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,124 @@
1
+ # Tyrell — rules for coding agents
2
+
3
+ <!-- Source of truth. Ships in tyrell-components and tyrell-react as AGENTS.md, stamped with the package version (packages/core/scripts/pack-agent-docs.mjs); its facts are checked against source before every pack (check-agent-docs.mjs). Keep it under 9,000 characters: the Claude Code plugin injects it whole. -->
4
+
5
+ For apps that **use** Tyrell (`tyrell-components`, `tyrell-react`, `dev.gersak/tyrell`). Version: <!--tyrell-version-->master (unreleased)<!--/tyrell-version-->. Not for editing Tyrell's own source.
6
+
7
+ Your training data barely knows Tyrell; Tailwind/shadcn/Bootstrap habits are wrong here, and these rules win. The full docs for this version (`guides/`, `CHANGELOG.md`) ship next to this file: grep them before guessing.
8
+
9
+ ## 1. If Tyrell has a component, use it
10
+
11
+ Never hand-roll a control: no `.btn`, `.pill`, `.badge`, `.chip`, `.seg`, `.toggle`, `.drawer`, `.dropdown` or `.tabs` CSS, and no native `<button>`, `<select>`, `<input>`, `<textarea>` or `<dialog>` in app markup.
12
+
13
+ | Need | Use |
14
+ |---|---|
15
+ | Any action (submit, open, delete, icon) | `ty-button` |
16
+ | Status, category, count, filter chip | `ty-tag` (§4) |
17
+ | Pick one or many from a list | `ty-select` + `ty-option`; `multiple` + `ty-selected-options` for chips |
18
+ | A few choices (up to 7) instead of a segmented control | `ty-select` with `slot="trigger"` (§6) |
19
+ | Switch views or sections | `ty-tabs` + `ty-tab` (scrolls by default; `fixed` for 2–5 short labels) |
20
+ | Steps | `ty-wizard` + `ty-step` |
21
+ | On/off | `ty-switch`; in a form list `ty-checkbox` |
22
+ | One of several, all visible | `ty-radio-group` + `ty-radio` |
23
+ | Text, number, money, percent, big numbers | `ty-input` (`type="currency"`, `"percent"`, `"compact"`) |
24
+ | Multi-line text | `ty-textarea` |
25
+ | Date or date-time | `ty-date-picker`; month grid `ty-calendar` |
26
+ | Dialog, drawer, bottom sheet | `ty-modal` (`sheet`: full screen, slides up below 768px) |
27
+ | Anchored panel or menu | `ty-popup` |
28
+ | Hint on hover/focus | `ty-tooltip`, not `title=` |
29
+ | Copyable value | `ty-copy` |
30
+ | File drop/pick | `ty-file-upload` |
31
+ | Reorder, kanban | `ty-sortable` |
32
+ | Scroll area with edge shadows | `ty-scroll-container` |
33
+ | Icon | `ty-icon` |
34
+ | Field label, error text | the `label` / `error` attribute on the component |
35
+
36
+ Plain HTML with Tyrell color classes and Tailwind is right for layout, cards and panels, tables, sidebars and nav, headings and text, KPI/stat blocks, empty states and links.
37
+
38
+ ## 2. A prototype sets the look, Tyrell sets the widgets
39
+
40
+ Given an HTML or Figma prototype, keep its layout, spacing, typography and palette, and build every control from §1: `.btn` → `ty-button`, `.pill`/`.badge` → `ty-tag`, `.seg` → `ty-select` trigger or `ty-tabs`, `.drawer` → `ty-modal`. Bring its palette in through the theme (§7). "Match the prototype" never means copying its component CSS or its hex colors.
41
+
42
+ ## 3. Sizes (px)
43
+
44
+ | | xs | sm (default) | md | lg | xl |
45
+ |---|---|---|---|---|---|
46
+ | Field: `ty-input`, `ty-select`, `ty-date-picker`, `ty-copy` | 28 | 32 | 36 | 40 | 44 |
47
+ | `ty-button` | 24 | 28 | 32 | 36 | 40 |
48
+ | `ty-tag` | 20 | 24 | 28 | 32 | 36 |
49
+
50
+ Below 640px fields drop `lg` to 36 and `xl` to 40 (below 480px `xl` to 36). Buttons and tags don't change.
51
+
52
+ - **Field and button in one row: field `md` + button `lg`** (both 36). It lines up at every width. Smaller row: field `sm` + button `md` (32). Avoid field `lg` + button `xl`: it breaks below 640px.
53
+ - Button inside a field's `end` slot: the field's size name.
54
+ - The defaults never line up (field 32, button 28): in a row, set `size` on both.
55
+ - Tag beside a button or field: match heights (tag `lg` = button `md` = field `sm`; tag `xl` = button `lg` = field `md`). In tables and dense lists: `sm`.
56
+ - Fields are `width: 100%`: in a flex row the field takes the free space, the button keeps its label width.
57
+ - A `ty-button` that is a direct child of a flex column stretches; add `self-start`.
58
+
59
+ ## 4. Tags
60
+
61
+ - For status (semantic flavor), category or type (neutral), counts, filter chips (`clickable`, `dismissible`) and picked values (`ty-selected-options` renders them for `ty-select multiple`).
62
+ - Not for decoration, headings, navigation, actions (`ty-button`) or sentences.
63
+ - The label says what it is: "Overdue", "Retail", "3 units". If a reader can't tell what a tag means, remove it. No unexplained tags in top bars.
64
+ - `neutral` by default. A semantic flavor only for state, with one meaning per flavor across the app: `success` ok/active, `warning` needs attention, `danger` problem, `primary` selected/emphasis.
65
+ - Tags hug their content. Don't stretch them to full width.
66
+
67
+ ## 5. Surfaces
68
+
69
+ - From the back: `ty-canvas` (app background) → `ty-content` (main area) → `ty-elevated` (cards, panels, sidebars) → `ty-floating` (modals, popovers, menus). `ty-input` is the background of form controls.
70
+ - `ty-modal` and `ty-popup` are transparent: put a `ty-floating` panel inside, with your own padding and radius.
71
+ - Dividers between rows inside a surface: `ty-divide-y` / `ty-divide-x`, not Tailwind's `divide-*`.
72
+ - `ty-bg-*` is for small accents (a callout box, a highlighted row, a status dot). Never for cards, and never to fake a button or badge.
73
+
74
+ ## 6. Dropdowns (`ty-select`)
75
+
76
+ - Options are `ty-option` (not `<option>` or `ty-tag`). The selection is the select's `value`; `<ty-option selected>` selects nothing, so server-rendered HTML carries `value="…"`.
77
+ - **Up to 7 options: give it a trigger** (`slot="trigger"`). The search row only appears above 7 options, so a short list doesn't need a form field. In toolbars and filter bars, `compact` is the plain alternative.
78
+ - More options, or typed search: the default field. `external-search` for remote lists, `allow-create` for a tags input.
79
+ - A slotted trigger keeps the value, form submit, ARIA, keyboard and the error line. A trigger that takes focus (`ty-button`, `clickable` tag) is the tab stop; else the select is. You render the trigger: show the current value in it and update it on `change`. No × button; call `clear()`.
80
+ - The list is at least 320px wide, or as wide as the trigger; `--ty-select-popup-width` sets it.
81
+ - **Status picker:** the trigger is a `ty-tag` in the current option's flavor, with a chevron.
82
+
83
+ ```html
84
+ <ty-select name="status" value="active">
85
+ <ty-tag slot="trigger" flavor="success">Active <ty-icon slot="end" name="chevron-down"></ty-icon></ty-tag>
86
+ <ty-option value="active">Active</ty-option>
87
+ <ty-option value="paused">Paused</ty-option>
88
+ </ty-select>
89
+ ```
90
+
91
+ - **Sort, view or filter switch:** the trigger is a `ty-button` sized for its row: icon, current label, chevron.
92
+
93
+ ```html
94
+ <ty-select name="sort" value="newest">
95
+ <ty-button slot="trigger" size="lg"><ty-icon slot="start" name="arrow-down-up"></ty-icon> Newest <ty-icon slot="end" name="chevron-down"></ty-icon></ty-button>
96
+ <ty-option value="newest">Newest</ty-option>
97
+ <ty-option value="oldest">Oldest</ty-option>
98
+ </ty-select>
99
+ ```
100
+
101
+ ## 7. Colors and theme
102
+
103
+ - Colors come only from Tyrell classes; layout, spacing and type from Tailwind. Never `bg-blue-500`, `text-gray-900` or hex colors in markup.
104
+ - Text: `ty-text++`, `ty-text+`, `ty-text`, `ty-text-`, `ty-text--`. Semantic: `ty-text-{flavor}`, `ty-bg-{flavor}` (`+` stronger, `-` softer), `ty-border-{flavor}`.
105
+ - Flavors: `primary`, `success`, `danger`, `warning`, `neutral`. There is no `info`, `secondary` or `accent`. For a project flavor `X`, define `--ty-color-X`, `--ty-bg-X`, `--ty-border-X` (and `--ty-solid-X` for solid buttons), then use `flavor="X"`.
106
+ - Brand: load `tyrell-theme.css` after `tyrell.css` and set `--ty-primary-seed: oklch(0.5 <chroma> <hue>)` on `:root`. Not just `--ty-primary-hue`/`--ty-primary-chroma` on `:root`: dark mode re-declares them and the brand vanishes there.
107
+
108
+ ## 8. Events, properties, icons, SSR
109
+
110
+ - The payload is on `event.detail`: `.value` (`.values` for `multiple`), `.checked` for checkbox and switch. Never `event.value`. `ty-tabs` fires `ty-tab-change` with `detail.activeId`.
111
+ - Booleans, arrays and objects are properties; strings can be attributes. React: props via `tyrell-react`. Vue: `:prop`. Svelte: `prop:`. Reagent `:>` and Helix `$` need camelCase props; UIx translates kebab-case.
112
+ - `<ty-icon name="chevron-down">` needs registering first, and the key is the name: `registerIcons({ 'chevron-down': chevronDown })`, named imports from `tyrell-components/icons/lucide` (never `import *`). CLJS: `(tyrell.icons/register! {...})`. Server-rendered apps can slot an inline `<svg>` (`currentColor`) into `<ty-icon>` instead.
113
+ - `customElements.define` needs a browser: import Tyrell only in client code (`'use client'`, `.client.ts`, `if (browser)`).
114
+
115
+ ## 9. Your stack
116
+
117
+ - React: `tyrell-react` (`TyButton`, `TySelect`, …). ClojureScript: `dev.gersak/tyrell`, which installs this npm package; UIx, Reagent, Helix via `tyrell.react`, Replicant and vanilla as raw `<ty-*>` hiccup. Server-rendered (HTMX, Datastar, templates): plain `<ty-*>` markup; fields post like native ones.
118
+ - Guides: `TY_GUIDE.md` (every attribute, slot, event), `CSS_GUIDE.md` (colors, surfaces, sizing), `js/` (React, Vue, Svelte, HTMX), `clj/`, `DATASTAR_TY_GUIDE.md`.
119
+
120
+ ## 10. Before you say done
121
+
122
+ - Search your markup and CSS for `.btn`, `.pill`, `.chip`, `.badge`, `.seg`, `.drawer`, `<button`, `<select`, `<dialog`, hex colors and Tailwind color classes. Each hit needs a reason or a Tyrell replacement.
123
+ - Check every row where a field and a button sit together (§3).
124
+ - Look at the result in a real browser, with the real data flow running.
@@ -0,0 +1,53 @@
1
+ # Tyrell for AI Agents
2
+
3
+ Treasure map. Find your context, follow the link.
4
+
5
+ ## I'm building in…
6
+
7
+ | Context | Read |
8
+ |---|---|
9
+ | Plain HTML / vanilla JS | [TY_GUIDE.md](TY_GUIDE.md) → [js/JAVASCRIPT_GUIDE.md](js/JAVASCRIPT_GUIDE.md) |
10
+ | React | [js/REACT_TY_GUIDE.md](js/REACT_TY_GUIDE.md) |
11
+ | Vue 3 / Nuxt | [js/VUE_TY_GUIDE.md](js/VUE_TY_GUIDE.md) |
12
+ | Svelte 5 / SvelteKit | [js/SVELTE_TY_GUIDE.md](js/SVELTE_TY_GUIDE.md) |
13
+ | ClojureScript (UIx) | [clj/UIX_TY_GUIDE.md](clj/UIX_TY_GUIDE.md) |
14
+ | ClojureScript (Reagent / re-frame) | [clj/REAGENT_TY_GUIDE.md](clj/REAGENT_TY_GUIDE.md) |
15
+ | ClojureScript (Helix) | [clj/HELIX_TY_GUIDE.md](clj/HELIX_TY_GUIDE.md) |
16
+ | ClojureScript (Replicant / vanilla) | [clj/REPLICANT_TY_GUIDE.md](clj/REPLICANT_TY_GUIDE.md) |
17
+ | ClojureScript (quickstart, two tracks) | [clj/QUICKSTART.md](clj/QUICKSTART.md) |
18
+ | ClojureScript (substrate reference) | [clj/CLOJURESCRIPT_GUIDE.md](clj/CLOJURESCRIPT_GUIDE.md) |
19
+ | HTMX | [js/HTMX_TY_GUIDE.md](js/HTMX_TY_GUIDE.md) |
20
+ | Datastar / SSE | [DATASTAR_TY_GUIDE.md](DATASTAR_TY_GUIDE.md) |
21
+ | Other framework | [TY_GUIDE.md](TY_GUIDE.md) (web components are universal) |
22
+
23
+ ## I need to know…
24
+
25
+ | Question | Read |
26
+ |---|---|
27
+ | What components exist, what props they take | [TY_GUIDE.md](TY_GUIDE.md) |
28
+ | Colors, surfaces, text classes, dark mode | [CSS_GUIDE.md](CSS_GUIDE.md) |
29
+ | Bundlers, subpath imports, code splitting, SSR | [js/JAVASCRIPT_GUIDE.md](js/JAVASCRIPT_GUIDE.md) |
30
+ | Icons: sets, registration, tree-shaking | [ICONS_GUIDE.md](ICONS_GUIDE.md) |
31
+ | Routing in CLJS apps | [clj/ROUTING_GUIDE.md](clj/ROUTING_GUIDE.md) |
32
+ | Internationalization in CLJS | [clj/I18N_GUIDE.md](clj/I18N_GUIDE.md) |
33
+ | Responsive layout in CLJS | [clj/LAYOUT_GUIDE.md](clj/LAYOUT_GUIDE.md) |
34
+ | CLJS web component shim | [clj/COMPONENT_GUIDE.md](clj/COMPONENT_GUIDE.md) |
35
+ | Lazy loading with shadow-cljs | [clj/CODE_SPLITTING.md](clj/CODE_SPLITTING.md) |
36
+
37
+ ## Rules
38
+
39
+ Read [AGENT_INSTRUCTIONS.md](AGENT_INSTRUCTIONS.md) before writing markup: use the Tyrell component for every control, size pairs, tags, surfaces, dropdown triggers, theming, events, icons, SSR. It ships in every npm version as `AGENTS.md`; prefer `node_modules/tyrell-components/AGENTS.md`, which matches the installed version.
40
+
41
+ ## For agents working in a *consumer* project
42
+
43
+ If the user is using Tyrell in their own project (not editing Tyrell itself), add this line to their `CLAUDE.md`:
44
+
45
+ ```
46
+ @node_modules/tyrell-components/AGENTS.md
47
+ ```
48
+
49
+ Other agents and CDN-only projects: `packages/core/README.md` → "AI coding agents".
50
+
51
+ ## For agents working *on* Tyrell itself
52
+
53
+ Read the repo's `CLAUDE.md` if present; releases go through `scripts/publish.sh`. Do not edit generated files (`packages/core/lib/`, `packages/core/dist/`, `packages/core/src/icons/*.ts`).