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.
- package/AGENTS.md +122 -0
- package/CHANGELOG.md +1541 -0
- package/README.md +71 -53
- package/bin/tyrell.mjs +77 -0
- package/css/tyrell-colors-static.css +1 -0
- package/css/tyrell-theme.css +1 -0
- package/css/tyrell.css +1 -1783
- package/dist/tyrell-colors-static.css +1 -0
- package/dist/tyrell-theme.css +1 -0
- package/dist/tyrell.css +1 -1783
- package/dist/tyrell.js +1 -1
- package/guides/AGENT_INSTRUCTIONS.md +124 -0
- package/guides/AI_GUIDE.md +53 -0
- package/guides/CSS_GUIDE.md +1016 -0
- package/guides/DATASTAR_TY_GUIDE.md +657 -0
- package/guides/ICONS_GUIDE.md +212 -0
- package/guides/TY_GUIDE.md +937 -0
- package/guides/clj/CLOJURESCRIPT_GUIDE.md +300 -0
- package/guides/clj/CODE_SPLITTING.md +279 -0
- package/guides/clj/COMPONENT_GUIDE.md +391 -0
- package/guides/clj/HELIX_TY_GUIDE.md +428 -0
- package/guides/clj/I18N_GUIDE.md +478 -0
- package/guides/clj/LAYOUT_GUIDE.md +273 -0
- package/guides/clj/QUICKSTART.md +266 -0
- package/guides/clj/REAGENT_TY_GUIDE.md +408 -0
- package/guides/clj/REPLICANT_TY_GUIDE.md +623 -0
- package/guides/clj/ROUTING_GUIDE.md +346 -0
- package/guides/clj/UIX_TY_GUIDE.md +319 -0
- package/guides/js/HTMX_TY_GUIDE.md +252 -0
- package/guides/js/JAVASCRIPT_GUIDE.md +388 -0
- package/guides/js/REACT_TY_GUIDE.md +983 -0
- package/guides/js/SVELTE_TY_GUIDE.md +682 -0
- package/guides/js/TYCOMPONENT_GUIDE.md +962 -0
- package/guides/js/VUE_TY_GUIDE.md +738 -0
- package/lib/base/ty-component.d.ts +57 -13
- package/lib/base/ty-component.js +266 -292
- package/lib/components/button.d.ts +33 -18
- package/lib/components/button.js +317 -267
- package/lib/components/calendar-month.d.ts +30 -47
- package/lib/components/calendar-month.js +455 -429
- package/lib/components/calendar-navigation.d.ts +41 -49
- package/lib/components/calendar-navigation.js +287 -346
- package/lib/components/calendar.d.ts +73 -83
- package/lib/components/calendar.js +837 -762
- package/lib/components/checkbox.d.ts +26 -75
- package/lib/components/checkbox.js +298 -391
- package/lib/components/copy.d.ts +20 -60
- package/lib/components/copy.js +276 -380
- package/lib/components/date-picker.d.ts +100 -183
- package/lib/components/date-picker.js +1155 -1570
- package/lib/components/file-upload.d.ts +16 -15
- package/lib/components/file-upload.js +436 -426
- package/lib/components/icon.d.ts +3 -24
- package/lib/components/icon.js +141 -230
- package/lib/components/input.d.ts +93 -108
- package/lib/components/input.js +734 -710
- package/lib/components/modal.d.ts +39 -29
- package/lib/components/modal.js +419 -438
- package/lib/components/option.d.ts +20 -35
- package/lib/components/option.js +184 -309
- package/lib/components/popup.d.ts +2 -17
- package/lib/components/popup.js +353 -347
- package/lib/components/radio.d.ts +33 -25
- package/lib/components/radio.js +433 -422
- package/lib/components/resize-observer.d.ts +3 -30
- package/lib/components/resize-observer.js +71 -103
- package/lib/components/scroll-container.d.ts +21 -14
- package/lib/components/scroll-container.js +292 -234
- package/lib/components/select.d.ts +458 -0
- package/lib/components/select.js +1458 -0
- package/lib/components/selected-tags.d.ts +60 -0
- package/lib/components/selected-tags.js +225 -0
- package/lib/components/sortable.d.ts +175 -0
- package/lib/components/sortable.js +1844 -0
- package/lib/components/step.d.ts +1 -6
- package/lib/components/step.js +62 -68
- package/lib/components/switch.d.ts +15 -15
- package/lib/components/switch.js +237 -231
- package/lib/components/tab.d.ts +50 -7
- package/lib/components/tab.js +203 -69
- package/lib/components/tabs.d.ts +19 -64
- package/lib/components/tabs.js +600 -618
- package/lib/components/tag.d.ts +14 -52
- package/lib/components/tag.js +231 -306
- package/lib/components/textarea.d.ts +58 -89
- package/lib/components/textarea.js +523 -573
- package/lib/components/tooltip.d.ts +8 -13
- package/lib/components/tooltip.js +322 -409
- package/lib/components/wizard.d.ts +7 -54
- package/lib/components/wizard.js +376 -606
- package/lib/icons/fontawesome/brands.d.ts +0 -1
- package/lib/icons/fontawesome/brands.js +0 -8
- package/lib/icons/fontawesome/regular.d.ts +0 -1
- package/lib/icons/fontawesome/regular.js +0 -8
- package/lib/icons/fontawesome/solid.d.ts +0 -1
- package/lib/icons/fontawesome/solid.js +0 -8
- package/lib/icons/heroicons/micro.d.ts +0 -1
- package/lib/icons/heroicons/micro.js +392 -400
- package/lib/icons/heroicons/mini.d.ts +0 -1
- package/lib/icons/heroicons/mini.js +382 -390
- package/lib/icons/heroicons/outline.d.ts +0 -1
- package/lib/icons/heroicons/outline.js +337 -345
- package/lib/icons/heroicons/solid.d.ts +0 -1
- package/lib/icons/heroicons/solid.js +407 -415
- package/lib/icons/lucide.d.ts +0 -1
- package/lib/icons/lucide.js +24479 -26351
- package/lib/icons/material/filled.d.ts +0 -1
- package/lib/icons/material/filled.js +9653 -9663
- package/lib/icons/material/outlined.d.ts +0 -1
- package/lib/icons/material/outlined.js +10271 -10281
- package/lib/icons/material/round.d.ts +0 -1
- package/lib/icons/material/round.js +10495 -10505
- package/lib/icons/material/sharp.d.ts +0 -1
- package/lib/icons/material/sharp.js +9905 -9915
- package/lib/icons/material/two-tone.d.ts +0 -1
- package/lib/icons/material/two-tone.js +12792 -12802
- package/lib/index.d.ts +7 -4
- package/lib/index.js +26 -39
- package/lib/styles/button.d.ts +24 -7
- package/lib/styles/button.js +285 -445
- package/lib/styles/calendar-month.d.ts +7 -6
- package/lib/styles/calendar-month.js +158 -226
- package/lib/styles/calendar-navigation.d.ts +2 -6
- package/lib/styles/calendar-navigation.js +108 -127
- package/lib/styles/calendar.d.ts +3 -3
- package/lib/styles/calendar.js +87 -23
- package/lib/styles/checkbox.d.ts +7 -6
- package/lib/styles/checkbox.js +101 -15
- package/lib/styles/copy.d.ts +3 -2
- package/lib/styles/copy.js +91 -71
- package/lib/styles/custom-scrollbar.d.ts +1 -2
- package/lib/styles/custom-scrollbar.js +80 -115
- package/lib/styles/date-picker.d.ts +4 -6
- package/lib/styles/date-picker.js +321 -388
- package/lib/styles/field-size.d.ts +6 -0
- package/lib/styles/field-size.js +91 -0
- package/lib/styles/file-upload.d.ts +1 -2
- package/lib/styles/file-upload.js +143 -188
- package/lib/styles/icon.d.ts +2 -6
- package/lib/styles/icon.js +92 -170
- package/lib/styles/input.d.ts +4 -7
- package/lib/styles/input.js +148 -643
- package/lib/styles/modal.d.ts +1 -2
- package/lib/styles/modal.js +127 -108
- package/lib/styles/option.d.ts +2 -6
- package/lib/styles/option.js +53 -96
- package/lib/styles/popup.d.ts +1 -2
- package/lib/styles/popup.js +47 -77
- package/lib/styles/radio.d.ts +3 -2
- package/lib/styles/radio.js +90 -116
- package/lib/styles/resize-observer.d.ts +1 -2
- package/lib/styles/resize-observer.js +2 -12
- package/lib/styles/scroll-container.d.ts +1 -2
- package/lib/styles/scroll-container.js +103 -146
- package/lib/styles/select-base.d.ts +8 -0
- package/lib/styles/select-base.js +752 -0
- package/lib/styles/select.d.ts +11 -0
- package/lib/styles/select.js +229 -0
- package/lib/styles/sortable.d.ts +16 -0
- package/lib/styles/sortable.js +85 -0
- package/lib/styles/step.d.ts +1 -2
- package/lib/styles/step.js +15 -34
- package/lib/styles/switch.d.ts +3 -2
- package/lib/styles/switch.js +52 -68
- package/lib/styles/tab.d.ts +1 -2
- package/lib/styles/tab.js +86 -34
- package/lib/styles/tabs.d.ts +3 -11
- package/lib/styles/tabs.js +204 -162
- package/lib/styles/tag.d.ts +2 -6
- package/lib/styles/tag.js +168 -362
- package/lib/styles/textarea.d.ts +1 -2
- package/lib/styles/textarea.js +238 -306
- package/lib/styles/tooltip.d.ts +4 -3
- package/lib/styles/tooltip.js +3 -131
- package/lib/styles/wizard.d.ts +8 -20
- package/lib/styles/wizard.js +306 -295
- package/lib/types/common.d.ts +9 -8
- package/lib/types/common.js +8 -5
- package/lib/utils/calendar-utils.d.ts +49 -65
- package/lib/utils/calendar-utils.js +158 -343
- package/lib/utils/custom-scrollbar.d.ts +6 -20
- package/lib/utils/custom-scrollbar.js +273 -317
- package/lib/utils/flavor-sheet.d.ts +31 -0
- package/lib/utils/flavor-sheet.js +17 -0
- package/lib/utils/icon-registry.d.ts +0 -15
- package/lib/utils/icon-registry.js +138 -279
- package/lib/utils/icons.d.ts +9 -0
- package/lib/utils/icons.js +1 -0
- package/lib/utils/loader-registry.d.ts +2 -3
- package/lib/utils/loader-registry.js +3 -35
- package/lib/utils/locale.d.ts +2 -80
- package/lib/utils/locale.js +30 -205
- package/lib/utils/mobile.d.ts +0 -1
- package/lib/utils/mobile.js +1 -18
- package/lib/utils/number-format.d.ts +6 -24
- package/lib/utils/number-format.js +53 -136
- package/lib/utils/positioning.d.ts +72 -22
- package/lib/utils/positioning.js +224 -298
- package/lib/utils/property-capture.d.ts +5 -27
- package/lib/utils/property-capture.js +36 -144
- package/lib/utils/property-manager.d.ts +6 -6
- package/lib/utils/property-manager.js +127 -196
- package/lib/utils/resize-observer.d.ts +0 -1
- package/lib/utils/resize-observer.js +23 -59
- package/lib/utils/scroll-lock.d.ts +10 -11
- package/lib/utils/scroll-lock.js +165 -173
- package/lib/utils/styles.d.ts +0 -6
- package/lib/utils/styles.js +17 -48
- package/lib/utils/upgrade-properties.d.ts +21 -0
- package/lib/utils/upgrade-properties.js +47 -0
- package/lib/utils/validity.d.ts +122 -0
- package/lib/utils/validity.js +289 -0
- package/lib/version.d.ts +1 -2
- package/lib/version.js +1 -11
- package/package.json +66 -18
- package/lib/base/ty-component.d.ts.map +0 -1
- package/lib/base/ty-component.js.map +0 -1
- package/lib/components/button.d.ts.map +0 -1
- package/lib/components/button.js.map +0 -1
- package/lib/components/calendar-month.d.ts.map +0 -1
- package/lib/components/calendar-month.js.map +0 -1
- package/lib/components/calendar-navigation.d.ts.map +0 -1
- package/lib/components/calendar-navigation.js.map +0 -1
- package/lib/components/calendar.d.ts.map +0 -1
- package/lib/components/calendar.js.map +0 -1
- package/lib/components/checkbox.d.ts.map +0 -1
- package/lib/components/checkbox.js.map +0 -1
- package/lib/components/copy.d.ts.map +0 -1
- package/lib/components/copy.js.map +0 -1
- package/lib/components/date-picker.d.ts.map +0 -1
- package/lib/components/date-picker.js.map +0 -1
- package/lib/components/dropdown.d.ts +0 -404
- package/lib/components/dropdown.d.ts.map +0 -1
- package/lib/components/dropdown.js +0 -1563
- package/lib/components/dropdown.js.map +0 -1
- package/lib/components/file-upload.d.ts.map +0 -1
- package/lib/components/file-upload.js.map +0 -1
- package/lib/components/icon.d.ts.map +0 -1
- package/lib/components/icon.js.map +0 -1
- package/lib/components/input.d.ts.map +0 -1
- package/lib/components/input.js.map +0 -1
- package/lib/components/modal.d.ts.map +0 -1
- package/lib/components/modal.js.map +0 -1
- package/lib/components/multiselect.d.ts +0 -408
- package/lib/components/multiselect.d.ts.map +0 -1
- package/lib/components/multiselect.js +0 -1611
- package/lib/components/multiselect.js.map +0 -1
- package/lib/components/option.d.ts.map +0 -1
- package/lib/components/option.js.map +0 -1
- package/lib/components/popup.d.ts.map +0 -1
- package/lib/components/popup.js.map +0 -1
- package/lib/components/radio.d.ts.map +0 -1
- package/lib/components/radio.js.map +0 -1
- package/lib/components/resize-observer.d.ts.map +0 -1
- package/lib/components/resize-observer.js.map +0 -1
- package/lib/components/scroll-container.d.ts.map +0 -1
- package/lib/components/scroll-container.js.map +0 -1
- package/lib/components/step.d.ts.map +0 -1
- package/lib/components/step.js.map +0 -1
- package/lib/components/switch.d.ts.map +0 -1
- package/lib/components/switch.js.map +0 -1
- package/lib/components/tab.d.ts.map +0 -1
- package/lib/components/tab.js.map +0 -1
- package/lib/components/tabs.d.ts.map +0 -1
- package/lib/components/tabs.js.map +0 -1
- package/lib/components/tag.d.ts.map +0 -1
- package/lib/components/tag.js.map +0 -1
- package/lib/components/textarea.d.ts.map +0 -1
- package/lib/components/textarea.js.map +0 -1
- package/lib/components/tooltip.d.ts.map +0 -1
- package/lib/components/tooltip.js.map +0 -1
- package/lib/components/wizard.d.ts.map +0 -1
- package/lib/components/wizard.js.map +0 -1
- package/lib/icons/fontawesome/brands.d.ts.map +0 -1
- package/lib/icons/fontawesome/brands.js.map +0 -1
- package/lib/icons/fontawesome/regular.d.ts.map +0 -1
- package/lib/icons/fontawesome/regular.js.map +0 -1
- package/lib/icons/fontawesome/solid.d.ts.map +0 -1
- package/lib/icons/fontawesome/solid.js.map +0 -1
- package/lib/icons/heroicons/micro.d.ts.map +0 -1
- package/lib/icons/heroicons/micro.js.map +0 -1
- package/lib/icons/heroicons/mini.d.ts.map +0 -1
- package/lib/icons/heroicons/mini.js.map +0 -1
- package/lib/icons/heroicons/outline.d.ts.map +0 -1
- package/lib/icons/heroicons/outline.js.map +0 -1
- package/lib/icons/heroicons/solid.d.ts.map +0 -1
- package/lib/icons/heroicons/solid.js.map +0 -1
- package/lib/icons/lucide.d.ts.map +0 -1
- package/lib/icons/lucide.js.map +0 -1
- package/lib/icons/material/filled.d.ts.map +0 -1
- package/lib/icons/material/filled.js.map +0 -1
- package/lib/icons/material/outlined.d.ts.map +0 -1
- package/lib/icons/material/outlined.js.map +0 -1
- package/lib/icons/material/round.d.ts.map +0 -1
- package/lib/icons/material/round.js.map +0 -1
- package/lib/icons/material/sharp.d.ts.map +0 -1
- package/lib/icons/material/sharp.js.map +0 -1
- package/lib/icons/material/two-tone.d.ts.map +0 -1
- package/lib/icons/material/two-tone.js.map +0 -1
- package/lib/index.d.ts.map +0 -1
- package/lib/index.js.map +0 -1
- package/lib/styles/button.d.ts.map +0 -1
- package/lib/styles/button.js.map +0 -1
- package/lib/styles/calendar-month.d.ts.map +0 -1
- package/lib/styles/calendar-month.js.map +0 -1
- package/lib/styles/calendar-navigation.d.ts.map +0 -1
- package/lib/styles/calendar-navigation.js.map +0 -1
- package/lib/styles/calendar.d.ts.map +0 -1
- package/lib/styles/calendar.js.map +0 -1
- package/lib/styles/checkbox.d.ts.map +0 -1
- package/lib/styles/checkbox.js.map +0 -1
- package/lib/styles/copy.d.ts.map +0 -1
- package/lib/styles/copy.js.map +0 -1
- package/lib/styles/custom-scrollbar.d.ts.map +0 -1
- package/lib/styles/custom-scrollbar.js.map +0 -1
- package/lib/styles/date-picker.d.ts.map +0 -1
- package/lib/styles/date-picker.js.map +0 -1
- package/lib/styles/dropdown.d.ts +0 -12
- package/lib/styles/dropdown.d.ts.map +0 -1
- package/lib/styles/dropdown.js +0 -1048
- package/lib/styles/dropdown.js.map +0 -1
- package/lib/styles/file-upload.d.ts.map +0 -1
- package/lib/styles/file-upload.js.map +0 -1
- package/lib/styles/icon.d.ts.map +0 -1
- package/lib/styles/icon.js.map +0 -1
- package/lib/styles/input.d.ts.map +0 -1
- package/lib/styles/input.js.map +0 -1
- package/lib/styles/modal.d.ts.map +0 -1
- package/lib/styles/modal.js.map +0 -1
- package/lib/styles/multiselect.d.ts +0 -6
- package/lib/styles/multiselect.d.ts.map +0 -1
- package/lib/styles/multiselect.js +0 -837
- package/lib/styles/multiselect.js.map +0 -1
- package/lib/styles/option.d.ts.map +0 -1
- package/lib/styles/option.js.map +0 -1
- package/lib/styles/popup.d.ts.map +0 -1
- package/lib/styles/popup.js.map +0 -1
- package/lib/styles/radio.d.ts.map +0 -1
- package/lib/styles/radio.js.map +0 -1
- package/lib/styles/resize-observer.d.ts.map +0 -1
- package/lib/styles/resize-observer.js.map +0 -1
- package/lib/styles/scroll-container.d.ts.map +0 -1
- package/lib/styles/scroll-container.js.map +0 -1
- package/lib/styles/step.d.ts.map +0 -1
- package/lib/styles/step.js.map +0 -1
- package/lib/styles/switch.d.ts.map +0 -1
- package/lib/styles/switch.js.map +0 -1
- package/lib/styles/tab.d.ts.map +0 -1
- package/lib/styles/tab.js.map +0 -1
- package/lib/styles/tabs.d.ts.map +0 -1
- package/lib/styles/tabs.js.map +0 -1
- package/lib/styles/tag.d.ts.map +0 -1
- package/lib/styles/tag.js.map +0 -1
- package/lib/styles/textarea.d.ts.map +0 -1
- package/lib/styles/textarea.js.map +0 -1
- package/lib/styles/tooltip.d.ts.map +0 -1
- package/lib/styles/tooltip.js.map +0 -1
- package/lib/styles/wizard.d.ts.map +0 -1
- package/lib/styles/wizard.js.map +0 -1
- package/lib/types/common.d.ts.map +0 -1
- package/lib/types/common.js.map +0 -1
- package/lib/utils/calendar-utils.d.ts.map +0 -1
- package/lib/utils/calendar-utils.js.map +0 -1
- package/lib/utils/custom-scrollbar.d.ts.map +0 -1
- package/lib/utils/custom-scrollbar.js.map +0 -1
- package/lib/utils/icon-registry.d.ts.map +0 -1
- package/lib/utils/icon-registry.js.map +0 -1
- package/lib/utils/loader-registry.d.ts.map +0 -1
- package/lib/utils/loader-registry.js.map +0 -1
- package/lib/utils/locale.d.ts.map +0 -1
- package/lib/utils/locale.js.map +0 -1
- package/lib/utils/mobile.d.ts.map +0 -1
- package/lib/utils/mobile.js.map +0 -1
- package/lib/utils/number-format.d.ts.map +0 -1
- package/lib/utils/number-format.js.map +0 -1
- package/lib/utils/parse-boolean.d.ts +0 -39
- package/lib/utils/parse-boolean.d.ts.map +0 -1
- package/lib/utils/parse-boolean.js +0 -58
- package/lib/utils/parse-boolean.js.map +0 -1
- package/lib/utils/positioning.d.ts.map +0 -1
- package/lib/utils/positioning.js.map +0 -1
- package/lib/utils/property-capture.d.ts.map +0 -1
- package/lib/utils/property-capture.js.map +0 -1
- package/lib/utils/property-manager.d.ts.map +0 -1
- package/lib/utils/property-manager.js.map +0 -1
- package/lib/utils/resize-observer.d.ts.map +0 -1
- package/lib/utils/resize-observer.js.map +0 -1
- package/lib/utils/scroll-lock.d.ts.map +0 -1
- package/lib/utils/scroll-lock.js.map +0 -1
- package/lib/utils/styles.d.ts.map +0 -1
- package/lib/utils/styles.js.map +0 -1
- package/lib/version.d.ts.map +0 -1
- 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
|
+
```
|