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
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
/**
|
|
2
|
-
*
|
|
2
|
+
* Page scroll lock, reference-counted so multiple components can lock at once.
|
|
3
3
|
*
|
|
4
|
-
*
|
|
5
|
-
*
|
|
6
|
-
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
4
|
+
* Two parts: overflow: hidden on <html> (the document scroller), and a guard
|
|
5
|
+
* for apps that scroll their own container (a full-height layout with an
|
|
6
|
+
* inner overflow: auto div), which <html> overflow doesn't reach. The guard
|
|
7
|
+
* cancels wheel, touchmove and scroll keys that would scroll anything outside
|
|
8
|
+
* the open dialog they come from (every lock holder is a top-layer <dialog>):
|
|
9
|
+
* scrollers inside the dialog keep working until their edge, nothing chains
|
|
10
|
+
* out of it, and events from the page behind scroll nothing. Keys a control
|
|
11
|
+
* uses itself (text fields, selects, Space on buttons, arrows in widgets) are
|
|
12
|
+
* left alone.
|
|
13
13
|
*/
|
|
14
14
|
declare global {
|
|
15
15
|
interface Window {
|
|
@@ -76,4 +76,3 @@ export declare function getLockState(): Readonly<{
|
|
|
76
76
|
scrollY: number;
|
|
77
77
|
activeLocks: string[];
|
|
78
78
|
}>;
|
|
79
|
-
//# sourceMappingURL=scroll-lock.d.ts.map
|
package/lib/utils/scroll-lock.js
CHANGED
|
@@ -1,197 +1,189 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* CSS-based scroll prevention using position: fixed.
|
|
3
|
-
*
|
|
4
|
-
* Prevents body/page scrolling by temporarily fixing the body position
|
|
5
|
-
* while preserving scroll position. Much more reliable than event prevention.
|
|
6
|
-
*
|
|
7
|
-
* Key benefits:
|
|
8
|
-
* - No event manipulation complexity
|
|
9
|
-
* - No interference with component keyboard navigation
|
|
10
|
-
* - Preserves scroll position perfectly
|
|
11
|
-
* - Standard industry technique
|
|
12
|
-
* - Multiple component support with proper cleanup
|
|
13
|
-
*/
|
|
14
|
-
// ============================================================================
|
|
15
|
-
// Global State Management
|
|
16
|
-
// ============================================================================
|
|
17
1
|
const lockState = {
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
2
|
+
locked: false,
|
|
3
|
+
scrollY: 0,
|
|
4
|
+
activeLocks: new Set(),
|
|
21
5
|
};
|
|
22
|
-
|
|
23
|
-
// DOM Helper Functions
|
|
24
|
-
// ============================================================================
|
|
25
|
-
/**
|
|
26
|
-
* Get the document body element
|
|
27
|
-
*/
|
|
6
|
+
let savedStyle = { overflow: '', paddingRight: '' };
|
|
28
7
|
function getBodyEl() {
|
|
29
|
-
|
|
8
|
+
return document.body;
|
|
30
9
|
}
|
|
31
|
-
/**
|
|
32
|
-
* Get the document element (html)
|
|
33
|
-
*/
|
|
34
10
|
function getDocEl() {
|
|
35
|
-
|
|
11
|
+
return document.documentElement;
|
|
36
12
|
}
|
|
37
|
-
/**
|
|
38
|
-
* Get current vertical scroll position
|
|
39
|
-
*/
|
|
40
13
|
function getScrollY() {
|
|
41
|
-
|
|
14
|
+
return window.scrollY || getDocEl().scrollTop || 0;
|
|
42
15
|
}
|
|
43
|
-
/**
|
|
44
|
-
* Calculate the width of the browser's scrollbar
|
|
45
|
-
*/
|
|
46
16
|
function getScrollbarWidth() {
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
17
|
+
return window.innerWidth - getDocEl().clientWidth;
|
|
18
|
+
}
|
|
19
|
+
const KEY_SCROLL = {
|
|
20
|
+
ArrowDown: ['y', 1], ArrowUp: ['y', -1], PageDown: ['y', 1], PageUp: ['y', -1],
|
|
21
|
+
End: ['y', 1], Home: ['y', -1], ' ': ['y', 1], ArrowRight: ['x', 1], ArrowLeft: ['x', -1],
|
|
22
|
+
};
|
|
23
|
+
const TEXT_INPUT = /^(?:text|search|email|url|tel|password|number|date|datetime-local|month|week|time|range|color)$/;
|
|
24
|
+
function keyBelongsTo(el, key) {
|
|
25
|
+
if (el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement)
|
|
26
|
+
return true;
|
|
27
|
+
if (el instanceof HTMLElement && el.isContentEditable)
|
|
28
|
+
return true;
|
|
29
|
+
if (el instanceof HTMLInputElement) {
|
|
30
|
+
if (TEXT_INPUT.test(el.type))
|
|
31
|
+
return true;
|
|
32
|
+
if (el.type === 'radio' && key.startsWith('Arrow'))
|
|
33
|
+
return true;
|
|
34
|
+
}
|
|
35
|
+
if (key === ' ' && el.matches('button, input, summary, a[href], [role]'))
|
|
36
|
+
return true;
|
|
37
|
+
if (key !== ' ' && el.matches('[role]:not([role=dialog]):not([role=document]):not([role=presentation]):not([role=none])'))
|
|
38
|
+
return true;
|
|
39
|
+
return false;
|
|
40
|
+
}
|
|
41
|
+
function canScroll(el, axis, dir) {
|
|
42
|
+
const style = getComputedStyle(el);
|
|
43
|
+
const overflow = axis === 'y' ? style.overflowY : style.overflowX;
|
|
44
|
+
if (!/^(?:auto|scroll|overlay)$/.test(overflow) && !(el instanceof HTMLTextAreaElement))
|
|
45
|
+
return false;
|
|
46
|
+
const pos = axis === 'y' ? el.scrollTop : Math.abs(el.scrollLeft);
|
|
47
|
+
const max = axis === 'y' ? el.scrollHeight - el.clientHeight : el.scrollWidth - el.clientWidth;
|
|
48
|
+
if (max < 1)
|
|
49
|
+
return false;
|
|
50
|
+
return dir > 0 ? pos < max - 1 : pos > 0;
|
|
51
|
+
}
|
|
52
|
+
const HAS_POPOVER = typeof HTMLElement !== 'undefined' && 'popover' in HTMLElement.prototype;
|
|
53
|
+
function isOpenPopover(el) {
|
|
54
|
+
return HAS_POPOVER && el.hasAttribute('popover') && el.matches(':popover-open');
|
|
55
|
+
}
|
|
56
|
+
function scrollsInside(event, axis, dir) {
|
|
57
|
+
if (!dir)
|
|
58
|
+
return true;
|
|
59
|
+
const path = event.composedPath().filter((n) => n instanceof Element);
|
|
60
|
+
const root = path.findIndex((n) => (n instanceof HTMLDialogElement && n.open) || isOpenPopover(n));
|
|
61
|
+
return root >= 0 && path.slice(0, root + 1).some((n) => canScroll(n, axis, dir));
|
|
62
|
+
}
|
|
63
|
+
function guardWheel(e) {
|
|
64
|
+
if (e.ctrlKey)
|
|
65
|
+
return;
|
|
66
|
+
const axis = Math.abs(e.deltaX) > Math.abs(e.deltaY) || e.shiftKey ? 'x' : 'y';
|
|
67
|
+
const delta = axis === 'y' && !e.shiftKey ? e.deltaY : e.deltaX || e.deltaY;
|
|
68
|
+
if (e.cancelable && !scrollsInside(e, axis, Math.sign(delta)))
|
|
69
|
+
e.preventDefault();
|
|
70
|
+
}
|
|
71
|
+
let touchX = 0;
|
|
72
|
+
let touchY = 0;
|
|
73
|
+
function guardTouchStart(e) {
|
|
74
|
+
if (e.touches.length !== 1)
|
|
75
|
+
return;
|
|
76
|
+
touchX = e.touches[0].clientX;
|
|
77
|
+
touchY = e.touches[0].clientY;
|
|
78
|
+
}
|
|
79
|
+
function guardTouchMove(e) {
|
|
80
|
+
if (e.touches.length !== 1 || !e.cancelable)
|
|
81
|
+
return;
|
|
82
|
+
const { clientX, clientY } = e.touches[0];
|
|
83
|
+
const dx = touchX - clientX;
|
|
84
|
+
const dy = touchY - clientY;
|
|
85
|
+
touchX = clientX;
|
|
86
|
+
touchY = clientY;
|
|
87
|
+
const axis = Math.abs(dx) > Math.abs(dy) ? 'x' : 'y';
|
|
88
|
+
if (!scrollsInside(e, axis, Math.sign(axis === 'y' ? dy : dx)))
|
|
89
|
+
e.preventDefault();
|
|
90
|
+
}
|
|
91
|
+
function guardKey(e) {
|
|
92
|
+
const scroll = KEY_SCROLL[e.key];
|
|
93
|
+
if (!scroll || e.defaultPrevented || e.altKey || e.ctrlKey || e.metaKey)
|
|
94
|
+
return;
|
|
95
|
+
const target = e.composedPath()[0];
|
|
96
|
+
if (target instanceof Element && keyBelongsTo(target, e.key))
|
|
97
|
+
return;
|
|
98
|
+
const [axis, dir] = scroll;
|
|
99
|
+
if (!scrollsInside(e, axis, e.key === ' ' && e.shiftKey ? -dir : dir))
|
|
100
|
+
e.preventDefault();
|
|
101
|
+
}
|
|
102
|
+
const WHEEL_OPTS = { capture: true, passive: false };
|
|
103
|
+
function addGuard() {
|
|
104
|
+
window.addEventListener('wheel', guardWheel, WHEEL_OPTS);
|
|
105
|
+
window.addEventListener('touchstart', guardTouchStart, { capture: true, passive: true });
|
|
106
|
+
window.addEventListener('touchmove', guardTouchMove, WHEEL_OPTS);
|
|
107
|
+
window.addEventListener('keydown', guardKey, true);
|
|
108
|
+
}
|
|
109
|
+
function removeGuard() {
|
|
110
|
+
window.removeEventListener('wheel', guardWheel, WHEEL_OPTS);
|
|
111
|
+
window.removeEventListener('touchstart', guardTouchStart, { capture: true });
|
|
112
|
+
window.removeEventListener('touchmove', guardTouchMove, WHEEL_OPTS);
|
|
113
|
+
window.removeEventListener('keydown', guardKey, true);
|
|
114
|
+
}
|
|
60
115
|
function lockBodyFixed() {
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
* Unlock body scrolling
|
|
79
|
-
*/
|
|
116
|
+
if (lockState.locked)
|
|
117
|
+
return;
|
|
118
|
+
const scrollbarWidth = getScrollbarWidth();
|
|
119
|
+
const docEl = getDocEl();
|
|
120
|
+
if (window.tyScrollDebug) {
|
|
121
|
+
console.log('🔒 Locking body scroll:', { scrollbarWidth });
|
|
122
|
+
}
|
|
123
|
+
lockState.scrollY = getScrollY();
|
|
124
|
+
lockState.locked = true;
|
|
125
|
+
savedStyle = { overflow: docEl.style.overflow, paddingRight: docEl.style.paddingRight };
|
|
126
|
+
docEl.style.overflow = 'hidden';
|
|
127
|
+
if (scrollbarWidth > 0) {
|
|
128
|
+
docEl.style.paddingRight = `${scrollbarWidth}px`;
|
|
129
|
+
}
|
|
130
|
+
docEl.classList.add('ty-scroll-locked');
|
|
131
|
+
addGuard();
|
|
132
|
+
}
|
|
80
133
|
function unlockBodyFixed() {
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
// Public API
|
|
94
|
-
// ============================================================================
|
|
95
|
-
/**
|
|
96
|
-
* Lock scrolling for a specific component.
|
|
97
|
-
*
|
|
98
|
-
* Multiple components can lock scrolling simultaneously.
|
|
99
|
-
* Scroll remains locked until ALL components unlock.
|
|
100
|
-
*
|
|
101
|
-
* @param componentId - Unique identifier for the component
|
|
102
|
-
*/
|
|
134
|
+
if (!lockState.locked)
|
|
135
|
+
return;
|
|
136
|
+
const docEl = getDocEl();
|
|
137
|
+
if (window.tyScrollDebug) {
|
|
138
|
+
console.log('🔓 Unlocking body scroll');
|
|
139
|
+
}
|
|
140
|
+
removeGuard();
|
|
141
|
+
docEl.classList.remove('ty-scroll-locked');
|
|
142
|
+
docEl.style.overflow = savedStyle.overflow;
|
|
143
|
+
docEl.style.paddingRight = savedStyle.paddingRight;
|
|
144
|
+
lockState.locked = false;
|
|
145
|
+
}
|
|
103
146
|
export function lockScroll(componentId) {
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
}
|
|
112
|
-
}
|
|
113
|
-
/**
|
|
114
|
-
* Unlock scrolling for a specific component.
|
|
115
|
-
*
|
|
116
|
-
* Scroll remains locked if other components still have locks active.
|
|
117
|
-
*
|
|
118
|
-
* @param componentId - Unique identifier for the component
|
|
119
|
-
*/
|
|
147
|
+
if (lockState.activeLocks.has(componentId))
|
|
148
|
+
return;
|
|
149
|
+
lockState.activeLocks.add(componentId);
|
|
150
|
+
if (lockState.activeLocks.size === 1) {
|
|
151
|
+
lockBodyFixed();
|
|
152
|
+
}
|
|
153
|
+
}
|
|
120
154
|
export function unlockScroll(componentId) {
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
}
|
|
129
|
-
console.log('Lock status', lockState.activeLocks);
|
|
130
|
-
}
|
|
131
|
-
/**
|
|
132
|
-
* Emergency unlock - removes all scroll locks immediately.
|
|
133
|
-
*
|
|
134
|
-
* Use this for cleanup or error recovery scenarios.
|
|
135
|
-
*/
|
|
155
|
+
if (!lockState.activeLocks.has(componentId))
|
|
156
|
+
return;
|
|
157
|
+
lockState.activeLocks.delete(componentId);
|
|
158
|
+
if (lockState.activeLocks.size === 0) {
|
|
159
|
+
unlockBodyFixed();
|
|
160
|
+
}
|
|
161
|
+
}
|
|
136
162
|
export function forceUnlockAll() {
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
}
|
|
140
|
-
// ============================================================================
|
|
141
|
-
// Debug API
|
|
142
|
-
// ============================================================================
|
|
143
|
-
/**
|
|
144
|
-
* Enable scroll lock debugging - useful for testing and development
|
|
145
|
-
*/
|
|
163
|
+
lockState.activeLocks.clear();
|
|
164
|
+
unlockBodyFixed();
|
|
165
|
+
}
|
|
146
166
|
export function enableDebug() {
|
|
147
|
-
|
|
148
|
-
|
|
167
|
+
console.log('🔍 CSS Scroll lock debugging enabled');
|
|
168
|
+
window.tyScrollDebug = true;
|
|
149
169
|
}
|
|
150
|
-
/**
|
|
151
|
-
* Disable scroll lock debugging
|
|
152
|
-
*/
|
|
153
170
|
export function disableDebug() {
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
}
|
|
157
|
-
// ============================================================================
|
|
158
|
-
// State Inspection
|
|
159
|
-
// ============================================================================
|
|
160
|
-
/**
|
|
161
|
-
* Get the set of currently active component locks.
|
|
162
|
-
*
|
|
163
|
-
* @returns Set of component IDs that currently have scroll locked
|
|
164
|
-
*/
|
|
171
|
+
console.log('🔍 CSS Scroll lock debugging disabled');
|
|
172
|
+
window.tyScrollDebug = false;
|
|
173
|
+
}
|
|
165
174
|
export function getActiveLocks() {
|
|
166
|
-
|
|
175
|
+
return new Set(lockState.activeLocks);
|
|
167
176
|
}
|
|
168
|
-
/**
|
|
169
|
-
* Check if scrolling is currently locked.
|
|
170
|
-
*
|
|
171
|
-
* @returns true if any component has scroll locked
|
|
172
|
-
*/
|
|
173
177
|
export function isLocked() {
|
|
174
|
-
|
|
175
|
-
}
|
|
176
|
-
/**
|
|
177
|
-
* Check if scrolling is locked by a specific component.
|
|
178
|
-
*
|
|
179
|
-
* @param componentId - Component identifier to check
|
|
180
|
-
* @returns true if this specific component has scroll locked
|
|
181
|
-
*/
|
|
178
|
+
return lockState.locked;
|
|
179
|
+
}
|
|
182
180
|
export function isLockedBy(componentId) {
|
|
183
|
-
|
|
181
|
+
return lockState.activeLocks.has(componentId);
|
|
184
182
|
}
|
|
185
|
-
/**
|
|
186
|
-
* Get the complete lock state for debugging.
|
|
187
|
-
*
|
|
188
|
-
* @returns Current state including scroll position and active locks
|
|
189
|
-
*/
|
|
190
183
|
export function getLockState() {
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
184
|
+
return {
|
|
185
|
+
locked: lockState.locked,
|
|
186
|
+
scrollY: lockState.scrollY,
|
|
187
|
+
activeLocks: Array.from(lockState.activeLocks),
|
|
188
|
+
};
|
|
196
189
|
}
|
|
197
|
-
//# sourceMappingURL=scroll-lock.js.map
|
package/lib/utils/styles.d.ts
CHANGED
|
@@ -19,9 +19,3 @@ export declare function ensureStyles(shadowRoot: ShadowRoot, styleContent: Style
|
|
|
19
19
|
* @returns Space-separated class string
|
|
20
20
|
*/
|
|
21
21
|
export declare function buildClassList(...classes: (string | false | null | undefined)[]): string;
|
|
22
|
-
/**
|
|
23
|
-
* Clear the style cache
|
|
24
|
-
* Useful for testing or hot-reloading
|
|
25
|
-
*/
|
|
26
|
-
export declare function clearStyleCache(): void;
|
|
27
|
-
//# sourceMappingURL=styles.d.ts.map
|
package/lib/utils/styles.js
CHANGED
|
@@ -1,53 +1,22 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* CSS Utilities for Ty Components
|
|
3
|
-
* Handles dynamic CSS loading into Shadow DOM
|
|
4
|
-
*/
|
|
5
|
-
/** Cache of loaded CSSStyleSheet objects */
|
|
6
1
|
const styleCache = new Map();
|
|
7
|
-
/**
|
|
8
|
-
* Ensure CSS is loaded into a shadow root
|
|
9
|
-
* Uses CSSStyleSheet API for efficient style sharing
|
|
10
|
-
*
|
|
11
|
-
* @param shadowRoot - The shadow root to attach styles to
|
|
12
|
-
* @param styleContent - Style content with CSS text and optional ID
|
|
13
|
-
*/
|
|
14
2
|
export function ensureStyles(shadowRoot, styleContent) {
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
sheet = styleCache.get(id);
|
|
20
|
-
}
|
|
21
|
-
else {
|
|
22
|
-
// Create new stylesheet
|
|
23
|
-
sheet = new CSSStyleSheet();
|
|
24
|
-
sheet.replaceSync(css);
|
|
25
|
-
// Cache it if ID provided
|
|
26
|
-
if (id) {
|
|
27
|
-
styleCache.set(id, sheet);
|
|
28
|
-
}
|
|
29
|
-
}
|
|
30
|
-
// Append only if not already adopted
|
|
31
|
-
const existing = shadowRoot.adoptedStyleSheets || [];
|
|
32
|
-
if (!existing.includes(sheet)) {
|
|
33
|
-
shadowRoot.adoptedStyleSheets = [...existing, sheet];
|
|
34
|
-
}
|
|
3
|
+
const { css, id } = styleContent;
|
|
4
|
+
let sheet;
|
|
5
|
+
if (id && styleCache.has(id)) {
|
|
6
|
+
sheet = styleCache.get(id);
|
|
35
7
|
}
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
8
|
+
else {
|
|
9
|
+
sheet = new CSSStyleSheet();
|
|
10
|
+
sheet.replaceSync(css);
|
|
11
|
+
if (id) {
|
|
12
|
+
styleCache.set(id, sheet);
|
|
13
|
+
}
|
|
14
|
+
}
|
|
15
|
+
const existing = shadowRoot.adoptedStyleSheets || [];
|
|
16
|
+
if (!existing.includes(sheet)) {
|
|
17
|
+
shadowRoot.adoptedStyleSheets = [...existing, sheet];
|
|
45
18
|
}
|
|
46
|
-
/**
|
|
47
|
-
* Clear the style cache
|
|
48
|
-
* Useful for testing or hot-reloading
|
|
49
|
-
*/
|
|
50
|
-
export function clearStyleCache() {
|
|
51
|
-
styleCache.clear();
|
|
52
19
|
}
|
|
53
|
-
|
|
20
|
+
export function buildClassList(...classes) {
|
|
21
|
+
return classes.filter(Boolean).join(' ');
|
|
22
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* For a component whose attributeChangedCallback assigns through its own
|
|
3
|
+
* accessors: call it in the constructor. While an element upgrades, the
|
|
4
|
+
* attribute callbacks run before connectedCallback and would overwrite the
|
|
5
|
+
* early values (an own property takes the assignment); taken off here, they
|
|
6
|
+
* reach the setters in upgradeProperties() instead, after the attributes.
|
|
7
|
+
*/
|
|
8
|
+
export declare function liftProperties(el: HTMLElement): void;
|
|
9
|
+
/**
|
|
10
|
+
* Properties set before the element upgraded (a framework rendering it
|
|
11
|
+
* before its definition loaded, a lazily defined element) are own data
|
|
12
|
+
* properties that shadow the class accessors, so later assignments would
|
|
13
|
+
* never reach a setter. Standard "upgrade property" pattern: read the own
|
|
14
|
+
* value, delete it, assign it again through the accessor. Covers every
|
|
15
|
+
* settable accessor on the prototype chain (value, checked, open, error,
|
|
16
|
+
* minLength, …). TyComponent does this itself; a component extending
|
|
17
|
+
* HTMLElement directly calls it at the start of connectedCallback.
|
|
18
|
+
* A value its setter rejects is reported, not thrown: connectedCallback
|
|
19
|
+
* goes on, as it would for an attribute with a bad value.
|
|
20
|
+
*/
|
|
21
|
+
export declare function upgradeProperties(el: HTMLElement): void;
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
const accessorCache = new WeakMap();
|
|
2
|
+
function settableAccessors(ctor) {
|
|
3
|
+
let names = accessorCache.get(ctor);
|
|
4
|
+
if (!names) {
|
|
5
|
+
const set = new Set();
|
|
6
|
+
for (let proto = ctor.prototype; proto && proto !== HTMLElement.prototype; proto = Object.getPrototypeOf(proto)) {
|
|
7
|
+
for (const [name, d] of Object.entries(Object.getOwnPropertyDescriptors(proto))) {
|
|
8
|
+
if (d.set)
|
|
9
|
+
set.add(name);
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
names = [...set];
|
|
13
|
+
accessorCache.set(ctor, names);
|
|
14
|
+
}
|
|
15
|
+
return names;
|
|
16
|
+
}
|
|
17
|
+
const lifted = new WeakMap();
|
|
18
|
+
function takeOwn(el) {
|
|
19
|
+
const taken = [];
|
|
20
|
+
for (const name of settableAccessors(el.constructor)) {
|
|
21
|
+
if (!Object.prototype.hasOwnProperty.call(el, name))
|
|
22
|
+
continue;
|
|
23
|
+
taken.push([name, el[name]]);
|
|
24
|
+
delete el[name];
|
|
25
|
+
}
|
|
26
|
+
return taken;
|
|
27
|
+
}
|
|
28
|
+
export function liftProperties(el) {
|
|
29
|
+
const taken = takeOwn(el);
|
|
30
|
+
if (taken.length)
|
|
31
|
+
lifted.set(el, taken);
|
|
32
|
+
}
|
|
33
|
+
export function upgradeProperties(el) {
|
|
34
|
+
const early = [...(lifted.get(el) ?? []), ...takeOwn(el)];
|
|
35
|
+
lifted.delete(el);
|
|
36
|
+
for (const [name, value] of early) {
|
|
37
|
+
if (value === undefined)
|
|
38
|
+
continue;
|
|
39
|
+
try {
|
|
40
|
+
;
|
|
41
|
+
el[name] = value;
|
|
42
|
+
}
|
|
43
|
+
catch (e) {
|
|
44
|
+
reportError(e);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Constraint validation for form-associated ty components.
|
|
3
|
+
*
|
|
4
|
+
* Components report their own state (e.g. valueMissing) through set(); users
|
|
5
|
+
* add a custom error through setCustomValidity(). Both are kept separately and
|
|
6
|
+
* merged into ElementInternals, so a component re-validating on the next
|
|
7
|
+
* keystroke doesn't wipe the user's custom error (same as native inputs).
|
|
8
|
+
*
|
|
9
|
+
* reportValidity() uses the component's own `error` display when it has one
|
|
10
|
+
* (ty-input, ty-textarea, ty-radio-group, ty-file-upload) instead of the
|
|
11
|
+
* browser's bubble, and clears that message again once the field is valid.
|
|
12
|
+
* Whenever the browser fires `invalid` on such a field — a submit attempt,
|
|
13
|
+
* form.reportValidity(), or checkValidity() on the field or its form — the
|
|
14
|
+
* message goes into that error line (no bubble), so a plain <form> needs no
|
|
15
|
+
* JS. For a check that shows nothing, read `field.validity.valid` or
|
|
16
|
+
* `form.matches(':invalid')`. A submit (a submitter click, Enter in a
|
|
17
|
+
* single-line field, form.requestSubmit()) and form.reportValidity() also
|
|
18
|
+
* move focus to the first failing field — the first in form order, like a
|
|
19
|
+
* native form, also when a later field shows a bubble. checkValidity() never
|
|
20
|
+
* does. For the script-run calls, a form holding a Ty field with an error
|
|
21
|
+
* line gets own requestSubmit / reportValidity wrappers (the prototype and
|
|
22
|
+
* other forms are left alone); they come off when the last such field leaves.
|
|
23
|
+
* An `error` the author set is never overwritten or removed;
|
|
24
|
+
* form.reset() clears every message the controller wrote.
|
|
25
|
+
*/
|
|
26
|
+
/**
|
|
27
|
+
* Run `fn` as a submit attempt: `invalid` events during it move focus to the
|
|
28
|
+
* first failing field. ty-button runs its form.requestSubmit() in this.
|
|
29
|
+
*/
|
|
30
|
+
export declare function asSubmitAttempt<T>(fn: () => T): T;
|
|
31
|
+
export declare class ValidityController {
|
|
32
|
+
private host;
|
|
33
|
+
private internals;
|
|
34
|
+
private own;
|
|
35
|
+
private custom;
|
|
36
|
+
/** The message this controller last wrote into `error`. */
|
|
37
|
+
private written;
|
|
38
|
+
/** The anchor last handed to setValidity(). */
|
|
39
|
+
private anchor?;
|
|
40
|
+
/**
|
|
41
|
+
* Anchors a validation bubble was shown on, the last two. WebKit keeps a
|
|
42
|
+
* pointer to that anchor without keeping it alive: once a re-render drops
|
|
43
|
+
* it (ty-calendar rebuilds its grid) and it is garbage-collected, the next
|
|
44
|
+
* submit crashes the page. Held until two later bubbles replaced it.
|
|
45
|
+
*/
|
|
46
|
+
private shown;
|
|
47
|
+
/** The form whose requestSubmit / reportValidity this field keeps wrapped. */
|
|
48
|
+
private form;
|
|
49
|
+
constructor(host: HTMLElement, internals: ElementInternals);
|
|
50
|
+
/**
|
|
51
|
+
* The host connected, disconnected or changed form: keep its form's
|
|
52
|
+
* requestSubmit / reportValidity wrapped while it (or another Ty field with
|
|
53
|
+
* an error line) is in it. Only such a field needs it: a native control or
|
|
54
|
+
* a bubble field is focused by the browser itself.
|
|
55
|
+
*/
|
|
56
|
+
track(): void;
|
|
57
|
+
/**
|
|
58
|
+
* Show the current message, if any, in the error display (on blur after an
|
|
59
|
+
* edit). During a pointer interaction it waits until after the click.
|
|
60
|
+
*/
|
|
61
|
+
reveal(): void;
|
|
62
|
+
/**
|
|
63
|
+
* `error` still holds what this controller wrote (a reportValidity(), a
|
|
64
|
+
* submit, a blur reveal), so it's ours to update and clear. Once the author
|
|
65
|
+
* sets their own message, it's theirs.
|
|
66
|
+
*/
|
|
67
|
+
private get errorFromReport();
|
|
68
|
+
private writeError;
|
|
69
|
+
/** Into `error`, unless the author's own message is there. */
|
|
70
|
+
private showError;
|
|
71
|
+
/**
|
|
72
|
+
* form.reset(): drop the message this controller showed and any blur
|
|
73
|
+
* reveal still waiting, so the field looks untouched again. An `error` the
|
|
74
|
+
* author set stays.
|
|
75
|
+
*/
|
|
76
|
+
reset(): void;
|
|
77
|
+
/** The component's own validity (replaces the previous one). */
|
|
78
|
+
set(flags: ValidityStateFlags, message?: string, anchor?: HTMLElement): void;
|
|
79
|
+
setCustom(message: string): void;
|
|
80
|
+
report(): boolean;
|
|
81
|
+
private sync;
|
|
82
|
+
}
|
|
83
|
+
type ProbeTag = 'input' | 'textarea' | 'select';
|
|
84
|
+
/**
|
|
85
|
+
* The browser's own (localized) message for a rule: a detached native control
|
|
86
|
+
* gets the same attributes and value and reports what it would say. `true`
|
|
87
|
+
* sets a boolean attribute; '', false and null leave the attribute off. One
|
|
88
|
+
* probe per tag, never in the document, stripped of every attribute before
|
|
89
|
+
* each use. Works for required and min/max; length rules only report after a
|
|
90
|
+
* user edit, so a probe can't word them (see lengthValidity()).
|
|
91
|
+
*/
|
|
92
|
+
export declare function nativeMessage(tag: ProbeTag, attrs: Record<string, string | boolean | null | undefined>, value?: string): string;
|
|
93
|
+
/**
|
|
94
|
+
* nativeMessage() plus the probe's own flags, for rules whose attribute the
|
|
95
|
+
* browser parses (min/max: ' 5 ' or '0x10' is no rule at all), so the flag
|
|
96
|
+
* and its message can't disagree. Read `validity` right away: the probe is
|
|
97
|
+
* reused by the next call.
|
|
98
|
+
*/
|
|
99
|
+
export declare function nativeValidity(tag: ProbeTag, attrs: Record<string, string | boolean | null | undefined>, value?: string): {
|
|
100
|
+
validity: ValidityState;
|
|
101
|
+
message: string;
|
|
102
|
+
};
|
|
103
|
+
/** Non-negative integer limit from an attribute string, or null when unset/invalid. */
|
|
104
|
+
export declare function toLimit(v: unknown): number | null;
|
|
105
|
+
/**
|
|
106
|
+
* minlength / maxlength for a text field (ty-input, ty-textarea): the failing
|
|
107
|
+
* flags with their messages. `control` is the inner native control carrying
|
|
108
|
+
* `minlength`; it only flags (and words, localized) a value the user typed,
|
|
109
|
+
* so its message is used then. Otherwise Ty's wording, and the author's
|
|
110
|
+
* too-short / too-long message always wins. Placeholders: {minlength}
|
|
111
|
+
* {maxlength} {length}.
|
|
112
|
+
*/
|
|
113
|
+
export declare function lengthValidity(value: string, rules: {
|
|
114
|
+
minlength: unknown;
|
|
115
|
+
maxlength: unknown;
|
|
116
|
+
tooShortMessage: string;
|
|
117
|
+
tooLongMessage: string;
|
|
118
|
+
}, control?: HTMLInputElement | HTMLTextAreaElement | null): {
|
|
119
|
+
tooShort?: string;
|
|
120
|
+
tooLong?: string;
|
|
121
|
+
};
|
|
122
|
+
export {};
|