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,39 +1,29 @@
1
1
  /**
2
- * TyOption Web Component
3
- * PORTED FROM: clj/ty/components/option.cljs
2
+ * TyOption Web Component - rich HTML alternative to native <option>.
3
+ * Property-attribute synchronization keeps it compatible with frameworks.
4
4
  *
5
- * Ty Option Web Component - Rich HTML alternative to native <option>
6
- * Enhanced with robust property-attribute synchronization for framework compatibility.
5
+ * Two kinds of selection state, never mixed:
6
+ * - `selected` (attribute/property) is the APP's mark. Only ty-select's
7
+ * `external-selection` mode reads it; otherwise the select's `value` rules.
8
+ * - `checked` (property only) is what the parent ty-select decided: it draws
9
+ * the check and aria-selected. Never written to an attribute, so a server
10
+ * morph has nothing of ours to strip.
11
+ * role="option" is an attribute (audit tools like axe don't read
12
+ * ElementInternals); it never changes, and comes back if a morph strips it.
7
13
  */
8
14
  import type { TyOptionElement } from '../types/common.js';
9
- /**
10
- * Ty Option Component
11
- *
12
- * Rich HTML alternative to native <option> element.
13
- * Supports HTML content, styling, and framework property binding.
14
- *
15
- * @example
16
- * ```html
17
- * <ty-option value="1">Simple Option</ty-option>
18
- * <ty-option value="2" selected>Selected Option</ty-option>
19
- * <ty-option value="3" disabled>Disabled Option</ty-option>
20
- * <ty-option value="4">
21
- * <strong>Rich</strong> <em>HTML</em> Content
22
- * </ty-option>
23
- * ```
24
- */
25
15
  export declare class TyOption extends HTMLElement implements TyOptionElement {
26
16
  private _value;
27
17
  private _selected;
18
+ private _checked;
19
+ private _inTrigger;
28
20
  private _disabled;
29
21
  private _highlighted;
30
22
  private _hidden;
31
- private _isMobile;
32
- private _clearButtonHandler;
23
+ private _internals;
33
24
  constructor();
34
25
  static get observedAttributes(): string[];
35
26
  connectedCallback(): void;
36
- disconnectedCallback(): void;
37
27
  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
38
28
  /**
39
29
  * Get value from either property or attribute, with textContent fallback.
@@ -42,25 +32,20 @@ export declare class TyOption extends HTMLElement implements TyOptionElement {
42
32
  private getOptionValue;
43
33
  get value(): string | undefined;
44
34
  set value(val: string | undefined);
35
+ /** The app's mark, read by ty-select only in `external-selection` mode. */
45
36
  get selected(): boolean;
46
37
  set selected(value: boolean);
38
+ /** Set by the parent ty-select: draws the check and aria-selected. */
39
+ get checked(): boolean;
40
+ set checked(value: boolean);
41
+ /** Set by the parent ty-select while this option is shown in its trigger. */
42
+ get inTrigger(): boolean;
43
+ set inTrigger(value: boolean);
47
44
  get disabled(): boolean;
48
45
  set disabled(value: boolean);
49
46
  get highlighted(): boolean;
50
47
  set highlighted(value: boolean);
51
48
  get hidden(): boolean;
52
49
  set hidden(value: boolean);
53
- /**
54
- * Remove clear button event listener if it exists
55
- */
56
- private removeClearButtonListener;
57
- /**
58
- * Add clear button event listener (only if not already added)
59
- */
60
- private addClearButtonListener;
61
- /**
62
- * Render the option component with rich HTML content and property sync
63
- */
64
50
  private render;
65
51
  }
66
- //# sourceMappingURL=option.d.ts.map
@@ -1,314 +1,189 @@
1
- /**
2
- * TyOption Web Component
3
- * PORTED FROM: clj/ty/components/option.cljs
4
- *
5
- * Ty Option Web Component - Rich HTML alternative to native <option>
6
- * Enhanced with robust property-attribute synchronization for framework compatibility.
7
- */
8
1
  import { ensureStyles } from '../utils/styles.js';
2
+ import { coerceBoolean } from '../utils/property-manager.js';
3
+ import { upgradeProperties } from '../utils/upgrade-properties.js';
9
4
  import { optionStyles } from '../styles/option.js';
