@coinbase/cds-mcp-server 8.43.0 → 8.44.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 (106) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/dts/analytics.d.ts +6 -9
  3. package/dts/index.d.ts +1 -1
  4. package/dts/server.d.ts +1 -1
  5. package/dts/setup.d.ts +1 -1
  6. package/mcp-docs/mobile/components/Alert.txt +1 -0
  7. package/mcp-docs/mobile/components/AvatarButton.txt +2 -0
  8. package/mcp-docs/mobile/components/Button.txt +2 -0
  9. package/mcp-docs/mobile/components/Carousel.txt +12 -0
  10. package/mcp-docs/mobile/components/CheckboxCell.txt +13 -0
  11. package/mcp-docs/mobile/components/Chip.txt +10 -0
  12. package/mcp-docs/mobile/components/Collapsible.txt +7 -0
  13. package/mcp-docs/mobile/components/Combobox.txt +26 -0
  14. package/mcp-docs/mobile/components/ContentCell.txt +17 -0
  15. package/mcp-docs/mobile/components/DataCard.txt +13 -0
  16. package/mcp-docs/mobile/components/DotCount.txt +9 -0
  17. package/mcp-docs/mobile/components/Icon.txt +15 -0
  18. package/mcp-docs/mobile/components/IconButton.txt +2 -0
  19. package/mcp-docs/mobile/components/InputChip.txt +2 -0
  20. package/mcp-docs/mobile/components/ListCell.txt +23 -0
  21. package/mcp-docs/mobile/components/MediaCard.txt +14 -0
  22. package/mcp-docs/mobile/components/MediaChip.txt +2 -0
  23. package/mcp-docs/mobile/components/MessagingCard.txt +14 -0
  24. package/mcp-docs/mobile/components/Modal.txt +1 -0
  25. package/mcp-docs/mobile/components/NudgeCard.txt +5 -0
  26. package/mcp-docs/mobile/components/PageFooter.txt +6 -0
  27. package/mcp-docs/mobile/components/PageHeader.txt +16 -0
  28. package/mcp-docs/mobile/components/Pressable.txt +2 -0
  29. package/mcp-docs/mobile/components/ProgressBar.txt +8 -0
  30. package/mcp-docs/mobile/components/ProgressBarWithFixedLabels.txt +10 -0
  31. package/mcp-docs/mobile/components/ProgressBarWithFloatLabel.txt +9 -0
  32. package/mcp-docs/mobile/components/ProgressCircle.txt +12 -0
  33. package/mcp-docs/mobile/components/RadioCell.txt +13 -0
  34. package/mcp-docs/mobile/components/RollingNumber.txt +16 -0
  35. package/mcp-docs/mobile/components/SectionHeader.txt +7 -0
  36. package/mcp-docs/mobile/components/SelectAlpha.txt +26 -0
  37. package/mcp-docs/mobile/components/SelectChip.txt +9 -5
  38. package/mcp-docs/mobile/components/SelectChipAlpha.txt +26 -0
  39. package/mcp-docs/mobile/components/SlideButton.txt +11 -0
  40. package/mcp-docs/mobile/components/Spacer.txt +3 -0
  41. package/mcp-docs/mobile/components/Stepper.txt +13 -0
  42. package/mcp-docs/mobile/components/TabbedChipsAlpha.txt +8 -0
  43. package/mcp-docs/mobile/components/Tray.txt +717 -133
  44. package/mcp-docs/mobile/components/UpsellCard.txt +1 -0
  45. package/mcp-docs/mobile/getting-started/styling.txt +6 -2
  46. package/mcp-docs/mobile/routes.txt +1 -1
  47. package/mcp-docs/web/components/Alert.txt +1 -0
  48. package/mcp-docs/web/components/AvatarButton.txt +12 -10
  49. package/mcp-docs/web/components/Box.txt +9 -9
  50. package/mcp-docs/web/components/Button.txt +12 -10
  51. package/mcp-docs/web/components/Carousel.txt +12 -0
  52. package/mcp-docs/web/components/CheckboxCell.txt +13 -0
  53. package/mcp-docs/web/components/Chip.txt +10 -0
  54. package/mcp-docs/web/components/Collapsible.txt +7 -0
  55. package/mcp-docs/web/components/Combobox.txt +26 -0
  56. package/mcp-docs/web/components/ContentCard.txt +9 -9
  57. package/mcp-docs/web/components/ContentCardBody.txt +9 -9
  58. package/mcp-docs/web/components/ContentCardFooter.txt +9 -9
  59. package/mcp-docs/web/components/ContentCardHeader.txt +9 -9
  60. package/mcp-docs/web/components/ContentCell.txt +27 -9
  61. package/mcp-docs/web/components/DataCard.txt +13 -0
  62. package/mcp-docs/web/components/DotCount.txt +9 -0
  63. package/mcp-docs/web/components/Fallback.txt +9 -9
  64. package/mcp-docs/web/components/FullscreenModal.txt +1 -0
  65. package/mcp-docs/web/components/FullscreenModalLayout.txt +1 -0
  66. package/mcp-docs/web/components/Grid.txt +9 -9
  67. package/mcp-docs/web/components/GridColumn.txt +9 -9
  68. package/mcp-docs/web/components/HStack.txt +9 -9
  69. package/mcp-docs/web/components/Icon.txt +8 -0
  70. package/mcp-docs/web/components/IconButton.txt +12 -10
  71. package/mcp-docs/web/components/InputChip.txt +2 -0
  72. package/mcp-docs/web/components/Interactable.txt +10 -10
  73. package/mcp-docs/web/components/Link.txt +11 -9
  74. package/mcp-docs/web/components/ListCell.txt +29 -9
  75. package/mcp-docs/web/components/MediaCard.txt +14 -0
  76. package/mcp-docs/web/components/MediaChip.txt +2 -0
  77. package/mcp-docs/web/components/MessagingCard.txt +14 -0
  78. package/mcp-docs/web/components/Modal.txt +1 -0
  79. package/mcp-docs/web/components/MultiContentModule.txt +9 -9
  80. package/mcp-docs/web/components/NavigationBar.txt +271 -45
  81. package/mcp-docs/web/components/PageFooter.txt +6 -0
  82. package/mcp-docs/web/components/PageHeader.txt +16 -0
  83. package/mcp-docs/web/components/Pressable.txt +12 -10
  84. package/mcp-docs/web/components/ProgressBar.txt +8 -0
  85. package/mcp-docs/web/components/ProgressBarWithFixedLabels.txt +10 -0
  86. package/mcp-docs/web/components/ProgressBarWithFloatLabel.txt +9 -0
  87. package/mcp-docs/web/components/ProgressCircle.txt +10 -0
  88. package/mcp-docs/web/components/RadioCell.txt +13 -0
  89. package/mcp-docs/web/components/RollingNumber.txt +25 -9
  90. package/mcp-docs/web/components/Scrubber.txt +10 -0
  91. package/mcp-docs/web/components/SelectAlpha.txt +26 -0
  92. package/mcp-docs/web/components/SelectChip.txt +2 -0
  93. package/mcp-docs/web/components/SelectChipAlpha.txt +26 -0
  94. package/mcp-docs/web/components/Sidebar.txt +10 -0
  95. package/mcp-docs/web/components/SidebarItem.txt +2 -0
  96. package/mcp-docs/web/components/Spacer.txt +9 -9
  97. package/mcp-docs/web/components/Stepper.txt +13 -0
  98. package/mcp-docs/web/components/TabbedChipsAlpha.txt +10 -0
  99. package/mcp-docs/web/components/Text.txt +9 -9
  100. package/mcp-docs/web/components/TileButton.txt +12 -10
  101. package/mcp-docs/web/components/Tray.txt +1032 -155
  102. package/mcp-docs/web/components/UpsellCard.txt +1 -0
  103. package/mcp-docs/web/components/VStack.txt +9 -9
  104. package/mcp-docs/web/getting-started/styling.txt +35 -12
  105. package/mcp-docs/web/routes.txt +1 -1
  106. package/package.json +1 -1
