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,370 +1,185 @@
1
- /**
2
- * Calendar Utilities
3
- *
4
- * Pure TypeScript utilities for calendar month generation and localization.
5
- * Ported from ClojureScript ty/date/core.cljs
6
- *
7
- * Key Features:
8
- * - 42-day calendar grid generation (6 weeks × 7 days)
9
- * - Monday-first week ordering
10
- * - Rich day context with metadata
11
- * - Localized weekday names
12
- * - No external dependencies (native Date API only)
13
- *
14
- * Note on Timestamps:
15
- * - `value`: UTC timestamp at midnight UTC (timezone-independent, use for storage/server)
16
- * - `localValue`: Local timestamp at midnight local time (use for display/local calculations)
17
- * - `year/month/dayInMonth`: Calendar date components (user's mental model)
18
- *
19
- * Example for October 13, 2025:
20
- * - value = Date.UTC(2025, 9, 13) = consistent worldwide
21
- * - localValue = new Date(2025, 9, 13).getTime() = varies by timezone
22
- * - Both represent the same calendar date, different moments in time
23
- */
24
- // ============================================================================
25
- // Validation Functions
26
- // ============================================================================
27
- /**
28
- * Validate month value (1-12)
29
- */
30
1
  function validateMonth(month) {
31
- if (!Number.isInteger(month) || month < 1 || month > 12) {
32
- throw new RangeError(`Invalid month: ${month}. Must be an integer between 1 and 12.`);
33
- }
2
+ if (!Number.isInteger(month) || month < 1 || month > 12) {
3
+ throw new RangeError(`Invalid month: ${month}. Must be an integer between 1 and 12.`);
4
+ }
34
5
  }
35
- /**
36
- * Validate year value (reasonable range)
37
- */
38
6
  function validateYear(year) {
39
- if (!Number.isInteger(year) || year < 1 || year > 9999) {
40
- throw new RangeError(`Invalid year: ${year}. Must be an integer between 1 and 9999.`);
41
- }
7
+ if (!Number.isInteger(year) || year < 1 || year > 9999) {
8
+ throw new RangeError(`Invalid year: ${year}. Must be an integer between 1 and 9999.`);
9
+ }
42
10
  }
43
- // ============================================================================
44
- // Helper Functions
45
- // ============================================================================
46
- /**
47
- * Check if two dates are on the same day (ignoring time)
48
- * Works in local timezone
49
- */
50
11
  function isSameDay(date1, date2) {
51
- return date1.getFullYear() === date2.getFullYear()
52
- && date1.getMonth() === date2.getMonth()
53
- && date1.getDate() === date2.getDate();
12
+ return date1.getFullYear() === date2.getFullYear()
13
+ && date1.getMonth() === date2.getMonth()
14
+ && date1.getDate() === date2.getDate();
54
15
  }
55
- /**
56
- * Create a date at midnight local time
57
- * This ensures consistent behavior across the application
58
- */
59
- function createMidnightDate(year, month, day) {
60
- return new Date(year, month - 1, day, 0, 0, 0, 0);
16
+ export function localMidnight(year, month, day) {
17
+ const date = new Date(2000, 0, 1, 12);
18
+ date.setFullYear(year, month - 1, day);
19
+ date.setHours(0, 0, 0, 0);
20
+ return date;
21
+ }
22
+ export function utcMidnight(year, month, day) {
23
+ const date = new Date(0);
24
+ date.setUTCFullYear(year, month - 1, day);
25
+ return date.getTime();
61
26
  }
62
- /**
63
- * Get today's date at midnight local time
64
- * Used for consistent "today" detection
65
- */
66
27
  function getTodayMidnight() {
67
- const now = new Date();
68
- return new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 0, 0);
28
+ const now = new Date();
29
+ return new Date(now.getFullYear(), now.getMonth(), now.getDate(), 0, 0, 0, 0);
69
30
  }
