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,76 +1,210 @@
1
- /**
2
- * Tab Component
3
- *
4
- * Individual tab panel with custom scrollbar via CustomScrollbar utility.
5
- */
6
1
  import { ensureStyles } from '../utils/styles.js';
7
2
  import { tabStyles } from '../styles/tab.js';
8
3
  import { CustomScrollbar, isCustomScrollbarEnabled } from '../utils/custom-scrollbar.js';
4
+ import { getLoaderSvg } from '../utils/loader-registry.js';
5
+ const STATUS_SLOTS = new Set(['loading', 'error']);
6
+ const INERT_ELEMENTS = new Set(['template', 'script', 'style']);
9
7
  export class TyTab extends HTMLElement {
10
- static get observedAttributes() {
11
- return ['id', 'label', 'disabled'];
12
- }
13
- constructor() {
14
- super();
15
- this._scrollbar = null;
16
- this.attachShadow({ mode: 'open' });
17
- }
18
- connectedCallback() {
19
- this._render();
20
- }
21
- disconnectedCallback() {
22
- this._destroyScrollbar();
23
- }
24
- attributeChangedCallback(_name, _oldValue, _newValue) {
25
- this._render();
26
- }
27
- _render() {
28
- const shadowRoot = this.shadowRoot;
29
- if (!shadowRoot)
30
- return;
31
- const id = this.getAttribute('id');
32
- if (!shadowRoot.querySelector('.tab-wrapper')) {
33
- ensureStyles(shadowRoot, { css: tabStyles, id: 'ty-tab' });
34
- shadowRoot.innerHTML = `
35
- <div class="tab-wrapper"
36
- role="tabpanel"
37
- ${id ? `id="panel-${id}"` : ''}
38
- ${id ? `aria-labelledby="tab-${id}"` : ''}
39
- >
40
- <div class="tab-panel">
41
- <slot></slot>
42
- </div>
43
- </div>
44
- `;
45
- this._setupScrollbar();
46
- }
47
- }
48
- _setupScrollbar() {
49
- const panel = this.shadowRoot?.querySelector('.tab-panel');
50
- const wrapper = this.shadowRoot?.querySelector('.tab-wrapper');
51
- if (!panel || !wrapper)
52
- return;
53
- if (!isCustomScrollbarEnabled())
54
- return;
55
- panel.classList.add('ty-custom-scroll');
56
- this._scrollbar = new CustomScrollbar(panel, { vertical: true });
57
- // Append track to wrapper (outside the scroll area, so it stays fixed)
58
- if (this._scrollbar.trackY) {
59
- wrapper.appendChild(this._scrollbar.trackY);
60
- }
61
- }
62
- _destroyScrollbar() {
63
- if (this._scrollbar) {
64
- this._scrollbar.trackY?.remove();
65
- this._scrollbar.destroy();
66
- this._scrollbar = null;
67
- }
68
- }
69
- resetScroll() {
70
- this._scrollbar?.scrollToTop(false);
71
- }
8
+ static get observedAttributes() {
9
+ return ['id', 'label', 'disabled', 'lazy'];
10
+ }
11
+ constructor() {
12
+ super();
13
+ this._scrollbar = null;
14
+ this._panelLabel = null;
15
+ this._shown = true;
16
+ this._load = 'idle';
17
+ this._contentObserver = null;
18
+ this._contentChanged = false;
19
+ this.attachShadow({ mode: 'open' });
20
+ }
21
+ connectedCallback() {
22
+ this._render();
23
+ if (!this._scrollbar)
24
+ this._setupScrollbar();
25
+ this._watchContent();
26
+ }
27
+ setPanelLabel(label) {
28
+ this._panelLabel = label;
29
+ this._syncPanel();
30
+ }
31
+ setShown(shown) {
32
+ this._shown = shown;
33
+ this._syncPanel();
34
+ }
35
+ disconnectedCallback() {
36
+ this._destroyScrollbar();
37
+ this._contentChanged = !!this._contentObserver?.takeRecords().length;
38
+ this._contentObserver?.disconnect();
39
+ this._contentObserver = null;
40
+ }
41
+ _requestLoad(index) {
42
+ if (this._contentObserver?.takeRecords().length)
43
+ this._checkContent(false);
44
+ if (this._load === 'empty' || this._load === 'failed')
45
+ this._fireLoad(index);
46
+ }
47
+ loadFailed() {
48
+ if (this._load === 'loading' || this._load === 'empty')
49
+ this._setLoad('failed');
50
+ }
51
+ attributeChangedCallback(name, oldValue, newValue) {
52
+ this._render();
53
+ if (name === 'lazy') {
54
+ if (this.isConnected)
55
+ this._watchContent();
56
+ return;
57
+ }
58
+ const tabs = this.parentElement;
59
+ if (oldValue !== newValue && this.isConnected && tabs?.localName === 'ty-tabs') {
60
+ tabs._queueUpdate?.(true);
61
+ }
62
+ }
63
+ _render() {
64
+ const shadowRoot = this.shadowRoot;
65
+ if (!shadowRoot)
66
+ return;
67
+ if (!shadowRoot.querySelector('.tab-wrapper')) {
68
+ ensureStyles(shadowRoot, { css: tabStyles, id: 'ty-tab' });
69
+ shadowRoot.innerHTML = `
70
+ <div class="tab-wrapper">
71
+ <div class="tab-panel" role="tabpanel" tabindex="0">
72
+ <slot></slot>
73
+ </div>
74
+ </div>
75
+ `;
76
+ }
77
+ this._syncPanel();
78
+ }
79
+ _watchContent() {
80
+ const lazy = this.hasAttribute('lazy');
81
+ if (lazy && !this._contentObserver) {
82
+ this._contentObserver = new MutationObserver(() => this._checkContent(true));
83
+ this._contentObserver.observe(this, { childList: true, characterData: true, subtree: true });
84
+ }
85
+ else if (!lazy && this._contentObserver) {
86
+ this._contentObserver.disconnect();
87
+ this._contentObserver = null;
88
+ }
89
+ const changed = this._contentChanged;
90
+ this._contentChanged = false;
91
+ this._checkContent(changed);
92
+ }
93
+ _hasContent() {
94
+ for (const node of Array.from(this.childNodes)) {
95
+ if (node.nodeType === Node.TEXT_NODE && node.textContent.trim())
96
+ return true;
97
+ if (node.nodeType !== Node.ELEMENT_NODE)
98
+ continue;
99
+ const el = node;
100
+ if (!STATUS_SLOTS.has(el.getAttribute('slot') ?? '') && !INERT_ELEMENTS.has(el.localName))
101
+ return true;
102
+ }
103
+ return false;
104
+ }
105
+ _checkContent(mutated) {
106
+ if (!this.hasAttribute('lazy') || this._hasContent()) {
107
+ this._setLoad('idle');
108
+ return;
109
+ }
110
+ if (this._load !== 'idle')
111
+ return;
112
+ this._setLoad('empty');
113
+ if (!mutated)
114
+ return;
115
+ queueMicrotask(() => {
116
+ if (this._load === 'empty' && this._shown && this.parentElement?.localName === 'ty-tabs')
117
+ this._fireLoad();
118
+ });
119
+ }
120
+ _fireLoad(index) {
121
+ const tabs = this.parentElement;
122
+ if (index === undefined) {
123
+ index = tabs?.localName === 'ty-tabs'
124
+ ? Array.from(tabs.querySelectorAll(':scope > ty-tab')).indexOf(this)
125
+ : 0;
126
+ }
127
+ this._setLoad('loading');
128
+ this.dispatchEvent(new CustomEvent('ty-tab-load', { detail: { id: this.id, index } }));
129
+ }
130
+ _ensureStatus(panel) {
131
+ if (panel.querySelector('.tab-loading'))
132
+ return;
133
+ panel.insertAdjacentHTML('beforeend', `
134
+ <div class="tab-loading" part="loading">
135
+ <slot name="loading"><span class="tab-spinner" part="spinner" aria-hidden="true"></span></slot>
136
+ </div>
137
+ <div class="tab-error" part="error" role="alert">
138
+ <slot name="error">Couldn't load.</slot>
139
+ <button type="button" class="tab-retry" part="retry">Retry</button>
140
+ </div>
141
+ `);
142
+ panel.querySelector('.tab-retry').addEventListener('click', () => {
143
+ panel.focus({ preventScroll: true });
144
+ this._fireLoad();
145
+ });
146
+ }
147
+ _setLoad(state) {
148
+ if (state === this._load)
149
+ return;
150
+ this._load = state;
151
+ const panel = this.shadowRoot?.querySelector('.tab-panel');
152
+ if (!panel)
153
+ return;
154
+ if (state === 'loading' || state === 'failed') {
155
+ this._ensureStatus(panel);
156
+ panel.dataset.load = state;
157
+ }
158
+ else {
159
+ delete panel.dataset.load;
160
+ }
161
+ if (state === 'loading') {
162
+ panel.setAttribute('aria-busy', 'true');
163
+ panel.querySelector('.tab-spinner').innerHTML = getLoaderSvg();
164
+ }
165
+ else {
166
+ panel.removeAttribute('aria-busy');
167
+ }
168
+ }
169
+ _syncPanel() {
170
+ const panel = this.shadowRoot?.querySelector('.tab-panel');
171
+ if (!panel)
172
+ return;
173
+ const tabs = this.parentElement;
174
+ const rich = !this._panelLabel && this.id && tabs?.localName === 'ty-tabs'
175
+ ? tabs.querySelector(`:scope > [slot="label-${CSS.escape(this.id)}"]`)
176
+ : null;
177
+ const label = this._panelLabel || rich?.textContent?.trim() || this.getAttribute('label');
178
+ if (label)
179
+ panel.setAttribute('aria-label', label);
180
+ else
181
+ panel.removeAttribute('aria-label');
182
+ panel.parentElement.inert = !this._shown;
183
+ }
184
+ _setupScrollbar() {
185
+ const panel = this.shadowRoot?.querySelector('.tab-panel');
186
+ const wrapper = this.shadowRoot?.querySelector('.tab-wrapper');
187
+ if (!panel || !wrapper)
188
+ return;
189
+ if (!isCustomScrollbarEnabled())
190
+ return;
191
+ panel.classList.add('ty-custom-scroll');
192
+ this._scrollbar = new CustomScrollbar(panel, { vertical: true });
193
+ if (this._scrollbar.trackY) {
194
+ wrapper.appendChild(this._scrollbar.trackY);
195
+ }
196
+ }
197
+ _destroyScrollbar() {
198
+ if (this._scrollbar) {
199
+ this._scrollbar.trackY?.remove();
200
+ this._scrollbar.destroy();
201
+ this._scrollbar = null;
202
+ }
203
+ }
204
+ resetScroll() {
205
+ this._scrollbar?.scrollToTop(false);
206
+ }
72
207
  }
