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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (386) hide show
  1. package/AGENTS.md +122 -0
  2. package/CHANGELOG.md +1531 -0
  3. package/README.md +71 -53
  4. package/css/tyrell-colors-static.css +1 -0
  5. package/css/tyrell-theme.css +1 -0
  6. package/css/tyrell.css +1 -1783
  7. package/dist/tyrell-colors-static.css +1 -0
  8. package/dist/tyrell-theme.css +1 -0
  9. package/dist/tyrell.css +1 -1783
  10. package/dist/tyrell.js +1 -1
  11. package/guides/AGENT_INSTRUCTIONS.md +124 -0
  12. package/guides/AI_GUIDE.md +53 -0
  13. package/guides/CSS_GUIDE.md +1016 -0
  14. package/guides/DATASTAR_TY_GUIDE.md +657 -0
  15. package/guides/ICONS_GUIDE.md +212 -0
  16. package/guides/TY_GUIDE.md +935 -0
  17. package/guides/clj/CLOJURESCRIPT_GUIDE.md +300 -0
  18. package/guides/clj/CODE_SPLITTING.md +279 -0
  19. package/guides/clj/COMPONENT_GUIDE.md +391 -0
  20. package/guides/clj/HELIX_TY_GUIDE.md +428 -0
  21. package/guides/clj/I18N_GUIDE.md +478 -0
  22. package/guides/clj/LAYOUT_GUIDE.md +273 -0
  23. package/guides/clj/QUICKSTART.md +266 -0
  24. package/guides/clj/REAGENT_TY_GUIDE.md +408 -0
  25. package/guides/clj/REPLICANT_TY_GUIDE.md +623 -0
  26. package/guides/clj/ROUTING_GUIDE.md +346 -0
  27. package/guides/clj/UIX_TY_GUIDE.md +319 -0
  28. package/guides/js/HTMX_TY_GUIDE.md +252 -0
  29. package/guides/js/JAVASCRIPT_GUIDE.md +388 -0
  30. package/guides/js/REACT_TY_GUIDE.md +983 -0
  31. package/guides/js/SVELTE_TY_GUIDE.md +682 -0
  32. package/guides/js/TYCOMPONENT_GUIDE.md +962 -0
  33. package/guides/js/VUE_TY_GUIDE.md +738 -0
  34. package/lib/base/ty-component.d.ts +57 -13
  35. package/lib/base/ty-component.js +266 -292
  36. package/lib/components/button.d.ts +42 -18
  37. package/lib/components/button.js +318 -235
  38. package/lib/components/calendar-month.d.ts +30 -47
  39. package/lib/components/calendar-month.js +455 -429
  40. package/lib/components/calendar-navigation.d.ts +41 -49
  41. package/lib/components/calendar-navigation.js +287 -346
  42. package/lib/components/calendar.d.ts +73 -83
  43. package/lib/components/calendar.js +837 -762
  44. package/lib/components/checkbox.d.ts +26 -75
  45. package/lib/components/checkbox.js +298 -391
  46. package/lib/components/copy.d.ts +20 -60
  47. package/lib/components/copy.js +276 -380
  48. package/lib/components/date-picker.d.ts +100 -183
  49. package/lib/components/date-picker.js +1155 -1570
  50. package/lib/components/file-upload.d.ts +122 -0
  51. package/lib/components/file-upload.js +451 -0
  52. package/lib/components/icon.d.ts +3 -24
  53. package/lib/components/icon.js +141 -230
  54. package/lib/components/input.d.ts +93 -108
  55. package/lib/components/input.js +734 -710
  56. package/lib/components/modal.d.ts +39 -29
  57. package/lib/components/modal.js +419 -438
  58. package/lib/components/option.d.ts +20 -35
  59. package/lib/components/option.js +184 -309
  60. package/lib/components/popup.d.ts +2 -17
  61. package/lib/components/popup.js +353 -347
  62. package/lib/components/radio.d.ts +33 -25
  63. package/lib/components/radio.js +433 -422
  64. package/lib/components/resize-observer.d.ts +3 -30
  65. package/lib/components/resize-observer.js +71 -103
  66. package/lib/components/scroll-container.d.ts +21 -14
  67. package/lib/components/scroll-container.js +292 -234
  68. package/lib/components/select.d.ts +446 -0
  69. package/lib/components/select.js +1381 -0
  70. package/lib/components/selected-tags.d.ts +60 -0
  71. package/lib/components/selected-tags.js +225 -0
  72. package/lib/components/sortable.d.ts +175 -0
  73. package/lib/components/sortable.js +1844 -0
  74. package/lib/components/step.d.ts +1 -6
  75. package/lib/components/step.js +62 -68
  76. package/lib/components/switch.d.ts +15 -15
  77. package/lib/components/switch.js +237 -231
  78. package/lib/components/tab.d.ts +50 -7
  79. package/lib/components/tab.js +203 -69
  80. package/lib/components/tabs.d.ts +19 -64
  81. package/lib/components/tabs.js +600 -618
  82. package/lib/components/tag.d.ts +17 -55
  83. package/lib/components/tag.js +235 -308
  84. package/lib/components/textarea.d.ts +58 -89
  85. package/lib/components/textarea.js +523 -573
  86. package/lib/components/tooltip.d.ts +8 -13
  87. package/lib/components/tooltip.js +322 -409
  88. package/lib/components/wizard.d.ts +7 -54
  89. package/lib/components/wizard.js +376 -606
  90. package/lib/icons/fontawesome/brands.d.ts +0 -1
  91. package/lib/icons/fontawesome/brands.js +0 -8
  92. package/lib/icons/fontawesome/regular.d.ts +0 -1
  93. package/lib/icons/fontawesome/regular.js +0 -8
  94. package/lib/icons/fontawesome/solid.d.ts +0 -1
  95. package/lib/icons/fontawesome/solid.js +0 -8
  96. package/lib/icons/heroicons/micro.d.ts +0 -1
  97. package/lib/icons/heroicons/micro.js +392 -400
  98. package/lib/icons/heroicons/mini.d.ts +0 -1
  99. package/lib/icons/heroicons/mini.js +382 -390
  100. package/lib/icons/heroicons/outline.d.ts +0 -1
  101. package/lib/icons/heroicons/outline.js +337 -345
  102. package/lib/icons/heroicons/solid.d.ts +0 -1
  103. package/lib/icons/heroicons/solid.js +407 -415
  104. package/lib/icons/lucide.d.ts +0 -1
  105. package/lib/icons/lucide.js +24479 -26351
  106. package/lib/icons/material/filled.d.ts +0 -1
  107. package/lib/icons/material/filled.js +9653 -9663
  108. package/lib/icons/material/outlined.d.ts +0 -1
  109. package/lib/icons/material/outlined.js +10271 -10281
  110. package/lib/icons/material/round.d.ts +0 -1
  111. package/lib/icons/material/round.js +10495 -10505
  112. package/lib/icons/material/sharp.d.ts +0 -1
  113. package/lib/icons/material/sharp.js +9905 -9915
  114. package/lib/icons/material/two-tone.d.ts +0 -1
  115. package/lib/icons/material/two-tone.js +12792 -12802
  116. package/lib/index.d.ts +15 -4
  117. package/lib/index.js +28 -38
  118. package/lib/styles/button.d.ts +24 -7
  119. package/lib/styles/button.js +298 -417
  120. package/lib/styles/calendar-month.d.ts +7 -6
  121. package/lib/styles/calendar-month.js +157 -179
  122. package/lib/styles/calendar-navigation.d.ts +2 -6
  123. package/lib/styles/calendar-navigation.js +108 -109
  124. package/lib/styles/calendar.d.ts +3 -3
  125. package/lib/styles/calendar.js +87 -23
  126. package/lib/styles/checkbox.d.ts +7 -6
  127. package/lib/styles/checkbox.js +101 -15
  128. package/lib/styles/copy.d.ts +3 -2
  129. package/lib/styles/copy.js +91 -71
  130. package/lib/styles/custom-scrollbar.d.ts +1 -2
  131. package/lib/styles/custom-scrollbar.js +80 -115
  132. package/lib/styles/date-picker.d.ts +4 -6
  133. package/lib/styles/date-picker.js +320 -352
  134. package/lib/styles/field-size.d.ts +6 -0
  135. package/lib/styles/field-size.js +91 -0
  136. package/lib/styles/file-upload.d.ts +1 -0
  137. package/lib/styles/file-upload.js +196 -0
  138. package/lib/styles/icon.d.ts +2 -6
  139. package/lib/styles/icon.js +92 -170
  140. package/lib/styles/input.d.ts +4 -7
  141. package/lib/styles/input.js +148 -643
  142. package/lib/styles/modal.d.ts +1 -2
  143. package/lib/styles/modal.js +127 -108
  144. package/lib/styles/option.d.ts +2 -6
  145. package/lib/styles/option.js +53 -96
  146. package/lib/styles/popup.d.ts +1 -2
  147. package/lib/styles/popup.js +47 -77
  148. package/lib/styles/radio.d.ts +3 -2
  149. package/lib/styles/radio.js +90 -116
  150. package/lib/styles/resize-observer.d.ts +1 -2
  151. package/lib/styles/resize-observer.js +2 -12
  152. package/lib/styles/scroll-container.d.ts +1 -2
  153. package/lib/styles/scroll-container.js +103 -146
  154. package/lib/styles/select-base.d.ts +8 -0
  155. package/lib/styles/select-base.js +747 -0
  156. package/lib/styles/select.d.ts +11 -0
  157. package/lib/styles/select.js +229 -0
  158. package/lib/styles/sortable.d.ts +16 -0
  159. package/lib/styles/sortable.js +85 -0
  160. package/lib/styles/step.d.ts +1 -2
  161. package/lib/styles/step.js +15 -34
  162. package/lib/styles/switch.d.ts +3 -2
  163. package/lib/styles/switch.js +52 -68
  164. package/lib/styles/tab.d.ts +1 -2
  165. package/lib/styles/tab.js +86 -34
  166. package/lib/styles/tabs.d.ts +3 -11
  167. package/lib/styles/tabs.js +204 -162
  168. package/lib/styles/tag.d.ts +2 -6
  169. package/lib/styles/tag.js +170 -359
  170. package/lib/styles/textarea.d.ts +1 -2
  171. package/lib/styles/textarea.js +238 -306
  172. package/lib/styles/tooltip.d.ts +4 -3
  173. package/lib/styles/tooltip.js +3 -131
  174. package/lib/styles/wizard.d.ts +8 -20
  175. package/lib/styles/wizard.js +306 -295
  176. package/lib/types/common.d.ts +9 -8
  177. package/lib/types/common.js +8 -5
  178. package/lib/utils/calendar-utils.d.ts +49 -65
  179. package/lib/utils/calendar-utils.js +158 -343
  180. package/lib/utils/custom-scrollbar.d.ts +6 -20
  181. package/lib/utils/custom-scrollbar.js +273 -317
  182. package/lib/utils/flavor-sheet.d.ts +31 -0
  183. package/lib/utils/flavor-sheet.js +17 -0
  184. package/lib/utils/icon-registry.d.ts +0 -15
  185. package/lib/utils/icon-registry.js +138 -279
  186. package/lib/utils/icons.d.ts +9 -0
  187. package/lib/utils/icons.js +1 -0
  188. package/lib/utils/loader-registry.d.ts +34 -0
  189. package/lib/utils/loader-registry.js +11 -0
  190. package/lib/utils/locale.d.ts +2 -80
  191. package/lib/utils/locale.js +30 -205
  192. package/lib/utils/mobile.d.ts +0 -1
  193. package/lib/utils/mobile.js +1 -18
  194. package/lib/utils/number-format.d.ts +6 -24
  195. package/lib/utils/number-format.js +53 -136
  196. package/lib/utils/positioning.d.ts +72 -22
  197. package/lib/utils/positioning.js +224 -298
  198. package/lib/utils/property-capture.d.ts +5 -27
  199. package/lib/utils/property-capture.js +36 -144
  200. package/lib/utils/property-manager.d.ts +6 -6
  201. package/lib/utils/property-manager.js +127 -196
  202. package/lib/utils/resize-observer.d.ts +0 -1
  203. package/lib/utils/resize-observer.js +23 -59
  204. package/lib/utils/scroll-lock.d.ts +10 -11
  205. package/lib/utils/scroll-lock.js +165 -173
  206. package/lib/utils/styles.d.ts +0 -6
  207. package/lib/utils/styles.js +17 -48
  208. package/lib/utils/upgrade-properties.d.ts +21 -0
  209. package/lib/utils/upgrade-properties.js +47 -0
  210. package/lib/utils/validity.d.ts +122 -0
  211. package/lib/utils/validity.js +289 -0
  212. package/lib/version.d.ts +1 -2
  213. package/lib/version.js +1 -11
  214. package/package.json +66 -18
  215. package/lib/base/ty-component.d.ts.map +0 -1
  216. package/lib/base/ty-component.js.map +0 -1
  217. package/lib/components/button.d.ts.map +0 -1
  218. package/lib/components/button.js.map +0 -1
  219. package/lib/components/calendar-month.d.ts.map +0 -1
  220. package/lib/components/calendar-month.js.map +0 -1
  221. package/lib/components/calendar-navigation.d.ts.map +0 -1
  222. package/lib/components/calendar-navigation.js.map +0 -1
  223. package/lib/components/calendar.d.ts.map +0 -1
  224. package/lib/components/calendar.js.map +0 -1
  225. package/lib/components/checkbox.d.ts.map +0 -1
  226. package/lib/components/checkbox.js.map +0 -1
  227. package/lib/components/copy.d.ts.map +0 -1
  228. package/lib/components/copy.js.map +0 -1
  229. package/lib/components/date-picker.d.ts.map +0 -1
  230. package/lib/components/date-picker.js.map +0 -1
  231. package/lib/components/dropdown.d.ts +0 -402
  232. package/lib/components/dropdown.d.ts.map +0 -1
  233. package/lib/components/dropdown.js +0 -1564
  234. package/lib/components/dropdown.js.map +0 -1
  235. package/lib/components/icon.d.ts.map +0 -1
  236. package/lib/components/icon.js.map +0 -1
  237. package/lib/components/input.d.ts.map +0 -1
  238. package/lib/components/input.js.map +0 -1
  239. package/lib/components/modal.d.ts.map +0 -1
  240. package/lib/components/modal.js.map +0 -1
  241. package/lib/components/multiselect.d.ts +0 -397
  242. package/lib/components/multiselect.d.ts.map +0 -1
  243. package/lib/components/multiselect.js +0 -1580
  244. package/lib/components/multiselect.js.map +0 -1
  245. package/lib/components/option.d.ts.map +0 -1
  246. package/lib/components/option.js.map +0 -1
  247. package/lib/components/popup.d.ts.map +0 -1
  248. package/lib/components/popup.js.map +0 -1
  249. package/lib/components/radio.d.ts.map +0 -1
  250. package/lib/components/radio.js.map +0 -1
  251. package/lib/components/resize-observer.d.ts.map +0 -1
  252. package/lib/components/resize-observer.js.map +0 -1
  253. package/lib/components/scroll-container.d.ts.map +0 -1
  254. package/lib/components/scroll-container.js.map +0 -1
  255. package/lib/components/step.d.ts.map +0 -1
  256. package/lib/components/step.js.map +0 -1
  257. package/lib/components/switch.d.ts.map +0 -1
  258. package/lib/components/switch.js.map +0 -1
  259. package/lib/components/tab.d.ts.map +0 -1
  260. package/lib/components/tab.js.map +0 -1
  261. package/lib/components/tabs.d.ts.map +0 -1
  262. package/lib/components/tabs.js.map +0 -1
  263. package/lib/components/tag.d.ts.map +0 -1
  264. package/lib/components/tag.js.map +0 -1
  265. package/lib/components/textarea.d.ts.map +0 -1
  266. package/lib/components/textarea.js.map +0 -1
  267. package/lib/components/tooltip.d.ts.map +0 -1
  268. package/lib/components/tooltip.js.map +0 -1
  269. package/lib/components/wizard.d.ts.map +0 -1
  270. package/lib/components/wizard.js.map +0 -1
  271. package/lib/icons/fontawesome/brands.d.ts.map +0 -1
  272. package/lib/icons/fontawesome/brands.js.map +0 -1
  273. package/lib/icons/fontawesome/regular.d.ts.map +0 -1
  274. package/lib/icons/fontawesome/regular.js.map +0 -1
  275. package/lib/icons/fontawesome/solid.d.ts.map +0 -1
  276. package/lib/icons/fontawesome/solid.js.map +0 -1
  277. package/lib/icons/heroicons/micro.d.ts.map +0 -1
  278. package/lib/icons/heroicons/micro.js.map +0 -1
  279. package/lib/icons/heroicons/mini.d.ts.map +0 -1
  280. package/lib/icons/heroicons/mini.js.map +0 -1
  281. package/lib/icons/heroicons/outline.d.ts.map +0 -1
  282. package/lib/icons/heroicons/outline.js.map +0 -1
  283. package/lib/icons/heroicons/solid.d.ts.map +0 -1
  284. package/lib/icons/heroicons/solid.js.map +0 -1
  285. package/lib/icons/lucide.d.ts.map +0 -1
  286. package/lib/icons/lucide.js.map +0 -1
  287. package/lib/icons/material/filled.d.ts.map +0 -1
  288. package/lib/icons/material/filled.js.map +0 -1
  289. package/lib/icons/material/outlined.d.ts.map +0 -1
  290. package/lib/icons/material/outlined.js.map +0 -1
  291. package/lib/icons/material/round.d.ts.map +0 -1
  292. package/lib/icons/material/round.js.map +0 -1
  293. package/lib/icons/material/sharp.d.ts.map +0 -1
  294. package/lib/icons/material/sharp.js.map +0 -1
  295. package/lib/icons/material/two-tone.d.ts.map +0 -1
  296. package/lib/icons/material/two-tone.js.map +0 -1
  297. package/lib/index.d.ts.map +0 -1
  298. package/lib/index.js.map +0 -1
  299. package/lib/styles/button.d.ts.map +0 -1
  300. package/lib/styles/button.js.map +0 -1
  301. package/lib/styles/calendar-month.d.ts.map +0 -1
  302. package/lib/styles/calendar-month.js.map +0 -1
  303. package/lib/styles/calendar-navigation.d.ts.map +0 -1
  304. package/lib/styles/calendar-navigation.js.map +0 -1
  305. package/lib/styles/calendar.d.ts.map +0 -1
  306. package/lib/styles/calendar.js.map +0 -1
  307. package/lib/styles/checkbox.d.ts.map +0 -1
  308. package/lib/styles/checkbox.js.map +0 -1
  309. package/lib/styles/copy.d.ts.map +0 -1
  310. package/lib/styles/copy.js.map +0 -1
  311. package/lib/styles/custom-scrollbar.d.ts.map +0 -1
  312. package/lib/styles/custom-scrollbar.js.map +0 -1
  313. package/lib/styles/date-picker.d.ts.map +0 -1
  314. package/lib/styles/date-picker.js.map +0 -1
  315. package/lib/styles/dropdown.d.ts +0 -12
  316. package/lib/styles/dropdown.d.ts.map +0 -1
  317. package/lib/styles/dropdown.js +0 -983
  318. package/lib/styles/dropdown.js.map +0 -1
  319. package/lib/styles/icon.d.ts.map +0 -1
  320. package/lib/styles/icon.js.map +0 -1
  321. package/lib/styles/input.d.ts.map +0 -1
  322. package/lib/styles/input.js.map +0 -1
  323. package/lib/styles/modal.d.ts.map +0 -1
  324. package/lib/styles/modal.js.map +0 -1
  325. package/lib/styles/multiselect.d.ts +0 -6
  326. package/lib/styles/multiselect.d.ts.map +0 -1
  327. package/lib/styles/multiselect.js +0 -774
  328. package/lib/styles/multiselect.js.map +0 -1
  329. package/lib/styles/option.d.ts.map +0 -1
  330. package/lib/styles/option.js.map +0 -1
  331. package/lib/styles/popup.d.ts.map +0 -1
  332. package/lib/styles/popup.js.map +0 -1
  333. package/lib/styles/radio.d.ts.map +0 -1
  334. package/lib/styles/radio.js.map +0 -1
  335. package/lib/styles/resize-observer.d.ts.map +0 -1
  336. package/lib/styles/resize-observer.js.map +0 -1
  337. package/lib/styles/scroll-container.d.ts.map +0 -1
  338. package/lib/styles/scroll-container.js.map +0 -1
  339. package/lib/styles/step.d.ts.map +0 -1
  340. package/lib/styles/step.js.map +0 -1
  341. package/lib/styles/switch.d.ts.map +0 -1
  342. package/lib/styles/switch.js.map +0 -1
  343. package/lib/styles/tab.d.ts.map +0 -1
  344. package/lib/styles/tab.js.map +0 -1
  345. package/lib/styles/tabs.d.ts.map +0 -1
  346. package/lib/styles/tabs.js.map +0 -1
  347. package/lib/styles/tag.d.ts.map +0 -1
  348. package/lib/styles/tag.js.map +0 -1
  349. package/lib/styles/textarea.d.ts.map +0 -1
  350. package/lib/styles/textarea.js.map +0 -1
  351. package/lib/styles/tooltip.d.ts.map +0 -1
  352. package/lib/styles/tooltip.js.map +0 -1
  353. package/lib/styles/wizard.d.ts.map +0 -1
  354. package/lib/styles/wizard.js.map +0 -1
  355. package/lib/types/common.d.ts.map +0 -1
  356. package/lib/types/common.js.map +0 -1
  357. package/lib/utils/calendar-utils.d.ts.map +0 -1
  358. package/lib/utils/calendar-utils.js.map +0 -1
  359. package/lib/utils/custom-scrollbar.d.ts.map +0 -1
  360. package/lib/utils/custom-scrollbar.js.map +0 -1
  361. package/lib/utils/icon-registry.d.ts.map +0 -1
  362. package/lib/utils/icon-registry.js.map +0 -1
  363. package/lib/utils/locale.d.ts.map +0 -1
  364. package/lib/utils/locale.js.map +0 -1
  365. package/lib/utils/mobile.d.ts.map +0 -1
  366. package/lib/utils/mobile.js.map +0 -1
  367. package/lib/utils/number-format.d.ts.map +0 -1
  368. package/lib/utils/number-format.js.map +0 -1
  369. package/lib/utils/parse-boolean.d.ts +0 -39
  370. package/lib/utils/parse-boolean.d.ts.map +0 -1
  371. package/lib/utils/parse-boolean.js +0 -58
  372. package/lib/utils/parse-boolean.js.map +0 -1
  373. package/lib/utils/positioning.d.ts.map +0 -1
  374. package/lib/utils/positioning.js.map +0 -1
  375. package/lib/utils/property-capture.d.ts.map +0 -1
  376. package/lib/utils/property-capture.js.map +0 -1
  377. package/lib/utils/property-manager.d.ts.map +0 -1
  378. package/lib/utils/property-manager.js.map +0 -1
  379. package/lib/utils/resize-observer.d.ts.map +0 -1
  380. package/lib/utils/resize-observer.js.map +0 -1
  381. package/lib/utils/scroll-lock.d.ts.map +0 -1
  382. package/lib/utils/scroll-lock.js.map +0 -1
  383. package/lib/utils/styles.d.ts.map +0 -1
  384. package/lib/utils/styles.js.map +0 -1
  385. package/lib/version.d.ts.map +0 -1
  386. package/lib/version.js.map +0 -1