70
- /**
71
- * Create a DayContext from a Date object
72
- *
73
- * @param date - The date to create context for (should be at midnight)
74
- * @param targetYear - The year of the calendar month being displayed
75
- * @param targetMonth - The month (1-12) of the calendar month being displayed
76
- * @param selection - Optional selection state from calendar
77
- * @returns Rich day context with metadata
78
- */
79
31
  function createDayContext(date, targetYear, targetMonth, selection) {
80
- const year = date.getFullYear();
81
- const month = date.getMonth() + 1; // Convert to 1-based
82
- const dayInMonth = date.getDate();
83
- const dayOfWeek = date.getDay(); // 0 = Sunday, 6 = Saturday
84
- // Check if this day is from a different month
85
- const isOtherMonth = year !== targetYear || month !== targetMonth;
86
- // Determine if previous or next month
87
- let isPrevMonth = false;
88
- let isNextMonth = false;
89
- if (isOtherMonth) {
90
- if (year < targetYear || (year === targetYear && month < targetMonth)) {
91
- isPrevMonth = true;
92
- }
93
- else {
94
- isNextMonth = true;
95
- }
96
- }
97
- // Check if today (compare dates at midnight for consistency)
98
- const todayMidnight = getTodayMidnight();
99
- const isToday = isSameDay(date, todayMidnight);
100
- // Check if this day is selected
101
- const isSelected = selection?.year === year
102
- && selection?.month === month
103
- && selection?.day === dayInMonth;
104
- // Calculate both UTC and local timestamps
105
- // value: UTC midnight (consistent worldwide for the same date)
106
- // localValue: Local midnight (respects user's timezone)
107
- const utcValue = Date.UTC(year, month - 1, dayInMonth, 0, 0, 0, 0);
108
- const localValue = date.getTime();
109
- return {
110
- value: utcValue,
111
- localValue,
112
- year,
113
- month,
114
- dayInMonth,
115
- weekend: dayOfWeek === 0 || dayOfWeek === 6,
116
- otherMonth: isOtherMonth,
117
- prevMonth: isPrevMonth,
118
- nextMonth: isNextMonth,
119
- today: isToday,
120
- isSelected,
121
- selectedYear: selection?.year,
122
- selectedMonth: selection?.month,
123
- selectedDay: selection?.day,
124
- };
32
+ const year = date.getFullYear();
33
+ const month = date.getMonth() + 1;
34
+ const dayInMonth = date.getDate();
35
+ const dayOfWeek = date.getDay();
36
+ const isOtherMonth = year !== targetYear || month !== targetMonth;
37
+ let isPrevMonth = false;
38
+ let isNextMonth = false;
39
+ if (isOtherMonth) {
40
+ if (year < targetYear || (year === targetYear && month < targetMonth)) {
41
+ isPrevMonth = true;
42
+ }
43
+ else {
44
+ isNextMonth = true;
45
+ }
46
+ }
47
+ const todayMidnight = getTodayMidnight();
48
+ const isToday = isSameDay(date, todayMidnight);
49
+ const isSelected = selection?.year === year
50
+ && selection?.month === month
51
+ && selection?.day === dayInMonth;
52
+ const utcValue = utcMidnight(year, month, dayInMonth);
53
+ const localValue = date.getTime();
54
+ return {
55
+ value: utcValue,
56
+ localValue,
57
+ year,
58
+ month,
59
+ dayInMonth,
60
+ weekend: dayOfWeek === 0 || dayOfWeek === 6,
61
+ otherMonth: isOtherMonth,
62
+ prevMonth: isPrevMonth,
63
+ nextMonth: isNextMonth,
64
+ today: isToday,
65
+ isSelected,
66
+ selectedYear: selection?.year,
67
+ selectedMonth: selection?.month,
68
+ selectedDay: selection?.day,
69
+ };
125
70
  }
