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,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-searchable → searchable: 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-searchable → searchable: 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