@workday/canvas-kit-docs 15.0.0-alpha.1326-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 (679) 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 +198703 -185317
  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 +40 -24
  134. package/dist/mdx/14.0-VISUAL-CHANGES.mdx +19 -19
  135. package/dist/mdx/15.0-UPGRADE-GUIDE.mdx +1090 -1
  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/examples/ContextualHelp/ContextualHelpDialogFocusRedirect.tsx +14 -10
  204. package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpDialogFocusTrap.tsx +12 -10
  205. package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpTooltip.tsx +6 -5
  206. package/dist/mdx/react/_examples/mdx/examples/CookieBanner.tsx +2 -2
  207. package/dist/mdx/react/_examples/mdx/examples/Density.tsx +43 -42
  208. package/dist/mdx/react/_examples/mdx/examples/MediaModal.tsx +4 -3
  209. package/dist/mdx/react/_examples/mdx/examples/PageHeader.tsx +22 -19
  210. package/dist/mdx/react/_examples/mdx/examples/SelectWithFormik.tsx +8 -12
  211. package/dist/mdx/react/_examples/mdx/examples/compoundComponent/CustomCard.tsx +10 -12
  212. package/dist/mdx/react/_examples/mdx/examples/layout/AreaColumnPositioning.tsx +1 -1
  213. package/dist/mdx/react/_examples/mdx/examples/layout/CustomColumnPositioning.tsx +1 -1
  214. package/dist/mdx/react/_examples/mdx/examples/layout/CustomColumnWidth.tsx +1 -1
  215. package/dist/mdx/react/_examples/mdx/examples/layout/FullWidthWith3Columns.tsx +50 -12
  216. package/dist/mdx/react/_examples/mdx/examples/layout/FullWidthWith3Columns2Rows.tsx +1 -1
  217. package/dist/mdx/react/_examples/mdx/examples/layout/Masonry.tsx +3 -2
  218. package/dist/mdx/react/_examples/mdx/examples/layout/ResponsiveColumns.tsx +2 -2
  219. package/dist/mdx/react/_examples/mdx/examples/layout/Tiled2and3Columns.tsx +1 -1
  220. package/dist/mdx/react/_examples/mdx/examples/layout/Tiled4and2Columns.tsx +1 -1
  221. package/dist/mdx/react/action-bar/ActionBar.mdx +4 -4
  222. package/dist/mdx/react/action-bar/examples/Icons.tsx +1 -1
  223. package/dist/mdx/react/action-bar/examples/OverflowActionBar.tsx +5 -3
  224. package/dist/mdx/react/action-bar/examples/OverflowActionBarCustomButtonCount.tsx +1 -0
  225. package/dist/mdx/{preview-react → react}/avatar/Avatar.mdx +23 -13
  226. package/dist/mdx/react/avatar/examples/Basic.tsx +5 -0
  227. package/dist/mdx/{preview-react → react}/avatar/examples/Custom.tsx +1 -1
  228. package/dist/mdx/{preview-react → react}/avatar/examples/Decorative.tsx +7 -5
  229. package/dist/mdx/{preview-react → react}/avatar/examples/Image.tsx +1 -1
  230. package/dist/mdx/{preview-react → react}/avatar/examples/Size.tsx +2 -2
  231. package/dist/mdx/{preview-react → react}/avatar/examples/Variant.tsx +2 -2
  232. package/dist/mdx/react/badge/CountBadge.mdx +1 -1
  233. package/dist/mdx/react/badge/examples/Basic.tsx +2 -2
  234. package/dist/mdx/react/badge/examples/CustomLimit.tsx +8 -8
  235. package/dist/mdx/react/badge/examples/Emphasis.tsx +4 -4
  236. package/dist/mdx/react/badge/examples/Inverse.tsx +7 -6
  237. package/dist/mdx/react/badge/examples/NotificationBadge.tsx +8 -7
  238. package/dist/mdx/react/banner/Banner.mdx +2 -2
  239. package/dist/mdx/react/banner/examples/IconBanner.tsx +1 -1
  240. package/dist/mdx/react/banner/examples/RefForwarding.tsx +1 -1
  241. package/dist/mdx/react/banner/examples/Sticky.tsx +1 -1
  242. package/dist/mdx/react/banner/examples/StickyAnimation.tsx +7 -7
  243. package/dist/mdx/react/banner/examples/StickyRTL.tsx +3 -14
  244. package/dist/mdx/react/banner/examples/ThemedAlert.tsx +4 -5
  245. package/dist/mdx/react/banner/examples/ThemedError.tsx +5 -6
  246. package/dist/mdx/react/breadcrumbs/Breadcrumbs.mdx +6 -5
  247. package/dist/mdx/react/breadcrumbs/examples/CurrentItemTruncation.tsx +1 -0
  248. package/dist/mdx/react/breadcrumbs/examples/LinkTruncation.tsx +1 -0
  249. package/dist/mdx/react/breadcrumbs/examples/Overflow.tsx +6 -3
  250. package/dist/mdx/react/breadcrumbs/examples/RTL.tsx +6 -10
  251. package/dist/mdx/react/button/button/Button.mdx +11 -12
  252. package/dist/mdx/react/button/button/Hyperlink.mdx +11 -5
  253. package/dist/mdx/react/button/button/examples/CustomStyles.tsx +43 -43
  254. package/dist/mdx/react/button/button/examples/Delete.tsx +4 -4
  255. package/dist/mdx/react/button/button/examples/ExternalHyperlinkInverse.tsx +3 -3
  256. package/dist/mdx/react/button/button/examples/ExternalHyperlinkRTL.tsx +10 -0
  257. package/dist/mdx/react/button/button/examples/HyperlinkInverse.tsx +3 -3
  258. package/dist/mdx/react/button/button/examples/Primary.tsx +5 -5
  259. package/dist/mdx/react/button/button/examples/PrimaryInverse.tsx +6 -6
  260. package/dist/mdx/react/button/button/examples/Secondary.tsx +5 -5
  261. package/dist/mdx/react/button/button/examples/SecondaryInverse.tsx +6 -6
  262. package/dist/mdx/react/button/button/examples/StandaloneHyperlink.tsx +2 -2
  263. package/dist/mdx/react/button/button/examples/Tertiary.tsx +5 -5
  264. package/dist/mdx/react/button/button/examples/TertiaryInverse.tsx +6 -6
  265. package/dist/mdx/react/button/button/examples/ThemeOverrides.tsx +6 -6
  266. package/dist/mdx/react/card/card.mdx +5 -5
  267. package/dist/mdx/react/card/examples/Basic.tsx +1 -0
  268. package/dist/mdx/react/card/examples/Borderless.tsx +2 -3
  269. package/dist/mdx/react/card/examples/CustomStyles.tsx +1 -3
  270. package/dist/mdx/react/card/examples/Stencils.tsx +9 -10
  271. package/dist/mdx/react/card/examples/{Filled.tsx → Tonal.tsx} +2 -1
  272. package/dist/mdx/react/checkbox/Checkbox.mdx +11 -12
  273. package/dist/mdx/react/checkbox/examples/Basic.tsx +1 -0
  274. package/dist/mdx/react/checkbox/examples/Caution.tsx +1 -0
  275. package/dist/mdx/react/checkbox/examples/Disabled.tsx +1 -0
  276. package/dist/mdx/react/checkbox/examples/Error.tsx +1 -0
  277. package/dist/mdx/react/checkbox/examples/Indeterminate.tsx +3 -2
  278. package/dist/mdx/react/checkbox/examples/Inverse.tsx +3 -2
  279. package/dist/mdx/react/checkbox/examples/LabelPosition.tsx +1 -0
  280. package/dist/mdx/react/checkbox/examples/RefForwarding.tsx +3 -2
  281. package/dist/mdx/react/checkbox/examples/Required.tsx +1 -0
  282. package/dist/mdx/react/collection/mdx/examples/BasicGrid.tsx +3 -3
  283. package/dist/mdx/react/collection/mdx/examples/DataLoader.tsx +4 -4
  284. package/dist/mdx/react/collection/mdx/examples/MultiSelection.tsx +3 -3
  285. package/dist/mdx/react/collection/mdx/examples/OverflowVerticalList.tsx +3 -2
  286. package/dist/mdx/react/collection/mdx/examples/RovingFocus.tsx +2 -2
  287. package/dist/mdx/react/collection/mdx/examples/Selection.tsx +3 -3
  288. package/dist/mdx/react/collection/mdx/examples/StringChildren.tsx +1 -1
  289. package/dist/mdx/react/collection/mdx/examples/WrappingGrid.tsx +3 -3
  290. package/dist/mdx/react/color-picker/color-input/ColorInput.mdx +7 -8
  291. package/dist/mdx/react/color-picker/color-input/examples/Basic.tsx +2 -1
  292. package/dist/mdx/react/color-picker/color-input/examples/Caution.tsx +2 -1
  293. package/dist/mdx/react/color-picker/color-input/examples/Checked.tsx +2 -1
  294. package/dist/mdx/react/color-picker/color-input/examples/Disabled.tsx +2 -1
  295. package/dist/mdx/react/color-picker/color-input/examples/Error.tsx +2 -1
  296. package/dist/mdx/react/color-picker/color-input/examples/Grow.tsx +2 -1
  297. package/dist/mdx/react/color-picker/color-input/examples/LabelPosition.tsx +2 -1
  298. package/dist/mdx/react/color-picker/color-input/examples/RefForwarding.tsx +2 -1
  299. package/dist/mdx/react/color-picker/color-input/examples/Required.tsx +2 -1
  300. package/dist/mdx/react/color-picker/color-input/examples/ValidColorChange.tsx +4 -3
  301. package/dist/mdx/react/color-picker/color-preview/ColorPreview.mdx +3 -3
  302. package/dist/mdx/react/color-picker/color-preview/examples/LabelPosition.tsx +2 -1
  303. package/dist/mdx/react/color-picker/color-preview/examples/RefForwarding.tsx +4 -3
  304. package/dist/mdx/react/combobox/examples/Autocomplete.tsx +11 -9
  305. package/dist/mdx/react/common/mdx/CompoundComponentUtilities.mdx +1 -1
  306. package/dist/mdx/react/common/mdx/Theming.mdx +166 -159
  307. package/dist/mdx/react/common/mdx/examples/CreateComponent.tsx +10 -4
  308. package/dist/mdx/react/common/mdx/examples/CreateContainer.tsx +1 -0
  309. package/dist/mdx/react/common/mdx/examples/CreateElemPropsHook.tsx +3 -2
  310. package/dist/mdx/react/common/mdx/examples/CreateModelHook.tsx +1 -0
  311. package/dist/mdx/react/common/mdx/examples/CreateSubcomponent.tsx +2 -1
  312. package/dist/mdx/react/common/mdx/examples/RTL.tsx +4 -5
  313. package/dist/mdx/react/common/mdx/examples/ResponsiveStyles.tsx +4 -3
  314. package/dist/mdx/react/common/mdx/examples/ResponsiveViewport.tsx +4 -3
  315. package/dist/mdx/react/common/mdx/examples/Theming.tsx +40 -22
  316. package/dist/mdx/react/dialog/Dialog.mdx +51 -20
  317. package/dist/mdx/react/dialog/examples/Basic.tsx +4 -3
  318. package/dist/mdx/react/dialog/examples/DialogWithFallbackPlacements.tsx +20 -12
  319. package/dist/mdx/react/dialog/examples/Focus.tsx +3 -3
  320. package/dist/mdx/react/expandable/Expandable.mdx +54 -2
  321. package/dist/mdx/react/expandable/examples/Avatar.tsx +1 -0
  322. package/dist/mdx/react/expandable/examples/Depth.tsx +10 -1
  323. package/dist/mdx/react/expandable/examples/HoistedModel.tsx +26 -21
  324. package/dist/mdx/react/expandable/examples/LongTitle.tsx +1 -0
  325. package/dist/mdx/react/expandable/examples/RTL.tsx +2 -7
  326. package/dist/mdx/react/form-field/FormField.mdx +97 -45
  327. package/dist/mdx/react/form-field/examples/AllFields.tsx +10 -11
  328. package/dist/mdx/react/form-field/examples/Basic.tsx +1 -0
  329. package/dist/mdx/react/form-field/examples/Caution.tsx +8 -5
  330. package/dist/mdx/react/form-field/examples/Custom.tsx +3 -2
  331. package/dist/mdx/react/form-field/examples/CustomId.tsx +1 -0
  332. package/dist/mdx/react/form-field/examples/Disabled.tsx +2 -2
  333. package/dist/mdx/react/form-field/examples/Error.tsx +3 -3
  334. package/dist/mdx/react/form-field/examples/GroupedInputs.tsx +14 -14
  335. package/dist/mdx/react/form-field/examples/Grow.tsx +1 -0
  336. package/dist/mdx/react/form-field/examples/HiddenLabel.tsx +27 -11
  337. package/dist/mdx/react/form-field/examples/Hint.tsx +2 -2
  338. package/dist/mdx/react/form-field/examples/LabelPositionHorizontalEnd.tsx +3 -2
  339. package/dist/mdx/react/form-field/examples/LabelPositionHorizontalStart.tsx +3 -2
  340. package/dist/mdx/react/form-field/examples/RefForwarding.tsx +4 -3
  341. package/dist/mdx/react/form-field/examples/Required.tsx +2 -1
  342. package/dist/mdx/react/form-field/examples/ThemedErrors.tsx +8 -8
  343. package/dist/mdx/react/icon/Assets.mdx +174 -17
  344. package/dist/mdx/react/icon/examples/AccentIconList.tsx +5 -4
  345. package/dist/mdx/react/icon/examples/AppletIconList.tsx +5 -4
  346. package/dist/mdx/react/icon/examples/ExpressiveBasic.tsx +41 -0
  347. package/dist/mdx/react/icon/examples/ExpressiveCustomStyles.tsx +54 -0
  348. package/dist/mdx/react/icon/examples/{IconList.tsx → ExpressiveIconList.tsx} +20 -13
  349. package/dist/mdx/react/icon/examples/SVGBasic.tsx +31 -0
  350. package/dist/mdx/react/icon/examples/SystemBasic.tsx +44 -0
  351. package/dist/mdx/react/icon/examples/SystemCircleBasic.tsx +34 -0
  352. package/dist/mdx/react/icon/examples/SystemCustomStyles.tsx +62 -0
  353. package/dist/mdx/react/icon/examples/SystemIconList.tsx +80 -0
  354. package/dist/mdx/react/information-highlight/InformationHighlight.mdx +96 -0
  355. package/dist/mdx/{preview-react → react}/information-highlight/examples/Basic.tsx +1 -1
  356. package/dist/mdx/{preview-react → react}/information-highlight/examples/Body.tsx +1 -1
  357. package/dist/mdx/{preview-react → react}/information-highlight/examples/Caution.tsx +2 -2
  358. package/dist/mdx/{preview-react → react}/information-highlight/examples/Critical.tsx +2 -2
  359. package/dist/mdx/{preview-react → react}/information-highlight/examples/CustomIconCritical.tsx +5 -6
  360. package/dist/mdx/{preview-react → react}/information-highlight/examples/Heading.tsx +1 -1
  361. package/dist/mdx/{preview-react → react}/information-highlight/examples/Informational.tsx +4 -4
  362. package/dist/mdx/{preview-react → react}/information-highlight/examples/RTL.tsx +6 -11
  363. package/dist/mdx/react/layout/Box.mdx +13 -13
  364. package/dist/mdx/react/layout/Flex.mdx +3 -3
  365. package/dist/mdx/react/layout/Grid.mdx +3 -3
  366. package/dist/mdx/react/layout/examples/Box/Basic.tsx +9 -2
  367. package/dist/mdx/react/layout/examples/Flex/Basic.tsx +1 -0
  368. package/dist/mdx/react/layout/examples/Grid/Basic.tsx +19 -13
  369. package/dist/mdx/react/layout/examples/Grid/GridCard.tsx +34 -24
  370. package/dist/mdx/react/layout/examples/Grid/GridLayout.tsx +1 -0
  371. package/dist/mdx/react/layout/examples/Grid/GridLayoutInteractive.tsx +3 -3
  372. package/dist/mdx/react/loading-dots/LoadingDots.mdx +1 -1
  373. package/dist/mdx/react/loading-dots/examples/Accessible.tsx +8 -7
  374. package/dist/mdx/react/loading-dots/examples/Basic.tsx +1 -0
  375. package/dist/mdx/react/loading-dots/examples/CustomColorAndAnimation.tsx +6 -4
  376. package/dist/mdx/react/loading-dots/examples/CustomShape.tsx +7 -7
  377. package/dist/mdx/react/loading-dots/examples/Inverse.tsx +2 -2
  378. package/dist/mdx/react/loading-dots/examples/RTL.tsx +3 -7
  379. package/dist/mdx/react/menu/Menu.mdx +68 -30
  380. package/dist/mdx/react/menu/examples/Icons.tsx +11 -10
  381. package/dist/mdx/react/menu/examples/MenuWithFallbackPlacements.tsx +5 -3
  382. package/dist/mdx/react/menu/examples/Nested.tsx +0 -1
  383. package/dist/mdx/react/menu/examples/NestedDynamic.tsx +1 -1
  384. package/dist/mdx/react/menu/examples/SelectableMenu.tsx +13 -2
  385. package/dist/mdx/react/modal/Modal.mdx +94 -16
  386. package/dist/mdx/react/modal/examples/Basic.tsx +5 -4
  387. package/dist/mdx/react/modal/examples/BodyOverflow.tsx +1 -1
  388. package/dist/mdx/react/modal/examples/CustomFocus.tsx +4 -3
  389. package/dist/mdx/react/modal/examples/FormModal.tsx +28 -3
  390. package/dist/mdx/react/modal/examples/FullOverflow.tsx +1 -1
  391. package/dist/mdx/react/modal/examples/IframeTest.tsx +1 -1
  392. package/dist/mdx/react/modal/examples/ModalWithPopup.tsx +3 -3
  393. package/dist/mdx/react/modal/examples/ModalWithPopupRTL.tsx +66 -0
  394. package/dist/mdx/react/modal/examples/NoTargetRTL.tsx +49 -0
  395. package/dist/mdx/react/modal/examples/ReturnFocus.tsx +140 -41
  396. package/dist/mdx/react/modal/examples/StackedModals.tsx +1 -1
  397. package/dist/mdx/react/modal/examples/WithRadioButtons.tsx +1 -0
  398. package/dist/mdx/react/modal/examples/WithTooltips.tsx +2 -1
  399. package/dist/mdx/react/modal/examples/WithoutCloseIcon.tsx +10 -9
  400. package/dist/mdx/react/pagination/examples/Basic.tsx +0 -1
  401. package/dist/mdx/react/pagination/examples/HoistedModel.tsx +0 -1
  402. package/dist/mdx/react/pagination/examples/RTL.tsx +2 -5
  403. package/dist/mdx/react/pagination/examples/ResponsiveRange.tsx +13 -9
  404. package/dist/mdx/react/pagination/pagination.mdx +8 -6
  405. package/dist/mdx/{preview-react → react}/pill/Pill.mdx +3 -3
  406. package/dist/mdx/{preview-react → react}/pill/examples/Basic.tsx +2 -3
  407. package/dist/mdx/react/pill/examples/CustomStyles.tsx +52 -0
  408. package/dist/mdx/{preview-react → react}/pill/examples/WithAvatar.tsx +6 -4
  409. package/dist/mdx/{preview-react → react}/pill/examples/WithCount.tsx +3 -2
  410. package/dist/mdx/{preview-react → react}/pill/examples/WithList.tsx +2 -2
  411. package/dist/mdx/{preview-react → react}/pill/examples/WithReadOnly.tsx +3 -3
  412. package/dist/mdx/{preview-react → react}/pill/examples/WithRemovable.tsx +6 -5
  413. package/dist/mdx/react/popup/Popup.mdx +64 -36
  414. package/dist/mdx/react/popup/examples/Basic.tsx +22 -5
  415. package/dist/mdx/react/popup/examples/ComboboxWithinPopup.tsx +3 -3
  416. package/dist/mdx/react/popup/examples/CustomTarget.tsx +3 -2
  417. package/dist/mdx/react/popup/examples/ExternalWindow.tsx +26 -29
  418. package/dist/mdx/react/popup/examples/FocusRedirect.tsx +27 -12
  419. package/dist/mdx/react/popup/examples/FocusTrap.tsx +8 -6
  420. package/dist/mdx/react/popup/examples/FullScreen.tsx +6 -6
  421. package/dist/mdx/react/popup/examples/InitialFocus.tsx +115 -11
  422. package/dist/mdx/react/popup/examples/InlinePopup.tsx +126 -0
  423. package/dist/mdx/react/popup/examples/MixedPopupTypes.tsx +5 -4
  424. package/dist/mdx/react/popup/examples/MultiplePopups.tsx +34 -22
  425. package/dist/mdx/react/popup/examples/NestedPopups.tsx +5 -5
  426. package/dist/mdx/react/popup/examples/PopupWithFallbackPlacements.tsx +26 -18
  427. package/dist/mdx/react/popup/examples/PopupWithNonHidablePopup.tsx +1 -1
  428. package/dist/mdx/react/popup/examples/RTL.tsx +9 -9
  429. package/dist/mdx/react/popup/examples/ReturnFocusTest.tsx +4 -4
  430. package/dist/mdx/react/popup/examples/TooltipReturnFocus.tsx +5 -5
  431. package/dist/mdx/react/radio/Radio.mdx +8 -9
  432. package/dist/mdx/react/radio/examples/Basic.tsx +4 -3
  433. package/dist/mdx/react/radio/examples/Caution.tsx +2 -1
  434. package/dist/mdx/react/radio/examples/Disabled.tsx +2 -1
  435. package/dist/mdx/react/radio/examples/Error.tsx +2 -1
  436. package/dist/mdx/react/radio/examples/Inverse.tsx +3 -2
  437. package/dist/mdx/react/radio/examples/LabelPosition.tsx +2 -1
  438. package/dist/mdx/react/radio/examples/NoValue.tsx +2 -1
  439. package/dist/mdx/react/radio/examples/RefForwarding.tsx +2 -1
  440. package/dist/mdx/react/radio/examples/Required.tsx +2 -1
  441. package/dist/mdx/react/segmented-control/SegmentedControl.mdx +119 -18
  442. package/dist/mdx/react/segmented-control/examples/Basic.tsx +32 -28
  443. package/dist/mdx/{preview-react → react}/segmented-control/examples/Disabled.tsx +2 -2
  444. package/dist/mdx/{preview-react → react}/segmented-control/examples/Dynamic.tsx +3 -2
  445. package/dist/mdx/{preview-react → react}/segmented-control/examples/RTL.tsx +4 -4
  446. package/dist/mdx/{preview-react → react}/segmented-control/examples/Sizes.tsx +4 -3
  447. package/dist/mdx/{preview-react → react}/segmented-control/examples/TextAndIcon.tsx +2 -1
  448. package/dist/mdx/{preview-react → react}/segmented-control/examples/TextOnly.tsx +2 -1
  449. package/dist/mdx/{preview-react → react}/segmented-control/examples/Vertical.tsx +2 -2
  450. package/dist/mdx/react/select/Select.mdx +26 -20
  451. package/dist/mdx/react/select/examples/Basic.tsx +2 -1
  452. package/dist/mdx/react/select/examples/Caution.tsx +2 -1
  453. package/dist/mdx/react/select/examples/Complex.tsx +2 -1
  454. package/dist/mdx/react/select/examples/Controlled.tsx +3 -2
  455. package/dist/mdx/react/select/examples/Disabled.tsx +2 -1
  456. package/dist/mdx/react/select/examples/DisabledOption.tsx +2 -1
  457. package/dist/mdx/react/select/examples/Error.tsx +2 -1
  458. package/dist/mdx/react/select/examples/FetchingDynamicItems.tsx +4 -3
  459. package/dist/mdx/react/select/examples/GroupedItems.tsx +59 -0
  460. package/dist/mdx/react/select/examples/Grow.tsx +2 -1
  461. package/dist/mdx/react/select/examples/HoistedModel.tsx +1 -0
  462. package/dist/mdx/react/select/examples/InitialSelectedItem.tsx +2 -1
  463. package/dist/mdx/react/select/examples/LabelPosition.tsx +2 -1
  464. package/dist/mdx/react/select/examples/MenuHeight.tsx +1 -1
  465. package/dist/mdx/react/select/examples/Placeholder.tsx +2 -1
  466. package/dist/mdx/react/select/examples/RefForwarding.tsx +1 -0
  467. package/dist/mdx/react/select/examples/Required.tsx +2 -1
  468. package/dist/mdx/react/select/examples/WithIcons.tsx +6 -10
  469. package/dist/mdx/react/side-panel/SidePanel.mdx +287 -0
  470. package/dist/mdx/react/side-panel/examples/AlwaysOpen.tsx +50 -0
  471. package/dist/mdx/react/side-panel/examples/Basic.tsx +33 -0
  472. package/dist/mdx/react/side-panel/examples/ExternalControl.tsx +60 -0
  473. package/dist/mdx/react/side-panel/examples/Heading.tsx +43 -0
  474. package/dist/mdx/react/side-panel/examples/OnStateTransition.tsx +52 -0
  475. package/dist/mdx/react/side-panel/examples/RightOrigin.tsx +67 -0
  476. package/dist/mdx/react/side-panel/examples/Variant.tsx +51 -0
  477. package/dist/mdx/react/side-panel/examples/useDirection.ts +24 -0
  478. package/dist/mdx/react/skeleton/Skeleton.mdx +1 -1
  479. package/dist/mdx/react/skeleton/examples/Basic.tsx +8 -6
  480. package/dist/mdx/react/skeleton/examples/Color.tsx +13 -11
  481. package/dist/mdx/react/skeleton/examples/Header.tsx +1 -0
  482. package/dist/mdx/react/skeleton/examples/Shape.tsx +4 -3
  483. package/dist/mdx/react/skeleton/examples/Simulation.tsx +40 -25
  484. package/dist/mdx/react/skeleton/examples/Text.tsx +1 -0
  485. package/dist/mdx/react/status-indicator/StatusIndicator.mdx +1 -1
  486. package/dist/mdx/react/status-indicator/examples/Basic.tsx +6 -7
  487. package/dist/mdx/react/status-indicator/examples/Emphasis.tsx +6 -7
  488. package/dist/mdx/react/status-indicator/examples/Icon.tsx +3 -2
  489. package/dist/mdx/react/status-indicator/examples/MaxWidth.tsx +6 -7
  490. package/dist/mdx/react/switch/Switch.mdx +22 -9
  491. package/dist/mdx/react/switch/examples/Basic.tsx +1 -0
  492. package/dist/mdx/react/switch/examples/Caution.tsx +1 -0
  493. package/dist/mdx/react/switch/examples/Disabled.tsx +1 -0
  494. package/dist/mdx/react/switch/examples/Error.tsx +1 -0
  495. package/dist/mdx/react/switch/examples/LabelPosition.tsx +1 -0
  496. package/dist/mdx/react/switch/examples/RefForwarding.tsx +1 -0
  497. package/dist/mdx/react/table/examples/BaseHtmlTable.tsx +1 -3
  498. package/dist/mdx/react/table/examples/Basic.tsx +1 -3
  499. package/dist/mdx/react/table/examples/BasicWithHeading.tsx +3 -5
  500. package/dist/mdx/react/table/examples/FixedColumn.tsx +8 -8
  501. package/dist/mdx/react/table/examples/RightToLeft.tsx +3 -5
  502. package/dist/mdx/react/tabs/Tabs.mdx +10 -9
  503. package/dist/mdx/react/tabs/examples/AlternativeTabStop.tsx +3 -4
  504. package/dist/mdx/react/tabs/examples/Basic.tsx +3 -3
  505. package/dist/mdx/react/tabs/examples/DisabledTab.tsx +3 -3
  506. package/dist/mdx/react/tabs/examples/DynamicTabs.tsx +2 -1
  507. package/dist/mdx/react/tabs/examples/HoistedModel.tsx +3 -4
  508. package/dist/mdx/react/tabs/examples/Icons.tsx +4 -5
  509. package/dist/mdx/react/tabs/examples/NamedTabs.tsx +3 -3
  510. package/dist/mdx/react/tabs/examples/OverflowTabs.tsx +2 -2
  511. package/dist/mdx/react/tabs/examples/RightToLeft.tsx +5 -5
  512. package/dist/mdx/react/tabs/examples/SinglePanel.tsx +2 -4
  513. package/dist/mdx/react/testing/examples/Basic.tsx +3 -3
  514. package/dist/mdx/react/text/LabelText.mdx +1 -1
  515. package/dist/mdx/react/text/Text.mdx +1 -1
  516. package/dist/mdx/react/text/examples/BodyText/Basic.tsx +1 -0
  517. package/dist/mdx/react/text/examples/Heading/Basic.tsx +1 -0
  518. package/dist/mdx/react/text/examples/LabelText/Basic.tsx +1 -0
  519. package/dist/mdx/react/text/examples/LabelText/Cursor.tsx +1 -0
  520. package/dist/mdx/react/text/examples/LabelText/Disabled.tsx +3 -5
  521. package/dist/mdx/react/text/examples/Subtext/Basic.tsx +1 -0
  522. package/dist/mdx/react/text/examples/Text/Basic.tsx +12 -7
  523. package/dist/mdx/react/text/examples/Title/Basic.tsx +1 -0
  524. package/dist/mdx/react/text-area/TextArea.mdx +44 -18
  525. package/dist/mdx/react/text-area/examples/Basic.tsx +1 -0
  526. package/dist/mdx/react/text-area/examples/Disabled.tsx +1 -0
  527. package/dist/mdx/react/text-area/examples/Grow.tsx +1 -0
  528. package/dist/mdx/react/text-area/examples/LabelPosition.tsx +1 -0
  529. package/dist/mdx/react/text-area/examples/Placeholder.tsx +1 -0
  530. package/dist/mdx/react/text-area/examples/RefForwarding.tsx +1 -0
  531. package/dist/mdx/react/text-area/examples/Required.tsx +1 -0
  532. package/dist/mdx/react/text-area/examples/ResizeConstraints.tsx +1 -0
  533. package/dist/mdx/react/text-input/TextInput.mdx +43 -18
  534. package/dist/mdx/react/text-input/examples/Basic.tsx +1 -0
  535. package/dist/mdx/react/text-input/examples/Disabled.tsx +1 -0
  536. package/dist/mdx/react/text-input/examples/Grow.tsx +1 -0
  537. package/dist/mdx/react/text-input/examples/Icons.tsx +25 -21
  538. package/dist/mdx/react/text-input/examples/LabelPosition.tsx +1 -0
  539. package/dist/mdx/react/text-input/examples/Placeholder.tsx +1 -0
  540. package/dist/mdx/react/text-input/examples/RefForwarding.tsx +1 -0
  541. package/dist/mdx/react/text-input/examples/Required.tsx +1 -0
  542. package/dist/mdx/react/toast/examples/Basic.tsx +2 -1
  543. package/dist/mdx/react/toast/examples/RTL.tsx +4 -6
  544. package/dist/mdx/react/toast/examples/ToastAlert.tsx +2 -2
  545. package/dist/mdx/react/toast/examples/ToastDialog.tsx +2 -1
  546. package/dist/mdx/react/toast/examples/WithActionLinkAndCloseIcon.tsx +2 -4
  547. package/dist/mdx/react/toast/examples/WithPopper.tsx +4 -4
  548. package/dist/mdx/react/toast/toast.mdx +4 -3
  549. package/dist/mdx/react/tokens/Tokens.mdx +1 -1
  550. package/dist/mdx/react/tokens/examples/Overview.tsx +2 -2
  551. package/dist/mdx/react/tokens/examples/Tokens.tsx +4 -4
  552. package/dist/mdx/react/tooltip/Tooltip.mdx +31 -13
  553. package/dist/mdx/react/tooltip/examples/Default.tsx +1 -1
  554. package/dist/mdx/react/tooltip/examples/DescriptionType.tsx +3 -3
  555. package/dist/mdx/react/tooltip/examples/Ellipsis.tsx +8 -8
  556. package/dist/mdx/react/tooltip/examples/Placements.tsx +13 -14
  557. package/dist/mdx/react/tooltip/examples/UseTooltip.tsx +2 -2
  558. package/dist/mdx/style-props/STYLE_PROPS.mdx +1 -1
  559. package/dist/mdx/style-props/stylePropsMigrationCodemod.mdx +1 -1
  560. package/dist/mdx/style-props/stylePropsMigrationOverview.mdx +20 -20
  561. package/dist/mdx/styling/mdx/CreateStyles.mdx +32 -31
  562. package/dist/mdx/styling/mdx/CustomizingStyles.mdx +4 -4
  563. package/dist/mdx/styling/mdx/MergingStyles.mdx +6 -4
  564. package/dist/mdx/styling/mdx/Overview.mdx +15 -15
  565. package/dist/mdx/styling/mdx/Stencils.mdx +32 -30
  566. package/dist/mdx/styling/mdx/Utilities.mdx +135 -27
  567. package/dist/mdx/styling/mdx/examples/CSProp.tsx +7 -9
  568. package/dist/mdx/styling/mdx/examples/CreateModifiers.tsx +1 -1
  569. package/dist/mdx/styling/mdx/examples/CreateStencil.tsx +10 -9
  570. package/dist/mdx/styling/mdx/examples/CreateStyles.tsx +2 -4
  571. package/dist/mdx/styling/mdx/examples/CustomButton.tsx +16 -23
  572. package/dist/mdx/styling/mdx/examples/CustomIcon.tsx +5 -6
  573. package/dist/mdx/styling/mdx/examples/EmotionButton.tsx +1 -1
  574. package/dist/mdx/styling/mdx/examples/ManualStylesButton.tsx +1 -0
  575. package/dist/mdx/styling/mdx/examples/StyledButton.tsx +13 -15
  576. package/dist/mdx/styling/mdx/examples/StylingButton.tsx +2 -1
  577. package/dist/mdx/styling/mdx/examples/StylingOverrides.tsx +10 -10
  578. package/dist/mdx/tokens/TokenMigrationCodemod.mdx +9 -0
  579. package/dist/mdx/tokens/TokenMigrationFinal.mdx +35 -30
  580. package/dist/mdx/tokens/TokenMigrationInstall.mdx +17 -14
  581. package/dist/mdx/tokens/TokenMigrationMappingColors.mdx +434 -288
  582. package/dist/mdx/tokens/TokenMigrationMappingSystem.mdx +51 -199
  583. package/dist/mdx/tokens/TokenMigrationOverview.mdx +23 -41
  584. package/dist/mdx/welcome.mdx +14 -16
  585. package/lib/DescriptionTooltip.tsx +16 -11
  586. package/lib/DownloadLLMFile.tsx +12 -12
  587. package/lib/ExampleCodeBlock.tsx +38 -28
  588. package/lib/MDXElements.tsx +6 -5
  589. package/lib/MoreTooltip.tsx +12 -10
  590. package/lib/Specifications.tsx +30 -17
  591. package/lib/StorybookStatusIndicator.tsx +32 -20
  592. package/lib/StylePropsTable.tsx +2 -1
  593. package/lib/SymbolDoc.tsx +2 -1
  594. package/lib/Table.tsx +37 -39
  595. package/lib/Value.tsx +22 -15
  596. package/lib/docs.ts +1 -0
  597. package/lib/stackblitzFiles/App.tsx +7 -21
  598. package/lib/stackblitzFiles/main.tsx +6 -4
  599. package/lib/stackblitzFiles/packageJSONFile.ts +4 -2
  600. package/lib/stackblitzFiles/types/custom-imports.d.ts +0 -9
  601. package/lib/stackblitzFiles/vite.config.ts +1 -3
  602. package/lib/widgetUtils.tsx +42 -43
  603. package/lib/widgets/array.tsx +1 -1
  604. package/lib/widgets/callExpression.tsx +1 -2
  605. package/lib/widgets/canvasColor.tsx +2 -2
  606. package/lib/widgets/conditional.tsx +1 -1
  607. package/lib/widgets/enhancedComponent.tsx +12 -8
  608. package/lib/widgets/external.tsx +1 -2
  609. package/lib/widgets/function.tsx +3 -3
  610. package/lib/widgets/index.ts +1 -1
  611. package/lib/widgets/intersection.tsx +1 -1
  612. package/lib/widgets/model.tsx +1 -1
  613. package/lib/widgets/parenthesis.tsx +1 -1
  614. package/lib/widgets/primitives.tsx +3 -2
  615. package/lib/widgets/qualifiedName.tsx +1 -1
  616. package/lib/widgets/tuple.tsx +1 -1
  617. package/lib/widgets/typeParameter.tsx +1 -1
  618. package/lib/widgets/union.tsx +1 -1
  619. package/package.json +14 -12
  620. package/webpack/extract-exports.js +2 -1
  621. package/dist/mdx/labs-react/combobox/Combobox.mdx +0 -68
  622. package/dist/mdx/labs-react/combobox/examples/Basic.tsx +0 -88
  623. package/dist/mdx/labs-react/combobox/examples/DisabledItem.tsx +0 -88
  624. package/dist/mdx/labs-react/combobox/examples/GroupOfResult.tsx +0 -88
  625. package/dist/mdx/labs-react/combobox/examples/Grow.tsx +0 -88
  626. package/dist/mdx/labs-react/combobox/examples/NoClearButton.tsx +0 -88
  627. package/dist/mdx/labs-react/combobox/examples/RTL.tsx +0 -90
  628. package/dist/mdx/labs-react/search-form/SearchForm.mdx +0 -92
  629. package/dist/mdx/labs-react/search-form/examples/Basic.tsx +0 -63
  630. package/dist/mdx/labs-react/search-form/examples/Collapsed.tsx +0 -64
  631. package/dist/mdx/labs-react/search-form/examples/CustomStyles.tsx +0 -91
  632. package/dist/mdx/labs-react/search-form/examples/CustomTheme.tsx +0 -73
  633. package/dist/mdx/labs-react/search-form/examples/Grow.tsx +0 -64
  634. package/dist/mdx/labs-react/search-form/examples/RTL.tsx +0 -72
  635. package/dist/mdx/labs-react/search-form/examples/Theming.tsx +0 -66
  636. package/dist/mdx/preview-react/avatar/examples/Basic.tsx +0 -5
  637. package/dist/mdx/preview-react/information-highlight/InformationHighlight.mdx +0 -109
  638. package/dist/mdx/preview-react/pill/examples/CustomStyles.tsx +0 -53
  639. package/dist/mdx/preview-react/segmented-control/SegmentedControl.mdx +0 -139
  640. package/dist/mdx/preview-react/segmented-control/examples/Basic.tsx +0 -42
  641. package/dist/mdx/preview-react/select/Select.mdx +0 -107
  642. package/dist/mdx/preview-react/select/examples/Left Label/AlertLeft.tsx +0 -18
  643. package/dist/mdx/preview-react/select/examples/Left Label/DefaultLeft.tsx +0 -17
  644. package/dist/mdx/preview-react/select/examples/Left Label/DefaultWithCustomOptionsLeft.tsx +0 -25
  645. package/dist/mdx/preview-react/select/examples/Left Label/DefaultWithSimpleOptionsLeft.tsx +0 -17
  646. package/dist/mdx/preview-react/select/examples/Left Label/DisabledLeft.tsx +0 -19
  647. package/dist/mdx/preview-react/select/examples/Left Label/ErrorLeft.tsx +0 -18
  648. package/dist/mdx/preview-react/select/examples/Left Label/GrowLeft.tsx +0 -17
  649. package/dist/mdx/preview-react/select/examples/Left Label/ScrollableLeft.tsx +0 -17
  650. package/dist/mdx/preview-react/select/examples/Left Label/index.ts +0 -8
  651. package/dist/mdx/preview-react/select/examples/Top Label/Caution.tsx +0 -16
  652. package/dist/mdx/preview-react/select/examples/Top Label/Default.tsx +0 -15
  653. package/dist/mdx/preview-react/select/examples/Top Label/DefaultWithCustomOptions.tsx +0 -23
  654. package/dist/mdx/preview-react/select/examples/Top Label/DefaultWithSimpleOptions.tsx +0 -15
  655. package/dist/mdx/preview-react/select/examples/Top Label/Disabled.tsx +0 -17
  656. package/dist/mdx/preview-react/select/examples/Top Label/Error.tsx +0 -16
  657. package/dist/mdx/preview-react/select/examples/Top Label/Grow.tsx +0 -15
  658. package/dist/mdx/preview-react/select/examples/Top Label/Scrollable.tsx +0 -13
  659. package/dist/mdx/preview-react/select/examples/Top Label/index.ts +0 -8
  660. package/dist/mdx/preview-react/select/examples/storiesData.tsx +0 -92
  661. package/dist/mdx/react/_examples/mdx/examples/SegmentControlWithText.tsx +0 -119
  662. package/dist/mdx/react/avatar/avatar/Avatar.mdx +0 -109
  663. package/dist/mdx/react/avatar/avatar/examples/Basic.tsx +0 -17
  664. package/dist/mdx/react/avatar/avatar/examples/Button.tsx +0 -20
  665. package/dist/mdx/react/avatar/avatar/examples/CustomStyles.tsx +0 -34
  666. package/dist/mdx/react/avatar/avatar/examples/Image.tsx +0 -25
  667. package/dist/mdx/react/avatar/avatar/examples/LazyLoad.tsx +0 -20
  668. package/dist/mdx/react/avatar/avatar/examples/ObjectFit.tsx +0 -30
  669. package/dist/mdx/react/avatar/avatar/examples/Size.tsx +0 -27
  670. package/dist/mdx/react/avatar/avatar/examples/Variant.tsx +0 -10
  671. package/dist/mdx/react/avatar/avatar/examples/test-avatar.png +0 -0
  672. package/dist/mdx/react/icon/examples/Overview.tsx +0 -42
  673. package/dist/mdx/react/text-area/examples/Caution.tsx +0 -21
  674. package/dist/mdx/react/text-area/examples/Error.tsx +0 -21
  675. package/dist/mdx/react/text-input/examples/Caution.tsx +0 -21
  676. package/dist/mdx/react/text-input/examples/Error.tsx +0 -21
  677. /package/dist/mdx/accessibility/{AccessibilityTesting.mdx → TestingTableWithFormFields.mdx} +0 -0
  678. /package/dist/mdx/{preview-react → react}/avatar/examples/nicholas-avatar.jpg +0 -0
  679. /package/dist/mdx/{preview-react → react}/pill/examples/test-avatar.png +0 -0