126
- /**
127
- * Get the Monday at or before a given date
128
- * (Monday = start of week in ISO 8601)
129
- *
130
- * @param date - Any date
131
- * @returns The Monday of that week at midnight
132
- */
133
71
  function getMondayOfWeek(date) {
134
- const dayOfWeek = date.getDay(); // 0 = Sunday, 1 = Monday, etc.
135
- // Calculate days to subtract to get to Monday
136
- // Sunday (0) → go back 6 days
137
- // Monday (1) → go back 0 days
138
- // Tuesday (2) → go back 1 day
139
- // ...
140
- const daysToMonday = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
141
- // Create new date at Monday midnight
142
- const monday = new Date(date);
143
- monday.setDate(date.getDate() - daysToMonday);
144
- monday.setHours(0, 0, 0, 0); // Ensure midnight
145
- return monday;
72
+ const dayOfWeek = date.getDay();
73
+ const daysToMonday = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
74
+ const monday = new Date(date);
75
+ monday.setDate(date.getDate() - daysToMonday);
76
+ monday.setHours(0, 0, 0, 0);
77
+ return monday;
146
78
  }
147
- /**
148
- * Get the start date for the calendar grid
149
- * (The Monday at or before the first day of the month)
150
- *
151
- * @param year - Year
152
- * @param month - Month (1-12)
153
- * @returns The Monday that starts the calendar grid
154
- */
155
79
  function getMonthGridStart(year, month) {
156
- // Get first day of month at midnight (month is 1-based, Date constructor is 0-based)
157
- const firstDay = createMidnightDate(year, month, 1);
158
- // Get the Monday of that week
159
- return getMondayOfWeek(firstDay);
80
+ const firstDay = localMidnight(year, month, 1);
81
+ return getMondayOfWeek(firstDay);
160
82
  }
161
- /**
162
- * Add days to a date safely
163
- * Creates a new date without mutating the original
164
- *
165
- * @param date - Starting date
166
- * @param days - Number of days to add
167
- * @returns New date with days added
168
- */
169
83
  function addDays(date, days) {
170
- const result = new Date(date);
171
- result.setDate(result.getDate() + days);
172
- return result;
84
+ const result = new Date(date);
85
+ result.setDate(result.getDate() + days);
86
+ return result;
173
87
  }
174
- /**
175
- * Generate N consecutive days starting from a date
176
- *
177
- * @param startDate - Starting date
178
- * @param count - Number of days to generate
179
- * @param targetYear - Year of the calendar month
180
- * @param targetMonth - Month (1-12) of the calendar month
181
- * @param selection - Optional selection state to include in day contexts
182
- * @returns Array of day contexts
183
- */
184
88
  function generateDays(startDate, count, targetYear, targetMonth, selection) {
185
- const days = [];
186
- for (let i = 0; i < count; i++) {
187
- const date = addDays(startDate, i);
188
- days.push(createDayContext(date, targetYear, targetMonth, selection));
189
- }
190
- return days;
89
+ const days = [];
90
+ for (let i = 0; i < count; i++) {
91
+ const date = addDays(startDate, i);
92
+ days.push(createDayContext(date, targetYear, targetMonth, selection));
93
+ }
94
+ return days;
191
95
  }
192
- // ============================================================================
193
- // Main Calendar Functions
194
- // ============================================================================
195
- /**
196
- * Generate a 42-day calendar grid for a given month
197
- *
198
- * Returns 6 weeks (42 days) starting from the Monday at or before
199
- * the first day of the month. This ensures a complete calendar view
200
- * with days from the previous and next months as needed.
201
- *
202
- * @param year - Year (e.g., 2025)
203
- * @param month - Month (1-12, 1 = January)
204
- * @param selection - Optional selection state to include in day contexts
205
- * @returns Array of 42 day contexts with rich metadata
206
- *
207
- * @throws {RangeError} If year or month are invalid
208
- *
209
- * @example
210
- * const days = getCalendarMonthDays(2025, 10); // October 2025
211
- * console.log(days.length); // 42
212
- * console.log(days[0].dayInMonth); // First day shown (might be from September)
213
- */
214
96
  export function getCalendarMonthDays(year, month, selection) {
215
- // Validate inputs
216
- validateYear(year);
217
- validateMonth(month);
218
- const startDate = getMonthGridStart(year, month);
219
- return generateDays(startDate, 42, year, month, selection);
97
+ validateYear(year);
98
+ validateMonth(month);
99
+ const startDate = getMonthGridStart(year, month);
100
+ return generateDays(startDate, 42, year, month, selection);
220
101
  }
