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,391 @@
1
+ # Building Web Components with tyrell.shim
2
+
3
+ Turn any ClojureScript render function into a standards-compliant Web Component.
4
+
5
+ ## Basic Pattern
6
+
7
+ ```clojure
8
+ (ns app.components
9
+ (:require [tyrell.shim :as shim]))
10
+
11
+ (defn render! [^js el]
12
+ (let [root (shim/ensure-shadow el)]
13
+ (set! (.-innerHTML root) "<p>Hello!</p>")))
14
+
15
+ (shim/define! "my-component"
16
+ {:observed [:name :count] ;; Attributes to watch
17
+ :connected render! ;; Called when added to DOM
18
+ :disconnected cleanup! ;; Called when removed
19
+ :attr (fn [el delta] (render! el)) ;; Batched attribute changes
20
+ :prop (fn [el delta] (render! el)) ;; Batched property changes
21
+ :form-associated true}) ;; Enable form participation
22
+ ```
23
+
24
+ ---
25
+
26
+ ## Configuration Options
27
+
28
+ | Key | Type | Description |
29
+ |-----|------|-------------|
30
+ | `:observed` | `[keyword]` | Attribute names to watch for changes |
31
+ | `:props` | `{keyword any}` | Property accessors (keys define available props) |
32
+ | `:connected` | `(fn [el])` | Lifecycle: element added to DOM |
33
+ | `:disconnected` | `(fn [el])` | Lifecycle: element removed from DOM |
34
+ | `:adopted` | `(fn [el old-doc new-doc])` | Lifecycle: element moved to new document |
35
+ | `:attr` | `(fn [el delta])` | Batched attribute changes (delta is a map) |
36
+ | `:prop` | `(fn [el delta])` | Batched property changes (delta is a map) |
37
+ | `:form-associated` | `boolean` | Enable form participation |
38
+
39
+ ---
40
+
41
+ ## Attribute Helpers
42
+
43
+ ```clojure
44
+ ;; Read attributes
45
+ (shim/attr el "name") ;; Raw string
46
+ (shim/parse-int-attr el "count") ;; Parse as integer
47
+ (shim/parse-float-attr el "ratio") ;; Parse as float
48
+ (shim/parse-bool-attr el "disabled") ;; Presence = true, "false" = false
49
+ (shim/parse-json-attr el "config") ;; Parse JSON to map
50
+ (shim/parse-edn-attr el "data") ;; Parse EDN
51
+
52
+ ;; Write attributes
53
+ (shim/set-attr! el "name" "value")
54
+ (shim/rm-attr! el "disabled")
55
+ ```
56
+
57
+ ---
58
+
59
+ ## With Replicant
60
+
61
+ ```clojure
62
+ (ns app.components
63
+ (:require [replicant.dom :as d]
64
+ [tyrell.shim :as shim]))
65
+
66
+ (defn counter-view [count on-click]
67
+ [:div.ty-elevated.p-6.rounded-lg.space-y-4
68
+ [:div.ty-text++.text-4xl.text-center count]
69
+ [:div.flex.gap-2.justify-center
70
+ [:ty-button {:flavor "neutral" :on {:click #(on-click dec)}} "-"]
71
+ [:ty-button {:flavor "primary" :on {:click #(on-click inc)}} "+"]]])
72
+
73
+ (defn render! [^js el]
74
+ (let [root (shim/ensure-shadow el)
75
+ get-count #(or (.-_count el) 0)
76
+ set-count! (fn [f]
77
+ (set! (.-_count el) (f (get-count)))
78
+ (render! el))]
79
+ (d/render root (counter-view (get-count) set-count!))))
80
+
81
+ (shim/define! "replicant-counter"
82
+ {:observed [:initial]
83
+ :connected (fn [el]
84
+ (set! (.-_count el) (or (shim/parse-int-attr el "initial") 0))
85
+ (render! el))
86
+ :attr (fn [el {:strs [initial]}]
87
+ (when initial
88
+ (set! (.-_count el) (js/parseInt initial))
89
+ (render! el)))})
90
+ ```
91
+
92
+ ```html
93
+ <replicant-counter initial="10"></replicant-counter>
94
+ ```
95
+
96
+ ---
97
+
98
+ ## With UIx
99
+
100
+ ```clojure
101
+ (ns app.components
102
+ (:require [uix.core :as uix :refer [defui $]]
103
+ [uix.dom]
104
+ [tyrell.shim :as shim]))
105
+
106
+ (defui counter [{:keys [initial]}]
107
+ (let [[count set-count] (uix/use-state (or initial 0))]
108
+ ($ :div.ty-elevated.p-6.rounded-lg.space-y-4
109
+ ($ :div.ty-text++.text-4xl.text-center count)
110
+ ($ :div.flex.gap-2.justify-center
111
+ ($ :ty-button {:flavor "neutral" :on-click #(set-count dec)} "-")
112
+ ($ :ty-button {:flavor "primary" :on-click #(set-count inc)} "+")))))
113
+
114
+ (defn render! [^js el]
115
+ (let [root (shim/ensure-shadow el)
116
+ initial (shim/parse-int-attr el "initial")]
117
+ ;; UIx needs a root - create once, reuse
118
+ (when-not (.-_uixRoot el)
119
+ (set! (.-_uixRoot el) (uix.dom/create-root root)))
120
+ (uix.dom/render-root (.-_uixRoot el)
121
+ ($ counter {:initial initial}))))
122
+
123
+ (shim/define! "uix-counter"
124
+ {:observed [:initial]
125
+ :connected render!
126
+ :disconnected (fn [el]
127
+ (when-let [root (.-_uixRoot el)]
128
+ (uix.dom/unmount-root root)))})
129
+ ```
130
+
131
+ ---
132
+
133
+ ## With Reagent
134
+
135
+ ```clojure
136
+ (ns app.components
137
+ (:require [reagent.core :as r]
138
+ [reagent.dom :as rdom]
139
+ [tyrell.shim :as shim]))
140
+
141
+ (defn counter [initial-count]
142
+ (let [count (r/atom (or initial-count 0))]
143
+ (fn []
144
+ [:div.ty-elevated.p-6.rounded-lg.space-y-4
145
+ [:div.ty-text++.text-4xl.text-center @count]
146
+ [:div.flex.gap-2.justify-center
147
+ [:ty-button {:flavor "neutral" :on-click #(swap! count dec)} "-"]
148
+ [:ty-button {:flavor "primary" :on-click #(swap! count inc)} "+"]]])))
149
+
150
+ (defn render! [^js el]
151
+ (let [root (shim/ensure-shadow el)
152
+ initial (shim/parse-int-attr el "initial")]
153
+ (rdom/render [counter initial] root)))
154
+
155
+ (shim/define! "reagent-counter"
156
+ {:observed [:initial]
157
+ :connected render!
158
+ :disconnected (fn [el]
159
+ (rdom/unmount-component-at-node (.-shadowRoot el)))})
160
+ ```
161
+
162
+ ---
163
+
164
+ ## Shadow DOM & Styling
165
+
166
+ ### Inline Styles
167
+
168
+ ```clojure
169
+ (ns app.components
170
+ (:require [tyrell.shim :as shim]
171
+ [tyrell.css :refer [ensure-styles!]]))
172
+
173
+ (def my-styles
174
+ ".container { padding: 1rem; }
175
+ .title { font-size: 1.5rem; }")
176
+
177
+ (defn render! [^js el]
178
+ (let [root (shim/ensure-shadow el)]
179
+ ;; Inject styles into shadow DOM (deduped by ID)
180
+ (ensure-styles! root my-styles "my-component")
181
+
182
+ ;; Tyrell design system classes work inside shadow DOM
183
+ (set! (.-innerHTML root)
184
+ "<div class='ty-elevated p-4 rounded-lg'>
185
+ <h2 class='ty-text+ mb-2'>Title</h2>
186
+ <p class='ty-text-'>Content here</p>
187
+ </div>")))
188
+ ```
189
+
190
+ ### defstyles Macro (Compile-time CSS)
191
+
192
+ Load CSS files at compile time for better organization:
193
+
194
+ ```clojure
195
+ (ns app.components.card
196
+ (:require [tyrell.shim :as shim]
197
+ [tyrell.css :refer [ensure-styles!]])
198
+ (:require-macros [tyrell.css :refer [defstyles]]))
199
+
200
+ ;; Loads app/components/card.css at compile time
201
+ ;; Creates a CSSStyleSheet for efficient shadow DOM adoption
202
+ (defstyles card-styles)
203
+
204
+ ;; Or specify a custom path
205
+ (defstyles card-styles "custom/path/card.css")
206
+
207
+ (defn render! [^js el]
208
+ (let [root (shim/ensure-shadow el)]
209
+ (ensure-styles! root card-styles "app-card")
210
+ ;; render...
211
+ ))
212
+ ```
213
+
214
+ Create the CSS file alongside your ClojureScript:
215
+
216
+ ```css
217
+ /* app/components/card.css */
218
+ :host {
219
+ display: block;
220
+ }
221
+
222
+ .card {
223
+ padding: var(--ty-spacing-4);
224
+ border-radius: var(--ty-radius-lg);
225
+ background: var(--ty-surface-elevated);
226
+ }
227
+
228
+ .card-title {
229
+ font-size: var(--ty-text-lg);
230
+ color: var(--ty-text-strong);
231
+ }
232
+ ```
233
+
234
+ Benefits:
235
+ - CSS is bundled at compile time (no runtime fetch)
236
+ - Uses `CSSStyleSheet` for efficient style sharing
237
+ - CSS variables from Tyrell design system are available
238
+ - Better editor support with separate `.css` files
239
+
240
+ ---
241
+
242
+ ## Form Participation
243
+
244
+ ```clojure
245
+ (shim/define! "my-input"
246
+ {:observed [:value :name]
247
+ :form-associated true
248
+ :connected (fn [el]
249
+ ;; Access ElementInternals
250
+ (let [internals (.-_internals el)]
251
+ ;; Set form value
252
+ (.setFormValue internals "initial-value")
253
+ ;; Access associated form
254
+ (.-form internals)))})
255
+ ```
256
+
257
+ ---
258
+
259
+ ## Properties vs Attributes
260
+
261
+ **Attributes** are strings in HTML. **Properties** are JS values on the element.
262
+
263
+ ```clojure
264
+ ;; Define properties
265
+ (shim/define! "my-component"
266
+ {:props {:config nil ;; Will create .config property
267
+ :on-change nil} ;; Will create .onChange property
268
+ :prop (fn [el delta]
269
+ ;; delta = {"config" new-value, "onChange" new-fn}
270
+ (render! el))})
271
+
272
+ ;; Set properties programmatically
273
+ (shim/set-props! el {:config {:foo "bar"}
274
+ :on-change #(js/console.log %)})
275
+
276
+ ;; Read properties
277
+ (shim/get-props el) ;; => {:config {:foo "bar"} ...}
278
+ ```
279
+
280
+ ---
281
+
282
+ ## Hot Reload
283
+
284
+ The shim supports shadow-cljs hot reload automatically:
285
+
286
+ ```clojure
287
+ (ns app.components
288
+ (:require [tyrell.shim :as shim]))
289
+
290
+ ;; Re-defining a component in dev mode refreshes all instances
291
+ (shim/define! "my-component" {...})
292
+
293
+ ;; Optional: Add hooks for cleanup/setup
294
+ (defn ^:dev/before-load stop []
295
+ (js/console.log "Preparing for reload..."))
296
+
297
+ (defn ^:dev/after-load start []
298
+ (js/console.log "Reloaded!"))
299
+ ```
300
+
301
+ ---
302
+
303
+ ## Initial Attributes (React-compatible)
304
+
305
+ For one-time initialization attributes that shouldn't override user state:
306
+
307
+ ```clojure
308
+ (defn render! [^js el]
309
+ ;; Only read these on first render
310
+ (let [initial (shim/get-initial-attrs el
311
+ {:view-year js/parseInt
312
+ :view-month js/parseInt
313
+ :min-date parse-date})]
314
+ (when (seq initial)
315
+ (apply-initial-state! el initial))
316
+
317
+ (render-view! el)))
318
+ ```
319
+
320
+ ---
321
+
322
+ ## Complete Example: Date Input
323
+
324
+ ```clojure
325
+ (ns app.date-input
326
+ (:require [replicant.dom :as d]
327
+ [tyrell.shim :as shim]
328
+ [tyrell.css :refer [ensure-styles!]]))
329
+
330
+ (def styles
331
+ ".wrapper { position: relative; }
332
+ .popup { position: absolute; top: 100%; left: 0; }")
333
+
334
+ (defn date-input-view [{:keys [value label on-change on-toggle open?]}]
335
+ [:div.wrapper
336
+ [:ty-input
337
+ {:label label
338
+ :value value
339
+ :readonly true
340
+ :on {:click on-toggle}}]
341
+ (when open?
342
+ [:div.popup.ty-floating.p-2.rounded-lg.shadow-lg
343
+ [:ty-calendar
344
+ {:value value
345
+ :on {:change #(on-change (.. % -detail -value))}}]])])
346
+
347
+ (defn render! [^js el]
348
+ (let [root (shim/ensure-shadow el)]
349
+ (ensure-styles! root styles "date-input")
350
+ (d/render root
351
+ (date-input-view
352
+ {:value (.-_value el)
353
+ :label (or (shim/attr el "label") "Date")
354
+ :open? (.-_open el)
355
+ :on-toggle #(do (set! (.-_open el) (not (.-_open el)))
356
+ (render! el))
357
+ :on-change #(do (set! (.-_value el) %)
358
+ (set! (.-_open el) false)
359
+ (.dispatchEvent el (js/CustomEvent. "change"
360
+ #js {:detail #js {:value %}}))
361
+ (render! el))}))))
362
+
363
+ (shim/define! "app-date-input"
364
+ {:observed [:value :label]
365
+ :props {:value nil}
366
+ :connected (fn [el]
367
+ (set! (.-_value el) (shim/attr el "value"))
368
+ (set! (.-_open el) false)
369
+ (render! el))
370
+ :attr (fn [el delta]
371
+ (when-let [v (get delta "value")]
372
+ (set! (.-_value el) v))
373
+ (render! el))
374
+ :prop (fn [el delta]
375
+ (when-let [v (get delta "value")]
376
+ (set! (.-_value el) v))
377
+ (render! el))})
378
+ ```
379
+
380
+ ```html
381
+ <app-date-input label="Start Date" value="2025-01-15"></app-date-input>
382
+ ```
383
+
384
+ ---
385
+
386
+ ## See Also
387
+
388
+ - [Code Splitting Guide](CODE_SPLITTING.md) - Lazy loading and bundle optimization (in guides/)
389
+ - [Tyrell Components Source](components/ty/components/) - Reference implementations
390
+ - [tyrell.shim Source](src/ty/shim.cljs) - Full API
391
+ - [tyrell.css](src/ty/css.cljs) - Style injection utilities