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
@@ -1,297 +1,271 @@
1
- /**
2
- * TyComponent - Base class for all Ty web components
3
- *
4
- * Provides unified property/attribute lifecycle management:
5
- * - Single code path for all property updates
6
- * - Declarative property configuration
7
- * - Predictable rendering behavior
8
- * - Form association support
9
- * - Property change events via 'prop:change' (separate from user 'change' events)
10
- */
11
1
  import { PropertyManager } from '../utils/property-manager.js';
12
- /**
13
- * Base class for all Ty components with unified property lifecycle
14
- */
2
+ import { ValidityController } from '../utils/validity.js';
3
+ import { upgradeProperties } from '../utils/upgrade-properties.js';
4
+ export { upgradeProperties };
5
+ const labelClickHosts = new WeakSet();
6
+ const directClicks = new WeakMap();
7
+ let labelForwardsWatched = false;
8
+ function watchLabelForwards() {
9
+ if (labelForwardsWatched)
10
+ return;
11
+ labelForwardsWatched = true;
12
+ window.addEventListener('click', (e) => {
13
+ const path = e.composedPath();
14
+ const host = path.find((n) => labelClickHosts.has(n));
15
+ if (!host)
16
+ return;
17
+ const at = `${e.clientX},${e.clientY}`;
18
+ if (path[0] !== host) {
19
+ directClicks.set(host, at);
20
+ setTimeout(() => { if (directClicks.get(host) === at)
21
+ directClicks.delete(host); });
22
+ }
23
+ else if (directClicks.get(host) === at) {
24
+ e.stopImmediatePropagation();
25
+ }
26
+ }, true);
27
+ }
15
28
  export class TyComponent extends HTMLElement {
16
- constructor() {
17
- super();
18
- // Track if component is connected
19
- this._connected = false;
20
- // Track if initial render happened
21
- this._rendered = false;
22
- // Initialize property manager
23
- const ctor = this.constructor;
24
- this.props = new PropertyManager(ctor.properties);
25
- // Form association
26
- this._internals = this.attachInternals();
27
- // Setup shadow DOM (subclasses can override by checking if shadowRoot exists)
28
- if (!this.shadowRoot) {
29
- this.attachShadow({ mode: 'open' });
30
- }
31
- }
32
- /**
33
- * Define which attributes to observe
34
- * Auto-generated from property configuration
35
- * Returns kebab-case attribute names (e.g., 'minHeight' -> 'min-height')
36
- */
37
- static get observedAttributes() {
38
- const attrs = [];
39
- for (const [name, config] of Object.entries(this.properties)) {
40
- attrs.push(name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase());
41
- // Include alias names so attributeChangedCallback fires for them
42
- if (config.aliases) {
43
- for (const alias of Object.keys(config.aliases)) {
44
- attrs.push(alias);
45
- }
46
- }
47
- }
48
- return attrs;
49
- }
50
- /**
51
- * Unified property setter
52
- * Use this in your property setters instead of direct field assignment
53
- */
54
- setProperty(name, value) {
55
- const change = this.props.updateProperty(name, value, 'property');
56
- if (change) {
57
- // Sync to attribute (kebab-case)
58
- this._syncPropertyToAttribute(change);
59
- // Handle the change through unified lifecycle
60
- this._handlePropertyChanges([change]);
61
- }
62
- }
63
- /**
64
- * Unified property getter
65
- * Use this in your property getters
66
- */
67
- getProperty(name) {
68
- return this.props.get(name);
69
- }
70
- /**
71
- * Sync property value to HTML attribute
72
- */
73
- _syncPropertyToAttribute(change) {
74
- const { name, newValue } = change;
75
- const config = this.props.getConfig(name);
76
- if (!config)
77
- return;
78
- // Convert to kebab-case for attribute
79
- const attrName = this._toKebabCase(name);
80
- // Handle different types
81
- if (config.type === 'boolean') {
82
- if (newValue) {
83
- this.setAttribute(attrName, '');
84
- }
85
- else {
86
- this.removeAttribute(attrName);
87
- }
88
- }
89
- else if (newValue === null || newValue === undefined) {
90
- this.removeAttribute(attrName);
91
- }
92
- else if (typeof newValue === 'object') {
93
- this.setAttribute(attrName, JSON.stringify(newValue));
94
- }
95
- else {
96
- this.setAttribute(attrName, String(newValue));
97
- }
98
- }
99
- /**
100
- * Convert camelCase to kebab-case
101
- */
102
- _toKebabCase(str) {
103
- return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
104
- }
105
- /**
106
- * Convert kebab-case to camelCase
107
- */
108
- _toCamelCase(str) {
109
- return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
110
- }
111
- /**
112
- * Attribute changed callback - unified for all components
113
- */
114
- attributeChangedCallback(name, oldValue, newValue) {
115
- if (oldValue === newValue)
116
- return;
117
- // Check if this is an alias (e.g., not-clearable)
118
- let change = this.props.handleAlias(name, newValue);
119
- if (!change) {
120
- // Properties may be registered with kebab-case (e.g., 'display-month')
121
- // or camelCase. Try the attribute name as-is first, then camelCase.
122
- const camelName = this._toCamelCase(name);
123
- const propName = this.props.hasConfig(name) ? name : camelName;
124
- change = this.props.updateProperty(propName, newValue, 'attribute');
125
- }
126
- if (change) {
127
- this._handlePropertyChanges([change]);
128
- }
129
- }
130
- /**
131
- * Connected callback - handle pre-set properties
132
- */
133
- connectedCallback() {
134
- this._connected = true;
135
- // Capture pre-set properties (React/Vue/Reagent pattern)
136
- const preSetProps = this._capturePreSetProperties();
137
- // Batch process all pre-set properties
138
- if (preSetProps.length > 0) {
139
- this._handlePropertyChanges(preSetProps);
140
- }
141
- // Initialize component (subclass hook)
142
- this.onConnect();
143
- // Initial render
144
- if (!this._rendered) {
145
- this.render();
146
- this._rendered = true;
147
- }
148
- }
149
- /**
150
- * Disconnected callback
151
- */
152
- disconnectedCallback() {
153
- this._connected = false;
154
- this.onDisconnect();
155
- }
156
- /**
157
- * Capture properties that were set before connectedCallback
158
- * (React, Vue, Reagent set properties before element is connected)
159
- */
160
- _capturePreSetProperties() {
161
- const changes = [];
162
- const ctor = this.constructor;
163
- for (const propName of Object.keys(ctor.properties)) {
164
- // Check if property was set on the element before connection
165
- const descriptor = Object.getOwnPropertyDescriptor(this, propName);
166
- if (descriptor && descriptor.value !== undefined) {
167
- const change = this.props.updateProperty(propName, descriptor.value, 'property');
168
- if (change) {
169
- changes.push(change);
170
- }
171
- }
172
- }
173
- return changes;
174
- }
175
- /**
176
- * THE CORE LIFECYCLE METHOD
177
- * All property changes flow through here
178
- *
179
- * Lifecycle order:
180
- * 1. Update internal state (onPropertiesChanged hook)
181
- * 2. Sync form value (if formValue property changed)
182
- * 3. Render (if visual property changed)
183
- * 4. Emit events (if emitChange property changed)
184
- */
185
- _handlePropertyChanges(changes) {
186
- if (changes.length === 0)
187
- return;
188
- // 1. Update internal state (subclass-specific)
189
- this.onPropertiesChanged(changes);
190
- // 2. Sync form value if needed
191
- const formValueChanged = changes.some(c => this.props.isFormValue(c.name));
192
- if (formValueChanged) {
193
- this.updateFormValue();
194
- }
195
- // 3. Render only if visual properties changed AND component is connected
196
- const visualChanged = changes.some(c => this.props.isVisual(c.name));
197
- if (visualChanged && this._connected) {
198
- this.render();
199
- }
200
- // 4. Emit change events if configured
201
- this._emitChangeEvents(changes);
202
- }
203
- /**
204
- * Emit property change events for properties that require it
205
- * Uses 'prop:change' event to avoid conflicts with user interaction 'change' events
206
- */
207
- _emitChangeEvents(changes) {
208
- for (const change of changes) {
209
- if (this.props.shouldEmitChange(change.name)) {
210
- this.dispatchEvent(new CustomEvent('prop:change', {
211
- detail: {
212
- property: change.name,
213
- oldValue: change.oldValue,
214
- newValue: change.newValue
215
- },
216
- bubbles: true,
217
- composed: true
218
- }));
219
- }
220
- }
221
- }
222
- /**
223
- * Update form value via ElementInternals
224
- * Subclasses can override to customize form value
225
- */
226
- updateFormValue() {
227
- const formValue = this.getFormValue();
228
- this._internals.setFormValue(formValue);
229
- }
230
- /**
231
- * Get the form value for this component
232
- * Default: return 'value' property
233
- * Override for custom behavior
234
- */
235
- getFormValue() {
236
- return this.props.get('value') ?? null;
237
- }
238
- /**
239
- * Hook: Called when properties change
240
- * Subclasses can override to update internal state
241
- *
242
- * This is called BEFORE rendering, so you can update
243
- * internal state here and it will be reflected in the render
244
- */
245
- onPropertiesChanged(changes) {
246
- // Default: no-op
247
- // Subclasses can override to update _state, _config, etc.
248
- }
249
- /**
250
- * Hook: Called when component is connected
251
- * Use this instead of overriding connectedCallback
252
- */
253
- onConnect() {
254
- // Default: no-op
255
- }
256
- /**
257
- * Hook: Called when component is disconnected
258
- * Use this for cleanup instead of overriding disconnectedCallback
259
- */
260
- onDisconnect() {
261
- // Default: no-op
262
- }
263
- /**
264
- * Get the form element this component is associated with
265
- */
266
- get form() {
267
- return this._internals.form;
268
- }
269
- /**
270
- * Form reset callback - called when form.reset() is invoked
271
- * Resets component to its default value
272
- */
273
- formResetCallback() {
274
- // Get the default value from property configuration
275
- const ctor = this.constructor;
276
- const valueConfig = ctor.properties['value'];
277
- if (valueConfig) {
278
- const defaultValue = valueConfig.default ?? '';
279
- // Reset the value property through setProperty to trigger lifecycle
280
- this.setProperty('value', defaultValue);
281
- }
282
- // Call subclass hook for custom reset behavior
283
- this.onFormReset();
284
- }
285
- /**
286
- * Hook: Called when form is reset
287
- * Subclasses can override to perform additional reset actions
288
- */
289
- onFormReset() {
290
- // Default: no-op
291
- // Subclasses can override to reset additional state
292
- }
29
+ constructor() {
30
+ super();
31
+ this._connected = false;
32
+ this._rendered = false;
33
+ this._userEdited = false;
34
+ this._reflecting = false;
35
+ this._resetDefaults = null;
36
+ const ctor = this.constructor;
37
+ this.props = new PropertyManager(ctor.properties);
38
+ this._internals = this.attachInternals();
39
+ this._validity = new ValidityController(this, this._internals);
40
+ if (!this.shadowRoot) {
41
+ this.attachShadow({ mode: 'open', delegatesFocus: ctor.delegatesFocus, slotAssignment: ctor.slotAssignment });
42
+ }
43
+ if (ctor.labelClicks) {
44
+ labelClickHosts.add(this);
45
+ watchLabelForwards();
46
+ }
47
+ }
48
+ static get observedAttributes() {
49
+ const attrs = [];
50
+ for (const name of Object.keys(this.properties)) {
51
+ attrs.push(name.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase());
52
+ }
53
+ return attrs;
54
+ }
55
+ setProperty(name, value) {
56
+ const change = this.props.updateProperty(name, value, 'property');
57
+ if (change) {
58
+ this._syncPropertyToAttribute(change);
59
+ this._handlePropertyChanges([change]);
60
+ }
61
+ }
62
+ getProperty(name) {
63
+ return this.props.get(name);
64
+ }
65
+ _syncPropertyToAttribute(change) {
66
+ const { name, newValue } = change;
67
+ const config = this.props.getConfig(name);
68
+ if (!config)
69
+ return;
70
+ const attrName = this._toKebabCase(name);
71
+ this._reflecting = true;
72
+ try {
73
+ this._writeAttribute(attrName, config.type, newValue);
74
+ }
75
+ finally {
76
+ this._reflecting = false;
77
+ }
78
+ }
79
+ _writeAttribute(attrName, type, newValue) {
80
+ if (type === 'boolean') {
81
+ if (newValue) {
82
+ this.setAttribute(attrName, '');
83
+ }
84
+ else {
85
+ this.removeAttribute(attrName);
86
+ }
87
+ }
88
+ else if (newValue === null || newValue === undefined) {
89
+ this.removeAttribute(attrName);
90
+ }
91
+ else if (typeof newValue === 'object') {
92
+ this.setAttribute(attrName, JSON.stringify(newValue));
93
+ }
94
+ else {
95
+ this.setAttribute(attrName, String(newValue));
96
+ }
97
+ }
98
+ _toKebabCase(str) {
99
+ return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
100
+ }
101
+ _toCamelCase(str) {
102
+ return str.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
103
+ }
104
+ attributeChangedCallback(name, oldValue, newValue) {
105
+ if (oldValue === newValue)
106
+ return;
107
+ const propName = this.props.hasConfig(name) ? name : this._toCamelCase(name);
108
+ if (!this._reflecting && this._resetDefaults?.has(propName)) {
109
+ const config = this.props.getConfig(propName);
110
+ this._resetDefaults.set(propName, newValue ?? (typeof config.default === 'function' ? config.default() : config.default) ?? null);
111
+ }
112
+ const change = this.props.updateProperty(propName, newValue, 'attribute');
113
+ if (change) {
114
+ this._handlePropertyChanges([change]);
115
+ }
116
+ }
117
+ connectedCallback() {
118
+ if (!this._resetDefaults) {
119
+ this._resetDefaults = new Map();
120
+ const ctor = this.constructor;
121
+ for (const [name, config] of Object.entries(ctor.properties)) {
122
+ if (!config.formValue)
123
+ continue;
124
+ const attr = this.getAttribute(this._toKebabCase(name));
125
+ this._resetDefaults.set(name, attr ?? (typeof config.default === 'function' ? config.default() : config.default) ?? null);
126
+ }
127
+ }
128
+ this._upgradeProperties();
129
+ this._connected = true;
130
+ if (this._validates)
131
+ this._validity.track();
132
+ this.onConnect();
133
+ if (!this._rendered) {
134
+ this.render();
135
+ this._rendered = true;
136
+ }
137
+ }
138
+ disconnectedCallback() {
139
+ this._connected = false;
140
+ if (this._validates)
141
+ this._validity.track();
142
+ this.onDisconnect();
143
+ }
144
+ formAssociatedCallback() {
145
+ if (this._validates)
146
+ this._validity.track();
147
+ }
148
+ _upgradeProperties() {
149
+ for (const name of Object.keys(this.constructor.properties)) {
150
+ if (!Object.prototype.hasOwnProperty.call(this, name))
151
+ continue;
152
+ const value = this[name];
153
+ delete this[name];
154
+ if (value === undefined)
155
+ continue;
156
+ if (name in this)
157
+ this[name] = value;
158
+ else
159
+ this.setProperty(name, value);
160
+ }
161
+ upgradeProperties(this);
162
+ }
163
+ _handlePropertyChanges(changes) {
164
+ if (changes.length === 0)
165
+ return;
166
+ this.onPropertiesChanged(changes);
167
+ const formValueChanged = changes.some(c => this.props.isFormValue(c.name));
168
+ if (formValueChanged) {
169
+ this.updateFormValue();
170
+ }
171
+ const visualChanged = changes.some(c => this.props.isVisual(c.name));
172
+ if (visualChanged && this._connected) {
173
+ this.render();
174
+ }
175
+ this._emitChangeEvents(changes);
176
+ }
177
+ _emitChangeEvents(changes) {
178
+ for (const change of changes) {
179
+ if (this.props.shouldEmitChange(change.name)) {
180
+ this.dispatchEvent(new CustomEvent('prop:change', {
181
+ detail: {
182
+ property: change.name,
183
+ oldValue: change.oldValue,
184
+ newValue: change.newValue
185
+ },
186
+ bubbles: true,
187
+ composed: true
188
+ }));
189
+ }
190
+ }
191
+ }
192
+ updateFormValue() {
193
+ const formValue = this.getFormValue();
194
+ this._internals.setFormValue(formValue);
195
+ }
196
+ getFormValue() {
197
+ return this.props.get('value') ?? null;
198
+ }
199
+ onPropertiesChanged(changes) {
200
+ }
201
+ onConnect() {
202
+ }
203
+ onDisconnect() {
204
+ }
205
+ get form() {
206
+ return this._internals.form;
207
+ }
208
+ get _validates() {
209
+ return this.constructor.formAssociated === true;
210
+ }
211
+ applyValidity(flags, message, anchor) {
212
+ this._validity.set(flags, message, anchor);
213
+ }
214
+ revealValidity() {
215
+ if (this._validates)
216
+ this._validity.reveal();
217
+ }
218
+ get validity() {
219
+ return this._validates ? this._internals.validity : undefined;
220
+ }
221
+ get validationMessage() {
222
+ return this._validates ? this._internals.validationMessage : '';
223
+ }
224
+ get willValidate() {
225
+ return this._validates ? this._internals.willValidate : false;
226
+ }
227
+ checkValidity() {
228
+ return this._validates ? this._internals.checkValidity() : true;
229
+ }
230
+ reportValidity() {
231
+ return this._validates ? this._validity.report() : true;
232
+ }
233
+ setCustomValidity(message) {
234
+ if (this._validates)
235
+ this._validity.setCustom(message);
236
+ }
237
+ applyLabelName(roleEl) {
238
+ let text = Array.from(this._internals.labels ?? [])
239
+ .map((l) => l.textContent?.trim())
240
+ .filter(Boolean)
241
+ .join(' ');
242
+ if (!text) {
243
+ const lbl = this.closest('label');
244
+ if (lbl) {
245
+ const clone = lbl.cloneNode(true);
246
+ clone.querySelectorAll(this.tagName.toLowerCase()).forEach((n) => n.remove());
247
+ text = clone.textContent?.trim() ?? '';
248
+ }
249
+ }
250
+ if (text)
251
+ roleEl.setAttribute('aria-label', text);
252
+ else
253
+ roleEl.removeAttribute('aria-label');
254
+ }
255
+ formResetCallback() {
256
+ this._userEdited = false;
257
+ if (this._validates)
258
+ this._validity.reset();
259
+ for (const [name, def] of this._resetDefaults ?? []) {
260
+ this.setProperty(name, def);
261
+ }
262
+ this.onFormReset();
263
+ }
264
+ onFormReset() {
265
+ }
293
266
  }
