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,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", this.checked ? "true" : "false");
127
- switchEl.setAttribute("aria-disabled", this.disabled ? "true" : "false");
128
- switchEl.setAttribute("aria-required", this.required ? "true" : "false");
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", this.checked ? "true" : "false");
142
- switchEl.setAttribute("aria-disabled", this.disabled ? "true" : "false");
143
- switchEl.setAttribute("aria-required", this.required ? "true" : "false");
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