221
- /**
222
- * Get localized weekday names in Monday-first order
223
- *
224
- * Note: Intl.DateTimeFormat returns Sunday-first by default,
225
- * so we reorder to Monday-first: [Mon, Tue, Wed, Thu, Fri, Sat, Sun]
226
- *
227
- * @param locale - Locale string (e.g., "en-US", "de-DE", "ja-JP")
228
- * @param style - Display style: "long" (Monday), "short" (Mon), "narrow" (M)
229
- * @returns Array of 7 weekday names starting with Monday
230
- *
231
- * @example
232
- * getLocalizedWeekdays("en-US", "short")
233
- * // Returns: ["Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"]
234
- *
235
- * getLocalizedWeekdays("de-DE", "long")
236
- * // Returns: ["Montag", "Dienstag", "Mittwoch", ...]
237
- */
238
102
  export function getLocalizedWeekdays(locale, style = 'short') {
239
- const formatter = new Intl.DateTimeFormat(locale, { weekday: style });
240
- // Create a Sunday (base date) - January 7, 2024 is a Sunday
241
- const sunday = new Date(2024, 0, 7);
242
- // Generate Sunday-first array: [Sun, Mon, Tue, Wed, Thu, Fri, Sat]
243
- const sundayFirst = Array.from({ length: 7 }, (_, i) => {
244
- const date = addDays(sunday, i);
245
- return formatter.format(date);
246
- });
247
- // Reorder to Monday-first: [Mon, Tue, Wed, Thu, Fri, Sat, Sun]
248
- const [firstDay, ...rest] = sundayFirst;
249
- return [...rest, firstDay];
103
+ const formatter = new Intl.DateTimeFormat(locale, { weekday: style });
104
+ const sunday = new Date(2024, 0, 7);
105
+ const sundayFirst = Array.from({ length: 7 }, (_, i) => {
106
+ const date = addDays(sunday, i);
107
+ return formatter.format(date);
108
+ });
109
+ const [firstDay, ...rest] = sundayFirst;
110
+ return [...rest, firstDay];
250
111
  }
251
- // ============================================================================
252
- // Utility Functions (for testing and debugging)
253
- // ============================================================================
254
- /**
255
- * Get month name in specified locale
256
- *
257
- * @param month - Month (1-12)
258
- * @param locale - Locale string
259
- * @param style - Display style
260
- * @returns Localized month name
261
- *
262
- * @throws {RangeError} If month is invalid
263
- */
264
112
  export function getMonthName(month, locale = 'en-US', style = 'long') {
265
- validateMonth(month);
266
- const date = new Date(2024, month - 1, 1);
267
- const formatter = new Intl.DateTimeFormat(locale, { month: style });
268
- return formatter.format(date);
113
+ validateMonth(month);
114
+ const date = new Date(2024, month - 1, 1);
115
+ const formatter = new Intl.DateTimeFormat(locale, { month: style });
116
+ return formatter.format(date);
269
117
  }