@@ -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,66 +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
- })
131
-
132
- <CanvasProvider className={themedBrand}>
133
- <App/>
134
- </CanvasProvider>
135
- ```
136
-
137
- ### Theming Modals and Dialogs
138
-
139
- Previously, the `usePopupStack` hook created a CSS class name that was passed to our Popups. We attached those theme styles to that class name. This allowed the theme to be available in our Popups. But it also created a cascade barrier that blocked the global theme from being applied to our Popup components.
140
- Because we now use global CSS variables, we no longer need this class name to provide the global theme to Popups. But we have to remove this generated class name to allow the global theme to be applied to Popups.
141
-
142
- > **Important:** Passing a `theme` to the `CanvasProvider` **will not** theme components in Modals
143
- > and Dialogs. You can either pass a `className` or define CSS variables at the root.
144
-
145
- **Before in v13**
146
-
147
- ```tsx
148
- // When passing a theme to the Canvas Provider, the `usePopupStack` would grab the theme and generate a class to forward the theme to Modals and Dialogs. This would create a cascade barrier for any CSS variables deinfed at the root.
149
- <CanvasProvider theme={{canvas: {palette: {primary: {main: 'blue'}}}}}>
150
- <Modal>//... rest of modal code</Modal>
151
- </CanvasProvider>
152
- ```
153
-
154
- **After in v14**
155
-
156
- ```tsx
157
- // If you wish to still theme you application and Modals, you can either define the CSS variables at the root level of your application or define a className and pass it to the CanvasProvider.
158
- :root {
159
- --cnvs-brand-primary-base: blue;
160
- }
175
+ import {CanvasProvider} from '@workday/canvas-kit-react/common';
161
176
 
