@telus-uds/components-base 1.2.0 → 1.4.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.
Files changed (415) hide show
  1. package/.turbo/turbo-build.log +8 -0
  2. package/CHANGELOG.json +61 -0
  3. package/CHANGELOG.md +45 -2
  4. package/__tests__/ActivityIndicator/ActivityIndicator.test.jsx +35 -0
  5. package/__tests__/ActivityIndicator/__snapshots__/ActivityIndicator.test.jsx.snap +287 -0
  6. package/__tests__/FlexGrid/Col.test.jsx +6 -10
  7. package/__tests__/utils/props.test.js +36 -0
  8. package/__tests__/utils/semantics.test.jsx +1 -10
  9. package/babel.config.js +27 -5
  10. package/component-docs.json +170 -494
  11. package/generate-component-docs.js +3 -0
  12. package/lib/A11yText/index.js +6 -5
  13. package/lib/ActivityIndicator/Spinner.js +46 -37
  14. package/lib/ActivityIndicator/Spinner.native.js +26 -15
  15. package/lib/ActivityIndicator/index.js +3 -3
  16. package/lib/Box/Box.js +8 -8
  17. package/lib/Button/Button.js +2 -2
  18. package/lib/Button/ButtonBase.js +7 -8
  19. package/lib/Button/ButtonGroup.js +10 -12
  20. package/lib/Button/ButtonLink.js +4 -4
  21. package/lib/Button/propTypes.js +4 -2
  22. package/lib/Card/Card.js +6 -5
  23. package/lib/Card/CardBase.js +6 -9
  24. package/lib/Card/PressableCardBase.js +6 -11
  25. package/lib/Checkbox/Checkbox.js +4 -6
  26. package/lib/Divider/Divider.js +14 -13
  27. package/lib/ExpandCollapse/Control.js +7 -7
  28. package/lib/ExpandCollapse/ExpandCollapse.js +6 -2
  29. package/lib/ExpandCollapse/Panel.js +6 -7
  30. package/lib/Feedback/Feedback.js +6 -5
  31. package/lib/Fieldset/Fieldset.js +1 -3
  32. package/lib/FlexGrid/FlexGrid.js +4 -4
  33. package/lib/FlexGrid/helpers/index.js +1 -4
  34. package/lib/HorizontalScroll/HorizontalScroll.js +5 -6
  35. package/lib/IconButton/IconButton.js +6 -6
  36. package/lib/InputLabel/InputLabel.js +7 -2
  37. package/lib/InputSupports/InputSupports.js +2 -2
  38. package/lib/Link/LinkBase.js +12 -13
  39. package/lib/List/List.js +4 -6
  40. package/lib/List/ListItem.js +6 -2
  41. package/lib/Modal/Modal.js +6 -2
  42. package/lib/Notification/Notification.js +12 -8
  43. package/lib/Pagination/Pagination.js +8 -3
  44. package/lib/Progress/Progress.js +5 -4
  45. package/lib/Progress/ProgressBar.js +8 -7
  46. package/lib/Radio/Radio.js +4 -6
  47. package/lib/Radio/RadioButton.js +6 -3
  48. package/lib/Radio/RadioGroup.js +7 -2
  49. package/lib/RadioCard/RadioCard.js +4 -4
  50. package/lib/RadioCard/RadioCardGroup.js +9 -6
  51. package/lib/Search/Search.js +7 -2
  52. package/lib/Select/Select.js +10 -9
  53. package/lib/SideNav/Item.js +7 -7
  54. package/lib/SideNav/SideNav.js +7 -3
  55. package/lib/Skeleton/Skeleton.js +6 -2
  56. package/lib/Spacer/Spacer.js +9 -20
  57. package/lib/StackView/StackView.js +7 -7
  58. package/lib/StackView/StackWrapBox.js +6 -7
  59. package/lib/StackView/StackWrapGap.js +6 -5
  60. package/lib/StackView/getStackedContent.js +1 -1
  61. package/lib/StepTracker/Step.js +7 -3
  62. package/lib/StepTracker/StepTracker.js +7 -7
  63. package/lib/Tabs/Tabs.js +6 -2
  64. package/lib/Tabs/TabsItem.js +6 -5
  65. package/lib/Tags/Tags.js +11 -12
  66. package/lib/TextInput/TextArea.js +13 -14
  67. package/lib/TextInput/TextInput.js +13 -14
  68. package/lib/TextInput/TextInputBase.js +5 -3
  69. package/lib/ThemeProvider/useThemeTokens.js +3 -3
  70. package/lib/ThemeProvider/utils/theme-tokens.js +3 -3
  71. package/lib/ToggleSwitch/ToggleSwitch.js +10 -9
  72. package/lib/ToggleSwitch/ToggleSwitchGroup.js +10 -12
  73. package/lib/Tooltip/Tooltip.js +7 -2
  74. package/lib/TooltipButton/TooltipButton.js +7 -2
  75. package/lib/Typography/Typography.js +8 -6
  76. package/lib/index.js +7 -0
  77. package/lib/utils/a11y/semantics.js +4 -3
  78. package/lib/utils/children.js +5 -1
  79. package/lib/utils/index.js +18 -4
  80. package/lib/utils/pressability.js +2 -2
  81. package/lib/utils/props/a11yProps.js +153 -0
  82. package/lib/utils/props/clickProps.js +36 -0
  83. package/lib/utils/props/componentPropType.js +70 -0
  84. package/lib/utils/props/copyPropTypes.js +14 -0
  85. package/lib/utils/props/getPropSelector.js +13 -0
  86. package/lib/utils/props/hrefAttrsProp.js +41 -0
  87. package/lib/utils/props/index.js +158 -0
  88. package/lib/{InputSupports/propTypes.js → utils/props/inputSupportsProps.js} +2 -3
  89. package/lib/utils/props/linkProps.js +64 -0
  90. package/lib/utils/props/paddingProp.js +20 -0
  91. package/lib/utils/props/pressProps.js +57 -0
  92. package/lib/utils/props/rectProp.js +20 -0
  93. package/lib/utils/props/responsiveProps.js +40 -0
  94. package/lib/utils/props/selectSystemProps.js +31 -0
  95. package/lib/utils/props/spacingProps.js +71 -0
  96. package/lib/utils/props/tokens.js +145 -0
  97. package/lib/utils/props/variantProp.js +28 -0
  98. package/lib/utils/props/viewProps.js +34 -0
  99. package/lib/utils/ssr.js +51 -0
  100. package/lib/utils/useResponsiveProp.js +1 -1
  101. package/lib/utils/useSpacingScale.js +4 -4
  102. package/lib-module/A11yInfoProvider/index.js +62 -0
  103. package/lib-module/A11yText/index.js +55 -0
  104. package/lib-module/ActivityIndicator/Spinner.js +76 -0
  105. package/lib-module/ActivityIndicator/Spinner.native.js +143 -0
  106. package/lib-module/ActivityIndicator/index.js +40 -0
  107. package/lib-module/ActivityIndicator/shared.js +12 -0
  108. package/lib-module/BaseProvider/index.js +26 -0
  109. package/lib-module/Box/Box.js +243 -0
  110. package/lib-module/Box/index.js +2 -0
  111. package/lib-module/Button/Button.js +25 -0
  112. package/lib-module/Button/ButtonBase.js +254 -0
  113. package/lib-module/Button/ButtonGroup.js +164 -0
  114. package/lib-module/Button/ButtonLink.js +39 -0
  115. package/lib-module/Button/index.js +4 -0
  116. package/lib-module/Button/propTypes.js +36 -0
  117. package/lib-module/Card/Card.js +83 -0
  118. package/lib-module/Card/CardBase.js +62 -0
  119. package/lib-module/Card/PressableCardBase.js +113 -0
  120. package/lib-module/Card/index.js +4 -0
  121. package/lib-module/Checkbox/Checkbox.js +321 -0
  122. package/lib-module/Checkbox/CheckboxGroup.js +218 -0
  123. package/lib-module/Checkbox/CheckboxInput.js +58 -0
  124. package/lib-module/Checkbox/CheckboxInput.native.js +6 -0
  125. package/lib-module/Checkbox/index.js +3 -0
  126. package/lib-module/Divider/Divider.js +123 -0
  127. package/lib-module/Divider/index.js +2 -0
  128. package/lib-module/ExpandCollapse/Accordion.js +15 -0
  129. package/lib-module/ExpandCollapse/Control.js +130 -0
  130. package/lib-module/ExpandCollapse/ExpandCollapse.js +94 -0
  131. package/lib-module/ExpandCollapse/Panel.js +158 -0
  132. package/lib-module/ExpandCollapse/index.js +7 -0
  133. package/lib-module/Feedback/Feedback.js +144 -0
  134. package/lib-module/Feedback/index.js +2 -0
  135. package/lib-module/Fieldset/Fieldset.js +145 -0
  136. package/lib-module/Fieldset/FieldsetContainer.js +29 -0
  137. package/lib-module/Fieldset/FieldsetContainer.native.js +20 -0
  138. package/lib-module/Fieldset/Legend.js +21 -0
  139. package/lib-module/Fieldset/Legend.native.js +28 -0
  140. package/lib-module/Fieldset/cssReset.js +14 -0
  141. package/lib-module/Fieldset/index.js +2 -0
  142. package/lib-module/FlexGrid/Col/Col.js +265 -0
  143. package/lib-module/FlexGrid/Col/index.js +2 -0
  144. package/lib-module/FlexGrid/FlexGrid.js +147 -0
  145. package/lib-module/FlexGrid/Row/Row.js +177 -0
  146. package/lib-module/FlexGrid/Row/index.js +2 -0
  147. package/lib-module/FlexGrid/helpers/index.js +18 -0
  148. package/lib-module/FlexGrid/index.js +2 -0
  149. package/lib-module/FlexGrid/providers/GutterContext.js +3 -0
  150. package/lib-module/HorizontalScroll/HorizontalScroll.js +171 -0
  151. package/lib-module/HorizontalScroll/HorizontalScrollButton.js +102 -0
  152. package/lib-module/HorizontalScroll/ScrollViewEnd.js +47 -0
  153. package/lib-module/HorizontalScroll/ScrollViewEnd.native.js +24 -0
  154. package/lib-module/HorizontalScroll/dictionary.js +11 -0
  155. package/lib-module/HorizontalScroll/index.js +11 -0
  156. package/lib-module/HorizontalScroll/itemPositions.js +106 -0
  157. package/lib-module/Icon/Icon.js +61 -0
  158. package/lib-module/Icon/IconText.js +81 -0
  159. package/lib-module/Icon/index.js +4 -0
  160. package/lib-module/IconButton/IconButton.js +115 -0
  161. package/lib-module/IconButton/index.js +2 -0
  162. package/lib-module/InputLabel/InputLabel.js +131 -0
  163. package/lib-module/InputLabel/LabelContent.js +24 -0
  164. package/lib-module/InputLabel/LabelContent.native.js +16 -0
  165. package/lib-module/InputLabel/index.js +2 -0
  166. package/lib-module/InputSupports/InputSupports.js +88 -0
  167. package/lib-module/InputSupports/index.js +2 -0
  168. package/lib-module/InputSupports/useInputSupports.js +31 -0
  169. package/lib-module/Link/ChevronLink.js +51 -0
  170. package/lib-module/Link/InlinePressable.js +37 -0
  171. package/lib-module/Link/InlinePressable.native.js +85 -0
  172. package/lib-module/Link/Link.js +27 -0
  173. package/lib-module/Link/LinkBase.js +210 -0
  174. package/lib-module/Link/TextButton.js +43 -0
  175. package/lib-module/Link/index.js +5 -0
  176. package/lib-module/List/List.js +55 -0
  177. package/lib-module/List/ListItem.js +213 -0
  178. package/lib-module/List/index.js +5 -0
  179. package/lib-module/Modal/Modal.js +208 -0
  180. package/lib-module/Modal/dictionary.js +9 -0
  181. package/lib-module/Modal/index.js +2 -0
  182. package/lib-module/Notification/Notification.js +196 -0
  183. package/lib-module/Notification/dictionary.js +8 -0
  184. package/lib-module/Notification/index.js +2 -0
  185. package/lib-module/Pagination/PageButton.js +65 -0
  186. package/lib-module/Pagination/Pagination.js +140 -0
  187. package/lib-module/Pagination/SideButton.js +103 -0
  188. package/lib-module/Pagination/dictionary.js +18 -0
  189. package/lib-module/Pagination/index.js +2 -0
  190. package/lib-module/Pagination/usePagination.js +72 -0
  191. package/lib-module/Progress/Progress.js +85 -0
  192. package/lib-module/Progress/ProgressBar.js +134 -0
  193. package/lib-module/Progress/ProgressBarBackground.js +41 -0
  194. package/lib-module/Progress/index.js +4 -0
  195. package/lib-module/Radio/Radio.js +263 -0
  196. package/lib-module/Radio/RadioButton.js +128 -0
  197. package/lib-module/Radio/RadioGroup.js +225 -0
  198. package/lib-module/Radio/RadioInput.js +60 -0
  199. package/lib-module/Radio/RadioInput.native.js +6 -0
  200. package/lib-module/Radio/index.js +3 -0
  201. package/lib-module/RadioCard/RadioCard.js +218 -0
  202. package/lib-module/RadioCard/RadioCardGroup.js +232 -0
  203. package/lib-module/RadioCard/index.js +3 -0
  204. package/lib-module/Search/Search.js +233 -0
  205. package/lib-module/Search/dictionary.js +12 -0
  206. package/lib-module/Search/index.js +2 -0
  207. package/lib-module/Select/Group.js +20 -0
  208. package/lib-module/Select/Group.native.js +14 -0
  209. package/lib-module/Select/Item.js +17 -0
  210. package/lib-module/Select/Item.native.js +9 -0
  211. package/lib-module/Select/Picker.js +67 -0
  212. package/lib-module/Select/Picker.native.js +110 -0
  213. package/lib-module/Select/Select.js +317 -0
  214. package/lib-module/Select/index.js +6 -0
  215. package/lib-module/SideNav/Item.js +139 -0
  216. package/lib-module/SideNav/ItemContent.js +45 -0
  217. package/lib-module/SideNav/ItemsGroup.js +115 -0
  218. package/lib-module/SideNav/SideNav.js +133 -0
  219. package/lib-module/SideNav/index.js +1 -0
  220. package/lib-module/Skeleton/Skeleton.js +117 -0
  221. package/lib-module/Skeleton/index.js +2 -0
  222. package/lib-module/Skeleton/skeleton.constant.js +3 -0
  223. package/lib-module/Skeleton/skeletonWebAnimation.js +18 -0
  224. package/lib-module/Skeleton/useSkeletonNativeAnimation.js +24 -0
  225. package/lib-module/Spacer/Spacer.js +97 -0
  226. package/lib-module/Spacer/index.js +2 -0
  227. package/lib-module/StackView/StackView.js +124 -0
  228. package/lib-module/StackView/StackWrap.js +48 -0
  229. package/lib-module/StackView/StackWrap.native.js +3 -0
  230. package/lib-module/StackView/StackWrapBox.js +114 -0
  231. package/lib-module/StackView/StackWrapGap.js +58 -0
  232. package/lib-module/StackView/common.js +32 -0
  233. package/lib-module/StackView/getStackedContent.js +123 -0
  234. package/lib-module/StackView/index.js +5 -0
  235. package/lib-module/StepTracker/Step.js +229 -0
  236. package/lib-module/StepTracker/StepTracker.js +175 -0
  237. package/lib-module/StepTracker/dictionary.js +10 -0
  238. package/lib-module/StepTracker/index.js +2 -0
  239. package/lib-module/Tabs/Tabs.js +113 -0
  240. package/lib-module/Tabs/TabsItem.js +215 -0
  241. package/lib-module/Tabs/index.js +2 -0
  242. package/lib-module/Tags/Tags.js +238 -0
  243. package/lib-module/Tags/index.js +2 -0
  244. package/lib-module/TextInput/TextArea.js +88 -0
  245. package/lib-module/TextInput/TextInput.js +60 -0
  246. package/lib-module/TextInput/TextInputBase.js +233 -0
  247. package/lib-module/TextInput/index.js +3 -0
  248. package/lib-module/TextInput/propTypes.js +31 -0
  249. package/lib-module/ThemeProvider/ThemeProvider.js +35 -0
  250. package/lib-module/ThemeProvider/index.js +6 -0
  251. package/lib-module/ThemeProvider/useSetTheme.js +22 -0
  252. package/lib-module/ThemeProvider/useTheme.js +14 -0
  253. package/lib-module/ThemeProvider/useThemeTokens.js +105 -0
  254. package/lib-module/ThemeProvider/utils/index.js +2 -0
  255. package/lib-module/ThemeProvider/utils/styles.js +174 -0
  256. package/lib-module/ThemeProvider/utils/theme-tokens.js +151 -0
  257. package/lib-module/ToggleSwitch/ToggleSwitch.js +224 -0
  258. package/lib-module/ToggleSwitch/ToggleSwitchGroup.js +202 -0
  259. package/lib-module/ToggleSwitch/index.js +3 -0
  260. package/lib-module/Tooltip/Backdrop.js +52 -0
  261. package/lib-module/Tooltip/Backdrop.native.js +43 -0
  262. package/lib-module/Tooltip/Tooltip.js +332 -0
  263. package/lib-module/Tooltip/dictionary.js +8 -0
  264. package/lib-module/Tooltip/getTooltipPosition.js +164 -0
  265. package/lib-module/Tooltip/index.js +2 -0
  266. package/lib-module/TooltipButton/TooltipButton.js +71 -0
  267. package/lib-module/TooltipButton/index.js +2 -0
  268. package/lib-module/Typography/Typography.js +118 -0
  269. package/lib-module/Typography/index.js +2 -0
  270. package/lib-module/ViewportProvider/ViewportProvider.js +28 -0
  271. package/lib-module/ViewportProvider/index.js +3 -0
  272. package/lib-module/ViewportProvider/useViewport.js +3 -0
  273. package/lib-module/ViewportProvider/useViewportListener.js +43 -0
  274. package/lib-module/index.js +48 -0
  275. package/lib-module/utils/a11y/index.js +2 -0
  276. package/lib-module/utils/a11y/semantics.js +154 -0
  277. package/lib-module/utils/a11y/textSize.js +34 -0
  278. package/lib-module/utils/animation/index.js +2 -0
  279. package/lib-module/utils/animation/useVerticalExpandAnimation.js +49 -0
  280. package/lib-module/utils/children.js +118 -0
  281. package/lib-module/utils/index.js +15 -0
  282. package/lib-module/utils/info/index.js +7 -0
  283. package/lib-module/utils/info/platform/index.js +11 -0
  284. package/lib-module/utils/info/platform/platform.android.js +1 -0
  285. package/lib-module/utils/info/platform/platform.ios.js +1 -0
  286. package/lib-module/utils/info/platform/platform.js +1 -0
  287. package/lib-module/utils/info/platform/platform.native.js +4 -0
  288. package/lib-module/utils/info/versions.js +5 -0
  289. package/lib-module/utils/input.js +180 -0
  290. package/lib-module/utils/pressability.js +97 -0
  291. package/lib-module/utils/props/a11yProps.js +140 -0
  292. package/lib-module/utils/props/clickProps.js +25 -0
  293. package/lib-module/utils/props/componentPropType.js +63 -0
  294. package/lib-module/utils/props/copyPropTypes.js +2 -0
  295. package/lib-module/utils/props/getPropSelector.js +6 -0
  296. package/lib-module/utils/props/hrefAttrsProp.js +30 -0
  297. package/lib-module/utils/props/index.js +16 -0
  298. package/lib-module/utils/props/inputSupportsProps.js +54 -0
  299. package/lib-module/utils/props/linkProps.js +47 -0
  300. package/lib-module/utils/props/paddingProp.js +9 -0
  301. package/lib-module/utils/props/pressProps.js +42 -0
  302. package/lib-module/utils/props/rectProp.js +9 -0
  303. package/lib-module/utils/props/responsiveProps.js +30 -0
  304. package/lib-module/utils/props/selectSystemProps.js +24 -0
  305. package/lib-module/utils/props/spacingProps.js +56 -0
  306. package/lib-module/utils/props/tokens.js +120 -0
  307. package/lib-module/utils/props/variantProp.js +18 -0
  308. package/lib-module/utils/props/viewProps.js +22 -0
  309. package/lib-module/utils/ssr.js +35 -0
  310. package/lib-module/utils/useCopy.js +42 -0
  311. package/lib-module/utils/useHash.js +44 -0
  312. package/lib-module/utils/useHash.native.js +7 -0
  313. package/lib-module/utils/useResponsiveProp.js +47 -0
  314. package/lib-module/utils/useSpacingScale.js +123 -0
  315. package/lib-module/utils/useUniqueId.js +12 -0
  316. package/lib-module/utils/withLinkRouter.js +82 -0
  317. package/package.json +9 -5
  318. package/src/A11yText/index.jsx +7 -3
  319. package/src/ActivityIndicator/Spinner.jsx +56 -44
  320. package/src/ActivityIndicator/Spinner.native.jsx +20 -12
  321. package/src/ActivityIndicator/index.jsx +1 -1
  322. package/src/Box/Box.jsx +15 -13
  323. package/src/Button/Button.jsx +1 -1
  324. package/src/Button/ButtonBase.jsx +9 -8
  325. package/src/Button/ButtonGroup.jsx +17 -8
  326. package/src/Button/ButtonLink.jsx +1 -1
  327. package/src/Button/propTypes.js +2 -1
  328. package/src/Card/Card.jsx +7 -4
  329. package/src/Card/CardBase.jsx +6 -5
  330. package/src/Card/PressableCardBase.jsx +12 -12
  331. package/src/Checkbox/Checkbox.jsx +12 -5
  332. package/src/Divider/Divider.jsx +19 -12
  333. package/src/ExpandCollapse/Control.jsx +12 -7
  334. package/src/ExpandCollapse/ExpandCollapse.jsx +13 -3
  335. package/src/ExpandCollapse/Panel.jsx +15 -5
  336. package/src/Feedback/Feedback.jsx +13 -3
  337. package/src/Fieldset/Fieldset.jsx +1 -1
  338. package/src/FlexGrid/FlexGrid.jsx +11 -5
  339. package/src/FlexGrid/helpers/index.js +1 -3
  340. package/src/HorizontalScroll/HorizontalScroll.jsx +12 -5
  341. package/src/IconButton/IconButton.jsx +12 -8
  342. package/src/InputLabel/InputLabel.jsx +16 -2
  343. package/src/InputSupports/InputSupports.jsx +1 -1
  344. package/src/Link/LinkBase.jsx +11 -10
  345. package/src/List/List.jsx +12 -5
  346. package/src/List/ListItem.jsx +16 -2
  347. package/src/Modal/Modal.jsx +63 -50
  348. package/src/Notification/Notification.jsx +23 -6
  349. package/src/Pagination/Pagination.jsx +10 -3
  350. package/src/Progress/Progress.jsx +5 -3
  351. package/src/Progress/ProgressBar.jsx +8 -6
  352. package/src/Radio/Radio.jsx +13 -5
  353. package/src/Radio/RadioButton.jsx +13 -3
  354. package/src/Radio/RadioGroup.jsx +14 -2
  355. package/src/RadioCard/RadioCard.jsx +9 -6
  356. package/src/RadioCard/RadioCardGroup.jsx +16 -4
  357. package/src/Search/Search.jsx +15 -3
  358. package/src/Select/Select.jsx +21 -7
  359. package/src/SideNav/Item.jsx +15 -7
  360. package/src/SideNav/SideNav.jsx +13 -2
  361. package/src/Skeleton/Skeleton.jsx +55 -43
  362. package/src/Spacer/Spacer.jsx +10 -18
  363. package/src/StackView/StackView.jsx +13 -12
  364. package/src/StackView/StackWrapBox.jsx +12 -12
  365. package/src/StackView/StackWrapGap.jsx +9 -7
  366. package/src/StackView/getStackedContent.jsx +1 -1
  367. package/src/StepTracker/Step.jsx +7 -4
  368. package/src/StepTracker/StepTracker.jsx +8 -8
  369. package/src/Tabs/Tabs.jsx +16 -3
  370. package/src/Tabs/TabsItem.jsx +13 -9
  371. package/src/Tags/Tags.jsx +16 -7
  372. package/src/TextInput/TextArea.jsx +20 -8
  373. package/src/TextInput/TextInput.jsx +20 -8
  374. package/src/TextInput/TextInputBase.jsx +13 -3
  375. package/src/ThemeProvider/useThemeTokens.js +3 -3
  376. package/src/ThemeProvider/utils/theme-tokens.js +3 -3
  377. package/src/ToggleSwitch/ToggleSwitch.jsx +12 -7
  378. package/src/ToggleSwitch/ToggleSwitchGroup.jsx +14 -6
  379. package/src/Tooltip/Tooltip.jsx +13 -3
  380. package/src/TooltipButton/TooltipButton.jsx +6 -4
  381. package/src/Typography/Typography.jsx +10 -6
  382. package/src/index.js +1 -1
  383. package/src/utils/a11y/semantics.js +3 -2
  384. package/src/utils/children.jsx +2 -1
  385. package/src/utils/index.js +2 -1
  386. package/src/utils/pressability.js +1 -1
  387. package/src/utils/props/a11yProps.js +151 -0
  388. package/src/utils/props/clickProps.js +31 -0
  389. package/src/utils/props/componentPropType.js +67 -0
  390. package/src/utils/props/copyPropTypes.js +3 -0
  391. package/src/utils/props/getPropSelector.js +14 -0
  392. package/src/utils/props/hrefAttrsProp.js +25 -0
  393. package/src/utils/props/index.js +16 -0
  394. package/src/{InputSupports/propTypes.js → utils/props/inputSupportsProps.js} +2 -4
  395. package/src/utils/props/linkProps.js +43 -0
  396. package/src/utils/props/paddingProp.js +10 -0
  397. package/src/utils/props/pressProps.js +45 -0
  398. package/src/utils/props/rectProp.js +10 -0
  399. package/src/utils/props/responsiveProps.js +30 -0
  400. package/src/utils/props/selectSystemProps.js +25 -0
  401. package/src/utils/props/spacingProps.js +58 -0
  402. package/src/utils/props/tokens.js +150 -0
  403. package/src/utils/props/variantProp.js +20 -0
  404. package/src/utils/props/viewProps.js +23 -0
  405. package/src/utils/ssr.js +35 -0
  406. package/src/utils/useResponsiveProp.js +1 -1
  407. package/src/utils/useSpacingScale.js +4 -4
  408. package/.ultra.cache.json +0 -1
  409. package/lib/utils/a11y/propTypes.js +0 -61
  410. package/lib/utils/a11y/propTypes.native.js +0 -47
  411. package/lib/utils/propTypes.js +0 -566
  412. package/release-context.json +0 -7
  413. package/src/utils/a11y/propTypes.js +0 -61
  414. package/src/utils/a11y/propTypes.native.js +0 -39
  415. package/src/utils/propTypes.js +0 -561
