@telus-uds/components-base 1.8.1 → 1.8.2
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/CHANGELOG.md +13 -2
- package/component-docs.json +682 -675
- package/lib/A11yInfoProvider/index.js +4 -3
- package/lib/A11yText/index.js +6 -5
- package/lib/ActivityIndicator/Spinner.js +7 -6
- package/lib/ActivityIndicator/Spinner.native.js +8 -6
- package/lib/ActivityIndicator/index.js +6 -5
- package/lib/ActivityIndicator/shared.js +1 -1
- package/lib/BaseProvider/index.js +13 -10
- package/lib/Box/Box.js +20 -19
- package/lib/Button/Button.js +7 -6
- package/lib/Button/ButtonBase.js +95 -77
- package/lib/Button/ButtonGroup.js +33 -31
- package/lib/Button/ButtonLink.js +9 -7
- package/lib/Button/index.js +4 -4
- package/lib/Button/propTypes.js +1 -1
- package/lib/Card/Card.js +8 -7
- package/lib/Card/CardBase.js +35 -31
- package/lib/Card/PressableCardBase.js +14 -12
- package/lib/Checkbox/Checkbox.js +96 -82
- package/lib/Checkbox/CheckboxGroup.js +27 -25
- package/lib/Checkbox/CheckboxInput.js +12 -10
- package/lib/Divider/Divider.js +8 -7
- package/lib/ExpandCollapse/Control.js +42 -36
- package/lib/ExpandCollapse/ExpandCollapse.js +11 -10
- package/lib/ExpandCollapse/Panel.js +27 -23
- package/lib/Feedback/Feedback.js +48 -35
- package/lib/Fieldset/Fieldset.js +16 -15
- package/lib/Fieldset/FieldsetContainer.js +16 -13
- package/lib/Fieldset/FieldsetContainer.native.js +11 -8
- package/lib/Fieldset/Legend.js +10 -7
- package/lib/Fieldset/Legend.native.js +10 -7
- package/lib/FlexGrid/Col/Col.js +17 -16
- package/lib/FlexGrid/FlexGrid.js +15 -14
- package/lib/FlexGrid/Row/Row.js +13 -12
- package/lib/HorizontalScroll/HorizontalScroll.js +25 -20
- package/lib/HorizontalScroll/HorizontalScrollButton.js +18 -14
- package/lib/HorizontalScroll/ScrollViewEnd.js +6 -5
- package/lib/HorizontalScroll/ScrollViewEnd.native.js +12 -9
- package/lib/HorizontalScroll/itemPositions.js +19 -13
- package/lib/Icon/Icon.js +10 -9
- package/lib/Icon/IconText.js +8 -7
- package/lib/Icon/index.js +5 -5
- package/lib/IconButton/IconButton.js +50 -42
- package/lib/InputLabel/InputLabel.js +37 -30
- package/lib/InputLabel/LabelContent.js +12 -9
- package/lib/InputLabel/LabelContent.native.js +9 -6
- package/lib/InputSupports/InputSupports.js +11 -10
- package/lib/InputSupports/useInputSupports.js +7 -6
- package/lib/Link/ChevronLink.js +9 -8
- package/lib/Link/InlinePressable.js +13 -10
- package/lib/Link/InlinePressable.native.js +20 -16
- package/lib/Link/Link.js +10 -9
- package/lib/Link/LinkBase.js +96 -78
- package/lib/Link/TextButton.js +9 -8
- package/lib/List/List.js +9 -7
- package/lib/List/ListItem.js +99 -74
- package/lib/Modal/Modal.js +72 -59
- package/lib/Notification/Notification.js +46 -33
- package/lib/Pagination/PageButton.js +11 -10
- package/lib/Pagination/Pagination.js +39 -28
- package/lib/Pagination/SideButton.js +21 -18
- package/lib/Pagination/usePagination.js +5 -4
- package/lib/Progress/Progress.js +23 -19
- package/lib/Progress/ProgressBar.js +23 -19
- package/lib/Progress/ProgressBarBackground.js +4 -3
- package/lib/Radio/Radio.js +79 -68
- package/lib/Radio/RadioButton.js +63 -53
- package/lib/Radio/RadioGroup.js +28 -26
- package/lib/Radio/RadioInput.js +12 -10
- package/lib/RadioCard/RadioCard.js +15 -14
- package/lib/RadioCard/RadioCardGroup.js +28 -26
- package/lib/Search/Search.js +51 -31
- package/lib/Select/Group.js +5 -4
- package/lib/Select/Group.native.js +4 -3
- package/lib/Select/Item.js +10 -7
- package/lib/Select/Item.native.js +1 -9
- package/lib/Select/Picker.js +16 -15
- package/lib/Select/Picker.native.js +49 -38
- package/lib/Select/Select.js +134 -113
- package/lib/SideNav/Item.js +39 -33
- package/lib/SideNav/ItemContent.js +15 -12
- package/lib/SideNav/ItemsGroup.js +13 -11
- package/lib/SideNav/SideNav.js +19 -16
- package/lib/Skeleton/Skeleton.js +60 -44
- package/lib/Skeleton/skeleton.constant.js +1 -1
- package/lib/Spacer/Spacer.js +6 -5
- package/lib/StackView/StackView.js +12 -11
- package/lib/StackView/StackWrap.js +2 -2
- package/lib/StackView/StackWrapBox.js +12 -11
- package/lib/StackView/StackWrapGap.js +11 -10
- package/lib/StackView/common.js +14 -11
- package/lib/StackView/getStackedContent.js +8 -7
- package/lib/StackView/index.js +1 -1
- package/lib/StepTracker/Step.js +122 -103
- package/lib/StepTracker/StepTracker.js +48 -38
- package/lib/Tabs/Tabs.js +29 -24
- package/lib/Tabs/TabsItem.js +79 -68
- package/lib/Tags/Tags.js +67 -61
- package/lib/TextInput/TextArea.js +26 -20
- package/lib/TextInput/TextInput.js +20 -15
- package/lib/TextInput/TextInputBase.js +74 -62
- package/lib/TextInput/index.js +4 -4
- package/lib/ThemeProvider/ThemeProvider.js +6 -5
- package/lib/ThemeProvider/index.js +5 -5
- package/lib/ThemeProvider/useSetTheme.js +6 -3
- package/lib/ThemeProvider/useThemeTokens.js +7 -2
- package/lib/ThemeProvider/utils/styles.js +48 -41
- package/lib/ThemeProvider/utils/theme-tokens.js +26 -12
- package/lib/ToggleSwitch/ToggleSwitch.js +89 -73
- package/lib/ToggleSwitch/ToggleSwitchGroup.js +36 -34
- package/lib/Tooltip/Backdrop.js +4 -3
- package/lib/Tooltip/Backdrop.native.js +5 -4
- package/lib/Tooltip/Tooltip.js +81 -65
- package/lib/Tooltip/getTooltipPosition.js +29 -18
- package/lib/TooltipButton/TooltipButton.js +28 -21
- package/lib/Typography/Typography.js +37 -33
- package/lib/ViewportProvider/ViewportProvider.js +4 -3
- package/lib/ViewportProvider/useViewportListener.js +6 -3
- package/lib/index.js +54 -54
- package/lib/utils/a11y/semantics.js +5 -2
- package/lib/utils/a11y/textSize.js +8 -6
- package/lib/utils/animation/useVerticalExpandAnimation.js +6 -5
- package/lib/utils/children.js +2 -1
- package/lib/utils/index.js +10 -10
- package/lib/utils/input.js +22 -17
- package/lib/utils/pressability.js +36 -22
- package/lib/utils/props/clickProps.js +2 -1
- package/lib/utils/props/getPropSelector.js +6 -3
- package/lib/utils/props/handlerProps.js +25 -19
- package/lib/utils/props/hrefAttrsProp.js +14 -11
- package/lib/utils/props/index.js +12 -12
- package/lib/utils/props/inputSupportsProps.js +15 -12
- package/lib/utils/props/linkProps.js +7 -6
- package/lib/utils/props/pressProps.js +1 -1
- package/lib/utils/props/tokens.js +27 -13
- package/lib/utils/ssr.js +6 -2
- package/lib/utils/useCopy.js +6 -4
- package/lib/utils/useHash.js +2 -1
- package/lib/utils/useResponsiveProp.js +1 -1
- package/lib/utils/useUniqueId.js +2 -1
- package/lib/utils/withLinkRouter.js +6 -5
- package/package.json +11 -10
- package/src/Pagination/Pagination.jsx +3 -0
- package/src/Search/Search.jsx +11 -0
- package/src/Select/Item.native.jsx +0 -7
- package/lib-module/A11yInfoProvider/index.js +0 -62
- package/lib-module/A11yText/index.js +0 -55
- package/lib-module/ActivityIndicator/Spinner.js +0 -76
- package/lib-module/ActivityIndicator/Spinner.native.js +0 -143
- package/lib-module/ActivityIndicator/index.js +0 -40
- package/lib-module/ActivityIndicator/shared.js +0 -12
- package/lib-module/BaseProvider/index.js +0 -26
- package/lib-module/Box/Box.js +0 -243
- package/lib-module/Box/index.js +0 -2
- package/lib-module/Button/Button.js +0 -25
- package/lib-module/Button/ButtonBase.js +0 -254
- package/lib-module/Button/ButtonGroup.js +0 -245
- package/lib-module/Button/ButtonLink.js +0 -39
- package/lib-module/Button/index.js +0 -4
- package/lib-module/Button/propTypes.js +0 -36
- package/lib-module/Card/Card.js +0 -83
- package/lib-module/Card/CardBase.js +0 -62
- package/lib-module/Card/PressableCardBase.js +0 -113
- package/lib-module/Card/index.js +0 -4
- package/lib-module/Checkbox/Checkbox.js +0 -332
- package/lib-module/Checkbox/CheckboxGroup.js +0 -231
- package/lib-module/Checkbox/CheckboxInput.js +0 -58
- package/lib-module/Checkbox/CheckboxInput.native.js +0 -6
- package/lib-module/Checkbox/index.js +0 -3
- package/lib-module/Divider/Divider.js +0 -123
- package/lib-module/Divider/index.js +0 -2
- package/lib-module/ExpandCollapse/Accordion.js +0 -15
- package/lib-module/ExpandCollapse/Control.js +0 -130
- package/lib-module/ExpandCollapse/ExpandCollapse.js +0 -94
- package/lib-module/ExpandCollapse/Panel.js +0 -159
- package/lib-module/ExpandCollapse/index.js +0 -7
- package/lib-module/Feedback/Feedback.js +0 -144
- package/lib-module/Feedback/index.js +0 -2
- package/lib-module/Fieldset/Fieldset.js +0 -152
- package/lib-module/Fieldset/FieldsetContainer.js +0 -29
- package/lib-module/Fieldset/FieldsetContainer.native.js +0 -20
- package/lib-module/Fieldset/Legend.js +0 -21
- package/lib-module/Fieldset/Legend.native.js +0 -28
- package/lib-module/Fieldset/cssReset.js +0 -14
- package/lib-module/Fieldset/index.js +0 -2
- package/lib-module/FlexGrid/Col/Col.js +0 -275
- package/lib-module/FlexGrid/Col/index.js +0 -2
- package/lib-module/FlexGrid/FlexGrid.js +0 -147
- package/lib-module/FlexGrid/Row/Row.js +0 -183
- package/lib-module/FlexGrid/Row/index.js +0 -2
- package/lib-module/FlexGrid/helpers/index.js +0 -18
- package/lib-module/FlexGrid/index.js +0 -2
- package/lib-module/FlexGrid/providers/GutterContext.js +0 -3
- package/lib-module/HorizontalScroll/HorizontalScroll.js +0 -170
- package/lib-module/HorizontalScroll/HorizontalScrollButton.js +0 -77
- package/lib-module/HorizontalScroll/ScrollViewEnd.js +0 -47
- package/lib-module/HorizontalScroll/ScrollViewEnd.native.js +0 -24
- package/lib-module/HorizontalScroll/dictionary.js +0 -11
- package/lib-module/HorizontalScroll/index.js +0 -11
- package/lib-module/HorizontalScroll/itemPositions.js +0 -106
- package/lib-module/Icon/Icon.js +0 -61
- package/lib-module/Icon/IconText.js +0 -81
- package/lib-module/Icon/index.js +0 -4
- package/lib-module/IconButton/IconButton.js +0 -115
- package/lib-module/IconButton/index.js +0 -2
- package/lib-module/InputLabel/InputLabel.js +0 -141
- package/lib-module/InputLabel/LabelContent.js +0 -24
- package/lib-module/InputLabel/LabelContent.native.js +0 -16
- package/lib-module/InputLabel/index.js +0 -2
- package/lib-module/InputSupports/InputSupports.js +0 -95
- package/lib-module/InputSupports/index.js +0 -2
- package/lib-module/InputSupports/useInputSupports.js +0 -31
- package/lib-module/Link/ChevronLink.js +0 -51
- package/lib-module/Link/InlinePressable.js +0 -37
- package/lib-module/Link/InlinePressable.native.js +0 -85
- package/lib-module/Link/Link.js +0 -27
- package/lib-module/Link/LinkBase.js +0 -223
- package/lib-module/Link/TextButton.js +0 -34
- package/lib-module/Link/index.js +0 -5
- package/lib-module/List/List.js +0 -55
- package/lib-module/List/ListItem.js +0 -223
- package/lib-module/List/index.js +0 -5
- package/lib-module/Modal/Modal.js +0 -208
- package/lib-module/Modal/dictionary.js +0 -9
- package/lib-module/Modal/index.js +0 -2
- package/lib-module/Notification/Notification.js +0 -196
- package/lib-module/Notification/dictionary.js +0 -8
- package/lib-module/Notification/index.js +0 -2
- package/lib-module/Pagination/PageButton.js +0 -65
- package/lib-module/Pagination/Pagination.js +0 -140
- package/lib-module/Pagination/SideButton.js +0 -103
- package/lib-module/Pagination/dictionary.js +0 -18
- package/lib-module/Pagination/index.js +0 -2
- package/lib-module/Pagination/usePagination.js +0 -72
- package/lib-module/Progress/Progress.js +0 -85
- package/lib-module/Progress/ProgressBar.js +0 -134
- package/lib-module/Progress/ProgressBarBackground.js +0 -41
- package/lib-module/Progress/index.js +0 -4
- package/lib-module/Radio/Radio.js +0 -274
- package/lib-module/Radio/RadioButton.js +0 -128
- package/lib-module/Radio/RadioGroup.js +0 -241
- package/lib-module/Radio/RadioInput.js +0 -60
- package/lib-module/Radio/RadioInput.native.js +0 -6
- package/lib-module/Radio/index.js +0 -3
- package/lib-module/RadioCard/RadioCard.js +0 -218
- package/lib-module/RadioCard/RadioCardGroup.js +0 -248
- package/lib-module/RadioCard/index.js +0 -3
- package/lib-module/Search/Search.js +0 -241
- package/lib-module/Search/dictionary.js +0 -12
- package/lib-module/Search/index.js +0 -2
- package/lib-module/Select/Group.js +0 -20
- package/lib-module/Select/Group.native.js +0 -14
- package/lib-module/Select/Item.js +0 -17
- package/lib-module/Select/Item.native.js +0 -9
- package/lib-module/Select/Picker.js +0 -67
- package/lib-module/Select/Picker.native.js +0 -110
- package/lib-module/Select/Select.js +0 -316
- package/lib-module/Select/index.js +0 -6
- package/lib-module/SideNav/Item.js +0 -139
- package/lib-module/SideNav/ItemContent.js +0 -45
- package/lib-module/SideNav/ItemsGroup.js +0 -115
- package/lib-module/SideNav/SideNav.js +0 -133
- package/lib-module/SideNav/index.js +0 -1
- package/lib-module/Skeleton/Skeleton.js +0 -163
- package/lib-module/Skeleton/index.js +0 -2
- package/lib-module/Skeleton/skeleton.constant.js +0 -3
- package/lib-module/Skeleton/skeletonWebAnimation.js +0 -18
- package/lib-module/Skeleton/useSkeletonNativeAnimation.js +0 -24
- package/lib-module/Spacer/Spacer.js +0 -97
- package/lib-module/Spacer/index.js +0 -2
- package/lib-module/StackView/StackView.js +0 -124
- package/lib-module/StackView/StackWrap.js +0 -48
- package/lib-module/StackView/StackWrap.native.js +0 -3
- package/lib-module/StackView/StackWrapBox.js +0 -114
- package/lib-module/StackView/StackWrapGap.js +0 -58
- package/lib-module/StackView/common.js +0 -32
- package/lib-module/StackView/getStackedContent.js +0 -123
- package/lib-module/StackView/index.js +0 -5
- package/lib-module/StepTracker/Step.js +0 -229
- package/lib-module/StepTracker/StepTracker.js +0 -175
- package/lib-module/StepTracker/dictionary.js +0 -10
- package/lib-module/StepTracker/index.js +0 -2
- package/lib-module/Tabs/Tabs.js +0 -113
- package/lib-module/Tabs/TabsItem.js +0 -215
- package/lib-module/Tabs/index.js +0 -2
- package/lib-module/Tags/Tags.js +0 -245
- package/lib-module/Tags/index.js +0 -2
- package/lib-module/TextInput/TextArea.js +0 -88
- package/lib-module/TextInput/TextInput.js +0 -68
- package/lib-module/TextInput/TextInputBase.js +0 -233
- package/lib-module/TextInput/index.js +0 -3
- package/lib-module/TextInput/propTypes.js +0 -37
- package/lib-module/ThemeProvider/ThemeProvider.js +0 -35
- package/lib-module/ThemeProvider/index.js +0 -6
- package/lib-module/ThemeProvider/useSetTheme.js +0 -22
- package/lib-module/ThemeProvider/useTheme.js +0 -14
- package/lib-module/ThemeProvider/useThemeTokens.js +0 -105
- package/lib-module/ThemeProvider/utils/index.js +0 -2
- package/lib-module/ThemeProvider/utils/styles.js +0 -174
- package/lib-module/ThemeProvider/utils/theme-tokens.js +0 -151
- package/lib-module/ToggleSwitch/ToggleSwitch.js +0 -234
- package/lib-module/ToggleSwitch/ToggleSwitchGroup.js +0 -218
- package/lib-module/ToggleSwitch/index.js +0 -3
- package/lib-module/Tooltip/Backdrop.js +0 -52
- package/lib-module/Tooltip/Backdrop.native.js +0 -43
- package/lib-module/Tooltip/Tooltip.js +0 -332
- package/lib-module/Tooltip/dictionary.js +0 -8
- package/lib-module/Tooltip/getTooltipPosition.js +0 -164
- package/lib-module/Tooltip/index.js +0 -2
- package/lib-module/TooltipButton/TooltipButton.js +0 -71
- package/lib-module/TooltipButton/index.js +0 -2
- package/lib-module/Typography/Typography.js +0 -120
- package/lib-module/Typography/index.js +0 -2
- package/lib-module/ViewportProvider/ViewportProvider.js +0 -28
- package/lib-module/ViewportProvider/index.js +0 -3
- package/lib-module/ViewportProvider/useViewport.js +0 -3
- package/lib-module/ViewportProvider/useViewportListener.js +0 -43
- package/lib-module/index.js +0 -48
- package/lib-module/utils/a11y/index.js +0 -2
- package/lib-module/utils/a11y/semantics.js +0 -154
- package/lib-module/utils/a11y/textSize.js +0 -34
- package/lib-module/utils/animation/index.js +0 -2
- package/lib-module/utils/animation/useVerticalExpandAnimation.js +0 -61
- package/lib-module/utils/children.js +0 -118
- package/lib-module/utils/containUniqueFields.js +0 -26
- package/lib-module/utils/index.js +0 -16
- package/lib-module/utils/info/index.js +0 -7
- package/lib-module/utils/info/platform/index.js +0 -11
- package/lib-module/utils/info/platform/platform.android.js +0 -1
- package/lib-module/utils/info/platform/platform.ios.js +0 -1
- package/lib-module/utils/info/platform/platform.js +0 -1
- package/lib-module/utils/info/platform/platform.native.js +0 -4
- package/lib-module/utils/info/versions.js +0 -5
- package/lib-module/utils/input.js +0 -180
- package/lib-module/utils/pressability.js +0 -97
- package/lib-module/utils/props/a11yProps.js +0 -140
- package/lib-module/utils/props/clickProps.js +0 -25
- package/lib-module/utils/props/componentPropType.js +0 -63
- package/lib-module/utils/props/copyPropTypes.js +0 -2
- package/lib-module/utils/props/getPropSelector.js +0 -6
- package/lib-module/utils/props/handlerProps.js +0 -59
- package/lib-module/utils/props/hrefAttrsProp.js +0 -30
- package/lib-module/utils/props/index.js +0 -19
- package/lib-module/utils/props/inputSupportsProps.js +0 -59
- package/lib-module/utils/props/linkProps.js +0 -43
- package/lib-module/utils/props/paddingProp.js +0 -9
- package/lib-module/utils/props/pressProps.js +0 -42
- package/lib-module/utils/props/rectProp.js +0 -9
- package/lib-module/utils/props/responsiveProps.js +0 -30
- package/lib-module/utils/props/selectSystemProps.js +0 -24
- package/lib-module/utils/props/spacingProps.js +0 -56
- package/lib-module/utils/props/textInputProps.js +0 -194
- package/lib-module/utils/props/textProps.js +0 -59
- package/lib-module/utils/props/tokens.js +0 -120
- package/lib-module/utils/props/variantProp.js +0 -18
- package/lib-module/utils/props/viewProps.js +0 -22
- package/lib-module/utils/ssr.js +0 -35
- package/lib-module/utils/useCopy.js +0 -42
- package/lib-module/utils/useHash.js +0 -44
- package/lib-module/utils/useHash.native.js +0 -7
- package/lib-module/utils/useResponsiveProp.js +0 -47
- package/lib-module/utils/useSpacingScale.js +0 -123
- package/lib-module/utils/useUniqueId.js +0 -12
- package/lib-module/utils/withLinkRouter.js +0 -82
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
import Linking from "react-native-web/dist/exports/Linking";
|
|
2
|
-
import Platform from "react-native-web/dist/exports/Platform";
|
|
3
|
-
import PropTypes from 'prop-types';
|
|
4
|
-
import { pressPropTypes } from './pressProps';
|
|
5
|
-
import a11yProps from './a11yProps';
|
|
6
|
-
import hrefAttrsProp from './hrefAttrsProp';
|
|
7
|
-
import getPropSelector from './getPropSelector';
|
|
8
|
-
const linkPropTypes = { ...pressPropTypes,
|
|
9
|
-
href: PropTypes.string,
|
|
10
|
-
hrefAttrs: PropTypes.shape(hrefAttrsProp.types),
|
|
11
|
-
...a11yProps.types
|
|
12
|
-
};
|
|
13
|
-
export default {
|
|
14
|
-
/**
|
|
15
|
-
* Proptypes for components that, on Web, can output <a href="..."> link elements
|
|
16
|
-
*/
|
|
17
|
-
types: linkPropTypes,
|
|
18
|
-
|
|
19
|
-
/**
|
|
20
|
-
* Filters a props object, returning only the platform-relevant link props defined above
|
|
21
|
-
*/
|
|
22
|
-
select: getPropSelector(linkPropTypes),
|
|
23
|
-
|
|
24
|
-
/**
|
|
25
|
-
* Turn hrefs into press handlers that open links on Native.
|
|
26
|
-
*
|
|
27
|
-
* @param {({ onPress?: () => void, href?: string })}
|
|
28
|
-
* @returns {(() => void)|undefined} Returns a press handler, or undefined on web if no press
|
|
29
|
-
* handler is provided (expects calling component to render as `<a href={href}>` on web).
|
|
30
|
-
*/
|
|
31
|
-
handleHref: ({
|
|
32
|
-
onPress,
|
|
33
|
-
href
|
|
34
|
-
}) => {
|
|
35
|
-
return Platform.select({
|
|
36
|
-
web: onPress,
|
|
37
|
-
default: (...args) => {
|
|
38
|
-
if (onPress) onPress(...args);
|
|
39
|
-
if (href) Linking.openURL(href);
|
|
40
|
-
}
|
|
41
|
-
});
|
|
42
|
-
}
|
|
43
|
-
};
|
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
import Platform from "react-native-web/dist/exports/Platform";
|
|
2
|
-
import PropTypes from 'prop-types';
|
|
3
|
-
import rectProp from './rectProp';
|
|
4
|
-
import getPropSelector from './getPropSelector';
|
|
5
|
-
const pressHandlerPropTypes = {
|
|
6
|
-
onPress: PropTypes.func,
|
|
7
|
-
onPressIn: PropTypes.func,
|
|
8
|
-
onPressOut: PropTypes.func,
|
|
9
|
-
...Platform.select({
|
|
10
|
-
web: {
|
|
11
|
-
onMouseEnter: PropTypes.func,
|
|
12
|
-
onMouseLeave: PropTypes.func,
|
|
13
|
-
onFocus: PropTypes.func,
|
|
14
|
-
onBlur: PropTypes.func
|
|
15
|
-
},
|
|
16
|
-
default: {
|
|
17
|
-
onLongPress: PropTypes.func
|
|
18
|
-
}
|
|
19
|
-
})
|
|
20
|
-
};
|
|
21
|
-
export const pressPropTypes = { ...pressHandlerPropTypes,
|
|
22
|
-
disabled: PropTypes.bool,
|
|
23
|
-
...Platform.select({
|
|
24
|
-
web: {},
|
|
25
|
-
default: {
|
|
26
|
-
hitSlop: PropTypes.number,
|
|
27
|
-
pressRetentionOffset: PropTypes.oneOfType([PropTypes.number, rectProp.propType])
|
|
28
|
-
}
|
|
29
|
-
})
|
|
30
|
-
};
|
|
31
|
-
export default {
|
|
32
|
-
/**
|
|
33
|
-
* Proptypes for clickable or pressable components, including web-only props
|
|
34
|
-
*/
|
|
35
|
-
types: pressPropTypes,
|
|
36
|
-
|
|
37
|
-
/**
|
|
38
|
-
* Filters a props object, returning only the platform-relevant press props defined above
|
|
39
|
-
*/
|
|
40
|
-
select: getPropSelector(pressPropTypes),
|
|
41
|
-
selectHandlers: getPropSelector(pressHandlerPropTypes)
|
|
42
|
-
};
|
|
@@ -1,30 +0,0 @@
|
|
|
1
|
-
import PropTypes from 'prop-types';
|
|
2
|
-
|
|
3
|
-
const getByViewport = propType => ({
|
|
4
|
-
xs: propType,
|
|
5
|
-
sm: propType,
|
|
6
|
-
md: propType,
|
|
7
|
-
lg: propType,
|
|
8
|
-
xl: propType
|
|
9
|
-
});
|
|
10
|
-
/**
|
|
11
|
-
* Utilities for props that allow different values to be applied at different viewports.
|
|
12
|
-
*
|
|
13
|
-
* These should apply viewport inheritance such that if a viewport is undefined, the value is
|
|
14
|
-
* taken from the next smallest viewport for which a value is available. For example, a
|
|
15
|
-
* responsive prop { xs: 2, lg: 3 } should apply 2 at sizes sm and md, and 3 at size xl.
|
|
16
|
-
*
|
|
17
|
-
* @property {Function} getByViewport - returns an object where each each viewport has a key
|
|
18
|
-
* containing the provided argument.
|
|
19
|
-
* @property {Function} getTypeByViewport - returns a PropTypes shape validator for an object where
|
|
20
|
-
* each viewport has a key containing the provided proptype.
|
|
21
|
-
* @property {Function} getTypeOptionallyByViewport - returns a PropTypes validator that accepts
|
|
22
|
-
* either the provided proptype on its own, or the output of getTypeByViewport
|
|
23
|
-
*/
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
export default {
|
|
27
|
-
getByViewport,
|
|
28
|
-
getTypeByViewport: propType => PropTypes.shape(getByViewport(propType)),
|
|
29
|
-
getTypeOptionallyByViewport: propType => PropTypes.oneOfType([propType, PropTypes.shape(getByViewport(propType))])
|
|
30
|
-
};
|
|
@@ -1,24 +0,0 @@
|
|
|
1
|
-
// Returns a selector for requested prop kinds as well as the propTypes for
|
|
2
|
-
// those props merged into one object
|
|
3
|
-
export default function selectSystemProps(systemPropHelpers) {
|
|
4
|
-
const selectProps = props => systemPropHelpers.reduce((acc, propHelper) => {
|
|
5
|
-
if (typeof (propHelper === null || propHelper === void 0 ? void 0 : propHelper.select) !== 'function') {
|
|
6
|
-
throw new Error(`An invalid system prop helper has been passed to 'selectSystemProps': prop selector ('.select') is missing in ${propHelper}`);
|
|
7
|
-
}
|
|
8
|
-
|
|
9
|
-
return { ...acc,
|
|
10
|
-
...propHelper.select(props)
|
|
11
|
-
};
|
|
12
|
-
}, {});
|
|
13
|
-
|
|
14
|
-
const selectedPropTypes = systemPropHelpers.reduce((acc, propHelper) => {
|
|
15
|
-
if (!(propHelper !== null && propHelper !== void 0 && propHelper.types)) {
|
|
16
|
-
throw new Error(`An invalid system prop helper has been passed to 'selectSystemProps': types selector ('.types') is missing in ${propHelper}`);
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
return { ...acc,
|
|
20
|
-
...propHelper.types
|
|
21
|
-
};
|
|
22
|
-
}, {});
|
|
23
|
-
return [selectProps, selectedPropTypes];
|
|
24
|
-
}
|
|
@@ -1,56 +0,0 @@
|
|
|
1
|
-
import PropTypes from 'prop-types';
|
|
2
|
-
import responsiveProps from './responsiveProps';
|
|
3
|
-
import variantProp from './variantProp';
|
|
4
|
-
/**
|
|
5
|
-
* @typedef {0|1|2|3|4|5|6|7|8|9|10|11} SpacingIndex - value used to select a size on the spacing scale
|
|
6
|
-
*
|
|
7
|
-
* @typedef SpacingOptions
|
|
8
|
-
* @property {VariantProp} [SpacingOptions.variant] - optional theme scale variants e.g. compact, wide
|
|
9
|
-
* @property {number} [SpacingOptions.size] - optional override to force a particular pixel size
|
|
10
|
-
* @property {number} [SpacingOptions.subtract] - optional number to subtract from final pixel size
|
|
11
|
-
*
|
|
12
|
-
* @typedef SpacingObject
|
|
13
|
-
* @property {SpacingIndex} [SpacingObject.xs] - space scale index to use above xs viewport
|
|
14
|
-
* @property {SpacingIndex} [SpacingObject.sm] - space scale index to use above sm viewport
|
|
15
|
-
* @property {SpacingIndex} [SpacingObject.md] - space scale index to use above md viewport
|
|
16
|
-
* @property {SpacingIndex} [SpacingObject.lg] - space scale index to use above lg viewport
|
|
17
|
-
* @property {SpacingIndex} [SpacingObject.xl] - space scale index to use above xl viewport
|
|
18
|
-
* @property {SpacingIndex} [SpacingObject.space] - space scale index to use at all viewports
|
|
19
|
-
* @property {SpacingOptions} [SpacingObject.options] - optional options for this spacing
|
|
20
|
-
*
|
|
21
|
-
* @typedef {SpacingIndex|SpacingObject} SpacingValue
|
|
22
|
-
*/
|
|
23
|
-
|
|
24
|
-
const spacingScale = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
|
|
25
|
-
const spacingIndexPropType = PropTypes.oneOf(spacingScale);
|
|
26
|
-
const spacingObjectPropType = PropTypes.shape({ ...responsiveProps.getByViewport(spacingIndexPropType),
|
|
27
|
-
space: spacingIndexPropType,
|
|
28
|
-
options: PropTypes.shape({
|
|
29
|
-
variant: variantProp.propType,
|
|
30
|
-
size: PropTypes.number
|
|
31
|
-
})
|
|
32
|
-
});
|
|
33
|
-
/**
|
|
34
|
-
* Components and utilities that assign fixed space between components use a theme-defined spacing scale.
|
|
35
|
-
*
|
|
36
|
-
* They typically take one or more props of the {@link SpacingValue} type and turn it into a pixel size value
|
|
37
|
-
* using the hook `useSpacingScale`, which resolves any options or responsive behaviour and returns the
|
|
38
|
-
* appropriate value from the theme spacing scale.
|
|
39
|
-
*
|
|
40
|
-
* - see /ADRs/inter-component-spacing/README.md - ADR on this structure
|
|
41
|
-
* - see /src/utils/spacing/useSpacingScale.js - hook that processes spacing values
|
|
42
|
-
* - @see {@link SpacingIndex} - themes provide spacing scales of up to 12 sizes with optional theme rules.
|
|
43
|
-
* - @see {@link SpacingValue} - either a simple number referencing an index position on the spacing
|
|
44
|
-
* scale, or an object with an optional `options` key and one or more spacing indexes keyed either by
|
|
45
|
-
* viewports or `space` to apply at all viewports.
|
|
46
|
-
*/
|
|
47
|
-
|
|
48
|
-
export default {
|
|
49
|
-
scale: spacingScale,
|
|
50
|
-
types: {
|
|
51
|
-
spacingIndex: spacingIndexPropType,
|
|
52
|
-
spacingObject: spacingObjectPropType,
|
|
53
|
-
// Most spacing components and utilities take this prop / arg type:
|
|
54
|
-
spacingValue: PropTypes.oneOfType([spacingIndexPropType, spacingObjectPropType])
|
|
55
|
-
}
|
|
56
|
-
};
|
|
@@ -1,194 +0,0 @@
|
|
|
1
|
-
import PropTypes from 'prop-types';
|
|
2
|
-
import Platform from "react-native-web/dist/exports/Platform";
|
|
3
|
-
import getPropSelector from './getPropSelector'; // This file contains common props for components that render a React Native TextInput
|
|
4
|
-
// It excludes interaction handler functions which are in `./handlerProps.js`
|
|
5
|
-
|
|
6
|
-
/**
|
|
7
|
-
* TextInput (web and native) supports some common React Native props
|
|
8
|
-
* shared with React Native's Text component.
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
const textProps = {
|
|
12
|
-
maxFontSizeMultiplier: PropTypes.number,
|
|
13
|
-
nativeId: PropTypes.string,
|
|
14
|
-
onLayout: PropTypes.func
|
|
15
|
-
};
|
|
16
|
-
/**
|
|
17
|
-
* UDS text inputs accept props related to UDS's useInputValue hook
|
|
18
|
-
*/
|
|
19
|
-
|
|
20
|
-
const inputValueProps = {
|
|
21
|
-
value: PropTypes.string,
|
|
22
|
-
initialValue: PropTypes.string,
|
|
23
|
-
readOnly: PropTypes.bool,
|
|
24
|
-
inactive: PropTypes.bool
|
|
25
|
-
};
|
|
26
|
-
/**
|
|
27
|
-
* This collection adds props that can be passed through to both React Native's
|
|
28
|
-
* and React Native Web's implementations of the React Native TextInput component.
|
|
29
|
-
*/
|
|
30
|
-
|
|
31
|
-
const crossPlatform = { ...textProps,
|
|
32
|
-
...inputValueProps,
|
|
33
|
-
|
|
34
|
-
/**
|
|
35
|
-
* Web and Android; 'off' disables device autocomplete, other strings are platform-specific.
|
|
36
|
-
* Valid values on Native: https://reactnative.dev/docs/textinput#autocomplete-android
|
|
37
|
-
* Valid values on Web: https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/autocomplete
|
|
38
|
-
*/
|
|
39
|
-
autoComplete: PropTypes.string,
|
|
40
|
-
|
|
41
|
-
/**
|
|
42
|
-
* On Native, default is `true`, passing `false` disables autoCorrect.
|
|
43
|
-
* On web, only supported by Safari and expects "on" or "off" strings.
|
|
44
|
-
*/
|
|
45
|
-
autoCorrect: PropTypes.oneOf([true, false, 'on', 'off']),
|
|
46
|
-
|
|
47
|
-
/**
|
|
48
|
-
* Focuses the element on mount. On Web, only the first form element with autoFocus is focussed.
|
|
49
|
-
*/
|
|
50
|
-
autoFocus: PropTypes.bool,
|
|
51
|
-
|
|
52
|
-
/**
|
|
53
|
-
* Default is `true` for single line, `false` for multi-line
|
|
54
|
-
*/
|
|
55
|
-
blurOnSubmit: PropTypes.bool,
|
|
56
|
-
|
|
57
|
-
/**
|
|
58
|
-
* iOS and Web only, no effect on Android
|
|
59
|
-
*/
|
|
60
|
-
clearTextOnFocus: PropTypes.bool,
|
|
61
|
-
|
|
62
|
-
/**
|
|
63
|
-
* Default is `true`. On web, this works by mapping to input's `readonly` attribute
|
|
64
|
-
*/
|
|
65
|
-
editable: PropTypes.bool,
|
|
66
|
-
|
|
67
|
-
/**
|
|
68
|
-
* See documentation for allowed values (varies between Web, Android and iOS) and important notes:
|
|
69
|
-
* - Native: https://reactnative.dev/docs/textinput#keyboardtype
|
|
70
|
-
* - Web: equivalent to `inputmode` but see https://necolas.github.io/react-native-web/docs/text-input/
|
|
71
|
-
*/
|
|
72
|
-
keyboardType: PropTypes.string,
|
|
73
|
-
|
|
74
|
-
/**
|
|
75
|
-
* Uses native tools (no flicker) to cap the maximum number of characters.
|
|
76
|
-
* On Web, works via `maxlength` attr.
|
|
77
|
-
*/
|
|
78
|
-
maxLength: PropTypes.number,
|
|
79
|
-
|
|
80
|
-
/**
|
|
81
|
-
* If passed as true, the text input can be multiple lines.
|
|
82
|
-
*
|
|
83
|
-
* > It is important to note that this aligns the text to the top on iOS, and centers it on Android.
|
|
84
|
-
* > Use with textAlignVertical set to top for the same behavior in both platforms.
|
|
85
|
-
*/
|
|
86
|
-
multiline: PropTypes.bool,
|
|
87
|
-
|
|
88
|
-
/**
|
|
89
|
-
* Web and Android only, requires `multiline` to be `true`.
|
|
90
|
-
*/
|
|
91
|
-
numberOfLines: PropTypes.number,
|
|
92
|
-
|
|
93
|
-
/**
|
|
94
|
-
* Text to display when no value set.
|
|
95
|
-
* Accesibility guidelines recommend using labels to describe the input and using
|
|
96
|
-
* placeholders rarely and sparingly to prompt a particular format.
|
|
97
|
-
*/
|
|
98
|
-
placeholder: PropTypes.string,
|
|
99
|
-
|
|
100
|
-
/**
|
|
101
|
-
* Sets placeholder colour. On Web, uses `::placeholder { color: ... }` selector.
|
|
102
|
-
*/
|
|
103
|
-
placeholderTextColor: PropTypes.string,
|
|
104
|
-
|
|
105
|
-
/**
|
|
106
|
-
* One of a subset of platform-specific options that controls labelling and presentation
|
|
107
|
-
* in on-screen keyboards and accessibility tools. Uses `enterkeyhint` attr on Web.
|
|
108
|
-
*
|
|
109
|
-
* 'done', 'go', 'next', 'search', and 'send' are available for Web, Android and iOS.
|
|
110
|
-
*/
|
|
111
|
-
returnKeyType: PropTypes.string,
|
|
112
|
-
|
|
113
|
-
/**
|
|
114
|
-
* Obscures passwords and similar. Equivalent to type="password" on Web.
|
|
115
|
-
* Does not work if multiline is true.
|
|
116
|
-
*/
|
|
117
|
-
secureTextEntry: PropTypes.bool,
|
|
118
|
-
|
|
119
|
-
/**
|
|
120
|
-
* If true, all text will automatically be selected on focus.
|
|
121
|
-
*/
|
|
122
|
-
selectTextOnFocus: PropTypes.bool,
|
|
123
|
-
|
|
124
|
-
/**
|
|
125
|
-
* Web and iOS. On iOS, default inherits from `autoCorrect`.
|
|
126
|
-
* On Web, equivalent to `spellcheck` attr.
|
|
127
|
-
*/
|
|
128
|
-
spellCheck: PropTypes.bool
|
|
129
|
-
};
|
|
130
|
-
/**
|
|
131
|
-
* These web-only props all control HTML `input` attributes of the same name.
|
|
132
|
-
* Refer to general HTML documentation for more details.
|
|
133
|
-
*/
|
|
134
|
-
|
|
135
|
-
const webOnly = {
|
|
136
|
-
disabled: PropTypes.bool,
|
|
137
|
-
dir: PropTypes.oneOf(['auto', 'ltr', 'rtl']),
|
|
138
|
-
lang: PropTypes.string
|
|
139
|
-
};
|
|
140
|
-
/**
|
|
141
|
-
* These props are supported in React Native but not React Native Web.
|
|
142
|
-
*
|
|
143
|
-
* React Native text inputs can be quirky, so a full set of props should be allowed to handle edge cases.
|
|
144
|
-
* Refer to React Native documentation for details, allowed values, and Android/iOS support and versions:
|
|
145
|
-
* https://reactnative.dev/docs/textinput
|
|
146
|
-
*
|
|
147
|
-
* Beware that many React Native text input props apply via complicated logic that chooses a built-in
|
|
148
|
-
* native component based on the values of multiple boolean flags, and may sometimes appear to pick an
|
|
149
|
-
* option that is inappropriate for one flag based on the values of one or more other other flags.
|
|
150
|
-
*/
|
|
151
|
-
|
|
152
|
-
const nativeOnly = {
|
|
153
|
-
caretHidden: PropTypes.bool,
|
|
154
|
-
clearButtonMode: PropTypes.string,
|
|
155
|
-
contextMenuHidden: PropTypes.bool,
|
|
156
|
-
dataDetectorTypes: PropTypes.string,
|
|
157
|
-
disableFullscreenUI: PropTypes.bool,
|
|
158
|
-
enablesReturnKeyAutomatically: PropTypes.bool,
|
|
159
|
-
importantForAutofill: PropTypes.string,
|
|
160
|
-
inlineImageLeft: PropTypes.string,
|
|
161
|
-
keyboardAppearance: PropTypes.string,
|
|
162
|
-
returnKeyLabel: PropTypes.string,
|
|
163
|
-
rejectResponderTermination: PropTypes.bool,
|
|
164
|
-
scrollEnabled: PropTypes.bool,
|
|
165
|
-
selection: PropTypes.object,
|
|
166
|
-
selectionColor: PropTypes.string,
|
|
167
|
-
showSoftInputOnFocus: PropTypes.bool,
|
|
168
|
-
textAlign: PropTypes.string,
|
|
169
|
-
textContentType: PropTypes.string,
|
|
170
|
-
passwordRules: PropTypes.string,
|
|
171
|
-
textBreakStrategy: PropTypes.string,
|
|
172
|
-
underlineColorAndroid: PropTypes.string
|
|
173
|
-
};
|
|
174
|
-
export default {
|
|
175
|
-
/**
|
|
176
|
-
* Subset of proptypes that can be passed down to a React Native or React Native Web
|
|
177
|
-
* `TextInput` component. Allow regardless of platform, so cross-platform apps don't warn.
|
|
178
|
-
*/
|
|
179
|
-
types: { ...crossPlatform,
|
|
180
|
-
...webOnly,
|
|
181
|
-
...nativeOnly
|
|
182
|
-
},
|
|
183
|
-
|
|
184
|
-
/**
|
|
185
|
-
* Filters a props object. Return only platform-appropriate TextInput props, native inputs
|
|
186
|
-
* may throw errors on receiving unknown props.
|
|
187
|
-
*/
|
|
188
|
-
select: getPropSelector({ ...crossPlatform,
|
|
189
|
-
...Platform.select({
|
|
190
|
-
web: webOnly,
|
|
191
|
-
default: nativeOnly
|
|
192
|
-
})
|
|
193
|
-
})
|
|
194
|
-
};
|
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
import PropTypes from 'prop-types';
|
|
2
|
-
import Platform from "react-native-web/dist/exports/Platform";
|
|
3
|
-
import getPropSelector from './getPropSelector'; // These are the props accepted specifically on React Native (Web) `Text` elements.
|
|
4
|
-
// They are generally concerned with the behaviour of multiline text.
|
|
5
|
-
|
|
6
|
-
const crossPlatform = {
|
|
7
|
-
/**
|
|
8
|
-
* Truncates text after this many lines with an ellipsis at the end.
|
|
9
|
-
* On native, ellipsis behaviour may be changed with `ellipsizeMode` prop.
|
|
10
|
-
*/
|
|
11
|
-
numberOfLines: PropTypes.number,
|
|
12
|
-
|
|
13
|
-
/**
|
|
14
|
-
* Default is true on web and false on native
|
|
15
|
-
*/
|
|
16
|
-
selectable: PropTypes.bool
|
|
17
|
-
};
|
|
18
|
-
/**
|
|
19
|
-
* See React Native docs for latest details on these.
|
|
20
|
-
* https://reactnative.dev/docs/text
|
|
21
|
-
*/
|
|
22
|
-
|
|
23
|
-
const nativeOnly = {
|
|
24
|
-
ellipsizeMode: PropTypes.string,
|
|
25
|
-
maxFontSizeMultiplier: PropTypes.number,
|
|
26
|
-
minimumFontScale: PropTypes.number,
|
|
27
|
-
onTextLayout: PropTypes.func,
|
|
28
|
-
suppressHighlighting: PropTypes.bool,
|
|
29
|
-
textBreakStrategy: PropTypes.string
|
|
30
|
-
};
|
|
31
|
-
/**
|
|
32
|
-
* These set HTML attributes of the same name.
|
|
33
|
-
*/
|
|
34
|
-
|
|
35
|
-
const webOnly = {
|
|
36
|
-
dir: PropTypes.oneOf(['auto', 'ltr', 'rtl']),
|
|
37
|
-
lang: PropTypes.string
|
|
38
|
-
};
|
|
39
|
-
export default {
|
|
40
|
-
/**
|
|
41
|
-
* Set of prop types specific to React Native and React Native Web `Text`,
|
|
42
|
-
* which largely revolve around the behaviour of multiline non-pressable text.
|
|
43
|
-
*/
|
|
44
|
-
types: { ...crossPlatform,
|
|
45
|
-
...webOnly,
|
|
46
|
-
...nativeOnly
|
|
47
|
-
},
|
|
48
|
-
|
|
49
|
-
/**
|
|
50
|
-
* Filters a props object, returning only props specific to `Text` elements
|
|
51
|
-
* on the current platform. Does not include props applicable to `Text` and `View`.
|
|
52
|
-
*/
|
|
53
|
-
select: getPropSelector({ ...crossPlatform,
|
|
54
|
-
...Platform.select({
|
|
55
|
-
web: webOnly,
|
|
56
|
-
default: nativeOnly
|
|
57
|
-
})
|
|
58
|
-
})
|
|
59
|
-
};
|
|
@@ -1,120 +0,0 @@
|
|
|
1
|
-
import PropTypes from 'prop-types';
|
|
2
|
-
import { components as tokenKeys } from '@telus-uds/system-theme-tokens'; // Tokens can be primitive values (e.g. `'rgba(0,0,0,0'`, `12`), or objects of such values,
|
|
3
|
-
// such as tokens that describe shadow (e.g. shadow: { inset: true, color: 'rgba(...)' ... }),
|
|
4
|
-
// or components (e.g. Icon tokens)
|
|
5
|
-
|
|
6
|
-
const tokenValue = PropTypes.oneOfType([PropTypes.string, PropTypes.number, PropTypes.bool, PropTypes.elementType]);
|
|
7
|
-
const tokenValueType = PropTypes.oneOfType([tokenValue, PropTypes.objectOf(tokenValue)]);
|
|
8
|
-
export const getTokenNames = componentName => {
|
|
9
|
-
const componentTokenSchema = tokenKeys[componentName];
|
|
10
|
-
|
|
11
|
-
if (!componentTokenSchema) {
|
|
12
|
-
throw new Error(`No "${componentName}" tokenKeys in @telus-uds/system-theme-tokens`);
|
|
13
|
-
}
|
|
14
|
-
|
|
15
|
-
return Object.keys(componentTokenSchema);
|
|
16
|
-
};
|
|
17
|
-
/**
|
|
18
|
-
* Returns the subset of a set of tokens that may be accepted by the `tokens` prop of a named component
|
|
19
|
-
* or by a provided array of tokens. A prefix may be provided, for example:
|
|
20
|
-
*
|
|
21
|
-
* @example
|
|
22
|
-
* ```jsx
|
|
23
|
-
* // returns tokens from `themeTokens` that exist in the theme schema for `Button`.
|
|
24
|
-
* selectTokens('Button', themeTokens)
|
|
25
|
-
* ```
|
|
26
|
-
*
|
|
27
|
-
* @example
|
|
28
|
-
* ```jsx
|
|
29
|
-
* // returns `{ backgroundColor, width }` where the values of those keys come from
|
|
30
|
-
* // the source object's `{ containerBackgroundColor, containerWidth }` properties.
|
|
31
|
-
* selectTokens(['backgroundColor', 'width'], themeTokens, 'container')
|
|
32
|
-
* ```
|
|
33
|
-
*
|
|
34
|
-
* @example
|
|
35
|
-
* ```jsx
|
|
36
|
-
* // returns tokens that are defined in the `Button` theme schema, from tokens with
|
|
37
|
-
* // a prefix `'button'` e.g. a token `buttonBorderWidth` outputs as `borderWidth`.
|
|
38
|
-
* selectTokens('Button', themeTokens, 'button')
|
|
39
|
-
* ```
|
|
40
|
-
*
|
|
41
|
-
* @param {string[]|string} specifier - a name of a component in the theme schema, or an array of token names
|
|
42
|
-
* @param {object} tokens - a source object of theme tokens
|
|
43
|
-
* @param {string} [prefix] - if provided, matches keys in the source object with this as the first camelCase item
|
|
44
|
-
* @returns {object} - subset of theme tokens
|
|
45
|
-
*/
|
|
46
|
-
|
|
47
|
-
export const selectTokens = (specifier, tokens, prefix) => {
|
|
48
|
-
const tokenNames = typeof specifier === 'string' ? getTokenNames(specifier) : specifier;
|
|
49
|
-
const filteredTokens = tokenNames.reduce((validTokens, key) => {
|
|
50
|
-
const prefixedKey = prefix ? `${prefix}${key[0].toUpperCase()}${key.slice(1)}` : key;
|
|
51
|
-
const token = tokens[prefixedKey];
|
|
52
|
-
return token !== undefined ? { ...validTokens,
|
|
53
|
-
[key]: token
|
|
54
|
-
} : validTokens;
|
|
55
|
-
}, {});
|
|
56
|
-
return filteredTokens;
|
|
57
|
-
};
|
|
58
|
-
/**
|
|
59
|
-
* @typedef {string|number|boolean|{[key: string]:string|number|boolean}} TokenValue
|
|
60
|
-
* @typedef {{[key: string]: TokenValue}} TokensSet
|
|
61
|
-
* @typedef {(AppearanceSet) => TokensSet} TokensGetter
|
|
62
|
-
* @typedef {TokensSet|TokensGetter} TokensProp
|
|
63
|
-
*/
|
|
64
|
-
|
|
65
|
-
/**
|
|
66
|
-
* 'tokens' is an optional object prop on all themable components. Its keys must match the
|
|
67
|
-
* token keys in the component's theme schema.
|
|
68
|
-
*
|
|
69
|
-
* This prop is intended to be used as an 'escape hatch' for difficult or exceptional cases
|
|
70
|
-
* where the main theming system doesn't apply. It is intentionally permissive about values.
|
|
71
|
-
*
|
|
72
|
-
* @param {...string} componentsNames - one or more ComponentName, which tokens keys are accepted
|
|
73
|
-
* @return {function} - a custom PropTypes validator
|
|
74
|
-
*
|
|
75
|
-
* @example
|
|
76
|
-
* Component.propTypes = {
|
|
77
|
-
* // accepts all tokens keys defined in Component schema
|
|
78
|
-
* tokens: getTokensPropType('Component')
|
|
79
|
-
* }
|
|
80
|
-
*
|
|
81
|
-
* Component.propTypes = {
|
|
82
|
-
* // accepts all tokens keys defined in schemas for Component1 and Component2
|
|
83
|
-
* tokens: getTokensPropType('Component1', 'Component2')
|
|
84
|
-
* }
|
|
85
|
-
*/
|
|
86
|
-
|
|
87
|
-
export const getTokensPropType = (...componentsNames) => (props, propName, componentName) => {
|
|
88
|
-
PropTypes.checkPropTypes({
|
|
89
|
-
[propName]: PropTypes.oneOfType([PropTypes.object, PropTypes.func])
|
|
90
|
-
}, props, propName, componentName);
|
|
91
|
-
|
|
92
|
-
if (typeof props[propName] !== 'function') {
|
|
93
|
-
PropTypes.checkPropTypes({
|
|
94
|
-
[propName]: PropTypes.exact(Object.fromEntries(componentsNames.flatMap(component => getTokenNames(component).map(key => [key, tokenValueType]))))
|
|
95
|
-
}, props, propName, componentName);
|
|
96
|
-
}
|
|
97
|
-
};
|
|
98
|
-
/**
|
|
99
|
-
* Get a proptypes validator for a set of tokens that is not based on a component in the theme schema.
|
|
100
|
-
*
|
|
101
|
-
* For example, for a set of tokens used in a common style, or for a set of tokens required by
|
|
102
|
-
* a themeless component whose tokens are set by a parent but requires tokens of a certain shape.
|
|
103
|
-
*
|
|
104
|
-
* By default, requires an object with a complete set of tokens (allowing `null`, but not `undefined`).
|
|
105
|
-
*
|
|
106
|
-
* @param {string[]} componentTokenKeys - array of strings of token names
|
|
107
|
-
* @param {object} [options]
|
|
108
|
-
* @param {boolean} [options.partial] - if true, allows tokens to be undefined
|
|
109
|
-
* @param {boolean} [options.allowFunction] - if true, allows functions as well as tokens objects
|
|
110
|
-
* @returns
|
|
111
|
-
*/
|
|
112
|
-
|
|
113
|
-
export const getTokensSetPropType = (componentTokenKeys, {
|
|
114
|
-
partial = false,
|
|
115
|
-
allowFunction = false
|
|
116
|
-
} = {}) => {
|
|
117
|
-
const tokensObjectValidator = PropTypes.exact(Object.fromEntries(componentTokenKeys.map(key => [key, partial ? tokenValueType : // Some theme tokens can validly resolve to `null`, but .isRequired treats null as undefined
|
|
118
|
-
(props, propName, ...args) => props[propName] !== null && tokenValueType.isRequired(props, propName, ...args)])));
|
|
119
|
-
return allowFunction ? PropTypes.oneOfType([tokensObjectValidator, PropTypes.func]) : tokensObjectValidator;
|
|
120
|
-
};
|
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
import PropTypes from 'prop-types';
|
|
2
|
-
/**
|
|
3
|
-
* @typedef {{[key: string]: string|number|boolean}} AppearanceSet
|
|
4
|
-
* @typedef {AppearanceSet} VariantProp
|
|
5
|
-
*/
|
|
6
|
-
|
|
7
|
-
export default {
|
|
8
|
-
/**
|
|
9
|
-
* 'variant' is an optional object prop on all themable components.
|
|
10
|
-
*
|
|
11
|
-
* Contains an object with keys that correspond to the current component theme's allowed
|
|
12
|
-
* appearances and values that correspond to the allowed values of that component.
|
|
13
|
-
*
|
|
14
|
-
* Since the particular keys and values depend on which theme is currently active,
|
|
15
|
-
* the exact shape of variant props is not enforced using PropTypes.
|
|
16
|
-
*/
|
|
17
|
-
propType: PropTypes.objectOf(PropTypes.oneOfType([PropTypes.string, PropTypes.number, PropTypes.bool]))
|
|
18
|
-
};
|
|
@@ -1,22 +0,0 @@
|
|
|
1
|
-
import PropTypes from 'prop-types';
|
|
2
|
-
import getPropSelector from './getPropSelector';
|
|
3
|
-
const viewPropTypes = {
|
|
4
|
-
pointerEvents: PropTypes.oneOf(['all', 'none', 'box-only', 'box-none']),
|
|
5
|
-
onLayout: PropTypes.func,
|
|
6
|
-
nativeID: PropTypes.string,
|
|
7
|
-
testID: PropTypes.string,
|
|
8
|
-
dataSet: PropTypes.object
|
|
9
|
-
};
|
|
10
|
-
export default {
|
|
11
|
-
/**
|
|
12
|
-
* Subset of `View` proptypes that could conceivably be needed on any component
|
|
13
|
-
* that renders a single View.
|
|
14
|
-
*/
|
|
15
|
-
types: viewPropTypes,
|
|
16
|
-
|
|
17
|
-
/**
|
|
18
|
-
* Filters a props object, returning only cross-platform View props that are potentially
|
|
19
|
-
* relevant to any basic layout component that renders one View.
|
|
20
|
-
*/
|
|
21
|
-
select: getPropSelector(viewPropTypes)
|
|
22
|
-
};
|
package/lib-module/utils/ssr.js
DELETED
|
@@ -1,35 +0,0 @@
|
|
|
1
|
-
import AppRegistry from "react-native-web/dist/exports/AppRegistry";
|
|
2
|
-
/** @typedef {import('react').ComponentType} ReactComponent */
|
|
3
|
-
|
|
4
|
-
/** @typedef {import('react').ReactElement} ReactElement */
|
|
5
|
-
|
|
6
|
-
/**
|
|
7
|
-
* Registers the app's root component with React Native Web and generates
|
|
8
|
-
* the main <style> tag containing React Native Web stylesheet styles.
|
|
9
|
-
*
|
|
10
|
-
* @param {ReactComponent} AppRoot
|
|
11
|
-
* @param {string} [appName]
|
|
12
|
-
* @returns {ReactElement[]}
|
|
13
|
-
*/
|
|
14
|
-
|
|
15
|
-
export const getReactNativeWebSSRStyles = (AppRoot, appName = 'app') => {
|
|
16
|
-
AppRegistry.registerComponent(appName, () => AppRoot);
|
|
17
|
-
const {
|
|
18
|
-
getStyleElement
|
|
19
|
-
} = AppRegistry.getApplication(appName);
|
|
20
|
-
return [getStyleElement()];
|
|
21
|
-
};
|
|
22
|
-
/**
|
|
23
|
-
* Gets style tags for each currently supported CSS-in-JS library and returns
|
|
24
|
-
* them alongside any existing style tags.
|
|
25
|
-
*
|
|
26
|
-
* @param {ReactComponent} AppRoot
|
|
27
|
-
* @param {string} [appName]
|
|
28
|
-
* @param {ReactElement[]} [existingStyles]
|
|
29
|
-
* @returns {ReactElement[]}
|
|
30
|
-
*/
|
|
31
|
-
|
|
32
|
-
export const getSSRStyles = (AppRoot, appName = 'app', existingStyles = []) => {
|
|
33
|
-
return [...existingStyles, ...getReactNativeWebSSRStyles(AppRoot, appName) // if any other CSS-in-JS is added e.g. styled-components generate and add its styles here
|
|
34
|
-
];
|
|
35
|
-
};
|