10
- import { isMobileTouch } from '../utils/mobile.js';
11
- /**
12
- * Ty Option Component
13
- *
14
- * Rich HTML alternative to native <option> element.
15
- * Supports HTML content, styling, and framework property binding.
16
- *
17
- * @example
18
- * ```html
19
- * <ty-option value="1">Simple Option</ty-option>
20
- * <ty-option value="2" selected>Selected Option</ty-option>
21
- * <ty-option value="3" disabled>Disabled Option</ty-option>
22
- * <ty-option value="4">
23
- * <strong>Rich</strong> <em>HTML</em> Content
24
- * </ty-option>
25
- * ```
26
- */
5
+ const CHECK_SVG = `
6
+ <svg class="option-check" viewBox="0 0 24 24" fill="none" stroke="currentColor"
7
+ stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
8
+ <path d="M20 6 9 17l-5-5" />
9
+ </svg>
10
+ `;
27
11
  export class TyOption extends HTMLElement {
28
- constructor() {
29
- super();
30
- this._value = undefined;
31
- this._selected = false;
32
- this._disabled = false;
33
- this._highlighted = false;
34
- this._hidden = false;
35
- // Clear button event handler reference for cleanup
36
- this._clearButtonHandler = null;
37
- // Detect mobile device automatically
38
- this._isMobile = isMobileTouch();
39
- const shadow = this.attachShadow({ mode: 'open' });
40
- ensureStyles(shadow, { css: optionStyles, id: 'ty-option' });
41
- this.render();
42
- }
43
- static get observedAttributes() {
44
- return ['value', 'disabled', 'selected', 'highlighted', 'hidden'];
45
- }
46
- connectedCallback() {
47
- // CRITICAL: Reagent/React may set properties BEFORE the element is constructed
48
- // Check if value was set directly on the instance before our getter/setter was available
49
- const instanceValue = Object.getOwnPropertyDescriptor(this, 'value');
50
- if (instanceValue && instanceValue.value !== undefined) {
51
- this._value = instanceValue.value;
52
- // Clean up the instance property so our getter/setter works
53
- delete this.value;
54
- }
55
- this.render();
56
- }
57
- disconnectedCallback() {
58
- // Clean up clear button event listener
59
- this.removeClearButtonListener();
60
- }
61
- attributeChangedCallback(name, oldValue, newValue) {
62
- if (oldValue === newValue)
63
- return;
64
- switch (name) {
65
- case 'value':
66
- this._value = newValue || undefined;
67
- break;
68
- case 'selected':
69
- this._selected = newValue !== null;
70
- break;
71
- case 'disabled':
72
- this._disabled = newValue !== null;
73
- break;
74
- case 'highlighted':
75
- this._highlighted = newValue !== null;
76
- break;
77
- case 'hidden':
78
- this._hidden = newValue !== null;
79
- break;
80
- }
81
- this.render();
82
- }
83
- /**
84
- * Get value from either property or attribute, with textContent fallback.
85
- * Property takes precedence (for framework compatibility).
86
- */
87
- getOptionValue() {
88
- // Explicit priority: property > attribute > textContent
89
- // This correctly handles empty strings
90
- if (this._value !== undefined) {
91
- return this._value;
92
- }
93
- const attrValue = this.getAttribute('value');
94
- if (attrValue !== null) {
95
- return attrValue;
96
- }
97
- return this.textContent?.trim() || '';
98
- }
99
- // Public API - Getters/Setters
100
- // NOTE: All setters trigger re-render to support property changes from frameworks like React
101
- get value() {
102
- return this.getOptionValue();
103
- }
104
- set value(val) {
105
- if (this._value !== val) {
106
- this._value = val;
107
- if (val !== undefined) {
108
- this.setAttribute('value', val);
109
- }
110
- else {
111
- this.removeAttribute('value');
112
- }
113
- this.render();
114
- }
115
- }
116
- get selected() {
117
- return this._selected;
118
- }
119
- set selected(value) {
120
- if (this._selected !== value) {
121
- this._selected = value;
122
- if (value) {
123
- this.setAttribute('selected', '');
124
- }
125
- else {
126
- this.removeAttribute('selected');
127
- }
128
- this.render();
129
- }
130
- }
131
- get disabled() {
132
- return this._disabled;
133
- }
134
- set disabled(value) {
135
- if (this._disabled !== value) {
136
- this._disabled = value;
137
- if (value) {
138
- this.setAttribute('disabled', '');
139
- }
140
- else {
141
- this.removeAttribute('disabled');
142
- }
143
- this.render();
144
- }
145
- }
146
- get highlighted() {
147
- return this._highlighted;
148
- }
149
- set highlighted(value) {
150
- if (this._highlighted !== value) {
151
- this._highlighted = value;
152
- if (value) {
153
- this.setAttribute('highlighted', '');
154
- }
155
- else {
156
- this.removeAttribute('highlighted');
157
- }
158
- this.render();
159
- }
160
- }
161
- get hidden() {
162
- return this._hidden;
163
- }
164
- set hidden(value) {
165
- if (this._hidden !== value) {
166
- this._hidden = value;
167
- if (value) {
168
- this.setAttribute('hidden', '');
169
- }
170
- else {
171
- this.removeAttribute('hidden');
172
- }
173
- this.render();
174
- }
175
- }
176
- /**
177
- * Remove clear button event listener if it exists
178
- */
179
- removeClearButtonListener() {
180
- if (this._clearButtonHandler) {
181
- const clearBtn = this.shadowRoot?.querySelector('.option-clear-btn');
182
- if (clearBtn) {
183
- clearBtn.removeEventListener('click', this._clearButtonHandler);
184
- }
185
- this._clearButtonHandler = null;
186
- }
187
- }
188
- /**
189
- * Add clear button event listener (only if not already added)
190
- */
191
- addClearButtonListener(clearBtn) {
192
- // Remove existing listener first (if any)
193
- this.removeClearButtonListener();
194
- // Create new handler
195
- this._clearButtonHandler = (e) => {
196
- e.preventDefault();
197
- e.stopPropagation();
198
- this.dispatchEvent(new CustomEvent('clear-selection', {
199
- bubbles: true,
200
- composed: true,
201
- detail: { value: this._value }
202
- }));
203
- };
204
- // Add listener
205
- clearBtn.addEventListener('click', this._clearButtonHandler);
206
- }
207
- /**
208
- * Render the option component with rich HTML content and property sync
209
- */
210
- render() {
211
- const shadow = this.shadowRoot;
212
- const value = this.getOptionValue();
213
- // Create wrapper with optional clear button
214
- if (!shadow.querySelector('.option-content')) {
215
- const shouldShowClear = this._selected && this._isMobile;
216
- if (shouldShowClear) {
217
- shadow.innerHTML = `
218
- <div class="option-content">
219
- <span class="option-text"><slot></slot></span>
220
- <button class="option-clear-btn" type="button" aria-label="Clear selection">
221
- <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
222
- <line x1="18" y1="6" x2="6" y2="18"></line>
223
- <line x1="6" y1="6" x2="18" y2="18"></line>
224
- </svg>
225
- </button>
226
- </div>
227
- `;
228
- // Add clear button click handler
229
- const clearBtn = shadow.querySelector('.option-clear-btn');
230
- if (clearBtn) {
231
- this.addClearButtonListener(clearBtn);
232
- }
233
- }
234
- else {
235
- shadow.innerHTML = '<div class="option-content"><slot></slot></div>';
236
- }
237
- }
238
- else {
239
- // Update existing content - add/remove clear button as needed
240
- const shouldShowClear = this._selected && this._isMobile;
241
- const existingClearBtn = shadow.querySelector('.option-clear-btn');
242
- if (shouldShowClear && !existingClearBtn) {
243
- // Need to add clear button
244
- const content = shadow.querySelector('.option-content');
245
- if (content) {
246
- // Wrap slot in span if not already wrapped
247
- const slot = content.querySelector('slot');
248
- if (slot && !slot.parentElement?.classList.contains('option-text')) {
249
- const textSpan = document.createElement('span');
250
- textSpan.className = 'option-text';
251
- slot.parentNode?.insertBefore(textSpan, slot);
252
- textSpan.appendChild(slot);
253
- }
254
- // Add clear button
255
- const clearBtn = document.createElement('button');
256
- clearBtn.className = 'option-clear-btn';
257
- clearBtn.type = 'button';
258
- clearBtn.setAttribute('aria-label', 'Clear selection');
259
- clearBtn.innerHTML = `
260
- <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
261
- <line x1="18" y1="6" x2="6" y2="18"></line>
262
- <line x1="6" y1="6" x2="18" y2="18"></line>
263
- </svg>
264
- `;
265
- this.addClearButtonListener(clearBtn);
266
- content.appendChild(clearBtn);
267
- }
268
- }
269
- else if (!shouldShowClear && existingClearBtn) {
270
- // Remove clear button
271
- existingClearBtn.remove();
272
- // Clean up event listener
273
- this.removeClearButtonListener();
274
- }
275
- }
276
- // Update content wrapper attributes
277
- const content = shadow.querySelector('.option-content');
278
- if (content) {
279
- // Disabled state
280
- if (this._disabled) {
281
- content.setAttribute('disabled', '');
282
- }
283
- else {
284
- content.removeAttribute('disabled');
285
- }
286
- // Selected state
287
- if (this._selected) {
288
- content.setAttribute('selected', '');
289
- }
290
- else {
291
- content.removeAttribute('selected');
292
- }
293
- // Highlighted state
294
- if (this._highlighted) {
295
- content.setAttribute('highlighted', '');
296
- }
297
- else {
298
- content.removeAttribute('highlighted');
299
- }
300
- // Hidden state
301
- if (this._hidden) {
302
- content.setAttribute('hidden', '');
303
- }
304
- else {
305
- content.removeAttribute('hidden');
306
- }
307
- }
308
- }
309
- }
310
- // Register the custom element
12
+ constructor() {
13
+ super();
14
+ this._value = undefined;
15
+ this._selected = false;
16
+ this._checked = false;
17
+ this._inTrigger = false;
18
+ this._disabled = false;
19
+ this._highlighted = false;
20
+ this._hidden = false;
21
+ const shadow = this.attachShadow({ mode: 'open' });
22
+ ensureStyles(shadow, { css: optionStyles, id: 'ty-option' });
23
+ this._internals = this.attachInternals();
24
+ this._internals.ariaSelected = 'false';
25
+ this.render();
26
+ }
27
+ static get observedAttributes() {
28
+ return ['value', 'disabled', 'selected', 'highlighted', 'hidden', 'role'];
29
+ }
30
+ connectedCallback() {
31
+ upgradeProperties(this);
32
+ if (!this.hasAttribute('role'))
33
+ this.setAttribute('role', 'option');
34
+ this.render();
35
+ }
36
+ attributeChangedCallback(name, oldValue, newValue) {
37
+ if (oldValue === newValue)
38
+ return;
39
+ switch (name) {
40
+ case 'value':
41
+ this._value = newValue || undefined;
42
+ break;
43
+ case 'selected':
44
+ this._selected = newValue !== null && !/^(false|0)$/i.test(newValue.trim());
45
+ break;
46
+ case 'disabled':
47
+ this._disabled = newValue !== null;
48
+ break;
49
+ case 'highlighted':
50
+ this._highlighted = newValue !== null;
51
+ break;
52
+ case 'hidden':
53
+ this._hidden = newValue !== null;
54
+ break;
55
+ case 'role':
56
+ if (newValue === null && this.isConnected)
57
+ this.setAttribute('role', 'option');
58
+ return;
59
+ }
60
+ this.render();
61
+ }
62
+ getOptionValue() {
63
+ if (this._value !== undefined) {
64
+ return this._value;
65
+ }
66
+ const attrValue = this.getAttribute('value');
67
+ if (attrValue !== null) {
68
+ return attrValue;
69
+ }
70
+ return this.textContent?.trim() || '';
71
+ }
72
+ get value() {
73
+ return this.getOptionValue();
74
+ }
75
+ set value(val) {
76
+ if (this._value !== val) {
77
+ this._value = val;
78
+ if (val !== undefined) {
79
+ this.setAttribute('value', val);
80
+ }
81
+ else {
82
+ this.removeAttribute('value');
83
+ }
84
+ this.render();
85
+ }
86
+ }
87
+ get selected() {
88
+ return this._selected;
89
+ }
90
+ set selected(value) {
91
+ value = coerceBoolean(value);
92
+ if (this._selected !== value) {
93
+ this._selected = value;
94
+ if (value) {
95
+ this.setAttribute('selected', '');
96
+ }
97
+ else {
98
+ this.removeAttribute('selected');
99
+ }
100
+ }
101
+ }
102
+ get checked() {
103
+ return this._checked;
104
+ }
105
+ set checked(value) {
106
+ value = coerceBoolean(value);
107
+ if (this._checked !== value) {
108
+ this._checked = value;
109
+ this._internals.ariaSelected = String(value);
110
+ this.render();
111
+ }
112
+ }
113
+ get inTrigger() {
114
+ return this._inTrigger;
115
+ }
116
+ set inTrigger(value) {
117
+ value = coerceBoolean(value);
118
+ if (this._inTrigger !== value) {
119
+ this._inTrigger = value;
120
+ this.render();
121
+ }
122
+ }
123
+ get disabled() {
124
+ return this._disabled;
125
+ }
126
+ set disabled(value) {
127
+ value = coerceBoolean(value);
128
+ if (this._disabled !== value) {
129
+ this._disabled = value;
130
+ if (value) {
131
+ this.setAttribute('disabled', '');
132
+ }
133
+ else {
134
+ this.removeAttribute('disabled');
135
+ }
136
+ this.render();
137
+ }
138
+ }
139
+ get highlighted() {
140
+ return this._highlighted;
141
+ }
142
+ set highlighted(value) {
143
+ value = coerceBoolean(value);
144
+ if (this._highlighted !== value) {
145
+ this._highlighted = value;
146
+ if (value) {
147
+ this.setAttribute('highlighted', '');
148
+ }
149
+ else {
150
+ this.removeAttribute('highlighted');
151
+ }
152
+ this.render();
153
+ }
154
+ }
155
+ get hidden() {
156
+ return this._hidden;
157
+ }
158
+ set hidden(value) {
159
+ value = coerceBoolean(value);
160
+ if (this._hidden !== value) {
161
+ this._hidden = value;
162
+ if (value) {
163
+ this.setAttribute('hidden', '');
164
+ }
165
+ else {
166
+ this.removeAttribute('hidden');
167
+ }
168
+ this.render();
169
+ }
170
+ }
171
+ render() {
172
+ const shadow = this.shadowRoot;
173
+ if (!shadow.querySelector('.option-content')) {
174
+ shadow.innerHTML = `<div class="option-content"><slot></slot>${CHECK_SVG}</div>`;
175
+ }
176
+ this._internals.ariaDisabled = this._disabled ? 'true' : null;
177
+ const content = shadow.querySelector('.option-content');
178
+ if (content) {
179
+ content.toggleAttribute('disabled', this._disabled);
180
+ content.toggleAttribute('selected', this._checked);
181
+ content.toggleAttribute('highlighted', this._highlighted);
182
+ content.toggleAttribute('hidden', this._hidden);
183
+ content.classList.toggle('in-trigger', this._inTrigger);
184
+ }
185
+ }
186
+ }
311
187
  if (!customElements.get('ty-option')) {
312
- customElements.define('ty-option', TyOption);
188
+ customElements.define('ty-option', TyOption);
313
189
  }
