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

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 (393) hide show
  1. package/AGENTS.md +122 -0
  2. package/CHANGELOG.md +1541 -0
  3. package/README.md +71 -53
  4. package/bin/tyrell.mjs +77 -0
  5. package/css/tyrell-colors-static.css +1 -0
  6. package/css/tyrell-theme.css +1 -0
  7. package/css/tyrell.css +1 -1783
  8. package/dist/tyrell-colors-static.css +1 -0
  9. package/dist/tyrell-theme.css +1 -0
  10. package/dist/tyrell.css +1 -1783
  11. package/dist/tyrell.js +1 -1
  12. package/guides/AGENT_INSTRUCTIONS.md +124 -0
  13. package/guides/AI_GUIDE.md +53 -0
  14. package/guides/CSS_GUIDE.md +1016 -0
  15. package/guides/DATASTAR_TY_GUIDE.md +657 -0
  16. package/guides/ICONS_GUIDE.md +212 -0
  17. package/guides/TY_GUIDE.md +937 -0
  18. package/guides/clj/CLOJURESCRIPT_GUIDE.md +300 -0
  19. package/guides/clj/CODE_SPLITTING.md +279 -0
  20. package/guides/clj/COMPONENT_GUIDE.md +391 -0
  21. package/guides/clj/HELIX_TY_GUIDE.md +428 -0
  22. package/guides/clj/I18N_GUIDE.md +478 -0
  23. package/guides/clj/LAYOUT_GUIDE.md +273 -0
  24. package/guides/clj/QUICKSTART.md +266 -0
  25. package/guides/clj/REAGENT_TY_GUIDE.md +408 -0
  26. package/guides/clj/REPLICANT_TY_GUIDE.md +623 -0
  27. package/guides/clj/ROUTING_GUIDE.md +346 -0
  28. package/guides/clj/UIX_TY_GUIDE.md +319 -0
  29. package/guides/js/HTMX_TY_GUIDE.md +252 -0
  30. package/guides/js/JAVASCRIPT_GUIDE.md +388 -0
  31. package/guides/js/REACT_TY_GUIDE.md +983 -0
  32. package/guides/js/SVELTE_TY_GUIDE.md +682 -0
  33. package/guides/js/TYCOMPONENT_GUIDE.md +962 -0
  34. package/guides/js/VUE_TY_GUIDE.md +738 -0
  35. package/lib/base/ty-component.d.ts +57 -13
  36. package/lib/base/ty-component.js +266 -292
  37. package/lib/components/button.d.ts +33 -18
  38. package/lib/components/button.js +317 -267
  39. package/lib/components/calendar-month.d.ts +30 -47
  40. package/lib/components/calendar-month.js +455 -429
  41. package/lib/components/calendar-navigation.d.ts +41 -49
  42. package/lib/components/calendar-navigation.js +287 -346
  43. package/lib/components/calendar.d.ts +73 -83
  44. package/lib/components/calendar.js +837 -762
  45. package/lib/components/checkbox.d.ts +26 -75
  46. package/lib/components/checkbox.js +298 -391
  47. package/lib/components/copy.d.ts +20 -60
  48. package/lib/components/copy.js +276 -380
  49. package/lib/components/date-picker.d.ts +100 -183
  50. package/lib/components/date-picker.js +1155 -1570
  51. package/lib/components/file-upload.d.ts +16 -15
  52. package/lib/components/file-upload.js +436 -426
  53. package/lib/components/icon.d.ts +3 -24
  54. package/lib/components/icon.js +141 -230
  55. package/lib/components/input.d.ts +93 -108
  56. package/lib/components/input.js +734 -710
  57. package/lib/components/modal.d.ts +39 -29
  58. package/lib/components/modal.js +419 -438
  59. package/lib/components/option.d.ts +20 -35
  60. package/lib/components/option.js +184 -309
  61. package/lib/components/popup.d.ts +2 -17
  62. package/lib/components/popup.js +353 -347
  63. package/lib/components/radio.d.ts +33 -25
  64. package/lib/components/radio.js +433 -422
  65. package/lib/components/resize-observer.d.ts +3 -30
  66. package/lib/components/resize-observer.js +71 -103
  67. package/lib/components/scroll-container.d.ts +21 -14
  68. package/lib/components/scroll-container.js +292 -234
  69. package/lib/components/select.d.ts +458 -0
  70. package/lib/components/select.js +1458 -0
  71. package/lib/components/selected-tags.d.ts +60 -0
  72. package/lib/components/selected-tags.js +225 -0
  73. package/lib/components/sortable.d.ts +175 -0
  74. package/lib/components/sortable.js +1844 -0
  75. package/lib/components/step.d.ts +1 -6
  76. package/lib/components/step.js +62 -68
  77. package/lib/components/switch.d.ts +15 -15
  78. package/lib/components/switch.js +237 -231
  79. package/lib/components/tab.d.ts +50 -7
  80. package/lib/components/tab.js +203 -69
  81. package/lib/components/tabs.d.ts +19 -64
  82. package/lib/components/tabs.js +600 -618
  83. package/lib/components/tag.d.ts +14 -52
  84. package/lib/components/tag.js +231 -306
  85. package/lib/components/textarea.d.ts +58 -89
  86. package/lib/components/textarea.js +523 -573
  87. package/lib/components/tooltip.d.ts +8 -13
  88. package/lib/components/tooltip.js +322 -409
  89. package/lib/components/wizard.d.ts +7 -54
  90. package/lib/components/wizard.js +376 -606
  91. package/lib/icons/fontawesome/brands.d.ts +0 -1
  92. package/lib/icons/fontawesome/brands.js +0 -8
  93. package/lib/icons/fontawesome/regular.d.ts +0 -1
  94. package/lib/icons/fontawesome/regular.js +0 -8
  95. package/lib/icons/fontawesome/solid.d.ts +0 -1
  96. package/lib/icons/fontawesome/solid.js +0 -8
  97. package/lib/icons/heroicons/micro.d.ts +0 -1
  98. package/lib/icons/heroicons/micro.js +392 -400
  99. package/lib/icons/heroicons/mini.d.ts +0 -1
  100. package/lib/icons/heroicons/mini.js +382 -390
  101. package/lib/icons/heroicons/outline.d.ts +0 -1
  102. package/lib/icons/heroicons/outline.js +337 -345
  103. package/lib/icons/heroicons/solid.d.ts +0 -1
  104. package/lib/icons/heroicons/solid.js +407 -415
  105. package/lib/icons/lucide.d.ts +0 -1
  106. package/lib/icons/lucide.js +24479 -26351
  107. package/lib/icons/material/filled.d.ts +0 -1
  108. package/lib/icons/material/filled.js +9653 -9663
  109. package/lib/icons/material/outlined.d.ts +0 -1
  110. package/lib/icons/material/outlined.js +10271 -10281
  111. package/lib/icons/material/round.d.ts +0 -1
  112. package/lib/icons/material/round.js +10495 -10505
  113. package/lib/icons/material/sharp.d.ts +0 -1
  114. package/lib/icons/material/sharp.js +9905 -9915
  115. package/lib/icons/material/two-tone.d.ts +0 -1
  116. package/lib/icons/material/two-tone.js +12792 -12802
  117. package/lib/index.d.ts +7 -4
  118. package/lib/index.js +26 -39
  119. package/lib/styles/button.d.ts +24 -7
  120. package/lib/styles/button.js +285 -445
  121. package/lib/styles/calendar-month.d.ts +7 -6
  122. package/lib/styles/calendar-month.js +158 -226
  123. package/lib/styles/calendar-navigation.d.ts +2 -6
  124. package/lib/styles/calendar-navigation.js +108 -127
  125. package/lib/styles/calendar.d.ts +3 -3
  126. package/lib/styles/calendar.js +87 -23
  127. package/lib/styles/checkbox.d.ts +7 -6
  128. package/lib/styles/checkbox.js +101 -15
  129. package/lib/styles/copy.d.ts +3 -2
  130. package/lib/styles/copy.js +91 -71
  131. package/lib/styles/custom-scrollbar.d.ts +1 -2
  132. package/lib/styles/custom-scrollbar.js +80 -115
  133. package/lib/styles/date-picker.d.ts +4 -6
  134. package/lib/styles/date-picker.js +321 -388
  135. package/lib/styles/field-size.d.ts +6 -0
  136. package/lib/styles/field-size.js +91 -0
  137. package/lib/styles/file-upload.d.ts +1 -2
  138. package/lib/styles/file-upload.js +143 -188
  139. package/lib/styles/icon.d.ts +2 -6
  140. package/lib/styles/icon.js +92 -170
  141. package/lib/styles/input.d.ts +4 -7
  142. package/lib/styles/input.js +148 -643
  143. package/lib/styles/modal.d.ts +1 -2
  144. package/lib/styles/modal.js +127 -108
  145. package/lib/styles/option.d.ts +2 -6
  146. package/lib/styles/option.js +53 -96
  147. package/lib/styles/popup.d.ts +1 -2
  148. package/lib/styles/popup.js +47 -77
  149. package/lib/styles/radio.d.ts +3 -2
  150. package/lib/styles/radio.js +90 -116
  151. package/lib/styles/resize-observer.d.ts +1 -2
  152. package/lib/styles/resize-observer.js +2 -12
  153. package/lib/styles/scroll-container.d.ts +1 -2
  154. package/lib/styles/scroll-container.js +103 -146
  155. package/lib/styles/select-base.d.ts +8 -0
  156. package/lib/styles/select-base.js +752 -0
  157. package/lib/styles/select.d.ts +11 -0
  158. package/lib/styles/select.js +229 -0
  159. package/lib/styles/sortable.d.ts +16 -0
  160. package/lib/styles/sortable.js +85 -0
  161. package/lib/styles/step.d.ts +1 -2
  162. package/lib/styles/step.js +15 -34
  163. package/lib/styles/switch.d.ts +3 -2
  164. package/lib/styles/switch.js +52 -68
  165. package/lib/styles/tab.d.ts +1 -2
  166. package/lib/styles/tab.js +86 -34
  167. package/lib/styles/tabs.d.ts +3 -11
  168. package/lib/styles/tabs.js +204 -162
  169. package/lib/styles/tag.d.ts +2 -6
  170. package/lib/styles/tag.js +168 -362
  171. package/lib/styles/textarea.d.ts +1 -2
  172. package/lib/styles/textarea.js +238 -306
  173. package/lib/styles/tooltip.d.ts +4 -3
  174. package/lib/styles/tooltip.js +3 -131
  175. package/lib/styles/wizard.d.ts +8 -20
  176. package/lib/styles/wizard.js +306 -295
  177. package/lib/types/common.d.ts +9 -8
  178. package/lib/types/common.js +8 -5
  179. package/lib/utils/calendar-utils.d.ts +49 -65
  180. package/lib/utils/calendar-utils.js +158 -343
  181. package/lib/utils/custom-scrollbar.d.ts +6 -20
  182. package/lib/utils/custom-scrollbar.js +273 -317
  183. package/lib/utils/flavor-sheet.d.ts +31 -0
  184. package/lib/utils/flavor-sheet.js +17 -0
  185. package/lib/utils/icon-registry.d.ts +0 -15
  186. package/lib/utils/icon-registry.js +138 -279
  187. package/lib/utils/icons.d.ts +9 -0
  188. package/lib/utils/icons.js +1 -0
  189. package/lib/utils/loader-registry.d.ts +2 -3
  190. package/lib/utils/loader-registry.js +3 -35
  191. package/lib/utils/locale.d.ts +2 -80
  192. package/lib/utils/locale.js +30 -205
  193. package/lib/utils/mobile.d.ts +0 -1
  194. package/lib/utils/mobile.js +1 -18
  195. package/lib/utils/number-format.d.ts +6 -24
  196. package/lib/utils/number-format.js +53 -136
  197. package/lib/utils/positioning.d.ts +72 -22
  198. package/lib/utils/positioning.js +224 -298
  199. package/lib/utils/property-capture.d.ts +5 -27
  200. package/lib/utils/property-capture.js +36 -144
  201. package/lib/utils/property-manager.d.ts +6 -6
  202. package/lib/utils/property-manager.js +127 -196
  203. package/lib/utils/resize-observer.d.ts +0 -1
  204. package/lib/utils/resize-observer.js +23 -59
  205. package/lib/utils/scroll-lock.d.ts +10 -11
  206. package/lib/utils/scroll-lock.js +165 -173
  207. package/lib/utils/styles.d.ts +0 -6
  208. package/lib/utils/styles.js +17 -48
  209. package/lib/utils/upgrade-properties.d.ts +21 -0
  210. package/lib/utils/upgrade-properties.js +47 -0
  211. package/lib/utils/validity.d.ts +122 -0
  212. package/lib/utils/validity.js +289 -0
  213. package/lib/version.d.ts +1 -2
  214. package/lib/version.js +1 -11
  215. package/package.json +66 -18
  216. package/lib/base/ty-component.d.ts.map +0 -1
  217. package/lib/base/ty-component.js.map +0 -1
  218. package/lib/components/button.d.ts.map +0 -1
  219. package/lib/components/button.js.map +0 -1
  220. package/lib/components/calendar-month.d.ts.map +0 -1
  221. package/lib/components/calendar-month.js.map +0 -1
  222. package/lib/components/calendar-navigation.d.ts.map +0 -1
  223. package/lib/components/calendar-navigation.js.map +0 -1
  224. package/lib/components/calendar.d.ts.map +0 -1
  225. package/lib/components/calendar.js.map +0 -1
  226. package/lib/components/checkbox.d.ts.map +0 -1
  227. package/lib/components/checkbox.js.map +0 -1
  228. package/lib/components/copy.d.ts.map +0 -1
  229. package/lib/components/copy.js.map +0 -1
  230. package/lib/components/date-picker.d.ts.map +0 -1
  231. package/lib/components/date-picker.js.map +0 -1
  232. package/lib/components/dropdown.d.ts +0 -404
  233. package/lib/components/dropdown.d.ts.map +0 -1
  234. package/lib/components/dropdown.js +0 -1563
  235. package/lib/components/dropdown.js.map +0 -1
  236. package/lib/components/file-upload.d.ts.map +0 -1
  237. package/lib/components/file-upload.js.map +0 -1
  238. package/lib/components/icon.d.ts.map +0 -1
  239. package/lib/components/icon.js.map +0 -1
  240. package/lib/components/input.d.ts.map +0 -1
  241. package/lib/components/input.js.map +0 -1
  242. package/lib/components/modal.d.ts.map +0 -1
  243. package/lib/components/modal.js.map +0 -1
  244. package/lib/components/multiselect.d.ts +0 -408
  245. package/lib/components/multiselect.d.ts.map +0 -1
  246. package/lib/components/multiselect.js +0 -1611
  247. package/lib/components/multiselect.js.map +0 -1
  248. package/lib/components/option.d.ts.map +0 -1
  249. package/lib/components/option.js.map +0 -1
  250. package/lib/components/popup.d.ts.map +0 -1
  251. package/lib/components/popup.js.map +0 -1
  252. package/lib/components/radio.d.ts.map +0 -1
  253. package/lib/components/radio.js.map +0 -1
  254. package/lib/components/resize-observer.d.ts.map +0 -1
  255. package/lib/components/resize-observer.js.map +0 -1
  256. package/lib/components/scroll-container.d.ts.map +0 -1
  257. package/lib/components/scroll-container.js.map +0 -1
  258. package/lib/components/step.d.ts.map +0 -1
  259. package/lib/components/step.js.map +0 -1
  260. package/lib/components/switch.d.ts.map +0 -1
  261. package/lib/components/switch.js.map +0 -1
  262. package/lib/components/tab.d.ts.map +0 -1
  263. package/lib/components/tab.js.map +0 -1
  264. package/lib/components/tabs.d.ts.map +0 -1
  265. package/lib/components/tabs.js.map +0 -1
  266. package/lib/components/tag.d.ts.map +0 -1
  267. package/lib/components/tag.js.map +0 -1
  268. package/lib/components/textarea.d.ts.map +0 -1
  269. package/lib/components/textarea.js.map +0 -1
  270. package/lib/components/tooltip.d.ts.map +0 -1
  271. package/lib/components/tooltip.js.map +0 -1
  272. package/lib/components/wizard.d.ts.map +0 -1
  273. package/lib/components/wizard.js.map +0 -1
  274. package/lib/icons/fontawesome/brands.d.ts.map +0 -1
  275. package/lib/icons/fontawesome/brands.js.map +0 -1
  276. package/lib/icons/fontawesome/regular.d.ts.map +0 -1
  277. package/lib/icons/fontawesome/regular.js.map +0 -1
  278. package/lib/icons/fontawesome/solid.d.ts.map +0 -1
  279. package/lib/icons/fontawesome/solid.js.map +0 -1
  280. package/lib/icons/heroicons/micro.d.ts.map +0 -1
  281. package/lib/icons/heroicons/micro.js.map +0 -1
  282. package/lib/icons/heroicons/mini.d.ts.map +0 -1
  283. package/lib/icons/heroicons/mini.js.map +0 -1
  284. package/lib/icons/heroicons/outline.d.ts.map +0 -1
  285. package/lib/icons/heroicons/outline.js.map +0 -1
  286. package/lib/icons/heroicons/solid.d.ts.map +0 -1
  287. package/lib/icons/heroicons/solid.js.map +0 -1
  288. package/lib/icons/lucide.d.ts.map +0 -1
  289. package/lib/icons/lucide.js.map +0 -1
  290. package/lib/icons/material/filled.d.ts.map +0 -1
  291. package/lib/icons/material/filled.js.map +0 -1
  292. package/lib/icons/material/outlined.d.ts.map +0 -1
  293. package/lib/icons/material/outlined.js.map +0 -1
  294. package/lib/icons/material/round.d.ts.map +0 -1
  295. package/lib/icons/material/round.js.map +0 -1
  296. package/lib/icons/material/sharp.d.ts.map +0 -1
  297. package/lib/icons/material/sharp.js.map +0 -1
  298. package/lib/icons/material/two-tone.d.ts.map +0 -1
  299. package/lib/icons/material/two-tone.js.map +0 -1
  300. package/lib/index.d.ts.map +0 -1
  301. package/lib/index.js.map +0 -1
  302. package/lib/styles/button.d.ts.map +0 -1
  303. package/lib/styles/button.js.map +0 -1
  304. package/lib/styles/calendar-month.d.ts.map +0 -1
  305. package/lib/styles/calendar-month.js.map +0 -1
  306. package/lib/styles/calendar-navigation.d.ts.map +0 -1
  307. package/lib/styles/calendar-navigation.js.map +0 -1
  308. package/lib/styles/calendar.d.ts.map +0 -1
  309. package/lib/styles/calendar.js.map +0 -1
  310. package/lib/styles/checkbox.d.ts.map +0 -1
  311. package/lib/styles/checkbox.js.map +0 -1
  312. package/lib/styles/copy.d.ts.map +0 -1
  313. package/lib/styles/copy.js.map +0 -1
  314. package/lib/styles/custom-scrollbar.d.ts.map +0 -1
  315. package/lib/styles/custom-scrollbar.js.map +0 -1
  316. package/lib/styles/date-picker.d.ts.map +0 -1
  317. package/lib/styles/date-picker.js.map +0 -1
  318. package/lib/styles/dropdown.d.ts +0 -12
  319. package/lib/styles/dropdown.d.ts.map +0 -1
  320. package/lib/styles/dropdown.js +0 -1048
  321. package/lib/styles/dropdown.js.map +0 -1
  322. package/lib/styles/file-upload.d.ts.map +0 -1
  323. package/lib/styles/file-upload.js.map +0 -1
  324. package/lib/styles/icon.d.ts.map +0 -1
  325. package/lib/styles/icon.js.map +0 -1
  326. package/lib/styles/input.d.ts.map +0 -1
  327. package/lib/styles/input.js.map +0 -1
  328. package/lib/styles/modal.d.ts.map +0 -1
  329. package/lib/styles/modal.js.map +0 -1
  330. package/lib/styles/multiselect.d.ts +0 -6
  331. package/lib/styles/multiselect.d.ts.map +0 -1
  332. package/lib/styles/multiselect.js +0 -837
  333. package/lib/styles/multiselect.js.map +0 -1
  334. package/lib/styles/option.d.ts.map +0 -1
  335. package/lib/styles/option.js.map +0 -1
  336. package/lib/styles/popup.d.ts.map +0 -1
  337. package/lib/styles/popup.js.map +0 -1
  338. package/lib/styles/radio.d.ts.map +0 -1
  339. package/lib/styles/radio.js.map +0 -1
  340. package/lib/styles/resize-observer.d.ts.map +0 -1
  341. package/lib/styles/resize-observer.js.map +0 -1
  342. package/lib/styles/scroll-container.d.ts.map +0 -1
  343. package/lib/styles/scroll-container.js.map +0 -1
  344. package/lib/styles/step.d.ts.map +0 -1
  345. package/lib/styles/step.js.map +0 -1
  346. package/lib/styles/switch.d.ts.map +0 -1
  347. package/lib/styles/switch.js.map +0 -1
  348. package/lib/styles/tab.d.ts.map +0 -1
  349. package/lib/styles/tab.js.map +0 -1
  350. package/lib/styles/tabs.d.ts.map +0 -1
  351. package/lib/styles/tabs.js.map +0 -1
  352. package/lib/styles/tag.d.ts.map +0 -1
  353. package/lib/styles/tag.js.map +0 -1
  354. package/lib/styles/textarea.d.ts.map +0 -1
  355. package/lib/styles/textarea.js.map +0 -1
  356. package/lib/styles/tooltip.d.ts.map +0 -1
  357. package/lib/styles/tooltip.js.map +0 -1
  358. package/lib/styles/wizard.d.ts.map +0 -1
  359. package/lib/styles/wizard.js.map +0 -1
  360. package/lib/types/common.d.ts.map +0 -1
  361. package/lib/types/common.js.map +0 -1
  362. package/lib/utils/calendar-utils.d.ts.map +0 -1
  363. package/lib/utils/calendar-utils.js.map +0 -1
  364. package/lib/utils/custom-scrollbar.d.ts.map +0 -1
  365. package/lib/utils/custom-scrollbar.js.map +0 -1
  366. package/lib/utils/icon-registry.d.ts.map +0 -1
  367. package/lib/utils/icon-registry.js.map +0 -1
  368. package/lib/utils/loader-registry.d.ts.map +0 -1
  369. package/lib/utils/loader-registry.js.map +0 -1
  370. package/lib/utils/locale.d.ts.map +0 -1
  371. package/lib/utils/locale.js.map +0 -1
  372. package/lib/utils/mobile.d.ts.map +0 -1
  373. package/lib/utils/mobile.js.map +0 -1
  374. package/lib/utils/number-format.d.ts.map +0 -1
  375. package/lib/utils/number-format.js.map +0 -1
  376. package/lib/utils/parse-boolean.d.ts +0 -39
  377. package/lib/utils/parse-boolean.d.ts.map +0 -1
  378. package/lib/utils/parse-boolean.js +0 -58
  379. package/lib/utils/parse-boolean.js.map +0 -1
  380. package/lib/utils/positioning.d.ts.map +0 -1
  381. package/lib/utils/positioning.js.map +0 -1
  382. package/lib/utils/property-capture.d.ts.map +0 -1
  383. package/lib/utils/property-capture.js.map +0 -1
  384. package/lib/utils/property-manager.d.ts.map +0 -1
  385. package/lib/utils/property-manager.js.map +0 -1
  386. package/lib/utils/resize-observer.d.ts.map +0 -1
  387. package/lib/utils/resize-observer.js.map +0 -1
  388. package/lib/utils/scroll-lock.d.ts.map +0 -1
  389. package/lib/utils/scroll-lock.js.map +0 -1
  390. package/lib/utils/styles.d.ts.map +0 -1
  391. package/lib/utils/styles.js.map +0 -1
  392. package/lib/version.d.ts.map +0 -1
  393. package/lib/version.js.map +0 -1