@@ -1,240 +1,246 @@
1
- /**
2
- * TySwitch Web Component
3
- *
4
- * "Just the toggle" primitive — renders only the track + thumb visual.
5
- * Label, required asterisk, and error display are the consumer's
6
- * responsibility — wrap in a `<label>` for click delegation.
7
- *
8
- * - Boolean checked state, role="switch" ARIA
9
- * - Form-associated, keyboard accessibility
10
- * - Sizes (xs, sm, md, lg, xl) and semantic flavors
11
- *
12
- * @example
13
- * <label>
14
- * <ty-switch name="notifications" checked></ty-switch>
15
- * Email notifications
16
- * </label>
17
- */
1
+ import { DEFAULT_SIZE } from "../types/common.js";
18
2
  import { TyComponent } from "../base/ty-component.js";
19
3
  import { ensureStyles } from "../utils/styles.js";
20
- import { switchStyles } from "../styles/switch.js";
4
+ import { syncCustomFlavorSheet } from "../utils/flavor-sheet.js";
5
+ import { switchStyles, switchCustomFlavorCss } from "../styles/switch.js";
6
+ import { nativeMessage } from "../utils/validity.js";
21
7
  export class TySwitch extends TyComponent {
22
- constructor() {
23
- super();
24
- this._listenersSetup = false;
25
- this._clickHandler = null;
26
- this._keydownHandler = null;
27
- this._focusHandler = null;
28
- this._blurHandler = null;
29
- const shadow = this.shadowRoot;
30
- ensureStyles(shadow, { css: switchStyles, id: "ty-switch" });
31
- }
32
- onConnect() { }
33
- onDisconnect() {
34
- this.removeEventListeners();
35
- }
36
- onPropertiesChanged(_changes) { }
37
- getFormValue() {
38
- return this.checked ? this.value : null;
39
- }
40
- buildClassList() {
41
- const classes = [this.size, this.flavor];
42
- if (this.disabled)
43
- classes.push("disabled");
44
- if (this.required)
45
- classes.push("required");
46
- return classes.join(" ");
47
- }
48
- handleSwitchClick(e) {
49
- if (this.disabled)
50
- return;
51
- const newValue = !this.checked;
52
- this.checked = newValue;
53
- setTimeout(() => {
54
- const eventDetail = {
55
- value: newValue,
56
- checked: newValue,
57
- formValue: newValue ? this.value : null,
58
- originalEvent: e,
59
- };
60
- this.dispatchEvent(new CustomEvent("input", { detail: eventDetail, bubbles: true, composed: true }));
61
- this.dispatchEvent(new CustomEvent("change", { detail: eventDetail, bubbles: true, composed: true }));
62
- }, 0);
63
- }
64
- handleSwitchKeydown(e) {
65
- if (this.disabled)
66
- return;
67
- if (["Space", " ", "Enter"].includes(e.key)) {
68
- e.preventDefault();
69
- e.stopPropagation();
70
- this.handleSwitchClick(e);
71
- }
72
- }
73
- removeEventListeners() {
74
- if (!this._listenersSetup)
75
- return;
76
- const shadow = this.shadowRoot;
77
- if (!shadow)
78
- return;
79
- const el = shadow.querySelector(".switch-container");
80
- if (!el)
81
- return;
82
- if (this._clickHandler) {
83
- el.removeEventListener("click", this._clickHandler);
84
- this._clickHandler = null;
85
- }
86
- if (this._keydownHandler) {
87
- el.removeEventListener("keydown", this._keydownHandler);
88
- this._keydownHandler = null;
89
- }
90
- if (this._focusHandler) {
91
- el.removeEventListener("focus", this._focusHandler);
92
- this._focusHandler = null;
93
- }
94
- if (this._blurHandler) {
95
- el.removeEventListener("blur", this._blurHandler);
96
- this._blurHandler = null;
97
- }
98
- this._listenersSetup = false;
99
- }
100
- setupEventListeners() {
101
- if (this._listenersSetup)
102
- return;
103
- const shadow = this.shadowRoot;
104
- const el = shadow.querySelector(".switch-container");
105
- if (!el)
106
- return;
107
- this._clickHandler = (e) => this.handleSwitchClick(e);
108
- this._keydownHandler = (e) => this.handleSwitchKeydown(e);
109
- this._focusHandler = () => el.classList.add("focused");
110
- this._blurHandler = () => el.classList.remove("focused");
111
- el.addEventListener("click", this._clickHandler);
112
- el.addEventListener("keydown", this._keydownHandler);
113
- el.addEventListener("focus", this._focusHandler);
114
- el.addEventListener("blur", this._blurHandler);
115
- this._listenersSetup = true;
116
- }
117
- render() {
118
- const shadow = this.shadowRoot;
119
- let switchEl = shadow.querySelector(".switch-container");
120
- const classes = this.buildClassList();
121
- if (!switchEl) {
122
- switchEl = document.createElement("div");
123
- switchEl.className = "switch-container " + classes;
124
- switchEl.tabIndex = this.disabled ? -1 : 0;
125
- switchEl.setAttribute("role", "switch");
126
- switchEl.setAttribute("aria-checked", String(this.checked));
127
- switchEl.setAttribute("aria-disabled", String(this.disabled));
128
- switchEl.setAttribute("aria-required", String(this.required));
129
- const track = document.createElement("div");
130
- track.className = "switch-track";
131
- const thumb = document.createElement("div");
132
- thumb.className = "switch-thumb";
133
- track.appendChild(thumb);
134
- switchEl.appendChild(track);
135
- shadow.appendChild(switchEl);
136
- this.setupEventListeners();
137
- }
138
- else {
139
- switchEl.className = "switch-container " + classes;
140
- switchEl.tabIndex = this.disabled ? -1 : 0;
141
- switchEl.setAttribute("aria-checked", String(this.checked));
142
- switchEl.setAttribute("aria-disabled", String(this.disabled));
143
- switchEl.setAttribute("aria-required", String(this.required));
144
- }
145
- }
146
- // ============================================================================
147
- // PROPERTY ACCESSORS
148
- // ============================================================================
149
- get checked() { return this.getProperty("checked"); }
150
- set checked(value) { this.setProperty("checked", value); }
151
- get value() { return this.getProperty("value"); }
152
- set value(val) { this.setProperty("value", val); }
153
- get name() { return this.getProperty("name"); }
154
- set name(val) { this.setProperty("name", val); }
155
- get disabled() { return this.getProperty("disabled"); }
156
- set disabled(value) { this.setProperty("disabled", value); }
157
- get required() { return this.getProperty("required"); }
158
- set required(value) { this.setProperty("required", value); }
159
- get size() { return this.getProperty("size"); }
160
- set size(value) { this.setProperty("size", value); }
161
- get flavor() { return this.getProperty("flavor"); }
162
- set flavor(value) { this.setProperty("flavor", value); }
163
- get form() { return this._internals.form; }
8
+ constructor() {
9
+ super();
10
+ this._customFlavorSheet = null;
11
+ this._listenersSetup = false;
12
+ this._clickHandler = null;
13
+ this._keydownHandler = null;
14
+ this._focusHandler = null;
15
+ this._blurHandler = null;
16
+ const shadow = this.shadowRoot;
17
+ ensureStyles(shadow, { css: switchStyles, id: "ty-switch" });
18
+ }
19
+ onConnect() {
20
+ this.setupEventListeners();
21
+ this._syncCustomFlavor();
22
+ const el = this.shadowRoot.querySelector(".switch-container");
23
+ if (el && this.shadowRoot.activeElement !== el)
24
+ el.classList.remove("focused");
25
+ }
26
+ onDisconnect() {
27
+ this.removeEventListeners();
28
+ }
29
+ onPropertiesChanged(changes) {
30
+ if (changes.some((c) => c.name === "flavor")) {
31
+ this._syncCustomFlavor();
32
+ }
33
+ }
34
+ _syncCustomFlavor() {
35
+ this._customFlavorSheet = syncCustomFlavorSheet(this.shadowRoot, this._customFlavorSheet, this.flavor, ({ base }) => switchCustomFlavorCss(base));
36
+ }
37
+ getFormValue() {
38
+ return this.checked ? this.value : null;
39
+ }
40
+ buildClassList() {
41
+ const classes = [this.size];
42
+ if (this.disabled)
43
+ classes.push("disabled");
44
+ if (this.required)
45
+ classes.push("required");
46
+ return classes.join(" ");
47
+ }
48
+ handleSwitchClick(e) {
49
+ if (this.disabled)
50
+ return;
51
+ this.showFocusRing(e instanceof KeyboardEvent);
52
+ const newValue = !this.checked;
53
+ this.checked = newValue;
54
+ setTimeout(() => {
55
+ const eventDetail = {
56
+ value: newValue,
57
+ checked: newValue,
58
+ formValue: newValue ? this.value : null,
59
+ originalEvent: e,
60
+ };
61
+ this.dispatchEvent(new CustomEvent("input", { detail: eventDetail, bubbles: true, composed: true }));
62
+ this.dispatchEvent(new CustomEvent("change", { detail: eventDetail, bubbles: true, composed: true }));
63
+ }, 0);
64
+ }
65
+ showFocusRing(on) {
66
+ this.shadowRoot?.querySelector(".switch-container")?.classList.toggle("focused", on);
67
+ }
68
+ handleSwitchKeydown(e) {
69
+ if (this.disabled)
70
+ return;
71
+ if (["Space", " ", "Enter"].includes(e.key)) {
72
+ e.preventDefault();
73
+ e.stopPropagation();
74
+ this.handleSwitchClick(e);
75
+ }
76
+ }
77
+ removeEventListeners() {
78
+ if (!this._listenersSetup)
79
+ return;
80
+ if (this._clickHandler) {
81
+ this.removeEventListener("click", this._clickHandler);
82
+ this._clickHandler = null;
83
+ }
84
+ const shadow = this.shadowRoot;
85
+ if (!shadow)
86
+ return;
87
+ const el = shadow.querySelector(".switch-container");
88
+ if (!el) {
89
+ this._listenersSetup = false;
90
+ return;
91
+ }
92
+ if (this._keydownHandler) {
93
+ el.removeEventListener("keydown", this._keydownHandler);
94
+ this._keydownHandler = null;
95
+ }
96
+ if (this._focusHandler) {
97
+ el.removeEventListener("focus", this._focusHandler);
98
+ this._focusHandler = null;
99
+ }
100
+ if (this._blurHandler) {
101
+ el.removeEventListener("blur", this._blurHandler);
102
+ this._blurHandler = null;
103
+ }
104
+ this._listenersSetup = false;
105
+ }
106
+ setupEventListeners() {
107
+ if (this._listenersSetup)
108
+ return;
109
+ const shadow = this.shadowRoot;
110
+ const el = shadow.querySelector(".switch-container");
111
+ if (!el)
112
+ return;
113
+ this._clickHandler = (e) => this.handleSwitchClick(e);
114
+ this._keydownHandler = (e) => this.handleSwitchKeydown(e);
115
+ this._focusHandler = () => el.classList.toggle("focused", el.matches(":focus-visible"));
116
+ this._blurHandler = () => el.classList.remove("focused");
117
+ this.addEventListener("click", this._clickHandler);
118
+ el.addEventListener("keydown", this._keydownHandler);
119
+ el.addEventListener("focus", this._focusHandler);
120
+ el.addEventListener("blur", this._blurHandler);
121
+ this._listenersSetup = true;
122
+ }
123
+ render() {
124
+ const shadow = this.shadowRoot;
125
+ let switchEl = shadow.querySelector(".switch-container");
126
+ const classes = this.buildClassList();
127
+ if (!switchEl) {
128
+ switchEl = document.createElement("div");
129
+ switchEl.className = "switch-container " + classes;
130
+ if (!this.disabled)
131
+ switchEl.tabIndex = 0;
132
+ switchEl.setAttribute("role", "switch");
133
+ switchEl.setAttribute("aria-checked", this.checked ? "true" : "false");
134
+ switchEl.setAttribute("aria-disabled", this.disabled ? "true" : "false");
135
+ switchEl.setAttribute("aria-required", this.required ? "true" : "false");
136
+ const track = document.createElement("div");
137
+ track.className = "switch-track";
138
+ const thumb = document.createElement("div");
139
+ thumb.className = "switch-thumb";
140
+ track.appendChild(thumb);
141
+ switchEl.appendChild(track);
142
+ shadow.appendChild(switchEl);
143
+ }
144
+ else {
145
+ const focused = switchEl.classList.contains("focused") && shadow.activeElement === switchEl;
146
+ switchEl.className = "switch-container " + classes;
147
+ switchEl.classList.toggle("focused", focused && !this.disabled);
148
+ if (this.disabled)
149
+ switchEl.removeAttribute("tabindex");
150
+ else
151
+ switchEl.tabIndex = 0;
152
+ switchEl.setAttribute("aria-checked", this.checked ? "true" : "false");
153
+ switchEl.setAttribute("aria-disabled", this.disabled ? "true" : "false");
154
+ switchEl.setAttribute("aria-required", this.required ? "true" : "false");
155
+ }
156
+ this.setupEventListeners();
157
+ this.applyLabelName(switchEl);
158
+ this.updateValidity();
159
+ }
160
+ focus(options) {
161
+ const el = this.shadowRoot?.querySelector(".switch-container");
162
+ if (el)
163
+ el.focus(options);
164
+ else
165
+ super.focus(options);
166
+ }
167
+ updateValidity() {
168
+ const anchor = this.shadowRoot?.querySelector(".switch-container");
169
+ if (this.disabled) {
170
+ this.applyValidity({});
171
+ return;
172
+ }
173
+ if (this.required && !this.checked) {
174
+ this.applyValidity({ valueMissing: true }, nativeMessage("input", { type: "checkbox", switch: true, required: true }), anchor ?? undefined);
175
+ }
176
+ else {
177
+ this.applyValidity({});
178
+ }
179
+ }
180
+ get checked() { return this.getProperty("checked"); }
181
+ set checked(value) { this.setProperty("checked", value); }
182
+ get value() { return this.getProperty("value"); }
183
+ set value(val) { this.setProperty("value", val); }
184
+ get name() { return this.getProperty("name"); }
185
+ set name(val) { this.setProperty("name", val); }
186
+ get disabled() { return this.getProperty("disabled"); }
187
+ set disabled(value) { this.setProperty("disabled", value); }
188
+ get required() { return this.getProperty("required"); }
189
+ set required(value) { this.setProperty("required", value); }
190
+ get size() { return this.getProperty("size"); }
191
+ set size(value) { this.setProperty("size", value); }
192
+ get flavor() { return this.getProperty("flavor"); }
193
+ set flavor(value) { this.setProperty("flavor", value); }
194
+ get form() { return this._internals.form; }
164
195
  }
