@workday/canvas-kit-docs 15.0.0-alpha.1303-next.0 → 15.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (681) hide show
  1. package/README.md +6 -6
  2. package/dist/es6/docgen/createTraversals.d.ts +0 -3
  3. package/dist/es6/docgen/createTraversals.d.ts.map +1 -1
  4. package/dist/es6/docgen/docParser.d.ts +1 -1
  5. package/dist/es6/docgen/docParser.d.ts.map +1 -1
  6. package/dist/es6/docgen/docParser.js +14 -4
  7. package/dist/es6/docgen/plugins/componentParser.d.ts +1 -1
  8. package/dist/es6/docgen/plugins/componentParser.d.ts.map +1 -1
  9. package/dist/es6/docgen/plugins/componentParser.js +1 -1
  10. package/dist/es6/docgen/plugins/customTypes.d.ts +1 -1
  11. package/dist/es6/docgen/plugins/customTypes.d.ts.map +1 -1
  12. package/dist/es6/docgen/plugins/enhancedComponentParser.d.ts +1 -1
  13. package/dist/es6/docgen/plugins/enhancedComponentParser.d.ts.map +1 -1
  14. package/dist/es6/docgen/plugins/enhancedComponentParser.js +2 -1
  15. package/dist/es6/docgen/plugins/modelParser.d.ts.map +1 -1
  16. package/dist/es6/docgen/plugins/modelParser.js +4 -4
  17. package/dist/es6/docgen/traverse.d.ts.map +1 -1
  18. package/dist/es6/docgen/traverse.js +1 -1
  19. package/dist/es6/lib/DescriptionTooltip.d.ts +2 -5
  20. package/dist/es6/lib/DescriptionTooltip.d.ts.map +1 -1
  21. package/dist/es6/lib/DescriptionTooltip.js +11 -10
  22. package/dist/es6/lib/DownloadLLMFile.js +11 -11
  23. package/dist/es6/lib/ExampleCodeBlock.d.ts.map +1 -1
  24. package/dist/es6/lib/ExampleCodeBlock.js +37 -28
  25. package/dist/es6/lib/MDXElements.d.ts +1 -1
  26. package/dist/es6/lib/MDXElements.d.ts.map +1 -1
  27. package/dist/es6/lib/MDXElements.js +5 -5
  28. package/dist/es6/lib/MoreTooltip.d.ts.map +1 -1
  29. package/dist/es6/lib/MoreTooltip.js +1 -1
  30. package/dist/es6/lib/Specifications.d.ts +3 -1
  31. package/dist/es6/lib/Specifications.d.ts.map +1 -1
  32. package/dist/es6/lib/Specifications.js +20 -10
  33. package/dist/es6/lib/StorybookStatusIndicator.d.ts +2 -2
  34. package/dist/es6/lib/StorybookStatusIndicator.d.ts.map +1 -1
  35. package/dist/es6/lib/StorybookStatusIndicator.js +23 -21
  36. package/dist/es6/lib/StylePropsTable.d.ts.map +1 -1
  37. package/dist/es6/lib/StylePropsTable.js +1 -1
  38. package/dist/es6/lib/SymbolDoc.d.ts +1 -1
  39. package/dist/es6/lib/SymbolDoc.d.ts.map +1 -1
  40. package/dist/es6/lib/SymbolDoc.js +1 -1
  41. package/dist/es6/lib/Table.d.ts.map +1 -1
  42. package/dist/es6/lib/Table.js +33 -10
  43. package/dist/es6/lib/Value.d.ts.map +1 -1
  44. package/dist/es6/lib/Value.js +14 -11
  45. package/dist/es6/lib/docs.d.ts.map +1 -1
  46. package/dist/es6/lib/docs.js +204588 -183032
  47. package/dist/es6/lib/specs.js +6142 -1
  48. package/dist/es6/lib/stackblitzFiles/App.d.ts.map +1 -1
  49. package/dist/es6/lib/stackblitzFiles/App.js +5 -11
  50. package/dist/es6/lib/stackblitzFiles/App.tsx +7 -21
  51. package/dist/es6/lib/stackblitzFiles/main.d.ts +1 -0
  52. package/dist/es6/lib/stackblitzFiles/main.d.ts.map +1 -1
  53. package/dist/es6/lib/stackblitzFiles/main.js +4 -3
  54. package/dist/es6/lib/stackblitzFiles/main.tsx +6 -4
  55. package/dist/es6/lib/stackblitzFiles/packageJSONFile.d.ts.map +1 -1
  56. package/dist/es6/lib/stackblitzFiles/packageJSONFile.js +8 -7
  57. package/dist/es6/lib/stackblitzFiles/packageJSONFile.ts +9 -7
  58. package/dist/es6/lib/stackblitzFiles/vite.config.d.ts +1 -1
  59. package/dist/es6/lib/stackblitzFiles/vite.config.d.ts.map +1 -1
  60. package/dist/es6/lib/stackblitzFiles/vite.config.js +1 -1
  61. package/dist/es6/lib/stackblitzFiles/vite.config.ts +1 -3
  62. package/dist/es6/lib/widgetUtils.d.ts.map +1 -1
  63. package/dist/es6/lib/widgetUtils.js +39 -39
  64. package/dist/es6/lib/widgets/array.js +1 -1
  65. package/dist/es6/lib/widgets/callExpression.js +1 -1
  66. package/dist/es6/lib/widgets/canvasColor.js +3 -2
  67. package/dist/es6/lib/widgets/conditional.js +1 -1
  68. package/dist/es6/lib/widgets/enhancedComponent.js +2 -1
  69. package/dist/es6/lib/widgets/external.js +1 -1
  70. package/dist/es6/lib/widgets/function.js +2 -2
  71. package/dist/es6/lib/widgets/index.d.ts +1 -1
  72. package/dist/es6/lib/widgets/index.d.ts.map +1 -1
  73. package/dist/es6/lib/widgets/index.js +1 -1
  74. package/dist/es6/lib/widgets/intersection.js +1 -1
  75. package/dist/es6/lib/widgets/model.js +1 -1
  76. package/dist/es6/lib/widgets/parenthesis.js +1 -1
  77. package/dist/es6/lib/widgets/primitives.js +2 -2
  78. package/dist/es6/lib/widgets/qualifiedName.js +1 -1
  79. package/dist/es6/lib/widgets/tuple.js +1 -1
  80. package/dist/es6/lib/widgets/typeParameter.js +1 -1
  81. package/dist/es6/lib/widgets/union.js +1 -1
  82. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/CommentBoxWithCharLimit.d.ts +2 -0
  83. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/CommentBoxWithCharLimit.d.ts.map +1 -0
  84. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/CommentBoxWithCharLimit.js +31 -0
  85. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/FilterListWithLiveStatus.js +9 -9
  86. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/HiddenLiveRegion.js +2 -2
  87. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/IconButtonsWithLiveBadges.d.ts.map +1 -1
  88. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/IconButtonsWithLiveBadges.js +4 -4
  89. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/TextInputWithLiveError.d.ts.map +1 -1
  90. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/TextInputWithLiveError.js +3 -3
  91. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/VisibleLiveRegion.d.ts.map +1 -1
  92. package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/VisibleLiveRegion.js +8 -9
  93. package/dist/es6/mdx/accessibility/examples/GlobalHeader.js +21 -21
  94. package/dist/es6/mdx/accessibility/examples/PageStructure/BreadcrumbNavRegion.js +2 -2
  95. package/dist/es6/mdx/accessibility/examples/PageStructure/FullPageDemo.d.ts.map +1 -1
  96. package/dist/es6/mdx/accessibility/examples/PageStructure/FullPageDemo.js +16 -10
  97. package/dist/es6/mdx/accessibility/examples/PageStructure/LandmarkRegions.d.ts +1 -1
  98. package/dist/es6/mdx/accessibility/examples/PageStructure/LandmarkRegions.d.ts.map +1 -1
  99. package/dist/es6/mdx/accessibility/examples/PageStructure/LandmarkRegions.js +15 -9
  100. package/dist/es6/mdx/accessibility/examples/Popups/InlinePopupNoPortal.d.ts +2 -0
  101. package/dist/es6/mdx/accessibility/examples/Popups/InlinePopupNoPortal.d.ts.map +1 -0
  102. package/dist/es6/mdx/accessibility/examples/Popups/InlinePopupNoPortal.js +62 -0
  103. package/dist/es6/mdx/accessibility/examples/Popups/InlinePortalPopup.d.ts +7 -0
  104. package/dist/es6/mdx/accessibility/examples/Popups/InlinePortalPopup.d.ts.map +1 -0
  105. package/dist/es6/mdx/accessibility/examples/Popups/InlinePortalPopup.js +65 -0
  106. package/dist/es6/mdx/accessibility/examples/Popups/PopupAriaOwns.d.ts +7 -0
  107. package/dist/es6/mdx/accessibility/examples/Popups/PopupAriaOwns.d.ts.map +1 -0
  108. package/dist/es6/mdx/accessibility/examples/Popups/PopupAriaOwns.js +46 -0
  109. package/dist/es6/mdx/accessibility/examples/SidePanelWithNavigation.d.ts.map +1 -1
  110. package/dist/es6/mdx/accessibility/examples/SidePanelWithNavigation.js +16 -16
  111. package/dist/es6/mdx/accessibility/examples/SidePanelWithOverlay.d.ts.map +1 -1
  112. package/dist/es6/mdx/accessibility/examples/SidePanelWithOverlay.js +4 -5
  113. package/dist/es6/mdx/accessibility/examples/Table/WithColumnHeaderFilters.js +8 -8
  114. package/dist/es6/mdx/accessibility/examples/Table/WithExpandableRows.d.ts.map +1 -1
  115. package/dist/es6/mdx/accessibility/examples/Table/WithExpandableRows.js +6 -6
  116. package/dist/es6/mdx/accessibility/examples/Table/WithFormFields.d.ts.map +1 -1
  117. package/dist/es6/mdx/accessibility/examples/Table/WithFormFields.js +10 -10
  118. package/dist/es6/mdx/accessibility/examples/Table/WithSelectableRows.js +4 -4
  119. package/dist/es6/mdx/accessibility/examples/Table/WithSortableColumnHeaders.js +7 -7
  120. package/dist/es6/mdx/installBlock.d.ts.map +1 -1
  121. package/dist/es6/mdx/installBlock.js +18 -6
  122. package/dist/es6/mdx/tokens/StorybookInformationHighlight/index.d.ts.map +1 -1
  123. package/dist/es6/mdx/tokens/StorybookInformationHighlight/index.js +2 -3
  124. package/dist/es6/mdx/versionsTable.d.ts.map +1 -1
  125. package/dist/es6/mdx/versionsTable.js +4 -3
  126. package/dist/es6/mdx/welcomePage.d.ts.map +1 -1
  127. package/dist/es6/mdx/welcomePage.js +24 -20
  128. package/dist/es6/utils/parseSpecFile.d.ts +24 -0
  129. package/dist/es6/utils/parseSpecFile.d.ts.map +1 -0
  130. package/dist/es6/utils/parseSpecFile.js +82 -0
  131. package/dist/mdx/10.0-UPGRADE-GUIDE.mdx +3 -3
  132. package/dist/mdx/13.0-UPGRADE-GUIDE.mdx +24 -18
  133. package/dist/mdx/14.0-UPGRADE-GUIDE.mdx +61 -14
  134. package/dist/mdx/14.0-VISUAL-CHANGES.mdx +19 -19
  135. package/dist/mdx/15.0-UPGRADE-GUIDE.mdx +1097 -0
  136. package/dist/mdx/15.0-VISUAL-CHANGES.mdx +151 -0
  137. package/dist/mdx/5.0-UPGRADE-GUIDE.mdx +3 -3
  138. package/dist/mdx/7.0-UPGRADE-GUIDE.mdx +4 -4
  139. package/dist/mdx/8.0-UPGRADE-GUIDE.mdx +5 -5
  140. package/dist/mdx/9.0-UPGRADE-GUIDE.mdx +2 -2
  141. package/dist/mdx/CODEMODS.mdx +2 -2
  142. package/dist/mdx/CONTRIBUTING.mdx +4 -4
  143. package/dist/mdx/CREATING_COMPOUND_COMPONENTS.mdx +1 -1
  144. package/dist/mdx/DOCUMENTATION_GUIDELINES.mdx +2 -2
  145. package/dist/mdx/GETTING_STARTED.mdx +1 -2
  146. package/dist/mdx/accessibility/AriaLiveRegions.mdx +14 -15
  147. package/dist/mdx/accessibility/InlinePortals.mdx +20 -0
  148. package/dist/mdx/accessibility/PageStructure.mdx +3 -2
  149. package/dist/mdx/accessibility/Popups.mdx +71 -0
  150. package/dist/mdx/accessibility/WindowsHighContrastThemes.mdx +12 -11
  151. package/dist/mdx/changelog.mdx +1 -2
  152. package/dist/mdx/labs-react/ai-ingress-button/examples/Inverse.tsx +2 -2
  153. package/dist/mdx/preview-react/_examples/mdx/examples/TextInputWithReactHookForm.tsx +11 -12
  154. package/dist/mdx/preview-react/divider/examples/Basic.tsx +6 -7
  155. package/dist/mdx/preview-react/divider/examples/CustomSpace.tsx +4 -3
  156. package/dist/mdx/preview-react/loading-sparkles/LoadingSparkles.mdx +2 -2
  157. package/dist/mdx/preview-react/loading-sparkles/examples/Basic.tsx +3 -2
  158. package/dist/mdx/preview-react/loading-sparkles/examples/RTL.tsx +3 -7
  159. package/dist/mdx/preview-react/multi-select/MultiSelect.mdx +3 -4
  160. package/dist/mdx/preview-react/multi-select/examples/Basic.tsx +1 -1
  161. package/dist/mdx/preview-react/multi-select/examples/Complex.tsx +3 -5
  162. package/dist/mdx/preview-react/multi-select/examples/Controlled.tsx +2 -3
  163. package/dist/mdx/preview-react/multi-select/examples/Disabled.tsx +1 -1
  164. package/dist/mdx/preview-react/multi-select/examples/Error.tsx +5 -5
  165. package/dist/mdx/preview-react/multi-select/examples/Icons.tsx +8 -9
  166. package/dist/mdx/preview-react/multi-select/examples/InitialSelectedItems.tsx +6 -8
  167. package/dist/mdx/preview-react/multi-select/examples/Searching.tsx +6 -8
  168. package/dist/mdx/preview-react/radio/examples/Basic.tsx +2 -1
  169. package/dist/mdx/preview-react/radio/examples/Caution.tsx +2 -1
  170. package/dist/mdx/preview-react/radio/examples/Custom.tsx +2 -1
  171. package/dist/mdx/preview-react/radio/examples/Disabled.tsx +2 -1
  172. package/dist/mdx/preview-react/radio/examples/Error.tsx +2 -1
  173. package/dist/mdx/preview-react/radio/examples/Inverse.tsx +5 -4
  174. package/dist/mdx/preview-react/radio/examples/LabelPosition.tsx +2 -1
  175. package/dist/mdx/preview-react/radio/examples/NoValue.tsx +2 -1
  176. package/dist/mdx/preview-react/radio/examples/RefForwarding.tsx +2 -1
  177. package/dist/mdx/preview-react/radio/examples/Required.tsx +2 -1
  178. package/dist/mdx/preview-react/radio/examples/StandaloneRadio.tsx +2 -1
  179. package/dist/mdx/preview-react/side-panel/SidePanel.mdx +20 -8
  180. package/dist/mdx/preview-react/side-panel/examples/AlwaysOpen.tsx +5 -7
  181. package/dist/mdx/preview-react/side-panel/examples/Basic.tsx +10 -15
  182. package/dist/mdx/preview-react/side-panel/examples/ExternalControl.tsx +5 -5
  183. package/dist/mdx/preview-react/side-panel/examples/HiddenName.tsx +2 -1
  184. package/dist/mdx/preview-react/side-panel/examples/OnExpandedChange.tsx +3 -2
  185. package/dist/mdx/preview-react/side-panel/examples/OnStateTransition.tsx +3 -2
  186. package/dist/mdx/preview-react/side-panel/examples/RightOrigin.tsx +4 -7
  187. package/dist/mdx/preview-react/side-panel/examples/Variant.tsx +4 -6
  188. package/dist/mdx/preview-react/side-panel/examples/useDirection.ts +1 -0
  189. package/dist/mdx/preview-react/status-indicator/StatusIndicator.mdx +9 -2
  190. package/dist/mdx/preview-react/status-indicator/examples/Custom.tsx +22 -0
  191. package/dist/mdx/preview-react/status-indicator/examples/Emphasis.tsx +4 -6
  192. package/dist/mdx/preview-react/status-indicator/examples/Icon.tsx +4 -6
  193. package/dist/mdx/preview-react/status-indicator/examples/Overflow.tsx +5 -7
  194. package/dist/mdx/preview-react/status-indicator/examples/Variants.tsx +15 -17
  195. package/dist/mdx/preview-react/switch/Switch.mdx +84 -0
  196. package/dist/mdx/preview-react/switch/examples/Basic.tsx +21 -0
  197. package/dist/mdx/preview-react/switch/examples/Caution.tsx +22 -0
  198. package/dist/mdx/preview-react/switch/examples/Disabled.tsx +21 -0
  199. package/dist/mdx/preview-react/switch/examples/Error.tsx +22 -0
  200. package/dist/mdx/preview-react/switch/examples/LabelPosition.tsx +21 -0
  201. package/dist/mdx/preview-react/switch/examples/RTL.tsx +24 -0
  202. package/dist/mdx/preview-react/switch/examples/RefForwarding.tsx +30 -0
  203. package/dist/mdx/react/_examples/mdx/ContextualHelp.mdx +36 -0
  204. package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpDialogFocusRedirect.tsx +79 -0
  205. package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpDialogFocusTrap.tsx +79 -0
  206. package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpTooltip.tsx +43 -0
  207. package/dist/mdx/react/_examples/mdx/examples/CookieBanner.tsx +2 -2
  208. package/dist/mdx/react/_examples/mdx/examples/Density.tsx +43 -42
  209. package/dist/mdx/react/_examples/mdx/examples/MediaModal.tsx +4 -3
  210. package/dist/mdx/react/_examples/mdx/examples/PageHeader.tsx +22 -19
  211. package/dist/mdx/react/_examples/mdx/examples/SelectWithFormik.tsx +8 -12
  212. package/dist/mdx/react/_examples/mdx/examples/compoundComponent/CustomCard.tsx +10 -12
  213. package/dist/mdx/react/_examples/mdx/examples/layout/AreaColumnPositioning.tsx +1 -1
  214. package/dist/mdx/react/_examples/mdx/examples/layout/CustomColumnPositioning.tsx +1 -1
  215. package/dist/mdx/react/_examples/mdx/examples/layout/CustomColumnWidth.tsx +1 -1
  216. package/dist/mdx/react/_examples/mdx/examples/layout/FullWidthWith3Columns.tsx +50 -12
  217. package/dist/mdx/react/_examples/mdx/examples/layout/FullWidthWith3Columns2Rows.tsx +1 -1
  218. package/dist/mdx/react/_examples/mdx/examples/layout/Masonry.tsx +3 -2
  219. package/dist/mdx/react/_examples/mdx/examples/layout/ResponsiveColumns.tsx +2 -2
  220. package/dist/mdx/react/_examples/mdx/examples/layout/Tiled2and3Columns.tsx +1 -1
  221. package/dist/mdx/react/_examples/mdx/examples/layout/Tiled4and2Columns.tsx +1 -1
  222. package/dist/mdx/react/action-bar/ActionBar.mdx +4 -4
  223. package/dist/mdx/react/action-bar/examples/Icons.tsx +1 -1
  224. package/dist/mdx/react/action-bar/examples/OverflowActionBar.tsx +5 -3
  225. package/dist/mdx/react/action-bar/examples/OverflowActionBarCustomButtonCount.tsx +1 -0
  226. package/dist/mdx/{preview-react → react}/avatar/Avatar.mdx +23 -13
  227. package/dist/mdx/react/avatar/examples/Basic.tsx +5 -0
  228. package/dist/mdx/{preview-react → react}/avatar/examples/Custom.tsx +1 -1
  229. package/dist/mdx/{preview-react → react}/avatar/examples/Decorative.tsx +7 -5
  230. package/dist/mdx/{preview-react → react}/avatar/examples/Image.tsx +1 -1
  231. package/dist/mdx/{preview-react → react}/avatar/examples/Size.tsx +2 -2
  232. package/dist/mdx/{preview-react → react}/avatar/examples/Variant.tsx +2 -2
  233. package/dist/mdx/react/avatar/examples/nicholas-avatar.jpg +0 -0
  234. package/dist/mdx/react/badge/CountBadge.mdx +1 -1
  235. package/dist/mdx/react/badge/examples/Basic.tsx +2 -2
  236. package/dist/mdx/react/badge/examples/CustomLimit.tsx +8 -8
  237. package/dist/mdx/react/badge/examples/Emphasis.tsx +4 -4
  238. package/dist/mdx/react/badge/examples/Inverse.tsx +7 -6
  239. package/dist/mdx/react/badge/examples/NotificationBadge.tsx +8 -7
  240. package/dist/mdx/react/banner/Banner.mdx +2 -2
  241. package/dist/mdx/react/banner/examples/IconBanner.tsx +1 -1
  242. package/dist/mdx/react/banner/examples/RefForwarding.tsx +1 -1
  243. package/dist/mdx/react/banner/examples/Sticky.tsx +1 -1
  244. package/dist/mdx/react/banner/examples/StickyAnimation.tsx +7 -7
  245. package/dist/mdx/react/banner/examples/StickyRTL.tsx +3 -14
  246. package/dist/mdx/react/banner/examples/ThemedAlert.tsx +4 -5
  247. package/dist/mdx/react/banner/examples/ThemedError.tsx +5 -6
  248. package/dist/mdx/react/breadcrumbs/Breadcrumbs.mdx +6 -5
  249. package/dist/mdx/react/breadcrumbs/examples/CurrentItemTruncation.tsx +1 -0
  250. package/dist/mdx/react/breadcrumbs/examples/LinkTruncation.tsx +1 -0
  251. package/dist/mdx/react/breadcrumbs/examples/Overflow.tsx +6 -3
  252. package/dist/mdx/react/breadcrumbs/examples/RTL.tsx +6 -10
  253. package/dist/mdx/react/button/button/Button.mdx +11 -12
  254. package/dist/mdx/react/button/button/Hyperlink.mdx +11 -5
  255. package/dist/mdx/react/button/button/examples/CustomStyles.tsx +43 -43
  256. package/dist/mdx/react/button/button/examples/Delete.tsx +4 -4
  257. package/dist/mdx/react/button/button/examples/ExternalHyperlinkInverse.tsx +3 -3
  258. package/dist/mdx/react/button/button/examples/ExternalHyperlinkRTL.tsx +10 -0
  259. package/dist/mdx/react/button/button/examples/HyperlinkInverse.tsx +3 -3
  260. package/dist/mdx/react/button/button/examples/Primary.tsx +5 -5
  261. package/dist/mdx/react/button/button/examples/PrimaryInverse.tsx +6 -6
  262. package/dist/mdx/react/button/button/examples/Secondary.tsx +5 -5
  263. package/dist/mdx/react/button/button/examples/SecondaryInverse.tsx +6 -6
  264. package/dist/mdx/react/button/button/examples/StandaloneHyperlink.tsx +2 -2
  265. package/dist/mdx/react/button/button/examples/Tertiary.tsx +5 -5
  266. package/dist/mdx/react/button/button/examples/TertiaryInverse.tsx +6 -6
  267. package/dist/mdx/react/button/button/examples/ThemeOverrides.tsx +6 -6
  268. package/dist/mdx/react/card/card.mdx +5 -5
  269. package/dist/mdx/react/card/examples/Basic.tsx +1 -0
  270. package/dist/mdx/react/card/examples/Borderless.tsx +2 -3
  271. package/dist/mdx/react/card/examples/CustomStyles.tsx +1 -3
  272. package/dist/mdx/react/card/examples/Stencils.tsx +9 -10
  273. package/dist/mdx/react/card/examples/{Filled.tsx → Tonal.tsx} +2 -1
  274. package/dist/mdx/react/checkbox/Checkbox.mdx +11 -12
  275. package/dist/mdx/react/checkbox/examples/Basic.tsx +1 -0
  276. package/dist/mdx/react/checkbox/examples/Caution.tsx +1 -0
  277. package/dist/mdx/react/checkbox/examples/Disabled.tsx +1 -0
  278. package/dist/mdx/react/checkbox/examples/Error.tsx +1 -0
  279. package/dist/mdx/react/checkbox/examples/Indeterminate.tsx +3 -2
  280. package/dist/mdx/react/checkbox/examples/Inverse.tsx +3 -2
  281. package/dist/mdx/react/checkbox/examples/LabelPosition.tsx +1 -0
  282. package/dist/mdx/react/checkbox/examples/RefForwarding.tsx +3 -2
  283. package/dist/mdx/react/checkbox/examples/Required.tsx +1 -0
  284. package/dist/mdx/react/collection/mdx/examples/BasicGrid.tsx +3 -3
  285. package/dist/mdx/react/collection/mdx/examples/DataLoader.tsx +4 -4
  286. package/dist/mdx/react/collection/mdx/examples/MultiSelection.tsx +3 -3
  287. package/dist/mdx/react/collection/mdx/examples/OverflowVerticalList.tsx +3 -2
  288. package/dist/mdx/react/collection/mdx/examples/RovingFocus.tsx +2 -2
  289. package/dist/mdx/react/collection/mdx/examples/Selection.tsx +3 -3
  290. package/dist/mdx/react/collection/mdx/examples/StringChildren.tsx +1 -1
  291. package/dist/mdx/react/collection/mdx/examples/WrappingGrid.tsx +3 -3
  292. package/dist/mdx/react/color-picker/color-input/ColorInput.mdx +7 -8
  293. package/dist/mdx/react/color-picker/color-input/examples/Basic.tsx +2 -1
  294. package/dist/mdx/react/color-picker/color-input/examples/Caution.tsx +2 -1
  295. package/dist/mdx/react/color-picker/color-input/examples/Checked.tsx +2 -1
  296. package/dist/mdx/react/color-picker/color-input/examples/Disabled.tsx +2 -1
  297. package/dist/mdx/react/color-picker/color-input/examples/Error.tsx +2 -1
  298. package/dist/mdx/react/color-picker/color-input/examples/Grow.tsx +2 -1
  299. package/dist/mdx/react/color-picker/color-input/examples/LabelPosition.tsx +2 -1
  300. package/dist/mdx/react/color-picker/color-input/examples/RefForwarding.tsx +2 -1
  301. package/dist/mdx/react/color-picker/color-input/examples/Required.tsx +2 -1
  302. package/dist/mdx/react/color-picker/color-input/examples/ValidColorChange.tsx +4 -3
  303. package/dist/mdx/react/color-picker/color-preview/ColorPreview.mdx +3 -3
  304. package/dist/mdx/react/color-picker/color-preview/examples/LabelPosition.tsx +2 -1
  305. package/dist/mdx/react/color-picker/color-preview/examples/RefForwarding.tsx +4 -3
  306. package/dist/mdx/react/combobox/examples/Autocomplete.tsx +11 -9
  307. package/dist/mdx/react/common/mdx/CompoundComponentUtilities.mdx +1 -1
  308. package/dist/mdx/react/common/mdx/Theming.mdx +166 -129
  309. package/dist/mdx/react/common/mdx/examples/CreateComponent.tsx +10 -4
  310. package/dist/mdx/react/common/mdx/examples/CreateContainer.tsx +1 -0
  311. package/dist/mdx/react/common/mdx/examples/CreateElemPropsHook.tsx +3 -2
  312. package/dist/mdx/react/common/mdx/examples/CreateModelHook.tsx +1 -0
  313. package/dist/mdx/react/common/mdx/examples/CreateSubcomponent.tsx +2 -1
  314. package/dist/mdx/react/common/mdx/examples/RTL.tsx +4 -5
  315. package/dist/mdx/react/common/mdx/examples/ResponsiveStyles.tsx +4 -3
  316. package/dist/mdx/react/common/mdx/examples/ResponsiveViewport.tsx +4 -3
  317. package/dist/mdx/react/common/mdx/examples/Theming.tsx +40 -22
  318. package/dist/mdx/react/dialog/Dialog.mdx +51 -20
  319. package/dist/mdx/react/dialog/examples/Basic.tsx +4 -3
  320. package/dist/mdx/react/dialog/examples/DialogWithFallbackPlacements.tsx +20 -12
  321. package/dist/mdx/react/dialog/examples/Focus.tsx +3 -3
  322. package/dist/mdx/react/expandable/Expandable.mdx +54 -2
  323. package/dist/mdx/react/expandable/examples/Avatar.tsx +1 -0
  324. package/dist/mdx/react/expandable/examples/Depth.tsx +10 -1
  325. package/dist/mdx/react/expandable/examples/HoistedModel.tsx +26 -21
  326. package/dist/mdx/react/expandable/examples/LongTitle.tsx +1 -0
  327. package/dist/mdx/react/expandable/examples/RTL.tsx +2 -7
  328. package/dist/mdx/react/form-field/FormField.mdx +97 -45
  329. package/dist/mdx/react/form-field/examples/AllFields.tsx +10 -11
  330. package/dist/mdx/react/form-field/examples/Basic.tsx +1 -0
  331. package/dist/mdx/react/form-field/examples/Caution.tsx +8 -5
  332. package/dist/mdx/react/form-field/examples/Custom.tsx +3 -2
  333. package/dist/mdx/react/form-field/examples/CustomId.tsx +1 -0
  334. package/dist/mdx/react/form-field/examples/Disabled.tsx +2 -2
  335. package/dist/mdx/react/form-field/examples/Error.tsx +3 -3
  336. package/dist/mdx/react/form-field/examples/GroupedInputs.tsx +14 -14
  337. package/dist/mdx/react/form-field/examples/Grow.tsx +1 -0
  338. package/dist/mdx/react/form-field/examples/HiddenLabel.tsx +27 -11
  339. package/dist/mdx/react/form-field/examples/Hint.tsx +2 -2
  340. package/dist/mdx/react/form-field/examples/LabelPositionHorizontalEnd.tsx +3 -2
  341. package/dist/mdx/react/form-field/examples/LabelPositionHorizontalStart.tsx +3 -2
  342. package/dist/mdx/react/form-field/examples/RefForwarding.tsx +4 -3
  343. package/dist/mdx/react/form-field/examples/Required.tsx +2 -1
  344. package/dist/mdx/react/form-field/examples/ThemedErrors.tsx +8 -8
  345. package/dist/mdx/react/icon/Assets.mdx +174 -17
  346. package/dist/mdx/react/icon/examples/AccentIconList.tsx +5 -4
  347. package/dist/mdx/react/icon/examples/AppletIconList.tsx +5 -4
  348. package/dist/mdx/react/icon/examples/ExpressiveBasic.tsx +41 -0
  349. package/dist/mdx/react/icon/examples/ExpressiveCustomStyles.tsx +54 -0
  350. package/dist/mdx/react/icon/examples/{IconList.tsx → ExpressiveIconList.tsx} +20 -13
  351. package/dist/mdx/react/icon/examples/SVGBasic.tsx +31 -0
  352. package/dist/mdx/react/icon/examples/SystemBasic.tsx +44 -0
  353. package/dist/mdx/react/icon/examples/SystemCircleBasic.tsx +34 -0
  354. package/dist/mdx/react/icon/examples/SystemCustomStyles.tsx +62 -0
  355. package/dist/mdx/react/icon/examples/SystemIconList.tsx +80 -0
  356. package/dist/mdx/react/information-highlight/InformationHighlight.mdx +96 -0
  357. package/dist/mdx/{preview-react → react}/information-highlight/examples/Basic.tsx +1 -1
  358. package/dist/mdx/{preview-react → react}/information-highlight/examples/Body.tsx +1 -1
  359. package/dist/mdx/{preview-react → react}/information-highlight/examples/Caution.tsx +2 -2
  360. package/dist/mdx/{preview-react → react}/information-highlight/examples/Critical.tsx +2 -2
  361. package/dist/mdx/{preview-react → react}/information-highlight/examples/CustomIconCritical.tsx +5 -6
  362. package/dist/mdx/{preview-react → react}/information-highlight/examples/Heading.tsx +1 -1
  363. package/dist/mdx/{preview-react → react}/information-highlight/examples/Informational.tsx +4 -4
  364. package/dist/mdx/{preview-react → react}/information-highlight/examples/RTL.tsx +6 -11
  365. package/dist/mdx/react/layout/Box.mdx +13 -13
  366. package/dist/mdx/react/layout/Flex.mdx +3 -3
  367. package/dist/mdx/react/layout/Grid.mdx +3 -3
  368. package/dist/mdx/react/layout/examples/Box/Basic.tsx +9 -2
  369. package/dist/mdx/react/layout/examples/Flex/Basic.tsx +1 -0
  370. package/dist/mdx/react/layout/examples/Grid/Basic.tsx +19 -13
  371. package/dist/mdx/react/layout/examples/Grid/GridCard.tsx +34 -24
  372. package/dist/mdx/react/layout/examples/Grid/GridLayout.tsx +1 -0
  373. package/dist/mdx/react/layout/examples/Grid/GridLayoutInteractive.tsx +3 -3
  374. package/dist/mdx/react/loading-dots/LoadingDots.mdx +1 -1
  375. package/dist/mdx/react/loading-dots/examples/Accessible.tsx +8 -7
  376. package/dist/mdx/react/loading-dots/examples/Basic.tsx +1 -0
  377. package/dist/mdx/react/loading-dots/examples/CustomColorAndAnimation.tsx +6 -4
  378. package/dist/mdx/react/loading-dots/examples/CustomShape.tsx +7 -7
  379. package/dist/mdx/react/loading-dots/examples/Inverse.tsx +2 -2
  380. package/dist/mdx/react/loading-dots/examples/RTL.tsx +3 -7
  381. package/dist/mdx/react/menu/Menu.mdx +68 -30
  382. package/dist/mdx/react/menu/examples/Icons.tsx +11 -10
  383. package/dist/mdx/react/menu/examples/MenuWithFallbackPlacements.tsx +5 -3
  384. package/dist/mdx/react/menu/examples/Nested.tsx +0 -1
  385. package/dist/mdx/react/menu/examples/NestedDynamic.tsx +1 -1
  386. package/dist/mdx/react/menu/examples/SelectableMenu.tsx +13 -2
  387. package/dist/mdx/react/modal/Modal.mdx +94 -16
  388. package/dist/mdx/react/modal/examples/Basic.tsx +5 -4
  389. package/dist/mdx/react/modal/examples/BodyOverflow.tsx +1 -1
  390. package/dist/mdx/react/modal/examples/CustomFocus.tsx +4 -3
  391. package/dist/mdx/react/modal/examples/FormModal.tsx +28 -3
  392. package/dist/mdx/react/modal/examples/FullOverflow.tsx +1 -1
  393. package/dist/mdx/react/modal/examples/IframeTest.tsx +1 -1
  394. package/dist/mdx/react/modal/examples/ModalWithPopup.tsx +3 -3
  395. package/dist/mdx/react/modal/examples/ModalWithPopupRTL.tsx +66 -0
  396. package/dist/mdx/react/modal/examples/NoTargetRTL.tsx +49 -0
  397. package/dist/mdx/react/modal/examples/ReturnFocus.tsx +140 -41
  398. package/dist/mdx/react/modal/examples/StackedModals.tsx +1 -1
  399. package/dist/mdx/react/modal/examples/WithRadioButtons.tsx +1 -0
  400. package/dist/mdx/react/modal/examples/WithTooltips.tsx +2 -1
  401. package/dist/mdx/react/modal/examples/WithoutCloseIcon.tsx +10 -9
  402. package/dist/mdx/react/pagination/examples/Basic.tsx +0 -1
  403. package/dist/mdx/react/pagination/examples/HoistedModel.tsx +0 -1
  404. package/dist/mdx/react/pagination/examples/RTL.tsx +2 -5
  405. package/dist/mdx/react/pagination/examples/ResponsiveRange.tsx +13 -9
  406. package/dist/mdx/react/pagination/pagination.mdx +8 -6
  407. package/dist/mdx/{preview-react → react}/pill/Pill.mdx +3 -3
  408. package/dist/mdx/{preview-react → react}/pill/examples/Basic.tsx +2 -3
  409. package/dist/mdx/react/pill/examples/CustomStyles.tsx +52 -0
  410. package/dist/mdx/{preview-react → react}/pill/examples/WithAvatar.tsx +6 -4
  411. package/dist/mdx/{preview-react → react}/pill/examples/WithCount.tsx +3 -2
  412. package/dist/mdx/{preview-react → react}/pill/examples/WithList.tsx +2 -2
  413. package/dist/mdx/{preview-react → react}/pill/examples/WithReadOnly.tsx +3 -3
  414. package/dist/mdx/{preview-react → react}/pill/examples/WithRemovable.tsx +6 -5
  415. package/dist/mdx/react/popup/Popup.mdx +64 -36
  416. package/dist/mdx/react/popup/examples/Basic.tsx +22 -5
  417. package/dist/mdx/react/popup/examples/ComboboxWithinPopup.tsx +3 -3
  418. package/dist/mdx/react/popup/examples/CustomTarget.tsx +3 -2
  419. package/dist/mdx/react/popup/examples/ExternalWindow.tsx +26 -29
  420. package/dist/mdx/react/popup/examples/FocusRedirect.tsx +27 -12
  421. package/dist/mdx/react/popup/examples/FocusTrap.tsx +8 -6
  422. package/dist/mdx/react/popup/examples/FullScreen.tsx +6 -6
  423. package/dist/mdx/react/popup/examples/InitialFocus.tsx +115 -11
  424. package/dist/mdx/react/popup/examples/InlinePopup.tsx +126 -0
  425. package/dist/mdx/react/popup/examples/MixedPopupTypes.tsx +5 -4
  426. package/dist/mdx/react/popup/examples/MultiplePopups.tsx +34 -22
  427. package/dist/mdx/react/popup/examples/NestedPopups.tsx +5 -5
  428. package/dist/mdx/react/popup/examples/PopupWithFallbackPlacements.tsx +26 -18
  429. package/dist/mdx/react/popup/examples/PopupWithNonHidablePopup.tsx +1 -1
  430. package/dist/mdx/react/popup/examples/RTL.tsx +9 -9
  431. package/dist/mdx/react/popup/examples/ReturnFocusTest.tsx +4 -4
  432. package/dist/mdx/react/popup/examples/TooltipReturnFocus.tsx +5 -5
  433. package/dist/mdx/react/radio/Radio.mdx +8 -9
  434. package/dist/mdx/react/radio/examples/Basic.tsx +4 -3
  435. package/dist/mdx/react/radio/examples/Caution.tsx +2 -1
  436. package/dist/mdx/react/radio/examples/Disabled.tsx +2 -1
  437. package/dist/mdx/react/radio/examples/Error.tsx +2 -1
  438. package/dist/mdx/react/radio/examples/Inverse.tsx +3 -2
  439. package/dist/mdx/react/radio/examples/LabelPosition.tsx +2 -1
  440. package/dist/mdx/react/radio/examples/NoValue.tsx +2 -1
  441. package/dist/mdx/react/radio/examples/RefForwarding.tsx +2 -1
  442. package/dist/mdx/react/radio/examples/Required.tsx +2 -1
  443. package/dist/mdx/react/segmented-control/SegmentedControl.mdx +119 -18
  444. package/dist/mdx/react/segmented-control/examples/Basic.tsx +32 -28
  445. package/dist/mdx/{preview-react → react}/segmented-control/examples/Disabled.tsx +2 -2
  446. package/dist/mdx/{preview-react → react}/segmented-control/examples/Dynamic.tsx +3 -2
  447. package/dist/mdx/{preview-react → react}/segmented-control/examples/RTL.tsx +4 -4
  448. package/dist/mdx/{preview-react → react}/segmented-control/examples/Sizes.tsx +4 -3
  449. package/dist/mdx/{preview-react → react}/segmented-control/examples/TextAndIcon.tsx +2 -1
  450. package/dist/mdx/{preview-react → react}/segmented-control/examples/TextOnly.tsx +2 -1
  451. package/dist/mdx/{preview-react → react}/segmented-control/examples/Vertical.tsx +2 -2
  452. package/dist/mdx/react/select/Select.mdx +26 -20
  453. package/dist/mdx/react/select/examples/Basic.tsx +2 -1
  454. package/dist/mdx/react/select/examples/Caution.tsx +2 -1
  455. package/dist/mdx/react/select/examples/Complex.tsx +2 -1
  456. package/dist/mdx/react/select/examples/Controlled.tsx +3 -2
  457. package/dist/mdx/react/select/examples/Disabled.tsx +2 -1
  458. package/dist/mdx/react/select/examples/DisabledOption.tsx +2 -1
  459. package/dist/mdx/react/select/examples/Error.tsx +2 -1
  460. package/dist/mdx/react/select/examples/FetchingDynamicItems.tsx +4 -3
  461. package/dist/mdx/react/select/examples/GroupedItems.tsx +59 -0
  462. package/dist/mdx/react/select/examples/Grow.tsx +2 -1
  463. package/dist/mdx/react/select/examples/HoistedModel.tsx +1 -0
  464. package/dist/mdx/react/select/examples/InitialSelectedItem.tsx +2 -1
  465. package/dist/mdx/react/select/examples/LabelPosition.tsx +2 -1
  466. package/dist/mdx/react/select/examples/MenuHeight.tsx +1 -1
  467. package/dist/mdx/react/select/examples/Placeholder.tsx +2 -1
  468. package/dist/mdx/react/select/examples/RefForwarding.tsx +1 -0
  469. package/dist/mdx/react/select/examples/Required.tsx +2 -1
  470. package/dist/mdx/react/select/examples/WithIcons.tsx +6 -10
  471. package/dist/mdx/react/side-panel/SidePanel.mdx +287 -0
  472. package/dist/mdx/react/side-panel/examples/AlwaysOpen.tsx +50 -0
  473. package/dist/mdx/react/side-panel/examples/Basic.tsx +33 -0
  474. package/dist/mdx/react/side-panel/examples/ExternalControl.tsx +60 -0
  475. package/dist/mdx/react/side-panel/examples/Heading.tsx +43 -0
  476. package/dist/mdx/react/side-panel/examples/OnStateTransition.tsx +52 -0
  477. package/dist/mdx/react/side-panel/examples/RightOrigin.tsx +67 -0
  478. package/dist/mdx/react/side-panel/examples/Variant.tsx +51 -0
  479. package/dist/mdx/react/side-panel/examples/useDirection.ts +24 -0
  480. package/dist/mdx/react/skeleton/Skeleton.mdx +1 -1
  481. package/dist/mdx/react/skeleton/examples/Basic.tsx +8 -6
  482. package/dist/mdx/react/skeleton/examples/Color.tsx +13 -11
  483. package/dist/mdx/react/skeleton/examples/Header.tsx +1 -0
  484. package/dist/mdx/react/skeleton/examples/Shape.tsx +4 -3
  485. package/dist/mdx/react/skeleton/examples/Simulation.tsx +40 -25
  486. package/dist/mdx/react/skeleton/examples/Text.tsx +1 -0
  487. package/dist/mdx/react/status-indicator/StatusIndicator.mdx +1 -1
  488. package/dist/mdx/react/status-indicator/examples/Basic.tsx +6 -7
  489. package/dist/mdx/react/status-indicator/examples/Emphasis.tsx +6 -7
  490. package/dist/mdx/react/status-indicator/examples/Icon.tsx +3 -2
  491. package/dist/mdx/react/status-indicator/examples/MaxWidth.tsx +6 -7
  492. package/dist/mdx/react/switch/Switch.mdx +22 -9
  493. package/dist/mdx/react/switch/examples/Basic.tsx +1 -0
  494. package/dist/mdx/react/switch/examples/Caution.tsx +1 -0
  495. package/dist/mdx/react/switch/examples/Disabled.tsx +1 -0
  496. package/dist/mdx/react/switch/examples/Error.tsx +1 -0
  497. package/dist/mdx/react/switch/examples/LabelPosition.tsx +1 -0
  498. package/dist/mdx/react/switch/examples/RefForwarding.tsx +1 -0
  499. package/dist/mdx/react/table/examples/BaseHtmlTable.tsx +1 -3
  500. package/dist/mdx/react/table/examples/Basic.tsx +1 -3
  501. package/dist/mdx/react/table/examples/BasicWithHeading.tsx +3 -5
  502. package/dist/mdx/react/table/examples/FixedColumn.tsx +8 -8
  503. package/dist/mdx/react/table/examples/RightToLeft.tsx +3 -5
  504. package/dist/mdx/react/tabs/Tabs.mdx +10 -9
  505. package/dist/mdx/react/tabs/examples/AlternativeTabStop.tsx +3 -4
  506. package/dist/mdx/react/tabs/examples/Basic.tsx +3 -3
  507. package/dist/mdx/react/tabs/examples/DisabledTab.tsx +3 -3
  508. package/dist/mdx/react/tabs/examples/DynamicTabs.tsx +2 -1
  509. package/dist/mdx/react/tabs/examples/HoistedModel.tsx +3 -4
  510. package/dist/mdx/react/tabs/examples/Icons.tsx +4 -5
  511. package/dist/mdx/react/tabs/examples/NamedTabs.tsx +3 -3
  512. package/dist/mdx/react/tabs/examples/OverflowTabs.tsx +2 -2
  513. package/dist/mdx/react/tabs/examples/RightToLeft.tsx +5 -5
  514. package/dist/mdx/react/tabs/examples/SinglePanel.tsx +2 -4
  515. package/dist/mdx/react/testing/examples/Basic.tsx +3 -3
  516. package/dist/mdx/react/text/LabelText.mdx +1 -1
  517. package/dist/mdx/react/text/Text.mdx +1 -1
  518. package/dist/mdx/react/text/examples/BodyText/Basic.tsx +1 -0
  519. package/dist/mdx/react/text/examples/Heading/Basic.tsx +1 -0
  520. package/dist/mdx/react/text/examples/LabelText/Basic.tsx +1 -0
  521. package/dist/mdx/react/text/examples/LabelText/Cursor.tsx +1 -0
  522. package/dist/mdx/react/text/examples/LabelText/Disabled.tsx +3 -5
  523. package/dist/mdx/react/text/examples/Subtext/Basic.tsx +1 -0
  524. package/dist/mdx/react/text/examples/Text/Basic.tsx +12 -7
  525. package/dist/mdx/react/text/examples/Title/Basic.tsx +1 -0
  526. package/dist/mdx/react/text-area/TextArea.mdx +44 -18
  527. package/dist/mdx/react/text-area/examples/Basic.tsx +1 -0
  528. package/dist/mdx/react/text-area/examples/Disabled.tsx +1 -0
  529. package/dist/mdx/react/text-area/examples/Grow.tsx +1 -0
  530. package/dist/mdx/react/text-area/examples/LabelPosition.tsx +1 -0
  531. package/dist/mdx/react/text-area/examples/Placeholder.tsx +1 -0
  532. package/dist/mdx/react/text-area/examples/RefForwarding.tsx +1 -0
  533. package/dist/mdx/react/text-area/examples/Required.tsx +1 -0
  534. package/dist/mdx/react/text-area/examples/ResizeConstraints.tsx +1 -0
  535. package/dist/mdx/react/text-input/TextInput.mdx +43 -18
  536. package/dist/mdx/react/text-input/examples/Basic.tsx +1 -0
  537. package/dist/mdx/react/text-input/examples/Disabled.tsx +1 -0
  538. package/dist/mdx/react/text-input/examples/Grow.tsx +1 -0
  539. package/dist/mdx/react/text-input/examples/Icons.tsx +25 -21
  540. package/dist/mdx/react/text-input/examples/LabelPosition.tsx +1 -0
  541. package/dist/mdx/react/text-input/examples/Placeholder.tsx +1 -0
  542. package/dist/mdx/react/text-input/examples/RefForwarding.tsx +1 -0
  543. package/dist/mdx/react/text-input/examples/Required.tsx +1 -0
  544. package/dist/mdx/react/toast/examples/Basic.tsx +2 -1
  545. package/dist/mdx/react/toast/examples/RTL.tsx +4 -6
  546. package/dist/mdx/react/toast/examples/ToastAlert.tsx +2 -2
  547. package/dist/mdx/react/toast/examples/ToastDialog.tsx +2 -1
  548. package/dist/mdx/react/toast/examples/WithActionLinkAndCloseIcon.tsx +2 -4
  549. package/dist/mdx/react/toast/examples/WithPopper.tsx +4 -4
  550. package/dist/mdx/react/toast/toast.mdx +4 -3
  551. package/dist/mdx/react/tokens/Tokens.mdx +1 -1
  552. package/dist/mdx/react/tokens/examples/Overview.tsx +2 -2
  553. package/dist/mdx/react/tokens/examples/Tokens.tsx +4 -4
  554. package/dist/mdx/react/tooltip/Tooltip.mdx +31 -13
  555. package/dist/mdx/react/tooltip/examples/Default.tsx +1 -1
  556. package/dist/mdx/react/tooltip/examples/DescriptionType.tsx +3 -3
  557. package/dist/mdx/react/tooltip/examples/Ellipsis.tsx +8 -8
  558. package/dist/mdx/react/tooltip/examples/Placements.tsx +13 -14
  559. package/dist/mdx/react/tooltip/examples/UseTooltip.tsx +2 -2
  560. package/dist/mdx/style-props/STYLE_PROPS.mdx +1 -1
  561. package/dist/mdx/style-props/stylePropsMigrationCodemod.mdx +1 -1
  562. package/dist/mdx/style-props/stylePropsMigrationOverview.mdx +20 -20
  563. package/dist/mdx/styling/mdx/CreateStyles.mdx +32 -31
  564. package/dist/mdx/styling/mdx/CustomizingStyles.mdx +4 -4
  565. package/dist/mdx/styling/mdx/MergingStyles.mdx +6 -4
  566. package/dist/mdx/styling/mdx/Overview.mdx +15 -15
  567. package/dist/mdx/styling/mdx/Stencils.mdx +32 -30
  568. package/dist/mdx/styling/mdx/Utilities.mdx +135 -27
  569. package/dist/mdx/styling/mdx/examples/CSProp.tsx +7 -9
  570. package/dist/mdx/styling/mdx/examples/CreateModifiers.tsx +1 -1
  571. package/dist/mdx/styling/mdx/examples/CreateStencil.tsx +10 -9
  572. package/dist/mdx/styling/mdx/examples/CreateStyles.tsx +2 -4
  573. package/dist/mdx/styling/mdx/examples/CustomButton.tsx +16 -23
  574. package/dist/mdx/styling/mdx/examples/CustomIcon.tsx +5 -6
  575. package/dist/mdx/styling/mdx/examples/EmotionButton.tsx +1 -1
  576. package/dist/mdx/styling/mdx/examples/ManualStylesButton.tsx +1 -0
  577. package/dist/mdx/styling/mdx/examples/StyledButton.tsx +13 -15
  578. package/dist/mdx/styling/mdx/examples/StylingButton.tsx +2 -1
  579. package/dist/mdx/styling/mdx/examples/StylingOverrides.tsx +10 -10
  580. package/dist/mdx/tokens/TokenMigrationCodemod.mdx +9 -0
  581. package/dist/mdx/tokens/TokenMigrationFinal.mdx +35 -30
  582. package/dist/mdx/tokens/TokenMigrationInstall.mdx +17 -14
  583. package/dist/mdx/tokens/TokenMigrationMappingColors.mdx +434 -288
  584. package/dist/mdx/tokens/TokenMigrationMappingSystem.mdx +51 -199
  585. package/dist/mdx/tokens/TokenMigrationOverview.mdx +23 -41
  586. package/dist/mdx/welcome.mdx +14 -16
  587. package/lib/DescriptionTooltip.tsx +16 -11
  588. package/lib/DownloadLLMFile.tsx +12 -12
  589. package/lib/ExampleCodeBlock.tsx +38 -28
  590. package/lib/MDXElements.tsx +6 -5
  591. package/lib/MoreTooltip.tsx +12 -10
  592. package/lib/Specifications.tsx +30 -17
  593. package/lib/StorybookStatusIndicator.tsx +32 -20
  594. package/lib/StylePropsTable.tsx +2 -1
  595. package/lib/SymbolDoc.tsx +2 -1
  596. package/lib/Table.tsx +37 -39
  597. package/lib/Value.tsx +22 -15
  598. package/lib/docs.ts +1 -0
  599. package/lib/stackblitzFiles/App.tsx +7 -21
  600. package/lib/stackblitzFiles/main.tsx +6 -4
  601. package/lib/stackblitzFiles/packageJSONFile.ts +4 -2
  602. package/lib/stackblitzFiles/types/custom-imports.d.ts +0 -9
  603. package/lib/stackblitzFiles/vite.config.ts +1 -3
  604. package/lib/widgetUtils.tsx +42 -43
  605. package/lib/widgets/array.tsx +1 -1
  606. package/lib/widgets/callExpression.tsx +1 -2
  607. package/lib/widgets/canvasColor.tsx +2 -2
  608. package/lib/widgets/conditional.tsx +1 -1
  609. package/lib/widgets/enhancedComponent.tsx +12 -8
  610. package/lib/widgets/external.tsx +1 -2
  611. package/lib/widgets/function.tsx +3 -3
  612. package/lib/widgets/index.ts +1 -1
  613. package/lib/widgets/intersection.tsx +1 -1
  614. package/lib/widgets/model.tsx +1 -1
  615. package/lib/widgets/parenthesis.tsx +1 -1
  616. package/lib/widgets/primitives.tsx +3 -2
  617. package/lib/widgets/qualifiedName.tsx +1 -1
  618. package/lib/widgets/tuple.tsx +1 -1
  619. package/lib/widgets/typeParameter.tsx +1 -1
  620. package/lib/widgets/union.tsx +1 -1
  621. package/package.json +14 -12
  622. package/webpack/extract-exports.js +2 -1
  623. package/dist/mdx/labs-react/combobox/Combobox.mdx +0 -68
  624. package/dist/mdx/labs-react/combobox/examples/Basic.tsx +0 -88
  625. package/dist/mdx/labs-react/combobox/examples/DisabledItem.tsx +0 -88
  626. package/dist/mdx/labs-react/combobox/examples/GroupOfResult.tsx +0 -88
  627. package/dist/mdx/labs-react/combobox/examples/Grow.tsx +0 -88
  628. package/dist/mdx/labs-react/combobox/examples/NoClearButton.tsx +0 -88
  629. package/dist/mdx/labs-react/combobox/examples/RTL.tsx +0 -90
  630. package/dist/mdx/labs-react/search-form/SearchForm.mdx +0 -92
  631. package/dist/mdx/labs-react/search-form/examples/Basic.tsx +0 -63
  632. package/dist/mdx/labs-react/search-form/examples/Collapsed.tsx +0 -64
  633. package/dist/mdx/labs-react/search-form/examples/CustomStyles.tsx +0 -91
  634. package/dist/mdx/labs-react/search-form/examples/CustomTheme.tsx +0 -73
  635. package/dist/mdx/labs-react/search-form/examples/Grow.tsx +0 -64
  636. package/dist/mdx/labs-react/search-form/examples/RTL.tsx +0 -72
  637. package/dist/mdx/labs-react/search-form/examples/Theming.tsx +0 -66
  638. package/dist/mdx/preview-react/avatar/examples/Basic.tsx +0 -5
  639. package/dist/mdx/preview-react/avatar/examples/nicholas-avatar.png +0 -0
  640. package/dist/mdx/preview-react/information-highlight/InformationHighlight.mdx +0 -109
  641. package/dist/mdx/preview-react/pill/examples/CustomStyles.tsx +0 -53
  642. package/dist/mdx/preview-react/segmented-control/SegmentedControl.mdx +0 -139
  643. package/dist/mdx/preview-react/segmented-control/examples/Basic.tsx +0 -42
  644. package/dist/mdx/preview-react/select/Select.mdx +0 -107
  645. package/dist/mdx/preview-react/select/examples/Left Label/AlertLeft.tsx +0 -18
  646. package/dist/mdx/preview-react/select/examples/Left Label/DefaultLeft.tsx +0 -17
  647. package/dist/mdx/preview-react/select/examples/Left Label/DefaultWithCustomOptionsLeft.tsx +0 -25
  648. package/dist/mdx/preview-react/select/examples/Left Label/DefaultWithSimpleOptionsLeft.tsx +0 -17
  649. package/dist/mdx/preview-react/select/examples/Left Label/DisabledLeft.tsx +0 -19
  650. package/dist/mdx/preview-react/select/examples/Left Label/ErrorLeft.tsx +0 -18
  651. package/dist/mdx/preview-react/select/examples/Left Label/GrowLeft.tsx +0 -17
  652. package/dist/mdx/preview-react/select/examples/Left Label/ScrollableLeft.tsx +0 -17
  653. package/dist/mdx/preview-react/select/examples/Left Label/index.ts +0 -8
  654. package/dist/mdx/preview-react/select/examples/Top Label/Caution.tsx +0 -16
  655. package/dist/mdx/preview-react/select/examples/Top Label/Default.tsx +0 -15
  656. package/dist/mdx/preview-react/select/examples/Top Label/DefaultWithCustomOptions.tsx +0 -23
  657. package/dist/mdx/preview-react/select/examples/Top Label/DefaultWithSimpleOptions.tsx +0 -15
  658. package/dist/mdx/preview-react/select/examples/Top Label/Disabled.tsx +0 -17
  659. package/dist/mdx/preview-react/select/examples/Top Label/Error.tsx +0 -16
  660. package/dist/mdx/preview-react/select/examples/Top Label/Grow.tsx +0 -15
  661. package/dist/mdx/preview-react/select/examples/Top Label/Scrollable.tsx +0 -13
  662. package/dist/mdx/preview-react/select/examples/Top Label/index.ts +0 -8
  663. package/dist/mdx/preview-react/select/examples/storiesData.tsx +0 -92
  664. package/dist/mdx/react/_examples/mdx/examples/SegmentControlWithText.tsx +0 -119
  665. package/dist/mdx/react/avatar/avatar/Avatar.mdx +0 -109
  666. package/dist/mdx/react/avatar/avatar/examples/Basic.tsx +0 -17
  667. package/dist/mdx/react/avatar/avatar/examples/Button.tsx +0 -20
  668. package/dist/mdx/react/avatar/avatar/examples/CustomStyles.tsx +0 -34
  669. package/dist/mdx/react/avatar/avatar/examples/Image.tsx +0 -25
  670. package/dist/mdx/react/avatar/avatar/examples/LazyLoad.tsx +0 -20
  671. package/dist/mdx/react/avatar/avatar/examples/ObjectFit.tsx +0 -30
  672. package/dist/mdx/react/avatar/avatar/examples/Size.tsx +0 -27
  673. package/dist/mdx/react/avatar/avatar/examples/Variant.tsx +0 -10
  674. package/dist/mdx/react/avatar/avatar/examples/test-avatar.png +0 -0
  675. package/dist/mdx/react/icon/examples/Overview.tsx +0 -42
  676. package/dist/mdx/react/text-area/examples/Caution.tsx +0 -21
  677. package/dist/mdx/react/text-area/examples/Error.tsx +0 -21
  678. package/dist/mdx/react/text-input/examples/Caution.tsx +0 -21
  679. package/dist/mdx/react/text-input/examples/Error.tsx +0 -21
  680. /package/dist/mdx/accessibility/{AccessibilityTesting.mdx → TestingTableWithFormFields.mdx} +0 -0
  681. /package/dist/mdx/{preview-react → react}/pill/examples/test-avatar.png +0 -0
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  ExampleCodeBlock,
3
- InformationHighlight,
4
- SymbolDoc,
5
3
  Specifications,