@@ -10,47 +10,116 @@ import { NavigationBar } from '@coinbase/cds-web/navigation/NavigationBar'
10
10
 
11
11
  ## Examples
12
12
 
13
- ### Web: Logged in Navigation Bar
13
+ NavigationBar is a horizontal navigation component that provides a consistent header for application navigation and wayfinding. It supports flexible content areas, theming, and custom styling.
14
+
15
+ ### Basics
16
+
17
+ ```jsx live
18
+ <NavigationBar
19
+ start={<IconButton name="backArrow" accessibilityLabel="Back" />}
20
+ end={
21
+ <HStack gap={1} alignItems="center">
22
+ <IconButton name="bell" accessibilityLabel="Notifications" />
23
+ <Avatar size="xl" />
24
+ </HStack>
25
+ }
26
+ >
27
+ <NavigationTitle>Dashboard</NavigationTitle>
28
+ </NavigationBar>
29
+ ```
30
+
31
+ #### With Tab Navigation
32
+
33
+ Use the `bottom` prop to add tab navigation below the main content.
34
+
35
+ ```jsx live
36
+ function NavigationWithTabs() {
37
+ const tabs = [
38
+ { id: 'all', label: 'All' },
39
+ { id: 'watchlist', label: 'Watchlist' },
40
+ { id: 'tradable', label: 'Tradable' },
41
+ { id: 'gainers', label: 'Gainers' },
42
+ ];
43
+ const [value, setValue] = useState(tabs[0].id);
44
+
45
+ return (
46
+ <NavigationBar
47
+ end={
48
+ <HStack gap={1} alignItems="center">
49
+ <IconButton name="bell" accessibilityLabel="Notifications" />
50
+ <Avatar size="xl" />
51
+ </HStack>
52
+ }
53
+ bottom={<TabNavigation tabs={tabs} value={value} onChange={setValue} />}
54
+ >
55
+ <NavigationTitle>Portfolio</NavigationTitle>
56
+ </NavigationBar>
57
+ );
58
+ }
59
+ ```
60
+
61
+ #### With Search
62
+
63
+ ```jsx live
64
+ function NavigationWithSearch() {
65
+ const [search, setSearch] = useState('');
66
+
67
+ return (
68
+ <NavigationBar
69
+ start={<IconButton name="backArrow" accessibilityLabel="Back" />}
70
+ end={<IconButton name="settings" accessibilityLabel="Settings" />}
71
+ >
72
+ <SearchInput
73
+ compact
74
+ accessibilityLabel="Search"
75
+ onChangeText={setSearch}
76
+ placeholder="Search assets..."
77
+ value={search}
78
+ />
79
+ </NavigationBar>
80
+ );
81
+ }
82
+ ```
83
+
84
+ ### Accessibility
85
+
86
+ Use `accessibilityLabel` to provide context for screen readers. The default label is "main navigation".
14
87
 
