@workday/canvas-kit-docs 15.0.0-alpha.0076-next.0 → 15.0.0-alpha.0090-next.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 (61) hide show
  1. package/dist/es6/lib/StorybookStatusIndicator.d.ts +2 -2
  2. package/dist/es6/lib/StorybookStatusIndicator.d.ts.map +1 -1
  3. package/dist/es6/lib/StorybookStatusIndicator.js +6 -1
  4. package/dist/es6/lib/docs.js +8766 -8796
  5. package/dist/es6/lib/stackblitzFiles/packageJSONFile.js +5 -5
  6. package/dist/es6/lib/stackblitzFiles/packageJSONFile.ts +5 -5
  7. package/dist/es6/mdx/accessibility/examples/GlobalHeader.js +1 -1
  8. package/dist/mdx/10.0-UPGRADE-GUIDE.mdx +1 -1
  9. package/dist/mdx/15.0-UPGRADE-GUIDE.mdx +127 -0
  10. package/dist/mdx/5.0-UPGRADE-GUIDE.mdx +3 -3
  11. package/dist/mdx/7.0-UPGRADE-GUIDE.mdx +4 -4
  12. package/dist/mdx/8.0-UPGRADE-GUIDE.mdx +5 -5
  13. package/dist/mdx/9.0-UPGRADE-GUIDE.mdx +2 -2
  14. package/dist/mdx/CONTRIBUTING.mdx +4 -4
  15. package/dist/mdx/CREATING_COMPOUND_COMPONENTS.mdx +1 -1
  16. package/dist/mdx/labs-react/side-panel/SidePanel.mdx +85 -54
  17. package/dist/mdx/labs-react/side-panel/examples/AlwaysOpen.tsx +3 -3
  18. package/dist/mdx/labs-react/side-panel/examples/Basic.tsx +17 -37
  19. package/dist/mdx/labs-react/side-panel/examples/ExternalControl.tsx +6 -20
  20. package/dist/mdx/labs-react/side-panel/examples/{HiddenName.tsx → Heading.tsx} +4 -3
  21. package/dist/mdx/labs-react/side-panel/examples/OnStateTransition.tsx +3 -1
  22. package/dist/mdx/labs-react/side-panel/examples/RightOrigin.tsx +3 -9
  23. package/dist/mdx/labs-react/side-panel/examples/Variant.tsx +2 -8
  24. package/dist/mdx/preview-react/divider/examples/Basic.tsx +1 -1
  25. package/dist/mdx/preview-react/multi-select/MultiSelect.mdx +3 -3
  26. package/dist/mdx/preview-react/status-indicator/StatusIndicator.mdx +1 -1
  27. package/dist/mdx/react/action-bar/ActionBar.mdx +1 -1
  28. package/dist/mdx/{preview-react → react}/avatar/Avatar.mdx +5 -7
  29. package/dist/mdx/react/avatar/examples/Basic.tsx +5 -0
  30. package/dist/mdx/{preview-react → react}/avatar/examples/Custom.tsx +1 -1
  31. package/dist/mdx/{preview-react → react}/avatar/examples/Decorative.tsx +1 -1
  32. package/dist/mdx/{preview-react → react}/avatar/examples/Image.tsx +1 -1
  33. package/dist/mdx/{preview-react → react}/avatar/examples/Size.tsx +1 -1
  34. package/dist/mdx/{preview-react → react}/avatar/examples/Variant.tsx +1 -1
  35. package/dist/mdx/react/banner/Banner.mdx +1 -1
  36. package/dist/mdx/react/breadcrumbs/Breadcrumbs.mdx +1 -1
  37. package/dist/mdx/react/card/card.mdx +1 -1
  38. package/dist/mdx/react/common/mdx/CompoundComponentUtilities.mdx +1 -1
  39. package/dist/mdx/react/layout/Box.mdx +13 -13
  40. package/dist/mdx/react/layout/Flex.mdx +3 -3
  41. package/dist/mdx/react/layout/Grid.mdx +3 -3
  42. package/dist/mdx/react/pagination/pagination.mdx +4 -4
  43. package/dist/mdx/react/popup/Popup.mdx +1 -1
  44. package/dist/mdx/react/select/Select.mdx +4 -4
  45. package/dist/mdx/react/tabs/Tabs.mdx +2 -2
  46. package/dist/mdx/react/text/Text.mdx +1 -1
  47. package/dist/mdx/react/toast/toast.mdx +1 -1
  48. package/lib/StorybookStatusIndicator.tsx +10 -1
  49. package/package.json +6 -6
  50. package/dist/mdx/preview-react/avatar/examples/Basic.tsx +0 -5
  51. package/dist/mdx/react/avatar/avatar/Avatar.mdx +0 -109
  52. package/dist/mdx/react/avatar/avatar/examples/Basic.tsx +0 -17
  53. package/dist/mdx/react/avatar/avatar/examples/Button.tsx +0 -20
  54. package/dist/mdx/react/avatar/avatar/examples/CustomStyles.tsx +0 -34
  55. package/dist/mdx/react/avatar/avatar/examples/Image.tsx +0 -25
  56. package/dist/mdx/react/avatar/avatar/examples/LazyLoad.tsx +0 -20
  57. package/dist/mdx/react/avatar/avatar/examples/ObjectFit.tsx +0 -30
  58. package/dist/mdx/react/avatar/avatar/examples/Size.tsx +0 -27
  59. package/dist/mdx/react/avatar/avatar/examples/Variant.tsx +0 -10
  60. package/dist/mdx/react/avatar/avatar/examples/test-avatar.png +0 -0
  61. /package/dist/mdx/{preview-react → react}/avatar/examples/nicholas-avatar.jpg +0 -0