73
208
  if (!customElements.get('ty-tab')) {
74
- customElements.define('ty-tab', TyTab);
209
+ customElements.define('ty-tab', TyTab);
75
210
  }
76
- //# sourceMappingURL=tab.js.map
@@ -1,65 +1,7 @@
1
1
  /**
2
- * Tabs Component
3
- *
4
- * A carousel-based tabs component with smooth animations and fixed container dimensions.
5
- * Features horizontal sliding transitions, smart positioning marker, and independent panel scrolling.
6
- *
7
- * Features:
8
- * - Carousel animation with smooth sliding transitions
9
- * - Fixed dimensions prevent layout shift between tabs
10
- * - Animated marker that follows active tab button
11
- * - Rich label support via slots (icons, badges, custom content)
12
- * - Custom marker slot for complete active tab styling control
13
- * - Independent panel scrolling with scroll position reset
14
- * - ResizeObserver for responsive percentage widths
15
- * - Smart rendering - only updates DOM when necessary
16
- * - Accessibility with ARIA roles and attributes
17
- * - Top/bottom placement for tab buttons
18
- *
19
- * @example
20
- * <!-- Basic tabs with text labels -->
21
- * <ty-tabs width="800px" height="600px" active="general">
22
- * <ty-tab id="general" label="General Settings">
23
- * <div class="p-6">General content...</div>
24
- * </ty-tab>
25
- * <ty-tab id="advanced" label="Advanced Settings">
26
- * <div class="p-6">Advanced content...</div>
27
- * </ty-tab>
28
- * </ty-tabs>
29
- *
30
- * @example
31
- * <!-- Rich labels with icons and badges -->
32
- * <ty-tabs width="800px" height="600px">
33
- * <!-- Rich label as direct child -->
34
- * <span slot="label-profile" class="flex items-center gap-2">
35
- * <ty-icon name="user" size="sm"></ty-icon>
36
- * Profile
37
- * </span>
38
- *
39
- * <span slot="label-notifications" class="flex items-center gap-2">
40
- * <ty-icon name="bell" size="sm"></ty-icon>
41
- * Notifications
42
- * <span class="ty-bg-danger ty-text-danger++ px-2 py-0.5 rounded-full text-xs">5</span>
43
- * </span>
44
- *
45
- * <!-- Tab panels -->
46
- * <ty-tab id="profile">...</ty-tab>
47
- * <ty-tab id="notifications">...</ty-tab>
48
- * </ty-tabs>
49
- *
50
- * @example
51
- * <!-- Custom marker styling -->
52
- * <ty-tabs width="100%" height="400px">
53
- * <!-- Gradient marker slot -->
54
- * <div slot="marker" style="
55
- * background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
56
- * border-radius: 0.5rem;
57
- * box-shadow: 0 2px 8px rgba(0,0,0,0.15);
58
- * "></div>
59
- *
60
- * <ty-tab id="tab1" label="Dashboard">...</ty-tab>
61
- * <ty-tab id="tab2" label="Analytics">...</ty-tab>
62
- * </ty-tabs>
2
+ * Tabs Component — carousel-based tabs with sliding transitions, an animated
3
+ * active marker, and fixed container dimensions. Expects `ty-tab` children;
4
+ * rich labels come from `slot="label-{tab-id}"` children of `ty-tabs` itself.
63
5
  */