162
- <CanvasProvider>
163
- <Modal>//... rest of modal code</Modal>
164
- </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>;
165
181
  ```
166
182
 
167
183
  ## CSS Token Structure
@@ -184,10 +200,12 @@ Base tokens define foundation palette and design values.
184
200
  Brand tokens define semantic color assignments.
185
201
 
186
202
  ```css
187
- --cnvs-brand-primary-base: var(--cnvs-base-palette-blue-600);
188
- --cnvs-brand-primary-accent: var(--cnvs-base-palette-neutral-0);
189
- --cnvs-brand-error-base: var(--cnvs-base-palette-red-600);
190
- --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);
191
209
  ```
192
210
 
193
211
  ### System Tokens (`system/_variables.css`)
@@ -195,9 +213,8 @@ Brand tokens define semantic color assignments.
195
213
  System tokens define component-specific values.
196
214
 
197
215
  ```css
198
- --cnvs-sys-color-bg-primary-default: var(--cnvs-base-palette-blue-600);
199
- --cnvs-sys-color-text-primary-default: var(--cnvs-base-palette-blue-600);
200
- --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);
201
218
  ```
202
219
 
203
220
  ## Practical Examples
@@ -212,59 +229,89 @@ System tokens define component-specific values.
212
229
 
213
230
  :root {
214
231
  /* Primary brand colors */
215
- --cnvs-brand-primary-base: var(--cnvs-base-palette-magenta-600);
216
- --cnvs-brand-primary-light: var(--cnvs-base-palette-magenta-200);
217
- --cnvs-brand-primary-lighter: var(--cnvs-base-palette-magenta-50);
218
- --cnvs-brand-primary-lightest: var(--cnvs-base-palette-magenta-25);
219
- --cnvs-brand-primary-dark: var(--cnvs-base-palette-magenta-700);
220
- --cnvs-brand-primary-darkest: var(--cnvs-base-palette-magenta-800);
221
- --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);
222
238
  }
223
239
  ```
