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,81 +1,26 @@
1
1
  /**
2
- * TyDatePicker Web Component
3
- * PORTED FROM: cljs/ty/components/date_picker.cljs
4
- *
5
- * A date picker component with read-only input and calendar dropdown.
6
- * Supports date-only and date+time modes with smart time input.
7
- *
8
- * Architecture:
9
- * - Read-only input stub (displays formatted date)
10
- * - Calendar dropdown (modal dialog with ty-calendar)
11
- * - Optional time input (with smart digit navigation)
12
- * - Form participation via ElementInternals
13
- * - UTC output, local display
14
- *
15
- * Features:
16
- * - Date selection with calendar dropdown
17
- * - Optional time input with smart navigation
18
- * - Form integration (works with FormData)
19
- * - UTC value output for server communication
20
- * - Localized display formatting (Intl API)
21
- * - Clearable with clear button
22
- * - Keyboard navigation (Escape to close)
23
- * - Outside click handling
24
- *
25
- * @example
26
- * ```html
27
- * <!-- Basic date picker -->
28
- * <ty-date-picker
29
- * label="Select Date"
30
- * placeholder="Choose a date">
31
- * </ty-date-picker>
32
- *
33
- * <!-- With time -->
34
- * <ty-date-picker
35
- * with-time="true"
36
- * label="Select Date & Time">
37
- * </ty-date-picker>
38
- *
39
- * <!-- Form integration -->
40
- * <form>
41
- * <ty-date-picker name="booking-date"></ty-date-picker>
42
- * <button type="submit">Submit</button>
43
- * </form>
44
- *
45
- * <!-- Pre-filled value (UTC) -->
46
- * <ty-date-picker value="2024-09-21T08:30:00.000Z"></ty-date-picker>
47
- * ```
2
+ * TyDatePicker Web Component — read-only input stub + calendar dropdown
3
+ * (modal <dialog>), optional time input, form participation via
4
+ * ElementInternals. Value is a UTC instant (wall-clock with `native`);
5
+ * display is local.
48
6
  */
7
+ import { type Placement } from '../utils/positioning.js';
49
8
  import { TyComponent } from '../base/ty-component.js';
9
+ import type { Flavor } from '../types/common.js';
50
10
  import type { PropertyChange } from '../utils/property-manager.js';
51
- /**
52
- * Date components (internal representation in local timezone)
53
- */
54
- interface DateComponents {
55
- year?: number;
56
- month?: number;
57
- day?: number;
58
- hour?: number;
59
- minute?: number;
60
- }
11
+ import { type DateTimeParts } from '../utils/calendar-utils.js';
61
12
  /**
62
13
  * Internal date picker state
63
14
  */