64
6
  /**
65
7
  * Tabs container attributes configuration
@@ -69,9 +11,11 @@ export interface TabsAttributes {
69
11
  height: string;
70
12
  active: string | null;
71
13
  placement: 'top' | 'bottom';
14
+ fixed: boolean;
72
15
  }
73
16
  /**
74
- * Tab change event detail
17
+ * Tab change event detail. Fired whenever the shown tab changes after the
18
+ * first one is shown — never for the initial tab.
75
19
  */
76
20
  export interface TabChangeDetail {
77
21
  activeId: string;
@@ -83,11 +27,22 @@ export interface TabChangeDetail {
83
27
  * TyTabs Web Component
84
28
  */
85
29
  export declare class TyTabs extends HTMLElement {
86
- /** Observed attributes */
87
30
  static get observedAttributes(): string[];
88
31
  constructor();
32
+ private _childObserver;
33
+ private _updateQueued;
34
+ private _structureDirty;
35
+ /** ID of the tab currently shown (`active` may be stale or missing after a morph). */
36
+ get activeTab(): string | null;
89
37
  connectedCallback(): void;
90
38
  disconnectedCallback(): void;
39
+ /**
40
+ * External changes (`active` set by app or server, children added or
41
+ * removed, a ty-tab's id/label/disabled changed — ty-tab reports those)
42
+ * settle in one microtask: a morph sets attributes and swaps children in
43
+ * one go, and the shown tab must be decided once the whole batch has
44
+ * landed — `active` may name a tab that is appended after it.
45
+ */
46
+ _queueUpdate(structure: boolean): void;
91
47
  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
92
48
  }
93
- //# sourceMappingURL=tabs.d.ts.map