314
- //# sourceMappingURL=option.js.map
@@ -1,19 +1,6 @@
1
1
  /**
2
- * Popup Component
3
- *
4
- * Interactive popup component with dropdown-like behavior and tooltip positioning.
5
- * Uses parent-child relationship - popup opens on click, stays open for interaction,
6
- * closes on outside click or ESC key.
7
- *
8
- * @example
9
- * <button>
10
- * Click me
11
- * <ty-popup placement="bottom" offset="8">
12
- * <div class="ty-elevated p-4 rounded-lg">
13
- * Popup content here
14
- * </div>
15
- * </ty-popup>
16
- * </button>
2
+ * Popup Component - click-triggered popup positioned against its PARENT element
3
+ * (the anchor). Stays open for interaction; closes on outside click or ESC.
17
4
  */
18
5
  import { type Placement } from '../utils/positioning.js';
19
6
  /**
@@ -33,11 +20,9 @@ export declare class TyPopup extends HTMLElement {
33
20
  closePopup?: () => void;
34
21
  openPopup?: () => void;
35
22
  togglePopup?: () => void;
36
- /** Observed attributes */
37
23
  static get observedAttributes(): string[];
38
24
  constructor();
39
25
  connectedCallback(): void;
40
26
  disconnectedCallback(): void;
41
27
  attributeChangedCallback(name: string, _oldValue: string | null, _newValue: string | null): void;
42
28
  }
43
- //# sourceMappingURL=popup.d.ts.map