@@ -0,0 +1,13 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = getPropSelector;
7
+
8
+ function getPropSelector(propTypes, regexp) {
9
+ const keys = Object.keys(propTypes);
10
+ return props => Object.entries(props).reduce((items, [key, value]) => keys.includes(key) || regexp && regexp.test(key) ? { ...items,
11
+ [key]: value
12
+ } : items, {});
13
+ }
@@ -0,0 +1,41 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+
8
+ var _propTypes = _interopRequireDefault(require("prop-types"));
9
+
10
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
11
+
12
+ // Props related to HTML <a> anchor link attributes.
13
+ const targetValues = ['_self', '_blank', '_parent', '_top'];
14
+ var _default = {
15
+ types: {
16
+ // React Native Web >= 0.15.0 supports hrefAttrs prop with only these properties
17
+ // and passes them to <a> if an element has a href prop or accessibilityRole "link"
18
+ download: _propTypes.default.string,
19
+ rel: _propTypes.default.string,
20
+ target: _propTypes.default.oneOf(targetValues)
21
+ },
22
+
23
+ /**
24
+ * Takes a props object, bundles any hrefAttrs props present into one object
25
+ * and returns that keyed as `hrefAttrs` and non-hrefAttrs props keyed as `rest`
26
+ */
27
+ bundle: ({
28
+ download,
29
+ rel,
30
+ target,
31
+ ...rest
32
+ }) => ({
33
+ hrefAttrs: {
34
+ download,
35
+ rel,
36
+ target
37
+ },
38
+ rest
39
+ })
40
+ };
41
+ exports.default = _default;
@@ -0,0 +1,158 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ var _exportNames = {
7
+ a11yProps: true,
8
+ clickProps: true,
9
+ copyPropTypes: true,
10
+ componentPropType: true,
11
+ hrefAttrsProp: true,
12
+ inputSupportsProps: true,
13
+ linkProps: true,
14
+ pressProps: true,
15
+ paddingProp: true,
16
+ rectProp: true,
17
+ responsiveProps: true,
18
+ spacingProps: true,
19
+ selectSystemProps: true,
20
+ variantProp: true,
21
+ viewProps: true
22
+ };
23
+ Object.defineProperty(exports, "a11yProps", {
24
+ enumerable: true,
25
+ get: function () {
26
+ return _a11yProps.default;
27
+ }
28
+ });
29
+ Object.defineProperty(exports, "clickProps", {
30
+ enumerable: true,
31
+ get: function () {
32
+ return _clickProps.default;
33
+ }
34
+ });
35
+ Object.defineProperty(exports, "copyPropTypes", {
36
+ enumerable: true,
37
+ get: function () {
38
+ return _copyPropTypes.default;
39
+ }
40
+ });
41
+ Object.defineProperty(exports, "componentPropType", {
42
+ enumerable: true,
43
+ get: function () {
44
+ return _componentPropType.default;
45
+ }
46
+ });
47
+ Object.defineProperty(exports, "hrefAttrsProp", {
48
+ enumerable: true,
49
+ get: function () {
50
+ return _hrefAttrsProp.default;
51
+ }
52
+ });
53
+ Object.defineProperty(exports, "inputSupportsProps", {
54
+ enumerable: true,
55
+ get: function () {
56
+ return _inputSupportsProps.default;
57
+ }
58
+ });
59
+ Object.defineProperty(exports, "linkProps", {
60
+ enumerable: true,
61
+ get: function () {
62
+ return _linkProps.default;
63
+ }
64
+ });
65
+ Object.defineProperty(exports, "pressProps", {
66
+ enumerable: true,
67
+ get: function () {
68
+ return _pressProps.default;
69
+ }
70
+ });
71
+ Object.defineProperty(exports, "paddingProp", {
72
+ enumerable: true,
73
+ get: function () {
74
+ return _paddingProp.default;
75
+ }
76
+ });
77
+ Object.defineProperty(exports, "rectProp", {
78
+ enumerable: true,
79
+ get: function () {
80
+ return _rectProp.default;
81
+ }
82
+ });
83
+ Object.defineProperty(exports, "responsiveProps", {
84
+ enumerable: true,
85
+ get: function () {
86
+ return _responsiveProps.default;
87
+ }
88
+ });
89
+ Object.defineProperty(exports, "spacingProps", {
90
+ enumerable: true,
91
+ get: function () {
92
+ return _spacingProps.default;
93
+ }
94
+ });
95
+ Object.defineProperty(exports, "selectSystemProps", {
96
+ enumerable: true,
97
+ get: function () {
98
+ return _selectSystemProps.default;
99
+ }
100
+ });
101
+ Object.defineProperty(exports, "variantProp", {
102
+ enumerable: true,
103
+ get: function () {
104
+ return _variantProp.default;
105
+ }
106
+ });
107
+ Object.defineProperty(exports, "viewProps", {
108
+ enumerable: true,
109
+ get: function () {
110
+ return _viewProps.default;
111
+ }
112
+ });
113
+
114
+ var _tokens = require("./tokens");
115
+
116
+ Object.keys(_tokens).forEach(function (key) {
117
+ if (key === "default" || key === "__esModule") return;
118
+ if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
119
+ if (key in exports && exports[key] === _tokens[key]) return;
120
+ Object.defineProperty(exports, key, {
121
+ enumerable: true,
122
+ get: function () {
123
+ return _tokens[key];
124
+ }
125
+ });
126
+ });
127
+
128
+ var _a11yProps = _interopRequireDefault(require("./a11yProps"));
129
+
130
+ var _clickProps = _interopRequireDefault(require("./clickProps"));
131
+
132
+ var _copyPropTypes = _interopRequireDefault(require("./copyPropTypes"));
133
+
134
+ var _componentPropType = _interopRequireDefault(require("./componentPropType"));
135
+
136
+ var _hrefAttrsProp = _interopRequireDefault(require("./hrefAttrsProp"));
137
+
138
+ var _inputSupportsProps = _interopRequireDefault(require("./inputSupportsProps"));
139
+
140
+ var _linkProps = _interopRequireDefault(require("./linkProps"));
141
+
142
+ var _pressProps = _interopRequireDefault(require("./pressProps"));
143
+
144
+ var _paddingProp = _interopRequireDefault(require("./paddingProp"));
145
+
146
+ var _rectProp = _interopRequireDefault(require("./rectProp"));
147
+
148
+ var _responsiveProps = _interopRequireDefault(require("./responsiveProps"));
149
+
150
+ var _spacingProps = _interopRequireDefault(require("./spacingProps"));
151
+
152
+ var _selectSystemProps = _interopRequireDefault(require("./selectSystemProps"));
153
+
154
+ var _variantProp = _interopRequireDefault(require("./variantProp"));
155
+
156
+ var _viewProps = _interopRequireDefault(require("./viewProps"));
157
+
158
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
@@ -9,7 +9,7 @@ var _propTypes = _interopRequireDefault(require("prop-types"));
9
9
 
