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,152 +1,44 @@
1
- /**
2
- * Property Capture Utility
3
- *
4
- * Solves the problem of frameworks (React, Reagent, etc.) setting properties
5
- * on custom elements BEFORE connectedCallback runs.
6
- *
7
- * PROBLEM:
8
- * 1. Framework creates element: document.createElement('ty-dropdown')
9
- * 2. Framework sets properties: element.value = "foo"
10
- * 3. Constructor runs and defines getters/setters
11
- * 4. BUT properties were already set, creating instance properties
12
- * 5. Instance properties shadow the class getters/setters
13
- * 6. connectedCallback runs - too late!
14
- *
15
- * SOLUTION:
16
- * In connectedCallback, capture any pre-set properties and apply them properly.
17
- *
18
- * @example
19
- * ```typescript
20
- * connectedCallback(): void {
21
- * const preSetProps = capturePreSetProperties(this, [
22
- * 'value', 'clearable', 'disabled'
23
- * ])
24
- *
25
- * if (preSetProps.value !== undefined) {
26
- * this._value = preSetProps.value
27
- * }
28
- * }
29
- * ```
30
- */
31
- /**
32
- * Capture properties that were set before connectedCallback
33
- *
34
- * @param element - The custom element instance
35
- * @param propertyNames - Array of property names to check
36
- * @param options - Capture options
37
- * @returns Record of captured properties with metadata
38
- *
39
- * @example
40
- * ```typescript
41
- * const captured = capturePreSetProperties(this, ['value', 'disabled'])
42
- * // {
43
- * // value: { name: 'value', value: 'foo', hadProperty: true },
44
- * // disabled: { name: 'disabled', value: undefined, hadProperty: false }
45
- * // }
46
- * ```
47
- */
48
1
  export function capturePreSetProperties(element, propertyNames, options = { cleanup: true }) {
49
- const captured = {};
50
- for (const name of propertyNames) {
51
- const descriptor = Object.getOwnPropertyDescriptor(element, name);
52
- captured[name] = {
53
- name,
54
- value: descriptor?.value,
55
- hadProperty: descriptor !== undefined && descriptor.value !== undefined
56
- };
57
- // Clean up instance property so class getter/setter works
58
- if (options.cleanup && captured[name].hadProperty) {
59
- delete element[name];
60
- }
61
- }
62
- return captured;
2
+ const captured = {};
3
+ for (const name of propertyNames) {
4
+ const descriptor = Object.getOwnPropertyDescriptor(element, name);
5
+ captured[name] = {
6
+ name,
7
+ value: descriptor?.value,
8
+ hadProperty: descriptor !== undefined && descriptor.value !== undefined
9
+ };
10
+ if (options.cleanup && captured[name].hadProperty) {
11
+ delete element[name];
12
+ }
13
+ }
14
+ return captured;
63
15
  }
64
- /**
65
- * Simpler API - just get the values that were pre-set
66
- *
67
- * @param element - The custom element instance
68
- * @param propertyNames - Array of property names to check
69
- * @param options - Capture options
70
- * @returns Record of property names to values (only includes properties that were set)
71
- *
72
- * @example
73
- * ```typescript
74
- * const values = getCapturedValues(this, ['value', 'disabled'])
75
- * if (values.value !== undefined) {
76
- * this._value = values.value
77
- * }
78
- * ```
79
- */
80
16
  export function getCapturedValues(element, propertyNames, options) {
81
- const captured = capturePreSetProperties(element, propertyNames, options);
82
- const values = {};
83
- for (const [name, data] of Object.entries(captured)) {
84
- if (data.hadProperty) {
85
- values[name] = data.value;
86
- }
87
- }
88
- return values;
17
+ const captured = capturePreSetProperties(element, propertyNames, options);
18
+ const values = {};
19
+ for (const [name, data] of Object.entries(captured)) {
20
+ if (data.hadProperty) {
21
+ values[name] = data.value;
22
+ }
23
+ }
24
+ return values;
89
25
  }