294
267
  TyComponent.formAssociated = true;
295
- // Subclasses must define their property configuration
296
268
  TyComponent.properties = {};
297
- //# sourceMappingURL=ty-component.js.map
269
+ TyComponent.delegatesFocus = false;
270
+ TyComponent.slotAssignment = 'named';
271
+ TyComponent.labelClicks = false;
@@ -1,12 +1,6 @@
1
1
  /**
2
- * TyButton Web Component
3
- *
4
- * Three appearance variants × six flavors × three tones (+/base/-).
5
- * appearance="solid" saturated brand fill (default)
6
- * appearance="outlined" transparent bg, text === border
7
- * appearance="ghost" text only, hover bg
8
- *
9
- * Append `+` or `-` to a flavor for stronger/softer tone (e.g. "primary+").
2
+ * TyButton Web Component — three appearances (solid/outlined/ghost) × six
3
+ * flavors × three tones. Append `+`/`-` to a flavor for stronger/softer tone.
10
4
  */
11
5
  import type { Flavor, Size, TyButtonElement } from "../types/common.js";
12
6
  import { TyComponent } from "../base/ty-component.js";
@@ -27,13 +21,6 @@ interface ButtonState {
27
21
  }
28
22
  /**
29
23
  * Ty Button Component
30
- *
31
- * @example
32
- * ```html
33
- * <ty-button flavor="primary">Default solid</ty-button>
34
- * <ty-button appearance="outlined" flavor="danger">Outlined</ty-button>
35
- * <ty-button appearance="ghost" flavor="success+">Ghost stronger</ty-button>
36
- * ```
37
24
  */
