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
@@ -0,0 +1,478 @@
1
+ # Tyrell i18n — Internationalization Guide
2
+
3
+ The `tyrell.i18n` namespaces provide internationalization for any ClojureScript framework. Protocol-based, leveraging the browser's native `Intl` API for number/date formatting.
4
+
5
+ ## Namespaces
6
+
7
+ | Namespace | Purpose |
8
+ |-----------|---------|
9
+ | `tyrell.i18n` | Core protocols, `t` function, `*locale*` dynamic var |
10
+ | `tyrell.i18n.keyword` | Keyword-based translations (primary) |
11
+ | `tyrell.i18n.string` | String-as-key translations (for UI strings) |
12
+ | `tyrell.i18n.number` | Number/currency/percent formatting via `Intl.NumberFormat` |
13
+ | `tyrell.i18n.time` | Date/time formatting via `Intl.DateTimeFormat` |
14
+
15
+ ---
16
+
17
+ ## Locale
18
+
19
+ The current locale is held in the dynamic var `tyrell.i18n/*locale*`. It auto-detects from the browser on load:
20
+
21
+ ```clojure
22
+ (require '[tyrell.i18n :as i18n])
23
+
24
+ i18n/*locale* ; => :en_US (detected from navigator.languages)
25
+ ```
26
+
27
+ ### Setting Locale
28
+
29
+ ```clojure
30
+ ;; Set globally (e.g., on language change)
31
+ (set! i18n/*locale* :hr)
32
+
33
+ ;; Temporarily bind for a block of code
34
+ (i18n/with-locale :de
35
+ (i18n/t :greeting)) ; translates using :de
36
+ ```
37
+
38
+ `with-locale` is useful when you need to render something in a different locale without changing the global setting — e.g., previewing content in another language, or formatting a value for export.
39
+
40
+ ### Supported Locales
41
+
42
+ 123 locales supported, including regional variants:
43
+
44
+ `:en`, `:en_US`, `:en_GB`, `:de`, `:de_AT`, `:de_CH`, `:fr`, `:fr_CA`, `:es`, `:es_MX`, `:hr`, `:ja`, `:zh`, `:zh_CN`, `:zh_TW`, `:ko`, `:ar`, `:hi`, `:ru`, `:pt`, `:pt_BR`, and many more.
45
+
46
+ Full list in `tyrell.i18n/locales`.
47
+
48
+ ---
49
+
50
+ ## Translation with `t`
51
+
52
+ The `t` function is the primary API. It dispatches via the `Translator` protocol — the behavior depends on the type of the first argument:
53
+
54
+ ```clojure
55
+ (require '[tyrell.i18n :refer [t]])
56
+
57
+ (t :save) ; keyword → keyword translation
58
+ (t "Select date...") ; string → string translation
59
+ (t 1234.56) ; number → formatted number
60
+ (t (js/Date.)) ; date → formatted date
61
+ ```
62
+
63
+ All forms use `*locale*` by default. Pass an explicit locale as second arg:
64
+
65
+ ```clojure
66
+ (t :save :de)
67
+ (t 1234.56 :de)
68
+ (t (js/Date.) :hr)
69
+ ```
70
+
71
+ ---
72
+
73
+ ## Keyword Translations
74
+
75
+ The primary translation approach. Uses qualified keywords for storage: `:key/locale`.
76
+
77
+ ### Registering Translations
78
+
79
+ ```clojure
80
+ (require '[tyrell.i18n.keyword :as kw])
81
+ ```
82
+
83
+ **With `add-translations`** — namespaced map syntax:
84
+
85
+ ```clojure
86
+ (kw/add-translations
87
+ #:save {:default "Save"
88
+ :hr "Spremi"
89
+ :de "Speichern"})
90
+
91
+ (kw/add-translations
92
+ #:cancel {:default "Cancel"
93
+ :hr "Odustani"
94
+ :de "Abbrechen"})
95
+ ```
96
+
97
+ The `#:save {...}` reader syntax expands to `{:save/default "Save" :save/hr "Spremi" ...}`.
98
+
99
+ **With `add-locale`** — grouped by locale:
100
+
101
+ ```clojure
102
+ (kw/add-locale
103
+ {:default {:save "Save"
104
+ :cancel "Cancel"
105
+ :delete "Delete"}
106
+ :hr {:save "Spremi"
107
+ :cancel "Odustani"
108
+ :delete "Obriši"}
109
+ :de {:save "Speichern"
110
+ :cancel "Abbrechen"
111
+ :delete "Löschen"}})
112
+ ```
113
+
114
+ Both approaches store to the same atom and can be mixed.
115
+
116
+ ### Using Translations
117
+
118
+ ```clojure
119
+ (require '[tyrell.i18n :refer [t]])
120
+ (require '[tyrell.i18n.keyword]) ; extends Keyword with Translator protocol
121
+
122
+ ;; Uses *locale*
123
+ (t :save) ; => "Spremi" (when *locale* is :hr)
124
+
125
+ ;; Explicit locale
126
+ (t :save :de) ; => "Speichern"
127
+
128
+ ;; Direct qualified keyword lookup
129
+ (t :save/hr) ; => "Spremi" (ignores *locale*)
130
+ ```
131
+
132
+ ### Fallback Chain
133
+
134
+ 1. `:key/*locale*` — exact locale match
135
+ 2. `:key/default` — default translation
136
+ 3. `(name key)` — keyword name as string (last resort)
137
+
138
+ ### Removing Translations
139
+
140
+ ```clojure
141
+ (kw/remove-translations :save [:hr :de]) ; remove specific locales
142
+ (kw/clear-translations!) ; clear everything
143
+ ```
144
+
145
+ ### Loading from URL
146
+
147
+ Fetch translations asynchronously from a server or static file. Returns a promise.
148
+
149
+ **EDN format:**
150
+
151
+ ```clojure
152
+ ;; File at /translations/hr.edn:
153
+ ;; {:save "Spremi" :cancel "Odustani" :delete "Obriši"}
154
+
155
+ (kw/load-translations!
156
+ {:format :edn
157
+ :path "/translations/hr.edn"
158
+ :locale :hr})
159
+ ```
160
+
161
+ The `:locale` option transforms `{:save "Spremi"}` into `{:save/hr "Spremi"}`.
162
+
163
+ **JSON format:**
164
+
165
+ ```clojure
166
+ ;; File at /api/translations/de.json:
167
+ ;; {"save": "Speichern", "cancel": "Abbrechen"}
168
+
169
+ (kw/load-translations!
170
+ {:format :json
171
+ :path "/api/translations/de.json"
172
+ :locale :de})
173
+ ```
174
+
175
+ **Pre-qualified format** (no `:locale` option needed):
176
+
177
+ ```clojure
178
+ ;; File contains already-qualified keys:
179
+ ;; {:save/hr "Spremi" :save/de "Speichern" :cancel/hr "Odustani"}
180
+
181
+ (kw/load-translations!
182
+ {:format :edn
183
+ :path "/translations/all.edn"})
184
+ ```
185
+
186
+ ---
187
+
188
+ ## String Translations
189
+
190
+ Uses English text as the key. Useful for translating UI strings that appear in component labels, tooltips, etc.
191
+
192
+ ```clojure
193
+ (require '[tyrell.i18n.string :as str-i18n])
194
+ ```
195
+
196
+ ### Registering
197
+
198
+ ```clojure
199
+ (str-i18n/add-string-translations
200
+ {"Select date..." {:hr "Odaberite datum..."
201
+ :de "Datum auswählen..."
202
+ :fr "Sélectionner une date..."}
203
+ "Save changes" {:hr "Spremi promjene"
204
+ :de "Änderungen speichern"}})
205
+
206
+ ;; Single string
207
+ (str-i18n/add-string-translation "Today" :hr "Danas")
208
+ ```
209
+
210
+ ### Using
211
+
212
+ ```clojure
213
+ (t "Select date...") ; => "Odaberite datum..." (when *locale* is :hr)
214
+ (t "Select date..." :de) ; => "Datum auswählen..."
215
+ (t "Unknown string") ; => "Unknown string" (returns original if no translation)
216
+ ```
217
+
218
+ ### Built-in Datepicker Translations
219
+
220
+ Pre-built translations for calendar/datepicker UI strings in 10 languages (hr, de, fr, es, it, pt, ru, ja, zh, ko):
221
+
222
+ ```clojure
223
+ (str-i18n/load-datepicker-translations!)
224
+ ```
225
+
226
+ Covers: "Select date...", "Time:", "Today", "Clear", "Open calendar", "Close calendar", "Previous year", "Previous month", "Next month", "Next year".
227
+
228
+ ### Loading from URL
229
+
230
+ ```clojure
231
+ ;; File: {"Select date..." {"hr": "Odaberite datum...", "de": "Datum auswählen..."}}
232
+ (str-i18n/load-string-translations!
233
+ {:format :json
234
+ :path "/translations/strings.json"})
235
+
236
+ (str-i18n/load-string-translations!
237
+ {:format :edn
238
+ :path "/translations/strings.edn"})
239
+ ```
240
+
241
+ ### Removing
242
+
243
+ ```clojure
244
+ (str-i18n/remove-string-translation "Today" :hr) ; remove one locale
245
+ (str-i18n/remove-string-translations "Today") ; remove all locales for string
246
+ (str-i18n/clear-string-translations!) ; clear everything
247
+ ```
248
+
249
+ ---
250
+
251
+ ## Number Formatting
252
+
253
+ Locale-aware number formatting via `Intl.NumberFormat`. Requiring the namespace extends `number` with the `Translator` protocol.
254
+
255
+ ```clojure
256
+ (require '[tyrell.i18n.number :as num])
257
+ ```
258
+
259
+ ### Basic Formatting
260
+
261
+ ```clojure
262
+ (num/format-number 1234567.89) ; => "1,234,567.89" (en_US)
263
+ (num/format-number 1234567.89 :de) ; => "1.234.567,89"
264
+ (num/format-number 1234567.89 :hr) ; => "1.234.567,89"
265
+ ```
266
+
267
+ ### Currency
268
+
269
+ ```clojure
270
+ (num/format-currency 1234.56 "EUR") ; => "€1,234.56" (en_US)
271
+ (num/format-currency 1234.56 "EUR" :de) ; => "1.234,56 €"
272
+ (num/format-currency 1234.56 "HRK" :hr) ; => "1.234,56 HRK"
273
+ ```
274
+
275
+ ### Percent
276
+
277
+ ```clojure
278
+ (num/format-percent 0.156) ; => "16%" (en_US)
279
+ (num/format-percent 0.156 :de) ; => "16 %"
280
+ ```
281
+
282
+ ### Compact
283
+
284
+ ```clojure
285
+ (num/format-compact 1234567) ; => "1.2M" (en_US)
286
+ (num/format-compact 1234567 :de) ; => "1,2 Mio."
287
+ (num/format-compact 1500) ; => "1.5K"
288
+ ```
289
+
290
+ ### Custom Options
291
+
292
+ Pass any `Intl.NumberFormat` option:
293
+
294
+ ```clojure
295
+ (num/format-number 1234.5 :en_US
296
+ {:minimumFractionDigits 2
297
+ :maximumFractionDigits 2
298
+ :useGrouping true})
299
+ ; => "1,234.50"
300
+ ```
301
+
302
+ ### Via `t`
303
+
304
+ Numbers are extended with `Translator`:
305
+
306
+ ```clojure
307
+ (t 1234.56) ; => "1,234.56" (formatted with *locale*)
308
+ (t 1234.56 :de) ; => "1.234,56" (explicit locale)
309
+ (t 1234.56 "EUR") ; => "€1,234.56" (string arg = currency code)
310
+ ```
311
+
312
+ ---
313
+
314
+ ## Date/Time Formatting
315
+
316
+ Locale-aware date/time formatting via `Intl.DateTimeFormat`. Requiring the namespace extends `js/Date` with the `Translator` protocol.
317
+
318
+ ```clojure
319
+ (require '[tyrell.i18n.time :as time])
320
+ ```
321
+
322
+ ### Preset Formats
323
+
324
+ ```clojure
325
+ (def d (js/Date. 2026 2 25)) ; March 25, 2026
326
+
327
+ (time/format-date-short d) ; => "3/25/26"
328
+ (time/format-date-medium d) ; => "Mar 25, 2026"
329
+ (time/format-date-long d) ; => "March 25, 2026"
330
+ (time/format-date-full d) ; => "Wednesday, March 25, 2026"
331
+
332
+ (time/format-date-short d :de) ; => "25.03.26"
333
+ (time/format-date-long d :hr) ; => "25. ožujka 2026."
334
+ ```
335
+
336
+ ### Time
337
+
338
+ ```clojure
339
+ (time/format-time (js/Date.)) ; => "2:30:45 PM"
340
+ (time/format-time (js/Date.) :de) ; => "14:30:45"
341
+ ```
342
+
343
+ ### Date + Time
344
+
345
+ ```clojure
346
+ (time/format-datetime (js/Date.)) ; => "Mar 25, 2026, 2:30 PM"
347
+ (time/format-datetime (js/Date.) :de) ; => "25.03.2026, 14:30"
348
+ ```
349
+
350
+ ### Relative Time
351
+
352
+ ```clojure
353
+ (time/format-relative -3 "day") ; => "3 days ago"
354
+ (time/format-relative -3 "day" :de) ; => "vor 3 Tagen"
355
+ (time/format-relative 1 "hour") ; => "in 1 hour"
356
+ (time/format-relative -1 "month" :hr) ; => "prošli mjesec"
357
+ ```
358
+
359
+ Units: `"year"`, `"quarter"`, `"month"`, `"week"`, `"day"`, `"hour"`, `"minute"`, `"second"`.
360
+
361
+ ### Custom Options
362
+
363
+ Pass any `Intl.DateTimeFormat` option:
364
+
365
+ ```clojure
366
+ (time/format-date (js/Date.) :en_US
367
+ {:weekday "long"
368
+ :year "numeric"
369
+ :month "short"
370
+ :day "numeric"
371
+ :hour "2-digit"
372
+ :minute "2-digit"})
373
+ ; => "Wednesday, Mar 25, 2026, 02:30 PM"
374
+ ```
375
+
376
+ ### Via `t`
377
+
378
+ Dates are extended with `Translator`:
379
+
380
+ ```clojure
381
+ (t (js/Date.)) ; => "Mar 25, 2026" (medium format with *locale*)
382
+ (t (js/Date.) :de) ; => "25.03.2026" (explicit locale)
383
+ (t (js/Date.) "short") ; => "3/25/26" (string arg = style preset)
384
+ (t (js/Date.) "full") ; => "Wednesday, March 25, 2026"
385
+ (t (js/Date.) "time") ; => "2:30:45 PM"
386
+ (t (js/Date.) "datetime") ; => "Mar 25, 2026, 2:30 PM"
387
+ ```
388
+
389
+ ---
390
+
391
+ ## Locale Info
392
+
393
+ The `Locale` protocol provides locale-specific calendar symbols:
394
+
395
+ ```clojure
396
+ (require '[tyrell.i18n :as i18n])
397
+ (require '[tyrell.i18n.time]) ; extends Keyword with Locale protocol
398
+
399
+ (i18n/locale :en :months) ; => ["January" "February" ... "December"]
400
+ (i18n/locale :de :months) ; => ["Januar" "Februar" ... "Dezember"]
401
+ (i18n/locale :hr :months/short) ; => ["sij" "velj" ... "pro"]
402
+ (i18n/locale :ja :months/narrow) ; => ["1月" "2月" ... "12月"]
403
+
404
+ (i18n/locale :en :weekdays) ; => ["Sunday" "Monday" ... "Saturday"]
405
+ (i18n/locale :hr :weekdays/short) ; => ["ned" "pon" ... "sub"]
406
+ (i18n/locale :zh :weekdays/narrow) ; => ["日" "一" ... "六"]
407
+ ```
408
+
409
+ Available keys: `:months`, `:months/short`, `:months/narrow`, `:weekdays`, `:weekdays/short`, `:weekdays/narrow`.
410
+
411
+ ---
412
+
413
+ ## App Initialization Example
414
+
415
+ ```clojure
416
+ (ns my-app.core
417
+ (:require [tyrell.i18n :as i18n]
418
+ [tyrell.i18n.keyword :as kw]
419
+ [tyrell.i18n.string :as str-i18n]
420
+ [tyrell.i18n.number] ; extends number with Translator
421
+ [tyrell.i18n.time])) ; extends Date with Translator
422
+
423
+ ;; 1. Register embedded translations
424
+ (kw/add-locale
425
+ {:default {:greeting "Hello"
426
+ :save "Save"
427
+ :cancel "Cancel"
428
+ :delete "Delete"
429
+ :confirm "Are you sure?"}
430
+ :hr {:greeting "Bok"
431
+ :save "Spremi"
432
+ :cancel "Odustani"
433
+ :delete "Obriši"
434
+ :confirm "Jeste li sigurni?"}
435
+ :de {:greeting "Hallo"
436
+ :save "Speichern"
437
+ :cancel "Abbrechen"
438
+ :delete "Löschen"
439
+ :confirm "Sind Sie sicher?"}})
440
+
441
+ ;; 2. Load datepicker UI translations (built-in)
442
+ (str-i18n/load-datepicker-translations!)
443
+
444
+ ;; 3. Optionally load more translations from server
445
+ (kw/load-translations!
446
+ {:format :json
447
+ :path "/api/translations/hr.json"
448
+ :locale :hr})
449
+
450
+ ;; 4. Set locale (or leave auto-detected from browser)
451
+ (set! i18n/*locale* :hr)
452
+ ```
453
+
454
+ ### Switching Language at Runtime
455
+
456
+ ```clojure
457
+ (defn set-language! [locale]
458
+ (set! i18n/*locale* locale)
459
+ (render!)) ; re-render your app
460
+ ```
461
+
462
+ ---
463
+
464
+ ## Extending with Custom Types
465
+
466
+ The `Translator` protocol can be extended to any type:
467
+
468
+ ```clojure
469
+ (extend-protocol i18n/Translator
470
+ cljs.core/PersistentVector
471
+ (translate
472
+ ([this] (mapv i18n/t this))
473
+ ([this locale] (mapv #(i18n/t % locale) this))
474
+ ([this locale opts] (mapv #(i18n/t % locale opts) this))))
475
+
476
+ (t [:save :cancel :delete])
477
+ ; => ["Spremi" "Odustani" "Obriši"]
478
+ ```