90
- /**
91
- * Automatically apply pre-set properties to private fields
92
- *
93
- * @param element - The custom element instance
94
- * @param propertyNames - Array of property names to check
95
- * @param propertyMap - Optional mapping of public names to private field names
96
- * Default: adds underscore prefix (e.g., 'value' -> '_value')
97
- * @param options - Capture options
98
- *
99
- * @example
100
- * ```typescript
101
- * // Simple usage (uses _propertyName convention)
102
- * applyPreSetProperties(this, ['value', 'disabled'])
103
- * // Sets this._value and this._disabled
104
- *
105
- * // Custom mapping
106
- * applyPreSetProperties(this, ['value'], { value: 'internalValue' })
107
- * // Sets this.internalValue
108
- * ```
109
- */
110
26
  export function applyPreSetProperties(element, propertyNames, propertyMap, options) {
111
- const captured = capturePreSetProperties(element, propertyNames, options);
112
- for (const [name, data] of Object.entries(captured)) {
113
- if (data.hadProperty) {
114
- // Determine the private field name
115
- const privateName = propertyMap?.[name] || `_${name}`;
116
- element[privateName] = data.value;
117
- }
118
- }
27
+ const captured = capturePreSetProperties(element, propertyNames, options);
28
+ for (const [name, data] of Object.entries(captured)) {
29
+ if (data.hadProperty) {
30
+ const privateName = propertyMap?.[name] || `_${name}`;
31
+ element[privateName] = data.value;
32
+ }
33
+ }
119
34
  }
120
- /**
121
- * Helper for components with standard _propertyName pattern
122
- *
123
- * @param element - The custom element instance
124
- * @param propertyNames - Array of property names to check
125
- * @param transformer - Optional function to transform values before setting
126
- * @param options - Capture options
127
- *
128
- * @example
129
- * ```typescript
130
- * connectedCallback(): void {
131
- * // Basic usage
132
- * captureAndApplyProperties(this, ['value', 'disabled', 'required'])
133
- *
134
- * // With transformation
135
- * captureAndApplyProperties(this, ['value'], (name, value) => {
136
- * if (name === 'value') return this.parseValue(value)
137
- * return value
138
- * })
139
- * }
140
- * ```
141
- */
142
35
  export function captureAndApplyProperties(element, propertyNames, transformer, options) {
143
- const captured = capturePreSetProperties(element, propertyNames, options);
144
- for (const [name, data] of Object.entries(captured)) {
145
- if (data.hadProperty) {
146
- const privateName = `_${name}`;
147
- const value = transformer ? transformer(name, data.value) : data.value;
148
- element[privateName] = value;
149
- }
150
- }
36
+ const captured = capturePreSetProperties(element, propertyNames, options);
37
+ for (const [name, data] of Object.entries(captured)) {
38
+ if (data.hadProperty) {
39
+ const privateName = `_${name}`;
40
+ const value = transformer ? transformer(name, data.value) : data.value;
41
+ element[privateName] = value;
42
+ }
43
+ }
151
44
  }
152
- //# sourceMappingURL=property-capture.js.map
@@ -15,7 +15,6 @@ export interface PropertyConfig {
15
15
  default?: any;
16
16
  validate?: (value: any) => boolean;
17
17
  coerce?: (value: any) => any;
18
- aliases?: Record<string, any>;
19
18
  }
20
19
  /**
21
20
  * Represents a property change
@@ -29,6 +28,12 @@ export interface PropertyChange {
29
28
  /**
30
29
  * Manages component properties with unified lifecycle
31
30
  */