165
196
  TySwitch.formAssociated = true;
197
+ TySwitch.delegatesFocus = true;
198
+ TySwitch.labelClicks = true;
166
199
  TySwitch.properties = {
167
- checked: {
168
- type: "boolean",
169
- visual: true,
170
- formValue: true,
171
- emitChange: true,
172
- default: false,
173
- },
174
- value: {
175
- type: "string",
176
- default: "on",
177
- },
178
- name: {
179
- type: "string",
180
- default: "",
181
- },
182
- disabled: {
183
- type: "boolean",
184
- visual: true,
185
- default: false,
186
- },
187
- required: {
188
- type: "boolean",
189
- visual: true,
190
- default: false,
191
- },
192
- size: {
193
- type: "string",
194
- visual: true,
195
- default: "md",
196
- validate: (v) => ["xs", "sm", "md", "lg", "xl"].includes(v),
197
- coerce: (v) => {
198
- if (!["xs", "sm", "md", "lg", "xl"].includes(v)) {
199
- console.warn(`[ty-switch] Invalid size '${v}'. Using 'md'.`);
200
- return "md";
201
- }
202
- return v;
203
- },
204
- },
205
- flavor: {
206
- type: "string",
207
- visual: true,
208
- default: "primary",
209
- validate: (v) => {
210
- const valid = [
211
- "primary",
212
- "secondary",
213
- "success",
214
- "danger",
215
- "warning",
216
- "neutral",
217
- ];
218
- return valid.includes(v);
219
- },
220
- coerce: (v) => {
221
- const valid = [
222
- "primary",
223
- "secondary",
224
- "success",
225
- "danger",
226
- "warning",
227
- "neutral",
228
- ];
229
- if (!valid.includes(v)) {
230
- console.warn(`[ty-switch] Invalid flavor '${v}'. Using 'primary'.`);
231
- return "primary";
232
- }
233
- return v;
234
- },
235
- },
200
+ checked: {
201
+ type: "boolean",
202
+ visual: true,
203
+ formValue: true,
204
+ emitChange: true,
205
+ default: false,
206
+ },
207
+ value: {
208
+ type: "string",
209
+ default: "on",
210
+ },
211
+ name: {
212
+ type: "string",
213
+ default: "",
214
+ },
215
+ disabled: {
216
+ type: "boolean",
217
+ visual: true,
218
+ default: false,
219
+ },
220
+ required: {
221
+ type: "boolean",
222
+ visual: true,
223
+ default: false,
224
+ },
225
+ size: {
226
+ type: "string",
227
+ visual: true,
228
+ default: DEFAULT_SIZE,
229
+ validate: (v) => ["xs", "sm", "md", "lg", "xl"].includes(v),
230
+ coerce: (v) => {
231
+ if (!["xs", "sm", "md", "lg", "xl"].includes(v)) {
232
+ console.warn(`[ty-switch] Invalid size '${v}'. Using '${DEFAULT_SIZE}'.`);
233
+ return DEFAULT_SIZE;
234
+ }
235
+ return v;
236
+ },
237
+ },
238
+ flavor: {
239
+ type: "string",
240
+ visual: true,
241
+ default: "primary",
242
+ },
236
243
  };