10
10
  function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
11
11
 
12
- const inputSupportProps = {
12
+ var _default = {
13
13
  types: {
14
14
  /**
15
15
  * The input label.
@@ -59,8 +59,7 @@ const inputSupportProps = {
59
59
  tooltip,
60
60
  validation
61
61
  },
62
- rest
62
+ ...rest
63
63
  })
64
64
  };
65
- var _default = inputSupportProps;
66
65
  exports.default = _default;
@@ -0,0 +1,64 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+
8
+ var _Linking = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Linking"));
9
+
10
+ var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
11
+
12
+ var _propTypes = _interopRequireDefault(require("prop-types"));
13
+
14
+ var _pressProps = require("./pressProps");
15
+
16
+ var _a11yProps = _interopRequireDefault(require("./a11yProps"));
17
+
18
+ var _hrefAttrsProp = _interopRequireDefault(require("./hrefAttrsProp"));
19
+
20
+ var _getPropSelector = _interopRequireDefault(require("./getPropSelector"));
21
+
22
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
23
+
24
+ const linkPropTypes = { ..._pressProps.pressPropTypes,
25
+ href: _propTypes.default.string,
26
+ hrefAttrs: _propTypes.default.shape(_hrefAttrsProp.default.types),
27
+ ..._a11yProps.default.types
28
+ };
29
+ var _default = {
30
+ /**
31
+ * Proptypes for components that, on Web, can output <a href="..."> link elements
32
+ */
33
+ types: linkPropTypes,
34
+
35
+ /**
36
+ * Filters a props object, returning only the platform-relevant link props defined above
37
+ */
38
+ select: (0, _getPropSelector.default)(linkPropTypes),
39
+
40
+ /**
41
+ * Turn hrefs into press handlers on Native and throw if not given `onPress` or `href`.
42
+ *
43
+ * @param {({ onPress?: () => void, href?: string })}
44
+ * @returns {(() => void)|undefined} Returns a press handler, or undefined on web if href
45
+ * string is provided. Expects calling component to use href string on web (e.g. in `<a>`).
46
+ */
47
+ handleHref: ({
48
+ onPress,
49
+ href
50
+ }) => {
51
+ if (!href && !onPress) {
52
+ throw new Error('handleHref requires either href or onPress');
53
+ }
54
+
55
+ return _Platform.default.select({
56
+ web: onPress,
57
+ default: (...args) => {
58
+ if (onPress) onPress(...args);
59
+ if (href) _Linking.default.openURL(href);
60
+ }
61
+ });
62
+ }
63
+ };
64
+ exports.default = _default;
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+
8
+ var _propTypes = _interopRequireDefault(require("prop-types"));
9
+
10
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
11
+
12
+ var _default = {
13
+ propType: _propTypes.default.shape({
14
+ paddingBottom: _propTypes.default.number,
15
+ paddingLeft: _propTypes.default.number,
16
+ paddingRight: _propTypes.default.number,
17
+ paddingTop: _propTypes.default.number
18
+ })
19
+ };
20
+ exports.default = _default;
@@ -0,0 +1,57 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = exports.pressPropTypes = void 0;
7
+
8
+ var _Platform = _interopRequireDefault(require("react-native-web/dist/cjs/exports/Platform"));
9
+
10
+ var _propTypes = _interopRequireDefault(require("prop-types"));
11
+
12
+ var _rectProp = _interopRequireDefault(require("./rectProp"));
13
+
14
+ var _getPropSelector = _interopRequireDefault(require("./getPropSelector"));
15
+
16
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
17
+
18
+ const pressHandlerPropTypes = {
19
+ onPress: _propTypes.default.func,
20
+ onPressIn: _propTypes.default.func,
21
+ onPressOut: _propTypes.default.func,
22
+ ..._Platform.default.select({
23
+ web: {
24
+ onMouseEnter: _propTypes.default.func,
25
+ onMouseLeave: _propTypes.default.func,
26
+ onFocus: _propTypes.default.func,
27
+ onBlur: _propTypes.default.func
28
+ },
29
+ default: {
30
+ onLongPress: _propTypes.default.func
31
+ }
32
+ })
33
+ };
34
+ const pressPropTypes = { ...pressHandlerPropTypes,
35
+ disabled: _propTypes.default.bool,
36
+ ..._Platform.default.select({
37
+ web: {},
38
+ default: {
39
+ hitSlop: _propTypes.default.number,
40
+ pressRetentionOffset: _propTypes.default.oneOfType([_propTypes.default.number, _rectProp.default.propType])
41
+ }
42
+ })
43
+ };
44
+ exports.pressPropTypes = pressPropTypes;
45
+ var _default = {
46
+ /**
47
+ * Proptypes for clickable or pressable components, including web-only props
48
+ */
49
+ types: pressPropTypes,
50
+
51
+ /**
52
+ * Filters a props object, returning only the platform-relevant press props defined above
53
+ */
54
+ select: (0, _getPropSelector.default)(pressPropTypes),
55
+ selectHandlers: (0, _getPropSelector.default)(pressHandlerPropTypes)
56
+ };
57
+ exports.default = _default;
@@ -0,0 +1,20 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+
8
+ var _propTypes = _interopRequireDefault(require("prop-types"));
9
+
10
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
11
+
12
+ var _default = {
13
+ propType: _propTypes.default.shape({
14
+ bottom: _propTypes.default.number,
15
+ left: _propTypes.default.number,
16
+ right: _propTypes.default.number,
17
+ top: _propTypes.default.number
18
+ })
19
+ };
20
+ exports.default = _default;
@@ -0,0 +1,40 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+
8
+ var _propTypes = _interopRequireDefault(require("prop-types"));
9
+
10
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
11
+
12
+ const getByViewport = propType => ({
13
+ xs: propType,
14
+ sm: propType,
15
+ md: propType,
16
+ lg: propType,
17
+ xl: propType
18
+ });
19
+ /**
20
+ * Utilities for props that allow different values to be applied at different viewports.
21
+ *
22
+ * These should apply viewport inheritance such that if a viewport is undefined, the value is
23
+ * taken from the next smallest viewport for which a value is available. For example, a
24
+ * responsive prop { xs: 2, lg: 3 } should apply 2 at sizes sm and md, and 3 at size xl.
25
+ *
26
+ * @property {Function} getByViewport - returns an object where each each viewport has a key
27
+ * containing the provided argument.
28
+ * @property {Function} getTypeByViewport - returns a PropTypes shape validator for an object where
29
+ * each viewport has a key containing the provided proptype.
30
+ * @property {Function} getTypeOptionallyByViewport - returns a PropTypes validator that accepts
31
+ * either the provided proptype on its own, or the output of getTypeByViewport
32
+ */
33
+
34
+
35
+ var _default = {
36
+ getByViewport,
37
+ getTypeByViewport: propType => _propTypes.default.shape(getByViewport(propType)),
38
+ getTypeOptionallyByViewport: propType => _propTypes.default.oneOfType([propType, _propTypes.default.shape(getByViewport(propType))])
39
+ };
40
+ exports.default = _default;
@@ -0,0 +1,31 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = selectSystemProps;
7
+
8
+ // Returns a selector for requested prop kinds as well as the propTypes for
9
+ // those props merged into one object
10
+ function selectSystemProps(systemPropHelpers) {
11
+ const selectProps = props => systemPropHelpers.reduce((acc, propHelper) => {
12
+ if (typeof (propHelper === null || propHelper === void 0 ? void 0 : propHelper.select) !== 'function') {
13
+ throw new Error(`An invalid system prop helper has been passed to 'selectSystemProps': prop selector ('.select') is missing in ${propHelper}`);
14
+ }
15
+
16
+ return { ...acc,
17
+ ...propHelper.select(props)
18
+ };
19
+ }, {});
20
+
21
+ const selectedPropTypes = systemPropHelpers.reduce((acc, propHelper) => {
22
+ if (!(propHelper !== null && propHelper !== void 0 && propHelper.types)) {
23
+ throw new Error(`An invalid system prop helper has been passed to 'selectSystemProps': types selector ('.types') is missing in ${propHelper}`);
24
+ }
25
+
26
+ return { ...acc,
27
+ ...propHelper.types
28
+ };
29
+ }, {});
30
+ return [selectProps, selectedPropTypes];
31
+ }
@@ -0,0 +1,71 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+
8
+ var _propTypes = _interopRequireDefault(require("prop-types"));
9
+
10
+ var _responsiveProps = _interopRequireDefault(require("./responsiveProps"));
11
+
12
+ var _variantProp = _interopRequireDefault(require("./variantProp"));
13
+
14
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
15
+
16
+ /**
17
+ * @typedef {0|1|2|3|4|5|6|7|8|9|10|11} SpacingIndex - value used to select a size on the spacing scale
18
+ *
19
+ * @typedef SpacingOptions
20
+ * @property {VariantProp} [SpacingOptions.variant] - optional theme scale variants e.g. compact, wide
21
+ * @property {number} [SpacingOptions.size] - optional override to force a particular pixel size
22
+ * @property {number} [SpacingOptions.subtract] - optional number to subtract from final pixel size
23
+ *
24
+ * @typedef SpacingObject
25
+ * @property {SpacingIndex} [SpacingObject.xs] - space scale index to use above xs viewport
26
+ * @property {SpacingIndex} [SpacingObject.sm] - space scale index to use above sm viewport
27
+ * @property {SpacingIndex} [SpacingObject.md] - space scale index to use above md viewport
28
+ * @property {SpacingIndex} [SpacingObject.lg] - space scale index to use above lg viewport
29
+ * @property {SpacingIndex} [SpacingObject.xl] - space scale index to use above xl viewport
30
+ * @property {SpacingIndex} [SpacingObject.space] - space scale index to use at all viewports
31
+ * @property {SpacingOptions} [SpacingObject.options] - optional options for this spacing
32
+ *
33
+ * @typedef {SpacingIndex|SpacingObject} SpacingValue
34
+ */
35
+ const spacingScale = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11];
36
+
37
+ const spacingIndexPropType = _propTypes.default.oneOf(spacingScale);
38
+
39
+ const spacingObjectPropType = _propTypes.default.shape({ ..._responsiveProps.default.getByViewport(spacingIndexPropType),
40
+ space: spacingIndexPropType,
41
+ options: _propTypes.default.shape({
42
+ variant: _variantProp.default.propType,
43
+ size: _propTypes.default.number
44
+ })
45
+ });
46
+ /**
47
+ * Components and utilities that assign fixed space between components use a theme-defined spacing scale.
48
+ *
49
+ * They typically take one or more props of the {@link SpacingValue} type and turn it into a pixel size value
50
+ * using the hook `useSpacingScale`, which resolves any options or responsive behaviour and returns the
51
+ * appropriate value from the theme spacing scale.
52
+ *
53
+ * - see /ADRs/inter-component-spacing/README.md - ADR on this structure
54
+ * - see /src/utils/spacing/useSpacingScale.js - hook that processes spacing values
55
+ * - @see {@link SpacingIndex} - themes provide spacing scales of up to 12 sizes with optional theme rules.
56
+ * - @see {@link SpacingValue} - either a simple number referencing an index position on the spacing
57
+ * scale, or an object with an optional `options` key and one or more spacing indexes keyed either by
58
+ * viewports or `space` to apply at all viewports.
59
+ */
60
+
61
+
62
+ var _default = {
63
+ scale: spacingScale,
64
+ types: {
65
+ spacingIndex: spacingIndexPropType,
66
+ spacingObject: spacingObjectPropType,
67
+ // Most spacing components and utilities take this prop / arg type:
68
+ spacingValue: _propTypes.default.oneOfType([spacingIndexPropType, spacingObjectPropType])
69
+ }
70
+ };
71
+ exports.default = _default;
@@ -0,0 +1,145 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.getTokensSetPropType = exports.getTokensPropType = exports.selectTokens = exports.getTokenNames = void 0;
7
+
8
+ var _propTypes = _interopRequireDefault(require("prop-types"));
9
+
10
+ var _systemThemeTokens = require("@telus-uds/system-theme-tokens");
11
+
12
+ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
13
+
14
+ // Tokens can be primitive values (e.g. `'rgba(0,0,0,0'`, `12`), or objects of such values,
15
+ // such as tokens that describe shadow (e.g. shadow: { inset: true, color: 'rgba(...)' ... }),
16
+ // or components (e.g. Icon tokens)
17
+ const tokenValue = _propTypes.default.oneOfType([_propTypes.default.string, _propTypes.default.number, _propTypes.default.bool, _propTypes.default.elementType]);
18
+
19
+ const tokenValueType = _propTypes.default.oneOfType([tokenValue, _propTypes.default.objectOf(tokenValue)]);
20
+
21
+ const getTokenNames = componentName => {
22
+ const componentTokenSchema = _systemThemeTokens.components[componentName];
23
+
24
+ if (!componentTokenSchema) {
25
+ throw new Error(`No "${componentName}" tokenKeys in @telus-uds/system-theme-tokens`);
26
+ }
27
+
28
+ return Object.keys(componentTokenSchema);
29
+ };
30
+ /**
31
+ * Returns the subset of a set of tokens that may be accepted by the `tokens` prop of a named component
32
+ * or by a provided array of tokens. A prefix may be provided, for example:
33
+ *
34
+ * @example
35
+ * ```jsx
36
+ * // returns tokens from `themeTokens` that exist in the theme schema for `Button`.
37
+ * selectTokens('Button', themeTokens)
38
+ * ```
39
+ *
40
+ * @example
41
+ * ```jsx
42
+ * // returns `{ backgroundColor, width }` where the values of those keys come from
43
+ * // the source object's `{ containerBackgroundColor, containerWidth }` properties.
44
+ * selectTokens(['backgroundColor', 'width'], themeTokens, 'container')
45
+ * ```
46
+ *
47
+ * @example
48
+ * ```jsx
49
+ * // returns tokens that are defined in the `Button` theme schema, from tokens with
50
+ * // a prefix `'button'` e.g. a token `buttonBorderWidth` outputs as `borderWidth`.
51
+ * selectTokens('Button', themeTokens, 'button')
52
+ * ```
53
+ *
54
+ * @param {string[]|string} specifier - a name of a component in the theme schema, or an array of token names
55
+ * @param {object} tokens - a source object of theme tokens
56
+ * @param {string} [prefix] - if provided, matches keys in the source object with this as the first camelCase item
57
+ * @returns {object} - subset of theme tokens
58
+ */
59
+
60
+
61
+ exports.getTokenNames = getTokenNames;
62
+
63
+ const selectTokens = (specifier, tokens, prefix) => {
64
+ const tokenNames = typeof specifier === 'string' ? getTokenNames(specifier) : specifier;
65
+ const filteredTokens = tokenNames.reduce((validTokens, key) => {
66
+ const prefixedKey = prefix ? `${prefix}${key[0].toUpperCase()}${key.slice(1)}` : key;
67
+ const token = tokens[prefixedKey];
68
+ return token !== undefined ? { ...validTokens,
69
+ [key]: token
70
+ } : validTokens;
71
+ }, {});
72
+ return filteredTokens;
73
+ };
74
+ /**
75
+ * @typedef {string|number|boolean|{[key: string]:string|number|boolean}} TokenValue
76
+ * @typedef {{[key: string]: TokenValue}} TokensSet
77
+ * @typedef {(AppearanceSet) => TokensSet} TokensGetter
78
+ * @typedef {TokensSet|TokensGetter} TokensProp
79
+ */
80
+
81
+ /**
82
+ * 'tokens' is an optional object prop on all themable components. Its keys must match the
83
+ * token keys in the component's theme schema.
84
+ *
85
+ * This prop is intended to be used as an 'escape hatch' for difficult or exceptional cases
86
+ * where the main theming system doesn't apply. It is intentionally permissive about values.
87
+ *
88
+ * @param {...string} componentsNames - one or more ComponentName, which tokens keys are accepted
89
+ * @return {function} - a custom PropTypes validator
90
+ *
91
+ * @example
92
+ * Component.propTypes = {
93
+ * // accepts all tokens keys defined in Component schema
94
+ * tokens: getTokensPropType('Component')
95
+ * }
96
+ *
97
+ * Component.propTypes = {
98
+ * // accepts all tokens keys defined in schemas for Component1 and Component2
99
+ * tokens: getTokensPropType('Component1', 'Component2')
100
+ * }
101
+ */
102
+
103
+
104
+ exports.selectTokens = selectTokens;
105
+
106
+ const getTokensPropType = (...componentsNames) => (props, propName, componentName) => {
107
+ _propTypes.default.checkPropTypes({
108
+ [propName]: _propTypes.default.oneOfType([_propTypes.default.object, _propTypes.default.func])
109
+ }, props, propName, componentName);
110
+
111
+ if (typeof props[propName] !== 'function') {
112
+ _propTypes.default.checkPropTypes({
113
+ [propName]: _propTypes.default.exact(Object.fromEntries(componentsNames.flatMap(component => getTokenNames(component).map(key => [key, tokenValueType]))))
114
+ }, props, propName, componentName);
115
+ }
116
+ };
117
+ /**
118
+ * Get a proptypes validator for a set of tokens that is not based on a component in the theme schema.
119
+ *
120
+ * For example, for a set of tokens used in a common style, or for a set of tokens required by
121
+ * a themeless component whose tokens are set by a parent but requires tokens of a certain shape.
122
+ *
123
+ * By default, requires an object with a complete set of tokens (allowing `null`, but not `undefined`).
124
+ *
125
+ * @param {string[]} componentTokenKeys - array of strings of token names
126
+ * @param {object} [options]
127
+ * @param {boolean} [options.partial] - if true, allows tokens to be undefined
128
+ * @param {boolean} [options.allowFunction] - if true, allows functions as well as tokens objects
129
+ * @returns
130
+ */
131
+
132
+
133
+ exports.getTokensPropType = getTokensPropType;
134
+
135
+ const getTokensSetPropType = (componentTokenKeys, {
136
+ partial = false,
137
+ allowFunction = false
138
+ } = {}) => {
139
+ 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
140
+ (props, propName, ...args) => props[propName] !== null && tokenValueType.isRequired(props, propName, ...args)])));
141
+
142
+ return allowFunction ? _propTypes.default.oneOfType([tokensObjectValidator, _propTypes.default.func]) : tokensObjectValidator;
143
+ };
144
+
145
+ exports.getTokensSetPropType = getTokensSetPropType;