4
+ SymbolDoc,
6
5
  } from '@workday/canvas-kit-docs';
6
+
7
7
  import Basic from './examples/Basic';
8
8
  import LabelPosition from './examples/LabelPosition';
9
9
  import RefForwarding from './examples/RefForwarding';
@@ -47,4 +47,4 @@ input component. By default, the orientation will be set to `vertical`.
47
47
 
48
48
  ## Specifications
49
49
 
50
- <Specifications file="ColorPicker.spec.ts" name="ColorPreview" />
50
+ <Specifications file="./cypress/component/ColorPicker.spec.tsx" name="ColorPreview" />
@@ -1,6 +1,7 @@
1
1
  import React from 'react';
2
- import {FormField} from '@workday/canvas-kit-react/form-field';
2
+
3
3
  import {ColorPreview} from '@workday/canvas-kit-react/color-picker';
4
+ import {FormField} from '@workday/canvas-kit-react/form-field';
4
5
 
5
6
  export default () => {
6
7
  return (
@@ -1,8 +1,9 @@
1
1
  import React from 'react';
2
+
2
3
  import {PrimaryButton} from '@workday/canvas-kit-react/button';
3
- import {FormField} from '@workday/canvas-kit-react/form-field';
4
4
  import {ColorPreview} from '@workday/canvas-kit-react/color-picker';
5
- import {type} from '@workday/canvas-kit-react/tokens';
5
+ import {FormField} from '@workday/canvas-kit-react/form-field';
6
+ import {Subtext} from '@workday/canvas-kit-react/text';
6
7
 
7
8
  export default () => {
8
9
  const [width, setWidth] = React.useState(null);
@@ -20,7 +21,7 @@ export default () => {
20
21
  <FormField.Input as={ColorPreview} ref={ref} value="#00ffcc" />
21
22
  </FormField.Field>
22
23
  </FormField>
23
- <p style={type.levels.subtext.large}>Width of Color Preview: {width}</p>
24
+ <Subtext size="large">Width of Color Preview: {width}</Subtext>
24
25
  <PrimaryButton onClick={handleClick}>Calculate Width of Color Preview</PrimaryButton>
25
26
  </>
26
27
  );
@@ -1,21 +1,21 @@
1
1
  import React from 'react';
2
2
 
3
- import {
4
- createElemPropsHook,
5
- createSubcomponent,
6
- composeHooks,
7
- } from '@workday/canvas-kit-react/common';
8
3
  import {LoadReturn} from '@workday/canvas-kit-react/collection';
9
4
  import {
10
5
  Combobox,
11
- useComboboxModel,
12
- useComboboxLoader,
13
6
  useComboboxInput,
14
7
  useComboboxInputArbitrary,
8
+ useComboboxLoader,
9
+ useComboboxModel,
15
10
  } from '@workday/canvas-kit-react/combobox';
11
+ import {
12
+ composeHooks,
13
+ createElemPropsHook,
14
+ createSubcomponent,
15
+ } from '@workday/canvas-kit-react/common';
16
16
  import {FormField} from '@workday/canvas-kit-react/form-field';
17
- import {StyledMenuItem} from '@workday/canvas-kit-react/menu';
18
17
  import {LoadingDots} from '@workday/canvas-kit-react/loading-dots';
18
+ import {StyledMenuItem} from '@workday/canvas-kit-react/menu';
19
19
  import {InputGroup, TextInput} from '@workday/canvas-kit-react/text-input';
20
20
  import {createStencil, px2rem} from '@workday/canvas-kit-styling';
21
21
  import {system} from '@workday/canvas-tokens-web';
@@ -28,6 +28,8 @@ const options = Array(1000)
28
28
  return `${colors[index % colors.length]} ${fruits[index % fruits.length]} ${index + 1}`;
29
29
  });
30
30
 
31
+ const simulatedDelay = (window as any).Cypress ? 5 : 300;
32
+
31
33
  const useAutocompleteInput = composeHooks(
32
34
  createElemPropsHook(useComboboxModel)(model => {
33
35
  return {
@@ -113,7 +115,7 @@ export default () => {
113
115
  items,
114
116
  total,
115
117
  });
116
- }, 300);
118
+ }, simulatedDelay);
117
119
  });