64
- interface DatePickerState extends DateComponents {
15
+ interface DatePickerState extends DateTimeParts {
65
16
  withTime: boolean;
66
17
  open: boolean;
67
18
  }
68
- /**
69
- * Date picker sizes
70
- */
71
19
  type DatePickerSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
72
20
  /**
73
21
  * Date picker flavors (visual styles)
74
22
  */
75
- type DatePickerFlavor = 'default' | 'primary' | 'secondary' | 'success' | 'danger' | 'warning';
76
- /**
77
- * Date format types
78
- */
23
+ type DatePickerFlavor = 'default' | Flavor;
79
24
  type DateFormatType = 'short' | 'medium' | 'long' | 'full';
80
25
  /**
81
26
  * Change event detail
@@ -89,10 +34,15 @@ export interface DatePickerChangeDetail {
89
34
  }
90
35
  export declare class TyDatePicker extends TyComponent<DatePickerState> {
91
36
  protected static properties: {
92
- size: {
37
+ placement: {
93
38
  type: "string";
94
39
  visual: boolean;
95
40
  default: string;
41
+ };
42
+ size: {
43
+ type: "string";
44
+ visual: boolean;
45
+ default: import("../types/common.js").Size;
96
46
  validate: (v: any) => boolean;
97
47
  coerce: (v: any) => any;
98
48
  };
@@ -116,6 +66,16 @@ export declare class TyDatePicker extends TyComponent<DatePickerState> {
116
66
  visual: boolean;
117
67
  default: string;
118
68
  };
69
+ min: {
70
+ type: "string";
71
+ visual: boolean;
72
+ default: string;
73
+ };
74
+ max: {
75
+ type: "string";
76
+ visual: boolean;
77
+ default: string;
78
+ };
119
79
  required: {
120
80
  type: "boolean";
121
81
  visual: boolean;
@@ -126,13 +86,15 @@ export declare class TyDatePicker extends TyComponent<DatePickerState> {
126
86
  visual: boolean;
127
87
  default: boolean;
128
88
  };
129
- clearable: {
89
+ noClear: {
130
90
  type: "boolean";
131
91
  visual: boolean;
132
92
  default: boolean;
133
- aliases: {
134
- 'not-clearable': boolean;
135
- };
93
+ };
94
+ error: {
95
+ type: "string";
96
+ visual: boolean;
97
+ default: string;
136
98
  };
137
99
  format: {
138
100
  type: "string";
@@ -158,41 +120,49 @@ export declare class TyDatePicker extends TyComponent<DatePickerState> {
158
120
  visual: boolean;
159
121
  default: boolean;
160
122
  };
123
+ native: {
124
+ type: "boolean";
125
+ visual: boolean;
126
+ default: boolean;
127
+ };
161
128
  };
162
129
  private _state;
163
130
  private _clickListener?;
164
131
  private _keydownListener?;
165
132
  private _dialogClickListener?;
166
133
  private _closeTimestamp;
134
+ private _initialized;
135
+ private _syncing;
167
136
  private _timeInput?;
168
137
  private _localeObserver?;
169
- /**
170
- * Form-associated custom element
171
- */
138
+ private _customFlavorSheet;
172
139
  static formAssociated: boolean;
173
140
  constructor();
174
- /**
175
- * Called when component connects to DOM
176
- * TyComponent handles property capture automatically
177
- */
141
+ /** TyComponent handles property capture automatically. */
178
142
  protected onConnect(): void;
179
- /**
180
- * Called when component disconnects from DOM
181
- */
143
+ /** Custom (non-built-in) flavors — see utils/flavor-sheet.ts. */
144
+ private _syncCustomFlavor;
182
145
  protected onDisconnect(): void;
183
- /**
184
- * Called when properties change
185
- * Handle state updates BEFORE render
186
- */
146
+ /** Handle state updates BEFORE render. */
187
147
  protected onPropertiesChanged(changes: PropertyChange[]): void;
188
148
  /**
189
- * Get form value - returns UTC string from current state
190
- * TyComponent calls this automatically when value property changes
149
+ * Get form value - the submitted string from current state (see
150
+ * componentsToOutputValue). TyComponent calls this automatically when the
151
+ * value property changes.
191
152
  */
192
153
  protected getFormValue(): FormDataEntryValue | null;
193
- /**
194
- * Extract current date components from internal state
195
- */
154
+ private outputValue;
155
+ protected updateFormValue(): void;
156
+ /** The field's focusable element: the stub, or the native input on touch devices. */
157
+ private focusTarget;
158
+ /** Focus the field: the host itself isn't focusable. Disabled: nothing, like a native input. */
159
+ focus(options?: FocusOptions): void;
160
+ /**
161
+ * `required` used to be cosmetic: nothing reported valueMissing, so an empty
162
+ * required picker never blocked its form. Disabled pickers don't validate.
163
+ * The message is a native date (datetime-local with time) input's.
164
+ */
165
+ private updateValidity;
196
166
  private getComponents;
197
167
  /**
198
168
  * Whether internal state has a complete date
@@ -204,15 +174,8 @@ export declare class TyDatePicker extends TyComponent<DatePickerState> {
204
174
  private getFormattedValue;
205
175
  /**
206
176
  * Initialize component state from attributes
207
- *
208
- * PORTED FROM: init-component-state! in date_picker.cljs
209
177
  */
210
178
  private initializeState;
211
- /**
212
- * Update internal state
213
- *
214
- * PORTED FROM: update-component-state! in date_picker.cljs
215
- */
216
179
  private updateState;
217
180
  /**
218
181
  * Sync form value with current state
@@ -220,19 +183,16 @@ export declare class TyDatePicker extends TyComponent<DatePickerState> {
220
183
  */
221
184
  private syncFormValue;
222
185
  /**
223
- * Handle time input changes from TimeInput class
224
- *
225
- * PORTED FROM: handle-time-change! in date_picker.cljs
186
+ * Handle time changes from the footer's hour/minute fields
226
187
  */
227
188
  handleTimeInputChange(hour: number, minute: number): void;
228
- /**
229
- * Emit change event
230
- *
231
- * PORTED FROM: emit-change-event! in date_picker.cljs
232
- */
189
+ /** Footer summary under the time fields: "Wed, Sep 23 · 14:30" + local ISO. */
190
+ private updateTimeSummary;
233
191
  private emitChangeEvent;
234
192
  get size(): DatePickerSize;
235
193
  set size(v: DatePickerSize);
194
+ get placement(): Placement | '';
195
+ set placement(v: Placement | '');
236
196
  get flavor(): DatePickerFlavor;
237
197
  set flavor(v: DatePickerFlavor);
238
198
  get label(): string;
@@ -249,49 +209,51 @@ export declare class TyDatePicker extends TyComponent<DatePickerState> {
249
209
  set required(v: boolean);
250
210
  get disabled(): boolean;
251
211
  set disabled(v: boolean);
252
- get clearable(): boolean;
253
- set clearable(v: boolean);
212
+ get noClear(): boolean;
213
+ set noClear(v: boolean);
214
+ get min(): string;
215
+ set min(v: string);
216
+ get max(): string;
217
+ set max(v: string);
254
218
  get withTime(): boolean;
255
219
  set withTime(v: boolean);
220
+ get native(): boolean;
221
+ set native(v: boolean);
222
+ get error(): string;
223
+ set error(v: string);
256
224
  /**
257
- * Get current value (UTC ISO string)
225
+ * Get current value — the string the form submits: a UTC ISO instant, or
226
+ * wall-clock ('YYYY-MM-DD' / 'YYYY-MM-DDTHH:mm') with `native`. null when
227
+ * empty (the form then submits name=, like a native date input).
258
228
  */
259
229
  get value(): string | null;
260
230
  /**
261
- * Set value (UTC ISO string, Date object, or null)
231
+ * Set value: any format parseDateTime() reads, a Date, epoch milliseconds,
232
+ * or null. It's normalized to the submitted form.
262
233
  *
263
234
  * When set to null/undefined/empty string, the attribute is removed.
264
- * When set to a valid date, the attribute is set to ISO UTC string.
265
235
  */
266
- set value(val: string | Date | null);
236
+ set value(val: string | number | Date | null);
267
237
  /**
268
- * Build CSS classes for the stub element
269
- *
270
- * PORTED FROM: build-stub-classes in date_picker.cljs
238
+ * Clear the date value programmatically WITH a change event (source:
239
+ * 'clear'). Works regardless of `no-clear` — lets any
240
+ * external trigger (e.g. a button elsewhere in the page) clear the value
241
+ * without needing the built-in clear button. Mirrors ty-select's clear().
271
242
  */
243
+ clear(): void;
272
244
  private buildStubClasses;
273
- /**
274
- * Render the date picker stub (input display)
275
- *
276
- * PORTED FROM: render-date-picker-stub in date_picker.cljs
277
- */
278
245
  private renderStub;
279
- /**
280
- * Create time input element
281
- *
282
- * PORTED FROM: create-time-input in date_picker.cljs
283
- */
284
- private createTimeInputElement;
285
- /**
286
- * Render time input section
287
- */
246
+ private createTimeField;
247
+ /** Footer: clock + "Time" on the left, HH : MM on the right, summary below. */
288
248
  private renderTimeSection;
249
+ private renderCalendarDropdown;
289
250
  /**
290
- * Render calendar dropdown with dialog
291
- *
292
- * PORTED FROM: render-calendar-dropdown in date_picker.cljs
251
+ * Match the popup calendar to the stub's look: danger while an error
252
+ * shows, as on the stub (styles: errorLook), else the user's flavor.
253
+ * 'default' is the stub's own unstyled state, not a real flavor: the
254
+ * calendar stays on its own default.
293
255
  */
294
- private renderCalendarDropdown;
256
+ private calendarFlavor;
295
257
  /**
296
258
  * Render native date input for mobile touch devices.
297
259
  * Uses <input type="date"> or <input type="datetime-local"> when with-time.
@@ -299,32 +261,23 @@ export declare class TyDatePicker extends TyComponent<DatePickerState> {
299
261
  */
300
262
  private renderNativeInput;
301
263
  /**
302
- * Calculate calendar position
303
- *
304
- * PORTED FROM: calculate-calendar-position! in date_picker.cljs
264
+ * The touch devices' native input follows the picker: type (date, or
265
+ * datetime-local with time), disabled, required, min/max (datetime-local
266
+ * wants a time suffix) and value — also when they change at runtime.
305
267
  */
268
+ private syncNativeInput;
306
269
  private calculateCalendarPosition;
307
- /**
308
- * Render container structure
309
- *
310
- * PORTED FROM: render-container-structure in date_picker.cljs
311
- */
312
270
  private renderContainer;
271
+ protected render(): void;
313
272
  /**
314
- * Main render method
315
- *
316
- * PORTED FROM: render! in date_picker.cljs
273
+ * The `error` line under the field — same markup as ty-input's; the field
274
+ * (stub, or the native input on touch devices) is described by it.
317
275
  */
318
- protected render(): void;
276
+ private syncErrorLine;
319
277
  /**
320
278
  * Update display without destroying DOM (for open dialog)
321
- *
322
- * PORTED FROM: update-display! in date_picker.cljs
323
279
  */
324
280
  private updateDisplay;
325
- /**
326
- * Setup document-level event listeners
327
- */
328
281
  private setupEventListeners;
329
282
  private handleStubClick;
330
283
  /**
@@ -332,48 +285,12 @@ export declare class TyDatePicker extends TyComponent<DatePickerState> {
332
285
  */
333
286
  private clearValue;
334
287
  private handleClearClick;
335
- /**
336
- * Handle calendar date selection
337
- *
338
- * PORTED FROM: handle-calendar-change! in date_picker.cljs
339
- */
340
288
  private handleCalendarChange;
341
- /**
342
- * Handle dialog backdrop clicks
343
- *
344
- * PORTED FROM: handle-dialog-click! in date_picker.cljs
345
- */
346
289
  private handleDialogClick;
347
- /**
348
- * Handle clicks outside the date picker
349
- *
350
- * PORTED FROM: handle-outside-click! in date_picker.cljs
351
- */
352
290
  private handleOutsideClick;
353
- /**
354
- * Handle Escape key press
355
- *
356
- * PORTED FROM: handle-escape-key! in date_picker.cljs
357
- */
358
291
  private handleEscapeKey;
359
- /**
360
- * Open calendar dropdown
361
- *
362
- * PORTED FROM: open-dropdown! in date_picker.cljs
363
- */
364
292
  private openDropdown;
365
- /**
366
- * Close calendar dropdown
367
- *
368
- * PORTED FROM: close-dropdown! in date_picker.cljs
369
- */
370
293
  private closeDropdown;
371
- /**
372
- * Clean up event listeners and state
373
- *
374
- * PORTED FROM: cleanup! in date_picker.cljs
375
- */
376
294
  private cleanup;
377
295
  }
378
296
  export {};
379
- //# sourceMappingURL=date-picker.d.ts.map