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,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