tyrell-components 1.0.0-TC9 → 1.0.0-rc.21
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 +1531 -0
- package/README.md +71 -53
- 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 +935 -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 +446 -0
- package/lib/components/select.js +1381 -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 +747 -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 +62 -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
package/lib/utils/locale.js
CHANGED
|
@@ -1,213 +1,38 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Locale Resolution Utilities
|
|
3
|
-
*
|
|
4
|
-
* Provides a cascade system for resolving locale/language preferences:
|
|
5
|
-
* 1. Component's explicit `locale` attribute (highest priority)
|
|
6
|
-
* 2. Closest ancestor's `lang` attribute
|
|
7
|
-
* 3. Document root's `lang` attribute
|
|
8
|
-
* 4. Browser's language preference
|
|
9
|
-
* 5. 'en-US' fallback (lowest priority)
|
|
10
|
-
*
|
|
11
|
-
* This allows developers to set locale at any level:
|
|
12
|
-
* - Per-component: <ty-input locale="fr-FR">
|
|
13
|
-
* - Per-section: <div lang="de-DE"><ty-input></ty-input></div>
|
|
14
|
-
* - Per-page: <html lang="es-ES">
|
|
15
|
-
* - Browser default: Uses navigator.language
|
|
16
|
-
*
|
|
17
|
-
* @example
|
|
18
|
-
* ```typescript
|
|
19
|
-
* // In a component
|
|
20
|
-
* class TyInput extends HTMLElement {
|
|
21
|
-
* get locale(): string {
|
|
22
|
-
* return getEffectiveLocale(this, this.getAttribute('locale'));
|
|
23
|
-
* }
|
|
24
|
-
* }
|
|
25
|
-
* ```
|
|
26
|
-
*/
|
|
27
|
-
/**
|
|
28
|
-
* Get the effective locale for an element using the resolution cascade.
|
|
29
|
-
*
|
|
30
|
-
* Resolution order:
|
|
31
|
-
* 1. Explicit locale attribute on the element
|
|
32
|
-
* 2. Closest ancestor element with a `lang` attribute
|
|
33
|
-
* 3. Document root element's `lang` attribute
|
|
34
|
-
* 4. Browser's navigator.language
|
|
35
|
-
* 5. Fallback to 'en-US'
|
|
36
|
-
*
|
|
37
|
-
* @param element - The element to get locale for
|
|
38
|
-
* @param explicitLocale - Optional explicit locale value (from component's locale attribute)
|
|
39
|
-
* @returns The resolved locale string (e.g., 'en-US', 'fr-FR')
|
|
40
|
-
*
|
|
41
|
-
* @example
|
|
42
|
-
* ```html
|
|
43
|
-
* <html lang="en-US">
|
|
44
|
-
* <div lang="fr-FR">
|
|
45
|
-
* <ty-input></ty-input> <!-- Uses 'fr-FR' -->
|
|
46
|
-
* <ty-input locale="de-DE"></ty-input> <!-- Uses 'de-DE' -->
|
|
47
|
-
* </div>
|
|
48
|
-
* <ty-input></ty-input> <!-- Uses 'en-US' -->
|
|
49
|
-
* </html>
|
|
50
|
-
* ```
|
|
51
|
-
*/
|
|
52
1
|
export function getEffectiveLocale(element, explicitLocale) {
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
return explicitLocale;
|
|
56
|
-
}
|
|
57
|
-
// 2. Check closest ancestor with lang attribute
|
|
58
|
-
// This allows per-section locale overrides
|
|
59
|
-
const langElement = element.closest('[lang]');
|
|
60
|
-
if (langElement) {
|
|
61
|
-
const lang = langElement.getAttribute('lang');
|
|
62
|
-
if (lang)
|
|
63
|
-
return lang;
|
|
64
|
-
}
|
|
65
|
-
// 3. Check document root (html element)
|
|
66
|
-
if (document.documentElement.lang) {
|
|
67
|
-
return document.documentElement.lang;
|
|
68
|
-
}
|
|
69
|
-
// 4. Use browser's language preference
|
|
70
|
-
if (navigator.language) {
|
|
71
|
-
return navigator.language;
|
|
72
|
-
}
|
|
73
|
-
// 5. Ultimate fallback
|
|
74
|
-
return 'en-US';
|
|
2
|
+
if (explicitLocale) {
|
|
3
|
+
return explicitLocale;
|
|
75
4
|
}
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
* @returns Normalized locale string
|
|
82
|
-
*
|
|
83
|
-
* @example
|
|
84
|
-
* ```typescript
|
|
85
|
-
* normalizeLocale('en') // 'en'
|
|
86
|
-
* normalizeLocale('en_US') // 'en-US'
|
|
87
|
-
* normalizeLocale('EN-us') // 'en-US'
|
|
88
|
-
* ```
|
|
89
|
-
*/
|
|
90
|
-
export function normalizeLocale(locale) {
|
|
91
|
-
if (!locale)
|
|
92
|
-
return 'en-US';
|
|
93
|
-
// Replace underscores with hyphens (en_US -> en-US)
|
|
94
|
-
let normalized = locale.replace(/_/g, '-');
|
|
95
|
-
// Split into parts
|
|
96
|
-
const parts = normalized.split('-');
|
|
97
|
-
if (parts.length === 0)
|
|
98
|
-
return 'en-US';
|
|
99
|
-
// Lowercase language code (EN -> en)
|
|
100
|
-
parts[0] = parts[0].toLowerCase();
|
|
101
|
-
// Uppercase country code if present (us -> US)
|
|
102
|
-
if (parts.length > 1) {
|
|
103
|
-
parts[1] = parts[1].toUpperCase();
|
|
104
|
-
}
|
|
105
|
-
return parts.join('-');
|
|
5
|
+
const langElement = element.closest('[lang]');
|
|
6
|
+
if (langElement) {
|
|
7
|
+
const lang = langElement.getAttribute('lang');
|
|
8
|
+
if (lang)
|
|
9
|
+
return lang;
|
|
106
10
|
}
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
*
|
|
110
|
-
* @param locale - The locale string to validate
|
|
111
|
-
* @returns true if valid, false otherwise
|
|
112
|
-
*
|
|
113
|
-
* @example
|
|
114
|
-
* ```typescript
|
|
115
|
-
* isValidLocale('en-US') // true
|
|
116
|
-
* isValidLocale('fr') // true
|
|
117
|
-
* isValidLocale('invalid!') // false
|
|
118
|
-
* ```
|
|
119
|
-
*/
|
|
120
|
-
export function isValidLocale(locale) {
|
|
121
|
-
if (!locale)
|
|
122
|
-
return false;
|
|
123
|
-
// BCP 47 language tag pattern
|
|
124
|
-
// Simplified: allows language-region format
|
|
125
|
-
const pattern = /^[a-z]{2,3}(-[A-Z]{2})?$/;
|
|
126
|
-
return pattern.test(locale);
|
|
11
|
+
if (document.documentElement.lang) {
|
|
12
|
+
return document.documentElement.lang;
|
|
127
13
|
}
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
*
|
|
131
|
-
* @param locale - The locale string
|
|
132
|
-
* @returns The language code
|
|
133
|
-
*
|
|
134
|
-
* @example
|
|
135
|
-
* ```typescript
|
|
136
|
-
* getLanguageCode('en-US') // 'en'
|
|
137
|
-
* getLanguageCode('fr-FR') // 'fr'
|
|
138
|
-
* getLanguageCode('de') // 'de'
|
|
139
|
-
* ```
|
|
140
|
-
*/
|
|
141
|
-
export function getLanguageCode(locale) {
|
|
142
|
-
if (!locale)
|
|
143
|
-
return 'en';
|
|
144
|
-
return locale.split('-')[0].toLowerCase();
|
|
14
|
+
if (navigator.language) {
|
|
15
|
+
return navigator.language;
|
|
145
16
|
}
|
|
146
|
-
|
|
147
|
-
* Get the region/country code from a locale (e.g., 'US' from 'en-US').
|
|
148
|
-
*
|
|
149
|
-
* @param locale - The locale string
|
|
150
|
-
* @returns The region code, or undefined if not present
|
|
151
|
-
*
|
|
152
|
-
* @example
|
|
153
|
-
* ```typescript
|
|
154
|
-
* getRegionCode('en-US') // 'US'
|
|
155
|
-
* getRegionCode('fr-FR') // 'FR'
|
|
156
|
-
* getRegionCode('de') // undefined
|
|
157
|
-
* ```
|
|
158
|
-
*/
|
|
159
|
-
export function getRegionCode(locale) {
|
|
160
|
-
if (!locale)
|
|
161
|
-
return undefined;
|
|
162
|
-
const parts = locale.split('-');
|
|
163
|
-
return parts.length > 1 ? parts[1].toUpperCase() : undefined;
|
|
17
|
+
return 'en-US';
|
|
164
18
|
}
|
|
165
|
-
/**
|
|
166
|
-
* Create a MutationObserver to watch for lang attribute changes.
|
|
167
|
-
* Useful for components that need to react to dynamic locale changes.
|
|
168
|
-
*
|
|
169
|
-
* @param element - The element to observe
|
|
170
|
-
* @param callback - Function to call when lang changes
|
|
171
|
-
* @returns Cleanup function to disconnect the observer
|
|
172
|
-
*
|
|
173
|
-
* @example
|
|
174
|
-
* ```typescript
|
|
175
|
-
* class TyInput extends HTMLElement {
|
|
176
|
-
* private _localeObserver?: () => void;
|
|
177
|
-
*
|
|
178
|
-
* connectedCallback() {
|
|
179
|
-
* this._localeObserver = observeLocaleChanges(this, () => {
|
|
180
|
-
* this.render(); // Re-render when locale changes
|
|
181
|
-
* });
|
|
182
|
-
* }
|
|
183
|
-
*
|
|
184
|
-
* disconnectedCallback() {
|
|
185
|
-
* this._localeObserver?.();
|
|
186
|
-
* }
|
|
187
|
-
* }
|
|
188
|
-
* ```
|
|
189
|
-
*/
|
|
190
19
|
export function observeLocaleChanges(element, callback) {
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
});
|
|
210
|
-
// Return cleanup function
|
|
211
|
-
return () => observer.disconnect();
|
|
20
|
+
let currentLocale = getEffectiveLocale(element);
|
|
21
|
+
const observer = new MutationObserver((mutations) => {
|
|
22
|
+
for (const mutation of mutations) {
|
|
23
|
+
if (mutation.type === 'attributes' && mutation.attributeName === 'lang') {
|
|
24
|
+
const newLocale = getEffectiveLocale(element);
|
|
25
|
+
if (newLocale !== currentLocale) {
|
|
26
|
+
currentLocale = newLocale;
|
|
27
|
+
callback(newLocale);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
});
|
|
32
|
+
observer.observe(document.documentElement, {
|
|
33
|
+
attributes: true,
|
|
34
|
+
attributeFilter: ['lang'],
|
|
35
|
+
subtree: true
|
|
36
|
+
});
|
|
37
|
+
return () => observer.disconnect();
|
|
212
38
|
}
|
|
213
|
-
//# sourceMappingURL=locale.js.map
|
package/lib/utils/mobile.d.ts
CHANGED
package/lib/utils/mobile.js
CHANGED
|
@@ -1,21 +1,4 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Mobile detection utility
|
|
3
|
-
*
|
|
4
|
-
* Uses CSS media query via matchMedia for reliable detection:
|
|
5
|
-
* - `pointer: coarse` identifies touch-primary devices (not laptops with touchscreens)
|
|
6
|
-
* - Breakpoint is evaluated by the browser, always in sync with CSS
|
|
7
|
-
* - Called on each use (not cached), so it responds to viewport changes and rotation
|
|
8
|
-
*/
|
|
9
|
-
/**
|
|
10
|
-
* Default mobile breakpoint (px).
|
|
11
|
-
* Matches phones in portrait and most phones in landscape.
|
|
12
|
-
*/
|
|
13
1
|
const MOBILE_BREAKPOINT = 768;
|
|
14
|
-
/**
|
|
15
|
-
* Detect mobile touch devices.
|
|
16
|
-
* Returns true when the primary pointer is coarse (touch) AND viewport is narrow.
|
|
17
|
-
*/
|
|
18
2
|
export function isMobileTouch(breakpoint = MOBILE_BREAKPOINT) {
|
|
19
|
-
|
|
3
|
+
return window.matchMedia(`(pointer: coarse) and (max-width: ${breakpoint}px)`).matches;
|
|
20
4
|
}
|
|
21
|
-
//# sourceMappingURL=mobile.js.map
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Number Formatting Utilities
|
|
3
|
-
* PORTED FROM: clj/ty/i18n/number.cljs
|
|
4
3
|
*
|
|
5
4
|
* Uses native Intl.NumberFormat for locale-aware number formatting
|
|
6
5
|
* Supports currency, percent, compact notation, and custom precision
|
|
@@ -34,6 +33,10 @@ export declare function formatNumber(value: number, config: FormatConfig): strin
|
|
|
34
33
|
* Simple rule: the last occurring . or , is the decimal separator.
|
|
35
34
|
* Everything else is stripped. This works for both US (1,234.56) and
|
|
36
35
|
* European (1.234,56) input, and for mobile keyboards that use , as decimal.
|
|
36
|
+
* One grouping exception: a repeated separator ("1.234.567") can't be a
|
|
37
|
+
* decimal point, so it's stripped as thousands grouping. A LONE separator is
|
|
38
|
+
* always decimal — "$1,234" pasted from formatted text parses as 1.234; this
|
|
39
|
+
* known ambiguity is resolved in favor of typed input ("12,50" → 12.5).
|
|
37
40
|
*
|
|
38
41
|
* @example
|
|
39
42
|
* ```typescript
|
|
@@ -42,7 +45,8 @@ export declare function formatNumber(value: number, config: FormatConfig): strin
|
|
|
42
45
|
* parseNumericValue("12,50") // 12.5 (last separator is ,)
|
|
43
46
|
* parseNumericValue("12.50") // 12.5 (last separator is .)
|
|
44
47
|
* parseNumericValue("1234") // 1234
|
|
45
|
-
* parseNumericValue("
|
|
48
|
+
* parseNumericValue("1.234.567") // 1234567 (repeated separator = grouping)
|
|
49
|
+
* parseNumericValue("$1,234") // 1.234 (lone separator = decimal; known paste ambiguity)
|
|
46
50
|
* parseNumericValue("15%") // 15
|
|
47
51
|
* parseNumericValue("") // null
|
|
48
52
|
* ```
|
|
@@ -59,25 +63,3 @@ export declare function parseNumericValue(value: string): number | null;
|
|
|
59
63
|
* ```
|
|
60
64
|
*/
|
|
61
65
|
export declare function shouldFormat(type: string): boolean;
|
|
62
|
-
/**
|
|
63
|
-
* Format currency with locale
|
|
64
|
-
* Convenience function for currency formatting
|
|
65
|
-
*/
|
|
66
|
-
export declare function formatCurrency(value: number, currency?: string, locale?: string): string;
|
|
67
|
-
/**
|
|
68
|
-
* Format percent with locale
|
|
69
|
-
* Convenience function for percent formatting
|
|
70
|
-
*
|
|
71
|
-
* Note: Expects value as 0.15 for 15%
|
|
72
|
-
*/
|
|
73
|
-
export declare function formatPercent(value: number, locale?: string, precision?: number): string;
|
|
74
|
-
/**
|
|
75
|
-
* Format compact notation
|
|
76
|
-
* Convenience function for compact formatting
|
|
77
|
-
*
|
|
78
|
-
* @example
|
|
79
|
-
* formatCompact(1234567) // "1.2M"
|
|
80
|
-
* formatCompact(1234) // "1.2K"
|
|
81
|
-
*/
|
|
82
|
-
export declare function formatCompact(value: number, locale?: string): string;
|
|
83
|
-
//# sourceMappingURL=number-format.d.ts.map
|
|
@@ -1,143 +1,60 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Number Formatting Utilities
|
|
3
|
-
* PORTED FROM: clj/ty/i18n/number.cljs
|
|
4
|
-
*
|
|
5
|
-
* Uses native Intl.NumberFormat for locale-aware number formatting
|
|
6
|
-
* Supports currency, percent, compact notation, and custom precision
|
|
7
|
-
*/
|
|
8
|
-
/**
|
|
9
|
-
* Format a number based on configuration
|
|
10
|
-
*
|
|
11
|
-
* @example
|
|
12
|
-
* ```typescript
|
|
13
|
-
* formatNumber(1234.56, { type: 'currency', currency: 'USD', locale: 'en-US' })
|
|
14
|
-
* // Returns: "$1,234.56"
|
|
15
|
-
*
|
|
16
|
-
* formatNumber(0.15, { type: 'percent', precision: 2 })
|
|
17
|
-
* // Returns: "15.00%"
|
|
18
|
-
*
|
|
19
|
-
* formatNumber(1234567, { type: 'compact' })
|
|
20
|
-
* // Returns: "1.2M"
|
|
21
|
-
* ```
|
|
22
|
-
*/
|
|
23
1
|
export function formatNumber(value, config) {
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
options.maximumFractionDigits = precision;
|
|
30
|
-
}
|
|
31
|
-
// Configure based on type
|
|
32
|
-
switch (type) {
|
|
33
|
-
case 'currency':
|
|
34
|
-
options.style = 'currency';
|
|
35
|
-
options.currency = currency;
|
|
36
|
-
break;
|
|
37
|
-
case 'percent':
|
|
38
|
-
options.style = 'percent';
|
|
39
|
-
// Note: Intl.NumberFormat expects decimal (0.15 for 15%)
|
|
40
|
-
// We'll handle the division in the input component
|
|
41
|
-
break;
|
|
42
|
-
case 'compact':
|
|
43
|
-
options.notation = 'compact';
|
|
44
|
-
options.compactDisplay = 'short';
|
|
45
|
-
break;
|
|
46
|
-
case 'number':
|
|
47
|
-
default:
|
|
48
|
-
options.style = 'decimal';
|
|
49
|
-
break;
|
|
50
|
-
}
|
|
51
|
-
const formatter = new Intl.NumberFormat(locale, options);
|
|
52
|
-
const formatted = formatter.format(value);
|
|
53
|
-
// Normalize Unicode spaces for better HTML input compatibility
|
|
54
|
-
// Replace narrow no-break space (U+202F) and thin space (U+2009) with regular non-breaking space (U+00A0)
|
|
55
|
-
// This ensures proper rendering in HTML input elements
|
|
56
|
-
return formatted
|
|
57
|
-
.replace(/\u202F/g, '\u00A0') // Narrow no-break space → non-breaking space
|
|
58
|
-
.replace(/\u2009/g, '\u00A0'); // Thin space → non-breaking space
|
|
2
|
+
const { type, locale = 'en-US', currency = 'USD', precision } = config;
|
|
3
|
+
const options = {};
|
|
4
|
+
if (precision !== undefined) {
|
|
5
|
+
options.minimumFractionDigits = precision;
|
|
6
|
+
options.maximumFractionDigits = precision;
|
|
59
7
|
}
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
* parseNumericValue("") // null
|
|
77
|
-
* ```
|
|
78
|
-
*/
|
|
79
|
-
export function parseNumericValue(value) {
|
|
80
|
-
if (!value || value.trim() === '')
|
|
81
|
-
return null;
|
|
82
|
-
// Strip everything except digits, dots, commas, and minus
|
|
83
|
-
let stripped = value
|
|
84
|
-
.replace(/[^\d.,-]/g, '')
|
|
85
|
-
.trim();
|
|
86
|
-
if (stripped === '' || stripped === '-')
|
|
87
|
-
return null;
|
|
88
|
-
// Find the last occurring . or , — that's the decimal separator
|
|
89
|
-
const lastComma = stripped.lastIndexOf(',');
|
|
90
|
-
const lastDot = stripped.lastIndexOf('.');
|
|
91
|
-
const lastSep = Math.max(lastComma, lastDot);
|
|
92
|
-
if (lastSep === -1) {
|
|
93
|
-
// No separators — pure integer
|
|
94
|
-
const parsed = parseFloat(stripped);
|
|
95
|
-
return isNaN(parsed) ? null : parsed;
|
|
96
|
-
}
|
|
97
|
-
// Split at the last separator
|
|
98
|
-
const intPart = stripped.slice(0, lastSep).replace(/[.,]/g, '');
|
|
99
|
-
const decPart = stripped.slice(lastSep + 1);
|
|
100
|
-
const parsed = parseFloat(intPart + '.' + decPart);
|
|
101
|
-
return isNaN(parsed) ? null : parsed;
|
|
8
|
+
switch (type) {
|
|
9
|
+
case 'currency':
|
|
10
|
+
options.style = 'currency';
|
|
11
|
+
options.currency = currency;
|
|
12
|
+
break;
|
|
13
|
+
case 'percent':
|
|
14
|
+
options.style = 'percent';
|
|
15
|
+
break;
|
|
16
|
+
case 'compact':
|
|
17
|
+
options.notation = 'compact';
|
|
18
|
+
options.compactDisplay = 'short';
|
|
19
|
+
break;
|
|
20
|
+
case 'number':
|
|
21
|
+
default:
|
|
22
|
+
options.style = 'decimal';
|
|
23
|
+
break;
|
|
102
24
|
}
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
* shouldFormat('currency') // true
|
|
109
|
-
* shouldFormat('percent') // true
|
|
110
|
-
* shouldFormat('text') // false
|
|
111
|
-
* ```
|
|
112
|
-
*/
|
|
113
|
-
export function shouldFormat(type) {
|
|
114
|
-
return ['number', 'currency', 'percent', 'compact'].includes(type);
|
|
25
|
+
const formatter = new Intl.NumberFormat(locale, options);
|
|
26
|
+
const formatted = formatter.format(value);
|
|
27
|
+
return formatted
|
|
28
|
+
.replace(/\u202F/g, '\u00A0')
|
|
29
|
+
.replace(/\u2009/g, '\u00A0');
|
|
115
30
|
}
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
31
|
+
export function parseNumericValue(value) {
|
|
32
|
+
if (!value || value.trim() === '')
|
|
33
|
+
return null;
|
|
34
|
+
let stripped = value
|
|
35
|
+
.replace(/[^\d.,-]/g, '')
|
|
36
|
+
.trim();
|
|
37
|
+
if (stripped === '' || stripped === '-')
|
|
38
|
+
return null;
|
|
39
|
+
const lastComma = stripped.lastIndexOf(',');
|
|
40
|
+
const lastDot = stripped.lastIndexOf('.');
|
|
41
|
+
const lastSep = Math.max(lastComma, lastDot);
|
|
42
|
+
if (lastSep === -1) {
|
|
43
|
+
const parsed = parseFloat(stripped);
|
|
44
|
+
return isNaN(parsed) ? null : parsed;
|
|
122
45
|
}
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
export function formatPercent(value, locale = 'en-US', precision) {
|
|
130
|
-
return formatNumber(value, { type: 'percent', locale, precision });
|
|
46
|
+
const sepChar = stripped[lastSep];
|
|
47
|
+
const before = stripped.slice(0, lastSep);
|
|
48
|
+
const after = stripped.slice(lastSep + 1);
|
|
49
|
+
if (before.includes(sepChar)) {
|
|
50
|
+
const parsed = parseFloat(stripped.replace(/[.,]/g, ''));
|
|
51
|
+
return isNaN(parsed) ? null : parsed;
|
|
131
52
|
}
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
*/
|
|
140
|
-
export function formatCompact(value, locale = 'en-US') {
|
|
141
|
-
return formatNumber(value, { type: 'compact', locale });
|
|
53
|
+
const intPart = before.replace(/[.,]/g, '');
|
|
54
|
+
const decPart = after;
|
|
55
|
+
const parsed = parseFloat(intPart + '.' + decPart);
|
|
56
|
+
return isNaN(parsed) ? null : parsed;
|
|
57
|
+
}
|
|
58
|
+
export function shouldFormat(type) {
|
|
59
|
+
return ['number', 'currency', 'percent', 'compact'].includes(type);
|
|
142
60
|
}
|
|
143
|
-
//# sourceMappingURL=number-format.js.map
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Core positioning engine for floating elements
|
|
3
|
-
* Adapted from ty.positioning ClojureScript implementation
|
|
4
3
|
*
|
|
5
4
|
* Handles smart positioning of tooltips, dropdowns, popups, and other
|
|
6
5
|
* floating elements relative to anchor elements with automatic overflow
|
|
@@ -13,7 +12,7 @@ export type PlacementOrientation = 'horizontal' | 'vertical';
|
|
|
13
12
|
/**
|
|
14
13
|
* Vertical alignment options
|
|
15
14
|
*/
|
|
16
|
-
export type VerticalAlign = 'top' | 'center' | 'bottom' | 'end';
|
|
15
|
+
export type VerticalAlign = 'top' | 'start' | 'center' | 'bottom' | 'end';
|
|
17
16
|
/**
|
|
18
17
|
* Horizontal alignment options
|
|
19
18
|
*/
|
|
@@ -111,33 +110,84 @@ export declare const placementPreferences: {
|
|
|
111
110
|
tooltip: Placement[];
|
|
112
111
|
dropdown: Placement[];
|
|
113
112
|
};
|
|
113
|
+
/** The four sides a floating element can sit on. */
|
|
114
|
+
export type PlacementSide = 'top' | 'right' | 'bottom' | 'left';
|
|
115
|
+
/** Cross-axis alignment against the anchor. Omitted means centred. */
|
|
116
|
+
export type PlacementAlign = 'start' | 'end';
|
|
117
|
+
/** Split `'left-end'` into `{ side: 'left', align: 'end' }`. */
|
|
118
|
+
export declare function parsePlacement(placement: Placement): {
|
|
119
|
+
side: PlacementSide;
|
|
120
|
+
align?: PlacementAlign;
|
|
121
|
+
};
|
|
114
122
|
/**
|
|
115
|
-
*
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
*
|
|
123
|
+
* Fallback order to try for a requested placement, best-fit first.
|
|
124
|
+
*
|
|
125
|
+
* FLIP BEFORE RE-ALIGN. When a placement overflows it is almost always the
|
|
126
|
+
* SIDE axis that ran out of room, and re-aligning on the same side does not
|
|
127
|
+
* change the fit at all: `bottom-start` and `bottom-end` need identical
|
|
128
|
+
* vertical space. Flipping to the opposite side is the move that actually
|
|
129
|
+
* helps, so the requested alignment is carried across the flip first, and only
|
|
130
|
+
* then do we try other alignments.
|
|
131
|
+
*
|
|
132
|
+
* This also keeps the old hand-written chains intact for the four bare sides —
|
|
133
|
+
* `top` still degrades to `bottom` as its very next candidate, exactly as
|
|
134
|
+
* before aligned placements existed.
|
|
135
|
+
*
|
|
136
|
+
* Callers previously hand-wrote a 4-entry chain per side, which silently
|
|
137
|
+
* dropped every aligned placement onto the default chain.
|
|
120
138
|
*/
|
|
121
|
-
export declare function
|
|
139
|
+
export declare function preferenceChain(placement: Placement): Placement[];
|
|
122
140
|
/**
|
|
123
|
-
*
|
|
124
|
-
*
|
|
125
|
-
|
|
126
|
-
|
|
141
|
+
* Map a `Placement` onto `computeAnchoredPosition`'s inputs, so dropdown-style
|
|
142
|
+
* components (ty-select, ty-date-picker) accept the same `placement` vocabulary
|
|
143
|
+
* as ty-popup / ty-tooltip.
|
|
144
|
+
*
|
|
145
|
+
* Dropdowns only ever live above or below their trigger, so a left/right
|
|
146
|
+
* placement degrades to "auto" side while keeping its alignment. Bare sides
|
|
147
|
+
* default to start-aligned, matching a native <select> and the behaviour these
|
|
148
|
+
* components had before `placement` existed.
|
|
149
|
+
*/
|
|
150
|
+
export declare function placementToAnchored(placement?: Placement | '' | null): {
|
|
151
|
+
side: 'top' | 'bottom' | 'auto';
|
|
152
|
+
align: 'start' | 'center' | 'end';
|
|
153
|
+
};
|
|
127
154
|
/**
|
|
128
155
|
* Find the best position for the floating element
|
|
129
156
|
* Tries all preference placements and returns the one that fits best
|
|
130
157
|
*/
|
|
131
158
|
export declare function findBestPosition(options: PositionOptions): PositionResult;
|
|
132
159
|
/**
|
|
133
|
-
*
|
|
134
|
-
* Continuously monitors and updates position when target or floating element changes
|
|
160
|
+
* Below/above placement for trigger-anchored `<dialog>` popups.
|
|
135
161
|
*
|
|
136
|
-
*
|
|
137
|
-
*
|
|
138
|
-
*
|
|
139
|
-
*
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
162
|
+
* Unlike findBestPosition (12-placement engine for non-modal floats), these
|
|
163
|
+
* popups only ever open below or above their trigger, and their CSS anchors
|
|
164
|
+
* with `top:` when below but `bottom:` when above — so both conventions are
|
|
165
|
+
* returned and the caller picks by `below`.
|
|
166
|
+
*/
|
|
167
|
+
export interface AnchoredPopupOptions {
|
|
168
|
+
anchorRect: DOMRect | ElementRect;
|
|
169
|
+
popupWidth: number;
|
|
170
|
+
popupHeight: number;
|
|
171
|
+
/** Gap between trigger and popup edge (px, default 4) */
|
|
172
|
+
gap?: number;
|
|
173
|
+
/** Minimum distance from viewport edges (px, default 8) */
|
|
174
|
+
padding?: number;
|
|
175
|
+
/** Horizontal anchor edge: trigger's left edge ("start", default), its
|
|
176
|
+
* right edge ("end"), or centred on it. Either way the result is clamped
|
|
177
|
+
* into the viewport, same as before. */
|
|
178
|
+
align?: "start" | "center" | "end";
|
|
179
|
+
/** Preferred vertical side. "auto" (default) keeps the historic behaviour:
|
|
180
|
+
* below when it fits, otherwise whichever side has more room. Naming a
|
|
181
|
+
* side honours it when it fits and still flips rather than clipping. */
|
|
182
|
+
side?: "top" | "bottom" | "auto";
|
|
183
|
+
}
|
|
184
|
+
export interface AnchoredPopupPosition {
|
|
185
|
+
/** Popup left edge, viewport coords, clamped into view */
|
|
186
|
+
x: number;
|
|
187
|
+
/** CSS `top` value when below */
|
|
188
|
+
topY: number;
|
|
189
|
+
/** CSS `bottom` value when above */
|
|
190
|
+
bottomY: number;
|
|
191
|
+
below: boolean;
|
|
192
|
+
}
|
|
193
|
+
export declare function computeAnchoredPosition(o: AnchoredPopupOptions): AnchoredPopupPosition;
|