@telus-uds/components-base 0.0.2-prerelease.6 → 1.0.0
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/.eslintrc.js +9 -0
- package/.ultra.cache.json +1 -1
- package/CHANGELOG.md +85 -0
- package/README.md +4 -2
- package/__fixtures__/Accessible.js +33 -0
- package/__fixtures__/Accessible.native.js +32 -0
- package/__fixtures__/test-utils.js +25 -0
- package/__fixtures__/testTheme.js +851 -57
- package/__tests__/ActivityIndicator/ActivityIndicator.test.jsx +1 -1
- package/__tests__/Button/ButtonBase.test.jsx +2 -31
- package/__tests__/Button/ButtonGroup.test.jsx +6 -7
- package/__tests__/Checkbox/Checkbox.test.jsx +94 -0
- package/__tests__/Checkbox/CheckboxGroup.test.jsx +246 -0
- package/__tests__/ExpandCollapse/ExpandCollapse.test.jsx +2 -2
- package/__tests__/HorizontalScroll/HorizontalScroll.test.jsx +164 -0
- package/__tests__/Icon/Icon.test.jsx +3 -3
- package/__tests__/IconButton/IconButton.test.jsx +52 -0
- package/__tests__/InputSupports/InputSupports.test.jsx +50 -0
- package/__tests__/Link/LinkBase.test.jsx +0 -14
- package/__tests__/List/List.test.jsx +60 -0
- package/__tests__/Modal/Modal.test.jsx +47 -0
- package/__tests__/Notification/Notification.test.jsx +20 -0
- package/__tests__/Pagination/Pagination.test.jsx +2 -2
- package/__tests__/Progress/Progress.test.jsx +79 -0
- package/__tests__/Radio/Radio.test.jsx +87 -0
- package/__tests__/Radio/RadioGroup.test.jsx +220 -0
- package/__tests__/RadioCard/RadioCard.test.jsx +87 -0
- package/__tests__/RadioCard/RadioCardGroup.test.jsx +246 -0
- package/__tests__/Search/Search.test.jsx +73 -0
- package/__tests__/Select/Select.test.jsx +94 -0
- package/__tests__/Skeleton/Skeleton.test.jsx +61 -0
- package/__tests__/StepTracker/StepTracker.test.jsx +94 -0
- package/__tests__/Tabs/Tabs.test.jsx +40 -0
- package/__tests__/Tags/Tags.test.jsx +327 -0
- package/__tests__/TextInput/TextArea.test.jsx +35 -0
- package/__tests__/TextInput/{TextInput.test.jsx → TextInputBase.test.jsx} +29 -50
- package/__tests__/ThemeProvider/ThemeProvider.test.jsx +77 -0
- package/__tests__/ThemeProvider/useThemeTokens.test.jsx +9 -5
- package/__tests__/ThemeProvider/utils/theme-tokens.test.js +41 -0
- package/__tests__/ToggleSwitch/ToggleSwitch.test.jsx +3 -2
- package/__tests__/utils/children.test.jsx +128 -0
- package/__tests__/utils/input.test.js +59 -1
- package/__tests__/utils/semantics.test.jsx +43 -0
- package/__tests__/utils/useCopy.test.js +14 -3
- package/babel.config.js +20 -0
- package/jest.config.js +8 -3
- package/lib/A11yInfoProvider/index.js +54 -26
- package/lib/A11yText/index.js +45 -17
- package/lib/ActivityIndicator/Spinner.js +81 -0
- package/lib/ActivityIndicator/Spinner.native.js +129 -91
- package/lib/ActivityIndicator/index.js +28 -12
- package/lib/ActivityIndicator/shared.js +27 -12
- package/lib/BaseProvider/index.js +34 -11
- package/lib/Box/Box.js +152 -35
- package/lib/Box/index.js +13 -2
- package/lib/Button/Button.js +41 -12
- package/lib/Button/ButtonBase.js +125 -97
- package/lib/Button/ButtonGroup.js +112 -89
- package/lib/Button/ButtonLink.js +48 -17
- package/lib/Button/index.js +31 -4
- package/lib/Button/propTypes.js +32 -9
- package/lib/Card/Card.js +38 -41
- package/lib/Card/CardBase.js +85 -0
- package/lib/Card/PressableCardBase.js +141 -0
- package/lib/Card/index.js +40 -2
- package/lib/Checkbox/Checkbox.js +355 -0
- package/lib/Checkbox/CheckboxGroup.js +241 -0
- package/lib/Checkbox/CheckboxInput.js +74 -0
- package/lib/Checkbox/CheckboxInput.native.js +14 -0
- package/lib/Checkbox/index.js +21 -0
- package/lib/Divider/Divider.js +59 -28
- package/lib/Divider/index.js +13 -2
- package/lib/ExpandCollapse/Accordion.js +26 -7
- package/lib/ExpandCollapse/Control.js +60 -31
- package/lib/ExpandCollapse/ExpandCollapse.js +50 -28
- package/lib/ExpandCollapse/Panel.js +83 -44
- package/lib/ExpandCollapse/index.js +25 -7
- package/lib/Feedback/Feedback.js +90 -39
- package/lib/Feedback/index.js +13 -2
- package/lib/Fieldset/Fieldset.js +165 -0
- package/lib/Fieldset/FieldsetContainer.js +46 -0
- package/lib/Fieldset/FieldsetContainer.native.js +38 -0
- package/lib/Fieldset/Legend.js +38 -0
- package/lib/Fieldset/Legend.native.js +48 -0
- package/lib/Fieldset/cssReset.js +21 -0
- package/lib/Fieldset/index.js +13 -0
- package/lib/FlexGrid/Col/Col.js +73 -41
- package/lib/FlexGrid/Col/index.js +13 -2
- package/lib/FlexGrid/FlexGrid.js +99 -49
- package/lib/FlexGrid/Row/Row.js +58 -30
- package/lib/FlexGrid/Row/index.js +13 -2
- package/lib/FlexGrid/helpers/index.js +9 -1
- package/lib/FlexGrid/index.js +13 -2
- package/lib/FlexGrid/providers/GutterContext.js +15 -3
- package/lib/HorizontalScroll/HorizontalScroll.js +200 -0
- package/lib/HorizontalScroll/HorizontalScrollButton.js +127 -0
- package/lib/HorizontalScroll/ScrollViewEnd.js +66 -0
- package/lib/HorizontalScroll/ScrollViewEnd.native.js +41 -0
- package/lib/HorizontalScroll/dictionary.js +18 -0
- package/lib/HorizontalScroll/index.js +35 -0
- package/lib/HorizontalScroll/itemPositions.js +128 -0
- package/lib/Icon/Icon.js +62 -50
- package/lib/Icon/IconText.js +101 -0
- package/lib/Icon/index.js +31 -3
- package/lib/IconButton/IconButton.js +140 -0
- package/lib/IconButton/index.js +13 -0
- package/lib/InputLabel/InputLabel.js +102 -40
- package/lib/InputLabel/LabelContent.js +41 -0
- package/lib/InputLabel/LabelContent.native.js +32 -6
- package/lib/InputLabel/index.js +13 -2
- package/lib/InputSupports/InputSupports.js +109 -0
- package/lib/InputSupports/index.js +13 -0
- package/lib/InputSupports/propTypes.js +66 -0
- package/lib/InputSupports/useInputSupports.js +41 -0
- package/lib/Link/ChevronLink.js +58 -31
- package/lib/Link/InlinePressable.js +56 -0
- package/lib/Link/InlinePressable.native.js +102 -0
- package/lib/Link/Link.js +39 -15
- package/lib/Link/LinkBase.js +126 -150
- package/lib/Link/TextButton.js +53 -18
- package/lib/Link/index.js +39 -4
- package/lib/List/List.js +81 -0
- package/lib/List/ListItem.js +245 -0
- package/lib/List/index.js +13 -0
- package/lib/Modal/Modal.js +231 -0
- package/lib/Modal/dictionary.js +16 -0
- package/lib/Modal/index.js +13 -0
- package/lib/Notification/Notification.js +216 -0
- package/lib/Notification/dictionary.js +15 -0
- package/lib/Notification/index.js +13 -0
- package/lib/Pagination/PageButton.js +58 -48
- package/lib/Pagination/Pagination.js +78 -43
- package/lib/Pagination/SideButton.js +79 -58
- package/lib/Pagination/dictionary.js +9 -2
- package/lib/Pagination/index.js +13 -2
- package/lib/Pagination/usePagination.js +12 -2
- package/lib/Progress/Progress.js +104 -0
- package/lib/Progress/ProgressBar.js +157 -0
- package/lib/Progress/ProgressBarBackground.js +61 -0
- package/lib/Progress/index.js +16 -0
- package/lib/Radio/Radio.js +293 -0
- package/lib/Radio/RadioButton.js +152 -0
- package/lib/Radio/RadioGroup.js +244 -0
- package/lib/Radio/RadioInput.js +76 -0
- package/lib/Radio/RadioInput.native.js +14 -0
- package/lib/Radio/index.js +21 -0
- package/lib/RadioCard/RadioCard.js +244 -0
- package/lib/RadioCard/RadioCardGroup.js +252 -0
- package/lib/RadioCard/index.js +21 -0
- package/lib/Search/Search.js +254 -0
- package/lib/Search/dictionary.js +19 -0
- package/lib/Search/index.js +13 -0
- package/lib/Select/Group.js +33 -0
- package/lib/Select/Group.native.js +25 -0
- package/lib/Select/Item.js +29 -0
- package/lib/Select/Item.native.js +19 -0
- package/lib/Select/Picker.js +84 -0
- package/lib/Select/Picker.native.js +130 -0
- package/lib/Select/Select.js +342 -0
- package/lib/Select/index.js +19 -0
- package/lib/SideNav/Item.js +63 -37
- package/lib/SideNav/ItemContent.js +41 -15
- package/lib/SideNav/ItemsGroup.js +55 -31
- package/lib/SideNav/SideNav.js +100 -73
- package/lib/SideNav/index.js +15 -1
- package/lib/Skeleton/Skeleton.js +137 -0
- package/lib/Skeleton/index.js +13 -0
- package/lib/Skeleton/skeleton.constant.js +12 -0
- package/lib/Skeleton/skeletonWebAnimation.js +27 -0
- package/lib/Skeleton/useSkeletonNativeAnimation.js +37 -0
- package/lib/Spacer/Spacer.js +49 -18
- package/lib/Spacer/index.js +13 -2
- package/lib/StackView/StackView.js +71 -31
- package/lib/StackView/StackWrap.js +43 -13
- package/lib/StackView/StackWrap.native.js +13 -2
- package/lib/StackView/StackWrapBox.js +76 -29
- package/lib/StackView/StackWrapGap.js +56 -26
- package/lib/StackView/common.js +23 -6
- package/lib/StackView/getStackedContent.js +47 -17
- package/lib/StackView/index.js +29 -5
- package/lib/StepTracker/Step.js +245 -0
- package/lib/StepTracker/StepTracker.js +202 -0
- package/lib/StepTracker/dictionary.js +17 -0
- package/lib/StepTracker/index.js +13 -0
- package/lib/Tabs/Tabs.js +124 -0
- package/lib/Tabs/TabsItem.js +238 -0
- package/lib/Tabs/index.js +13 -0
- package/lib/Tags/Tags.js +266 -0
- package/lib/Tags/index.js +13 -0
- package/lib/TextInput/TextArea.js +111 -0
- package/lib/TextInput/TextInput.js +50 -304
- package/lib/TextInput/TextInputBase.js +256 -0
- package/lib/TextInput/index.js +23 -2
- package/lib/TextInput/propTypes.js +42 -0
- package/lib/ThemeProvider/ThemeProvider.js +46 -18
- package/lib/ThemeProvider/index.js +61 -6
- package/lib/ThemeProvider/useSetTheme.js +19 -5
- package/lib/ThemeProvider/useTheme.js +13 -4
- package/lib/ThemeProvider/useThemeTokens.js +86 -19
- package/lib/ThemeProvider/utils/index.js +31 -2
- package/lib/ThemeProvider/utils/styles.js +50 -14
- package/lib/ThemeProvider/utils/theme-tokens.js +121 -12
- package/lib/ToggleSwitch/ToggleSwitch.js +86 -57
- package/lib/ToggleSwitch/index.js +13 -2
- package/lib/Tooltip/{Backdrop.web.js → Backdrop.js} +20 -8
- package/lib/Tooltip/Backdrop.native.js +39 -15
- package/lib/Tooltip/Tooltip.js +117 -74
- package/lib/Tooltip/dictionary.js +9 -2
- package/lib/Tooltip/getTooltipPosition.js +9 -1
- package/lib/Tooltip/index.js +13 -2
- package/lib/TooltipButton/TooltipButton.js +57 -38
- package/lib/TooltipButton/index.js +13 -2
- package/lib/Typography/Typography.js +86 -55
- package/lib/Typography/index.js +13 -2
- package/lib/ViewportProvider/ViewportProvider.js +34 -13
- package/lib/ViewportProvider/index.js +28 -3
- package/lib/ViewportProvider/useViewport.js +15 -3
- package/lib/ViewportProvider/useViewportListener.js +24 -10
- package/lib/index.js +539 -26
- package/lib/utils/a11y/index.js +31 -0
- package/lib/utils/a11y/semantics.js +173 -0
- package/lib/utils/a11y/textSize.js +49 -0
- package/lib/utils/animation/index.js +15 -2
- package/lib/utils/animation/useVerticalExpandAnimation.js +27 -10
- package/lib/utils/children.js +134 -0
- package/lib/utils/index.js +163 -7
- package/lib/utils/info/index.js +19 -0
- package/lib/utils/info/platform/index.js +23 -0
- package/lib/utils/info/platform/platform.android.js +8 -0
- package/lib/utils/info/platform/platform.ios.js +8 -0
- package/lib/utils/info/platform/platform.js +8 -0
- package/lib/utils/info/platform/platform.native.js +11 -0
- package/lib/utils/info/versions.js +16 -0
- package/lib/utils/input.js +53 -25
- package/lib/utils/pressability.js +120 -0
- package/lib/utils/propTypes.js +338 -132
- package/lib/utils/useCopy.js +40 -5
- package/lib/utils/useHash.js +52 -0
- package/lib/utils/useHash.native.js +15 -0
- package/lib/utils/useResponsiveProp.js +21 -9
- package/lib/utils/useSpacingScale.js +19 -9
- package/lib/utils/useUniqueId.js +12 -3
- package/package.json +16 -10
- package/release-context.json +4 -4
- package/src/A11yText/index.jsx +6 -4
- package/src/ActivityIndicator/{Spinner.web.jsx → Spinner.jsx} +5 -3
- package/src/ActivityIndicator/Spinner.native.jsx +5 -3
- package/src/Box/Box.jsx +131 -39
- package/src/Button/Button.jsx +13 -6
- package/src/Button/ButtonBase.jsx +134 -125
- package/src/Button/ButtonGroup.jsx +85 -86
- package/src/Button/ButtonLink.jsx +22 -7
- package/src/Button/propTypes.js +12 -2
- package/src/Card/Card.jsx +5 -31
- package/src/Card/CardBase.jsx +58 -0
- package/src/Card/PressableCardBase.jsx +119 -0
- package/src/Card/index.js +3 -0
- package/src/Checkbox/Checkbox.jsx +284 -0
- package/src/Checkbox/CheckboxGroup.jsx +206 -0
- package/src/Checkbox/CheckboxInput.jsx +55 -0
- package/src/Checkbox/CheckboxInput.native.jsx +6 -0
- package/src/Checkbox/index.js +5 -0
- package/src/Divider/Divider.jsx +7 -4
- package/src/ExpandCollapse/Accordion.jsx +3 -2
- package/src/ExpandCollapse/Control.jsx +40 -43
- package/src/ExpandCollapse/ExpandCollapse.jsx +26 -23
- package/src/ExpandCollapse/Panel.jsx +69 -63
- package/src/Feedback/Feedback.jsx +42 -30
- package/src/Fieldset/Fieldset.jsx +136 -0
- package/src/Fieldset/FieldsetContainer.jsx +31 -0
- package/src/Fieldset/FieldsetContainer.native.jsx +19 -0
- package/src/Fieldset/Legend.jsx +21 -0
- package/src/Fieldset/Legend.native.jsx +27 -0
- package/src/Fieldset/cssReset.js +14 -0
- package/src/Fieldset/index.js +3 -0
- package/src/FlexGrid/Col/Col.jsx +139 -132
- package/src/FlexGrid/FlexGrid.jsx +79 -51
- package/src/FlexGrid/Row/Row.jsx +55 -48
- package/src/HorizontalScroll/HorizontalScroll.jsx +168 -0
- package/src/HorizontalScroll/HorizontalScrollButton.jsx +105 -0
- package/src/HorizontalScroll/ScrollViewEnd.jsx +53 -0
- package/src/HorizontalScroll/ScrollViewEnd.native.jsx +24 -0
- package/src/HorizontalScroll/dictionary.js +11 -0
- package/src/HorizontalScroll/index.js +17 -0
- package/src/HorizontalScroll/itemPositions.js +101 -0
- package/src/Icon/Icon.jsx +46 -49
- package/src/Icon/IconText.jsx +68 -0
- package/src/Icon/index.js +3 -2
- package/src/IconButton/IconButton.jsx +114 -0
- package/src/IconButton/index.js +3 -0
- package/src/InputLabel/InputLabel.jsx +57 -35
- package/src/InputLabel/LabelContent.jsx +21 -0
- package/src/InputLabel/LabelContent.native.jsx +11 -2
- package/src/InputSupports/InputSupports.jsx +70 -0
- package/src/InputSupports/index.js +3 -0
- package/src/InputSupports/propTypes.js +44 -0
- package/src/InputSupports/useInputSupports.js +30 -0
- package/src/Link/ChevronLink.jsx +34 -21
- package/src/Link/InlinePressable.jsx +39 -0
- package/src/Link/InlinePressable.native.jsx +75 -0
- package/src/Link/Link.jsx +23 -13
- package/src/Link/LinkBase.jsx +98 -170
- package/src/Link/TextButton.jsx +37 -16
- package/src/Link/index.js +2 -1
- package/src/List/List.jsx +48 -0
- package/src/List/ListItem.jsx +182 -0
- package/src/List/index.js +3 -0
- package/src/Modal/Modal.jsx +190 -0
- package/src/Modal/dictionary.js +9 -0
- package/src/Modal/index.js +3 -0
- package/src/Notification/Notification.jsx +164 -0
- package/src/Notification/dictionary.js +8 -0
- package/src/Notification/index.js +3 -0
- package/src/Pagination/PageButton.jsx +42 -49
- package/src/Pagination/Pagination.jsx +88 -92
- package/src/Pagination/SideButton.jsx +58 -66
- package/src/Progress/Progress.jsx +78 -0
- package/src/Progress/ProgressBar.jsx +123 -0
- package/src/Progress/ProgressBarBackground.jsx +36 -0
- package/src/Progress/index.js +6 -0
- package/src/Radio/Radio.jsx +240 -0
- package/src/Radio/RadioButton.jsx +142 -0
- package/src/Radio/RadioGroup.jsx +209 -0
- package/src/Radio/RadioInput.jsx +57 -0
- package/src/Radio/RadioInput.native.jsx +6 -0
- package/src/Radio/index.js +5 -0
- package/src/RadioCard/RadioCard.jsx +198 -0
- package/src/RadioCard/RadioCardGroup.jsx +218 -0
- package/src/RadioCard/index.js +5 -0
- package/src/Search/Search.jsx +225 -0
- package/src/Search/dictionary.js +12 -0
- package/src/Search/index.js +3 -0
- package/src/Select/Group.jsx +15 -0
- package/src/Select/Group.native.jsx +14 -0
- package/src/Select/Item.jsx +11 -0
- package/src/Select/Item.native.jsx +10 -0
- package/src/Select/Picker.jsx +74 -0
- package/src/Select/Picker.native.jsx +102 -0
- package/src/Select/Select.jsx +298 -0
- package/src/Select/index.js +8 -0
- package/src/SideNav/Item.jsx +54 -47
- package/src/SideNav/ItemsGroup.jsx +50 -43
- package/src/SideNav/SideNav.jsx +68 -60
- package/src/Skeleton/Skeleton.jsx +94 -0
- package/src/Skeleton/index.js +3 -0
- package/src/Skeleton/skeleton.constant.js +3 -0
- package/src/Skeleton/skeletonWebAnimation.js +13 -0
- package/src/Skeleton/useSkeletonNativeAnimation.js +27 -0
- package/src/Spacer/Spacer.jsx +11 -4
- package/src/StackView/StackView.jsx +53 -23
- package/src/StackView/StackWrap.jsx +16 -7
- package/src/StackView/StackWrapBox.jsx +62 -28
- package/src/StackView/StackWrapGap.jsx +46 -24
- package/src/StackView/common.jsx +3 -2
- package/src/StackView/getStackedContent.jsx +8 -2
- package/src/StepTracker/Step.jsx +202 -0
- package/src/StepTracker/StepTracker.jsx +174 -0
- package/src/StepTracker/dictionary.js +10 -0
- package/src/StepTracker/index.js +3 -0
- package/src/Tabs/Tabs.jsx +97 -0
- package/src/Tabs/TabsItem.jsx +212 -0
- package/src/Tabs/index.js +3 -0
- package/src/Tags/Tags.jsx +219 -0
- package/src/Tags/index.js +3 -0
- package/src/TextInput/TextArea.jsx +79 -0
- package/src/TextInput/TextInput.jsx +18 -284
- package/src/TextInput/TextInputBase.jsx +217 -0
- package/src/TextInput/index.js +2 -1
- package/src/TextInput/propTypes.js +29 -0
- package/src/ThemeProvider/ThemeProvider.jsx +11 -7
- package/src/ThemeProvider/useSetTheme.js +4 -0
- package/src/ThemeProvider/useThemeTokens.js +56 -5
- package/src/ThemeProvider/utils/styles.js +18 -5
- package/src/ThemeProvider/utils/theme-tokens.js +74 -5
- package/src/ToggleSwitch/ToggleSwitch.jsx +51 -53
- package/src/Tooltip/{Backdrop.web.jsx → Backdrop.jsx} +0 -0
- package/src/Tooltip/Tooltip.jsx +135 -131
- package/src/TooltipButton/TooltipButton.jsx +23 -27
- package/src/Typography/Typography.jsx +72 -59
- package/src/index.js +31 -3
- package/src/utils/a11y/index.js +2 -0
- package/src/utils/a11y/semantics.js +162 -0
- package/src/utils/a11y/textSize.js +30 -0
- package/src/utils/children.jsx +119 -0
- package/src/utils/index.js +6 -0
- package/src/utils/info/index.js +8 -0
- package/src/utils/info/platform/index.js +11 -0
- package/src/utils/info/platform/platform.android.js +1 -0
- package/src/utils/info/platform/platform.ios.js +1 -0
- package/src/utils/info/platform/platform.js +1 -0
- package/src/utils/info/platform/platform.native.js +4 -0
- package/src/utils/info/versions.js +6 -0
- package/src/utils/input.js +36 -25
- package/src/utils/pressability.js +96 -0
- package/src/utils/propTypes.js +291 -90
- package/src/utils/useCopy.js +30 -4
- package/src/utils/useHash.js +39 -0
- package/src/utils/useHash.native.js +6 -0
- package/stories/A11yText/A11yText.stories.jsx +6 -10
- package/stories/ActivityIndicator/ActivityIndicator.stories.jsx +1 -1
- package/stories/Box/Box.stories.jsx +1 -1
- package/stories/Button/Button.stories.jsx +7 -2
- package/stories/Button/ButtonGroup.stories.jsx +1 -1
- package/stories/Button/ButtonLink.stories.jsx +1 -1
- package/stories/Card/Card.stories.jsx +1 -1
- package/stories/Checkbox/Checkbox.stories.jsx +94 -0
- package/stories/Divider/Divider.stories.jsx +1 -1
- package/stories/ExpandCollapse/ExpandCollapse.stories.jsx +2 -2
- package/stories/Feedback/Feedback.stories.jsx +5 -6
- package/stories/FlexGrid/01 FlexGrid.stories.jsx +1 -1
- package/stories/FlexGrid/02 Row.stories.jsx +1 -1
- package/stories/FlexGrid/03 Col.stories.jsx +1 -1
- package/stories/Icon/Icon.stories.jsx +27 -7
- package/stories/IconButton/IconButton.stories.jsx +50 -0
- package/stories/InputLabel/InputLabel.stories.jsx +1 -1
- package/stories/Link/ChevronLink.stories.jsx +1 -1
- package/stories/Link/Link.stories.jsx +28 -18
- package/stories/Link/TextButton.stories.jsx +1 -1
- package/stories/List/List.stories.jsx +117 -0
- package/stories/Modal/Modal.stories.jsx +29 -0
- package/stories/Notification/Notification.stories.jsx +82 -0
- package/stories/Pagination/Pagination.stories.jsx +1 -1
- package/stories/Progress/Progress.stories.jsx +93 -0
- package/stories/Radio/Radio.stories.jsx +100 -0
- package/stories/RadioCard/RadioCard.stories.jsx +98 -0
- package/stories/Search/Search.stories.jsx +16 -0
- package/stories/Select/Select.stories.jsx +55 -0
- package/stories/SideNav/SideNav.stories.jsx +1 -1
- package/stories/SideNav/SideNavItem.stories.jsx +1 -1
- package/stories/SideNav/SideNavItemsGroup.stories.jsx +1 -1
- package/stories/Skeleton/Skeleton.stories.jsx +36 -0
- package/stories/Spacer/Spacer.stories.jsx +1 -1
- package/stories/StackView/StackView.stories.jsx +1 -1
- package/stories/StackView/StackWrap.stories.jsx +1 -1
- package/stories/StepTracker/StepTracker.stories.jsx +71 -0
- package/stories/Tabs/Tabs.stories.jsx +97 -0
- package/stories/Tags/Tags.stories.jsx +69 -0
- package/stories/TextInput/TextArea.stories.jsx +100 -0
- package/stories/TextInput/TextInput.stories.jsx +1 -1
- package/stories/ToggleSwitch/ToggleSwitch.stories.jsx +1 -1
- package/stories/Tooltip/Tooltip.stories.jsx +1 -1
- package/stories/TooltipButton/TooltipButton.stories.jsx +1 -1
- package/stories/Typography/Typography.stories.jsx +1 -1
- package/stories/{platform-supports.web.jsx → platform-supports.jsx} +1 -1
- package/stories/supports.jsx +38 -4
- package/__fixtures__/accessible.icon.svg +0 -6
- package/babel.config.json +0 -8
- package/docs/Contributing.stories.mdx +0 -9
- package/docs/Fonts.stories.mdx +0 -104
- package/docs/Icons.stories.mdx +0 -144
- package/docs/Introduction.stories.mdx +0 -9
- package/lib/ActivityIndicator/Spinner.web.js +0 -55
- package/lib/InputLabel/LabelContent.web.js +0 -17
- package/lib/config/svgr-icons-web.js +0 -9
- package/lib/config/svgr-icons.js +0 -52
- package/src/InputLabel/LabelContent.web.jsx +0 -13
- package/src/config/svgr-icons-web.js +0 -11
- package/src/config/svgr-icons.js +0 -46
package/lib/utils/propTypes.js
CHANGED
|
@@ -1,12 +1,44 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
1
|
+
"use strict";
|
|
2
|
+
|
|
3
|
+
Object.defineProperty(exports, "__esModule", {
|
|
4
|
+
value: true
|
|
5
|
+
});
|
|
6
|
+
exports.copyPropTypes = exports.componentPropType = exports.spacingProps = exports.responsiveProps = exports.viewProps = exports.linkProps = exports.pressProps = exports.hrefAttrsProp = exports.a11yProps = exports.getTokensSetPropType = exports.getTokensPropType = exports.selectTokens = exports.getTokenNames = exports.variantProp = exports.rectProp = exports.paddingProp = void 0;
|
|
7
|
+
|
|
8
|
+
var _propTypes = _interopRequireDefault(require("prop-types"));
|
|
9
|
+
|
|
10
|
+
var _Linking = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Linking"));
|
|
11
|
+
|
|
12
|
+
var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
|
|
13
|
+
|
|
14
|
+
var _systemThemeTokens = require("@telus-uds/system-theme-tokens");
|
|
15
|
+
|
|
16
|
+
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
|
|
17
|
+
|
|
18
|
+
const paddingProp = {
|
|
19
|
+
propType: _propTypes.default.shape({
|
|
20
|
+
paddingBottom: _propTypes.default.number,
|
|
21
|
+
paddingLeft: _propTypes.default.number,
|
|
22
|
+
paddingRight: _propTypes.default.number,
|
|
23
|
+
paddingTop: _propTypes.default.number
|
|
24
|
+
})
|
|
25
|
+
};
|
|
26
|
+
exports.paddingProp = paddingProp;
|
|
27
|
+
const rectProp = {
|
|
28
|
+
propType: _propTypes.default.shape({
|
|
29
|
+
bottom: _propTypes.default.number,
|
|
30
|
+
left: _propTypes.default.number,
|
|
31
|
+
right: _propTypes.default.number,
|
|
32
|
+
top: _propTypes.default.number
|
|
33
|
+
})
|
|
34
|
+
};
|
|
4
35
|
/**
|
|
5
36
|
* @typedef {{[key: string]: string|number|boolean}} AppearanceSet
|
|
6
37
|
* @typedef {AppearanceSet} VariantProp
|
|
7
38
|
*/
|
|
8
39
|
|
|
9
|
-
|
|
40
|
+
exports.rectProp = rectProp;
|
|
41
|
+
const variantProp = {
|
|
10
42
|
/**
|
|
11
43
|
* 'variant' is an optional object prop on all themable components.
|
|
12
44
|
*
|
|
@@ -16,32 +48,68 @@ export const variantProp = {
|
|
|
16
48
|
* Since the particular keys and values depend on which theme is currently active,
|
|
17
49
|
* the exact shape of variant props is not enforced using PropTypes.
|
|
18
50
|
*/
|
|
19
|
-
propType:
|
|
20
|
-
}; // Tokens can be primitive values (e.g. `'rgba(0,0,0,0'`, `12`), or objects of such values
|
|
21
|
-
// such as tokens that describe shadow (e.g. shadow: { inset: true, color: 'rgba(...)' ... })
|
|
51
|
+
propType: _propTypes.default.objectOf(_propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number, _propTypes.default.bool]))
|
|
52
|
+
}; // Tokens can be primitive values (e.g. `'rgba(0,0,0,0'`, `12`), or objects of such values,
|
|
53
|
+
// such as tokens that describe shadow (e.g. shadow: { inset: true, color: 'rgba(...)' ... }),
|
|
54
|
+
// or components (e.g. Icon tokens)
|
|
55
|
+
|
|
56
|
+
exports.variantProp = variantProp;
|
|
57
|
+
|
|
58
|
+
const tokenValue = _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number, _propTypes.default.bool, _propTypes.default.elementType]);
|
|
22
59
|
|
|
23
|
-
const
|
|
24
|
-
const tokenValueType = PropTypes.oneOfType([tokenValue, PropTypes.objectOf(tokenValue)]);
|
|
60
|
+
const tokenValueType = _propTypes.default.oneOfType([tokenValue, _propTypes.default.objectOf(tokenValue)]);
|
|
25
61
|
|
|
26
62
|
const getTokenNames = componentName => {
|
|
27
|
-
const
|
|
63
|
+
const componentTokenSchema = _systemThemeTokens.components[componentName];
|
|
28
64
|
|
|
29
|
-
if (!
|
|
30
|
-
throw new Error(`No "${componentName}" tokenKeys in @telus-uds/
|
|
65
|
+
if (!componentTokenSchema) {
|
|
66
|
+
throw new Error(`No "${componentName}" tokenKeys in @telus-uds/system-theme-tokens`);
|
|
31
67
|
}
|
|
32
68
|
|
|
33
|
-
return
|
|
69
|
+
return Object.keys(componentTokenSchema);
|
|
34
70
|
};
|
|
35
71
|
/**
|
|
36
72
|
* Returns the subset of a set of tokens that may be accepted by the `tokens` prop of a named component
|
|
73
|
+
* or by a provided array of tokens. A prefix may be provided, for example:
|
|
74
|
+
*
|
|
75
|
+
* @example
|
|
76
|
+
* ```jsx
|
|
77
|
+
* // returns tokens from `themeTokens` that exist in the theme schema for `Button`.
|
|
78
|
+
* selectTokens('Button', themeTokens)
|
|
79
|
+
* ```
|
|
80
|
+
*
|
|
81
|
+
* @example
|
|
82
|
+
* ```jsx
|
|
83
|
+
* // returns `{ backgroundColor, width }` where the values of those keys come from
|
|
84
|
+
* // the source object's `{ containerBackgroundColor, containerWidth }` properties.
|
|
85
|
+
* selectTokens(['backgroundColor', 'width'], themeTokens, 'container')
|
|
86
|
+
* ```
|
|
87
|
+
*
|
|
88
|
+
* @example
|
|
89
|
+
* ```jsx
|
|
90
|
+
* // returns tokens that are defined in the `Button` theme schema, from tokens with
|
|
91
|
+
* // a prefix `'button'` e.g. a token `buttonBorderWidth` outputs as `borderWidth`.
|
|
92
|
+
* selectTokens('Button', themeTokens, 'button')
|
|
93
|
+
* ```
|
|
94
|
+
*
|
|
95
|
+
* @param {string[]|string} specifier - a name of a component in the theme schema, or an array of token names
|
|
96
|
+
* @param {object} tokens - a source object of theme tokens
|
|
97
|
+
* @param {string} [prefix] - if provided, matches keys in the source object with this as the first camelCase item
|
|
98
|
+
* @returns {object} - subset of theme tokens
|
|
37
99
|
*/
|
|
38
100
|
|
|
39
101
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
102
|
+
exports.getTokenNames = getTokenNames;
|
|
103
|
+
|
|
104
|
+
const selectTokens = (specifier, tokens, prefix) => {
|
|
105
|
+
const tokenNames = typeof specifier === 'string' ? getTokenNames(specifier) : specifier;
|
|
106
|
+
const filteredTokens = tokenNames.reduce((validTokens, key) => {
|
|
107
|
+
const prefixedKey = prefix ? `${prefix}${key[0].toUpperCase()}${key.slice(1)}` : key;
|
|
108
|
+
const token = tokens[prefixedKey];
|
|
109
|
+
return token !== undefined ? { ...validTokens,
|
|
110
|
+
[key]: token
|
|
111
|
+
} : validTokens;
|
|
112
|
+
}, {});
|
|
45
113
|
return filteredTokens;
|
|
46
114
|
};
|
|
47
115
|
/**
|
|
@@ -57,10 +125,65 @@ export const selectTokens = (componentName, tokens) => {
|
|
|
57
125
|
*
|
|
58
126
|
* This prop is intended to be used as an 'escape hatch' for difficult or exceptional cases
|
|
59
127
|
* where the main theming system doesn't apply. It is intentionally permissive about values.
|
|
128
|
+
*
|
|
129
|
+
* @param {...string} componentsNames - one or more ComponentName, which tokens keys are accepted
|
|
130
|
+
* @return {function} - a custom PropTypes validator
|
|
131
|
+
*
|
|
132
|
+
* @example
|
|
133
|
+
* Component.propTypes = {
|
|
134
|
+
* // accepts all tokens keys defined in Component schema
|
|
135
|
+
* tokens: getTokensPropType('Component')
|
|
136
|
+
* }
|
|
137
|
+
*
|
|
138
|
+
* Component.propTypes = {
|
|
139
|
+
* // accepts all tokens keys defined in schemas for Component1 and Component2
|
|
140
|
+
* tokens: getTokensPropType('Component1', 'Component2')
|
|
141
|
+
* }
|
|
142
|
+
*/
|
|
143
|
+
|
|
144
|
+
|
|
145
|
+
exports.selectTokens = selectTokens;
|
|
146
|
+
|
|
147
|
+
const getTokensPropType = (...componentsNames) => (props, propName, componentName) => {
|
|
148
|
+
_propTypes.default.checkPropTypes({
|
|
149
|
+
[propName]: _propTypes.default.oneOfType([_propTypes.default.object, _propTypes.default.func])
|
|
150
|
+
}, props, propName, componentName);
|
|
151
|
+
|
|
152
|
+
if (typeof props[propName] !== 'function') {
|
|
153
|
+
_propTypes.default.checkPropTypes({
|
|
154
|
+
[propName]: _propTypes.default.exact(Object.fromEntries(componentsNames.flatMap(component => getTokenNames(component).map(key => [key, tokenValueType]))))
|
|
155
|
+
}, props, propName, componentName);
|
|
156
|
+
}
|
|
157
|
+
};
|
|
158
|
+
/**
|
|
159
|
+
* Get a proptypes validator for a set of tokens that is not based on a component in the theme schema.
|
|
160
|
+
*
|
|
161
|
+
* For example, for a set of tokens used in a common style, or for a set of tokens required by
|
|
162
|
+
* a themeless component whose tokens are set by a parent but requires tokens of a certain shape.
|
|
163
|
+
*
|
|
164
|
+
* By default, requires an object with a complete set of tokens (allowing `null`, but not `undefined`).
|
|
165
|
+
*
|
|
166
|
+
* @param {string[]} componentTokenKeys - array of strings of token names
|
|
167
|
+
* @param {object} [options]
|
|
168
|
+
* @param {boolean} [options.partial] - if true, allows tokens to be undefined
|
|
169
|
+
* @param {boolean} [options.allowFunction] - if true, allows functions as well as tokens objects
|
|
170
|
+
* @returns
|
|
60
171
|
*/
|
|
61
172
|
|
|
62
|
-
|
|
63
|
-
|
|
173
|
+
|
|
174
|
+
exports.getTokensPropType = getTokensPropType;
|
|
175
|
+
|
|
176
|
+
const getTokensSetPropType = (componentTokenKeys, {
|
|
177
|
+
partial = false,
|
|
178
|
+
allowFunction = false
|
|
179
|
+
} = {}) => {
|
|
180
|
+
const tokensObjectValidator = _propTypes.default.exact(Object.fromEntries(componentTokenKeys.map(key => [key, partial ? tokenValueType : // Some theme tokens can validly resolve to `null`, but .isRequired treats null as undefined
|
|
181
|
+
(props, propName, ...args) => props[propName] !== null && tokenValueType.isRequired(props, propName, ...args)])));
|
|
182
|
+
|
|
183
|
+
return allowFunction ? _propTypes.default.oneOfType([tokensObjectValidator, _propTypes.default.func]) : tokensObjectValidator;
|
|
184
|
+
};
|
|
185
|
+
|
|
186
|
+
exports.getTokensSetPropType = getTokensSetPropType;
|
|
64
187
|
|
|
65
188
|
function getPropSelector(propTypes, regexp) {
|
|
66
189
|
const keys = Object.keys(propTypes);
|
|
@@ -72,40 +195,88 @@ function getPropSelector(propTypes, regexp) {
|
|
|
72
195
|
|
|
73
196
|
|
|
74
197
|
const a11yPropTypes = {
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
accessibilityHint: PropTypes.string,
|
|
198
|
+
accessible: _propTypes.default.bool,
|
|
199
|
+
focusable: _propTypes.default.bool,
|
|
200
|
+
accessibilityElementsHidden: _propTypes.default.bool,
|
|
201
|
+
accessibilityHint: _propTypes.default.string,
|
|
80
202
|
// react-native-web ignores `accessibilityHint`
|
|
81
|
-
accessibilityIgnoresInvertColors:
|
|
82
|
-
accessibilityLabel:
|
|
83
|
-
accessibilityRole:
|
|
84
|
-
accessibilityActions:
|
|
85
|
-
name:
|
|
86
|
-
label:
|
|
203
|
+
accessibilityIgnoresInvertColors: _propTypes.default.bool,
|
|
204
|
+
accessibilityLabel: _propTypes.default.string,
|
|
205
|
+
accessibilityRole: _propTypes.default.string,
|
|
206
|
+
accessibilityActions: _propTypes.default.arrayOf(_propTypes.default.shape({
|
|
207
|
+
name: _propTypes.default.string.isRequired,
|
|
208
|
+
label: _propTypes.default.string
|
|
87
209
|
})),
|
|
88
|
-
accessibilityLiveRegion:
|
|
89
|
-
accessibilityState:
|
|
90
|
-
disabled:
|
|
91
|
-
selected:
|
|
92
|
-
checked:
|
|
93
|
-
busy:
|
|
94
|
-
expanded:
|
|
210
|
+
accessibilityLiveRegion: _propTypes.default.oneOf(['none', 'polite', 'assertive']),
|
|
211
|
+
accessibilityState: _propTypes.default.shape({
|
|
212
|
+
disabled: _propTypes.default.bool,
|
|
213
|
+
selected: _propTypes.default.bool,
|
|
214
|
+
checked: _propTypes.default.oneOf([true, false, 'mixed']),
|
|
215
|
+
busy: _propTypes.default.bool,
|
|
216
|
+
expanded: _propTypes.default.bool
|
|
95
217
|
}),
|
|
96
|
-
accessibilityValue:
|
|
97
|
-
min:
|
|
98
|
-
max:
|
|
99
|
-
now:
|
|
100
|
-
text:
|
|
218
|
+
accessibilityValue: _propTypes.default.shape({
|
|
219
|
+
min: _propTypes.default.number,
|
|
220
|
+
max: _propTypes.default.number,
|
|
221
|
+
now: _propTypes.default.number,
|
|
222
|
+
text: _propTypes.default.string
|
|
101
223
|
}),
|
|
102
|
-
accessibilityViewIsModal:
|
|
103
|
-
importantForAccessibility:
|
|
104
|
-
onAccessibilityAction:
|
|
105
|
-
onAccessibilityEscape:
|
|
106
|
-
onAccessibilityTap:
|
|
224
|
+
accessibilityViewIsModal: _propTypes.default.bool,
|
|
225
|
+
importantForAccessibility: _propTypes.default.oneOf(['auto', 'yes', 'no', 'no-hide-descendants']),
|
|
226
|
+
onAccessibilityAction: _propTypes.default.func,
|
|
227
|
+
onAccessibilityEscape: _propTypes.default.func,
|
|
228
|
+
onAccessibilityTap: _propTypes.default.func,
|
|
229
|
+
..._Platform.default.select({
|
|
230
|
+
web: {
|
|
231
|
+
// React Native Web adds many a11y props that alias aria-* attributes
|
|
232
|
+
// Types based on https://necolas.github.io/react-native-web/docs/accessibility/
|
|
233
|
+
accessibilityActiveDescendant: _propTypes.default.string,
|
|
234
|
+
accessibilityAtomic: _propTypes.default.bool,
|
|
235
|
+
accessibilityAutoComplete: _propTypes.default.string,
|
|
236
|
+
accessibilityBusy: _propTypes.default.bool,
|
|
237
|
+
accessibilityChecked: _propTypes.default.oneOf([true, false, 'mixed']),
|
|
238
|
+
accessibilityColumnCount: _propTypes.default.number,
|
|
239
|
+
accessibilityColumnIndex: _propTypes.default.number,
|
|
240
|
+
accessibilityColumnSpan: _propTypes.default.number,
|
|
241
|
+
accessibilityControls: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.arrayOf(_propTypes.default.string)]),
|
|
242
|
+
accessibilityCurrent: _propTypes.default.oneOf([true, false, 'page', 'step', 'location', 'date', 'time']),
|
|
243
|
+
accessibilityDescribedBy: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.arrayOf(_propTypes.default.string)]),
|
|
244
|
+
accessibilityDetails: _propTypes.default.string,
|
|
245
|
+
accessibilityDisabled: _propTypes.default.bool,
|
|
246
|
+
accessibilityErrorMessage: _propTypes.default.string,
|
|
247
|
+
accessibilityExpanded: _propTypes.default.bool,
|
|
248
|
+
accessibilityFlowTo: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.arrayOf(_propTypes.default.string)]),
|
|
249
|
+
accessibilityHasPopup: _propTypes.default.string,
|
|
250
|
+
accessibilityHidden: _propTypes.default.bool,
|
|
251
|
+
accessibilityInvalid: _propTypes.default.bool,
|
|
252
|
+
accessibilityKeyShortcuts: _propTypes.default.string,
|
|
253
|
+
accessibilityLabelledBy: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.arrayOf(_propTypes.default.string)]),
|
|
254
|
+
accessibilityLevel: _propTypes.default.number,
|
|
255
|
+
accessibilityModal: _propTypes.default.bool,
|
|
256
|
+
accessibilityMultiline: _propTypes.default.bool,
|
|
257
|
+
accessibilityMultiSelectable: _propTypes.default.bool,
|
|
258
|
+
accessibilityOrientation: _propTypes.default.oneOf(['horizontal', 'vertical']),
|
|
259
|
+
accessibilityOwns: _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.arrayOf(_propTypes.default.string)]),
|
|
260
|
+
accessibilityPlaceholder: _propTypes.default.string,
|
|
261
|
+
accessibilityPosInSet: _propTypes.default.number,
|
|
262
|
+
accessibilityPressed: _propTypes.default.bool,
|
|
263
|
+
accessibilityReadOnly: _propTypes.default.bool,
|
|
264
|
+
accessibilityRequired: _propTypes.default.bool,
|
|
265
|
+
accessibilityRoleDescription: _propTypes.default.string,
|
|
266
|
+
accessibilityRowCount: _propTypes.default.number,
|
|
267
|
+
accessibilityRowIndex: _propTypes.default.number,
|
|
268
|
+
accessibilityRowSpan: _propTypes.default.number,
|
|
269
|
+
accessibilitySelected: _propTypes.default.bool,
|
|
270
|
+
accessibilitySetSize: _propTypes.default.number,
|
|
271
|
+
accessibilitySort: _propTypes.default.oneOf(['ascending', 'descending', 'none', 'other']),
|
|
272
|
+
accessibilityValueMax: _propTypes.default.number,
|
|
273
|
+
accessibilityValueMin: _propTypes.default.number,
|
|
274
|
+
accessibilityValueNow: _propTypes.default.number,
|
|
275
|
+
accessibilityValueText: _propTypes.default.string
|
|
276
|
+
}
|
|
277
|
+
})
|
|
107
278
|
};
|
|
108
|
-
|
|
279
|
+
const a11yProps = {
|
|
109
280
|
/**
|
|
110
281
|
* Proptypes for recognised React Native accessiblity (a11y) props.
|
|
111
282
|
* Spread this in the propTypes of components that accept React Native a11y props.
|
|
@@ -125,11 +296,9 @@ export const a11yProps = {
|
|
|
125
296
|
*/
|
|
126
297
|
nonFocusableProps: {
|
|
127
298
|
focusable: false,
|
|
128
|
-
// for android, and for keyboard nav in web
|
|
129
|
-
...
|
|
299
|
+
// for android, and for keyboard nav in web
|
|
300
|
+
..._Platform.default.select({
|
|
130
301
|
web: {
|
|
131
|
-
accessible: false,
|
|
132
|
-
// workaround for web keyboard nav in RNW < 0.15.x
|
|
133
302
|
accessibilityHidden: true // web screenreaders
|
|
134
303
|
|
|
135
304
|
},
|
|
@@ -140,17 +309,38 @@ export const a11yProps = {
|
|
|
140
309
|
accessibilityElementsHidden: true
|
|
141
310
|
}
|
|
142
311
|
})
|
|
143
|
-
}
|
|
312
|
+
},
|
|
313
|
+
|
|
314
|
+
/**
|
|
315
|
+
* Generates an object of platform-appropriate a11y props describing an item that has an
|
|
316
|
+
* ordered position in a set. Examples of usage by accessibility tools includes screenreaders
|
|
317
|
+
* saying "Item X of Y" when this item is select.
|
|
318
|
+
*
|
|
319
|
+
* @param {number} itemsCount - the number of items in the set
|
|
320
|
+
* @param {number} index - the current item's index in the set
|
|
321
|
+
* @returns {object} - platform-applicable a11y props describing this position (if available)
|
|
322
|
+
*/
|
|
323
|
+
getPositionInSet: (itemsCount, index) => _Platform.default.select({
|
|
324
|
+
web: {
|
|
325
|
+
// accessibilityPosInSet etc exists in React Native Web main branch
|
|
326
|
+
// but not in a release compatible with Expo etc; just use `aria-*`
|
|
327
|
+
'aria-setsize': itemsCount,
|
|
328
|
+
'aria-posinset': index + 1
|
|
329
|
+
},
|
|
330
|
+
// No equivalents exist on the native side
|
|
331
|
+
default: {}
|
|
332
|
+
})
|
|
144
333
|
}; // Props related to HTML <a> anchor link attributes.
|
|
145
334
|
|
|
335
|
+
exports.a11yProps = a11yProps;
|
|
146
336
|
const targetValues = ['_self', '_blank', '_parent', '_top'];
|
|
147
|
-
|
|
337
|
+
const hrefAttrsProp = {
|
|
148
338
|
types: {
|
|
149
339
|
// React Native Web >= 0.15.0 supports hrefAttrs prop with only these properties
|
|
150
340
|
// and passes them to <a> if an element has a href prop or accessibilityRole "link"
|
|
151
|
-
download:
|
|
152
|
-
rel:
|
|
153
|
-
target:
|
|
341
|
+
download: _propTypes.default.string,
|
|
342
|
+
rel: _propTypes.default.string,
|
|
343
|
+
target: _propTypes.default.oneOf(targetValues)
|
|
154
344
|
},
|
|
155
345
|
|
|
156
346
|
/**
|
|
@@ -169,46 +359,36 @@ export const hrefAttrsProp = {
|
|
|
169
359
|
target
|
|
170
360
|
},
|
|
171
361
|
rest
|
|
172
|
-
}),
|
|
173
|
-
|
|
174
|
-
/**
|
|
175
|
-
* Takes a hrefAttrs object and returns an object that can be spread into Pressable props
|
|
176
|
-
* in a way that handles compatibility before and after React Native Web 0.15.0
|
|
177
|
-
*/
|
|
178
|
-
spread: hrefAttrs => ({
|
|
179
|
-
/**
|
|
180
|
-
* React Native Web >= 0.15.0 supports hrefAttrs prop but requires React 17
|
|
181
|
-
* so is incompatible with Expo until July 2021
|
|
182
|
-
*/
|
|
183
|
-
hrefAttrs,
|
|
184
|
-
|
|
185
|
-
/**
|
|
186
|
-
* React Native Web < 0.15.0 uses `target` and `rel` props.
|
|
187
|
-
* React Native Web >= 0.15.0 ignores these and reads hrefAttrs only.
|
|
188
|
-
*/
|
|
189
|
-
rel: hrefAttrs?.rel,
|
|
190
|
-
target: hrefAttrs?.target
|
|
191
|
-
/**
|
|
192
|
-
* Don't spread hrefAttrs.download, RNW <0.15.0 doesn't support it.
|
|
193
|
-
*/
|
|
194
|
-
|
|
195
362
|
})
|
|
196
363
|
};
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
364
|
+
exports.hrefAttrsProp = hrefAttrsProp;
|
|
365
|
+
const pressHandlerPropTypes = {
|
|
366
|
+
onPress: _propTypes.default.func,
|
|
367
|
+
onPressIn: _propTypes.default.func,
|
|
368
|
+
onPressOut: _propTypes.default.func,
|
|
369
|
+
..._Platform.default.select({
|
|
202
370
|
web: {
|
|
203
|
-
onMouseEnter:
|
|
204
|
-
onMouseLeave:
|
|
205
|
-
onFocus:
|
|
206
|
-
onBlur:
|
|
371
|
+
onMouseEnter: _propTypes.default.func,
|
|
372
|
+
onMouseLeave: _propTypes.default.func,
|
|
373
|
+
onFocus: _propTypes.default.func,
|
|
374
|
+
onBlur: _propTypes.default.func
|
|
207
375
|
},
|
|
208
|
-
default: {
|
|
376
|
+
default: {
|
|
377
|
+
onLongPress: _propTypes.default.func
|
|
378
|
+
}
|
|
379
|
+
})
|
|
380
|
+
};
|
|
381
|
+
const pressPropTypes = { ...pressHandlerPropTypes,
|
|
382
|
+
disabled: _propTypes.default.bool,
|
|
383
|
+
..._Platform.default.select({
|
|
384
|
+
web: {},
|
|
385
|
+
default: {
|
|
386
|
+
hitSlop: _propTypes.default.number,
|
|
387
|
+
pressRetentionOffset: _propTypes.default.oneOfType([_propTypes.default.number, rectProp.propType])
|
|
388
|
+
}
|
|
209
389
|
})
|
|
210
390
|
};
|
|
211
|
-
|
|
391
|
+
const pressProps = {
|
|
212
392
|
/**
|
|
213
393
|
* Proptypes for clickable or pressable components, including web-only props
|
|
214
394
|
*/
|
|
@@ -217,14 +397,16 @@ export const pressProps = {
|
|
|
217
397
|
/**
|
|
218
398
|
* Filters a props object, returning only the platform-relevant press props defined above
|
|
219
399
|
*/
|
|
220
|
-
select: getPropSelector(pressPropTypes)
|
|
400
|
+
select: getPropSelector(pressPropTypes),
|
|
401
|
+
selectHandlers: getPropSelector(pressHandlerPropTypes)
|
|
221
402
|
};
|
|
403
|
+
exports.pressProps = pressProps;
|
|
222
404
|
const linkPropTypes = { ...pressPropTypes,
|
|
223
|
-
href:
|
|
224
|
-
hrefAttrs:
|
|
405
|
+
href: _propTypes.default.string,
|
|
406
|
+
hrefAttrs: _propTypes.default.shape(hrefAttrsProp.types),
|
|
225
407
|
...a11yPropTypes
|
|
226
408
|
};
|
|
227
|
-
|
|
409
|
+
const linkProps = {
|
|
228
410
|
/**
|
|
229
411
|
* Proptypes for components that, on Web, can output <a href="..."> link elements
|
|
230
412
|
*/
|
|
@@ -236,7 +418,7 @@ export const linkProps = {
|
|
|
236
418
|
select: getPropSelector(linkPropTypes),
|
|
237
419
|
|
|
238
420
|
/**
|
|
239
|
-
* Turn hrefs into press handlers on Native and throw if not given `onPress`
|
|
421
|
+
* Turn hrefs into press handlers on Native and throw if not given `onPress` or `href`.
|
|
240
422
|
*
|
|
241
423
|
* @param {({ onPress?: () => void, href?: string })}
|
|
242
424
|
* @returns {(() => void)|undefined} Returns a press handler, or undefined on web if href
|
|
@@ -246,19 +428,40 @@ export const linkProps = {
|
|
|
246
428
|
onPress,
|
|
247
429
|
href
|
|
248
430
|
}) => {
|
|
249
|
-
// TODO: revisit this when integrating routing packages
|
|
250
|
-
// https://github.com/telus/universal-design-system/issues/24
|
|
251
|
-
if (href && onPress) {
|
|
252
|
-
throw new Error("handleHref currently doesn't support both href and onPress");
|
|
253
|
-
}
|
|
254
|
-
|
|
255
431
|
if (!href && !onPress) {
|
|
256
432
|
throw new Error('handleHref requires either href or onPress');
|
|
257
433
|
}
|
|
258
434
|
|
|
259
|
-
return
|
|
435
|
+
return _Platform.default.select({
|
|
436
|
+
web: onPress,
|
|
437
|
+
default: (...args) => {
|
|
438
|
+
if (onPress) onPress(...args);
|
|
439
|
+
if (href) _Linking.default.openURL(href);
|
|
440
|
+
}
|
|
441
|
+
});
|
|
260
442
|
}
|
|
261
443
|
};
|
|
444
|
+
exports.linkProps = linkProps;
|
|
445
|
+
const viewPropTypes = {
|
|
446
|
+
pointerEvents: _propTypes.default.oneOf(['all', 'none', 'box-only', 'box-none']),
|
|
447
|
+
onLayout: _propTypes.default.func,
|
|
448
|
+
nativeID: _propTypes.default.string,
|
|
449
|
+
testID: _propTypes.default.string
|
|
450
|
+
};
|
|
451
|
+
const viewProps = {
|
|
452
|
+
/**
|
|
453
|
+
* Subset of `View` proptypes that could conceivably be needed on any component
|
|
454
|
+
* that renders a single View.
|
|
455
|
+
*/
|
|
456
|
+
types: viewPropTypes,
|
|
457
|
+
|
|
458
|
+
/**
|
|
459
|
+
* Filters a props object, returning only cross-platform View props that are potentially
|
|
460
|
+
* relevant to any basic layout component that renders one View.
|
|
461
|
+
*/
|
|
462
|
+
select: getPropSelector(viewPropTypes)
|
|
463
|
+
};
|
|
464
|
+
exports.viewProps = viewProps;
|
|
262
465
|
|
|
263
466
|
const getByViewport = propType => ({
|
|
264
467
|
xs: propType,
|
|
@@ -283,10 +486,10 @@ const getByViewport = propType => ({
|
|
|
283
486
|
*/
|
|
284
487
|
|
|
285
488
|
|
|
286
|
-
|
|
489
|
+
const responsiveProps = {
|
|
287
490
|
getByViewport,
|
|
288
|
-
getTypeByViewport: propType =>
|
|
289
|
-
getTypeOptionallyByViewport: propType =>
|
|
491
|
+
getTypeByViewport: propType => _propTypes.default.shape(getByViewport(propType)),
|
|
492
|
+
getTypeOptionallyByViewport: propType => _propTypes.default.oneOfType([propType, _propTypes.default.shape(getByViewport(propType))])
|
|
290
493
|
};
|
|
291
494
|
/**
|
|
292
495
|
* @typedef {0|1|2|3|4|5|6|7|8|9|10|11} SpacingIndex - value used to select a size on the spacing scale
|
|
@@ -308,13 +511,16 @@ export const responsiveProps = {
|
|
|
308
511
|
* @typedef {SpacingIndex|SpacingObject} SpacingValue
|
|
309
512
|
*/
|
|
310
513
|
|
|
514
|
+
exports.responsiveProps = responsiveProps;
|
|
311
515
|
const spacingScale = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
|
|
312
|
-
|
|
313
|
-
const
|
|
516
|
+
|
|
517
|
+
const spacingIndexPropType = _propTypes.default.oneOf(spacingScale);
|
|
518
|
+
|
|
519
|
+
const spacingObjectPropType = _propTypes.default.shape({ ...responsiveProps.getByViewport(spacingIndexPropType),
|
|
314
520
|
space: spacingIndexPropType,
|
|
315
|
-
options:
|
|
521
|
+
options: _propTypes.default.shape({
|
|
316
522
|
variant: variantProp.propType,
|
|
317
|
-
size:
|
|
523
|
+
size: _propTypes.default.number
|
|
318
524
|
})
|
|
319
525
|
});
|
|
320
526
|
/**
|
|
@@ -332,31 +538,35 @@ const spacingObjectPropType = PropTypes.shape({ ...responsiveProps.getByViewport
|
|
|
332
538
|
* viewports or `space` to apply at all viewports.
|
|
333
539
|
*/
|
|
334
540
|
|
|
335
|
-
|
|
541
|
+
|
|
542
|
+
const spacingProps = {
|
|
336
543
|
scale: spacingScale,
|
|
337
544
|
types: {
|
|
338
545
|
spacingIndex: spacingIndexPropType,
|
|
339
546
|
spacingObject: spacingObjectPropType,
|
|
340
547
|
// Most spacing components and utilities take this prop / arg type:
|
|
341
|
-
spacingValue:
|
|
548
|
+
spacingValue: _propTypes.default.oneOfType([spacingIndexPropType, spacingObjectPropType])
|
|
342
549
|
}
|
|
343
550
|
};
|
|
344
551
|
/**
|
|
345
|
-
* Returns a prop type validator which checks whether a prop is either a component or an array of
|
|
346
|
-
* type, based on their `name`
|
|
552
|
+
* Returns a prop type validator which checks whether a prop is either a component or an array of
|
|
553
|
+
* components of a given type, based on their `name` or `displayName` properties.
|
|
347
554
|
* Use an array of strings for `passedName` to accept more than one component type.
|
|
348
555
|
* For an array the validation fails on the first occurrence of an invalid element.
|
|
349
556
|
*
|
|
350
557
|
* @param {string|string[]} passedName
|
|
351
|
-
* @param {boolean} [checkDisplayName] - if `true` then `displayName` property on the component will be validated instead of `name`
|
|
352
558
|
* @return {function}
|
|
353
559
|
*/
|
|
354
560
|
|
|
355
|
-
|
|
561
|
+
exports.spacingProps = spacingProps;
|
|
562
|
+
|
|
563
|
+
const componentPropType = passedName => {
|
|
356
564
|
const passedNames = typeof passedName === 'string' ? [passedName] : passedName;
|
|
357
565
|
|
|
358
566
|
const checkProp = (props, propName, componentName) => {
|
|
359
|
-
|
|
567
|
+
var _props$propName$type, _props$propName$type2;
|
|
568
|
+
|
|
569
|
+
if (props[propName] === undefined || props[propName] === null) {
|
|
360
570
|
return undefined;
|
|
361
571
|
}
|
|
362
572
|
|
|
@@ -366,12 +576,11 @@ export const componentPropType = (passedName, checkDisplayName = false) => {
|
|
|
366
576
|
return props[propName].map((_, index) => checkProp(props[propName], index, componentName)).find(Boolean);
|
|
367
577
|
}
|
|
368
578
|
|
|
369
|
-
const
|
|
579
|
+
const nameInProp = ((_props$propName$type = props[propName].type) === null || _props$propName$type === void 0 ? void 0 : _props$propName$type.displayName) || ((_props$propName$type2 = props[propName].type) === null || _props$propName$type2 === void 0 ? void 0 : _props$propName$type2.name);
|
|
370
580
|
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
return new Error(`${componentName}: Component passed to \`${propName}\` prop should be ${passedNames.join(' or ')}`);
|
|
581
|
+
if (!nameInProp || !passedNames.includes(nameInProp)) {
|
|
582
|
+
const propDescription = nameInProp ? `Component ${nameInProp}` : typeof props[propName];
|
|
583
|
+
return new Error(`${componentName}: ${propDescription} was passed to \`${propName}\` prop; should be ${passedNames.join(' or ')}`);
|
|
375
584
|
}
|
|
376
585
|
|
|
377
586
|
return undefined;
|
|
@@ -405,12 +614,9 @@ export const componentPropType = (passedName, checkDisplayName = false) => {
|
|
|
405
614
|
validate.isRequired = createValidate(true);
|
|
406
615
|
return validate;
|
|
407
616
|
};
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
paddingTop: PropTypes.number
|
|
415
|
-
})
|
|
416
|
-
};
|
|
617
|
+
|
|
618
|
+
exports.componentPropType = componentPropType;
|
|
619
|
+
|
|
620
|
+
const copyPropTypes = _propTypes.default.oneOf(['en', 'fr']);
|
|
621
|
+
|
|
622
|
+
exports.copyPropTypes = copyPropTypes;
|