31
+ /**
32
+ * Boolean coercion for a property set from JS, HTML-style: '' (what React 19
33
+ * and Vue hand a property for a bare attribute) is true; false, null,
34
+ * undefined, 0, 'false' and '0' are false.
35
+ */
36
+ export declare function coerceBoolean(value: unknown): boolean;
32
37
  export declare class PropertyManager<T = any> {
33
38
  private _props;
34
39
  private _config;
@@ -82,9 +87,4 @@ export declare class PropertyManager<T = any> {
82
87
  * Check if a property should emit change events
83
88
  */
84
89
  shouldEmitChange(name: string): boolean;
85
- /**
86
- * Handle property aliases (e.g., not-clearable → clearable: false)
87
- */
88
- handleAlias(aliasName: string, value: any): PropertyChange | null;
89
90
  }
90
- //# sourceMappingURL=property-manager.d.ts.map
@@ -1,197 +1,128 @@
1
- /**
2
- * Property Manager - Unified property lifecycle for web components
3
- *
4
- * Handles property/attribute synchronization, validation, coercion, and change tracking.
5
- * All property updates flow through a single code path for consistency.
6
- */
7
- /**
8
- * Manages component properties with unified lifecycle
9
- */
1
+ export function coerceBoolean(value) {
2
+ if (typeof value === 'string') {
3
+ const normalized = value.toLowerCase().trim();
4
+ return normalized !== 'false' && normalized !== '0';
5
+ }
6
+ return Boolean(value);
7
+ }
8
+ function defaultOf(config) {
9
+ return typeof config.default === 'function' ? config.default() : config.default;
10
+ }
10
11
  export class PropertyManager {
11
- constructor(config) {
12
- this._props = new Map();
13
- this._config = config;
14
- this._initializeDefaults();
15
- }
16
- /**
17
- * Initialize properties with default values
18
- */
19
- _initializeDefaults() {
20
- for (const [name, config] of Object.entries(this._config)) {
21
- if (config.default !== undefined) {
22
- this._props.set(name, config.default);
23
- }
24
- }
25
- }
26
- /**
27
- * Check if a property name exists in the configuration
28
- */
29
- hasConfig(name) {
30
- return name in this._config;
31
- }
32
- /**
33
- * Update a property value
34
- * Returns PropertyChange if value changed, null otherwise
35
- */
36
- updateProperty(name, value, source = 'property') {
37
- const config = this._config[name];
38
- if (!config) {
39
- console.warn(`[PropertyManager] Unknown property: ${name}`);
40
- return null;
41
- }
42
- // Get old value
43
- const oldValue = this._props.get(name);
44
- // Coerce value to correct type
45
- const coercedValue = this._coerceValue(name, value, config);
46
- // Validate value
47
- if (!this._validateValue(name, coercedValue, config)) {
48
- console.warn(`[PropertyManager] Invalid value for ${name}:`, coercedValue);
49
- return null;
50
- }
51
- // Check if value actually changed
52
- if (this._valuesEqual(oldValue, coercedValue)) {
53
- return null;
54
- }
55
- // Update internal map
56
- this._props.set(name, coercedValue);
57
- // Create change object
58
- const change = {
59
- name,
60
- oldValue,
61
- newValue: coercedValue,
62
- source
63
- };
64
- return change;
65
- }
66
- /**
67
- * Coerce value to the correct type
68
- */
69
- _coerceValue(name, value, config) {
70
- // Custom coercion
71
- if (config.coerce) {
72
- return config.coerce(value);
73
- }
74
- // Null/undefined handling
75
- if (value === null || value === undefined) {
76
- return config.default ?? null;
77
- }
78
- // Type coercion
79
- switch (config.type) {
80
- case 'boolean':
81
- // HTML Standard: attribute present (even empty) = true, absent = false
82
- // String handling:
83
- if (typeof value === 'string') {
84
- // Empty string = true (HTML boolean attribute: <input checked>)
85
- if (value === '')
86
- return true;
87
- // Explicit false values
88
- const normalized = value.toLowerCase().trim();
89
- if (normalized === 'false' || normalized === '0')
90
- return false;
91
- // Everything else is truthy
92
- return true;
93
- }
94
- // Non-string: standard truthy/falsy
95
- return Boolean(value);
96
- case 'number':
97
- const num = Number(value);
98
- return isNaN(num) ? (config.default ?? 0) : num;
99
- case 'string':
100
- return String(value);
101
- case 'object':
102
- case 'array':
103
- if (typeof value === 'string') {
104
- try {
105
- return JSON.parse(value);
106
- }
107
- catch {
108
- console.warn(`[PropertyManager] Failed to parse ${name}:`, value);
109
- return config.default ?? (config.type === 'array' ? [] : {});
110
- }
111
- }
112
- return value;
113
- default:
114
- return value;
115
- }
116
- }
117
- /**
118
- * Validate a property value
119
- */
120
- _validateValue(name, value, config) {
121
- if (config.validate) {
122
- return config.validate(value);
123
- }
124
- return true;
125
- }
126
- /**
127
- * Check if two values are equal
128
- */
129
- _valuesEqual(a, b) {
130
- // Simple equality for primitives
131
- if (typeof a !== 'object' || typeof b !== 'object') {
132
- return a === b;
133
- }
134
- // Null checks
135
- if (a === null || b === null) {
136
- return a === b;
137
- }
138
- // Deep equality for objects/arrays (simple implementation)
139
- // For production, consider using a proper deep equality library
140
- try {
141
- return JSON.stringify(a) === JSON.stringify(b);
142
- }
143
- catch {
144
- return false;
145
- }
146
- }
147
- /**
148
- * Get a property value
149
- */
150
- get(name) {
151
- return this._props.get(name);
152
- }
153
- /**
154
- * Get all properties as an object
155
- */
156
- getAll() {
157
- return Object.fromEntries(this._props);
158
- }
159
- /**
160
- * Get property configuration
161
- */
162
- getConfig(name) {
163
- return this._config[name];
164
- }
165
- /**
166
- * Check if a property is visual (requires render)
167
- */
168
- isVisual(name) {
169
- return this._config[name]?.visual ?? false;
170
- }
171
- /**
172
- * Check if a property affects form value
173
- */
174
- isFormValue(name) {
175
- return this._config[name]?.formValue ?? false;
176
- }
177
- /**
178
- * Check if a property should emit change events
179
- */
180
- shouldEmitChange(name) {
181
- return this._config[name]?.emitChange ?? false;
182
- }
183
- /**
184
- * Handle property aliases (e.g., not-clearable → clearable: false)
185
- */
186
- handleAlias(aliasName, value) {
187
- // Find property with this alias
188
- for (const [propName, config] of Object.entries(this._config)) {
189
- if (config.aliases && aliasName in config.aliases) {
190
- const aliasedValue = config.aliases[aliasName];
191
- return this.updateProperty(propName, aliasedValue, 'attribute');
192
- }
193
- }
194
- return null;
195
- }
196
- }
197
- //# sourceMappingURL=property-manager.js.map
12
+ constructor(config) {
13
+ this._props = new Map();
14
+ this._config = config;
15
+ this._initializeDefaults();
16
+ }
17
+ _initializeDefaults() {
18
+ for (const [name, config] of Object.entries(this._config)) {
19
+ if (config.default !== undefined) {
20
+ this._props.set(name, defaultOf(config));
21
+ }
22
+ }
23
+ }
24
+ hasConfig(name) {
25
+ return name in this._config;
26
+ }
27
+ updateProperty(name, value, source = 'property') {
28
+ const config = this._config[name];
29
+ if (!config) {
30
+ console.warn(`[PropertyManager] Unknown property: ${name}`);
31
+ return null;
32
+ }
33
+ const oldValue = this._props.get(name);
34
+ const coercedValue = this._coerceValue(name, value, config);
35
+ if (!this._validateValue(name, coercedValue, config)) {
36
+ console.warn(`[PropertyManager] Invalid value for ${name}:`, coercedValue);
37
+ return null;
38
+ }
39
+ if (this._valuesEqual(oldValue, coercedValue)) {
40
+ return null;
41
+ }
42
+ this._props.set(name, coercedValue);
43
+ const change = {
44
+ name,
45
+ oldValue,
46
+ newValue: coercedValue,
47
+ source
48
+ };
49
+ return change;
50
+ }
51
+ _coerceValue(name, value, config) {
52
+ if (config.coerce) {
53
+ return config.coerce(value);
54
+ }
55
+ if (value === null || value === undefined) {
56
+ return defaultOf(config) ?? null;
57
+ }
58
+ switch (config.type) {
59
+ case 'boolean':
60
+ if (typeof value === 'string') {
61
+ if (value === '')
62
+ return true;
63
+ const normalized = value.toLowerCase().trim();
64
+ if (normalized === 'false' || normalized === '0')
65
+ return false;
66
+ return true;
67
+ }
68
+ return Boolean(value);
69
+ case 'number':
70
+ const num = Number(value);
71
+ return isNaN(num) ? (defaultOf(config) ?? 0) : num;
72
+ case 'string':
73
+ return String(value);
74
+ case 'object':
75
+ case 'array':
76
+ if (typeof value === 'string') {
77
+ try {
78
+ return JSON.parse(value);
79
+ }
80
+ catch {
81
+ console.warn(`[PropertyManager] Failed to parse ${name}:`, value);
82
+ return defaultOf(config) ?? (config.type === 'array' ? [] : {});
83
+ }
84
+ }
85
+ return value;
86
+ default:
87
+ return value;
88
+ }
89
+ }
90
+ _validateValue(name, value, config) {
91
+ if (config.validate) {
92
+ return config.validate(value);
93
+ }
94
+ return true;
95
+ }
96
+ _valuesEqual(a, b) {
97
+ if (typeof a !== 'object' || typeof b !== 'object') {
98
+ return a === b;
99
+ }
100
+ if (a === null || b === null) {
101
+ return a === b;
102
+ }
103
+ try {
104
+ return JSON.stringify(a) === JSON.stringify(b);
105
+ }
106
+ catch {
107
+ return false;
108
+ }
109
+ }
110
+ get(name) {
111
+ return this._props.get(name);
112
+ }
113
+ getAll() {
114
+ return Object.fromEntries(this._props);
115
+ }
116
+ getConfig(name) {
117
+ return this._config[name];
118
+ }
119
+ isVisual(name) {
120
+ return this._config[name]?.visual ?? false;
121
+ }
122
+ isFormValue(name) {
123
+ return this._config[name]?.formValue ?? false;
124
+ }
125
+ shouldEmitChange(name) {
126
+ return this._config[name]?.emitChange ?? false;
127
+ }
128
+ }
@@ -39,4 +39,3 @@ export declare function updateSize(id: string, width: number, height: number): v
39
39
  * Internal: Remove size from registry and cleanup callbacks