38
25
  export declare class TyButton extends TyComponent<ButtonState> implements TyButtonElement {
39
26
  static formAssociated: boolean;
@@ -46,7 +33,7 @@ export declare class TyButton extends TyComponent<ButtonState> implements TyButt
46
33
  size: {
47
34
  type: "string";
48
35
  visual: boolean;
49
- default: string;
36
+ default: Size;
50
37
  validate: (v: any) => boolean;
51
38
  coerce: (v: any) => any;
52
39
  };
@@ -82,6 +69,11 @@ export declare class TyButton extends TyComponent<ButtonState> implements TyButt
82
69
  visual: boolean;
83
70
  default: boolean;
84
71
  };
72
+ muted: {
73
+ type: "boolean";
74
+ visual: boolean;
75
+ default: boolean;
76
+ };
85
77
  wide: {
86
78
  type: "boolean";
87
79
  visual: boolean;
@@ -97,10 +89,32 @@ export declare class TyButton extends TyComponent<ButtonState> implements TyButt
97
89
  };
98
90
  };
99
91
  private _structureInitialized;
92
+ private _formDisabled;
93
+ private _customFlavorSheet;
94
+ private _ownClick;
100
95
  constructor();
96
+ /**
97
+ * A real press inside the host's content box that missed the button: the
98
+ * empty host below a wide button that a min-height made taller, or around
99
+ * one a page's display: flex stretched. Nothing there looks like the
100
+ * button, so it's no press. Host padding and border are outside the
101
+ * content box.
102
+ */
103
+ private _pressOffButton;
101
104
  protected onConnect(): void;