224
240
 
225
- ### 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:
226
256
 
227
257
  ```tsx
228
- import {createStyles} from '@workday/canvas-kit-styling';
229
- import {brand, base} from '@workday/canvas-tokens-web';
230
- import {PrimaryButton} from '@workday/canvas-kit-react/button';
231
258
  import {CanvasProvider} from '@workday/canvas-kit-react/common';
232
259
 
233
- const greenTheme = createStyles({
234
- [brand.primary.base]: base.green600,
235
- [brand.primary.dark]: base.green700,
236
- [brand.primary.darkest]: base.green800,
237
- [brand.primary.light]: base.green200,
238
- [brand.primary.lighter]: base.green50,
239
- [brand.primary.lightest]: base.green25,
240
- [brand.primary.accent]: base.neutral0,
241
- });
242
-
243
- <CanvasProvider className={greenTheme}>
244
- <PrimaryButton>Click me</PrimaryButton>
260
+ // Set RTL direction
261
+ <CanvasProvider dir="rtl">
262
+ <App />
245
263
  </CanvasProvider>;
246
264
  ```
247
265
 
248
- <ExampleCodeBlock code={Theming} />
266
+ You can also set it on any HTML element:
249
267
 
250
- ### 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:
251
282
 
252
283
  ```css
253
- /* Dark mode theming */
254
- [data-theme='dark'] {
255
- --cnvs-sys-color-bg-default: var(--cnvs-base-palette-neutral-950);
256
- --cnvs-sys-color-text-default: var(--cnvs-base-palette-neutral-50);
257
- --cnvs-sys-color-border-container: var(--cnvs-base-palette-slate-700);
258
- --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;
259
296
  }
260
297
  ```