@@ -0,0 +1,212 @@
1
+ # Icons
2
+
3
+ `<ty-icon name="mail">` looks the name up in a runtime registry. There are two ways to fill it:
4
+
5
+ - **By name.** Register SVG strings once at startup, then use `name="…"` anywhere.
6
+ - **By slot.** Put the `<svg>` inside the tag. No registry, no JavaScript.
7
+
8
+ Both work on the same page. Size, color, `spin`, `pulse` and `tempo` style the `<ty-icon>` element, so they apply either way.
9
+
10
+ ## How the icon sets are built
11
+
12
+ Every set is generated from its upstream source into flat files of SVG strings: one export (JS) or one `def` (Clojure) per icon. Nothing is fetched at runtime. What you don't reference, the compiler drops.
13
+
14
+ | Set | JS import (`tyrell-components/…`) | Clojure namespace | Icons |
15
+ | --- | --- | --- | --- |
16
+ | Lucide | `icons/lucide` | `tyrell.lucide` | 1,861 |
17
+ | Heroicons outline | `icons/heroicons/outline` | `tyrell.heroicons.outline` | 324 |
18
+ | Heroicons solid | `icons/heroicons/solid` | `tyrell.heroicons.solid` | 324 |
19
+ | Heroicons mini | `icons/heroicons/mini` | `tyrell.heroicons.mini` | 324 |
20
+ | Heroicons micro | `icons/heroicons/micro` | `tyrell.heroicons.micro` | 316 |
21
+ | Material filled | `icons/material/filled` | `tyrell.material.filled` | 2,170 |
22
+ | Material outlined | `icons/material/outlined` | `tyrell.material.outlined` | 2,132 |
23
+ | Material round | `icons/material/round` | `tyrell.material.round` | 2,137 |
24
+ | Material sharp | `icons/material/sharp` | `tyrell.material.sharp` | 2,137 |
25
+ | Material two-tone | `icons/material/two-tone` | `tyrell.material.two-tone` | 2,175 |
26
+ | Font Awesome solid | `icons/fontawesome/solid` | `tyrell.fav6.solid` | 1,984 |
27
+ | Font Awesome regular | `icons/fontawesome/regular` | `tyrell.fav6.regular` | 273 |
28
+ | Font Awesome brands | `icons/fontawesome/brands` | `tyrell.fav6.brands` | 549 |
29
+
30
+ **You pick the names.** Registration maps a name to an SVG string, and `name="…"` uses that name. The set's identifier is only where the SVG comes from: JS exports are camelCase (`chevronDown`), Clojure defs are kebab-case (`chevron-down`), and neither has to match the name you register. Naming by role (`action-down`, `nav-back`) lets you swap the artwork later without touching templates.
31
+
32
+ ## In Clojure
33
+
34
+ Icons ship as one Clojars jar per set: `dev.gersak/tyrell-icons-lucide`, `-heroicons`, `-material` and `-fontawesome`. `dev.gersak/tyrell` includes none of them: add the set jar you need, or `dev.gersak/tyrell-icons` for every set. There's no npm package for them. The files are `.cljc`, so the same defs work in ClojureScript and on the JVM.
35
+
36
+ ```clojure
37
+ (ns app.icons
38
+ (:require [tyrell.icons :as icons]
39
+ [tyrell.lucide :as lucide]
40
+ [tyrell.heroicons.outline :as hero]
41
+ [tyrell.fav6.brands :as brands]))
42
+
43
+ (icons/register!
44
+ {:mail lucide/mail
45
+ :action-down lucide/chevron-down ; any name you like
46
+ :user hero/user-circle
47
+ :github brands/github})
48
+
49
+ [:ty-icon {:name "action-down"}]
50
+ ```
51
+
52
+ `register!` takes keyword or string keys and writes to `window.tyIcons`, which `tyrell.components` sets up. Call it once at startup, before the first render. If `tyrell.js` comes from a `<script>` tag that may load after your code, use `icons/register-async!`: same map, retries until `window.tyIcons` exists.
53
+
54
+ Prefer the npm files? `(:require ["tyrell-components/icons/lucide" :refer [mail]])` works too and tree-shakes the same way. Pass them to `register!` like any string.
55
+
56
+ **Tree-shaking.** A release build (`:advanced`) keeps only the defs you reference. Two ways to lose that:
57
+
58
+ - Building names at runtime, such as `(symbol "lucide" name)`. The compiler can't see which defs you use.
59
+ - Registering a whole namespace, such as `(ns-publics 'tyrell.lucide)`. Every icon ships.
60
+
61
+ If the icons are dynamic, register every candidate up front.
62
+
63
+ **On the server.** Keep the name → SVG map in one namespace and let the extract tool (below) write it out as a static `icons.js`. Pages load that file once, cached, and templates use names like everywhere else:
64
+
65
+ ```clojure
66
+ (ns app.icons
67
+ (:require [tyrell.lucide :as lucide]
68
+ [tyrell.heroicons.outline :as hero]))
69
+
70
+ (def registry
71
+ {:mail lucide/mail
72
+ :action-down lucide/chevron-down
73
+ :user hero/user-circle})
74
+ ```
75
+
76
+ ```clojure
77
+ [:script {:src "https://cdn…/tyrell.js"}]
78
+ [:script {:src "/icons.js" :defer true}] ; right after tyrell.js
79
+ …
80
+ [:ty-icon {:name "action-down"}]
81
+ ```
82
+
83
+ Or inline the def into the tag and skip the registry. Nothing to load first, but every page repeats the SVG:
84
+
85
+ ```clojure
86
+ [:ty-icon {:size "lg"} (h/raw lucide/mail)]
87
+ ```
88
+
89
+ **Ship only what you use on the JVM.** The JVM has no `:advanced` pass, so an uberjar carries every def of every set you depend on (Material alone is 6.6 MB). `tyrell.icons.build/extract` does the trimming ahead of time: clj-kondo's analysis finds the icon vars your code uses (`lucide/mail`, referred names, `require` calls, the `:clj` side of `.cljc`; not strings or comments), and the tool writes trimmed copies of the same namespaces. Your code doesn't change; only the classpath does.
90
+
91
+ ```clojure
92
+ ;; deps.edn
93
+ {:paths ["src" "resources"]
94
+ :aliases
95
+ {:dev {:extra-deps {dev.gersak/tyrell-icons {:mvn/version "…"}}} ; every icon while you work
96
+ :prod {:extra-paths ["gen-icons"]} ; only the used ones
97
+ :icons {:extra-deps {dev.gersak/tyrell-icons {:mvn/version "…"}
98
+ clj-kondo/clj-kondo {:mvn/version "2026.08.04"}}
99
+ :exec-fn tyrell.icons.build/extract
100
+ :exec-args {:paths ["src"]
101
+ :out "gen-icons"
102
+ :registry app.icons/registry ; optional:
103
+ :js-out "resources/public/icons.js"}}}} ; write icons.js
104
+ ```
105
+
106
+ ```bash
107
+ clj -X:icons
108
+ # tyrell.heroicons.outline 1 icon 0.6 KB → gen-icons/tyrell/heroicons/outline.cljc
109
+ # tyrell.lucide 2 icons 0.9 KB → gen-icons/tyrell/lucide.cljc
110
+ # registration script 3 icons 1.2 KB → resources/public/icons.js
111
+ ```
112
+
113
+ Run it before building the uberjar (or commit `gen-icons/`). Keep `gen-icons` off the `:dev` classpath: the copies use the same namespace names, so whichever comes first wins. Names the scan can't see, such as ones built at runtime, go in `:include [tyrell.lucide/heart]`. `:svg-dir "resources/icons"` also writes each icon as `resources/icons/lucide/mail.svg` for template engines that include files. Unknown names are listed at the end, so a typo shows up there.
114
+
115
+ ## In JavaScript
116
+
117
+ Named imports from a set, then `registerIcons` once at the entry point. Works the same for React, Vue, Svelte and vanilla.
118
+
119
+ ```js
120
+ import { registerIcons } from 'tyrell-components/icons/registry'
121
+ import { mail, chevronDown } from 'tyrell-components/icons/lucide'
122
+ import { userCircle } from 'tyrell-components/icons/heroicons/outline'
123
+ import { github } from 'tyrell-components/icons/fontawesome/brands'
124
+
125
+ registerIcons({
126
+ mail,
127
+ 'action-down': chevronDown, // the key is the name, pick any
128
+ user: userCircle,
129
+ github,
130
+ })
131
+ ```
132
+
133
+ ```html
134
+ <ty-icon name="action-down"></ty-icon>
135
+ ```
136
+
137
+ The key is the name you use in `name="…"`. Shorthand `{ chevronDown }` registers the name `chevronDown`; nothing converts it to `chevron-down`.
138
+
139
+ **Tree-shaking.** Only named imports are kept. `import * as lucide from '…/icons/lucide'` followed by `registerIcons(lucide)` ships all 1,861.
140
+
141
+ **SSR.** Register in the same client-only place you import `tyrell-components` (a `'use client'` component, `onMount`, and so on).
142
+
143
+ **CDN script plus npm icons.** If the components come from the CDN `<script>` but the icons from npm, register with `window.tyIcons.register(…)`. `registerIcons` from `…/icons/registry` would be a second copy of the registry that `<ty-icon>` never reads.
144
+
145
+ ## In HTML
146
+
147
+ Server-rendered pages (Flask, Django, Go, Rails, HTMX, Datastar) with the components from the CDN script: build your icons into one small `icons.js` and serve it next to your other static files. The browser fetches it once and caches it, every page and every swapped-in fragment uses the names, and the bundler keeps only what you import.
148
+
149
+ ```js
150
+ // icons.js
151
+ import { mail, chevronDown } from 'tyrell-components/icons/lucide'
152
+ import { userCircle } from 'tyrell-components/icons/heroicons/outline'
153
+
154
+ await customElements.whenDefined('ty-icon')
155
+ window.tyIcons.register({
156
+ mail,
157
+ 'action-down': chevronDown,
158
+ user: userCircle,
159
+ })
160
+ ```
161
+
162
+ ```bash
163
+ npm i -D tyrell-components esbuild
164
+ npx esbuild icons.js --bundle --minify --format=esm --outfile=static/icons.js
165
+ ```
166
+
167
+ ```html
168
+ <script src="https://cdn…/tyrell.js"></script>
169
+ <script type="module" src="/static/icons.js"></script> <!-- right after tyrell.js -->
170
+
171
+ <ty-icon name="action-down"></ty-icon>
172
+ ```
173
+
174
+ Register through `window.tyIcons`, not `registerIcons`: the components come from the CDN script, and an imported registry would be a second copy `<ty-icon>` never reads. Until `icons.js` runs, names render as a faint placeholder; loading it in `<head>` right after `tyrell.js` keeps that to the first frames. Clojure backends get the same file without Node: see `:js-out` [above](#in-clojure).
175
+
176
+ **No build at all?** Slot the SVG straight from your template. `<ty-icon>` only sizes and colors it, so nothing has to load first, at the cost of repeating the SVG on every page:
177
+
178
+ ```html
179
+ <ty-icon size="lg">{% include "icons/mail.svg" %}</ty-icon>
180
+ ```
181
+
182
+ Use `currentColor` for `fill` and `stroke` so `ty-text-*` classes tint the icon.
183
+
184
+ ## Custom SVGs
185
+
186
+ The registry takes any SVG string:
187
+
188
+ ```js
189
+ registerIcons({ 'company-logo': '<svg viewBox="0 0 24 24">…</svg>' })
190
+ ```
191
+
192
+ ```clojure
193
+ (icons/register! {:company-logo "<svg viewBox=\"0 0 24 24\">…</svg>"})
194
+ ```
195
+
196
+ ## Size and motion
197
+
198
+ ```html
199
+ <ty-icon name="loader" size="sm" spin></ty-icon>
200
+ <ty-icon name="heart" size="24" pulse tempo="slow"></ty-icon>
201
+ ```
202
+
203
+ - `size`: `xs` `sm` `md` `lg` `xl` `2xl`, or pixels `12` `14` `16` `18` `20` `24` `32` `48` `64` `80` `96`.
204
+ - `spin`, `pulse`: animations. `tempo`: `slow` or `fast`.
205
+
206
+ ## Why is my icon a faint circle?
207
+
208
+ An unknown name renders a faint placeholder circle, and nothing is logged. Check, in order:
209
+
210
+ 1. **Registered?** In the console, `tyIcons.has('mail')`. `tyIcons.list()` shows every registered name.
211
+ 2. **Same name?** Names match exactly: `chevronDown`, `chevron-down` and `action-down` are three different names.
212
+ 3. **Registered before use?** Registering later works (icons update), but a typo in the key never will.