237
244
  if (!customElements.get("ty-switch")) {
238
- customElements.define("ty-switch", TySwitch);
245
+ customElements.define("ty-switch", TySwitch);
239
246
  }
240
- //# sourceMappingURL=switch.js.map
@@ -1,23 +1,66 @@
1
- /**
2
- * Tab Component
3
- *
4
- * Individual tab panel with custom scrollbar via CustomScrollbar utility.
5
- */
1
+ /** Individual tab panel with custom scrollbar via CustomScrollbar utility. */
6
2
  export interface TabAttributes {
7
3
  id: string | null;
8
4
  label: string | null;
9
5
  disabled: boolean;
6
+ lazy: boolean;
7
+ }
8
+ /**
9
+ * `ty-tab-load`: a lazy tab with no content was shown. Fired on the ty-tab
10
+ * and doesn't bubble, so a lazy tab nested in another doesn't trigger the
11
+ * outer one's listener. Listen on the tab, or on ty-tabs with capture.
12
+ */
13
+ export interface TabLoadDetail {
14
+ id: string;
15
+ index: number;
10
16
  }
11
17
  export declare class TyTab extends HTMLElement {
12
18
  private _scrollbar;
19
+ private _panelLabel;
20
+ private _shown;
21
+ private _load;
22
+ private _contentObserver;
23
+ private _contentChanged;
13
24
  static get observedAttributes(): string[];
14
25
  constructor();
15
26
  connectedCallback(): void;
27
+ /** Accessible name. Set by ty-tabs, which also knows rich `label-{id}` slots. */
28
+ setPanelLabel(label: string): void;
29
+ /** Set by ty-tabs: a panel that isn't shown is inert. */
30
+ setShown(shown: boolean): void;
16
31
  disconnectedCallback(): void;
17
- attributeChangedCallback(_name: string, _oldValue: string | null, _newValue: string | null): void;
32
+ /**
33
+ * Called by ty-tabs when this tab becomes the shown one — never for the
34
+ * tab shown first, whose content the page is expected to carry. A lazy
35
+ * tab with no content (or whose load failed) asks for it.
36
+ */
37
+ _requestLoad(index: number): void;
38
+ /**
39
+ * Report that loading this tab's content failed: shows `slot="error"`
40
+ * (default "Couldn't load.") with a Retry button. Retry, or showing the
41
+ * tab again, fires `ty-tab-load` once more. Content arriving clears it.
42
+ */
43
+ loadFailed(): void;
44
+ attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
18
45
  private _render;
46
+ /** Lazy tabs track whether they have content; others don't watch. */
47
+ private _watchContent;
48
+ private _hasContent;
49
+ /**
50
+ * `mutated`: content changed under a connected tab. Content that goes away
51
+ * (a morph with the server's empty markup) loads again — right away when
52
+ * this tab is the one shown, otherwise the next time it's shown.
53
+ */
54
+ private _checkContent;
55
+ private _fireLoad;
56
+ /**
57
+ * Placeholder and error, built the first time a tab loads: tabs that never
58
+ * do carry no hidden "Couldn't load / Retry" text.
59
+ */
60
+ private _ensureStatus;
61
+ private _setLoad;
62
+ private _syncPanel;
19
63
  private _setupScrollbar;
20
64
  private _destroyScrollbar;
21
65
  resetScroll(): void;
22
66
  }
23
- //# sourceMappingURL=tab.d.ts.map