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,24 +1,6 @@
1
1
  /**
2
- * TyResizeObserver Web Component
3
- *
4
- * Self-observing resize component that tracks its own dimensions
5
- * and stores them in a global registry accessible by element ID.
6
- *
7
- * @example
8
- * ```html
9
- * <ty-resize-observer id="parent-container">
10
- * <div class="child">
11
- * <!-- Child can query parent size via getSize('parent-container') -->
12
- * </div>
13
- * </ty-resize-observer>
14
- * ```
15
- *
16
- * @example With debouncing
17
- * ```html
18
- * <ty-resize-observer id="container" debounce="100">
19
- * <!-- Only updates after 100ms of no resize activity -->
20
- * </ty-resize-observer>
21
- * ```
2
+ * TyResizeObserver Web Component - self-observing element that tracks its own
3
+ * dimensions in a global registry keyed by element ID. Optional debounce.
22
4
  */
23
5
  export declare class TyResizeObserver extends HTMLElement {
24
6
  private _resizeObserver;
@@ -31,18 +13,9 @@ export declare class TyResizeObserver extends HTMLElement {
31
13
  set debounce(value: number);
32
14
  constructor();
33
15
  connectedCallback(): void;
16
+ attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
34
17
  disconnectedCallback(): void;
35
- /**
36
- * Setup ResizeObserver to watch this element
37
- */
38
18
  private setupObserver;
39
- /**
40
- * Handle resize events - update registry and notify callbacks
41
- */
42
19
  private handleResize;
43
- /**
44
- * Cleanup observer and remove from registry
45
- */
46
20
  private cleanup;
47
21
  }
48
- //# sourceMappingURL=resize-observer.d.ts.map
@@ -1,108 +1,76 @@
1
- /**
2
- * TyResizeObserver Web Component
3
- *
4
- * Self-observing resize component that tracks its own dimensions
5
- * and stores them in a global registry accessible by element ID.
6
- *
7
- * @example
8
- * ```html
9
- * <ty-resize-observer id="parent-container">
10
- * <div class="child">
11
- * <!-- Child can query parent size via getSize('parent-container') -->
12
- * </div>
13
- * </ty-resize-observer>
14
- * ```
15
- *
16
- * @example With debouncing
17
- * ```html
18
- * <ty-resize-observer id="container" debounce="100">
19
- * <!-- Only updates after 100ms of no resize activity -->
20
- * </ty-resize-observer>
21
- * ```
22
- */
23
1
  import { ensureStyles } from '../utils/styles.js';
24
2
  import { resizeObserverStyles } from '../styles/resize-observer.js';
25
3
  import { updateSize, removeSize } from '../utils/resize-observer.js';
4
+ import { upgradeProperties } from '../utils/upgrade-properties.js';
26
5
  export class TyResizeObserver extends HTMLElement {
27
- static get observedAttributes() {
28
- return ['id', 'debounce'];
29
- }
30
- /**
31
- * Debounce in milliseconds (default: 0 = no debounce)
32
- */
33
- get debounce() {
34
- return parseInt(this.getAttribute('debounce') || '0');
35
- }
36
- set debounce(value) {
37
- this.setAttribute('debounce', String(value));
38
- }
39
- constructor() {
40
- super();
41
- this._resizeObserver = null;
42
- this._debounceTimer = null;
43
- // Setup shadow DOM with styles
44
- const shadow = this.attachShadow({ mode: 'open' });
45
- ensureStyles(shadow, { css: resizeObserverStyles, id: 'ty-resize-observer' });
46
- // Simple slot for content
47
- shadow.innerHTML = '<slot></slot>';
48
- }
49
- connectedCallback() {
50
- this.setupObserver();
51
- }
52
- disconnectedCallback() {
53
- this.cleanup();
54
- }
55
- /**
56
- * Setup ResizeObserver to watch this element
57
- */
58
- setupObserver() {
59
- this._resizeObserver = new ResizeObserver((entries) => {
60
- if (this.debounce > 0) {
61
- // Debounced handling
62
- if (this._debounceTimer)
63
- clearTimeout(this._debounceTimer);
64
- this._debounceTimer = window.setTimeout(() => {
65
- this.handleResize(entries);
66
- }, this.debounce);
67
- }
68
- else {
69
- // Immediate handling
70
- this.handleResize(entries);
71
- }
72
- });
73
- // Observe the custom element itself (not shadow root)
74
- this._resizeObserver.observe(this);
75
- }
76
- /**
77
- * Handle resize events - update registry and notify callbacks
78
- */
79
- handleResize(entries) {
80
- const { width, height } = entries[0].contentRect;
81
- // Only update if element has an ID
82
- if (this.id) {
83
- updateSize(this.id, width, height);
84
- }
85
- }
86
- /**
87
- * Cleanup observer and remove from registry
88
- */
89
- cleanup() {
90
- // Disconnect observer
91
- if (this._resizeObserver) {
92
- this._resizeObserver.disconnect();
93
- this._resizeObserver = null;
94
- }
95
- // Clear pending debounce timer
96
- if (this._debounceTimer) {
97
- clearTimeout(this._debounceTimer);
98
- this._debounceTimer = null;
99
- }
100
- // Remove from registry
101
- if (this.id) {
102
- removeSize(this.id);
103
- }
104
- }
105
- }
106
- // Register custom element
6
+ static get observedAttributes() {
7
+ return ['id', 'debounce'];
8
+ }
9
+ get debounce() {
10
+ return parseInt(this.getAttribute('debounce') || '0');
11
+ }
12
+ set debounce(value) {
13
+ this.setAttribute('debounce', String(value));
14
+ }
15
+ constructor() {
16
+ super();
17
+ this._resizeObserver = null;
18
+ this._debounceTimer = null;
19
+ const shadow = this.attachShadow({ mode: 'open' });
20
+ ensureStyles(shadow, { css: resizeObserverStyles, id: 'ty-resize-observer' });
21
+ shadow.innerHTML = '<slot></slot>';
22
+ }
23
+ connectedCallback() {
24
+ upgradeProperties(this);
25
+ this.setupObserver();
26
+ }
27
+ attributeChangedCallback(name, oldValue, newValue) {
28
+ if (name === 'id' && oldValue && oldValue !== newValue) {
29
+ removeSize(oldValue);
30
+ if (newValue && this.isConnected) {
31
+ const { width, height } = this.getBoundingClientRect();
32
+ updateSize(newValue, width, height);
33
+ }
34
+ }
35
+ }
36
+ disconnectedCallback() {
37
+ this.cleanup();
38
+ }
39
+ setupObserver() {
40
+ this._resizeObserver = new ResizeObserver((entries) => {
41
+ if (this.debounce > 0) {
42
+ if (this._debounceTimer)
43
+ clearTimeout(this._debounceTimer);
44
+ this._debounceTimer = window.setTimeout(() => {
45
+ this.handleResize(entries);
46
+ }, this.debounce);
47
+ }
48
+ else {
49
+ this.handleResize(entries);
50
+ }
51
+ });
52
+ this._resizeObserver.observe(this);
53
+ }
54
+ handleResize(entries) {
55
+ const { width, height } = entries[0].contentRect;
56
+ if (this.id) {
57
+ updateSize(this.id, width, height);
58
+ }
59
+ }
60
+ cleanup() {
61
+ if (this._resizeObserver) {
62
+ this._resizeObserver.disconnect();
63
+ this._resizeObserver = null;
64
+ }
65
+ if (this._debounceTimer) {
66
+ clearTimeout(this._debounceTimer);
67
+ this._debounceTimer = null;
68
+ }
69
+ if (this.id) {
70
+ removeSize(this.id);
71
+ }
72
+ }
73
+ }
74
+ if (!customElements.get('ty-resize-observer')) {
107
75
  customElements.define('ty-resize-observer', TyResizeObserver);
108
- //# sourceMappingURL=resize-observer.js.map
76
+ }
@@ -1,15 +1,6 @@
1
1
  /**
2
- * TyScrollContainer Web Component
3
- *
4
- * A scroll container with shadow indicators and an optional custom-rendered scrollbar.
5
- * Uses the CustomScrollbar utility internally.
6
- *
7
- * @example Custom scrollbar
8
- * ```html
9
- * <ty-scroll-container max-height="300px" custom-scrollbar>
10
- * <div>Long content...</div>
11
- * </ty-scroll-container>
12
- * ```
2
+ * TyScrollContainer Web Component - scroll wrapper with edge shadow indicators
3
+ * and an optional custom-rendered scrollbar (CustomScrollbar utility).
13
4
  */