15
88
  ```jsx live
16
- function NavigationWithPress() {
89
+ <NavigationBar
90
+ accessibilityLabel="Primary site navigation"
91
+ start={<IconButton name="backArrow" accessibilityLabel="Go back to previous page" />}
92
+ end={<IconButton name="bell" accessibilityLabel="View notifications, 3 unread" />}
93
+ >
94
+ <NavigationTitle>Account Settings</NavigationTitle>
95
+ </NavigationBar>
96
+ ```
97
+
98
+ When using interactive elements in the navigation bar, ensure each has appropriate accessibility labels describing their action.
99
+
100
+ ### Composed Examples
101
+
102
+ #### Full Navigation with Back Button
103
+
104
+ A complete navigation example with dynamic back button visibility and tab navigation.
105
+
106
+ ```jsx live
107
+ function FullNavigation() {
17
108
  const tabs = [
18
- {
19
- id: 'all',
20
- label: 'All',
21
- },
22
- {
23
- id: 'watchlist',
24
- label: 'Watchlist',
25
- },
26
- {
27
- id: 'tradable',
28
- label: 'Tradable',
29
- },
30
- {
31
- id: 'gainers',
32
- label: 'Gainers',
33
- count: 2,
34
- },
35
- {
36
- id: 'losers',
37
- label: 'Losers',
38
- },
39
- {
40
- id: 'trending',
41
- label: 'Trending',
42
- },
43
- {
44
- id: 'other',
45
- label: 'Other',
46
- },
109
+ { id: 'all', label: 'All' },
110
+ { id: 'watchlist', label: 'Watchlist' },
111
+ { id: 'tradable', label: 'Tradable' },
112
+ { id: 'gainers', label: 'Gainers' },
113
+ { id: 'losers', label: 'Losers' },
47
114
  ];
48
115
  const [search, setSearch] = useState('');
49
116
  const [value, setValue] = useState(tabs[1].id);
50
117
  const showBackButton = useMemo(() => value !== tabs[0].id, [value]);
118
+
51
119
  const handleBackPress = useCallback(() => {
52
120
  setValue(tabs[0].id);
53
121
  }, []);
122
+
54
123
  return (
55
124
  <NavigationBar
56
125
  start={
@@ -60,23 +129,80 @@ function NavigationWithPress() {
60
129
  }
61
130
  end={
62
131
  <HStack gap={1} alignItems="center">
63
- <IconButton accessibilityLabel="Language" active={false} name="globe" />
132
+ <IconButton accessibilityLabel="Language" name="globe" />
64
133
  <IconButton accessibilityLabel="Notifications" active name="bell" />
65
134
  </HStack>
66
135
  }
67
136
  bottom={<TabNavigation tabs={tabs} value={value} onChange={setValue} />}
68
137
  >
69
- <HStack alignItems="center" flexGrow={1} gap={1}>
70
- <VStack width="100%">
138
+ <SearchInput
139
+ compact
140
+ accessibilityLabel="Search"
141
+ onChangeText={setSearch}
142
+ placeholder="Search"
143
+ value={search}
144
+ />
145
+ </NavigationBar>
146
+ );
147
+ }
148
+ ```
149
+
150
+ #### Responsive Navigation
151
+
152
+ A responsive navigation bar that adapts to screen size. On mobile, the search input collapses to an icon button.
153
+
154
+ ```jsx live
155
+ function ResponsiveNavigation() {
156
+ const [search, setSearch] = useState('');
157
+ const [searchOpen, setSearchOpen] = useState(false);
158
+ const { isMobile } = useBreakpoints();
159
+
160
+ const handleSearchToggle = useCallback(() => {
161
+ setSearchOpen((prev) => !prev);
162
+ if (searchOpen) {
163
+ setSearch('');
164
+ }
165
+ }, [searchOpen]);
166
+
167
+ return (
168
+ <NavigationBar
169
+ background="bgSecondary"
170
+ start={<IconButton name="backArrow" accessibilityLabel="Back" />}
171
+ end={
172
+ <HStack gap={1} alignItems="center">
173
+ {isMobile && (
174
+ <IconButton
175
+ name="search"
176
+ accessibilityLabel="Search"
177
+ onClick={handleSearchToggle}
178
+ active={searchOpen}
179
+ />
180
+ )}
181
+ <IconButton name="bell" accessibilityLabel="Notifications" />
182
+ <Avatar size="xl" />
183
+ </HStack>
184
+ }
185
+ >
186
+ {isMobile ? (
187
+ searchOpen && (
71
188
  <SearchInput
72
189
  compact
73
190
  accessibilityLabel="Search"
74
191
  onChangeText={setSearch}
75
- placeholder="Search"
192
+ placeholder="Search..."
76
193
  value={search}
77
194
  />
78
- </VStack>
79
- </HStack>
195
+ )
196
+ ) : (
197
+ <SearchInput
198
+ compact
199
+ accessibilityLabel="Search"
200
+ onChangeText={setSearch}
201
+ placeholder="Search assets..."
202
+ value={search}
203
+ />
204
+ )}
205
+ {!isMobile && !searchOpen && <NavigationTitle>Trading</NavigationTitle>}
80
206
  </NavigationBar>
81
207
  );
82
208
  }
@@ -86,17 +212,117 @@ function NavigationWithPress() {
86
212
 
87
213
  | Prop | Type | Required | Default | Description |
88
214
  | --- | --- | --- | --- | --- |
89
- | `children` | `null \| string \| number \| false \| true \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal` | Yes | `-` | The middle content. Use the children to render the page title |
90
- | `accessibilityLabel` | `string` | No | `-` | Accessibility label for the nav bar |
91
- | `bottom` | `null \| string \| number \| false \| true \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal` | No | `-` | The bottom content. Use to render tabs |
92
- | `columnGap` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `2` | Space between the start, children, and end of the nav bar |
215
+ | `alignContent` | `ResponsiveProp<center \| normal \| start \| end \| flex-start \| flex-end \| stretch \| baseline \| first baseline \| last baseline \| space-between \| space-around \| space-evenly>` | No | `-` | - |
216
+ | `alignItems` | `ResponsiveProp<center \| normal \| start \| end \| flex-start \| flex-end \| self-start \| self-end \| stretch \| baseline \| first baseline \| last baseline>` | No | `-` | - |
217
+ | `alignSelf` | `ResponsiveProp<center \| normal \| auto \| start \| end \| flex-start \| flex-end \| self-start \| self-end \| stretch \| baseline \| first baseline \| last baseline>` | No | `-` | - |
218
+ | `as` | `nav` | No | `-` | The underlying element or component the polymorphic component will render. Changing as also changes the inherited native props (e.g. href for as=a) and the expected ref type. |
219
+ | `aspectRatio` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
220
+ | `background` | `currentColor \| fg \| fgMuted \| fgInverse \| fgPrimary \| fgWarning \| fgPositive \| fgNegative \| bg \| bgAlternate \| bgInverse \| bgOverlay \| bgElevation1 \| bgElevation2 \| bgPrimary \| bgPrimaryWash \| bgSecondary \| bgTertiary \| bgSecondaryWash \| bgNegative \| bgNegativeWash \| bgPositive \| bgPositiveWash \| bgWarning \| bgWarningWash \| bgLine \| bgLineHeavy \| bgLineInverse \| bgLinePrimary \| bgLinePrimarySubtle \| accentSubtleRed \| accentBoldRed \| accentSubtleGreen \| accentBoldGreen \| accentSubtleBlue \| accentBoldBlue \| accentSubtlePurple \| accentBoldPurple \| accentSubtleYellow \| accentBoldYellow \| accentSubtleGray \| accentBoldGray \| transparent` | No | `-` | - |
221
+ | `borderBottomLeftRadius` | `0 \| 100 \| 200 \| 300 \| 400 \| 500 \| 600 \| 700 \| 800 \| 900 \| 1000` | No | `-` | - |
222
+ | `borderBottomRightRadius` | `0 \| 100 \| 200 \| 300 \| 400 \| 500 \| 600 \| 700 \| 800 \| 900 \| 1000` | No | `-` | - |
223
+ | `borderBottomWidth` | `0 \| 100 \| 200 \| 300 \| 400 \| 500` | No | `-` | - |
224
+ | `borderColor` | `currentColor \| fg \| fgMuted \| fgInverse \| fgPrimary \| fgWarning \| fgPositive \| fgNegative \| bg \| bgAlternate \| bgInverse \| bgOverlay \| bgElevation1 \| bgElevation2 \| bgPrimary \| bgPrimaryWash \| bgSecondary \| bgTertiary \| bgSecondaryWash \| bgNegative \| bgNegativeWash \| bgPositive \| bgPositiveWash \| bgWarning \| bgWarningWash \| bgLine \| bgLineHeavy \| bgLineInverse \| bgLinePrimary \| bgLinePrimarySubtle \| accentSubtleRed \| accentBoldRed \| accentSubtleGreen \| accentBoldGreen \| accentSubtleBlue \| accentBoldBlue \| accentSubtlePurple \| accentBoldPurple \| accentSubtleYellow \| accentBoldYellow \| accentSubtleGray \| accentBoldGray \| transparent` | No | `-` | - |
225
+ | `borderEndWidth` | `0 \| 100 \| 200 \| 300 \| 400 \| 500` | No | `-` | - |
226
+ | `borderRadius` | `0 \| 100 \| 200 \| 300 \| 400 \| 500 \| 600 \| 700 \| 800 \| 900 \| 1000` | No | `-` | - |
227
+ | `borderStartWidth` | `0 \| 100 \| 200 \| 300 \| 400 \| 500` | No | `-` | - |
228
+ | `borderTopLeftRadius` | `0 \| 100 \| 200 \| 300 \| 400 \| 500 \| 600 \| 700 \| 800 \| 900 \| 1000` | No | `-` | - |
229
+ | `borderTopRightRadius` | `0 \| 100 \| 200 \| 300 \| 400 \| 500 \| 600 \| 700 \| 800 \| 900 \| 1000` | No | `-` | - |
230
+ | `borderTopWidth` | `0 \| 100 \| 200 \| 300 \| 400 \| 500` | No | `-` | - |
231
+ | `borderWidth` | `0 \| 100 \| 200 \| 300 \| 400 \| 500` | No | `-` | - |
232
+ | `bordered` | `boolean` | No | `-` | Add a border around all sides of the box. |
233
+ | `borderedBottom` | `boolean` | No | `-` | Add a border to the bottom side of the box. |
234
+ | `borderedEnd` | `boolean` | No | `-` | Add a border to the trailing side of the box. |
235
+ | `borderedHorizontal` | `boolean` | No | `-` | Add a border to the leading and trailing sides of the box. |
236
+ | `borderedStart` | `boolean` | No | `-` | Add a border to the leading side of the box. |
237
+ | `borderedTop` | `boolean` | No | `-` | Add a border to the top side of the box. |
238
+ | `borderedVertical` | `boolean` | No | `-` | Add a border to the top and bottom sides of the box. |
239
+ | `bottom` | `((Bottom<string \| number> \| { base?: Bottom<string \| number>; phone?: Bottom<string \| number> \| undefined; tablet?: Bottom<string \| number> \| undefined; desktop?: Bottom<string \| number> \| undefined; }) & (string \| number \| boolean \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal \| null)) \| undefined` | No | `-` | The bottom content. Use to render tabs |
240
+ | `children` | `null \| string \| number \| false \| true \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal` | No | `-` | The middle content. Use the children to render the page title |
241
+ | `classNames` | `{ readonly root?: string; readonly start?: string \| undefined; readonly content?: string \| undefined; } \| undefined` | No | `-` | - |
242
+ | `color` | `currentColor \| fg \| fgMuted \| fgInverse \| fgPrimary \| fgWarning \| fgPositive \| fgNegative \| bg \| bgAlternate \| bgInverse \| bgOverlay \| bgElevation1 \| bgElevation2 \| bgPrimary \| bgPrimaryWash \| bgSecondary \| bgTertiary \| bgSecondaryWash \| bgNegative \| bgNegativeWash \| bgPositive \| bgPositiveWash \| bgWarning \| bgWarningWash \| bgLine \| bgLineHeavy \| bgLineInverse \| bgLinePrimary \| bgLinePrimarySubtle \| accentSubtleRed \| accentBoldRed \| accentSubtleGreen \| accentBoldGreen \| accentSubtleBlue \| accentBoldBlue \| accentSubtlePurple \| accentBoldPurple \| accentSubtleYellow \| accentBoldYellow \| accentSubtleGray \| accentBoldGray \| transparent` | No | `-` | - |
243
+ | `columnGap` | `((Space \| { base?: Space; phone?: Space \| undefined; tablet?: Space \| undefined; desktop?: Space \| undefined; }) & ResponsiveProp<Space>) \| undefined` | No | `2` | Space between the start, children, and end of the nav bar |
93
244
  | `dangerouslyDisableOverflowHidden` | `boolean` | No | `-` | Disable the overflow: hidden style from being injected to the child Col |
245
+ | `dangerouslySetBackground` | `string` | No | `-` | - |
246
+ | `display` | `ResponsiveProp<grid \| revert \| none \| block \| inline \| inline-block \| flex \| inline-flex \| inline-grid \| contents \| flow-root \| list-item>` | No | `-` | - |
247
+ | `elevation` | `0 \| 1 \| 2` | No | `-` | - |
94
248
  | `end` | `null \| string \| number \| false \| true \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal` | No | `-` | Node (icons, avatar, etc) to display at the end of the nav bar |
95
- | `paddingBottom` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `2` | - |
96
- | `paddingTop` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `2` | - |
97
- | `paddingX` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `2` | - |
98
- | `rowGap` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `2` | Space between bottom of the nav bar and the rest of its content |
249
+ | `flexBasis` | `ResponsiveProp<FlexBasis<string \| number>>` | No | `-` | - |
250
+ | `flexDirection` | `ResponsiveProp<column \| row \| row-reverse \| column-reverse>` | No | `-` | - |
251
+ | `flexGrow` | `inherit \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
252
+ | `flexShrink` | `inherit \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
253
+ | `flexWrap` | `ResponsiveProp<nowrap \| wrap \| wrap-reverse>` | No | `-` | - |
254
+ | `font` | `ResponsiveProp<FontFamily \| inherit>` | No | `-` | - |
255
+ | `fontFamily` | `ResponsiveProp<FontFamily \| inherit>` | No | `-` | - |
256
+ | `fontSize` | `ResponsiveProp<FontSize \| inherit>` | No | `-` | - |
257
+ | `fontWeight` | `ResponsiveProp<FontWeight \| inherit>` | No | `-` | - |
258
+ | `gap` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
259
+ | `grid` | `inherit \| none \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
260
+ | `gridArea` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
261
+ | `gridAutoColumns` | `ResponsiveProp<GridAutoColumns<string \| number>>` | No | `-` | - |
262
+ | `gridAutoFlow` | `inherit \| revert \| row \| column \| -moz-initial \| initial \| revert-layer \| unset \| dense` | No | `-` | - |
263
+ | `gridAutoRows` | `ResponsiveProp<GridAutoRows<string \| number>>` | No | `-` | - |
264
+ | `gridColumn` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
265
+ | `gridColumnEnd` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
266
+ | `gridColumnStart` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
267
+ | `gridRow` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
268
+ | `gridRowEnd` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
269
+ | `gridRowStart` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
270
+ | `gridTemplate` | `inherit \| none \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
271
+ | `gridTemplateAreas` | `inherit \| none \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
272
+ | `gridTemplateColumns` | `ResponsiveProp<GridTemplateColumns<string \| number>>` | No | `-` | - |
273
+ | `gridTemplateRows` | `ResponsiveProp<GridTemplateRows<string \| number>>` | No | `-` | - |
274
+ | `height` | `ResponsiveProp<Height<string \| number>>` | No | `-` | - |
275
+ | `justifyContent` | `ResponsiveProp<left \| right \| center \| normal \| start \| end \| flex-start \| flex-end \| stretch \| space-between \| space-around \| space-evenly>` | No | `-` | - |
276
+ | `key` | `Key \| null` | No | `-` | - |
277
+ | `left` | `ResponsiveProp<Left<string \| number>>` | No | `-` | - |
278
+ | `lineHeight` | `ResponsiveProp<LineHeight \| inherit>` | No | `-` | - |
279
+ | `margin` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
280
+ | `marginBottom` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
281
+ | `marginEnd` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
282
+ | `marginStart` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
283
+ | `marginTop` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
284
+ | `marginX` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
285
+ | `marginY` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
286
+ | `maxHeight` | `ResponsiveProp<MaxHeight<string \| number>>` | No | `-` | - |
287
+ | `maxWidth` | `ResponsiveProp<MaxWidth<string \| number>>` | No | `-` | - |
288
+ | `minHeight` | `ResponsiveProp<MinHeight<string \| number>>` | No | `-` | - |
289
+ | `minWidth` | `ResponsiveProp<MinWidth<string \| number>>` | No | `-` | - |
290
+ | `onChange` | `FormEventHandler<HTMLDivElement>` | No | `-` | - |
291
+ | `opacity` | `inherit \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
292
+ | `overflow` | `ResponsiveProp<hidden \| auto \| visible \| clip \| scroll>` | No | `-` | - |
293
+ | `padding` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
294
+ | `paddingBottom` | `((Space \| { base?: Space; phone?: Space \| undefined; tablet?: Space \| undefined; desktop?: Space \| undefined; }) & Space) \| undefined` | No | `2 if bottom is not provided` | - |
295
+ | `paddingEnd` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
296
+ | `paddingStart` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
297
+ | `paddingTop` | `((Space \| { base?: Space; phone?: Space \| undefined; tablet?: Space \| undefined; desktop?: Space \| undefined; }) & Space) \| undefined` | No | `2` | - |
298
+ | `paddingX` | `((Space \| { base?: Space; phone?: Space \| undefined; tablet?: Space \| undefined; desktop?: Space \| undefined; }) & Space) \| undefined` | No | `2` | - |
299
+ | `paddingY` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
300
+ | `pin` | `top \| bottom \| left \| right \| all` | No | `-` | Direction in which to absolutely pin the box. |
301
+ | `position` | `ResponsiveProp<fixed \| static \| relative \| absolute \| sticky>` | No | `-` | - |
302
+ | `ref` | `((instance: HTMLElement \| null) => void) \| RefObject<HTMLElement> \| null` | No | `-` | - |
303
+ | `right` | `ResponsiveProp<Right<string \| number>>` | No | `-` | - |
304
+ | `rowGap` | `((Space \| { base?: Space; phone?: Space \| undefined; tablet?: Space \| undefined; desktop?: Space \| undefined; }) & ResponsiveProp<Space>) \| undefined` | No | `2` | Space between bottom of the nav bar and the rest of its content |
99
305
  | `start` | `null \| string \| number \| false \| true \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal` | No | `-` | Node (ie Back button) to display at the start of the nav bar |
306
+ | `style` | `CSSProperties` | No | `-` | - |
307
+ | `styles` | `{ readonly root?: CSSProperties; readonly start?: CSSProperties \| undefined; readonly content?: CSSProperties \| undefined; } \| undefined` | No | `-` | - |
100
308
  | `testID` | `string` | No | `-` | Used to locate this element in unit and end-to-end tests. Under the hood, testID translates to data-testid on Web. On Mobile, testID stays the same - testID |
309
+ | `textAlign` | `ResponsiveProp<center \| start \| end \| justify>` | No | `-` | - |
310
+ | `textDecoration` | `ResponsiveProp<none \| underline \| overline \| line-through \| underline overline \| underline double>` | No | `-` | - |
311
+ | `textTransform` | `ResponsiveProp<capitalize \| lowercase \| none \| uppercase>` | No | `-` | - |
312
+ | `top` | `ResponsiveProp<Top<string \| number>>` | No | `-` | - |
313
+ | `transform` | `inherit \| none \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
314
+ | `userSelect` | `ResponsiveProp<text \| none \| auto \| all>` | No | `-` | - |
315
+ | `visibility` | `ResponsiveProp<hidden \| visible>` | No | `-` | - |
316
+ | `width` | `ResponsiveProp<Width<string \| number>>` | No | `-` | - |
317
+ | `zIndex` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
318
+
319
+
320
+ ## Styles
321
+
322
+ | Selector | Static class name | Description |
323
+ | --- | --- | --- |
324
+ | `root` | `cds-NavigationBar` | Root nav element containing the entire navigation bar |
325
+ | `start` | `cds-NavigationBar-start` | Container for the start slot (e.g., back button) |
326
+ | `content` | `cds-NavigationBar-content` | Container for the main children content (e.g., title) |
101
327
 