270
- /**
271
- * Format a day context as an ISO date string
272
- *
273
- * @param dayContext - Day context to format
274
- * @returns ISO date string (YYYY-MM-DD)
275
- *
276
- * @example
277
- * formatDayContext({ year: 2025, month: 10, dayInMonth: 13, ... })
278
- * // Returns: "2025-10-13"
279
- */
280
- export function formatDayContext(dayContext) {
281
- const { year, month, dayInMonth } = dayContext;
282
- const monthStr = month.toString().padStart(2, '0');
283
- const dayStr = dayInMonth.toString().padStart(2, '0');
284
- return `${year}-${monthStr}-${dayStr}`;
285
- }
286
- /**
287
- * Check if a day context matches a specific date
288
- *
289
- * @param dayContext - Day context to check
290
- * @param year - Target year
291
- * @param month - Target month (1-12)
292
- * @param day - Target day
293
- * @returns True if the day context matches
294
- *
295
- * @example
296
- * isDayContext(dayCtx, 2025, 10, 13) // true if context is Oct 13, 2025
297
- */
298
- export function isDayContext(dayContext, year, month, day) {
299
- return dayContext.year === year
300
- && dayContext.month === month
301
- && dayContext.dayInMonth === day;
302
- }
303
- /**
304
- * Parse an ISO date string (YYYY-MM-DD) into year, month, day components
305
- *
306
- * @param isoString - ISO date string (YYYY-MM-DD)
307
- * @returns Object with year, month (1-12), and day, or null if invalid
308
- *
309
- * @example
310
- * parseISODate("2025-10-13")
311
- * // Returns: { year: 2025, month: 10, day: 13 }
312
- */
313
118
  export function parseISODate(isoString) {
314
- const match = isoString.match(/^(\d{4})-(\d{2})-(\d{2})$/);
315
- if (!match)
316
- return null;
317
- const year = parseInt(match[1], 10);
318
- const month = parseInt(match[2], 10);
319
- const day = parseInt(match[3], 10);
320
- // Validate ranges
321
- if (year < 1 || year > 9999)
322
- return null;
323
- if (month < 1 || month > 12)
324
- return null;
325
- if (day < 1 || day > 31)
326
- return null;
327
- // Check if date is valid (handles Feb 30, etc.)
328
- const date = new Date(year, month - 1, day);
329
- if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {
330
- return null;
331
- }
332
- return { year, month, day };
333
- }
334
- /**
335
- * Convert a UTC timestamp to an ISO date string
336
- * Interprets the timestamp as UTC midnight and returns the date
337
- *
338
- * @param utcTimestamp - UTC timestamp in milliseconds
339
- * @returns ISO date string (YYYY-MM-DD)
340
- *
341
- * @example
342
- * const ctx = getCalendarMonthDays(2025, 10)[0];
343
- * utcTimestampToISO(ctx.value) // "2025-10-13"
344
- */
345
- export function utcTimestampToISO(utcTimestamp) {
346
- const date = new Date(utcTimestamp);
347
- const year = date.getUTCFullYear();
348
- const month = (date.getUTCMonth() + 1).toString().padStart(2, '0');
349
- const day = date.getUTCDate().toString().padStart(2, '0');
350
- return `${year}-${month}-${day}`;
351
- }
352
- /**
353
- * Convert a local timestamp to an ISO date string
354
- * Interprets the timestamp in local timezone and returns the date
355
- *
356
- * @param localTimestamp - Local timestamp in milliseconds
357
- * @returns ISO date string (YYYY-MM-DD)
358
- *
359
- * @example
360
- * const ctx = getCalendarMonthDays(2025, 10)[0];
361
- * localTimestampToISO(ctx.localValue) // "2025-10-13"
362
- */
363
- export function localTimestampToISO(localTimestamp) {
364
- const date = new Date(localTimestamp);
365
- const year = date.getFullYear();
366
- const month = (date.getMonth() + 1).toString().padStart(2, '0');
367
- const day = date.getDate().toString().padStart(2, '0');
368
- return `${year}-${month}-${day}`;
119
+ const match = isoString.match(/^(\d{4})-(\d{2})-(\d{2})$/);
120
+ if (!match)
121
+ return null;
122
+ const year = parseInt(match[1], 10);
123
+ const month = parseInt(match[2], 10);
124
+ const day = parseInt(match[3], 10);
125
+ if (year < 1 || year > 9999)
126
+ return null;
127
+ if (month < 1 || month > 12)
128
+ return null;
129
+ if (day < 1 || day > 31)
130
+ return null;
131
+ const date = new Date(utcMidnight(year, month, day));
132
+ if (date.getUTCMonth() !== month - 1 || date.getUTCDate() !== day) {
133
+ return null;
134
+ }
135
+ return { year, month, day };
136
+ }
137
+ const LOCAL_VALUE = /^(\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.\d+)?)?)?$/;
138
+ export function wallClockDate(c) {
139
+ const date = new Date(0);
140
+ date.setUTCFullYear(c.year, c.month - 1, c.day);
141
+ date.setUTCHours(c.hour || 0, c.minute || 0, c.second || 0);
142
+ return date;
143
+ }
144
+ export function parseDateTime(value) {
145
+ if (value === null || value === undefined || value === '')
146
+ return null;
147
+ if (typeof value === 'string') {
148
+ const local = LOCAL_VALUE.exec(value);
149
+ if (local) {
150
+ const [year, month, day, hour, minute, second] = local.slice(1, 7).map((g) => Number(g ?? 0));
151
+ const components = { year, month, day, hour, minute, second };
152
+ const check = wallClockDate(components);
153
+ const real = check.getUTCMonth() === month - 1 && check.getUTCDate() === day &&
154
+ hour < 24 && minute < 60 && second < 60;
155
+ return real ? components : null;
156
+ }
157
+ }
158
+ const dateObj = typeof value === 'number' || typeof value === 'string' ? new Date(value) : null;
159
+ if (!dateObj || isNaN(dateObj.getTime())) {
160
+ return null;
161
+ }
162
+ return {
163
+ year: dateObj.getFullYear(),
164
+ month: dateObj.getMonth() + 1,
165
+ day: dateObj.getDate(),
166
+ hour: dateObj.getHours(),
167
+ minute: dateObj.getMinutes(),
168
+ second: dateObj.getSeconds(),
169
+ epoch: dateObj.getTime(),
170
+ };
171
+ }
172
+ export function parseDateDay(value) {
173
+ const parts = parseDateTime(value instanceof Date ? value.getTime() : value);
174
+ if (!parts || parts.year < 1 || parts.year > 9999)
175
+ return null;
176
+ return { year: parts.year, month: parts.month, day: parts.day };
177
+ }
178
+ export function formatISODay(year, month, day) {
179
+ const pad = (n, w) => n.toString().padStart(w, '0');
180
+ return `${pad(year, 4)}-${pad(month, 2)}-${pad(day, 2)}`;
181
+ }
182
+ export function toISODay(value) {
183
+ const d = parseDateDay(value);
184
+ return d && formatISODay(d.year, d.month, d.day);
369
185
  }