@@ -2,7 +2,7 @@ import {AccentIcon} from '@workday/canvas-kit-react/icon';
2
2
  import {rocketIcon} from '@workday/canvas-accent-icons-web';
3
3
  import {SidePanel, useSidePanelModel} from '@workday/canvas-kit-labs-react/side-panel';
4
4
  import {Flex} from '@workday/canvas-kit-react/layout';
5
- import {Heading, Text} from '@workday/canvas-kit-react/text';
5
+ import {Text} from '@workday/canvas-kit-react/text';
6
6
  import {system} from '@workday/canvas-tokens-web';
7
7
  import {createStyles, px2rem} from '@workday/canvas-kit-styling';
8
8
 
@@ -37,9 +37,9 @@ export default () => {
37
37
  <SidePanel model={model}>
38
38
  <Flex cs={stylesOverride.panelContainer}>
39
39
  <AccentIcon icon={rocketIcon} cs={stylesOverride.accentIcon} />
40
- <Heading size="small" cs={stylesOverride.panelHeading} id={model.state.labelId}>
40
+ <SidePanel.Heading size="small" cs={stylesOverride.panelHeading}>
41
41
  Tasks Panel
42
- </Heading>
42
+ </SidePanel.Heading>
43
43
  </Flex>
44
44
  </SidePanel>
45
45
  <Flex as="main" cs={stylesOverride.mainContent}>
@@ -1,54 +1,34 @@
1
1
  import * as React from 'react';
2
- import {SecondaryButton} from '@workday/canvas-kit-react/button';
2
+
3
3
  import {SidePanel, useSidePanelModel} from '@workday/canvas-kit-labs-react/side-panel';
4
4
  import {Flex} from '@workday/canvas-kit-react/layout';
5
- import {Heading, Text} from '@workday/canvas-kit-react/text';
6
5
  import {AccentIcon} from '@workday/canvas-kit-react/icon';
7
- import {rocketIcon} from '@workday/canvas-accent-icons-web';
8
6
  import {createStyles, px2rem} from '@workday/canvas-kit-styling';
7
+ import {rocketIcon} from '@workday/canvas-accent-icons-web';
9
8
  import {system} from '@workday/canvas-tokens-web';
10
9
 
11
- const stylesOverride = {
12
- viewPortContainer: createStyles({
13
- height: px2rem(320),
14
- }),
15
- panel: createStyles({
16
- alignItems: 'center',
17
- padding: system.space.x4,
18
- }),
19
- accentIcon: createStyles({
20
- marginInlineEnd: system.space.x4,
21
- }),
22
- mainContent: createStyles({
23
- alignItems: 'center',
24
- justifyContent: 'center',
25
- flexDirection: 'column',
26
- flex: 1,
27
- flexBasis: 'auto',
28
- }),
29
- };
10
+ const flexHeadingStyles = createStyles({
11
+ alignItems: 'center',
12
+ gap: system.space.x2,
13
+ });
14
+
15
+ const viewPortStyles = createStyles({
16
+ height: px2rem(320),
17
+ });
30
18
 
31
19
  export default () => {
32
20
  const model = useSidePanelModel();
33
21
 
34
22
  return (
35
- <Flex cs={stylesOverride.viewPortContainer}>
23
+ <Flex cs={viewPortStyles}>
36
24
  <SidePanel model={model}>
37
- <SidePanel.ToggleButton />
38
- <Flex cs={stylesOverride.panel}>
39
- {model.state.transitionState === 'expanded' && (
40
- <Flex cs={stylesOverride.accentIcon}>
41
- <AccentIcon icon={rocketIcon} />
42
- </Flex>
43
- )}
44
- <Heading
45
- size="small"
46
- id={model.state.labelId}
47
- hidden={model.state.transitionState === 'collapsed' ? true : undefined}
48
- >
25
+ <SidePanel.Heading size="small">
26
+ <Flex cs={flexHeadingStyles}>
27
+ <AccentIcon icon={rocketIcon} />
49
28
  Tasks Panel
50
- </Heading>
51
- </Flex>
29
+ </Flex>
30
+ </SidePanel.Heading>
31
+ <SidePanel.ToggleButton aria-label="Collapse View" />
52
32
  </SidePanel>
53
33
  </Flex>
54
34
  );
@@ -1,7 +1,7 @@
1
1
  import * as React from 'react';
2
2
  import {SidePanel, useSidePanelModel} from '@workday/canvas-kit-labs-react/side-panel';
3
3
  import {Flex} from '@workday/canvas-kit-react/layout';
4
- import {Heading, Text} from '@workday/canvas-kit-react/text';
4
+ import {Text} from '@workday/canvas-kit-react/text';
5
5
  import {SecondaryButton} from '@workday/canvas-kit-react/button';
6
6
  import {createStyles, px2rem} from '@workday/canvas-kit-styling';
7
7
  import {system} from '@workday/canvas-tokens-web';
@@ -26,19 +26,6 @@ const stylesOverride = {
26
26
  }),
27
27
  };
