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,458 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* TySelect Web Component — THE select control (replaces ty-dropdown/ty-multiselect).
|
|
3
|
+
* Cardinality follows native <select>: default single (scalar value, picking closes
|
|
4
|
+
* the popup), `multiple` toggles options and submits repeated `name=` FormData entries.
|
|
5
|
+
* Skins: default form field, `compact` content-hugging trigger, slot="trigger" custom.
|
|
6
|
+
*
|
|
7
|
+
* The selection is the `value` attribute/property, nothing else. Options are a
|
|
8
|
+
* plain list: the select draws their check through `option.checked`, a
|
|
9
|
+
* property, and never writes selection state onto them. A closed single select
|
|
10
|
+
* shows the picked option itself in its trigger (manual slot assignment), so
|
|
11
|
+
* nothing is added to the children a framework renders. `external-selection` hands
|
|
12
|
+
* the selection to the app: it marks the options it holds `selected`, the
|
|
13
|
+
* select reads those marks and reports picks as `change` events.
|
|
14
|
+
*/
|
|
15
|
+
import type { Flavor, Size } from "../types/common.js";
|
|
16
|
+
import { type Placement } from "../utils/positioning.js";
|
|
17
|
+
import { TyComponent } from "../base/ty-component.js";
|
|
18
|
+
import type { PropertyChange } from "../utils/property-manager.js";
|
|
19
|
+
interface TagData {
|
|
20
|
+
value: string;
|
|
21
|
+
text: string;
|
|
22
|
+
element: HTMLElement;
|
|
23
|
+
}
|
|
24
|
+
interface SelectState {
|
|
25
|
+
open: boolean;
|
|
26
|
+
search: string;
|
|
27
|
+
highlightedIndex: number;
|
|
28
|
+
filteredTags: TagData[];
|
|
29
|
+
mode: "desktop" | "mobile";
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Ty Select Component
|
|
33
|
+
*/
|
|
34
|
+
export declare class TySelect extends TyComponent<SelectState> {
|
|
35
|
+
protected static slotAssignment: SlotAssignmentMode;
|
|
36
|
+
protected static properties: {
|
|
37
|
+
value: {
|
|
38
|
+
type: "string";
|
|
39
|
+
visual: boolean;
|
|
40
|
+
formValue: boolean;
|
|
41
|
+
emitChange: boolean;
|
|
42
|
+
default: string;
|
|
43
|
+
coerce: (v: any) => string;
|
|
44
|
+
};
|
|
45
|
+
name: {
|
|
46
|
+
type: "string";
|
|
47
|
+
default: string;
|
|
48
|
+
};
|
|
49
|
+
multiple: {
|
|
50
|
+
type: "boolean";
|
|
51
|
+
visual: boolean;
|
|
52
|
+
default: boolean;
|
|
53
|
+
};
|
|
54
|
+
compact: {
|
|
55
|
+
type: "boolean";
|
|
56
|
+
visual: boolean;
|
|
57
|
+
default: boolean;
|
|
58
|
+
};
|
|
59
|
+
placeholder: {
|
|
60
|
+
type: "string";
|
|
61
|
+
visual: boolean;
|
|
62
|
+
default: string;
|
|
63
|
+
};
|
|
64
|
+
label: {
|
|
65
|
+
type: "string";
|
|
66
|
+
visual: boolean;
|
|
67
|
+
default: string;
|
|
68
|
+
};
|
|
69
|
+
disabled: {
|
|
70
|
+
type: "boolean";
|
|
71
|
+
visual: boolean;
|
|
72
|
+
default: boolean;
|
|
73
|
+
};
|
|
74
|
+
readonly: {
|
|
75
|
+
type: "boolean";
|
|
76
|
+
visual: boolean;
|
|
77
|
+
default: boolean;
|
|
78
|
+
};
|
|
79
|
+
required: {
|
|
80
|
+
type: "boolean";
|
|
81
|
+
visual: boolean;
|
|
82
|
+
default: boolean;
|
|
83
|
+
};
|
|
84
|
+
error: {
|
|
85
|
+
type: "string";
|
|
86
|
+
visual: boolean;
|
|
87
|
+
default: string;
|
|
88
|
+
};
|
|
89
|
+
noClear: {
|
|
90
|
+
type: "boolean";
|
|
91
|
+
visual: boolean;
|
|
92
|
+
default: boolean;
|
|
93
|
+
};
|
|
94
|
+
externalSearch: {
|
|
95
|
+
type: "boolean";
|
|
96
|
+
visual: boolean;
|
|
97
|
+
default: boolean;
|
|
98
|
+
};
|
|
99
|
+
externalSelection: {
|
|
100
|
+
type: "boolean";
|
|
101
|
+
visual: boolean;
|
|
102
|
+
default: boolean;
|
|
103
|
+
};
|
|
104
|
+
allowCreate: {
|
|
105
|
+
type: "boolean";
|
|
106
|
+
visual: boolean;
|
|
107
|
+
default: boolean;
|
|
108
|
+
};
|
|
109
|
+
createTransform: {
|
|
110
|
+
type: "string";
|
|
111
|
+
visual: boolean;
|
|
112
|
+
default: string;
|
|
113
|
+
coerce: (v: any) => "none" | "slug";
|
|
114
|
+
};
|
|
115
|
+
notSearchable: {
|
|
116
|
+
type: "boolean";
|
|
117
|
+
visual: boolean;
|
|
118
|
+
default: boolean;
|
|
119
|
+
};
|
|
120
|
+
placement: {
|
|
121
|
+
type: "string";
|
|
122
|
+
visual: boolean;
|
|
123
|
+
default: string;
|
|
124
|
+
};
|
|
125
|
+
size: {
|
|
126
|
+
type: "string";
|
|
127
|
+
visual: boolean;
|
|
128
|
+
default: Size;
|
|
129
|
+
validate: (v: any) => boolean;
|
|
130
|
+
coerce: (v: any) => any;
|
|
131
|
+
};
|
|
132
|
+
debounce: {
|
|
133
|
+
type: "number";
|
|
134
|
+
default: number;
|
|
135
|
+
validate: (v: any) => boolean;
|
|
136
|
+
coerce: (v: any) => number;
|
|
137
|
+
};
|
|
138
|
+
"available-label": {
|
|
139
|
+
type: "string";
|
|
140
|
+
visual: boolean;
|
|
141
|
+
default: string;
|
|
142
|
+
};
|
|
143
|
+
"selected-label": {
|
|
144
|
+
type: "string";
|
|
145
|
+
visual: boolean;
|
|
146
|
+
default: string;
|
|
147
|
+
};
|
|
148
|
+
"no-options-message": {
|
|
149
|
+
type: "string";
|
|
150
|
+
visual: boolean;
|
|
151
|
+
default: string;
|
|
152
|
+
};
|
|
153
|
+
loading: {
|
|
154
|
+
type: "boolean";
|
|
155
|
+
visual: boolean;
|
|
156
|
+
default: boolean;
|
|
157
|
+
};
|
|
158
|
+
flavor: {
|
|
159
|
+
type: "string";
|
|
160
|
+
visual: boolean;
|
|
161
|
+
default: string;
|
|
162
|
+
};
|
|
163
|
+
};
|
|
164
|
+
private readonly _uid;
|
|
165
|
+
private _state;
|
|
166
|
+
private _scrollLockId;
|
|
167
|
+
private _keyboardHandler;
|
|
168
|
+
private _searchDebounceTimer;
|
|
169
|
+
private _optionsScrollbar;
|
|
170
|
+
private _childObserver;
|
|
171
|
+
private _customFlavorSheet;
|
|
172
|
+
private _ariaTrigger;
|
|
173
|
+
private _ariaObserver;
|
|
174
|
+
private _triggerTextObserver;
|
|
175
|
+
constructor();
|
|
176
|
+
/** TyComponent renders right after this on the first connect. */
|
|
177
|
+
protected onConnect(): void;
|
|
178
|
+
/** Custom (non-built-in) flavors — see utils/flavor-sheet.ts. */
|
|
179
|
+
private _syncCustomFlavor;
|
|
180
|
+
protected onDisconnect(): void;
|
|
181
|
+
/** Handle state synchronization BEFORE render. */
|
|
182
|
+
protected onPropertiesChanged(changes: PropertyChange[]): void;
|
|
183
|
+
/**
|
|
184
|
+
* Toggle the loading visual state on the open popup: a centered spinner in
|
|
185
|
+
* place of the options; the search input stays usable. Reads the loader
|
|
186
|
+
* registry each time, so a newly registered loader shows next time.
|
|
187
|
+
*/
|
|
188
|
+
private applyLoadingState;
|
|
189
|
+
/** Form value: a plain entry for single, FormData with repeated entries for multiple (HTMX standard). */
|
|
190
|
+
protected getFormValue(): FormDataEntryValue | FormData | null;
|
|
191
|
+
/**
|
|
192
|
+
* Focus the trigger: a slotted one, else the field. The host itself isn't
|
|
193
|
+
* focusable. A slotted trigger that can't take focus (a <span>, a disabled
|
|
194
|
+
* button) leaves it to the field.
|
|
195
|
+
*/
|
|
196
|
+
focus(options?: FocusOptions): void;
|
|
197
|
+
private parseValue;
|
|
198
|
+
/** The selection: the `value` property. external-selection holds none. */
|
|
199
|
+
private getSelectedValues;
|
|
200
|
+
private getTagElements;
|
|
201
|
+
/**
|
|
202
|
+
* The options on offer: all but the ones the author hid (`hidden`, like a
|
|
203
|
+
* native <option hidden>). The search filters these and the keyboard walks
|
|
204
|
+
* them; a hidden option can still be the value.
|
|
205
|
+
*/
|
|
206
|
+
private getOfferedTags;
|
|
207
|
+
private getTagData;
|
|
208
|
+
private findOption;
|
|
209
|
+
/** Draw each option's check from the selection (or, external, the app's marks). */
|
|
210
|
+
private paintOptions;
|
|
211
|
+
/**
|
|
212
|
+
* The option the trigger shows: single select, list closed, the picked
|
|
213
|
+
* option — if it is a direct child (only those can be slotted).
|
|
214
|
+
*/
|
|
215
|
+
private shownOption;
|
|
216
|
+
/**
|
|
217
|
+
* Every child goes to the slot it asks for, the rest to the list — except
|
|
218
|
+
* the option the trigger shows. The real node: page CSS styles it, and the
|
|
219
|
+
* children a framework rendered stay exactly its own.
|
|
220
|
+
*/
|
|
221
|
+
private assignSlots;
|
|
222
|
+
/** What the trigger shows, and where every child is slotted. */
|
|
223
|
+
private syncTrigger;
|
|
224
|
+
/** Set the selection; with `dispatchChange`, also fire `change` (a user action). */
|
|
225
|
+
private updateComponentValue;
|
|
226
|
+
/** Rich item info for values, read off the matching options. */
|
|
227
|
+
private getSelectedItems;
|
|
228
|
+
private calculatePosition;
|
|
229
|
+
private _setupOptionsScrollbar;
|
|
230
|
+
private _destroyOptionsScrollbar;
|
|
231
|
+
/** Open the popup (desktop dropdown or mobile full-screen dialog). */
|
|
232
|
+
private open;
|
|
233
|
+
private close;
|
|
234
|
+
/**
|
|
235
|
+
* `<dialog>.showModal()` puts the popup in the top layer but does NOT stop
|
|
236
|
+
* the page behind it from scrolling: the shared scroll lock does.
|
|
237
|
+
*/
|
|
238
|
+
private lockPageScroll;
|
|
239
|
+
private unlockPageScroll;
|
|
240
|
+
private setExpanded;
|
|
241
|
+
private openDropdown;
|
|
242
|
+
private closeDropdown;
|
|
243
|
+
private openMobileModal;
|
|
244
|
+
private closeMobileModal;
|
|
245
|
+
/**
|
|
246
|
+
* On close: empty the search box and show every option again. With
|
|
247
|
+
* external-search the app filters, so it gets an empty `search` instead
|
|
248
|
+
* (right away, not debounced: its list should be reset before a reopen).
|
|
249
|
+
*/
|
|
250
|
+
private resetSearch;
|
|
251
|
+
private handleStubClick;
|
|
252
|
+
/**
|
|
253
|
+
* .select-clear click — must stop propagation before it bubbles to the
|
|
254
|
+
* stub's own click handler (which would otherwise also open the dropdown).
|
|
255
|
+
*/
|
|
256
|
+
private handleClearClick;
|
|
257
|
+
/**
|
|
258
|
+
* Keyboard-open the closed stub: it is a div with tabindex="0", so
|
|
259
|
+
* Enter/Space don't click it. handleKeyboard takes over once open.
|
|
260
|
+
*/
|
|
261
|
+
private handleStubKeydown;
|
|
262
|
+
private handleTagClick;
|
|
263
|
+
/** Pick an option: click, Enter on a highlighted one, allow-create's exact match. */
|
|
264
|
+
private selectByTag;
|
|
265
|
+
/**
|
|
266
|
+
* allow-create: Enter with unmatched search text mints a new option.
|
|
267
|
+
* Returns true if it handled the key (created, or selected an existing
|
|
268
|
+
* exact match instead of duplicating) — false if there's nothing to do
|
|
269
|
+
* (blank query, or allow-create is off), so the caller's normal Enter
|
|
270
|
+
* handling (select highlighted, or no-op) proceeds.
|
|
271
|
+
*/
|
|
272
|
+
private tryCreateFromSearch;
|
|
273
|
+
/**
|
|
274
|
+
* Multiple + allow-create: clear the search box and show the full (now
|
|
275
|
+
* longer) list, so the next tag can be typed right away.
|
|
276
|
+
*/
|
|
277
|
+
private clearSearchAfterCreate;
|
|
278
|
+
private searchInput;
|
|
279
|
+
private handleSearchInput;
|
|
280
|
+
private handleKeyboard;
|
|
281
|
+
/**
|
|
282
|
+
* Next tag index in `direction` (-1/1) that a click would accept, wrapping
|
|
283
|
+
* around: not disabled, and not out of sight (`tags` is the list as it was
|
|
284
|
+
* offered; an option can get `hidden` while open, by a server patch).
|
|
285
|
+
* -1 if there is none.
|
|
286
|
+
*/
|
|
287
|
+
private nextEnabledTagIndex;
|
|
288
|
+
private filterTags;
|
|
289
|
+
/**
|
|
290
|
+
* Search filtering marks the options it leaves out `filtered-out`, never
|
|
291
|
+
* `hidden`: that one is the author's (see getOfferedTags).
|
|
292
|
+
*/
|
|
293
|
+
private updateTagVisibility;
|
|
294
|
+
private updateOptionsVisibility;
|
|
295
|
+
private clearHighlights;
|
|
296
|
+
private highlightTag;
|
|
297
|
+
/** external-search: fire `search`, after `debounce` ms when set. */
|
|
298
|
+
private dispatchSearchEvent;
|
|
299
|
+
private fireSearchEvent;
|
|
300
|
+
/**
|
|
301
|
+
* Popup lifecycle events. They do NOT bubble, like native <dialog>
|
|
302
|
+
* open/close: a bubbling `close` from a select in a ty-modal would close
|
|
303
|
+
* the modal. On open, external-search also gets an empty `search`, a hook
|
|
304
|
+
* to reset or refetch the list.
|
|
305
|
+
*/
|
|
306
|
+
private fireOpenEvent;
|
|
307
|
+
private fireCloseEvent;
|
|
308
|
+
private dispatchChangeEvent;
|
|
309
|
+
/** One sync of everything the state shows; idempotent. */
|
|
310
|
+
protected render(): void;
|
|
311
|
+
/**
|
|
312
|
+
* The options changed while the list is open (a morph, an external-search
|
|
313
|
+
* swap): filter the new ones by the query (a morph also strips the marks
|
|
314
|
+
* of the old filter), and let the keyboard walk them, not the old ones.
|
|
315
|
+
*/
|
|
316
|
+
private refreshOpenList;
|
|
317
|
+
/**
|
|
318
|
+
* Patch label, required marker and disabled/compact state onto the
|
|
319
|
+
* already-built shadow DOM (build() writes the markup once).
|
|
320
|
+
*/
|
|
321
|
+
private syncFieldChrome;
|
|
322
|
+
/**
|
|
323
|
+
* A slotted trigger is what takes focus (focus()), so it carries the error
|
|
324
|
+
* state too. aria-describedby can't reach into our shadow root from the
|
|
325
|
+
* light DOM: the message goes in aria-description instead. The trigger is
|
|
326
|
+
* the author's markup, so a morph can strip these while the error stays:
|
|
327
|
+
* a watch on them puts them back. Writes only on a real change, or the
|
|
328
|
+
* watch would feed itself.
|
|
329
|
+
*/
|
|
330
|
+
private syncTriggerAria;
|
|
331
|
+
/**
|
|
332
|
+
* Reflect constraint validation to the owning <form> via ElementInternals:
|
|
333
|
+
* empty + required => valueMissing, with a native <select>'s message.
|
|
334
|
+
* Disabled fields, and external-selection (the app holds the selection),
|
|
335
|
+
* are barred from it.
|
|
336
|
+
*/
|
|
337
|
+
private updateValidity;
|
|
338
|
+
/**
|
|
339
|
+
* A slotted trigger (slot="trigger") replaces the field chrome. has-trigger
|
|
340
|
+
* on the host sizes it to the trigger (Blink can't parse :has() inside
|
|
341
|
+
* :host()); render() puts it back if a morph strips it.
|
|
342
|
+
*/
|
|
343
|
+
private syncTriggerSlot;
|
|
344
|
+
private slottedTrigger;
|
|
345
|
+
private triggerTakesFocus;
|
|
346
|
+
/** The element a slotted trigger takes focus on, which is where its ARIA must go; null if it can't. */
|
|
347
|
+
private triggerAriaTarget;
|
|
348
|
+
/**
|
|
349
|
+
* Name the control after the select's label and what the trigger shows:
|
|
350
|
+
* "Sort: Newest". An aria-label the author put there wins. A trigger that
|
|
351
|
+
* can't take focus leaves the stub as the control: without a label it is
|
|
352
|
+
* named after the trigger's text.
|
|
353
|
+
*/
|
|
354
|
+
private syncTriggerName;
|
|
355
|
+
/**
|
|
356
|
+
* Build the shadow DOM once. Mobile (touch, narrow) gets a full-screen
|
|
357
|
+
* dialog with a selected strip; desktop an anchored dropdown. The mode is
|
|
358
|
+
* fixed here: everything wired below belongs to one of them.
|
|
359
|
+
*/
|
|
360
|
+
private build;
|
|
361
|
+
/**
|
|
362
|
+
* The dialog was closed by someone else — a ty-modal around this select
|
|
363
|
+
* closes the dialogs still open inside it. Run our own close too, so the
|
|
364
|
+
* open state, aria-expanded and the scroll lock follow. Watches the `open`
|
|
365
|
+
* attribute rather than the `close` event: that one comes a task later,
|
|
366
|
+
* so right after modal.hide() the stub would still say expanded. Our own
|
|
367
|
+
* close() calls land here with the state already closed, and a dialog
|
|
368
|
+
* reopened since then is open again: both are no-ops.
|
|
369
|
+
*/
|
|
370
|
+
private syncOnOutsideClose;
|
|
371
|
+
private updateMobileSelectedState;
|
|
372
|
+
/** "Label (n)" with the count in its own muted span. */
|
|
373
|
+
private setMobileSectionTitle;
|
|
374
|
+
/**
|
|
375
|
+
* Hand the dialog's spare height to one section: a phone has no room for
|
|
376
|
+
* two usefully tall lists. Selecting from the list hands it back to
|
|
377
|
+
* "available".
|
|
378
|
+
*/
|
|
379
|
+
private expandMobileSection;
|
|
380
|
+
/**
|
|
381
|
+
* The selected values as dismissible chips, pinned above the available
|
|
382
|
+
* list so a long list can never scroll the current selection out of sight.
|
|
383
|
+
* Rebuilt wholesale: the strip is small.
|
|
384
|
+
*/
|
|
385
|
+
private renderMobileSelectedChips;
|
|
386
|
+
/**
|
|
387
|
+
* Should the popup show a search row? external-search/allow-create pin it
|
|
388
|
+
* on (the input is the only way to get a query out at all), not-searchable
|
|
389
|
+
* forces it off, and otherwise it follows the list: shown once there are
|
|
390
|
+
* more options than fit without scrolling.
|
|
391
|
+
*/
|
|
392
|
+
private shouldShowSearch;
|
|
393
|
+
/** Toggle the search row (desktop header / mobile input) per shouldShowSearch. */
|
|
394
|
+
private updateSearchVisibility;
|
|
395
|
+
/**
|
|
396
|
+
* The trigger, list closed:
|
|
397
|
+
* - single: the picked option itself (`shown`), else its label, else the placeholder
|
|
398
|
+
* - multiple + field: the labels, comma-joined (ellipsis via CSS)
|
|
399
|
+
* - multiple + compact: placeholder + count badge
|
|
400
|
+
* Open, the list shows what is picked: the trigger shows the placeholder.
|
|
401
|
+
*/
|
|
402
|
+
private updateSelectionDisplay;
|
|
403
|
+
/**
|
|
404
|
+
* Deselect a value WITH a change event, like a pick in the popup (HTMX
|
|
405
|
+
* hx-trigger="change" etc.). Used by ty-selected-options chips.
|
|
406
|
+
*/
|
|
407
|
+
deselectValue(value: string): void;
|
|
408
|
+
/**
|
|
409
|
+
* Clear the selection WITH a change event (action: 'clear'), for a custom
|
|
410
|
+
* trigger's own clear control. Shows no validation message (a code reset
|
|
411
|
+
* after a save shouldn't flag the field); the built-in × does.
|
|
412
|
+
*/
|
|
413
|
+
clear(): void;
|
|
414
|
+
get value(): string;
|
|
415
|
+
set value(val: string);
|
|
416
|
+
get name(): string;
|
|
417
|
+
set name(val: string);
|
|
418
|
+
get multiple(): boolean;
|
|
419
|
+
set multiple(value: boolean);
|
|
420
|
+
get compact(): boolean;
|
|
421
|
+
set compact(value: boolean);
|
|
422
|
+
get placeholder(): string;
|
|
423
|
+
set placeholder(val: string);
|
|
424
|
+
get label(): string;
|
|
425
|
+
set label(val: string);
|
|
426
|
+
get disabled(): boolean;
|
|
427
|
+
set disabled(value: boolean);
|
|
428
|
+
get loading(): boolean;
|
|
429
|
+
set loading(value: boolean);
|
|
430
|
+
get readonly(): boolean;
|
|
431
|
+
set readonly(value: boolean);
|
|
432
|
+
get noClear(): boolean;
|
|
433
|
+
set noClear(value: boolean);
|
|
434
|
+
get required(): boolean;
|
|
435
|
+
set required(value: boolean);
|
|
436
|
+
get error(): string;
|
|
437
|
+
set error(value: string);
|
|
438
|
+
get notSearchable(): boolean;
|
|
439
|
+
set notSearchable(value: boolean);
|
|
440
|
+
get externalSearch(): boolean;
|
|
441
|
+
set externalSearch(value: boolean);
|
|
442
|
+
get externalSelection(): boolean;
|
|
443
|
+
set externalSelection(value: boolean);
|
|
444
|
+
get allowCreate(): boolean;
|
|
445
|
+
set allowCreate(value: boolean);
|
|
446
|
+
get createTransform(): "none" | "slug";
|
|
447
|
+
set createTransform(value: "none" | "slug");
|
|
448
|
+
get debounce(): number;
|
|
449
|
+
set debounce(value: number | string);
|
|
450
|
+
get size(): Size;
|
|
451
|
+
set size(value: Size);
|
|
452
|
+
get placement(): Placement | "";
|
|
453
|
+
set placement(value: Placement | "");
|
|
454
|
+
get flavor(): Flavor;
|
|
455
|
+
set flavor(value: Flavor);
|
|
456
|
+
get form(): HTMLFormElement | null;
|
|
457
|
+
}
|
|
458
|
+
export {};
|