40
40
  */
41
41
  export declare function removeSize(id: string): void;
42
- //# sourceMappingURL=resize-observer.d.ts.map
@@ -1,71 +1,35 @@
1
- /**
2
- * Resize Observer Registry & Callbacks
3
- *
4
- * Provides global registry for element sizes and optional callback subscriptions.
5
- */
6
- // Global registry (Map-based storage)
7
1
  const sizes = new Map();
8
2
  const callbacks = new Map();
9
- /**
10
- * Get current size for element by ID (sync query)
11
- *
12
- * @example
13
- * const size = getSize('parent-container')
14
- * if (size) console.log(`Width: ${size.width}px`)
15
- */
16
3
  export function getSize(id) {
17
- return sizes.get(id);
4
+ return sizes.get(id);
18
5
  }
19
- /**
20
- * Subscribe to size changes for element by ID
21
- * Returns unsubscribe function
22
- *
23
- * @example
24
- * const unsubscribe = onResize('parent', ({ width, height }) => {
25
- * console.log(`Resized to ${width}x${height}`)
26
- * })
27
- * // Later: unsubscribe()
28
- */
29
6
  export function onResize(id, callback) {
30
- if (!callbacks.has(id)) {
31
- callbacks.set(id, new Set());
32
- }
33
- callbacks.get(id).add(callback);
34
- // Call immediately with current size if available
35
- const current = sizes.get(id);
36
- if (current)
37
- callback(current);
38
- // Return unsubscribe function
39
- return () => {
40
- callbacks.get(id)?.delete(callback);
41
- if (callbacks.get(id)?.size === 0) {
42
- callbacks.delete(id);
43
- }
44
- };
7
+ if (!callbacks.has(id)) {
8
+ callbacks.set(id, new Set());
9
+ }
10
+ callbacks.get(id).add(callback);
11
+ const current = sizes.get(id);
12
+ if (current)
13
+ callback(current);
14
+ return () => {
15
+ callbacks.get(id)?.delete(callback);
16
+ if (callbacks.get(id)?.size === 0) {
17
+ callbacks.delete(id);
18
+ }
19
+ };
45
20
  }
46
- /**
47
- * Get all registered sizes (for debugging/window API)
48
- */
49
21
  export function getAllSizes() {
50
- return Object.fromEntries(sizes);
22
+ return Object.fromEntries(sizes);
51
23
  }
52
- /**
53
- * Internal: Update size in registry and notify callbacks
54
- */
55
24
  export function updateSize(id, width, height) {
56
- sizes.set(id, { width, height });
57
- // Notify all subscribers
58
- const cbs = callbacks.get(id);
59
- if (cbs) {
60
- const size = { width, height };
61
- cbs.forEach(cb => cb(size));
62
- }
25
+ sizes.set(id, { width, height });
26
+ const cbs = callbacks.get(id);
27
+ if (cbs) {
28
+ const size = { width, height };
29
+ cbs.forEach(cb => cb(size));
30
+ }
63
31
  }
64
- /**
65
- * Internal: Remove size from registry and cleanup callbacks
66
- */
67
32
  export function removeSize(id) {
68
- sizes.delete(id);
69
- callbacks.delete(id);
33
+ sizes.delete(id);
34
+ callbacks.delete(id);
70
35
  }
71
- //# sourceMappingURL=resize-observer.js.map