102
328
 
@@ -113,6 +113,7 @@ function CustomLayoutFooter() {
113
113
  | `borderedStart` | `boolean` | No | `-` | Add a border to the leading side of the box. |
114
114
  | `borderedTop` | `boolean` | No | `-` | Add a border to the top side of the box. |
115
115
  | `borderedVertical` | `boolean` | No | `-` | Add a border to the top and bottom sides of the box. |
116
+ | `bottom` | `string \| number` | No | `-` | Position the box to the bottom edge. |
116
117
  | `color` | `currentColor \| fg \| fgMuted \| fgInverse \| fgPrimary \| fgWarning \| fgPositive \| fgNegative \| bg \| bgAlternate \| bgInverse \| bgOverlay \| bgElevation1 \| bgElevation2 \| bgPrimary \| bgPrimaryWash \| bgSecondary \| bgTertiary \| bgSecondaryWash \| bgNegative \| bgNegativeWash \| bgPositive \| bgPositiveWash \| bgWarning \| bgWarningWash \| bgLine \| bgLineHeavy \| bgLineInverse \| bgLinePrimary \| bgLinePrimarySubtle \| accentSubtleRed \| accentBoldRed \| accentSubtleGreen \| accentBoldGreen \| accentSubtleBlue \| accentBoldBlue \| accentSubtlePurple \| accentBoldPurple \| accentSubtleYellow \| accentBoldYellow \| accentSubtleGray \| accentBoldGray \| transparent` | No | `-` | - |
117
118
  | `columnGap` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
118
119
  | `dangerouslySetBackground` | `string` | No | `-` | - |
@@ -146,6 +147,7 @@ function CustomLayoutFooter() {
146
147
  | `height` | `ResponsiveProp<Height<string \| number>>` | No | `-` | - |
147
148
  | `justifyContent` | `ResponsiveProp<left \| right \| center \| normal \| start \| end \| flex-start \| flex-end \| stretch \| space-between \| space-around \| space-evenly>` | No | `-` | - |
148
149
  | `key` | `Key \| null` | No | `-` | - |
150
+ | `left` | `string \| number` | No | `-` | Position the box to the left edge. |
149
151
  | `lineHeight` | `ResponsiveProp<LineHeight \| inherit>` | No | `-` | - |
150
152
  | `margin` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
151
153
  | `marginBottom` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
@@ -169,16 +171,20 @@ function CustomLayoutFooter() {
169
171
  | `paddingX` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
170
172
  | `paddingY` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
171
173
  | `pin` | `top \| bottom \| left \| right \| all` | No | `-` | Direction in which to absolutely pin the box. |
174
+ | `position` | `static \| relative \| fixed \| absolute \| sticky` | No | `-` | How to position the box within its parent. |
172
175
  | `ref` | `RefObject<HTMLDivElement> \| ((instance: HTMLDivElement \| null) => void) \| null` | No | `-` | - |
176
+ | `right` | `string \| number` | No | `-` | Position the box to the right edge. |
173
177
  | `rowGap` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
174
178
  | `style` | `CSSProperties` | No | `-` | - |
175
179
  | `testID` | `string` | No | `-` | Used to locate this element in unit and end-to-end tests. Under the hood, testID translates to data-testid on Web. On Mobile, testID stays the same - testID |
176
180
  | `textAlign` | `ResponsiveProp<center \| start \| end \| justify>` | No | `-` | - |
177
181
  | `textDecoration` | `ResponsiveProp<none \| underline \| overline \| line-through \| underline overline \| underline double>` | No | `-` | - |
178
182
  | `textTransform` | `ResponsiveProp<capitalize \| lowercase \| none \| uppercase>` | No | `-` | - |
183
+ | `top` | `string \| number` | No | `-` | Position the box to the top edge. |
179
184
  | `transform` | `inherit \| none \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
180
185
  | `userSelect` | `ResponsiveProp<text \| none \| auto \| all>` | No | `-` | - |
181
186
  | `visibility` | `ResponsiveProp<hidden \| visible>` | No | `-` | - |
182
187
  | `width` | `ResponsiveProp<Width<string \| number>>` | No | `-` | - |
188
+ | `zIndex` | `number` | No | `-` | Adjust the z-index positioning layer. |
183
189
 
184
190
 
@@ -164,6 +164,7 @@ function Example() {
164
164
  | `borderedStart` | `boolean` | No | `-` | Add a border to the leading side of the box. |
165
165
  | `borderedTop` | `boolean` | No | `-` | Add a border to the top side of the box. |
166
166
  | `borderedVertical` | `boolean` | No | `-` | Add a border to the top and bottom sides of the box. |
167
+ | `bottom` | `string \| number` | No | `-` | Position the box to the bottom edge. |
167
168
  | `classNames` | `{ root?: string; start?: string \| undefined; end?: string \| undefined; title?: string \| undefined; } \| undefined` | No | `-` | Custom class names for the page header. |
168
169
  | `color` | `currentColor \| fg \| fgMuted \| fgInverse \| fgPrimary \| fgWarning \| fgPositive \| fgNegative \| bg \| bgAlternate \| bgInverse \| bgOverlay \| bgElevation1 \| bgElevation2 \| bgPrimary \| bgPrimaryWash \| bgSecondary \| bgTertiary \| bgSecondaryWash \| bgNegative \| bgNegativeWash \| bgPositive \| bgPositiveWash \| bgWarning \| bgWarningWash \| bgLine \| bgLineHeavy \| bgLineInverse \| bgLinePrimary \| bgLinePrimarySubtle \| accentSubtleRed \| accentBoldRed \| accentSubtleGreen \| accentBoldGreen \| accentSubtleBlue \| accentBoldBlue \| accentSubtlePurple \| accentBoldPurple \| accentSubtleYellow \| accentBoldYellow \| accentSubtleGray \| accentBoldGray \| transparent` | No | `-` | - |
169
170
  | `columnGap` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
@@ -202,6 +203,7 @@ function Example() {
202
203
  | `height` | `ResponsiveProp<Height<string \| number>>` | No | `-` | - |
203
204
  | `justifyContent` | `ResponsiveProp<left \| right \| center \| normal \| start \| end \| flex-start \| flex-end \| stretch \| space-between \| space-around \| space-evenly>` | No | `-` | - |
204
205
  | `key` | `Key \| null` | No | `-` | - |
206
+ | `left` | `string \| number` | No | `-` | Position the box to the left edge. |
205
207
  | `lineHeight` | `ResponsiveProp<LineHeight \| inherit>` | No | `-` | - |
206
208
  | `margin` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
207
209
  | `marginBottom` | `ResponsiveProp<0 \| -5 \| -10 \| -0.25 \| -0.5 \| -0.75 \| -1 \| -1.5 \| -2 \| -3 \| -4 \| -6 \| -7 \| -8 \| -9>` | No | `-` | - |
@@ -225,7 +227,9 @@ function Example() {
225
227
  | `paddingX` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
226
228
  | `paddingY` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
227
229
  | `pin` | `top \| bottom \| left \| right \| all` | No | `-` | Direction in which to absolutely pin the box. |
230
+ | `position` | `static \| relative \| fixed \| absolute \| sticky` | No | `-` | How to position the box within its parent. |
228
231
  | `ref` | `RefObject<HTMLDivElement> \| ((instance: HTMLDivElement \| null) => void) \| null` | No | `-` | - |
232
+ | `right` | `string \| number` | No | `-` | Position the box to the right edge. |
229
233
  | `rowGap` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
230
234
  | `rows` | `number` | No | `-` | - |
231
235
  | `start` | `null \| string \| number \| false \| true \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal` | No | `-` | Optional. Accepts a ReactNode. Used for placing primary content on the left side of the page header, such as a header title, logo, or icon button. |
@@ -237,9 +241,21 @@ function Example() {
237
241
  | `textDecoration` | `ResponsiveProp<none \| underline \| overline \| line-through \| underline overline \| underline double>` | No | `-` | - |
238
242
  | `textTransform` | `ResponsiveProp<capitalize \| lowercase \| none \| uppercase>` | No | `-` | - |
239
243
  | `title` | `null \| string \| number \| false \| true \| ReactElement<any, string \| JSXElementConstructor<any>> \| Iterable<ReactNode> \| ReactPortal` | No | `-` | Optional. Accepts a ReactNode. Intended for main title within the Page Header or for secondary content in the center of the header, like a navigation stepper or search bar. |
244
+ | `top` | `string \| number` | No | `-` | Position the box to the top edge. |
240
245
  | `transform` | `inherit \| none \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
241
246
  | `userSelect` | `ResponsiveProp<text \| none \| auto \| all>` | No | `-` | - |
242
247
  | `visibility` | `ResponsiveProp<hidden \| visible>` | No | `-` | - |
243
248
  | `width` | `ResponsiveProp<Width<string \| number>>` | No | `-` | - |
249
+ | `zIndex` | `number` | No | `-` | Adjust the z-index positioning layer. |
250
+
251
+
252
+ ## Styles
253
+
254
+ | Selector | Static class name | Description |
255
+ | --- | --- | --- |
256
+ | `start` | `-` | start element. |
257
+ | `end` | `-` | end element. |
258
+ | `title` | `-` | title element. |
259
+ | `root` | `-` | root element. |
244
260
 
245
261
 
@@ -89,9 +89,10 @@ On web, all [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Acces
89
89
  | `alignContent` | `ResponsiveProp<center \| normal \| start \| end \| flex-start \| flex-end \| stretch \| baseline \| first baseline \| last baseline \| space-between \| space-around \| space-evenly>` | No | `-` | - |
90
90
  | `alignItems` | `ResponsiveProp<center \| normal \| start \| end \| flex-start \| flex-end \| self-start \| self-end \| stretch \| baseline \| first baseline \| last baseline>` | No | `-` | - |
91
91
  | `alignSelf` | `ResponsiveProp<center \| normal \| auto \| start \| end \| flex-start \| flex-end \| self-start \| self-end \| stretch \| baseline \| first baseline \| last baseline>` | No | `-` | - |
92
+ | `analyticsId` | `string` | No | `-` | - |
92
93
  | `aria-activedescendant` | `string \| undefined` | No | `-` | Identifies the currently active element when DOM focus is on a composite widget, textbox, group, or application. |
93
94
  | `aria-atomic` | `Booleanish \| undefined` | No | `-` | Indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. |
94
- | `aria-autocomplete` | `none \| list \| inline \| both \| undefined` | No | `-` | Indicates whether inputting text could trigger display of one or more predictions of the users intended value for an input and specifies how predictions would be presented if they are made. |
95
+ | `aria-autocomplete` | `none \| inline \| list \| both \| undefined` | No | `-` | Indicates whether inputting text could trigger display of one or more predictions of the users intended value for an input and specifies how predictions would be presented if they are made. |
95
96
  | `aria-braillelabel` | `string \| undefined` | No | `-` | Defines a string value that labels the current element, which is intended to be converted into Braille. |
96
97
  | `aria-brailleroledescription` | `string \| undefined` | No | `-` | Defines a human-readable, author-localized abbreviated description for the role of an element, which is intended to be converted into Braille. |
97
98
  | `aria-busy` | `Booleanish \| undefined` | No | `-` | - |
@@ -101,17 +102,17 @@ On web, all [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Acces
101
102
  | `aria-colindextext` | `string \| undefined` | No | `-` | Defines a human readable text alternative of aria-colindex. |
102
103
  | `aria-colspan` | `number \| undefined` | No | `-` | Defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid. |
103
104
  | `aria-controls` | `string \| undefined` | No | `-` | Identifies the element (or elements) whose contents or presence are controlled by the current element. |
104
- | `aria-current` | `boolean \| true \| false \| page \| step \| location \| date \| time \| undefined` | No | `-` | Indicates the element that represents the current item within a container or set of related elements. |
105
+ | `aria-current` | `boolean \| time \| location \| true \| false \| page \| step \| date \| undefined` | No | `-` | Indicates the element that represents the current item within a container or set of related elements. |
105
106
  | `aria-describedby` | `string \| undefined` | No | `-` | Identifies the element (or elements) that describes the object. |
106
107
  | `aria-description` | `string \| undefined` | No | `-` | Defines a string value that describes or annotates the current element. |
107
108
  | `aria-details` | `string \| undefined` | No | `-` | Identifies the element that provides a detailed, extended description for the object. |
108
109
  | `aria-disabled` | `Booleanish \| undefined` | No | `-` | Indicates that the element is perceivable but disabled, so it is not editable or otherwise operable. |
109
- | `aria-dropeffect` | `none \| link \| copy \| execute \| move \| popup \| undefined` | No | `-` | Indicates what functions can be performed when a dragged object is released on the drop target. |
110
+ | `aria-dropeffect` | `link \| none \| copy \| execute \| move \| popup \| undefined` | No | `-` | Indicates what functions can be performed when a dragged object is released on the drop target. |
110
111
  | `aria-errormessage` | `string \| undefined` | No | `-` | Identifies the element that provides an error message for the object. |
111
112
  | `aria-expanded` | `Booleanish \| undefined` | No | `-` | Indicates whether the element, or another grouping element it controls, is currently expanded or collapsed. |
112
113
  | `aria-flowto` | `string \| undefined` | No | `-` | Identifies the next element (or elements) in an alternate reading order of content which, at the users discretion, allows assistive technology to override the general default of reading in document source order. |
113
114
  | `aria-grabbed` | `Booleanish \| undefined` | No | `-` | Indicates an elements grabbed state in a drag-and-drop operation. |
114
- | `aria-haspopup` | `boolean \| true \| false \| dialog \| grid \| listbox \| menu \| tree \| undefined` | No | `-` | Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element. |
115
+ | `aria-haspopup` | `boolean \| grid \| dialog \| menu \| true \| false \| listbox \| tree \| undefined` | No | `-` | Indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element. |
115
116
  | `aria-hidden` | `Booleanish \| undefined` | No | `-` | Indicates whether the element is exposed to an accessibility API. |
116
117
  | `aria-invalid` | `boolean \| true \| false \| grammar \| spelling \| undefined` | No | `-` | Indicates the entered value does not conform to the format expected by the application. |
117
118
  | `aria-keyshortcuts` | `string \| undefined` | No | `-` | Indicates keyboard shortcuts that an author has implemented to activate or give focus to an element. |
@@ -128,7 +129,7 @@ On web, all [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Acces
128
129
  | `aria-posinset` | `number \| undefined` | No | `-` | Defines an elements number or position in the current set of listitems or treeitems. Not required if all elements in the set are present in the DOM. |
129
130
  | `aria-pressed` | `boolean \| true \| false \| mixed \| undefined` | No | `-` | Indicates the current pressed state of toggle buttons. |
130
131
  | `aria-readonly` | `Booleanish \| undefined` | No | `-` | Indicates that the element is not editable, but is otherwise operable. |
131
- | `aria-relevant` | `text \| additions \| additions removals \| additions text \| all \| removals \| removals additions \| removals text \| text additions \| text removals \| undefined` | No | `-` | Indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. |
132
+ | `aria-relevant` | `text \| all \| additions \| additions removals \| additions text \| removals \| removals additions \| removals text \| text additions \| text removals \| undefined` | No | `-` | Indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. |
132
133
  | `aria-required` | `Booleanish \| undefined` | No | `-` | Indicates that user input is required on the element before a form may be submitted. |
133
134
  | `aria-roledescription` | `string \| undefined` | No | `-` | Defines a human-readable, author-localized description for the role of an element. |
134
135
  | `aria-rowcount` | `number \| undefined` | No | `-` | Defines the total number of rows in a table, grid, or treegrid. |
@@ -144,7 +145,7 @@ On web, all [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Acces
144
145
  | `aria-valuetext` | `string \| undefined` | No | `-` | Defines the human readable text alternative of aria-valuenow for a range widget. |
145
146
  | `as` | `symbol \| object \| style \| div \| a \| abbr \| address \| area \| article \| aside \| audio \| b \| base \| bdi \| bdo \| big \| blockquote \| body \| br \| button \| canvas \| caption \| center \| cite \| code \| col \| colgroup \| data \| datalist \| dd \| del \| details \| dfn \| dialog \| dl \| dt \| em \| embed \| fieldset \| figcaption \| figure \| footer \| form \| h1 \| h2 \| h3 \| h4 \| h5 \| h6 \| head \| header \| hgroup \| hr \| html \| i \| iframe \| img \| input \| ins \| kbd \| keygen \| label \| legend \| li \| link \| main \| map \| mark \| menu \| menuitem \| meta \| meter \| nav \| noindex \| noscript \| ol \| optgroup \| option \| output \| p \| param \| picture \| pre \| progress \| q \| rp \| rt \| ruby \| s \| samp \| search \| slot \| script \| section \| select \| small \| source \| span \| strong \| sub \| summary \| sup \| table \| template \| tbody \| td \| textarea \| tfoot \| th \| thead \| time \| title \| tr \| track \| u \| ul \| var \| video \| wbr \| webview \| svg \| animate \| animateMotion \| animateTransform \| circle \| clipPath \| defs \| desc \| ellipse \| feBlend \| feColorMatrix \| feComponentTransfer \| feComposite \| feConvolveMatrix \| feDiffuseLighting \| feDisplacementMap \| feDistantLight \| feDropShadow \| feFlood \| feFuncA \| feFuncB \| feFuncG \| feFuncR \| feGaussianBlur \| feImage \| feMerge \| feMergeNode \| feMorphology \| feOffset \| fePointLight \| feSpecularLighting \| feSpotLight \| feTile \| feTurbulence \| filter \| foreignObject \| g \| image \| line \| linearGradient \| marker \| mask \| metadata \| mpath \| path \| pattern \| polygon \| polyline \| radialGradient \| rect \| set \| stop \| switch \| text \| textPath \| tspan \| use \| view \| ComponentClass<any, any> \| FunctionComponent<any>` | No | `button` | The underlying element or component the polymorphic component will render. Changing as also changes the inherited native props (e.g. href for as=a) and the expected ref type. |
146
147
  | `aspectRatio` | `inherit \| auto \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
147
- | `autoCapitalize` | `off \| none \| on \| sentences \| words \| characters \| (string & {}) \| undefined` | No | `-` | - |
148
+ | `autoCapitalize` | `(string & {}) \| none \| off \| on \| sentences \| words \| characters \| undefined` | No | `-` | - |
148
149
  | `autoCorrect` | `string \| undefined` | No | `-` | - |
149
150
  | `autoFocus` | `boolean \| undefined` | No | `-` | - |
150
151
  | `autoSave` | `string \| undefined` | No | `-` | - |
@@ -175,7 +176,7 @@ On web, all [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Acces
175
176
  | `color` | `currentColor \| fg \| fgMuted \| fgInverse \| fgPrimary \| fgWarning \| fgPositive \| fgNegative \| bg \| bgAlternate \| bgInverse \| bgOverlay \| bgElevation1 \| bgElevation2 \| bgPrimary \| bgPrimaryWash \| bgSecondary \| bgTertiary \| bgSecondaryWash \| bgNegative \| bgNegativeWash \| bgPositive \| bgPositiveWash \| bgWarning \| bgWarningWash \| bgLine \| bgLineHeavy \| bgLineInverse \| bgLinePrimary \| bgLinePrimarySubtle \| accentSubtleRed \| accentBoldRed \| accentSubtleGreen \| accentBoldGreen \| accentSubtleBlue \| accentBoldBlue \| accentSubtlePurple \| accentBoldPurple \| accentSubtleYellow \| accentBoldYellow \| accentSubtleGray \| accentBoldGray \| transparent` | No | `-` | - |
176
177
  | `columnGap` | `0 \| 1 \| 2 \| 0.25 \| 0.5 \| 0.75 \| 1.5 \| 3 \| 4 \| 5 \| 6 \| 7 \| 8 \| 9 \| 10` | No | `-` | - |
177
178
  | `content` | `string \| undefined` | No | `-` | - |
178
- | `contentEditable` | `Booleanish \| inherit \| plaintext-only \| undefined` | No | `-` | - |
179
+ | `contentEditable` | `inherit \| Booleanish \| plaintext-only \| undefined` | No | `-` | - |
179
180
  | `contextMenu` | `string \| undefined` | No | `-` | - |
180
181
  | `dangerouslySetBackground` | `string` | No | `-` | - |
181
182
  | `dangerouslySetInnerHTML` | `{ __html: string \| TrustedHTML; } \| undefined` | No | `-` | - |
@@ -187,7 +188,8 @@ On web, all [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Acces
187
188
  | `display` | `ResponsiveProp<grid \| revert \| none \| block \| inline \| inline-block \| flex \| inline-flex \| inline-grid \| contents \| flow-root \| list-item>` | No | `-` | - |
188
189
  | `draggable` | `Booleanish \| undefined` | No | `-` | - |
189
190
  | `elevation` | `0 \| 1 \| 2` | No | `-` | - |
190
- | `enterKeyHint` | `enter \| done \| go \| next \| previous \| search \| send \| undefined` | No | `-` | - |
191
+ | `enterKeyHint` | `search \| enter \| done \| go \| next \| previous \| send \| undefined` | No | `-` | - |
192
+ | `eventConfig` | `EventHandlerCustomConfig` | No | `-` | - |
191
193
  | `flexBasis` | `ResponsiveProp<FlexBasis<string \| number>>` | No | `-` | - |
192
194
  | `flexDirection` | `ResponsiveProp<column \| row \| row-reverse \| column-reverse>` | No | `-` | - |
193
195
  | `flexGrow` | `inherit \| revert \| -moz-initial \| initial \| revert-layer \| unset` | No | `-` | - |
@@ -224,7 +226,7 @@ On web, all [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Acces
224
226
  | `hidden` | `boolean \| undefined` | No | `-` | - |
225
227
  | `id` | `string \| undefined` | No | `-` | - |
226
228
  | `inlist` | `any` | No | `-` | - |
227
- | `inputMode` | `none \| search \| text \| tel \| url \| email \| numeric \| decimal \| undefined` | No | `-` | Hints at the type of data that might be entered by the user while editing the element or its contents |
229
+ | `inputMode` | `search \| text \| none \| email \| tel \| url \| numeric \| decimal \| undefined` | No | `-` | Hints at the type of data that might be entered by the user while editing the element or its contents |
228
230
  | `is` | `string \| undefined` | No | `-` | Specify that a standard HTML element should behave like a defined custom built-in element |
229
231
  | `itemID` | `string \| undefined` | No | `-` | - |
230
232
  | `itemProp` | `string \| undefined` | No | `-` | - |
@@ -451,7 +453,7 @@ On web, all [ARIA attributes](https://developer.mozilla.org/en-US/docs/Web/Acces
451
453
  | `translate` | `yes \| no \| undefined` | No | `-` | - |
452
454
  | `transparentWhileInactive` | `boolean` | No | `-` | Mark the background and border as transparent until the element is interacted with (hovered, pressed, etc). Must be used in conjunction with the pressed prop |
453
455
  | `transparentWhilePressed` | `boolean` | No | `-` | Mark the background and border as transparent even while element is interacted with (elevation underlay issue). Must be used in conjunction with the pressed prop |
454
- | `type` | `button \| submit \| reset \| undefined` | No | `-` | - |
456
+ | `type` | `button \| reset \| submit \| undefined` | No | `-` | - |
455
457
  | `typeof` | `string \| undefined` | No | `-` | - |
456
458
  | `unselectable` | `off \| on \| undefined` | No | `-` | - |
457
459
  | `userSelect` | `ResponsiveProp<text \| none \| auto \| all>` | No | `-` | - |
@@ -179,3 +179,11 @@ function Example() {
179
179
  | `weight` | `normal \| heavy \| thin \| semiheavy` | No | `normal` | Toggle used to change thickness of progress visualization |
180
180
 
181
181
 
182
+ ## Styles
183
+
184
+ | Selector | Static class name | Description |
185
+ | --- | --- | --- |
186
+ | `root` | `-` | progress bar root. |
187
+ | `progress` | `-` | progress. |
188
+
189
+
@@ -281,3 +281,13 @@ function Example() {
281
281
  | `testID` | `string` | No | `-` | Used to locate this element in unit and end-to-end tests. Under the hood, testID translates to data-testid on Web. On Mobile, testID stays the same - testID |
282
282
 
283
283
 
284
+ ## Styles
285
+
286
+ | Selector | Static class name | Description |
287
+ | --- | --- | --- |
288
+ | `root` | `-` | progress bar with fixed labels root. |
289
+ | `labelContainer` | `-` | label container. |
290
+ | `startLabel` | `-` | start label. |
291
+ | `endLabel` | `-` | end label. |
292
+
293
+
@@ -250,3 +250,12 @@ function Example() {
250
250
  | `testID` | `string` | No | `-` | Used to locate this element in unit and end-to-end tests. Under the hood, testID translates to data-testid on Web. On Mobile, testID stays the same - testID |
251
251
 
252
252
 
253
+ ## Styles
254
+
255
+ | Selector | Static class name | Description |
256
+ | --- | --- | --- |
257
+ | `root` | `-` | progress bar with float label root. |
258
+ | `labelContainer` | `-` | label container. |
259
+ | `label` | `-` | label. |
260
+
261
+
@@ -467,3 +467,13 @@ function Example() {
467
467
  | `weight` | `normal \| heavy \| thin \| semiheavy` | No | `normal` | Toggle used to change thickness of progress visualization |
468
468
 
469
469
 
470
+ ## Styles
471
+
472
+ | Selector | Static class name | Description |
473
+ | --- | --- | --- |
474
+ | `root` | `-` | progress circle root. |
475
+ | `svg` | `-` | progress circle svg. |
476
+ | `circle` | `-` | background circle. |
477
+ | `progress` | `-` | foreground circle. |
478
+
479
+