370
- //# sourceMappingURL=calendar-utils.js.map
@@ -1,23 +1,10 @@
1
1
  /**
2
- * CustomScrollbar - Reusable scrollbar utility
3
- *
4
- * Attaches a custom rendered scrollbar (vertical and/or horizontal) to any
5
- * scrollable element. Uses the overlay approach: native overflow:auto is
6
- * preserved for scroll physics, native scrollbar is hidden via CSS,
7
- * and custom track/thumb elements are synced on top.
8
- *
9
- * Usage:
10
- * const scrollbar = new CustomScrollbar(scrollEl, { vertical: true })
11
- * // scrollbar.trackY, scrollbar.thumbY — append these to your DOM
12
- * // scrollbar.trackX, scrollbar.thumbX — for horizontal
13
- * scrollbar.destroy() // cleanup
14
- *
15
- * CSS classes applied:
16
- * .ty-scrollbar-track-y / .ty-scrollbar-track-x
17
- * .ty-scrollbar-thumb-y / .ty-scrollbar-thumb-x
18
- * .has-overflow — when content overflows
19
- * .dragging — during thumb drag
20
- * .scrolling — briefly after scroll (auto-hide)
2
+ * CustomScrollbar - attaches a rendered scrollbar (vertical and/or horizontal)
3
+ * to any scrollable element. Overlay approach: native overflow:auto is kept for
4
+ * scroll physics, the native scrollbar is hidden via CSS, and custom track/thumb
5
+ * elements are synced on top. Append `trackY`/`trackX` to your DOM; `destroy()`
6
+ * cleans up. Classes: `.ty-scrollbar-{track,thumb}-{y,x}` plus state classes
7
+ * `.has-overflow`, `.dragging`, `.scrolling` (brief auto-hide after scroll).
21
8
  */
22
9
  export interface CustomScrollbarOptions {
23
10
  vertical?: boolean;
@@ -79,4 +66,3 @@ export declare class CustomScrollbar {
79
66
  private _handleTrackYDown;
80
67
  private _handleTrackXDown;
81
68
  }
82
- //# sourceMappingURL=custom-scrollbar.d.ts.map