14
5
  export declare class TyScrollContainer extends HTMLElement {
15
6
  private _scrollWrapper;
@@ -19,10 +10,14 @@ export declare class TyScrollContainer extends HTMLElement {
19
10
  private _shadowRight;
20
11
  private _scrollbar;
21
12
  private _resizeObserver;
13
+ private _contentObserver;
22
14
  private _rafId;
15
+ private _nearStartFired;
16
+ private _nearEndFired;
23
17
  static get observedAttributes(): string[];
24
- get shadow(): boolean;
25
- set shadow(value: boolean);
18
+ /** Edge shadows are on by default; no-shadow turns them off. */
19
+ get noShadow(): boolean;
20
+ set noShadow(value: boolean);
26
21
  get maxHeight(): string | null;
27
22
  set maxHeight(value: string | null);
28
23
  get hideScrollbar(): boolean;
@@ -31,21 +26,33 @@ export declare class TyScrollContainer extends HTMLElement {
31
26
  set customScrollbar(value: boolean);
32
27
  get overflowX(): boolean;
33
28
  set overflowX(value: boolean);
29
+ /** Distance (px) from an edge at which nearstart/nearend fire. Default 100. */
30
+ get nearEdgeThreshold(): number;
31
+ set nearEdgeThreshold(value: number | null);
32
+ /** Preserve visual position when content is added above the viewport
33
+ * (e.g. prepending older messages in a chat). Opt-in. */
34
+ get scrollAnchoring(): boolean;
35
+ set scrollAnchoring(value: boolean);
34
36
  constructor();
35
37
  connectedCallback(): void;
36
38
  disconnectedCallback(): void;
37
39
  attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
40
+ private _setupAnchoring;
41
+ private _teardownAnchoring;
38
42
  private _setupScrollbar;
39
43
  private _destroyScrollbar;
40
44
  private _updateMaxHeight;
41
45
  private _onScroll;
42
46
  private _onSlotChange;
43
47
  private _updateShadowState;
48
+ /** Edge-trigger one near-edge event; returns the new "fired" state. */
49
+ private _maybeEmitEdge;
44
50
  updateShadows(): void;
45
51
  scrollToTop(smooth?: boolean): void;
46
52
  scrollToBottom(smooth?: boolean): void;
47
53
  scrollToLeft(smooth?: boolean): void;
48
54
  scrollToRight(smooth?: boolean): void;
55
+ /** Scroll a slotted descendant (element or CSS selector) into view. */
56
+ scrollToElement(target: Element | string, smooth?: boolean): void;
49
57
  get scrollElement(): HTMLElement | null;
50
58
  }
51
- //# sourceMappingURL=scroll-container.d.ts.map