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,623 @@
|
|
|
1
|
+
# Replicant + Tyrell Guide
|
|
2
|
+
|
|
3
|
+
Using Tyrell web components with Replicant (ClojureScript DOM library).
|
|
4
|
+
|
|
5
|
+
For the full CSS class reference, see [`CSS_GUIDE.md`](../CSS_GUIDE.md). In Replicant hiccup, Tyrell color classes go on the element keyword with dots, Tailwind handles everything else:
|
|
6
|
+
|
|
7
|
+
```clojure
|
|
8
|
+
;; Tyrell for colors (surfaces, text, bg, border), Tailwind for layout
|
|
9
|
+
[:div.ty-elevated.p-6.rounded-lg.flex.items-center
|
|
10
|
+
[:h2.ty-text++.text-xl.font-bold "Title"]
|
|
11
|
+
[:p.ty-text-.text-sm "Subtitle"]]
|
|
12
|
+
|
|
13
|
+
;; Dynamic classes — use vectors, not string concatenation
|
|
14
|
+
[:div {:class ["ty-elevated" "p-4" (when active? "ty-bg-primary-")]}]
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Loading Tyrell CSS
|
|
20
|
+
|
|
21
|
+
Component classes only work once `tyrell.css` is loaded. Easiest is a CDN `<link>`:
|
|
22
|
+
|
|
23
|
+
```html
|
|
24
|
+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tyrell-components@latest/css/tyrell.css">
|
|
25
|
+
<!-- tyrell-theme.css: auto-contrast, seed-based rebranding, themes. See TY_GUIDE.md#quick-start -->
|
|
26
|
+
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/tyrell-components@latest/css/tyrell-theme.css">
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
For offline dev, fetch the files once and serve them from your `public/`:
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
# Pin a version
|
|
33
|
+
curl -o public/css/tyrell.css https://cdn.jsdelivr.net/npm/tyrell-components@1.0.0-rc.21/css/tyrell.css
|
|
34
|
+
curl -o public/css/tyrell-theme.css https://cdn.jsdelivr.net/npm/tyrell-components@1.0.0-rc.21/css/tyrell-theme.css
|
|
35
|
+
|
|
36
|
+
# Or copy from the version shadow-cljs already installed (after first build)
|
|
37
|
+
cp node_modules/tyrell-components/css/tyrell.css public/css/tyrell.css
|
|
38
|
+
cp node_modules/tyrell-components/css/tyrell-theme.css public/css/tyrell-theme.css
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Then `<link>` both in your HTML, brand.css after tyrell.css. See [`CLOJURESCRIPT_GUIDE.md`](CLOJURESCRIPT_GUIDE.md#css-handling) for the Tailwind/PostCSS pipeline variant.
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Replicant Attribute Conventions
|
|
46
|
+
|
|
47
|
+
Replicant emits console warnings (and in some cases drops change detection) when `:class` and `:style` aren't shaped the way it expects. Three rules cover virtually every case:
|
|
48
|
+
|
|
49
|
+
### 1. `:class` is always a vector of single-class tokens
|
|
50
|
+
|
|
51
|
+
Multi-class strings like `"text-xs font-light"` warn *and* perform worse — Replicant has to parse them at every render. Use a vector of single-class strings (or keywords) instead, **including inside `(when …)`, `(if …)`, `(cond …)`, `(case …)` branches**. The string-with-spaces is still wrong even when it's deep inside a dynamic form.
|
|
52
|
+
|
|
53
|
+
```clojure
|
|
54
|
+
;; ❌ Multi-class string (warns)
|
|
55
|
+
[:span {:class "text-xs font-light"} "welcome"]
|
|
56
|
+
|
|
57
|
+
;; ❌ Multi-class string inside a dynamic form (still warns)
|
|
58
|
+
[:div {:class (when on-click "cursor-pointer hover:shadow-lg")} ...]
|
|
59
|
+
|
|
60
|
+
[:span {:class (cond
|
|
61
|
+
(and featured? active?) "text-xs font-semibold"
|
|
62
|
+
featured? "text-xs font-medium"
|
|
63
|
+
:else "text-xs font-light")}]
|
|
64
|
+
|
|
65
|
+
;; ✅ Vectors everywhere
|
|
66
|
+
[:span {:class ["text-xs" "font-light"]} "welcome"]
|
|
67
|
+
|
|
68
|
+
[:div {:class (when on-click ["cursor-pointer" "hover:shadow-lg"])} ...]
|
|
69
|
+
|
|
70
|
+
[:span {:class (cond
|
|
71
|
+
(and featured? active?) ["text-xs" "font-semibold"]
|
|
72
|
+
featured? ["text-xs" "font-medium"]
|
|
73
|
+
:else ["text-xs" "font-light"])}]
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
Single-class strings like `(when active? "ty-text-primary")` are fine — the rule only applies to strings that contain spaces.
|
|
77
|
+
|
|
78
|
+
### 2. `:style` is always a map, never a string
|
|
79
|
+
|
|
80
|
+
Style strings (`{:style "font-size: 0.875rem;"}`) warn — Replicant has to parse them on every render and they're harder to read. Use a map of CSS-property keywords:
|
|
81
|
+
|
|
82
|
+
```clojure
|
|
83
|
+
;; ❌ Style string
|
|
84
|
+
[:p {:style "font-size: 0.875rem; line-height: 1.6;"} ...]
|
|
85
|
+
|
|
86
|
+
;; ✅ Style map
|
|
87
|
+
[:p {:style {:font-size "0.875rem"
|
|
88
|
+
:line-height "1.6"}} ...]
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
This rule applies only to the `:style` *attribute*. The `[:style "…"]` *element* (a `<style>` tag with CSS source as text content) is unaffected — it's a tag, not an attribute.
|
|
92
|
+
|
|
93
|
+
### 3. `:style` map keys are keywords — including CSS custom properties
|
|
94
|
+
|
|
95
|
+
Replicant warns when style keys are strings or symbols and refuses to recognize subsequent changes to them reliably. Clojure keywords accept the `--` prefix, so CSS custom properties become valid keywords:
|
|
96
|
+
|
|
97
|
+
```clojure
|
|
98
|
+
;; ❌ String keys for CSS variables
|
|
99
|
+
[:ty-button {:style {"--ty-button-bg" "#ff6600"
|
|
100
|
+
"--ty-button-color" "white"}}]
|
|
101
|
+
|
|
102
|
+
;; ✅ Keyword keys (Clojure accepts the leading -- in keywords)
|
|
103
|
+
[:ty-button {:style {:--ty-button-bg "#ff6600"
|
|
104
|
+
:--ty-button-color "white"}}]
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Component Usage
|
|
110
|
+
|
|
111
|
+
### Basic View Structure
|
|
112
|
+
|
|
113
|
+
```clojure
|
|
114
|
+
(ns my-app.views.user-profile
|
|
115
|
+
(:require [tyrell.router :as router]))
|
|
116
|
+
|
|
117
|
+
(defn view []
|
|
118
|
+
(when (router/rendered? ::user-profile)
|
|
119
|
+
[:div.ty-content.p-6
|
|
120
|
+
[:div.ty-elevated.rounded-lg.p-6
|
|
121
|
+
[:h2.ty-text++.text-2xl.mb-4 "User Profile"]
|
|
122
|
+
;; component content
|
|
123
|
+
]]))
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
### Tyrell Web Components in Hiccup
|
|
127
|
+
|
|
128
|
+
```clojure
|
|
129
|
+
;; Input with label and error
|
|
130
|
+
[:ty-input
|
|
131
|
+
{:type "email"
|
|
132
|
+
:label "Email"
|
|
133
|
+
:placeholder "you@example.com"
|
|
134
|
+
:required true
|
|
135
|
+
:value current-email
|
|
136
|
+
:error (when (touched :email) (errors :email))
|
|
137
|
+
:on {:change (fn [^js e] (on-email-change (-> e .-detail .-value)))}}]
|
|
138
|
+
|
|
139
|
+
;; Select (single)
|
|
140
|
+
[:ty-select
|
|
141
|
+
{:label "Country"
|
|
142
|
+
:placeholder "Select..."
|
|
143
|
+
:value selected-country
|
|
144
|
+
:on {:change (fn [^js e] (on-country-change (-> e .-detail .-value)))}}
|
|
145
|
+
[:ty-option {:value "us"} "United States"]
|
|
146
|
+
[:ty-option {:value "de"} "Germany"]]
|
|
147
|
+
|
|
148
|
+
;; Multi-select (ty-select with :multiple — children are
|
|
149
|
+
;; ty-option, chips render via ty-selected-options)
|
|
150
|
+
[:ty-select
|
|
151
|
+
{:multiple true
|
|
152
|
+
:id "skills"
|
|
153
|
+
:label "Skills"
|
|
154
|
+
:placeholder "Add skills"
|
|
155
|
+
:value (clojure.string/join "," selected-skills) ; the selection: a comma-joined string
|
|
156
|
+
:on {:change (fn [^js e] (on-skills-change (vec (-> e .-detail .-values))))}}
|
|
157
|
+
[:ty-option {:value "clojure" :flavor "primary"} "Clojure"]
|
|
158
|
+
[:ty-option {:value "javascript" :flavor "warning"} "JavaScript"]]
|
|
159
|
+
[:ty-selected-options {:for "skills"}]
|
|
160
|
+
|
|
161
|
+
;; Checkbox
|
|
162
|
+
[:ty-checkbox
|
|
163
|
+
{:checked agreed?
|
|
164
|
+
:flavor "primary"
|
|
165
|
+
:on {:change (fn [^js e] (on-agree-change (-> e .-detail .-checked)))}}
|
|
166
|
+
"I agree to terms"]
|
|
167
|
+
|
|
168
|
+
;; Textarea
|
|
169
|
+
[:ty-textarea
|
|
170
|
+
{:label "Notes"
|
|
171
|
+
:placeholder "Write something..."
|
|
172
|
+
:rows "4"
|
|
173
|
+
:value notes-value
|
|
174
|
+
:on {:change (fn [^js e] (on-notes-change (-> e .-detail .-value)))}}]
|
|
175
|
+
|
|
176
|
+
;; Button with start icon
|
|
177
|
+
[:ty-button {:flavor "primary" :type "submit"}
|
|
178
|
+
[:ty-icon {:slot "start" :name "save" :size "sm"}]
|
|
179
|
+
"Save"]
|
|
180
|
+
|
|
181
|
+
;; Button with end icon
|
|
182
|
+
[:ty-button {:flavor "neutral"}
|
|
183
|
+
"Next"
|
|
184
|
+
[:ty-icon {:slot "end" :name "chevron-right" :size "sm"}]]
|
|
185
|
+
|
|
186
|
+
;; Icon-only button
|
|
187
|
+
[:ty-button {:flavor "neutral" :size "sm"}
|
|
188
|
+
[:ty-icon {:name "settings" :size "sm"}]]
|
|
189
|
+
|
|
190
|
+
;; Input with icon slots
|
|
191
|
+
[:ty-input {:type "currency" :currency "EUR" :label "Price"}
|
|
192
|
+
[:ty-icon {:slot "start" :name "euro"}]]
|
|
193
|
+
|
|
194
|
+
[:ty-input {:type "email" :label "Email"}
|
|
195
|
+
[:ty-icon {:slot "start" :name "mail" :size "sm"}]
|
|
196
|
+
[:ty-icon {:slot "end" :name "check" :size "sm"}]]
|
|
197
|
+
|
|
198
|
+
;; Tag with icon
|
|
199
|
+
[:ty-tag {:flavor "primary" :dismissible true
|
|
200
|
+
:on {:dismiss (fn [^js e] (on-tag-dismiss (-> e .-detail .-value)))}}
|
|
201
|
+
[:ty-icon {:slot "start" :name "star" :size "sm"}]
|
|
202
|
+
"Featured"]
|
|
203
|
+
|
|
204
|
+
;; Modal
|
|
205
|
+
[:ty-modal {:open show-modal?
|
|
206
|
+
:on {:close (fn [^js e] (on-modal-close))}}
|
|
207
|
+
[:div.ty-elevated.p-6.rounded-lg
|
|
208
|
+
[:h3.ty-text++.text-lg "Confirm"]
|
|
209
|
+
[:p.ty-text "Are you sure?"]
|
|
210
|
+
[:div.flex.gap-2.mt-4
|
|
211
|
+
[:ty-button {:flavor "danger"} "Delete"]
|
|
212
|
+
[:ty-button {:flavor "neutral"} "Cancel"]]]]
|
|
213
|
+
|
|
214
|
+
;; Calendar
|
|
215
|
+
[:ty-calendar
|
|
216
|
+
{:value selected-date
|
|
217
|
+
:on {:change (fn [^js e] (on-date-change (-> e .-detail .-value)))}}]
|
|
218
|
+
|
|
219
|
+
;; Date picker
|
|
220
|
+
[:ty-date-picker
|
|
221
|
+
{:label "Start Date"
|
|
222
|
+
:value selected-date
|
|
223
|
+
:on {:change (fn [^js e] (on-date-change (-> e .-detail .-value)))}}]
|
|
224
|
+
|
|
225
|
+
;; Wizard
|
|
226
|
+
[:ty-wizard {:width "100%" :height "400px"
|
|
227
|
+
:active wizard-step
|
|
228
|
+
:completed (clojure.string/join "," completed-steps)}
|
|
229
|
+
[:ty-step {:id "info" :label "Information"} "Step 1"]
|
|
230
|
+
[:ty-step {:id "review" :label "Review"} "Step 2"]]
|
|
231
|
+
|
|
232
|
+
;; Tooltip
|
|
233
|
+
[:ty-button {:flavor "primary"}
|
|
234
|
+
"Hover me"
|
|
235
|
+
[:ty-tooltip "This is helpful info"]]
|
|
236
|
+
|
|
237
|
+
;; Scroll container
|
|
238
|
+
[:ty-scroll-container {:max-height "400px"}
|
|
239
|
+
(for [item items]
|
|
240
|
+
^{:key (:id item)}
|
|
241
|
+
[:div.p-3.ty-elevated.rounded-lg (:name item)])]
|
|
242
|
+
|
|
243
|
+
;; Copy
|
|
244
|
+
[:ty-copy {:value "npm install tyrell-components" :format "code"}]
|
|
245
|
+
```
|
|
246
|
+
|
|
247
|
+
---
|
|
248
|
+
|
|
249
|
+
## Event Handling
|
|
250
|
+
|
|
251
|
+
### Replicant `:on` Syntax
|
|
252
|
+
|
|
253
|
+
Event handlers are attached via the `:on` map. Keys are event type keywords, values are handler functions:
|
|
254
|
+
|
|
255
|
+
```clojure
|
|
256
|
+
[:ty-input {:on {:change handler-fn}}] ; single event
|
|
257
|
+
[:ty-input {:on {:input on-input ; multiple events
|
|
258
|
+
:change on-change
|
|
259
|
+
:focus on-focus}}]
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
### Type Hint with `^js`
|
|
263
|
+
|
|
264
|
+
Tyrell events are JavaScript `CustomEvent` objects. **Always type hint the event parameter with `^js`** so the ClojureScript compiler doesn't munge property access:
|
|
265
|
+
|
|
266
|
+
```clojure
|
|
267
|
+
;; CORRECT — ^js ensures .-detail and .-value are not munged
|
|
268
|
+
(fn [^js e]
|
|
269
|
+
(let [^js detail (.-detail e)
|
|
270
|
+
value (.-value detail)]
|
|
271
|
+
(do-something value)))
|
|
272
|
+
|
|
273
|
+
;; WRONG — without ^js, advanced compilation may break property access
|
|
274
|
+
(fn [e]
|
|
275
|
+
(let [value (-> e .-detail .-value)] ; may break in :advanced
|
|
276
|
+
(do-something value)))
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
### What Tyrell Components Emit
|
|
280
|
+
|
|
281
|
+
Every Tyrell component emits standard DOM `CustomEvent`s. The payload is always in `event.detail`:
|
|
282
|
+
|
|
283
|
+
| Component | Event | `event.detail` fields |
|
|
284
|
+
|-----------|-------|-----------------------|
|
|
285
|
+
| `ty-input` | `input` (every keystroke) | `value`, `formattedValue`, `rawValue`, `originalEvent` |
|
|
286
|
+
| `ty-input` | `change` (on blur) | `value`, `formattedValue`, `rawValue`, `originalEvent` |
|
|
287
|
+
| `ty-textarea` | `input` (every keystroke) | `value`, `originalEvent` |
|
|
288
|
+
| `ty-textarea` | `change` (on blur) | `value`, `originalEvent` |
|
|
289
|
+
| `ty-checkbox` | `change` | `value`, `checked`, `formValue`, `originalEvent` |
|
|
290
|
+
| `ty-select` | `change` | `value` (scalar, or array when `multiple`), `values` (JS array, pick order), `items`, `action` (`"add"`/`"remove"`/`"clear"`/`"set"`/`"create"`), `item`; with `external-selection`, `value` is the picked option and `selected` its requested state |
|
|
291
|
+
| `ty-select` | `search` | `query`, `element` |
|
|
292
|
+
| `ty-file-upload` | `change` | `value` (File[]), `files` (File[]), `names` (string[]) |
|
|
293
|
+
| `ty-calendar` | `change` | `year`, `month`, `day`, `action`, `source`, `dayContext` |
|
|
294
|
+
| `ty-calendar` | `navigate` | `month`, `year`, `action`, `source` |
|
|
295
|
+
| `ty-date-picker` | `change` | `value` (ISO string) |
|
|
296
|
+
| `ty-tabs` | `ty-tab-change` | `activeId`, `activeIndex`, `previousId`, `previousIndex` |
|
|
297
|
+
| `ty-tab` (`lazy`) | `ty-tab-load` | `id`, `index` (on the tab, doesn't bubble; call `(.loadFailed (.-target e))` if loading fails) |
|
|
298
|
+
| `ty-wizard` | `ty-wizard-step-change` | `activeId`, `activeIndex`, `previousId`, `previousIndex`, `direction` |
|
|
299
|
+
| `ty-modal` | `close` | `reason`, `returnValue` |
|
|
300
|
+
| `ty-tag` | `click` | `value` |
|
|
301
|
+
| `ty-tag` | `dismiss` | `value` |
|
|
302
|
+
| `ty-button` | `click` | `originalEvent` |
|
|
303
|
+
| `ty-copy` | `copy` | `value` |
|
|
304
|
+
| `ty-sortable` | `ty-sortable-change` | `value` (`key`, `group`, `source`, `from`, `to`, `order`), `item`, `fromContainer`, `toContainer` (on the destination list; `preventDefault()` rejects) |
|
|
305
|
+
|
|
306
|
+
### Reading Event Detail Per Component
|
|
307
|
+
|
|
308
|
+
```clojure
|
|
309
|
+
;; ty-input — value is the parsed value, rawValue is the string
|
|
310
|
+
[:ty-input
|
|
311
|
+
{:label "Price" :type "currency" :currency "EUR"
|
|
312
|
+
:on {:change (fn [^js e]
|
|
313
|
+
(let [^js detail (.-detail e)]
|
|
314
|
+
;; (.-value detail) => 1234.56
|
|
315
|
+
;; (.-formattedValue detail) => "€1.234,56"
|
|
316
|
+
;; (.-rawValue detail) => "1234.56"
|
|
317
|
+
(on-price-change (.-value detail))))}}]
|
|
318
|
+
|
|
319
|
+
;; ty-textarea — same pattern as ty-input but without formatted values
|
|
320
|
+
[:ty-textarea
|
|
321
|
+
{:label "Bio" :rows "4"
|
|
322
|
+
:on {:change (fn [^js e]
|
|
323
|
+
(on-bio-change (-> e .-detail .-value)))}}]
|
|
324
|
+
|
|
325
|
+
;; ty-select — detail.value is the scalar selected value (single select)
|
|
326
|
+
[:ty-select
|
|
327
|
+
{:label "Country"
|
|
328
|
+
:on {:change (fn [^js e]
|
|
329
|
+
(let [^js detail (.-detail e)]
|
|
330
|
+
;; (.-value detail) => "us"
|
|
331
|
+
;; (-> detail .-items (aget 0) .-label) => "United States"
|
|
332
|
+
(on-country-change (.-value detail))))}}
|
|
333
|
+
[:ty-option {:value "us"} "United States"]
|
|
334
|
+
[:ty-option {:value "de"} "Germany"]]
|
|
335
|
+
|
|
336
|
+
;; ty-select multiple — values is a JS array, convert with vec
|
|
337
|
+
[:ty-select
|
|
338
|
+
{:multiple true
|
|
339
|
+
:label "Tags"
|
|
340
|
+
:on {:change (fn [^js e]
|
|
341
|
+
(let [^js detail (.-detail e)
|
|
342
|
+
values (vec (.-values detail)) ; JS array -> CLJ vector
|
|
343
|
+
action (.-action detail)] ; "add", "remove", "clear", "set", "create"
|
|
344
|
+
(on-tags-change values)))}}
|
|
345
|
+
[:ty-option {:value "a"} "Alpha"]
|
|
346
|
+
[:ty-option {:value "b"} "Beta"]]
|
|
347
|
+
|
|
348
|
+
;; ty-checkbox — checked is boolean
|
|
349
|
+
[:ty-checkbox
|
|
350
|
+
{:flavor "primary"
|
|
351
|
+
:on {:change (fn [^js e]
|
|
352
|
+
(let [^js detail (.-detail e)]
|
|
353
|
+
;; (.-checked detail) => true/false
|
|
354
|
+
;; (.-value detail) => "on" (or custom value attr)
|
|
355
|
+
(on-agree-change (.-checked detail))))}}
|
|
356
|
+
"I agree"]
|
|
357
|
+
|
|
358
|
+
;; ty-tabs — activeId is the tab id string
|
|
359
|
+
[:ty-tabs
|
|
360
|
+
{:width "100%" :height "500px"
|
|
361
|
+
;; ty-tabs dispatches `ty-tab-change` (not `change`).
|
|
362
|
+
:on {:ty-tab-change (fn [^js e]
|
|
363
|
+
(let [^js detail (.-detail e)]
|
|
364
|
+
;; (.-activeId detail) => "settings"
|
|
365
|
+
;; (.-previousId detail) => "profile"
|
|
366
|
+
(on-tab-change (.-activeId detail))))}}
|
|
367
|
+
[:ty-tab {:id "profile" :label "Profile"} "..."]
|
|
368
|
+
[:ty-tab {:id "settings" :label "Settings"} "..."]]
|
|
369
|
+
|
|
370
|
+
;; ty-calendar — date fields are numbers
|
|
371
|
+
[:ty-calendar
|
|
372
|
+
{:on {:change (fn [^js e]
|
|
373
|
+
(let [^js detail (.-detail e)]
|
|
374
|
+
;; (.-year detail) => 2026
|
|
375
|
+
;; (.-month detail) => 3
|
|
376
|
+
;; (.-day detail) => 25
|
|
377
|
+
;; (.-action detail) => "select" or "deselect"
|
|
378
|
+
(on-date-select (.-year detail)
|
|
379
|
+
(.-month detail)
|
|
380
|
+
(.-day detail))))}}]
|
|
381
|
+
|
|
382
|
+
;; ty-modal — reason tells you how it was closed
|
|
383
|
+
[:ty-modal
|
|
384
|
+
{:open show?
|
|
385
|
+
:on {:close (fn [^js e]
|
|
386
|
+
(let [^js detail (.-detail e)]
|
|
387
|
+
;; (.-reason detail) => "backdrop", "escape", "method"
|
|
388
|
+
(on-modal-close)))}}
|
|
389
|
+
[:div.p-6 "Modal content"]]
|
|
390
|
+
```
|
|
391
|
+
|
|
392
|
+
---
|
|
393
|
+
|
|
394
|
+
## Icon Usage
|
|
395
|
+
|
|
396
|
+
```clojure
|
|
397
|
+
(ns my-app.icons
|
|
398
|
+
(:require [tyrell.icons :as icons]
|
|
399
|
+
[tyrell.lucide :as lucide]))
|
|
400
|
+
|
|
401
|
+
(icons/register! {:check lucide/check
|
|
402
|
+
:user lucide/user}) ; the key is the name
|
|
403
|
+
```
|
|
404
|
+
|
|
405
|
+
```clojure
|
|
406
|
+
[:ty-icon {:name "check" :size "sm"}]
|
|
407
|
+
|
|
408
|
+
;; in a button: use the slot, not margins
|
|
409
|
+
[:ty-button {:flavor "primary"}
|
|
410
|
+
[:ty-icon {:slot "start" :name "check" :size "sm"}]
|
|
411
|
+
"Save"]
|
|
412
|
+
```
|
|
413
|
+
|
|
414
|
+
If `tyrell.js` loads from a `<script>` after your code, use `icons/register-async!`.
|
|
415
|
+
|
|
416
|
+
Sets, tree-shaking, custom SVGs and troubleshooting: [ICONS_GUIDE.md](../ICONS_GUIDE.md#in-clojure).
|
|
417
|
+
|
|
418
|
+
---
|
|
419
|
+
|
|
420
|
+
## Form Handling
|
|
421
|
+
|
|
422
|
+
### Form Structure
|
|
423
|
+
|
|
424
|
+
Use standard `[:form]` with `:on {:submit ...}` and Tyrell components inside. Each Tyrell form component supports `name`, `label`, `error`, `required`, and `disabled` attributes:
|
|
425
|
+
|
|
426
|
+
```clojure
|
|
427
|
+
[:form.space-y-6
|
|
428
|
+
{:on {:submit (fn [^js e]
|
|
429
|
+
(.preventDefault e)
|
|
430
|
+
(on-submit))}}
|
|
431
|
+
|
|
432
|
+
[:ty-input
|
|
433
|
+
{:type "text"
|
|
434
|
+
:name "fullName"
|
|
435
|
+
:label "Full Name"
|
|
436
|
+
:placeholder "John Doe"
|
|
437
|
+
:required true
|
|
438
|
+
:value name-value
|
|
439
|
+
:error name-error
|
|
440
|
+
:on {:change (fn [^js e] (on-name-change (-> e .-detail .-value)))}}]
|
|
441
|
+
|
|
442
|
+
[:ty-input
|
|
443
|
+
{:type "email"
|
|
444
|
+
:name "email"
|
|
445
|
+
:label "Email Address"
|
|
446
|
+
:required true
|
|
447
|
+
:value email-value
|
|
448
|
+
:error email-error
|
|
449
|
+
:on {:change (fn [^js e] (on-email-change (-> e .-detail .-value)))}}]
|
|
450
|
+
|
|
451
|
+
[:div.flex.gap-3
|
|
452
|
+
[:ty-button {:flavor "primary" :type "submit" :disabled submitting?}
|
|
453
|
+
[:ty-icon {:slot "start" :name "save" :size "sm"}]
|
|
454
|
+
"Submit"]
|
|
455
|
+
|
|
456
|
+
[:ty-button {:flavor "neutral" :type "button"
|
|
457
|
+
:on {:click on-cancel}}
|
|
458
|
+
"Cancel"]]]
|
|
459
|
+
```
|
|
460
|
+
|
|
461
|
+
Key points:
|
|
462
|
+
- `ty-button` with `:type "submit"` triggers form submit
|
|
463
|
+
- `ty-button` with `:type "button"` does **not** trigger form submit
|
|
464
|
+
- `:error` attribute shows built-in error message styling — pass `nil` to hide
|
|
465
|
+
- `:required` adds a visual indicator and form validation
|
|
466
|
+
|
|
467
|
+
### Select with Rich Content
|
|
468
|
+
|
|
469
|
+
A closed single select shows the selected option itself in the field, so rich HTML displays intact, and it adds no child of its own for Replicant to trip over.
|
|
470
|
+
|
|
471
|
+
```clojure
|
|
472
|
+
[:ty-select
|
|
473
|
+
{:label "Select Country"
|
|
474
|
+
:placeholder "Choose a country"
|
|
475
|
+
:value selected-country
|
|
476
|
+
:on {:change (fn [^js e] (on-country-change (-> e .-detail .-value)))}}
|
|
477
|
+
|
|
478
|
+
[:ty-option {:value "us"}
|
|
479
|
+
[:div.flex.items-center.gap-2
|
|
480
|
+
[:div
|
|
481
|
+
[:div.font-medium "United States"]
|
|
482
|
+
[:div.text-xs.ty-text- "North America"]]]]
|
|
483
|
+
|
|
484
|
+
[:ty-option {:value "uk"}
|
|
485
|
+
[:div.flex.items-center.gap-2
|
|
486
|
+
[:div
|
|
487
|
+
[:div.font-medium "United Kingdom"]
|
|
488
|
+
[:div.text-xs.ty-text- "Europe"]]]]]
|
|
489
|
+
```
|
|
490
|
+
|
|
491
|
+
### Multi-select with Chips
|
|
492
|
+
|
|
493
|
+
`ty-select multiple` + `ty-selected-options` — options are `ty-option` children,
|
|
494
|
+
dismissible chips render out-of-band wherever you put them:
|
|
495
|
+
|
|
496
|
+
```clojure
|
|
497
|
+
[:ty-select
|
|
498
|
+
{:multiple true
|
|
499
|
+
:id "skills-select"
|
|
500
|
+
:label "Select Skills"
|
|
501
|
+
:placeholder "Add skills"
|
|
502
|
+
:value (clojure.string/join "," selected-skills)
|
|
503
|
+
:on {:change (fn [^js e] (on-skills-change (vec (-> e .-detail .-values))))}}
|
|
504
|
+
|
|
505
|
+
[:ty-option {:value "clojure" :flavor "primary"} "Clojure"]
|
|
506
|
+
[:ty-option {:value "javascript" :flavor "warning"} "JavaScript"]
|
|
507
|
+
[:ty-option {:value "react" :flavor "neutral"} "React"]]
|
|
508
|
+
|
|
509
|
+
[:div.flex.flex-wrap.gap-2
|
|
510
|
+
[:ty-selected-options {:for "skills-select"}]]
|
|
511
|
+
```
|
|
512
|
+
|
|
513
|
+
---
|
|
514
|
+
|
|
515
|
+
## Tabs Component
|
|
516
|
+
|
|
517
|
+
### Basic Structure
|
|
518
|
+
|
|
519
|
+
```clojure
|
|
520
|
+
[:ty-tabs
|
|
521
|
+
{:width "100%"
|
|
522
|
+
:height "600px"
|
|
523
|
+
:active "general"}
|
|
524
|
+
|
|
525
|
+
[:ty-tab {:id "general" :label "General"}
|
|
526
|
+
[:div.p-6 "General content"]]
|
|
527
|
+
|
|
528
|
+
[:ty-tab {:id "advanced" :label "Advanced"}
|
|
529
|
+
[:div.p-6 "Advanced content"]]]
|
|
530
|
+
```
|
|
531
|
+
|
|
532
|
+
### Rich Labels with Icons
|
|
533
|
+
|
|
534
|
+
```clojure
|
|
535
|
+
[:ty-tabs {:width "800px" :height "500px"}
|
|
536
|
+
|
|
537
|
+
[:span {:slot "label-profile" :class "flex items-center gap-2"}
|
|
538
|
+
[:ty-icon {:name "user" :size "sm"}]
|
|
539
|
+
"Profile"]
|
|
540
|
+
|
|
541
|
+
[:span {:slot "label-notifications" :class "flex items-center gap-2"}
|
|
542
|
+
[:ty-icon {:name "bell" :size "sm"}]
|
|
543
|
+
"Notifications"
|
|
544
|
+
[:span.ty-bg-danger.ty-text-danger++.px-2.py-0.5.rounded-full.text-xs.font-bold "5"]]
|
|
545
|
+
|
|
546
|
+
[:ty-tab {:id "profile"}
|
|
547
|
+
[:div.p-6 "Profile content"]]
|
|
548
|
+
|
|
549
|
+
[:ty-tab {:id "notifications"}
|
|
550
|
+
[:div.p-6 "Notifications content"]]]
|
|
551
|
+
```
|
|
552
|
+
|
|
553
|
+
### Custom Marker
|
|
554
|
+
|
|
555
|
+
```clojure
|
|
556
|
+
;; Pill-style marker
|
|
557
|
+
[:ty-tabs {:width "100%" :height "400px"}
|
|
558
|
+
[:div.ty-bg-primary.rounded-full.shadow-sm {:slot "marker"}]
|
|
559
|
+
[:ty-tab {:id "tab1" :label "Home"}
|
|
560
|
+
[:div.p-6 "Content"]]]
|
|
561
|
+
```
|
|
562
|
+
|
|
563
|
+
### CSS Variables
|
|
564
|
+
|
|
565
|
+
```clojure
|
|
566
|
+
[:ty-tabs
|
|
567
|
+
{:width "100%"
|
|
568
|
+
:height "500px"
|
|
569
|
+
:style {:--ty-tabs-bg "var(--ty-surface-elevated)"
|
|
570
|
+
:--ty-tabs-border-width "0"
|
|
571
|
+
:--ty-tabs-button-padding "8px 16px"
|
|
572
|
+
:--ty-tabs-button-gap "12px"
|
|
573
|
+
:--ty-tabs-button-hover-bg "var(--ty-surface-elevated)"
|
|
574
|
+
:--transition-duration "200ms"}}
|
|
575
|
+
...]
|
|
576
|
+
```
|
|
577
|
+
|
|
578
|
+
### Attributes Reference
|
|
579
|
+
|
|
580
|
+
**ty-tabs:**
|
|
581
|
+
- `width` (required) - Content area width (px or %)
|
|
582
|
+
- `height` (required) - Total container height (px)
|
|
583
|
+
- `active` - ID of initially active tab (defaults to first)
|
|
584
|
+
- `placement` - Tab button position: "top" or "bottom" (default: "top")
|
|
585
|
+
|
|
586
|
+
**ty-tab:**
|
|
587
|
+
- `id` (required) - Unique tab identifier
|
|
588
|
+
- `label` - Simple text label
|
|
589
|
+
- `disabled` - Disable tab interaction (boolean)
|
|
590
|
+
|
|
591
|
+
**Events:**
|
|
592
|
+
- `ty-tab-change` - Fires when the shown tab changes (not for the initial tab)
|
|
593
|
+
- Detail: `{activeId, activeIndex, previousId, previousIndex}`
|
|
594
|
+
|
|
595
|
+
---
|
|
596
|
+
|
|
597
|
+
## Reorderable lists (ty-sortable)
|
|
598
|
+
|
|
599
|
+
`ty-sortable` never moves its children. A drop (or a keyboard move) fires `ty-sortable-change` on the destination list, and the list holds the result on screen until Replicant renders the items in the new order. Give each item `:replicant/key` (so Replicant moves the node) and `:data-key` (or `:id`):
|
|
600
|
+
|
|
601
|
+
```clojure
|
|
602
|
+
(defn move! [^js e]
|
|
603
|
+
(let [value (.. e -detail -value)]
|
|
604
|
+
(swap! store assoc :saving? true)
|
|
605
|
+
(-> (save value)
|
|
606
|
+
(.then #(swap! store update :board merge (js->clj (.-order value))))
|
|
607
|
+
(.finally #(swap! store assoc :saving? false)))))
|
|
608
|
+
|
|
609
|
+
(defn column [{:keys [board saving?]} id label]
|
|
610
|
+
[:ty-sortable {:id id :group "board" :label label
|
|
611
|
+
:aria-busy (when saving? "true")
|
|
612
|
+
:on {:ty-sortable-change move!}}
|
|
613
|
+
(for [k (get board id)]
|
|
614
|
+
[:div {:replicant/key k :data-key k}
|
|
615
|
+
[:button {:type "button" :data-handle "" :aria-label (str "Move " k)}
|
|
616
|
+
[:ty-icon {:name "grip-vertical"}]]
|
|
617
|
+
k])])
|
|
618
|
+
```
|
|
619
|
+
|
|
620
|
+
- `value` is `{key, group, source, from, to, order}`. `order` is the new key order of each list the move touched, by list id, so one `merge` renders both lists. For fractional ranking, save a rank between `(.. value -to -prev)` and `(.. value -to -next)` instead.
|
|
621
|
+
- `:aria-busy` while saving makes a refused save snap back as soon as it clears (the order didn't change). Without it, call `(.settle (.. e -detail -toContainer) "rejected")`, or `(.preventDefault e)` to reject at once.
|
|
622
|
+
- On touch, a `:data-handle` drags at once and leaves the rest of the row to scroll; give it a 44px target. Without a handle the whole item drags after a 250 ms press.
|
|
623
|
+
- Attributes: `group`, `axis`, `handle` (default `[data-handle]`), `accepts`, `disabled`, `key-attr`, `hold-timeout`, `label`. Items: `data-locked`, `data-no-drag`, `data-sortable-ignore`. `(.move el "a" #js {:to "done" :index 0})` moves without a pointer.
|