tyrell-components 1.0.0-TC9 → 1.0.0-rc.21

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 (392) hide show
  1. package/AGENTS.md +122 -0
  2. package/CHANGELOG.md +1531 -0
  3. package/README.md +71 -53
  4. package/css/tyrell-colors-static.css +1 -0
  5. package/css/tyrell-theme.css +1 -0
  6. package/css/tyrell.css +1 -1783
  7. package/dist/tyrell-colors-static.css +1 -0
  8. package/dist/tyrell-theme.css +1 -0
  9. package/dist/tyrell.css +1 -1783
  10. package/dist/tyrell.js +1 -1
  11. package/guides/AGENT_INSTRUCTIONS.md +124 -0
  12. package/guides/AI_GUIDE.md +53 -0
  13. package/guides/CSS_GUIDE.md +1016 -0
  14. package/guides/DATASTAR_TY_GUIDE.md +657 -0
  15. package/guides/ICONS_GUIDE.md +212 -0
  16. package/guides/TY_GUIDE.md +935 -0
  17. package/guides/clj/CLOJURESCRIPT_GUIDE.md +300 -0
  18. package/guides/clj/CODE_SPLITTING.md +279 -0
  19. package/guides/clj/COMPONENT_GUIDE.md +391 -0
  20. package/guides/clj/HELIX_TY_GUIDE.md +428 -0
  21. package/guides/clj/I18N_GUIDE.md +478 -0
  22. package/guides/clj/LAYOUT_GUIDE.md +273 -0
  23. package/guides/clj/QUICKSTART.md +266 -0
  24. package/guides/clj/REAGENT_TY_GUIDE.md +408 -0
  25. package/guides/clj/REPLICANT_TY_GUIDE.md +623 -0
  26. package/guides/clj/ROUTING_GUIDE.md +346 -0
  27. package/guides/clj/UIX_TY_GUIDE.md +319 -0
  28. package/guides/js/HTMX_TY_GUIDE.md +252 -0
  29. package/guides/js/JAVASCRIPT_GUIDE.md +388 -0
  30. package/guides/js/REACT_TY_GUIDE.md +983 -0
  31. package/guides/js/SVELTE_TY_GUIDE.md +682 -0
  32. package/guides/js/TYCOMPONENT_GUIDE.md +962 -0
  33. package/guides/js/VUE_TY_GUIDE.md +738 -0
  34. package/lib/base/ty-component.d.ts +57 -13
  35. package/lib/base/ty-component.js +266 -292
  36. package/lib/components/button.d.ts +33 -18
  37. package/lib/components/button.js +317 -267
  38. package/lib/components/calendar-month.d.ts +30 -47
  39. package/lib/components/calendar-month.js +455 -429
  40. package/lib/components/calendar-navigation.d.ts +41 -49
  41. package/lib/components/calendar-navigation.js +287 -346
  42. package/lib/components/calendar.d.ts +73 -83
  43. package/lib/components/calendar.js +837 -762
  44. package/lib/components/checkbox.d.ts +26 -75
  45. package/lib/components/checkbox.js +298 -391
  46. package/lib/components/copy.d.ts +20 -60
  47. package/lib/components/copy.js +276 -380
  48. package/lib/components/date-picker.d.ts +100 -183
  49. package/lib/components/date-picker.js +1155 -1570
  50. package/lib/components/file-upload.d.ts +16 -15
  51. package/lib/components/file-upload.js +436 -426
  52. package/lib/components/icon.d.ts +3 -24
  53. package/lib/components/icon.js +141 -230
  54. package/lib/components/input.d.ts +93 -108
  55. package/lib/components/input.js +734 -710
  56. package/lib/components/modal.d.ts +39 -29
  57. package/lib/components/modal.js +419 -438
  58. package/lib/components/option.d.ts +20 -35
  59. package/lib/components/option.js +184 -309
  60. package/lib/components/popup.d.ts +2 -17
  61. package/lib/components/popup.js +353 -347
  62. package/lib/components/radio.d.ts +33 -25
  63. package/lib/components/radio.js +433 -422
  64. package/lib/components/resize-observer.d.ts +3 -30
  65. package/lib/components/resize-observer.js +71 -103
  66. package/lib/components/scroll-container.d.ts +21 -14
  67. package/lib/components/scroll-container.js +292 -234
  68. package/lib/components/select.d.ts +446 -0
  69. package/lib/components/select.js +1381 -0
  70. package/lib/components/selected-tags.d.ts +60 -0
  71. package/lib/components/selected-tags.js +225 -0
  72. package/lib/components/sortable.d.ts +175 -0
  73. package/lib/components/sortable.js +1844 -0
  74. package/lib/components/step.d.ts +1 -6
  75. package/lib/components/step.js +62 -68
  76. package/lib/components/switch.d.ts +15 -15
  77. package/lib/components/switch.js +237 -231
  78. package/lib/components/tab.d.ts +50 -7
  79. package/lib/components/tab.js +203 -69
  80. package/lib/components/tabs.d.ts +19 -64
  81. package/lib/components/tabs.js +600 -618
  82. package/lib/components/tag.d.ts +14 -52
  83. package/lib/components/tag.js +231 -306
  84. package/lib/components/textarea.d.ts +58 -89
  85. package/lib/components/textarea.js +523 -573
  86. package/lib/components/tooltip.d.ts +8 -13
  87. package/lib/components/tooltip.js +322 -409
  88. package/lib/components/wizard.d.ts +7 -54
  89. package/lib/components/wizard.js +376 -606
  90. package/lib/icons/fontawesome/brands.d.ts +0 -1
  91. package/lib/icons/fontawesome/brands.js +0 -8
  92. package/lib/icons/fontawesome/regular.d.ts +0 -1
  93. package/lib/icons/fontawesome/regular.js +0 -8
  94. package/lib/icons/fontawesome/solid.d.ts +0 -1
  95. package/lib/icons/fontawesome/solid.js +0 -8
  96. package/lib/icons/heroicons/micro.d.ts +0 -1
  97. package/lib/icons/heroicons/micro.js +392 -400
  98. package/lib/icons/heroicons/mini.d.ts +0 -1
  99. package/lib/icons/heroicons/mini.js +382 -390
  100. package/lib/icons/heroicons/outline.d.ts +0 -1
  101. package/lib/icons/heroicons/outline.js +337 -345
  102. package/lib/icons/heroicons/solid.d.ts +0 -1
  103. package/lib/icons/heroicons/solid.js +407 -415
  104. package/lib/icons/lucide.d.ts +0 -1
  105. package/lib/icons/lucide.js +24479 -26351
  106. package/lib/icons/material/filled.d.ts +0 -1
  107. package/lib/icons/material/filled.js +9653 -9663
  108. package/lib/icons/material/outlined.d.ts +0 -1
  109. package/lib/icons/material/outlined.js +10271 -10281
  110. package/lib/icons/material/round.d.ts +0 -1
  111. package/lib/icons/material/round.js +10495 -10505
  112. package/lib/icons/material/sharp.d.ts +0 -1
  113. package/lib/icons/material/sharp.js +9905 -9915
  114. package/lib/icons/material/two-tone.d.ts +0 -1
  115. package/lib/icons/material/two-tone.js +12792 -12802
  116. package/lib/index.d.ts +7 -4
  117. package/lib/index.js +26 -39
  118. package/lib/styles/button.d.ts +24 -7
  119. package/lib/styles/button.js +285 -445
  120. package/lib/styles/calendar-month.d.ts +7 -6
  121. package/lib/styles/calendar-month.js +158 -226
  122. package/lib/styles/calendar-navigation.d.ts +2 -6
  123. package/lib/styles/calendar-navigation.js +108 -127
  124. package/lib/styles/calendar.d.ts +3 -3
  125. package/lib/styles/calendar.js +87 -23
  126. package/lib/styles/checkbox.d.ts +7 -6
  127. package/lib/styles/checkbox.js +101 -15
  128. package/lib/styles/copy.d.ts +3 -2
  129. package/lib/styles/copy.js +91 -71
  130. package/lib/styles/custom-scrollbar.d.ts +1 -2
  131. package/lib/styles/custom-scrollbar.js +80 -115
  132. package/lib/styles/date-picker.d.ts +4 -6
  133. package/lib/styles/date-picker.js +321 -388
  134. package/lib/styles/field-size.d.ts +6 -0
  135. package/lib/styles/field-size.js +91 -0
  136. package/lib/styles/file-upload.d.ts +1 -2
  137. package/lib/styles/file-upload.js +143 -188
  138. package/lib/styles/icon.d.ts +2 -6
  139. package/lib/styles/icon.js +92 -170
  140. package/lib/styles/input.d.ts +4 -7
  141. package/lib/styles/input.js +148 -643
  142. package/lib/styles/modal.d.ts +1 -2
  143. package/lib/styles/modal.js +127 -108
  144. package/lib/styles/option.d.ts +2 -6
  145. package/lib/styles/option.js +53 -96
  146. package/lib/styles/popup.d.ts +1 -2
  147. package/lib/styles/popup.js +47 -77
  148. package/lib/styles/radio.d.ts +3 -2
  149. package/lib/styles/radio.js +90 -116
  150. package/lib/styles/resize-observer.d.ts +1 -2
  151. package/lib/styles/resize-observer.js +2 -12
  152. package/lib/styles/scroll-container.d.ts +1 -2
  153. package/lib/styles/scroll-container.js +103 -146
  154. package/lib/styles/select-base.d.ts +8 -0
  155. package/lib/styles/select-base.js +747 -0
  156. package/lib/styles/select.d.ts +11 -0
  157. package/lib/styles/select.js +229 -0
  158. package/lib/styles/sortable.d.ts +16 -0
  159. package/lib/styles/sortable.js +85 -0
  160. package/lib/styles/step.d.ts +1 -2
  161. package/lib/styles/step.js +15 -34
  162. package/lib/styles/switch.d.ts +3 -2
  163. package/lib/styles/switch.js +52 -68
  164. package/lib/styles/tab.d.ts +1 -2
  165. package/lib/styles/tab.js +86 -34
  166. package/lib/styles/tabs.d.ts +3 -11
  167. package/lib/styles/tabs.js +204 -162
  168. package/lib/styles/tag.d.ts +2 -6
  169. package/lib/styles/tag.js +168 -362
  170. package/lib/styles/textarea.d.ts +1 -2
  171. package/lib/styles/textarea.js +238 -306
  172. package/lib/styles/tooltip.d.ts +4 -3
  173. package/lib/styles/tooltip.js +3 -131
  174. package/lib/styles/wizard.d.ts +8 -20
  175. package/lib/styles/wizard.js +306 -295
  176. package/lib/types/common.d.ts +9 -8
  177. package/lib/types/common.js +8 -5
  178. package/lib/utils/calendar-utils.d.ts +49 -65
  179. package/lib/utils/calendar-utils.js +158 -343
  180. package/lib/utils/custom-scrollbar.d.ts +6 -20
  181. package/lib/utils/custom-scrollbar.js +273 -317
  182. package/lib/utils/flavor-sheet.d.ts +31 -0
  183. package/lib/utils/flavor-sheet.js +17 -0
  184. package/lib/utils/icon-registry.d.ts +0 -15
  185. package/lib/utils/icon-registry.js +138 -279
  186. package/lib/utils/icons.d.ts +9 -0
  187. package/lib/utils/icons.js +1 -0
  188. package/lib/utils/loader-registry.d.ts +2 -3
  189. package/lib/utils/loader-registry.js +3 -35
  190. package/lib/utils/locale.d.ts +2 -80
  191. package/lib/utils/locale.js +30 -205
  192. package/lib/utils/mobile.d.ts +0 -1
  193. package/lib/utils/mobile.js +1 -18
  194. package/lib/utils/number-format.d.ts +6 -24
  195. package/lib/utils/number-format.js +53 -136
  196. package/lib/utils/positioning.d.ts +72 -22
  197. package/lib/utils/positioning.js +224 -298
  198. package/lib/utils/property-capture.d.ts +5 -27
  199. package/lib/utils/property-capture.js +36 -144
  200. package/lib/utils/property-manager.d.ts +6 -6
  201. package/lib/utils/property-manager.js +127 -196
  202. package/lib/utils/resize-observer.d.ts +0 -1
  203. package/lib/utils/resize-observer.js +23 -59
  204. package/lib/utils/scroll-lock.d.ts +10 -11
  205. package/lib/utils/scroll-lock.js +165 -173
  206. package/lib/utils/styles.d.ts +0 -6
  207. package/lib/utils/styles.js +17 -48
  208. package/lib/utils/upgrade-properties.d.ts +21 -0
  209. package/lib/utils/upgrade-properties.js +47 -0
  210. package/lib/utils/validity.d.ts +122 -0
  211. package/lib/utils/validity.js +289 -0
  212. package/lib/version.d.ts +1 -2
  213. package/lib/version.js +1 -11
  214. package/package.json +62 -18
  215. package/lib/base/ty-component.d.ts.map +0 -1
  216. package/lib/base/ty-component.js.map +0 -1
  217. package/lib/components/button.d.ts.map +0 -1
  218. package/lib/components/button.js.map +0 -1
  219. package/lib/components/calendar-month.d.ts.map +0 -1
  220. package/lib/components/calendar-month.js.map +0 -1
  221. package/lib/components/calendar-navigation.d.ts.map +0 -1
  222. package/lib/components/calendar-navigation.js.map +0 -1
  223. package/lib/components/calendar.d.ts.map +0 -1
  224. package/lib/components/calendar.js.map +0 -1
  225. package/lib/components/checkbox.d.ts.map +0 -1
  226. package/lib/components/checkbox.js.map +0 -1
  227. package/lib/components/copy.d.ts.map +0 -1
  228. package/lib/components/copy.js.map +0 -1
  229. package/lib/components/date-picker.d.ts.map +0 -1
  230. package/lib/components/date-picker.js.map +0 -1
  231. package/lib/components/dropdown.d.ts +0 -404
  232. package/lib/components/dropdown.d.ts.map +0 -1
  233. package/lib/components/dropdown.js +0 -1563
  234. package/lib/components/dropdown.js.map +0 -1
  235. package/lib/components/file-upload.d.ts.map +0 -1
  236. package/lib/components/file-upload.js.map +0 -1
  237. package/lib/components/icon.d.ts.map +0 -1
  238. package/lib/components/icon.js.map +0 -1
  239. package/lib/components/input.d.ts.map +0 -1
  240. package/lib/components/input.js.map +0 -1
  241. package/lib/components/modal.d.ts.map +0 -1
  242. package/lib/components/modal.js.map +0 -1
  243. package/lib/components/multiselect.d.ts +0 -408
  244. package/lib/components/multiselect.d.ts.map +0 -1
  245. package/lib/components/multiselect.js +0 -1611
  246. package/lib/components/multiselect.js.map +0 -1
  247. package/lib/components/option.d.ts.map +0 -1
  248. package/lib/components/option.js.map +0 -1
  249. package/lib/components/popup.d.ts.map +0 -1
  250. package/lib/components/popup.js.map +0 -1
  251. package/lib/components/radio.d.ts.map +0 -1
  252. package/lib/components/radio.js.map +0 -1
  253. package/lib/components/resize-observer.d.ts.map +0 -1
  254. package/lib/components/resize-observer.js.map +0 -1
  255. package/lib/components/scroll-container.d.ts.map +0 -1
  256. package/lib/components/scroll-container.js.map +0 -1
  257. package/lib/components/step.d.ts.map +0 -1
  258. package/lib/components/step.js.map +0 -1
  259. package/lib/components/switch.d.ts.map +0 -1
  260. package/lib/components/switch.js.map +0 -1
  261. package/lib/components/tab.d.ts.map +0 -1
  262. package/lib/components/tab.js.map +0 -1
  263. package/lib/components/tabs.d.ts.map +0 -1
  264. package/lib/components/tabs.js.map +0 -1
  265. package/lib/components/tag.d.ts.map +0 -1
  266. package/lib/components/tag.js.map +0 -1
  267. package/lib/components/textarea.d.ts.map +0 -1
  268. package/lib/components/textarea.js.map +0 -1
  269. package/lib/components/tooltip.d.ts.map +0 -1
  270. package/lib/components/tooltip.js.map +0 -1
  271. package/lib/components/wizard.d.ts.map +0 -1
  272. package/lib/components/wizard.js.map +0 -1
  273. package/lib/icons/fontawesome/brands.d.ts.map +0 -1
  274. package/lib/icons/fontawesome/brands.js.map +0 -1
  275. package/lib/icons/fontawesome/regular.d.ts.map +0 -1
  276. package/lib/icons/fontawesome/regular.js.map +0 -1
  277. package/lib/icons/fontawesome/solid.d.ts.map +0 -1
  278. package/lib/icons/fontawesome/solid.js.map +0 -1
  279. package/lib/icons/heroicons/micro.d.ts.map +0 -1
  280. package/lib/icons/heroicons/micro.js.map +0 -1
  281. package/lib/icons/heroicons/mini.d.ts.map +0 -1
  282. package/lib/icons/heroicons/mini.js.map +0 -1
  283. package/lib/icons/heroicons/outline.d.ts.map +0 -1
  284. package/lib/icons/heroicons/outline.js.map +0 -1
  285. package/lib/icons/heroicons/solid.d.ts.map +0 -1
  286. package/lib/icons/heroicons/solid.js.map +0 -1
  287. package/lib/icons/lucide.d.ts.map +0 -1
  288. package/lib/icons/lucide.js.map +0 -1
  289. package/lib/icons/material/filled.d.ts.map +0 -1
  290. package/lib/icons/material/filled.js.map +0 -1
  291. package/lib/icons/material/outlined.d.ts.map +0 -1
  292. package/lib/icons/material/outlined.js.map +0 -1
  293. package/lib/icons/material/round.d.ts.map +0 -1
  294. package/lib/icons/material/round.js.map +0 -1
  295. package/lib/icons/material/sharp.d.ts.map +0 -1
  296. package/lib/icons/material/sharp.js.map +0 -1
  297. package/lib/icons/material/two-tone.d.ts.map +0 -1
  298. package/lib/icons/material/two-tone.js.map +0 -1
  299. package/lib/index.d.ts.map +0 -1
  300. package/lib/index.js.map +0 -1
  301. package/lib/styles/button.d.ts.map +0 -1
  302. package/lib/styles/button.js.map +0 -1
  303. package/lib/styles/calendar-month.d.ts.map +0 -1
  304. package/lib/styles/calendar-month.js.map +0 -1
  305. package/lib/styles/calendar-navigation.d.ts.map +0 -1
  306. package/lib/styles/calendar-navigation.js.map +0 -1
  307. package/lib/styles/calendar.d.ts.map +0 -1
  308. package/lib/styles/calendar.js.map +0 -1
  309. package/lib/styles/checkbox.d.ts.map +0 -1
  310. package/lib/styles/checkbox.js.map +0 -1
  311. package/lib/styles/copy.d.ts.map +0 -1
  312. package/lib/styles/copy.js.map +0 -1
  313. package/lib/styles/custom-scrollbar.d.ts.map +0 -1
  314. package/lib/styles/custom-scrollbar.js.map +0 -1
  315. package/lib/styles/date-picker.d.ts.map +0 -1
  316. package/lib/styles/date-picker.js.map +0 -1
  317. package/lib/styles/dropdown.d.ts +0 -12
  318. package/lib/styles/dropdown.d.ts.map +0 -1
  319. package/lib/styles/dropdown.js +0 -1048
  320. package/lib/styles/dropdown.js.map +0 -1
  321. package/lib/styles/file-upload.d.ts.map +0 -1
  322. package/lib/styles/file-upload.js.map +0 -1
  323. package/lib/styles/icon.d.ts.map +0 -1
  324. package/lib/styles/icon.js.map +0 -1
  325. package/lib/styles/input.d.ts.map +0 -1
  326. package/lib/styles/input.js.map +0 -1
  327. package/lib/styles/modal.d.ts.map +0 -1
  328. package/lib/styles/modal.js.map +0 -1
  329. package/lib/styles/multiselect.d.ts +0 -6
  330. package/lib/styles/multiselect.d.ts.map +0 -1
  331. package/lib/styles/multiselect.js +0 -837
  332. package/lib/styles/multiselect.js.map +0 -1
  333. package/lib/styles/option.d.ts.map +0 -1
  334. package/lib/styles/option.js.map +0 -1
  335. package/lib/styles/popup.d.ts.map +0 -1
  336. package/lib/styles/popup.js.map +0 -1
  337. package/lib/styles/radio.d.ts.map +0 -1
  338. package/lib/styles/radio.js.map +0 -1
  339. package/lib/styles/resize-observer.d.ts.map +0 -1
  340. package/lib/styles/resize-observer.js.map +0 -1
  341. package/lib/styles/scroll-container.d.ts.map +0 -1
  342. package/lib/styles/scroll-container.js.map +0 -1
  343. package/lib/styles/step.d.ts.map +0 -1
  344. package/lib/styles/step.js.map +0 -1
  345. package/lib/styles/switch.d.ts.map +0 -1
  346. package/lib/styles/switch.js.map +0 -1
  347. package/lib/styles/tab.d.ts.map +0 -1
  348. package/lib/styles/tab.js.map +0 -1
  349. package/lib/styles/tabs.d.ts.map +0 -1
  350. package/lib/styles/tabs.js.map +0 -1
  351. package/lib/styles/tag.d.ts.map +0 -1
  352. package/lib/styles/tag.js.map +0 -1
  353. package/lib/styles/textarea.d.ts.map +0 -1
  354. package/lib/styles/textarea.js.map +0 -1
  355. package/lib/styles/tooltip.d.ts.map +0 -1
  356. package/lib/styles/tooltip.js.map +0 -1
  357. package/lib/styles/wizard.d.ts.map +0 -1
  358. package/lib/styles/wizard.js.map +0 -1
  359. package/lib/types/common.d.ts.map +0 -1
  360. package/lib/types/common.js.map +0 -1
  361. package/lib/utils/calendar-utils.d.ts.map +0 -1
  362. package/lib/utils/calendar-utils.js.map +0 -1
  363. package/lib/utils/custom-scrollbar.d.ts.map +0 -1
  364. package/lib/utils/custom-scrollbar.js.map +0 -1
  365. package/lib/utils/icon-registry.d.ts.map +0 -1
  366. package/lib/utils/icon-registry.js.map +0 -1
  367. package/lib/utils/loader-registry.d.ts.map +0 -1
  368. package/lib/utils/loader-registry.js.map +0 -1
  369. package/lib/utils/locale.d.ts.map +0 -1
  370. package/lib/utils/locale.js.map +0 -1
  371. package/lib/utils/mobile.d.ts.map +0 -1
  372. package/lib/utils/mobile.js.map +0 -1
  373. package/lib/utils/number-format.d.ts.map +0 -1
  374. package/lib/utils/number-format.js.map +0 -1
  375. package/lib/utils/parse-boolean.d.ts +0 -39
  376. package/lib/utils/parse-boolean.d.ts.map +0 -1
  377. package/lib/utils/parse-boolean.js +0 -58
  378. package/lib/utils/parse-boolean.js.map +0 -1
  379. package/lib/utils/positioning.d.ts.map +0 -1
  380. package/lib/utils/positioning.js.map +0 -1
  381. package/lib/utils/property-capture.d.ts.map +0 -1
  382. package/lib/utils/property-capture.js.map +0 -1
  383. package/lib/utils/property-manager.d.ts.map +0 -1
  384. package/lib/utils/property-manager.js.map +0 -1
  385. package/lib/utils/resize-observer.d.ts.map +0 -1
  386. package/lib/utils/resize-observer.js.map +0 -1
  387. package/lib/utils/scroll-lock.d.ts.map +0 -1
  388. package/lib/utils/scroll-lock.js.map +0 -1
  389. package/lib/utils/styles.d.ts.map +0 -1
  390. package/lib/utils/styles.js.map +0 -1
  391. package/lib/version.d.ts.map +0 -1
  392. package/lib/version.js.map +0 -1