118
120
  },
119
121
  onShow() {
@@ -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,5 @@
1
1
  import {ExampleCodeBlock} from '@workday/canvas-kit-docs';
2
+
2
3
  import RTL from './examples/RTL';
3
4
  import Theming from './examples/Theming';
4
5
 
@@ -7,9 +8,22 @@ import Theming from './examples/Theming';
7
8
 
8
9
  ## Overview
9
10
 
10
- Canvas Kit v14 introduces a significant shift in our approach to theming: we've moved away from
11
- JavaScript-based theme objects to CSS variables. This change provides better performance, improved
12
- developer experience, and greater flexibility for theming applications.
11
+ Canvas Kit v14 and v15 introduce a significant shift in our approach to theming: we've moved away
12
+ from JavaScript-based theme objects to CSS variables. This change provides better performance,
13
+ improved developer experience, and greater flexibility for theming applications.
14
+
15
+ > **📌 Quick Start:**
16
+ >
17
+ > 1. **Import CSS variables once** at the root level of your application (e.g., in `index.css`)
18
+ > 2. **Override tokens at `:root`** for global theming — this is the recommended approach
19
+ > 3. **Use `CanvasProvider` scoped theming only** for specific scenarios like multi-brand sections
20
+ > or embedded components
21
+ >
22
+ > If your application renders within an environment that already imports these CSS variables, **do
23
+ > not re-import them**.
24
+
25
+ View our latest tokens documentation
26
+ [here](https://workday.github.io/canvas-tokens/?path=/docs/docs-getting-started--docs).
13
27
 
14
28
  ## Migration from v10 Theme Prop to v14 CSS Variables
15
29
 
@@ -47,6 +61,8 @@ via a `className` scoping those brand variables to a wrapping div. In order for
47
61
  better solution to theming that is scalable and is more aligned with our CSS variables, we changed
48
62
  this approach.
49
63
 
64
+ **Note:** While we support theme overrides, we advise to use global theming via CSS Variables.
65
+
50
66
  ## What is a Cascade Barrier?
51
67
 
52
68
  When we say "cascade barrier", we're talking about how
@@ -69,9 +85,59 @@ and scoped to the `div` that the `CanvasProvider` created. This meant that anyth
69
85
  or outside of the `CanvasProvider` would not be able to cascade down to the components within the
70
86
  `CanvasProvider`.
71
87
 
88
+ If you provide a `theme` to the `CanvasProvider`, it will create a scoped theme. Note that in v14
89
+ and v15, global CSS variables are the recommended way to theme Popups and Modals consistently.
90
+
91
+ ## Global vs Scoped Theming
92
+
93
+ Canvas Kit v14 and v15 support two theming strategies: **global theming** and **scoped theming**.
94
+ Understanding the difference is important to avoid unexpected behavior.
95
+
96
+ ### Global Theming
97
+
98
+ Global theming applies CSS variables at the `:root` level, making them available throughout your
99
+ entire application. This is the **recommended approach** for most use cases.
100
+
101
+ ```css
102
+ @import '@workday/canvas-tokens-web/css/base/_variables.css';
103
+ :root {
104
+ // This is showing how you can change the value of a token at the root level of your application.
105
+ --cnvs-brand-primary-600: var(--cnvs-base-palette-magenta-600);
106
+ }
107
+ ```
108
+
109
+ ### Scoped Theming
110
+
111
+ Scoped theming applies CSS variables to a specific section of your application using the
112
+ `CanvasProvider` via the `theme` prop. The theme only affects components within that provider.
113
+
114
+ ```tsx
115
+ // Using the theme prop for scoped theming. This will set the [brand.primary.**] tokens to shades of purple. This will also ensure that the Popup and Modal components are themed consistently.
116
+ <CanvasProvider theme={{canvas: {palette: {primary: {main: 'purple'}}}}}>
117
+ <ScopedSection />
118
+ </CanvasProvider>
119
+ ```
120
+
121
+ > **⚠️ Warning:** Scoped theming creates a cascade barrier that **will break global theming**. Any
122
+ > CSS variables defined at `:root` will be overridden by the scoped theme. Only the tokens
123
+ > explicitly defined in the `theme` prop will be changed - other tokens will use their default
124
+ > values, not your global overrides.
125
+
126
+ ### When to Use Scoped Theming
127
+
128
+ Only use scoped theming when you intentionally need a different theme for a specific section of your
129
+ application, such as:
130
+
131
+ - Embedding a Canvas Kit component in a third-party application with a different brand
132
+ - Creating a preview panel that shows components with different themes
133
+ - Supporting multi-tenant applications where sections have different branding
134
+
135
+ For all other cases, use global theming at `:root` to ensure consistent theming throughout your
136
+ application.
137
+
72
138
  ## ✅ Preferred Approach (v14+)
73
139
 
74
- Canvas Kit v14 promotes using CSS variables for theming, which can be applied in two ways:
140
+ Canvas Kit v14 and v15 promote using CSS variables for theming, which can be applied in two ways:
75
141
 
76
142
  ### Method 1: Global CSS Variables (Recommended)
77
143
 
@@ -83,16 +149,16 @@ CSS:
83
149
  @import '@workday/canvas-tokens-web/css/base/_variables.css';
84
150
  @import '@workday/canvas-tokens-web/css/system/_variables.css';
85
151
  @import '@workday/canvas-tokens-web/css/brand/_variables.css';
152
+ @import '@workday/canvas-tokens-web/css/component/_variables.css';
86
153
 
87
154
  :root {
88
155
  /* Override brand primary colors */
89
- --cnvs-brand-primary-base: var(--cnvs-base-palette-magenta-600);
90
- --cnvs-brand-primary-light: var(--cnvs-base-palette-magenta-200);
91
- --cnvs-brand-primary-lighter: var(--cnvs-base-palette-magenta-50);
92
- --cnvs-brand-primary-lightest: var(--cnvs-base-palette-magenta-25);
93
- --cnvs-brand-primary-dark: var(--cnvs-base-palette-magenta-700);
94
- --cnvs-brand-primary-darkest: var(--cnvs-base-palette-magenta-800);
95
- --cnvs-brand-primary-accent: var(--cnvs-base-palette-neutral-0);
156
+ --cnvs-brand-primary-600: var(--cnvs-base-palette-magenta-600);
157
+ --cnvs-brand-primary-200: var(--cnvs-base-palette-magenta-200);
158
+ --cnvs-brand-primary-50: var(--cnvs-base-palette-magenta-50);
159
+ --cnvs-brand-primary-25: var(--cnvs-base-palette-magenta-25);
160
+ --cnvs-brand-primary-700: var(--cnvs-base-palette-magenta-700);
161
+ --cnvs-brand-primary-800: var(--cnvs-base-palette-magenta-800);
96
162
  }
97
163
  ```
98
164
 
@@ -102,36 +168,16 @@ CSS:
102
168
 
103
169
  ### Method 2: Provider-Level CSS Variables
104
170
 
105
- Use Canvas Kit's `createStyles` utility to generate themed class names that can be applied to
106
- specific components or sections:
107
-
108
- > **Note:** Doing the following **will create a cascade barrier**. Only use this method if you
109
- > intentionally want to override the default theme.
171
+ Use Canvas Kit's `CanvasProvider` and `theme` prop to generate themed class names that can be
172
+ applied to specific components or sections:
110
173
 
111
174
  ```tsx
112
- import {createStyles}from "@workday/canvas-kit-styling"
113
- import {brand, base} from "@workday/canvas-tokens-web"
114
- import {CanvasProvider} from "@workday/canvas-kit-react/common"
115
-
116
- // You can import the CSS variables in a ts file or an index.css file. You do not need to do both.
117
- import '@workday/canvas-tokens-web/css/base/_variables.css';
118
- import '@workday/canvas-tokens-web/css/system/_variables.css';
119
- import '@workday/canvas-tokens-web/css/brand/_variables.css';
120
-
121
- // Generate a class name that defines CSS variables
122
- const themedBrand = createStyles({
123
- [brand.primary.accent]: base.neutral0,
124
- [brand.primary.darkest]: base.blue800,
125
- [brand.primary.dark]: base.blue700,
126
- [brand.primary.base]: base.blue600,
127
- [brand.primary.light]: base.blue200,
128
- [brand.primary.lighter]: base.blue50,
129
- [brand.primary.lightest]: base.blue25,
130
- })
175
+ import {CanvasProvider} from '@workday/canvas-kit-react/common';
131
176
 
132
- <CanvasProvider className={themedBrand}>
133
- <App/>
134
- </CanvasProvider>
177
+ // This will set the [brand.primary.**] tokens to shades of purple. This will also ensure that the Popup and Modal components are themed consistently.
178
+ <CanvasProvider theme={{canvas: {palette: {primary: {main: 'purple'}}}}}>
179
+ <App />
180
+ </CanvasProvider>;
135
181
  ```
136
182
 
137
183
  ## CSS Token Structure
@@ -154,10 +200,12 @@ Base tokens define foundation palette and design values.
154
200
  Brand tokens define semantic color assignments.
155
201
 
156
202
  ```css
157
- --cnvs-brand-primary-base: var(--cnvs-base-palette-blue-600);
158
- --cnvs-brand-primary-accent: var(--cnvs-base-palette-neutral-0);
159
- --cnvs-brand-error-base: var(--cnvs-base-palette-red-600);
160
- --cnvs-brand-success-base: var(--cnvs-base-palette-green-600);
203
+ --cnvs-brand-primary-600: var(--cnvs-base-palette-blue-600);
204
+ --cnvs-brand-primary-200: var(--cnvs-base-palette-blue-200);
205
+ --cnvs-brand-primary-50: var(--cnvs-base-palette-blue-50);
206
+ --cnvs-brand-primary-25: var(--cnvs-base-palette-blue-25);
207
+ --cnvs-brand-primary-700: var(--cnvs-base-palette-blue-700);
208
+ --cnvs-brand-primary-800: var(--cnvs-base-palette-blue-800);
161
209
  ```
162
210
 
163
211
  ### System Tokens (`system/_variables.css`)
@@ -165,9 +213,8 @@ Brand tokens define semantic color assignments.
165
213
  System tokens define component-specific values.
166
214
 
167
215
  ```css
168
- --cnvs-sys-color-bg-primary-default: var(--cnvs-base-palette-blue-600);
169
- --cnvs-sys-color-text-primary-default: var(--cnvs-base-palette-blue-600);
170
- --cnvs-sys-space-x4: calc(var(--cnvs-base-unit) * 4);
216
+ --cnvs-sys-color-bg-default: var(--cnvs-base-palette-blue-600);
217
+ --cnvs-sys-shape-sm: var(--cnvs-base-size-50);
171
218
  ```
172
219
 
173
220
  ## Practical Examples
@@ -182,59 +229,89 @@ System tokens define component-specific values.
182
229
 
183
230
  :root {
184
231
  /* Primary brand colors */
185
- --cnvs-brand-primary-base: var(--cnvs-base-palette-magenta-600);
186
- --cnvs-brand-primary-light: var(--cnvs-base-palette-magenta-200);
187
- --cnvs-brand-primary-lighter: var(--cnvs-base-palette-magenta-50);
188
- --cnvs-brand-primary-lightest: var(--cnvs-base-palette-magenta-25);
189
- --cnvs-brand-primary-dark: var(--cnvs-base-palette-magenta-700);
190
- --cnvs-brand-primary-darkest: var(--cnvs-base-palette-magenta-800);
191
- --cnvs-brand-primary-accent: var(--cnvs-base-palette-neutral-0);
232
+ --cnvs-brand-primary-600: var(--cnvs-base-palette-magenta-600);
233
+ --cnvs-brand-primary-200: var(--cnvs-base-palette-magenta-200);
234
+ --cnvs-brand-primary-50: var(--cnvs-base-palette-magenta-50);
235
+ --cnvs-brand-primary-25: var(--cnvs-base-palette-magenta-25);
236
+ --cnvs-brand-primary-700: var(--cnvs-base-palette-magenta-700);
237
+ --cnvs-brand-primary-800: var(--cnvs-base-palette-magenta-800);
192
238
  }
193
239
  ```
194
240
 
195
- ### App-Specific Theming
241
+ ### Scoped Theming
242
+
243
+ <ExampleCodeBlock code={Theming} />
244
+
245
+ ### RTL Support
246
+
247
+ Canvas Kit supports RTL out of the box. Our components are styled to use
248
+ [CSS logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
249
+ If you want to add additional styles based on RTL, you can also use the `:dir`
250
+ [pseudo selector](https://developer.mozilla.org/en-US/docs/Web/CSS/:dir).
251
+
252
+ #### Setting RTL Direction
253
+
254
+ Use the native HTML `dir` attribute to set the text direction. The `CanvasProvider` accepts a `dir`
255
+ prop which sets this attribute on its wrapper element:
196
256
 
197
257
  ```tsx
198
- import {createStyles} from '@workday/canvas-kit-styling';
199
- import {brand, base} from '@workday/canvas-tokens-web';
200
- import {PrimaryButton} from '@workday/canvas-kit-react/button';
201
258
  import {CanvasProvider} from '@workday/canvas-kit-react/common';
202
259
 
203
- const greenTheme = createStyles({
204
- [brand.primary.base]: base.green600,
205
- [brand.primary.dark]: base.green700,
206
- [brand.primary.darkest]: base.green800,
207
- [brand.primary.light]: base.green200,
208
- [brand.primary.lighter]: base.green50,
209
- [brand.primary.lightest]: base.green25,
210
- [brand.primary.accent]: base.neutral0,
211
- });
212
-
213
- <CanvasProvider className={greenTheme}>
214
- <PrimaryButton>Click me</PrimaryButton>
260
+ // Set RTL direction
261
+ <CanvasProvider dir="rtl">
262
+ <App />
215
263
  </CanvasProvider>;
216
264
  ```
217
265
 
218
- <ExampleCodeBlock code={Theming} />
266
+ You can also set it on any HTML element:
219
267
 
220
- ### Dark Mode Implementation
268
+ ```tsx
269
+ <div dir="rtl">
270
+ <MyComponent />
271
+ </div>
272
+ ```
273
+
274
+ > **Note:** The `dir` attribute is the standard HTML way to set text direction. It's preferred over
275
+ > the deprecated `theme.canvas.direction` approach because it works natively with CSS logical
276
+ > properties and the `:dir()` pseudo-class.
277
+
278
+ #### Using CSS Logical Properties
279
+
280
+ CSS logical properties automatically adapt to the text direction. Use these instead of physical
281
+ properties:
221
282
 
222
283
  ```css
223
- /* Dark mode theming */
224
- [data-theme='dark'] {
225
- --cnvs-sys-color-bg-default: var(--cnvs-base-palette-neutral-950);
226
- --cnvs-sys-color-text-default: var(--cnvs-base-palette-neutral-50);
227
- --cnvs-sys-color-border-container: var(--cnvs-base-palette-slate-700);
228
- --cnvs-sys-color-bg-alt-default: var(--cnvs-base-palette-slate-800);
284
+ /* Physical properties (don't adapt to RTL) */
285
+ .my-component {
286
+ margin-left: 1rem;
287
+ padding-right: 1rem;
288
+ border-left: 1px solid;
289
+ }
290
+
291
+ /* Logical properties (adapt to RTL automatically) */
292
+ .my-component {
293
+ margin-inline-start: 1rem;
294
+ padding-inline-end: 1rem;
295
+ border-inline-start: 1px solid;
229
296
  }
230
297
  ```
231
298
 
232
- ### RTL Support
299
+ #### Conditional RTL Styles with `:dir()`
233
300
 
234
- Canvas Kit supports RTL out of the box. Our components are styled to use
235
- [CSS logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
236
- If you want to add additional styles based on RTL, you can also use the `:dir`
237
- [pseudo selector](https://developer.mozilla.org/en-US/docs/Web/CSS/:dir).
301
+ For styles that need to change based on direction (like rotating icons), use the `:dir()`
302
+ pseudo-class:
303
+
304
+ ```tsx
305
+ import {createStyles} from '@workday/canvas-kit-styling';
306
+
307
+ const rtlButtonStyles = createStyles({
308
+ ':dir(rtl)': {
309
+ svg: {
310
+ transform: 'rotate(180deg)',
311
+ },
312
+ },
313
+ });
314
+ ```
238
315
 
239
316
  <ExampleCodeBlock code={RTL} />
240
317
 
@@ -295,31 +372,11 @@ const theme = {
295
372
  Replace theme-based `CanvasProvider` usage with CSS class-based theming.
296
373
 
297
374
  ```tsx
298
- // Before:
299
- <CanvasProvider theme={customTheme}>
300
- <App />
301
- </CanvasProvider>
302
-
303
- // After:
304
- <CanvasProvider className={customThemeClass}>
375
+ <CanvasProvider theme={{canvas: {palette: {primary: {main: 'green'}}}}}>
305
376
  <App />
306
377
  </CanvasProvider>
307
378
  ```
308
379
 
309
- > **Note:** Using a class means you will need to define each property of the palette for full
310
- > control over theming.
311
-
312
- ### Step 4: Test Component Rendering
313
-
314
- Verify that Canvas Kit components (like `PrimaryButton`) correctly use the new CSS variables.
315
-
316
- ```tsx
317
- import {PrimaryButton} from '@workday/canvas-kit-react/button';
318
-
319
- // This should automatically use your CSS variable overrides
320
- <PrimaryButton>Themed Button</PrimaryButton>;
321
- ```
322
-
323
380
  ## Best Practices
324
381
 
325
382
  ### 1. Use Semantic Token Names
@@ -328,7 +385,7 @@ Use brand tokens instead of base tokens for better maintainability.
328
385
 
329
386
  ```css
330
387
  /* ✅ Good - semantic meaning */
331
- --cnvs-brand-primary-base: var(--cnvs-base-palette-blue-600);
388
+ --cnvs-brand-primary-600: var(--cnvs-base-palette-blue-600);
332
389
 
333
390
  /* ❌ Avoid - direct base token usage */
334
391
  --cnvs-base-palette-blue-600: blue;
@@ -338,13 +395,8 @@ Use brand tokens instead of base tokens for better maintainability.
338
395
 
339
396
  Ensure color combinations meet accessibility standards.
340
397
 
341
- ```css
342
- /* Verify contrast ratios for text/background combinations */
343
- :root {
344
- --cnvs-brand-primary-base: var(--cnvs-base-palette-blue-600);
345
- --cnvs-brand-primary-accent: var(--cnvs-base-palette-neutral-0); /* White text */
346
- }
347
- ```
398
+ For a full list of color contrast pairs, view our
399
+ [Color Contrast](https://canvas.workday.com/guidelines/color/color-contrast) documentation.
348
400
 
349
401
  ### 3. Avoid Component Level Theming
350
402
 
@@ -354,15 +406,11 @@ component level.
354
406
  ```tsx
355
407
  /* ✅ Good - App level theming */
356
408
  import {CanvasProvider} from '@workday/canvas-kit-react/common';
357
- import {createStyles} from '@workday/canvas-kit-styling';
358
- import {base, brand} from '@workday/canvas-tokens-web';
359
409
 
360
- const myCustomTheme = createStyles({
361
- [brand.primary.base]: base.magenta600
362
- })
410
+ import {base, brand} from '@workday/canvas-tokens-web';
363
411
 
364
412
 
365
- <CanvasProvider className={myCustomTheme}>
413
+ <CanvasProvider theme={{canvas: {palette: {primary: {main: base.magenta600}}}}}>
366
414
  <App/>
367
415
  </CanvasProvider>
368
416
 
@@ -380,18 +428,6 @@ const myCustomTheme = createStyles({
380
428
 
381
429
  ```
382
430
 
383
- ## Component Compatibility
384
-
385
- All Canvas Kit components in v14 automatically consume CSS variables. No component-level changes are
386
- required when switching from the theme prop approach to CSS variables.
387
-
388
- ### Supported Components
389
-
390
- - ✅ All Button variants (`PrimaryButton`, `SecondaryButton`, etc.)
391
- - ✅ Form components (`TextInput`, `FormField`, etc.)
392
- - ✅ Layout components (`Card`, `Modal`, etc.)
393
- - ✅ Navigation components (`Tabs`, `SidePanel`, etc.)
394
-
395
431
  ## Performance Benefits
396
432
 
397
433
  The CSS variable approach provides several performance improvements:
@@ -416,6 +452,7 @@ Ensure CSS variable files are imported in the correct order.
416
452
  @import '@workday/canvas-tokens-web/css/base/_variables.css';
417
453
  @import '@workday/canvas-tokens-web/css/system/_variables.css';
418
454
  @import '@workday/canvas-tokens-web/css/brand/_variables.css';
455
+ @import '@workday/canvas-tokens-web/css/component/_variables.css';
419
456
 
420
457
  /* Your overrides after imports */
421
458
  :root {
@@ -444,7 +481,7 @@ Check for CSS specificity issues.
444
481
  Verify all required CSS token files are imported and token names are correct.
445
482
 
446
483
  ```tsx
447
- import {brand, base, system} from '@workday/canvas-tokens-web';
484
+ import {base, brand, system} from '@workday/canvas-tokens-web';
448
485
 
449
486
  // Check token availability in development
450
487
  console.log(brand.primary.base); // Should output CSS variable name
@@ -1,8 +1,8 @@
1
- import React from 'react';
2
- import {createComponent, ExtractProps} from '@workday/canvas-kit-react/common';
1
+ import {ExtractProps, createComponent} from '@workday/canvas-kit-react/common';
3
2
  import {Box, BoxProps} from '@workday/canvas-kit-react/layout';
4
3
  import {Heading} from '@workday/canvas-kit-react/text';
5
- import {colors} from '@workday/canvas-kit-react/tokens';
4
+ import {createStyles} from '@workday/canvas-kit-styling';
5
+ import {system} from '@workday/canvas-tokens-web';
6
6
 
7
7
  // Extend Heading Props and omitting size since we've added a default
8
8
  interface CardHeadingProps extends Omit<ExtractProps<typeof Heading>, 'size'> {}
@@ -33,9 +33,15 @@ export default createComponent('div')({
33
33
  },
34
34
  });
35
35
 
36
+ const cardStyles = createStyles({
37
+ boxShadow: system.depth[2],
38
+ border: `1px solid ${system.color.border.default}`,
39
+ padding: system.padding.sm,
40
+ });
41
+
36
42
  export default () => {
37
43
  return (
38
- <Card depth={2} border={`1px solid ${colors.soap400}`} padding="s" as="section">
44
+ <Card cs={cardStyles} as="section">
39
45
  <Card.Heading>Card Heading</Card.Heading>
40
46
  </Card>
41
47
  );
@@ -1,4 +1,5 @@
1
1
  import React from 'react';
2
+
2
3
  import {createContainer, createModelHook, useUniqueId} from '@workday/canvas-kit-react/common';
3
4
 
4
5
  export type Visibility = 'hidden' | 'visible';
@@ -1,12 +1,13 @@
1
1
  import React from 'react';
2
+
3
+ import {PrimaryButton, PrimaryButtonProps} from '@workday/canvas-kit-react/button';
2
4
  import {
3
5
  createContainer,
6
+ createElemPropsHook,
4
7
  createModelHook,
5
8
  createSubcomponent,
6
- createElemPropsHook,
7
9
  useUniqueId,
8
10
  } from '@workday/canvas-kit-react/common';
9
- import {PrimaryButton, PrimaryButtonProps} from '@workday/canvas-kit-react/button';
10
11
  import {Box, BoxProps} from '@workday/canvas-kit-react/layout';
11
12
 
12
13
  type Visibility = 'hidden' | 'visible';
@@ -1,4 +1,5 @@
1
1
  import React from 'react';
2
+
2
3
  import {createContainer, createModelHook, useUniqueId} from '@workday/canvas-kit-react/common';
3
4
 
4
5
  export type Visibility = 'hidden' | 'visible';
@@ -1,11 +1,12 @@
1
1
  import React from 'react';
2
+
3
+ import {PrimaryButton, PrimaryButtonProps} from '@workday/canvas-kit-react/button';
2
4
  import {
3
5
  createContainer,
4
6
  createModelHook,
5
7
  createSubcomponent,
6
8
  useUniqueId,
7
9
  } from '@workday/canvas-kit-react/common';
8
- import {PrimaryButton, PrimaryButtonProps} from '@workday/canvas-kit-react/button';
9
10
 
10
11
  export type Visibility = 'hidden' | 'visible';
11
12
 
@@ -1,16 +1,15 @@
1
1
  import React from 'react';
2
- import {createStyles} from '@workday/canvas-kit-styling';
3
2
 
4
- import {CanvasProvider} from '@workday/canvas-kit-react/common';
5
- import {Card} from '@workday/canvas-kit-react/card';
6
3
  import {PrimaryButton} from '@workday/canvas-kit-react/button';
4
+ import {Card} from '@workday/canvas-kit-react/card';
5
+ import {CanvasProvider} from '@workday/canvas-kit-react/common';
7
6
  import {FormField} from '@workday/canvas-kit-react/form-field';
8
7
  import {TextInput} from '@workday/canvas-kit-react/text-input';
8
+ import {createStyles, px2rem} from '@workday/canvas-kit-styling';
9
9
  import {arrowRightSmallIcon} from '@workday/canvas-system-icons-web';
10
- import {system} from '@workday/canvas-tokens-web';
11
10
 
12
11
  const rtlStyles = createStyles({
13
- paddingInlineStart: system.space.x16,
12
+ paddingInlineStart: px2rem(64),
14
13
  });
15
14
 
16
15
  const rtlButtonStyles = createStyles({
@@ -1,9 +1,10 @@
1
1
  import * as React from 'react';
2
- import {Box, Grid, Flex} from '@workday/canvas-kit-react/layout';
3
- import {Text} from '@workday/canvas-kit-react/text';
4
- import {useResponsiveContainerStyles, useResizeObserver} from '@workday/canvas-kit-react/common';
2
+
3
+ import {useResizeObserver, useResponsiveContainerStyles} from '@workday/canvas-kit-react/common';
5
4
  import {FormField} from '@workday/canvas-kit-react/form-field';
5
+ import {Box, Flex, Grid} from '@workday/canvas-kit-react/layout';
6
6
  import {Select} from '@workday/canvas-kit-react/select';
7
+ import {Text} from '@workday/canvas-kit-react/text';
7
8
 
8
9
  const HeadingText = ({children, ...props}) => (
9
10
  <Text as="p" fontSize={20} fontWeight="bold" color="frenchVanilla100" margin={0} {...props}>
@@ -1,8 +1,9 @@
1
- import * as React from 'react';
2
- import {Box, Grid} from '@workday/canvas-kit-react/layout';
3
1
  import styled from '@emotion/styled';
4
- import {type, space, colors, borderRadius} from '@workday/canvas-kit-react/tokens';
2
+ import * as React from 'react';
3
+
5
4
  import {getTheme} from '@workday/canvas-kit-react/common';
5
+ import {Box, Grid} from '@workday/canvas-kit-react/layout';
6
+ import {borderRadius, colors, space, type} from '@workday/canvas-kit-react/tokens';
6
7
 
7
8
  const theme = getTheme();
8
9
  const {up, down} = theme.canvas.breakpoints;