102
105
  protected onDisconnect(): void;
103
- protected onPropertiesChanged(_changes: PropertyChange[]): void;
106
+ protected onPropertiesChanged(changes: PropertyChange[]): void;
107
+ formDisabledCallback(disabled: boolean): void;
108
+ private get _isDisabled();
109
+ /** Focus the inner <button>. The host itself isn't focusable. */
110
+ focus(options?: FocusOptions): void;
111
+ /**
112
+ * Custom flavors: adopt generated per-flavor rules pointed at the user's
113
+ * design tokens (--ty-solid-X / --ty-color-X / --ty-bg-X), falling back to
114
+ * neutral for any token the user didn't define. Tone (+/-) is handled by
115
+ * the tone-plus/tone-minus classes, so only the base flavor matters here.
116
+ */
117
+ private _syncCustomFlavor;
104
118
  get flavor(): Flavor;
105
119
  set flavor(value: Flavor);
106
120
  get size(): Size;
@@ -117,6 +131,8 @@ export declare class TyButton extends TyComponent<ButtonState> implements TyButt
117
131
  set pill(value: boolean);
118
132
  get action(): boolean;
119
133
  set action(value: boolean);
134
+ get muted(): boolean;
135
+ set muted(value: boolean);
120
136
  get wide(): boolean;
121
137
  set wide(value: boolean);
122
138
  get name(): string;
@@ -132,4 +148,3 @@ export declare class TyButton extends TyComponent<ButtonState> implements TyButt
132
148
  protected render(): void;
133
149
  }
134
150
  export {};
135
- //# sourceMappingURL=button.d.ts.map