@@ -0,0 +1,623 @@
1
+ # Replicant + Tyrell Guide
2
+
3
+ Using Tyrell web components with Replicant (ClojureScript DOM library).
4
+
5
+ For the full CSS class reference, see [`CSS_GUIDE.md`](../CSS_GUIDE.md). In Replicant hiccup, Tyrell color classes go on the element keyword with dots, Tailwind handles everything else:
6
+
7
+ ```clojure
8
+ ;; Tyrell for colors (surfaces, text, bg, border), Tailwind for layout
9
+ [:div.ty-elevated.p-6.rounded-lg.flex.items-center
10
+ [:h2.ty-text++.text-xl.font-bold "Title"]
11
+ [:p.ty-text-.text-sm "Subtitle"]]
12
+
13
+ ;; Dynamic classes — use vectors, not string concatenation
14
+ [:div {:class ["ty-elevated" "p-4" (when active? "ty-bg-primary-")]}]
15
+ ```
16
+
17
+ ---
18
+
19
+ ## Loading Tyrell CSS
20
+
21
+ Component classes only work once `tyrell.css` is loaded. Easiest is a CDN `<link>`:
22
+
23
+ ```html
24
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tyrell-components@latest/css/tyrell.css">
25
+ <!-- tyrell-theme.css: auto-contrast, seed-based rebranding, themes. See TY_GUIDE.md#quick-start -->
26
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tyrell-components@latest/css/tyrell-theme.css">
27
+ ```
28
+
29
+ For offline dev, fetch the files once and serve them from your `public/`:
30
+
31
+ ```bash
32
+ # Pin a version
33
+ curl -o public/css/tyrell.css https://cdn.jsdelivr.net/npm/tyrell-components@1.0.0-RC20/css/tyrell.css
34
+ curl -o public/css/tyrell-theme.css https://cdn.jsdelivr.net/npm/tyrell-components@1.0.0-RC20/css/tyrell-theme.css
35
+
36
+ # Or copy from the version shadow-cljs already installed (after first build)
37
+ cp node_modules/tyrell-components/css/tyrell.css public/css/tyrell.css
38
+ cp node_modules/tyrell-components/css/tyrell-theme.css public/css/tyrell-theme.css
39
+ ```
40
+
41
+ Then `<link>` both in your HTML, brand.css after tyrell.css. See [`CLOJURESCRIPT_GUIDE.md`](CLOJURESCRIPT_GUIDE.md#css-handling) for the Tailwind/PostCSS pipeline variant.
42
+
43
+ ---
44
+
45
+ ## Replicant Attribute Conventions
46
+
47
+ Replicant emits console warnings (and in some cases drops change detection) when `:class` and `:style` aren't shaped the way it expects. Three rules cover virtually every case:
48
+
49
+ ### 1. `:class` is always a vector of single-class tokens
50
+
51
+ Multi-class strings like `"text-xs font-light"` warn *and* perform worse — Replicant has to parse them at every render. Use a vector of single-class strings (or keywords) instead, **including inside `(when …)`, `(if …)`, `(cond …)`, `(case …)` branches**. The string-with-spaces is still wrong even when it's deep inside a dynamic form.
52
+
53
+ ```clojure
54
+ ;; ❌ Multi-class string (warns)
55
+ [:span {:class "text-xs font-light"} "welcome"]
56
+
57
+ ;; ❌ Multi-class string inside a dynamic form (still warns)
58
+ [:div {:class (when on-click "cursor-pointer hover:shadow-lg")} ...]
59
+
60
+ [:span {:class (cond
61
+ (and featured? active?) "text-xs font-semibold"
62
+ featured? "text-xs font-medium"
63
+ :else "text-xs font-light")}]
64
+
65
+ ;; ✅ Vectors everywhere
66
+ [:span {:class ["text-xs" "font-light"]} "welcome"]
67
+
68
+ [:div {:class (when on-click ["cursor-pointer" "hover:shadow-lg"])} ...]
69
+
70
+ [:span {:class (cond
71
+ (and featured? active?) ["text-xs" "font-semibold"]
72
+ featured? ["text-xs" "font-medium"]
73
+ :else ["text-xs" "font-light"])}]
74
+ ```
75
+
76
+ Single-class strings like `(when active? "ty-text-primary")` are fine — the rule only applies to strings that contain spaces.
77
+
78
+ ### 2. `:style` is always a map, never a string
79
+
80
+ Style strings (`{:style "font-size: 0.875rem;"}`) warn — Replicant has to parse them on every render and they're harder to read. Use a map of CSS-property keywords:
81
+
82
+ ```clojure
83
+ ;; ❌ Style string
84
+ [:p {:style "font-size: 0.875rem; line-height: 1.6;"} ...]
85
+
86
+ ;; ✅ Style map
87
+ [:p {:style {:font-size "0.875rem"
88
+ :line-height "1.6"}} ...]
89
+ ```
90
+
91
+ This rule applies only to the `:style` *attribute*. The `[:style "…"]` *element* (a `<style>` tag with CSS source as text content) is unaffected — it's a tag, not an attribute.
92
+
93
+ ### 3. `:style` map keys are keywords — including CSS custom properties
94
+
95
+ Replicant warns when style keys are strings or symbols and refuses to recognize subsequent changes to them reliably. Clojure keywords accept the `--` prefix, so CSS custom properties become valid keywords:
96
+
97
+ ```clojure
98
+ ;; ❌ String keys for CSS variables
99
+ [:ty-button {:style {"--ty-button-bg" "#ff6600"
100
+ "--ty-button-color" "white"}}]
101
+
102
+ ;; ✅ Keyword keys (Clojure accepts the leading -- in keywords)
103
+ [:ty-button {:style {:--ty-button-bg "#ff6600"
104
+ :--ty-button-color "white"}}]
105
+ ```
106
+
107
+ ---
108
+
109
+ ## Component Usage
110
+
111
+ ### Basic View Structure
112
+
113
+ ```clojure
114
+ (ns my-app.views.user-profile
115
+ (:require [tyrell.router :as router]))
116
+
117
+ (defn view []
118
+ (when (router/rendered? ::user-profile)
119
+ [:div.ty-content.p-6
120
+ [:div.ty-elevated.rounded-lg.p-6
121
+ [:h2.ty-text++.text-2xl.mb-4 "User Profile"]
122
+ ;; component content
123
+ ]]))
124
+ ```
125
+
126
+ ### Tyrell Web Components in Hiccup
127
+
128
+ ```clojure
129
+ ;; Input with label and error
130
+ [:ty-input
131
+ {:type "email"
132
+ :label "Email"
133
+ :placeholder "you@example.com"
134
+ :required true
135
+ :value current-email
136
+ :error (when (touched :email) (errors :email))
137
+ :on {:change (fn [^js e] (on-email-change (-> e .-detail .-value)))}}]
138
+
139
+ ;; Select (single)
140
+ [:ty-select
141
+ {:label "Country"
142
+ :placeholder "Select..."
143
+ :value selected-country
144
+ :on {:change (fn [^js e] (on-country-change (-> e .-detail .-value)))}}
145
+ [:ty-option {:value "us"} "United States"]
146
+ [:ty-option {:value "de"} "Germany"]]
147
+
148
+ ;; Multi-select (ty-select with :multiple — children are
149
+ ;; ty-option, chips render via ty-selected-options)
150
+ [:ty-select
151
+ {:multiple true
152
+ :id "skills"
153
+ :label "Skills"
154
+ :placeholder "Add skills"
155
+ :value (clojure.string/join "," selected-skills) ; the selection: a comma-joined string
156
+ :on {:change (fn [^js e] (on-skills-change (vec (-> e .-detail .-values))))}}
157
+ [:ty-option {:value "clojure" :flavor "primary"} "Clojure"]
158
+ [:ty-option {:value "javascript" :flavor "warning"} "JavaScript"]]
159
+ [:ty-selected-options {:for "skills"}]
160
+
161
+ ;; Checkbox
162
+ [:ty-checkbox
163
+ {:checked agreed?
164
+ :flavor "primary"
165
+ :on {:change (fn [^js e] (on-agree-change (-> e .-detail .-checked)))}}
166
+ "I agree to terms"]
167
+
168
+ ;; Textarea
169
+ [:ty-textarea
170
+ {:label "Notes"
171
+ :placeholder "Write something..."
172
+ :rows "4"
173
+ :value notes-value
174
+ :on {:change (fn [^js e] (on-notes-change (-> e .-detail .-value)))}}]
175
+
176
+ ;; Button with start icon
177
+ [:ty-button {:flavor "primary" :type "submit"}
178
+ [:ty-icon {:slot "start" :name "save" :size "sm"}]
179
+ "Save"]
180
+
181
+ ;; Button with end icon
182
+ [:ty-button {:flavor "neutral"}
183
+ "Next"
184
+ [:ty-icon {:slot "end" :name "chevron-right" :size "sm"}]]
185
+
186
+ ;; Icon-only button
187
+ [:ty-button {:flavor "neutral" :size "sm"}
188
+ [:ty-icon {:name "settings" :size "sm"}]]
189
+
190
+ ;; Input with icon slots
191
+ [:ty-input {:type "currency" :currency "EUR" :label "Price"}
192
+ [:ty-icon {:slot "start" :name "euro"}]]
193
+
194
+ [:ty-input {:type "email" :label "Email"}
195
+ [:ty-icon {:slot "start" :name "mail" :size "sm"}]
196
+ [:ty-icon {:slot "end" :name "check" :size "sm"}]]
197
+
198
+ ;; Tag with icon
199
+ [:ty-tag {:flavor "primary" :dismissible true
200
+ :on {:dismiss (fn [^js e] (on-tag-dismiss (-> e .-detail .-value)))}}
201
+ [:ty-icon {:slot "start" :name "star" :size "sm"}]
202
+ "Featured"]
203
+
204
+ ;; Modal
205
+ [:ty-modal {:open show-modal?
206
+ :on {:close (fn [^js e] (on-modal-close))}}
207
+ [:div.ty-elevated.p-6.rounded-lg
208
+ [:h3.ty-text++.text-lg "Confirm"]
209
+ [:p.ty-text "Are you sure?"]
210
+ [:div.flex.gap-2.mt-4
211
+ [:ty-button {:flavor "danger"} "Delete"]
212
+ [:ty-button {:flavor "neutral"} "Cancel"]]]]
213
+
214
+ ;; Calendar
215
+ [:ty-calendar
216
+ {:value selected-date
217
+ :on {:change (fn [^js e] (on-date-change (-> e .-detail .-value)))}}]
218
+
219
+ ;; Date picker
220
+ [:ty-date-picker
221
+ {:label "Start Date"
222
+ :value selected-date
223
+ :on {:change (fn [^js e] (on-date-change (-> e .-detail .-value)))}}]
224
+
225
+ ;; Wizard
226
+ [:ty-wizard {:width "100%" :height "400px"
227
+ :active wizard-step
228
+ :completed (clojure.string/join "," completed-steps)}
229
+ [:ty-step {:id "info" :label "Information"} "Step 1"]
230
+ [:ty-step {:id "review" :label "Review"} "Step 2"]]
231
+
232
+ ;; Tooltip
233
+ [:ty-button {:flavor "primary"}
234
+ "Hover me"
235
+ [:ty-tooltip "This is helpful info"]]
236
+
237
+ ;; Scroll container
238
+ [:ty-scroll-container {:max-height "400px"}
239
+ (for [item items]
240
+ ^{:key (:id item)}
241
+ [:div.p-3.ty-elevated.rounded-lg (:name item)])]
242
+
243
+ ;; Copy
244
+ [:ty-copy {:value "npm install tyrell-components" :format "code"}]
245
+ ```
246
+
247
+ ---
248
+
249
+ ## Event Handling
250
+
251
+ ### Replicant `:on` Syntax
252
+
253
+ Event handlers are attached via the `:on` map. Keys are event type keywords, values are handler functions:
254
+
255
+ ```clojure
256
+ [:ty-input {:on {:change handler-fn}}] ; single event
257
+ [:ty-input {:on {:input on-input ; multiple events
258
+ :change on-change
259
+ :focus on-focus}}]
260
+ ```
261
+
262
+ ### Type Hint with `^js`
263
+
264
+ Tyrell events are JavaScript `CustomEvent` objects. **Always type hint the event parameter with `^js`** so the ClojureScript compiler doesn't munge property access:
265
+
266
+ ```clojure
267
+ ;; CORRECT — ^js ensures .-detail and .-value are not munged
268
+ (fn [^js e]
269
+ (let [^js detail (.-detail e)
270
+ value (.-value detail)]
271
+ (do-something value)))
272
+
273
+ ;; WRONG — without ^js, advanced compilation may break property access
274
+ (fn [e]
275
+ (let [value (-> e .-detail .-value)] ; may break in :advanced
276
+ (do-something value)))
277
+ ```
278
+
279
+ ### What Tyrell Components Emit
280
+
281
+ Every Tyrell component emits standard DOM `CustomEvent`s. The payload is always in `event.detail`:
282
+
283
+ | Component | Event | `event.detail` fields |
284
+ |-----------|-------|-----------------------|
285
+ | `ty-input` | `input` (every keystroke) | `value`, `formattedValue`, `rawValue`, `originalEvent` |
286
+ | `ty-input` | `change` (on blur) | `value`, `formattedValue`, `rawValue`, `originalEvent` |
287
+ | `ty-textarea` | `input` (every keystroke) | `value`, `originalEvent` |
288
+ | `ty-textarea` | `change` (on blur) | `value`, `originalEvent` |
289
+ | `ty-checkbox` | `change` | `value`, `checked`, `formValue`, `originalEvent` |
290
+ | `ty-select` | `change` | `value` (scalar, or array when `multiple`), `values` (JS array, pick order), `items`, `action` (`"add"`/`"remove"`/`"clear"`/`"set"`/`"create"`), `item`; with `external-selection`, `value` is the picked option and `selected` its requested state |
291
+ | `ty-select` | `search` | `query`, `element` |
292
+ | `ty-file-upload` | `change` | `value` (File[]), `files` (File[]), `names` (string[]) |
293
+ | `ty-calendar` | `change` | `year`, `month`, `day`, `action`, `source`, `dayContext` |
294
+ | `ty-calendar` | `navigate` | `month`, `year`, `action`, `source` |
295
+ | `ty-date-picker` | `change` | `value` (ISO string) |
296
+ | `ty-tabs` | `ty-tab-change` | `activeId`, `activeIndex`, `previousId`, `previousIndex` |
297
+ | `ty-tab` (`lazy`) | `ty-tab-load` | `id`, `index` (on the tab, doesn't bubble; call `(.loadFailed (.-target e))` if loading fails) |
298
+ | `ty-wizard` | `ty-wizard-step-change` | `activeId`, `activeIndex`, `previousId`, `previousIndex`, `direction` |
299
+ | `ty-modal` | `close` | `reason`, `returnValue` |
300
+ | `ty-tag` | `click` | `value` |
301
+ | `ty-tag` | `dismiss` | `value` |
302
+ | `ty-button` | `click` | `originalEvent` |
303
+ | `ty-copy` | `copy` | `value` |
304
+ | `ty-sortable` | `ty-sortable-change` | `value` (`key`, `group`, `source`, `from`, `to`, `order`), `item`, `fromContainer`, `toContainer` (on the destination list; `preventDefault()` rejects) |
305
+
306
+ ### Reading Event Detail Per Component
307
+
308
+ ```clojure
309
+ ;; ty-input — value is the parsed value, rawValue is the string
310
+ [:ty-input
311
+ {:label "Price" :type "currency" :currency "EUR"
312
+ :on {:change (fn [^js e]
313
+ (let [^js detail (.-detail e)]
314
+ ;; (.-value detail) => 1234.56
315
+ ;; (.-formattedValue detail) => "€1.234,56"
316
+ ;; (.-rawValue detail) => "1234.56"
317
+ (on-price-change (.-value detail))))}}]
318
+
319
+ ;; ty-textarea — same pattern as ty-input but without formatted values
320
+ [:ty-textarea
321
+ {:label "Bio" :rows "4"
322
+ :on {:change (fn [^js e]
323
+ (on-bio-change (-> e .-detail .-value)))}}]
324
+
325
+ ;; ty-select — detail.value is the scalar selected value (single select)
326
+ [:ty-select
327
+ {:label "Country"
328
+ :on {:change (fn [^js e]
329
+ (let [^js detail (.-detail e)]
330
+ ;; (.-value detail) => "us"
331
+ ;; (-> detail .-items (aget 0) .-label) => "United States"
332
+ (on-country-change (.-value detail))))}}
333
+ [:ty-option {:value "us"} "United States"]
334
+ [:ty-option {:value "de"} "Germany"]]
335
+
336
+ ;; ty-select multiple — values is a JS array, convert with vec
337
+ [:ty-select
338
+ {:multiple true
339
+ :label "Tags"
340
+ :on {:change (fn [^js e]
341
+ (let [^js detail (.-detail e)
342
+ values (vec (.-values detail)) ; JS array -> CLJ vector
343
+ action (.-action detail)] ; "add", "remove", "clear", "set", "create"
344
+ (on-tags-change values)))}}
345
+ [:ty-option {:value "a"} "Alpha"]
346
+ [:ty-option {:value "b"} "Beta"]]
347
+
348
+ ;; ty-checkbox — checked is boolean
349
+ [:ty-checkbox
350
+ {:flavor "primary"
351
+ :on {:change (fn [^js e]
352
+ (let [^js detail (.-detail e)]
353
+ ;; (.-checked detail) => true/false
354
+ ;; (.-value detail) => "on" (or custom value attr)
355
+ (on-agree-change (.-checked detail))))}}
356
+ "I agree"]
357
+
358
+ ;; ty-tabs — activeId is the tab id string
359
+ [:ty-tabs
360
+ {:width "100%" :height "500px"
361
+ ;; ty-tabs dispatches `ty-tab-change` (not `change`).
362
+ :on {:ty-tab-change (fn [^js e]
363
+ (let [^js detail (.-detail e)]
364
+ ;; (.-activeId detail) => "settings"
365
+ ;; (.-previousId detail) => "profile"
366
+ (on-tab-change (.-activeId detail))))}}
367
+ [:ty-tab {:id "profile" :label "Profile"} "..."]
368
+ [:ty-tab {:id "settings" :label "Settings"} "..."]]
369
+
370
+ ;; ty-calendar — date fields are numbers
371
+ [:ty-calendar
372
+ {:on {:change (fn [^js e]
373
+ (let [^js detail (.-detail e)]
374
+ ;; (.-year detail) => 2026
375
+ ;; (.-month detail) => 3
376
+ ;; (.-day detail) => 25
377
+ ;; (.-action detail) => "select" or "deselect"
378
+ (on-date-select (.-year detail)
379
+ (.-month detail)
380
+ (.-day detail))))}}]
381
+
382
+ ;; ty-modal — reason tells you how it was closed
383
+ [:ty-modal
384
+ {:open show?
385
+ :on {:close (fn [^js e]
386
+ (let [^js detail (.-detail e)]
387
+ ;; (.-reason detail) => "backdrop", "escape", "method"
388
+ (on-modal-close)))}}
389
+ [:div.p-6 "Modal content"]]
390
+ ```
391
+
392
+ ---
393
+
394
+ ## Icon Usage
395
+
396
+ ```clojure
397
+ (ns my-app.icons
398
+ (:require [tyrell.icons :as icons]
399
+ [tyrell.lucide :as lucide]))
400
+
401
+ (icons/register! {:check lucide/check
402
+ :user lucide/user}) ; the key is the name
403
+ ```
404
+
405
+ ```clojure
406
+ [:ty-icon {:name "check" :size "sm"}]
407
+
408
+ ;; in a button: use the slot, not margins
409
+ [:ty-button {:flavor "primary"}
410
+ [:ty-icon {:slot "start" :name "check" :size "sm"}]
411
+ "Save"]
412
+ ```
413
+
414
+ If `tyrell.js` loads from a `<script>` after your code, use `icons/register-async!`.
415
+
416
+ Sets, tree-shaking, custom SVGs and troubleshooting: [ICONS_GUIDE.md](../ICONS_GUIDE.md#in-clojure).
417
+
418
+ ---
419
+
420
+ ## Form Handling
421
+
422
+ ### Form Structure
423
+
424
+ Use standard `[:form]` with `:on {:submit ...}` and Tyrell components inside. Each Tyrell form component supports `name`, `label`, `error`, `required`, and `disabled` attributes:
425
+
426
+ ```clojure
427
+ [:form.space-y-6
428
+ {:on {:submit (fn [^js e]
429
+ (.preventDefault e)
430
+ (on-submit))}}
431
+
432
+ [:ty-input
433
+ {:type "text"
434
+ :name "fullName"
435
+ :label "Full Name"
436
+ :placeholder "John Doe"
437
+ :required true
438
+ :value name-value
439
+ :error name-error
440
+ :on {:change (fn [^js e] (on-name-change (-> e .-detail .-value)))}}]
441
+
442
+ [:ty-input
443
+ {:type "email"
444
+ :name "email"
445
+ :label "Email Address"
446
+ :required true
447
+ :value email-value
448
+ :error email-error
449
+ :on {:change (fn [^js e] (on-email-change (-> e .-detail .-value)))}}]
450
+
451
+ [:div.flex.gap-3
452
+ [:ty-button {:flavor "primary" :type "submit" :disabled submitting?}
453
+ [:ty-icon {:slot "start" :name "save" :size "sm"}]
454
+ "Submit"]
455
+
456
+ [:ty-button {:flavor "neutral" :type "button"
457
+ :on {:click on-cancel}}
458
+ "Cancel"]]]
459
+ ```
460
+
461
+ Key points:
462
+ - `ty-button` with `:type "submit"` triggers form submit
463
+ - `ty-button` with `:type "button"` does **not** trigger form submit
464
+ - `:error` attribute shows built-in error message styling — pass `nil` to hide
465
+ - `:required` adds a visual indicator and form validation
466
+
467
+ ### Select with Rich Content
468
+
469
+ A closed single select shows the selected option itself in the field, so rich HTML displays intact, and it adds no child of its own for Replicant to trip over.
470
+
471
+ ```clojure
472
+ [:ty-select
473
+ {:label "Select Country"
474
+ :placeholder "Choose a country"
475
+ :value selected-country
476
+ :on {:change (fn [^js e] (on-country-change (-> e .-detail .-value)))}}
477
+
478
+ [:ty-option {:value "us"}
479
+ [:div.flex.items-center.gap-2
480
+ [:div
481
+ [:div.font-medium "United States"]
482
+ [:div.text-xs.ty-text- "North America"]]]]
483
+
484
+ [:ty-option {:value "uk"}
485
+ [:div.flex.items-center.gap-2
486
+ [:div
487
+ [:div.font-medium "United Kingdom"]
488
+ [:div.text-xs.ty-text- "Europe"]]]]]
489
+ ```
490
+
491
+ ### Multi-select with Chips
492
+
493
+ `ty-select multiple` + `ty-selected-options` — options are `ty-option` children,
494
+ dismissible chips render out-of-band wherever you put them:
495
+
496
+ ```clojure
497
+ [:ty-select
498
+ {:multiple true
499
+ :id "skills-select"
500
+ :label "Select Skills"
501
+ :placeholder "Add skills"
502
+ :value (clojure.string/join "," selected-skills)
503
+ :on {:change (fn [^js e] (on-skills-change (vec (-> e .-detail .-values))))}}
504
+
505
+ [:ty-option {:value "clojure" :flavor "primary"} "Clojure"]
506
+ [:ty-option {:value "javascript" :flavor "warning"} "JavaScript"]
507
+ [:ty-option {:value "react" :flavor "neutral"} "React"]]
508
+
509
+ [:div.flex.flex-wrap.gap-2
510
+ [:ty-selected-options {:for "skills-select"}]]
511
+ ```
512
+
513
+ ---
514
+
515
+ ## Tabs Component
516
+
517
+ ### Basic Structure
518
+
519
+ ```clojure
520
+ [:ty-tabs
521
+ {:width "100%"
522
+ :height "600px"
523
+ :active "general"}
524
+
525
+ [:ty-tab {:id "general" :label "General"}
526
+ [:div.p-6 "General content"]]
527
+
528
+ [:ty-tab {:id "advanced" :label "Advanced"}
529
+ [:div.p-6 "Advanced content"]]]
530
+ ```
531
+
532
+ ### Rich Labels with Icons
533
+
534
+ ```clojure
535
+ [:ty-tabs {:width "800px" :height "500px"}
536
+
537
+ [:span {:slot "label-profile" :class "flex items-center gap-2"}
538
+ [:ty-icon {:name "user" :size "sm"}]
539
+ "Profile"]
540
+
541
+ [:span {:slot "label-notifications" :class "flex items-center gap-2"}
542
+ [:ty-icon {:name "bell" :size "sm"}]
543
+ "Notifications"
544
+ [:span.ty-bg-danger.ty-text-danger++.px-2.py-0.5.rounded-full.text-xs.font-bold "5"]]
545
+
546
+ [:ty-tab {:id "profile"}
547
+ [:div.p-6 "Profile content"]]
548
+
549
+ [:ty-tab {:id "notifications"}
550
+ [:div.p-6 "Notifications content"]]]
551
+ ```
552
+
553
+ ### Custom Marker
554
+
555
+ ```clojure
556
+ ;; Pill-style marker
557
+ [:ty-tabs {:width "100%" :height "400px"}
558
+ [:div.ty-bg-primary.rounded-full.shadow-sm {:slot "marker"}]
559
+ [:ty-tab {:id "tab1" :label "Home"}
560
+ [:div.p-6 "Content"]]]
561
+ ```
562
+
563
+ ### CSS Variables
564
+
565
+ ```clojure
566
+ [:ty-tabs
567
+ {:width "100%"
568
+ :height "500px"
569
+ :style {:--ty-tabs-bg "var(--ty-surface-elevated)"
570
+ :--ty-tabs-border-width "0"
571
+ :--ty-tabs-button-padding "8px 16px"
572
+ :--ty-tabs-button-gap "12px"
573
+ :--ty-tabs-button-hover-bg "var(--ty-surface-elevated)"
574
+ :--transition-duration "200ms"}}
575
+ ...]
576
+ ```
577
+
578
+ ### Attributes Reference
579
+
580
+ **ty-tabs:**
581
+ - `width` (required) - Content area width (px or %)
582
+ - `height` (required) - Total container height (px)
583
+ - `active` - ID of initially active tab (defaults to first)
584
+ - `placement` - Tab button position: "top" or "bottom" (default: "top")
585
+
586
+ **ty-tab:**
587
+ - `id` (required) - Unique tab identifier
588
+ - `label` - Simple text label
589
+ - `disabled` - Disable tab interaction (boolean)
590
+
591
+ **Events:**
592
+ - `ty-tab-change` - Fires when the shown tab changes (not for the initial tab)
593
+ - Detail: `{activeId, activeIndex, previousId, previousIndex}`
594
+
595
+ ---
596
+
597
+ ## Reorderable lists (ty-sortable)
598
+
599
+ `ty-sortable` never moves its children. A drop (or a keyboard move) fires `ty-sortable-change` on the destination list, and the list holds the result on screen until Replicant renders the items in the new order. Give each item `:replicant/key` (so Replicant moves the node) and `:data-key` (or `:id`):
600
+
601
+ ```clojure
602
+ (defn move! [^js e]
603
+ (let [value (.. e -detail -value)]
604
+ (swap! store assoc :saving? true)
605
+ (-> (save value)
606
+ (.then #(swap! store update :board merge (js->clj (.-order value))))
607
+ (.finally #(swap! store assoc :saving? false)))))
608
+
609
+ (defn column [{:keys [board saving?]} id label]
610
+ [:ty-sortable {:id id :group "board" :label label
611
+ :aria-busy (when saving? "true")
612
+ :on {:ty-sortable-change move!}}
613
+ (for [k (get board id)]
614
+ [:div {:replicant/key k :data-key k}
615
+ [:button {:type "button" :data-handle "" :aria-label (str "Move " k)}
616
+ [:ty-icon {:name "grip-vertical"}]]
617
+ k])])
618
+ ```
619
+
620
+ - `value` is `{key, group, source, from, to, order}`. `order` is the new key order of each list the move touched, by list id, so one `merge` renders both lists. For fractional ranking, save a rank between `(.. value -to -prev)` and `(.. value -to -next)` instead.
621
+ - `:aria-busy` while saving makes a refused save snap back as soon as it clears (the order didn't change). Without it, call `(.settle (.. e -detail -toContainer) "rejected")`, or `(.preventDefault e)` to reject at once.
622
+ - On touch, a `:data-handle` drags at once and leaves the rest of the row to scroll; give it a 44px target. Without a handle the whole item drags after a 250 ms press.
623
+ - Attributes: `group`, `axis`, `handle` (default `[data-handle]`), `accepts`, `disabled`, `key-attr`, `hold-timeout`, `label`. Items: `data-locked`, `data-no-drag`, `data-sortable-ignore`. `(.move el "a" #js {:to "done" :index 0})` moves without a pointer.