28
28
 
29
- /*
30
- * NOTE TO DEV:
31
- * Spreading the `controlProps` onto an external control creates serious accessibility issues.
32
- * - `aria-labelledby` id reference is invalid when the SidePanel is collapsed
33
- * - `aria-labelledby` will change the name of "Toggle Side Panel" button to "Tasks Panel"
34
- * - `aria-expanded` won't make sense to screen reader users when the expanded SidePanel content isn't following the control
35
- * - `aria-controls` is unsupported by screen readers and will not allow users to navigate to the controlled content
36
- *
37
- * SOLUTION:
38
- * - Pass the `controlProps` click handler function down to the external control component.
39
- * - Add a toggle state to Button components with `aria-pressed` for screen readers,
40
- * - OR use a similar toggle input like Checkbox or Switch.
41
- */
42
29
  export default () => {
43
30
  const model = useSidePanelModel({
44
31
  initialTransitionState: 'collapsed',
@@ -48,13 +35,12 @@ export default () => {
48
35
  return (
49
36
  <Flex cs={stylesOverride.viewport}>
50
37
  <SidePanel model={model}>
51
- <SidePanel.ToggleButton />
38
+ <SidePanel.ToggleButton aria-label="Collapse View" />
39
+ <SidePanel.Heading size="small" cs={stylesOverride.panelHeading}>
40
+ Task Panel
41
+ </SidePanel.Heading>
52
42
  {model.state.transitionState === 'expanded' && (
53
- <Flex cs={stylesOverride.panel}>
54
- <Heading size="small" cs={stylesOverride.panelHeading} id={model.state.labelId}>
55
- Tasks Panel
56
- </Heading>
57
- </Flex>
43
+ <Flex cs={stylesOverride.panel}>Contents</Flex>
58
44
  )}
59
45
  </SidePanel>
60
46
  <Flex as="main" cs={stylesOverride.main}>
@@ -1,7 +1,6 @@
1
1
  import * as React from 'react';
2
2
  import {SidePanel, useSidePanelModel} from '@workday/canvas-kit-labs-react/side-panel';
3
3
  import {Flex} from '@workday/canvas-kit-react/layout';
4
- import {AccessibleHide} from '@workday/canvas-kit-react/common';
5
4
  import {Text} from '@workday/canvas-kit-react/text';
6
5
  import {createStyles, px2rem} from '@workday/canvas-kit-styling';
7
6
 
@@ -28,8 +27,10 @@ export default () => {
28
27
  return (
29
28
  <Flex cs={stylesOverride.viewport}>
30
29
  <SidePanel model={model}>
31
- <SidePanel.ToggleButton />
32
- <AccessibleHide id={model.state.labelId}>Hidden Title</AccessibleHide>
30
+ <SidePanel.ToggleButton aria-label="Collapse View" />
31
+ <SidePanel.Heading hidden size="small">
32
+ Tasks Panel
33
+ </SidePanel.Heading>
33
34
  </SidePanel>
34
35
  <Flex as="main" cs={stylesOverride.main}>
35
36
  <Text as="p" typeLevel="body.large">
@@ -37,7 +37,9 @@ export default () => {
37
37
  <Flex cs={stylesOverride.viewport}>
38
38
  <SidePanel model={model}>
39
39
  <SidePanel.ToggleButton />
40
- <AccessibleHide id={model.state.labelId}>Hidden Title</AccessibleHide>
40
+ <SidePanel.Heading hidden size="small">
41
+ Hidden Title
42
+ </SidePanel.Heading>
41
43
  </SidePanel>
42
44
  <Flex as="main" cs={stylesOverride.main}>
43
45
  <Text as="p" typeLevel="body.large">
@@ -1,7 +1,7 @@
1
1
  import {SecondaryButton} from '@workday/canvas-kit-react/button';
2
2
  import {SidePanel, useSidePanelModel} from '@workday/canvas-kit-labs-react/side-panel';
3
3
  import {Flex} from '@workday/canvas-kit-react/layout';
4
- import {Heading, Text} from '@workday/canvas-kit-react/text';
4
+ import {Text} from '@workday/canvas-kit-react/text';
5
5
  import {CanvasProvider} from '@workday/canvas-kit-react/common';
6
6
  import {createStyles, px2rem} from '@workday/canvas-kit-styling';
7
7
  import {system} from '@workday/canvas-tokens-web';
@@ -37,15 +37,9 @@ const RightPanel = () => {
37
37
 
38
38
  return (
39
39
  <SidePanel model={model} className={stylesOverride.panelContainer}>
40
- <SidePanel.ToggleButton />
40
+ <SidePanel.ToggleButton aria-label="Collapse View" />
41
41
  <Flex cs={stylesOverride.panel}>
42
- <Heading
43
- size="small"
44
- hidden={model.state.transitionState === 'collapsed' ? true : undefined}
45
- id={model.state.labelId}
46
- >
47
- Tasks Panel
48
- </Heading>
42
+ <SidePanel.Heading size="small">Tasks Panel</SidePanel.Heading>
49
43
  </Flex>
50
44
  </SidePanel>
51
45
  );
@@ -35,15 +35,9 @@ export default () => {
35
35
  <CanvasProvider dir={direction}>
36
36
  <Flex cs={stylesOverride.viewport}>
37
37
  <SidePanel model={model} variant="alternate">
38
- <SidePanel.ToggleButton />
38
+ <SidePanel.ToggleButton aria-label="Collapse View" />
39
39
  <Flex cs={stylesOverride.panel}>
40
- <Heading
41
- size="small"
42
- hidden={model.state.transitionState === 'collapsed' ? true : undefined}
43
- id={model.state.labelId}
44
- >
45
- Alternate Panel
46
- </Heading>
40
+ <SidePanel.Heading size="small">Alternate Panel</SidePanel.Heading>
47
41
  </Flex>
48
42
  </SidePanel>
49
43
  <Flex as="main" cs={stylesOverride.main}>
@@ -96,7 +96,7 @@ const ProfileCard = ({id, name, bio}: ProfileCardProps) => (
96
96
  <Avatar
97
97
  size="extraLarge"
98
98
  url={`https://avatars.githubusercontent.com/u/${id}?v=4`}
99
- altText={`${name}'s avatar`}
99
+ name={`${name}'s avatar`}
100
100
  className={profileCardAvatarStyles}
101
101
  />
102
102
  <h3 className={profileCardHeadingStyles}>{name}</h3>
@@ -30,11 +30,11 @@ yarn add @workday/canvas-kit-preview-react
30
30
  ### Basic Example
31
31
 
32
32
  `MultiSelect` supports a
33
- [dynamic API](/getting-started/for-developers/resources/collection-api/#dynamic-items) where you
33
+ [dynamic API](/get-started/for-developers/guides/collection-api/#dynamic-items) where you
34
34
  pass an array of items via the `items` prop and provide a render function to display the items. The
35
35
  items may be provided as an
36
- [array of strings](/getting-started/for-developers/resources/collection-api/#array-of-strings) or an
37
- [array of objects](/getting-started/for-developers/resources/collection-api/#array-of-objects).
36
+ [array of strings](/get-started/for-developers/guides/collection-api/#array-of-strings) or an
37
+ [array of objects](/get-started/for-developers/guides/collection-api/#array-of-objects).
38
38
 
39
39
  `MultiSelect` should be used in tandem with [Form Field](/components/inputs/form-field/) where the
40
40
  `MultiSelect` wraps the `FormField` element and the `FormField` element wraps the children of
@@ -51,7 +51,7 @@ We **strongly** discourage using text in a `StatusIndicator` which will cause it
51
51
  maximum width of `200px`. In situations where this cannot be avoided and text must be overflowed, we
52
52
  suggest wrapping `StatusIndicator` in an `OverflowTooltip` and applying `tabIndex={0}` to it so the
53
53
  overflowed text is accessible via keyboard and mouse. You may also override the default `maxWidth`
54
- of `StatusIndicator` via [style props](/getting-started/for-developers/resources/style-props/).
54
+ of `StatusIndicator` via [style props](/get-started/for-developers/documentation/style-props/).
55
55
 
56
56
  <ExampleCodeBlock code={Overflow} />
57
57
 
@@ -7,7 +7,7 @@ import OverflowActionBarCustomButtonCount from './examples/OverflowActionBarCust
7
7
 
8
8
  # Canvas Kit Action Bar
9
9
 
10
- Action Bar is a [compound component](/getting-started/for-developers/resources/compound-components/)
10
+ Action Bar is a [compound component](/get-started/for-developers/documentation/compound-components/)
11
11
  that contains primary and secondary actions related to a page or task.
12
12
 
13
13
  [> Workday Design Reference](https://design.workday.com/components/buttons/action-bar)
@@ -1,6 +1,6 @@
1
- import {SymbolDoc, Specifications, ExampleCodeBlock} from '@workday/canvas-kit-docs';
1
+ import {SymbolDoc, Specifications, ExampleCodeBlock, StorybookStatusIndicator} from '@workday/canvas-kit-docs';
2
2
 
3
- import {Avatar} from '@workday/canvas-kit-preview-react/avatar';
3
+ import {Avatar} from '@workday/canvas-kit-react/avatar';
4
4
  import Basic from './examples/Basic';
5
5
  import Image from './examples/Image';
6
6
  import Size from './examples/Size';
@@ -9,14 +9,12 @@ import Custom from './examples/Custom';
9
9
  import Decorative from './examples/Decorative';
10
10
 
11
11
 
12
- # Avatar
13
-
14
-
12
+ # Avatar <StorybookStatusIndicator type="promoted" />
15
13
 
16
14
  ## Installation
17
15
 
18
16
  ```sh
19
- yarn add @workday/canvas-kit-preview-react
17
+ yarn add @workday/canvas-kit-react
20
18
  ```
21
19
 
22
20
 
@@ -77,4 +75,4 @@ If the Avatar is purely decorative, you can set the `isDecorative` prop to `true
77
75
 
78
76
  ## Component API
79
77
 
80
- <SymbolDoc name="Avatar" fileName="/preview-react/" hideDescription />
78
+ <SymbolDoc name="Avatar" fileName="/react/" hideDescription />
@@ -0,0 +1,5 @@
1
+ import {Avatar} from '@workday/canvas-kit-react/avatar';
2
+
3
+ export default () => {
4
+ return <Avatar name="John Doe" />;
5
+ };
@@ -1,4 +1,4 @@
1
- import {BaseAvatar} from '@workday/canvas-kit-preview-react/avatar';
1
+ import {BaseAvatar} from '@workday/canvas-kit-react/avatar';
2
2
  import {createStyles, px2rem} from '@workday/canvas-kit-styling';
3
3
  import {base} from '@workday/canvas-tokens-web';
4
4
 
@@ -1,4 +1,4 @@
1
- import {Avatar} from '@workday/canvas-kit-preview-react/avatar';
1
+ import {Avatar} from '@workday/canvas-kit-react/avatar';
2
2
  // @ts-ignore
3
3
  import nicholasAvatar from './nicholas-avatar.jpg';
4
4
  import {createStyles} from '@workday/canvas-kit-styling';
@@ -1,4 +1,4 @@
1
- import {Avatar} from '@workday/canvas-kit-preview-react/avatar';
1
+ import {Avatar} from '@workday/canvas-kit-react/avatar';
2
2
 
3
3
  export default () => {
4
4
  return (
@@ -1,4 +1,4 @@
1
- import {Avatar} from '@workday/canvas-kit-preview-react/avatar';
1
+ import {Avatar} from '@workday/canvas-kit-react/avatar';
2
2
  import {createStyles} from '@workday/canvas-kit-styling';
3
3
  import {system} from '@workday/canvas-tokens-web';
4
4
 
@@ -1,4 +1,4 @@
1
- import {Avatar} from '@workday/canvas-kit-preview-react/avatar';
1
+ import {Avatar} from '@workday/canvas-kit-react/avatar';
2
2
  import {createStyles} from '@workday/canvas-kit-styling';
3
3
  import {system} from '@workday/canvas-tokens-web';
4
4
 
@@ -13,7 +13,7 @@ import StickyRTL from './examples/StickyRTL';
13
13
 
14
14
  # Canvas Kit Banner
15
15
 
16
- `Banner` is a [compound component](/getting-started/for-developers/resources/compound-components/)
16
+ `Banner` is a [compound component](/get-started/for-developers/documentation/compound-components/)
17
17
  used surface important information and feedback to the user about a task, action, or state.
18
18
 
19
19
  [> Workday Design Reference](https://design.workday.com/components/indicators/banners)
@@ -8,7 +8,7 @@ import LinkTruncation from './examples/LinkTruncation';
8
8
  # Canvas Kit Breadcrumbs
9
9
 
10
10
  Breadcrumbs is a
11
- [compound component](/getting-started/for-developers/resources/compound-components/) that allows
11
+ [compound component](/get-started/for-developers/documentation/compound-components/) that allows
12
12
  users to keep track and maintain awareness of their location as they navigate through pages,
13
13
  folders, files, etc.
14
14
 
@@ -9,7 +9,7 @@ import WithStencils from './examples/Stencils';
9
9
  # Canvas Kit Card
10
10
 
11
11
  A Card is a preview that serves as an entry point to more detailed information. Card is a
12
- presentational [compound component](/getting-started/for-developers/resources/compound-components/)
12
+ presentational [compound component](/get-started/for-developers/documentation/compound-components/)
13
13
  used as a building block for other components such as [Popup](/components/popups/popup/) and
14
14
  [Modal](/components/popups/modal/).
15
15
 
@@ -10,7 +10,7 @@ import CreateComponent from './examples/CreateComponent';
10
10
  # Compound Component Utilities
11
11
 
12
12
  The following utilities are used to create and compose
13
- [compound components](/getting-started/for-developers/resources/compound-components/).
13
+ [compound components](/get-started/for-developers/documentation/compound-components/).
14
14
 
15
15
  ## Installation
16
16
 
@@ -1,4 +1,4 @@
1
- import {ExampleCodeBlock} from '@workday/canvas-kit-docs';
1
+ import { ExampleCodeBlock } from '@workday/canvas-kit-docs';
2
2
  import Basic from './examples/Box/Basic';
3
3
 
4
4
  # Box
@@ -31,18 +31,18 @@ supports all `BoxProps` such as `padding`, it also supports semantic anchor elem
31
31
 
32
32
  ### Style Props
33
33
 
34
- `Box` exposes [style props](/getting-started/for-developers/resources/style-props/) that allow you
34
+ `Box` exposes [style props](/get-started/for-developers/documentation/style-props/) that allow you
35
35
  to modify styles in an ergonomic way across components. To learn more about individual sets of `Box`
36
36
  style props, consult the lists below.
37
37
 
38
- - [Background Style Props](/getting-started/for-developers/resources/style-props/#background)
39
- - [Border Style Props](/getting-started/for-developers/resources/style-props/#border)
40
- - [Color Style Props](/getting-started/for-developers/resources/style-props/#color)
41
- - [Depth Style Props](/getting-started/for-developers/resources/style-props/#depth)
42
- - [Flex Item Style Props](/getting-started/for-developers/resources/style-props/#flex-item)
43
- - [Grid Item Style Props](/getting-started/for-developers/resources/style-props/#grid-item)
44
- - [Layout Style Props](/getting-started/for-developers/resources/style-props/#layout)
45
- - [Other Style Props](/getting-started/for-developers/resources/style-props/#other)
46
- - [Position Style Props](/getting-started/for-developers/resources/style-props/#position)
47
- - [Space Style Props](/getting-started/for-developers/resources/style-props/#space)
48
- - [Text Style Props](/getting-started/for-developers/resources/style-props/#text)
38
+ - [Background Style Props](/get-started/for-developers/documentation/style-props/#background)
39
+ - [Border Style Props](/get-started/for-developers/documentation/style-props/#border)
40
+ - [Color Style Props](/get-started/for-developers/documentation/style-props/#color)
41
+ - [Depth Style Props](/get-started/for-developers/documentation/style-props/#depth)
42
+ - [Flex Item Style Props](/get-started/for-developers/documentation/style-props/#flex-item)
43
+ - [Grid Item Style Props](/get-started/for-developers/documentation/style-props/#grid-item)
44
+ - [Layout Style Props](/get-started/for-developers/documentation/style-props/#layout)
45
+ - [Other Style Props](/get-started/for-developers/documentation/style-props/#other)
46
+ - [Position Style Props](/get-started/for-developers/documentation/style-props/#position)
47
+ - [Space Style Props](/get-started/for-developers/documentation/style-props/#space)
48
+ - [Text Style Props](/get-started/for-developers/documentation/style-props/#text)
@@ -52,13 +52,13 @@ building layouts.
52
52
  #### Props
53
53
 
54
54
  `Flex` exposes
55
- [flex container style props](/getting-started/for-developers/resources/style-props/#flex) and `Box`
55
+ [flex container style props](/get-started/for-developers/documentation/style-props/#flex) and `Box`
56
56
  style props.
57
57
 
58
58
  ### Flex.Item
59
59
 
60
60
  `Flex.Item` is a subcomponent of `Flex`. It is a `Box` component under the hood and exposes
61
- [flex item style props](/getting-started/for-developers/resources/style-props/#flex-item) that map
61
+ [flex item style props](/get-started/for-developers/documentation/style-props/#flex-item) that map
62
62
  to CSS Flexbox Item properties. This provides greater control over how child components render in
63
63
  your layout.
64
64
 
@@ -73,5 +73,5 @@ your layout.
73
73
  #### Props
74
74
 
75
75
  `Flex.Item` exposes
76
- [flex item style props](/getting-started/for-developers/resources/style-props/#flex-item) and `Box`
76
+ [flex item style props](/get-started/for-developers/documentation/style-props/#flex-item) and `Box`
77
77
  style props.
@@ -9,7 +9,7 @@ import GridLayoutInteractive from './examples/Grid/GridLayoutInteractive';
9
9
  two-dimensional layouts (rows and columns) with
10
10
  [CSS Grid](https://developer.mozilla.org/en-US/docs/Learn/CSS/CSS_layout/Grids).
11
11
 
12
- Please refer to our [layout examples](/examples/layout/) for more examples of how to implement
12
+ Please refer to our [layout examples](/examples-layouts--docs) for more examples of how to implement
13
13
  different layouts using `Grid`.
14
14
 
15
15
  ## Installation
@@ -96,13 +96,13 @@ layouts.
96
96
  #### Props
97
97
 
98
98
  `Grid` exposes
99
- [grid container style props](/getting-started/for-developers/resources/style-props/#grid) and `Box`
99
+ [grid container style props](/get-started/for-developers/documentation/style-props/#grid) and `Box`
100
100
  style props.
101
101
 
102
102
  ### Grid.Item
103
103
 
104
104
  `Grid.Item` is a subcomponent of `Grid`. It is a `Box` component under the hood and exposes
105
- [grid item style props](/getting-started/for-developers/resources/style-props/#grid) that map to CSS
105
+ [grid item style props](/get-started/for-developers/documentation/style-props/#grid) that map to CSS
106
106
  Grid Item properties. This provides greater control over how child components render in your layout.
107
107
 
108
108
  ```tsx
@@ -10,7 +10,7 @@ import RTL from './examples/RTL';
10
10
  # Canvas Kit Pagination
11
11
 
12
12
  `Pagination` is a
13
- [compound component](/getting-started/for-developers/resources/compound-components/) that allows
13
+ [compound component](/get-started/for-developers/documentation/compound-components/) that allows
14
14
  users to navigate between pages in a range.
15
15
 
16
16
  [> Workday Design Reference](https://design.workday.com/components/navigation/pagination)
@@ -46,7 +46,7 @@ readers.
46
46
  By default, `Pagination` will create and use its own [model](#model) internally. Alternatively, you
47
47
  may configure your own model with `usePaginationModel` and pass it to `Pagination` via the `model`
48
48
  prop. This pattern is referred to as
49
- [hoisting the model](/getting-started/for-developers/resources/compound-components/#configuring-a-model)
49
+ [hoisting the model](/get-started/for-developers/documentation/compound-components/#configuring-a-model)
50
50
  and provides direct access to its `state` and `events` outside of the `Pagination` component.
51
51
 
52
52
  In this example, we set up external observation of the model state and create an external button to
@@ -94,7 +94,7 @@ You can use `useResizeObserver` to accomplish this as in the example below.
94
94
  ## Model
95
95
 
96
96
  If `Pagination` was stripped of all its markup, attributes, and styling, what would remain is the
97
- [model](/getting-started/for-developers/resources/compound-components/#models). The model is an
97
+ [model](/get-started/for-developers/documentation/compound-components/#models). The model is an
98
98
  object composed of two parts: `state` which describes the current snapshot in time of the component
99
99
  and `events` which describes events that can be sent to the model.
100
100
 
@@ -135,7 +135,7 @@ export const CustomPagination = () => {
135
135
  Alternatively, if you need direct access to the model's `state` and `events` outside of the
136
136
  `Pagination` component, you may configure your own model with `usePaginationModel` and pass it to
137
137
  `Pagination` via a pattern called
138
- [hoisting the model](/getting-started/for-developers/resources/compound-components/#configuring-a-model).
138
+ [hoisting the model](/get-started/for-developers/documentation/compound-components/#configuring-a-model).
139
139
 
140
140
  ```tsx
141
141
  const model = usePaginationModel({
@@ -44,7 +44,7 @@ yarn add @workday/canvas-kit-react
44
44
  ## Usage
45
45
 
46
46
  The `Popup` component is a generic
47
- [Compound Component](/getting-started/for-developers/resources/compound-components/) that is used to
47
+ [Compound Component](/get-started/for-developers/documentation/compound-components/) that is used to
48
48
  build popup UIs that are not already covered by Canvas Kit.
49
49
 
50
50
  ### Basic Example
@@ -41,11 +41,11 @@ yarn add @workday/canvas-kit-react
41
41
  ### Basic Example
42
42
 
43
43
  `Select` supports a
44
- [dynamic API](/getting-started/for-developers/resources/collection-api/#dynamic-items) where you
44
+ [dynamic API](/get-started/for-developers/guides/collection-api/#dynamic-items) where you
45
45
  pass an array of items via the `items` prop and provide a render function to display the items. The
46
46
  items may be provided as an
47
- [array of strings](/getting-started/for-developers/resources/collection-api/#array-of-strings) or an
48
- [array of objects](/getting-started/for-developers/resources/collection-api/#array-of-objects).
47
+ [array of strings](/get-started/for-developers/guides/collection-api/#array-of-strings) or an
48
+ [array of objects](/get-started/for-developers/guides/collection-api/#array-of-objects).
49
49
 
50
50
  `Select` should be used in tandem with [Form Field](/components/inputs/form-field/) where the
51
51
  `Select` wraps the `FormField` element and the `FormField` element wraps the children of `Select` to
@@ -75,7 +75,7 @@ value of the `Select`.
75
75
  By default, `Select` will create and use its own model internally. Alternatively, you may configure
76
76
  your own model with `useSelectModel` and pass it to `Select` via the `model` prop. This pattern is
77
77
  referred to as
78
- [hoisting the model](/getting-started/for-developers/resources/compound-components/#configuring-a-model)
78
+ [hoisting the model](/get-started/for-developers/documentation/compound-components/#configuring-a-model)
79
79
  and provides direct access to its `state` and `events` outside of the `Select` component.
80
80
 
81
81
  In this example, we set up external observation of the model state and create an external button to
@@ -12,7 +12,7 @@ import DynamicTabs from './examples/DynamicTabs';
12
12
 
13
13
  # Canvas Kit Tabs
14
14
 
15
- `Tabs` is a [compound component](/getting-started/for-developers/resources/compound-components/)
15
+ `Tabs` is a [compound component](/get-started/for-developers/documentation/compound-components/)
16
16
  that allows users to navigate between related views of content while remaining in context of the
17
17
  page.
18
18
 
@@ -57,7 +57,7 @@ should render.
57
57
  By default, `Tabs` will create and use its own [model](#model) internally. Alternatively, you may
58
58
  configure your own model with `useTabsModel` and pass it to `Tabs` via the `model` prop. This
59
59
  pattern is referred to as
60
- [hoisting the model](/getting-started/for-developers/resources/compound-components/#configuring-a-model)
60
+ [hoisting the model](/get-started/for-developers/documentation/compound-components/#configuring-a-model)
61
61
  and provides direct access to its `state` and `events` outside of the `Tabs` component.
62
62
 
63
63
  In this example, we set up external observation of the model state and create an external button to
@@ -19,7 +19,7 @@ yarn add @workday/canvas-kit-react
19
19
  ### Basic Example
20
20
 
21
21
  `Text` is built on top of [`Box`](/components/layout/box/) and supports a multitude of
22
- [style props](/getting-started/for-developers/resources/style-props/) including spacing props such
22
+ [style props](/get-started/for-developers/documentation/style-props/) including spacing props such
23
23
  as `margin` and `padding`, as well as text styling props such as `fontSize` and `fontWeight`.
24
24
 
25
25
  `Text` renders a `<span>` element by default. You may override the rendered element using the `as`
@@ -9,7 +9,7 @@ import RTL from './examples/RTL';
9
9
 
10
10
  # Canvas Kit Toast
11
11
 
12
- `Toast` is a [compound component](/getting-started/for-developers/resources/compound-components/)
12
+ `Toast` is a [compound component](/get-started/for-developers/documentation/compound-components/)
13
13
  that contains updates or messages about the status of an application's process.
14
14
 
15
15
  ## Installation
@@ -28,14 +28,23 @@ const content = {
28
28
  icon: undefined,
29
29
  label: 'New',
30
30
  },
31
+ promoted: {
32
+ icon: undefined,
33
+ label: 'Promoted',
34
+ },
31
35
  };
32
36
 
33
- export const StorybookStatusIndicator = ({type}: {type: 'ai' | 'deprecated' | 'new'}) => {
37
+ export const StorybookStatusIndicator = ({
38
+ type,
39
+ }: {
40
+ type: 'ai' | 'deprecated' | 'new' | 'promoted';
41
+ }) => {
34
42
  const {icon, label} = content[type];
35
43
  const variantMapping = {
36
44
  ai: 'ai',
37
45
  deprecated: 'caution',
38
46
  new: 'positive',
47
+ promoted: 'info',
39
48
  };
40
49
  console.log(variantMapping[type]);
41
50
  return (