261
298
 
262
- ### RTL Support
299
+ #### Conditional RTL Styles with `:dir()`
263
300
 
264
- Canvas Kit supports RTL out of the box. Our components are styled to use
265
- [CSS logical properties](https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_logical_properties_and_values).
266
- If you want to add additional styles based on RTL, you can also use the `:dir`
267
- [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
+ ```
268
315
 
269
316
  <ExampleCodeBlock code={RTL} />
270
317
 
@@ -325,31 +372,11 @@ const theme = {
325
372
  Replace theme-based `CanvasProvider` usage with CSS class-based theming.
326
373
 
327
374
  ```tsx
328
- // Before:
329
- <CanvasProvider theme={customTheme}>
330
- <App />
331
- </CanvasProvider>
332
-
333
- // After:
334
- <CanvasProvider className={customThemeClass}>
375
+ <CanvasProvider theme={{canvas: {palette: {primary: {main: 'green'}}}}}>
335
376
  <App />
336
377
  </CanvasProvider>
337
378
  ```
338
379
 
339
- > **Note:** Using a class means you will need to define each property of the palette for full
340
- > control over theming.
341
-
342
- ### Step 4: Test Component Rendering
343
-
344
- Verify that Canvas Kit components (like `PrimaryButton`) correctly use the new CSS variables.
345
-
346
- ```tsx
347
- import {PrimaryButton} from '@workday/canvas-kit-react/button';
348
-
349
- // This should automatically use your CSS variable overrides
350
- <PrimaryButton>Themed Button</PrimaryButton>;
351
- ```
352
-
353
380
  ## Best Practices
354
381
 
355
382
  ### 1. Use Semantic Token Names
@@ -358,7 +385,7 @@ Use brand tokens instead of base tokens for better maintainability.
358
385
 
359
386
  ```css
360
387
  /* ✅ Good - semantic meaning */
361
- --cnvs-brand-primary-base: var(--cnvs-base-palette-blue-600);
388
+ --cnvs-brand-primary-600: var(--cnvs-base-palette-blue-600);
362
389
 
363
390
  /* ❌ Avoid - direct base token usage */
364
391
  --cnvs-base-palette-blue-600: blue;
@@ -368,13 +395,8 @@ Use brand tokens instead of base tokens for better maintainability.
368
395
 
369
396
  Ensure color combinations meet accessibility standards.
370
397
 
371
- ```css
372
- /* Verify contrast ratios for text/background combinations */
373
- :root {
374
- --cnvs-brand-primary-base: var(--cnvs-base-palette-blue-600);
375
- --cnvs-brand-primary-accent: var(--cnvs-base-palette-neutral-0); /* White text */
376
- }
377
- ```
398
+ For a full list of color contrast pairs, view our
399
+ [Color Contrast](https://canvas.workday.com/guidelines/color/color-contrast) documentation.
378
400
 
379
401
  ### 3. Avoid Component Level Theming
380
402
 
@@ -384,15 +406,11 @@ component level.
384
406
  ```tsx
385
407
  /* ✅ Good - App level theming */
386
408
  import {CanvasProvider} from '@workday/canvas-kit-react/common';
387
- import {createStyles} from '@workday/canvas-kit-styling';
388
- import {base, brand} from '@workday/canvas-tokens-web';
389
409
 
390
- const myCustomTheme = createStyles({
391
- [brand.primary.base]: base.magenta600
392
- })
410
+ import {base, brand} from '@workday/canvas-tokens-web';
393
411
 
394
412
 
395
- <CanvasProvider className={myCustomTheme}>
413
+ <CanvasProvider theme={{canvas: {palette: {primary: {main: base.magenta600}}}}}>
396
414
  <App/>
397
415
  </CanvasProvider>
398
416
 
@@ -410,18 +428,6 @@ const myCustomTheme = createStyles({
410
428
 
411
429
  ```
412
430
 
413
- ## Component Compatibility
414
-
415
- All Canvas Kit components in v14 automatically consume CSS variables. No component-level changes are
416
- required when switching from the theme prop approach to CSS variables.
417
-
418
- ### Supported Components
419
-
420
- - ✅ All Button variants (`PrimaryButton`, `SecondaryButton`, etc.)
421
- - ✅ Form components (`TextInput`, `FormField`, etc.)
422
- - ✅ Layout components (`Card`, `Modal`, etc.)
423
- - ✅ Navigation components (`Tabs`, `SidePanel`, etc.)
424
-
425
431
  ## Performance Benefits
426
432
 
427
433
  The CSS variable approach provides several performance improvements:
@@ -446,6 +452,7 @@ Ensure CSS variable files are imported in the correct order.
446
452
  @import '@workday/canvas-tokens-web/css/base/_variables.css';
447
453
  @import '@workday/canvas-tokens-web/css/system/_variables.css';
448
454
  @import '@workday/canvas-tokens-web/css/brand/_variables.css';
455
+ @import '@workday/canvas-tokens-web/css/component/_variables.css';
449
456
 
450
457
  /* Your overrides after imports */
451
458
  :root {
@@ -474,7 +481,7 @@ Check for CSS specificity issues.
474
481
  Verify all required CSS token files are imported and token names are correct.
475
482
 
476
483
  ```tsx
477
- import {brand, base, system} from '@workday/canvas-tokens-web';
484
+ import {base, brand, system} from '@workday/canvas-tokens-web';
478
485
 
479
486
  // Check token availability in development
480
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;