@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.
- package/README.md +6 -6
- package/dist/es6/docgen/createTraversals.d.ts +0 -3
- package/dist/es6/docgen/createTraversals.d.ts.map +1 -1
- package/dist/es6/docgen/docParser.d.ts +1 -1
- package/dist/es6/docgen/docParser.d.ts.map +1 -1
- package/dist/es6/docgen/docParser.js +14 -4
- package/dist/es6/docgen/plugins/componentParser.d.ts +1 -1
- package/dist/es6/docgen/plugins/componentParser.d.ts.map +1 -1
- package/dist/es6/docgen/plugins/componentParser.js +1 -1
- package/dist/es6/docgen/plugins/customTypes.d.ts +1 -1
- package/dist/es6/docgen/plugins/customTypes.d.ts.map +1 -1
- package/dist/es6/docgen/plugins/enhancedComponentParser.d.ts +1 -1
- package/dist/es6/docgen/plugins/enhancedComponentParser.d.ts.map +1 -1
- package/dist/es6/docgen/plugins/enhancedComponentParser.js +2 -1
- package/dist/es6/docgen/plugins/modelParser.d.ts.map +1 -1
- package/dist/es6/docgen/plugins/modelParser.js +4 -4
- package/dist/es6/docgen/traverse.d.ts.map +1 -1
- package/dist/es6/docgen/traverse.js +1 -1
- package/dist/es6/lib/DescriptionTooltip.d.ts +2 -5
- package/dist/es6/lib/DescriptionTooltip.d.ts.map +1 -1
- package/dist/es6/lib/DescriptionTooltip.js +11 -10
- package/dist/es6/lib/DownloadLLMFile.js +11 -11
- package/dist/es6/lib/ExampleCodeBlock.d.ts.map +1 -1
- package/dist/es6/lib/ExampleCodeBlock.js +37 -28
- package/dist/es6/lib/MDXElements.d.ts +1 -1
- package/dist/es6/lib/MDXElements.d.ts.map +1 -1
- package/dist/es6/lib/MDXElements.js +5 -5
- package/dist/es6/lib/MoreTooltip.d.ts.map +1 -1
- package/dist/es6/lib/MoreTooltip.js +1 -1
- package/dist/es6/lib/Specifications.d.ts +3 -1
- package/dist/es6/lib/Specifications.d.ts.map +1 -1
- package/dist/es6/lib/Specifications.js +20 -10
- package/dist/es6/lib/StorybookStatusIndicator.d.ts +2 -2
- package/dist/es6/lib/StorybookStatusIndicator.d.ts.map +1 -1
- package/dist/es6/lib/StorybookStatusIndicator.js +23 -21
- package/dist/es6/lib/StylePropsTable.d.ts.map +1 -1
- package/dist/es6/lib/StylePropsTable.js +1 -1
- package/dist/es6/lib/SymbolDoc.d.ts +1 -1
- package/dist/es6/lib/SymbolDoc.d.ts.map +1 -1
- package/dist/es6/lib/SymbolDoc.js +1 -1
- package/dist/es6/lib/Table.d.ts.map +1 -1
- package/dist/es6/lib/Table.js +33 -10
- package/dist/es6/lib/Value.d.ts.map +1 -1
- package/dist/es6/lib/Value.js +14 -11
- package/dist/es6/lib/docs.d.ts.map +1 -1
- package/dist/es6/lib/docs.js +204588 -183032
- package/dist/es6/lib/specs.js +6142 -1
- package/dist/es6/lib/stackblitzFiles/App.d.ts.map +1 -1
- package/dist/es6/lib/stackblitzFiles/App.js +5 -11
- package/dist/es6/lib/stackblitzFiles/App.tsx +7 -21
- package/dist/es6/lib/stackblitzFiles/main.d.ts +1 -0
- package/dist/es6/lib/stackblitzFiles/main.d.ts.map +1 -1
- package/dist/es6/lib/stackblitzFiles/main.js +4 -3
- package/dist/es6/lib/stackblitzFiles/main.tsx +6 -4
- package/dist/es6/lib/stackblitzFiles/packageJSONFile.d.ts.map +1 -1
- package/dist/es6/lib/stackblitzFiles/packageJSONFile.js +8 -7
- package/dist/es6/lib/stackblitzFiles/packageJSONFile.ts +9 -7
- package/dist/es6/lib/stackblitzFiles/vite.config.d.ts +1 -1
- package/dist/es6/lib/stackblitzFiles/vite.config.d.ts.map +1 -1
- package/dist/es6/lib/stackblitzFiles/vite.config.js +1 -1
- package/dist/es6/lib/stackblitzFiles/vite.config.ts +1 -3
- package/dist/es6/lib/widgetUtils.d.ts.map +1 -1
- package/dist/es6/lib/widgetUtils.js +39 -39
- package/dist/es6/lib/widgets/array.js +1 -1
- package/dist/es6/lib/widgets/callExpression.js +1 -1
- package/dist/es6/lib/widgets/canvasColor.js +3 -2
- package/dist/es6/lib/widgets/conditional.js +1 -1
- package/dist/es6/lib/widgets/enhancedComponent.js +2 -1
- package/dist/es6/lib/widgets/external.js +1 -1
- package/dist/es6/lib/widgets/function.js +2 -2
- package/dist/es6/lib/widgets/index.d.ts +1 -1
- package/dist/es6/lib/widgets/index.d.ts.map +1 -1
- package/dist/es6/lib/widgets/index.js +1 -1
- package/dist/es6/lib/widgets/intersection.js +1 -1
- package/dist/es6/lib/widgets/model.js +1 -1
- package/dist/es6/lib/widgets/parenthesis.js +1 -1
- package/dist/es6/lib/widgets/primitives.js +2 -2
- package/dist/es6/lib/widgets/qualifiedName.js +1 -1
- package/dist/es6/lib/widgets/tuple.js +1 -1
- package/dist/es6/lib/widgets/typeParameter.js +1 -1
- package/dist/es6/lib/widgets/union.js +1 -1
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/CommentBoxWithCharLimit.d.ts +2 -0
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/CommentBoxWithCharLimit.d.ts.map +1 -0
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/CommentBoxWithCharLimit.js +31 -0
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/FilterListWithLiveStatus.js +9 -9
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/HiddenLiveRegion.js +2 -2
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/IconButtonsWithLiveBadges.d.ts.map +1 -1
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/IconButtonsWithLiveBadges.js +4 -4
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/TextInputWithLiveError.d.ts.map +1 -1
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/TextInputWithLiveError.js +3 -3
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/VisibleLiveRegion.d.ts.map +1 -1
- package/dist/es6/mdx/accessibility/examples/AriaLiveRegions/VisibleLiveRegion.js +8 -9
- package/dist/es6/mdx/accessibility/examples/GlobalHeader.js +21 -21
- package/dist/es6/mdx/accessibility/examples/PageStructure/BreadcrumbNavRegion.js +2 -2
- package/dist/es6/mdx/accessibility/examples/PageStructure/FullPageDemo.d.ts.map +1 -1
- package/dist/es6/mdx/accessibility/examples/PageStructure/FullPageDemo.js +16 -10
- package/dist/es6/mdx/accessibility/examples/PageStructure/LandmarkRegions.d.ts +1 -1
- package/dist/es6/mdx/accessibility/examples/PageStructure/LandmarkRegions.d.ts.map +1 -1
- package/dist/es6/mdx/accessibility/examples/PageStructure/LandmarkRegions.js +15 -9
- package/dist/es6/mdx/accessibility/examples/Popups/InlinePopupNoPortal.d.ts +2 -0
- package/dist/es6/mdx/accessibility/examples/Popups/InlinePopupNoPortal.d.ts.map +1 -0
- package/dist/es6/mdx/accessibility/examples/Popups/InlinePopupNoPortal.js +62 -0
- package/dist/es6/mdx/accessibility/examples/Popups/InlinePortalPopup.d.ts +7 -0
- package/dist/es6/mdx/accessibility/examples/Popups/InlinePortalPopup.d.ts.map +1 -0
- package/dist/es6/mdx/accessibility/examples/Popups/InlinePortalPopup.js +65 -0
- package/dist/es6/mdx/accessibility/examples/Popups/PopupAriaOwns.d.ts +7 -0
- package/dist/es6/mdx/accessibility/examples/Popups/PopupAriaOwns.d.ts.map +1 -0
- package/dist/es6/mdx/accessibility/examples/Popups/PopupAriaOwns.js +46 -0
- package/dist/es6/mdx/accessibility/examples/SidePanelWithNavigation.d.ts.map +1 -1
- package/dist/es6/mdx/accessibility/examples/SidePanelWithNavigation.js +16 -16
- package/dist/es6/mdx/accessibility/examples/SidePanelWithOverlay.d.ts.map +1 -1
- package/dist/es6/mdx/accessibility/examples/SidePanelWithOverlay.js +4 -5
- package/dist/es6/mdx/accessibility/examples/Table/WithColumnHeaderFilters.js +8 -8
- package/dist/es6/mdx/accessibility/examples/Table/WithExpandableRows.d.ts.map +1 -1
- package/dist/es6/mdx/accessibility/examples/Table/WithExpandableRows.js +6 -6
- package/dist/es6/mdx/accessibility/examples/Table/WithFormFields.d.ts.map +1 -1
- package/dist/es6/mdx/accessibility/examples/Table/WithFormFields.js +10 -10
- package/dist/es6/mdx/accessibility/examples/Table/WithSelectableRows.js +4 -4
- package/dist/es6/mdx/accessibility/examples/Table/WithSortableColumnHeaders.js +7 -7
- package/dist/es6/mdx/installBlock.d.ts.map +1 -1
- package/dist/es6/mdx/installBlock.js +18 -6
- package/dist/es6/mdx/tokens/StorybookInformationHighlight/index.d.ts.map +1 -1
- package/dist/es6/mdx/tokens/StorybookInformationHighlight/index.js +2 -3
- package/dist/es6/mdx/versionsTable.d.ts.map +1 -1
- package/dist/es6/mdx/versionsTable.js +4 -3
- package/dist/es6/mdx/welcomePage.d.ts.map +1 -1
- package/dist/es6/mdx/welcomePage.js +24 -20
- package/dist/es6/utils/parseSpecFile.d.ts +24 -0
- package/dist/es6/utils/parseSpecFile.d.ts.map +1 -0
- package/dist/es6/utils/parseSpecFile.js +82 -0
- package/dist/mdx/10.0-UPGRADE-GUIDE.mdx +3 -3
- package/dist/mdx/13.0-UPGRADE-GUIDE.mdx +24 -18
- package/dist/mdx/14.0-UPGRADE-GUIDE.mdx +61 -14
- package/dist/mdx/14.0-VISUAL-CHANGES.mdx +19 -19
- package/dist/mdx/15.0-UPGRADE-GUIDE.mdx +1097 -0
- package/dist/mdx/15.0-VISUAL-CHANGES.mdx +151 -0
- package/dist/mdx/5.0-UPGRADE-GUIDE.mdx +3 -3
- package/dist/mdx/7.0-UPGRADE-GUIDE.mdx +4 -4
- package/dist/mdx/8.0-UPGRADE-GUIDE.mdx +5 -5
- package/dist/mdx/9.0-UPGRADE-GUIDE.mdx +2 -2
- package/dist/mdx/CODEMODS.mdx +2 -2
- package/dist/mdx/CONTRIBUTING.mdx +4 -4
- package/dist/mdx/CREATING_COMPOUND_COMPONENTS.mdx +1 -1
- package/dist/mdx/DOCUMENTATION_GUIDELINES.mdx +2 -2
- package/dist/mdx/GETTING_STARTED.mdx +1 -2
- package/dist/mdx/accessibility/AriaLiveRegions.mdx +14 -15
- package/dist/mdx/accessibility/InlinePortals.mdx +20 -0
- package/dist/mdx/accessibility/PageStructure.mdx +3 -2
- package/dist/mdx/accessibility/Popups.mdx +71 -0
- package/dist/mdx/accessibility/WindowsHighContrastThemes.mdx +12 -11
- package/dist/mdx/changelog.mdx +1 -2
- package/dist/mdx/labs-react/ai-ingress-button/examples/Inverse.tsx +2 -2
- package/dist/mdx/preview-react/_examples/mdx/examples/TextInputWithReactHookForm.tsx +11 -12
- package/dist/mdx/preview-react/divider/examples/Basic.tsx +6 -7
- package/dist/mdx/preview-react/divider/examples/CustomSpace.tsx +4 -3
- package/dist/mdx/preview-react/loading-sparkles/LoadingSparkles.mdx +2 -2
- package/dist/mdx/preview-react/loading-sparkles/examples/Basic.tsx +3 -2
- package/dist/mdx/preview-react/loading-sparkles/examples/RTL.tsx +3 -7
- package/dist/mdx/preview-react/multi-select/MultiSelect.mdx +3 -4
- package/dist/mdx/preview-react/multi-select/examples/Basic.tsx +1 -1
- package/dist/mdx/preview-react/multi-select/examples/Complex.tsx +3 -5
- package/dist/mdx/preview-react/multi-select/examples/Controlled.tsx +2 -3
- package/dist/mdx/preview-react/multi-select/examples/Disabled.tsx +1 -1
- package/dist/mdx/preview-react/multi-select/examples/Error.tsx +5 -5
- package/dist/mdx/preview-react/multi-select/examples/Icons.tsx +8 -9
- package/dist/mdx/preview-react/multi-select/examples/InitialSelectedItems.tsx +6 -8
- package/dist/mdx/preview-react/multi-select/examples/Searching.tsx +6 -8
- package/dist/mdx/preview-react/radio/examples/Basic.tsx +2 -1
- package/dist/mdx/preview-react/radio/examples/Caution.tsx +2 -1
- package/dist/mdx/preview-react/radio/examples/Custom.tsx +2 -1
- package/dist/mdx/preview-react/radio/examples/Disabled.tsx +2 -1
- package/dist/mdx/preview-react/radio/examples/Error.tsx +2 -1
- package/dist/mdx/preview-react/radio/examples/Inverse.tsx +5 -4
- package/dist/mdx/preview-react/radio/examples/LabelPosition.tsx +2 -1
- package/dist/mdx/preview-react/radio/examples/NoValue.tsx +2 -1
- package/dist/mdx/preview-react/radio/examples/RefForwarding.tsx +2 -1
- package/dist/mdx/preview-react/radio/examples/Required.tsx +2 -1
- package/dist/mdx/preview-react/radio/examples/StandaloneRadio.tsx +2 -1
- package/dist/mdx/preview-react/side-panel/SidePanel.mdx +20 -8
- package/dist/mdx/preview-react/side-panel/examples/AlwaysOpen.tsx +5 -7
- package/dist/mdx/preview-react/side-panel/examples/Basic.tsx +10 -15
- package/dist/mdx/preview-react/side-panel/examples/ExternalControl.tsx +5 -5
- package/dist/mdx/preview-react/side-panel/examples/HiddenName.tsx +2 -1
- package/dist/mdx/preview-react/side-panel/examples/OnExpandedChange.tsx +3 -2
- package/dist/mdx/preview-react/side-panel/examples/OnStateTransition.tsx +3 -2
- package/dist/mdx/preview-react/side-panel/examples/RightOrigin.tsx +4 -7
- package/dist/mdx/preview-react/side-panel/examples/Variant.tsx +4 -6
- package/dist/mdx/preview-react/side-panel/examples/useDirection.ts +1 -0
- package/dist/mdx/preview-react/status-indicator/StatusIndicator.mdx +9 -2
- package/dist/mdx/preview-react/status-indicator/examples/Custom.tsx +22 -0
- package/dist/mdx/preview-react/status-indicator/examples/Emphasis.tsx +4 -6
- package/dist/mdx/preview-react/status-indicator/examples/Icon.tsx +4 -6
- package/dist/mdx/preview-react/status-indicator/examples/Overflow.tsx +5 -7
- package/dist/mdx/preview-react/status-indicator/examples/Variants.tsx +15 -17
- package/dist/mdx/preview-react/switch/Switch.mdx +84 -0
- package/dist/mdx/preview-react/switch/examples/Basic.tsx +21 -0
- package/dist/mdx/preview-react/switch/examples/Caution.tsx +22 -0
- package/dist/mdx/preview-react/switch/examples/Disabled.tsx +21 -0
- package/dist/mdx/preview-react/switch/examples/Error.tsx +22 -0
- package/dist/mdx/preview-react/switch/examples/LabelPosition.tsx +21 -0
- package/dist/mdx/preview-react/switch/examples/RTL.tsx +24 -0
- package/dist/mdx/preview-react/switch/examples/RefForwarding.tsx +30 -0
- package/dist/mdx/react/_examples/mdx/ContextualHelp.mdx +36 -0
- package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpDialogFocusRedirect.tsx +79 -0
- package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpDialogFocusTrap.tsx +79 -0
- package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpTooltip.tsx +43 -0
- package/dist/mdx/react/_examples/mdx/examples/CookieBanner.tsx +2 -2
- package/dist/mdx/react/_examples/mdx/examples/Density.tsx +43 -42
- package/dist/mdx/react/_examples/mdx/examples/MediaModal.tsx +4 -3
- package/dist/mdx/react/_examples/mdx/examples/PageHeader.tsx +22 -19
- package/dist/mdx/react/_examples/mdx/examples/SelectWithFormik.tsx +8 -12
- package/dist/mdx/react/_examples/mdx/examples/compoundComponent/CustomCard.tsx +10 -12
- package/dist/mdx/react/_examples/mdx/examples/layout/AreaColumnPositioning.tsx +1 -1
- package/dist/mdx/react/_examples/mdx/examples/layout/CustomColumnPositioning.tsx +1 -1
- package/dist/mdx/react/_examples/mdx/examples/layout/CustomColumnWidth.tsx +1 -1
- package/dist/mdx/react/_examples/mdx/examples/layout/FullWidthWith3Columns.tsx +50 -12
- package/dist/mdx/react/_examples/mdx/examples/layout/FullWidthWith3Columns2Rows.tsx +1 -1
- package/dist/mdx/react/_examples/mdx/examples/layout/Masonry.tsx +3 -2
- package/dist/mdx/react/_examples/mdx/examples/layout/ResponsiveColumns.tsx +2 -2
- package/dist/mdx/react/_examples/mdx/examples/layout/Tiled2and3Columns.tsx +1 -1
- package/dist/mdx/react/_examples/mdx/examples/layout/Tiled4and2Columns.tsx +1 -1
- package/dist/mdx/react/action-bar/ActionBar.mdx +4 -4
- package/dist/mdx/react/action-bar/examples/Icons.tsx +1 -1
- package/dist/mdx/react/action-bar/examples/OverflowActionBar.tsx +5 -3
- package/dist/mdx/react/action-bar/examples/OverflowActionBarCustomButtonCount.tsx +1 -0
- package/dist/mdx/{preview-react → react}/avatar/Avatar.mdx +23 -13
- package/dist/mdx/react/avatar/examples/Basic.tsx +5 -0
- package/dist/mdx/{preview-react → react}/avatar/examples/Custom.tsx +1 -1
- package/dist/mdx/{preview-react → react}/avatar/examples/Decorative.tsx +7 -5
- package/dist/mdx/{preview-react → react}/avatar/examples/Image.tsx +1 -1
- package/dist/mdx/{preview-react → react}/avatar/examples/Size.tsx +2 -2
- package/dist/mdx/{preview-react → react}/avatar/examples/Variant.tsx +2 -2
- package/dist/mdx/react/avatar/examples/nicholas-avatar.jpg +0 -0
- package/dist/mdx/react/badge/CountBadge.mdx +1 -1
- package/dist/mdx/react/badge/examples/Basic.tsx +2 -2
- package/dist/mdx/react/badge/examples/CustomLimit.tsx +8 -8
- package/dist/mdx/react/badge/examples/Emphasis.tsx +4 -4
- package/dist/mdx/react/badge/examples/Inverse.tsx +7 -6
- package/dist/mdx/react/badge/examples/NotificationBadge.tsx +8 -7
- package/dist/mdx/react/banner/Banner.mdx +2 -2
- package/dist/mdx/react/banner/examples/IconBanner.tsx +1 -1
- package/dist/mdx/react/banner/examples/RefForwarding.tsx +1 -1
- package/dist/mdx/react/banner/examples/Sticky.tsx +1 -1
- package/dist/mdx/react/banner/examples/StickyAnimation.tsx +7 -7
- package/dist/mdx/react/banner/examples/StickyRTL.tsx +3 -14
- package/dist/mdx/react/banner/examples/ThemedAlert.tsx +4 -5
- package/dist/mdx/react/banner/examples/ThemedError.tsx +5 -6
- package/dist/mdx/react/breadcrumbs/Breadcrumbs.mdx +6 -5
- package/dist/mdx/react/breadcrumbs/examples/CurrentItemTruncation.tsx +1 -0
- package/dist/mdx/react/breadcrumbs/examples/LinkTruncation.tsx +1 -0
- package/dist/mdx/react/breadcrumbs/examples/Overflow.tsx +6 -3
- package/dist/mdx/react/breadcrumbs/examples/RTL.tsx +6 -10
- package/dist/mdx/react/button/button/Button.mdx +11 -12
- package/dist/mdx/react/button/button/Hyperlink.mdx +11 -5
- package/dist/mdx/react/button/button/examples/CustomStyles.tsx +43 -43
- package/dist/mdx/react/button/button/examples/Delete.tsx +4 -4
- package/dist/mdx/react/button/button/examples/ExternalHyperlinkInverse.tsx +3 -3
- package/dist/mdx/react/button/button/examples/ExternalHyperlinkRTL.tsx +10 -0
- package/dist/mdx/react/button/button/examples/HyperlinkInverse.tsx +3 -3
- package/dist/mdx/react/button/button/examples/Primary.tsx +5 -5
- package/dist/mdx/react/button/button/examples/PrimaryInverse.tsx +6 -6
- package/dist/mdx/react/button/button/examples/Secondary.tsx +5 -5
- package/dist/mdx/react/button/button/examples/SecondaryInverse.tsx +6 -6
- package/dist/mdx/react/button/button/examples/StandaloneHyperlink.tsx +2 -2
- package/dist/mdx/react/button/button/examples/Tertiary.tsx +5 -5
- package/dist/mdx/react/button/button/examples/TertiaryInverse.tsx +6 -6
- package/dist/mdx/react/button/button/examples/ThemeOverrides.tsx +6 -6
- package/dist/mdx/react/card/card.mdx +5 -5
- package/dist/mdx/react/card/examples/Basic.tsx +1 -0
- package/dist/mdx/react/card/examples/Borderless.tsx +2 -3
- package/dist/mdx/react/card/examples/CustomStyles.tsx +1 -3
- package/dist/mdx/react/card/examples/Stencils.tsx +9 -10
- package/dist/mdx/react/card/examples/{Filled.tsx → Tonal.tsx} +2 -1
- package/dist/mdx/react/checkbox/Checkbox.mdx +11 -12
- package/dist/mdx/react/checkbox/examples/Basic.tsx +1 -0
- package/dist/mdx/react/checkbox/examples/Caution.tsx +1 -0
- package/dist/mdx/react/checkbox/examples/Disabled.tsx +1 -0
- package/dist/mdx/react/checkbox/examples/Error.tsx +1 -0
- package/dist/mdx/react/checkbox/examples/Indeterminate.tsx +3 -2
- package/dist/mdx/react/checkbox/examples/Inverse.tsx +3 -2
- package/dist/mdx/react/checkbox/examples/LabelPosition.tsx +1 -0
- package/dist/mdx/react/checkbox/examples/RefForwarding.tsx +3 -2
- package/dist/mdx/react/checkbox/examples/Required.tsx +1 -0
- package/dist/mdx/react/collection/mdx/examples/BasicGrid.tsx +3 -3
- package/dist/mdx/react/collection/mdx/examples/DataLoader.tsx +4 -4
- package/dist/mdx/react/collection/mdx/examples/MultiSelection.tsx +3 -3
- package/dist/mdx/react/collection/mdx/examples/OverflowVerticalList.tsx +3 -2
- package/dist/mdx/react/collection/mdx/examples/RovingFocus.tsx +2 -2
- package/dist/mdx/react/collection/mdx/examples/Selection.tsx +3 -3
- package/dist/mdx/react/collection/mdx/examples/StringChildren.tsx +1 -1
- package/dist/mdx/react/collection/mdx/examples/WrappingGrid.tsx +3 -3
- package/dist/mdx/react/color-picker/color-input/ColorInput.mdx +7 -8
- package/dist/mdx/react/color-picker/color-input/examples/Basic.tsx +2 -1
- package/dist/mdx/react/color-picker/color-input/examples/Caution.tsx +2 -1
- package/dist/mdx/react/color-picker/color-input/examples/Checked.tsx +2 -1
- package/dist/mdx/react/color-picker/color-input/examples/Disabled.tsx +2 -1
- package/dist/mdx/react/color-picker/color-input/examples/Error.tsx +2 -1
- package/dist/mdx/react/color-picker/color-input/examples/Grow.tsx +2 -1
- package/dist/mdx/react/color-picker/color-input/examples/LabelPosition.tsx +2 -1
- package/dist/mdx/react/color-picker/color-input/examples/RefForwarding.tsx +2 -1
- package/dist/mdx/react/color-picker/color-input/examples/Required.tsx +2 -1
- package/dist/mdx/react/color-picker/color-input/examples/ValidColorChange.tsx +4 -3
- package/dist/mdx/react/color-picker/color-preview/ColorPreview.mdx +3 -3
- package/dist/mdx/react/color-picker/color-preview/examples/LabelPosition.tsx +2 -1
- package/dist/mdx/react/color-picker/color-preview/examples/RefForwarding.tsx +4 -3
- package/dist/mdx/react/combobox/examples/Autocomplete.tsx +11 -9
- package/dist/mdx/react/common/mdx/CompoundComponentUtilities.mdx +1 -1
- package/dist/mdx/react/common/mdx/Theming.mdx +166 -129
- package/dist/mdx/react/common/mdx/examples/CreateComponent.tsx +10 -4
- package/dist/mdx/react/common/mdx/examples/CreateContainer.tsx +1 -0
- package/dist/mdx/react/common/mdx/examples/CreateElemPropsHook.tsx +3 -2
- package/dist/mdx/react/common/mdx/examples/CreateModelHook.tsx +1 -0
- package/dist/mdx/react/common/mdx/examples/CreateSubcomponent.tsx +2 -1
- package/dist/mdx/react/common/mdx/examples/RTL.tsx +4 -5
- package/dist/mdx/react/common/mdx/examples/ResponsiveStyles.tsx +4 -3
- package/dist/mdx/react/common/mdx/examples/ResponsiveViewport.tsx +4 -3
- package/dist/mdx/react/common/mdx/examples/Theming.tsx +40 -22
- package/dist/mdx/react/dialog/Dialog.mdx +51 -20
- package/dist/mdx/react/dialog/examples/Basic.tsx +4 -3
- package/dist/mdx/react/dialog/examples/DialogWithFallbackPlacements.tsx +20 -12
- package/dist/mdx/react/dialog/examples/Focus.tsx +3 -3
- package/dist/mdx/react/expandable/Expandable.mdx +54 -2
- package/dist/mdx/react/expandable/examples/Avatar.tsx +1 -0
- package/dist/mdx/react/expandable/examples/Depth.tsx +10 -1
- package/dist/mdx/react/expandable/examples/HoistedModel.tsx +26 -21
- package/dist/mdx/react/expandable/examples/LongTitle.tsx +1 -0
- package/dist/mdx/react/expandable/examples/RTL.tsx +2 -7
- package/dist/mdx/react/form-field/FormField.mdx +97 -45
- package/dist/mdx/react/form-field/examples/AllFields.tsx +10 -11
- package/dist/mdx/react/form-field/examples/Basic.tsx +1 -0
- package/dist/mdx/react/form-field/examples/Caution.tsx +8 -5
- package/dist/mdx/react/form-field/examples/Custom.tsx +3 -2
- package/dist/mdx/react/form-field/examples/CustomId.tsx +1 -0
- package/dist/mdx/react/form-field/examples/Disabled.tsx +2 -2
- package/dist/mdx/react/form-field/examples/Error.tsx +3 -3
- package/dist/mdx/react/form-field/examples/GroupedInputs.tsx +14 -14
- package/dist/mdx/react/form-field/examples/Grow.tsx +1 -0
- package/dist/mdx/react/form-field/examples/HiddenLabel.tsx +27 -11
- package/dist/mdx/react/form-field/examples/Hint.tsx +2 -2
- package/dist/mdx/react/form-field/examples/LabelPositionHorizontalEnd.tsx +3 -2
- package/dist/mdx/react/form-field/examples/LabelPositionHorizontalStart.tsx +3 -2
- package/dist/mdx/react/form-field/examples/RefForwarding.tsx +4 -3
- package/dist/mdx/react/form-field/examples/Required.tsx +2 -1
- package/dist/mdx/react/form-field/examples/ThemedErrors.tsx +8 -8
- package/dist/mdx/react/icon/Assets.mdx +174 -17
- package/dist/mdx/react/icon/examples/AccentIconList.tsx +5 -4
- package/dist/mdx/react/icon/examples/AppletIconList.tsx +5 -4
- package/dist/mdx/react/icon/examples/ExpressiveBasic.tsx +41 -0
- package/dist/mdx/react/icon/examples/ExpressiveCustomStyles.tsx +54 -0
- package/dist/mdx/react/icon/examples/{IconList.tsx → ExpressiveIconList.tsx} +20 -13
- package/dist/mdx/react/icon/examples/SVGBasic.tsx +31 -0
- package/dist/mdx/react/icon/examples/SystemBasic.tsx +44 -0
- package/dist/mdx/react/icon/examples/SystemCircleBasic.tsx +34 -0
- package/dist/mdx/react/icon/examples/SystemCustomStyles.tsx +62 -0
- package/dist/mdx/react/icon/examples/SystemIconList.tsx +80 -0
- package/dist/mdx/react/information-highlight/InformationHighlight.mdx +96 -0
- package/dist/mdx/{preview-react → react}/information-highlight/examples/Basic.tsx +1 -1
- package/dist/mdx/{preview-react → react}/information-highlight/examples/Body.tsx +1 -1
- package/dist/mdx/{preview-react → react}/information-highlight/examples/Caution.tsx +2 -2
- package/dist/mdx/{preview-react → react}/information-highlight/examples/Critical.tsx +2 -2
- package/dist/mdx/{preview-react → react}/information-highlight/examples/CustomIconCritical.tsx +5 -6
- package/dist/mdx/{preview-react → react}/information-highlight/examples/Heading.tsx +1 -1
- package/dist/mdx/{preview-react → react}/information-highlight/examples/Informational.tsx +4 -4
- package/dist/mdx/{preview-react → react}/information-highlight/examples/RTL.tsx +6 -11
- package/dist/mdx/react/layout/Box.mdx +13 -13
- package/dist/mdx/react/layout/Flex.mdx +3 -3
- package/dist/mdx/react/layout/Grid.mdx +3 -3
- package/dist/mdx/react/layout/examples/Box/Basic.tsx +9 -2
- package/dist/mdx/react/layout/examples/Flex/Basic.tsx +1 -0
- package/dist/mdx/react/layout/examples/Grid/Basic.tsx +19 -13
- package/dist/mdx/react/layout/examples/Grid/GridCard.tsx +34 -24
- package/dist/mdx/react/layout/examples/Grid/GridLayout.tsx +1 -0
- package/dist/mdx/react/layout/examples/Grid/GridLayoutInteractive.tsx +3 -3
- package/dist/mdx/react/loading-dots/LoadingDots.mdx +1 -1
- package/dist/mdx/react/loading-dots/examples/Accessible.tsx +8 -7
- package/dist/mdx/react/loading-dots/examples/Basic.tsx +1 -0
- package/dist/mdx/react/loading-dots/examples/CustomColorAndAnimation.tsx +6 -4
- package/dist/mdx/react/loading-dots/examples/CustomShape.tsx +7 -7
- package/dist/mdx/react/loading-dots/examples/Inverse.tsx +2 -2
- package/dist/mdx/react/loading-dots/examples/RTL.tsx +3 -7
- package/dist/mdx/react/menu/Menu.mdx +68 -30
- package/dist/mdx/react/menu/examples/Icons.tsx +11 -10
- package/dist/mdx/react/menu/examples/MenuWithFallbackPlacements.tsx +5 -3
- package/dist/mdx/react/menu/examples/Nested.tsx +0 -1
- package/dist/mdx/react/menu/examples/NestedDynamic.tsx +1 -1
- package/dist/mdx/react/menu/examples/SelectableMenu.tsx +13 -2
- package/dist/mdx/react/modal/Modal.mdx +94 -16
- package/dist/mdx/react/modal/examples/Basic.tsx +5 -4
- package/dist/mdx/react/modal/examples/BodyOverflow.tsx +1 -1
- package/dist/mdx/react/modal/examples/CustomFocus.tsx +4 -3
- package/dist/mdx/react/modal/examples/FormModal.tsx +28 -3
- package/dist/mdx/react/modal/examples/FullOverflow.tsx +1 -1
- package/dist/mdx/react/modal/examples/IframeTest.tsx +1 -1
- package/dist/mdx/react/modal/examples/ModalWithPopup.tsx +3 -3
- package/dist/mdx/react/modal/examples/ModalWithPopupRTL.tsx +66 -0
- package/dist/mdx/react/modal/examples/NoTargetRTL.tsx +49 -0
- package/dist/mdx/react/modal/examples/ReturnFocus.tsx +140 -41
- package/dist/mdx/react/modal/examples/StackedModals.tsx +1 -1
- package/dist/mdx/react/modal/examples/WithRadioButtons.tsx +1 -0
- package/dist/mdx/react/modal/examples/WithTooltips.tsx +2 -1
- package/dist/mdx/react/modal/examples/WithoutCloseIcon.tsx +10 -9
- package/dist/mdx/react/pagination/examples/Basic.tsx +0 -1
- package/dist/mdx/react/pagination/examples/HoistedModel.tsx +0 -1
- package/dist/mdx/react/pagination/examples/RTL.tsx +2 -5
- package/dist/mdx/react/pagination/examples/ResponsiveRange.tsx +13 -9
- package/dist/mdx/react/pagination/pagination.mdx +8 -6
- package/dist/mdx/{preview-react → react}/pill/Pill.mdx +3 -3
- package/dist/mdx/{preview-react → react}/pill/examples/Basic.tsx +2 -3
- package/dist/mdx/react/pill/examples/CustomStyles.tsx +52 -0
- package/dist/mdx/{preview-react → react}/pill/examples/WithAvatar.tsx +6 -4
- package/dist/mdx/{preview-react → react}/pill/examples/WithCount.tsx +3 -2
- package/dist/mdx/{preview-react → react}/pill/examples/WithList.tsx +2 -2
- package/dist/mdx/{preview-react → react}/pill/examples/WithReadOnly.tsx +3 -3
- package/dist/mdx/{preview-react → react}/pill/examples/WithRemovable.tsx +6 -5
- package/dist/mdx/react/popup/Popup.mdx +64 -36
- package/dist/mdx/react/popup/examples/Basic.tsx +22 -5
- package/dist/mdx/react/popup/examples/ComboboxWithinPopup.tsx +3 -3
- package/dist/mdx/react/popup/examples/CustomTarget.tsx +3 -2
- package/dist/mdx/react/popup/examples/ExternalWindow.tsx +26 -29
- package/dist/mdx/react/popup/examples/FocusRedirect.tsx +27 -12
- package/dist/mdx/react/popup/examples/FocusTrap.tsx +8 -6
- package/dist/mdx/react/popup/examples/FullScreen.tsx +6 -6
- package/dist/mdx/react/popup/examples/InitialFocus.tsx +115 -11
- package/dist/mdx/react/popup/examples/InlinePopup.tsx +126 -0
- package/dist/mdx/react/popup/examples/MixedPopupTypes.tsx +5 -4
- package/dist/mdx/react/popup/examples/MultiplePopups.tsx +34 -22
- package/dist/mdx/react/popup/examples/NestedPopups.tsx +5 -5
- package/dist/mdx/react/popup/examples/PopupWithFallbackPlacements.tsx +26 -18
- package/dist/mdx/react/popup/examples/PopupWithNonHidablePopup.tsx +1 -1
- package/dist/mdx/react/popup/examples/RTL.tsx +9 -9
- package/dist/mdx/react/popup/examples/ReturnFocusTest.tsx +4 -4
- package/dist/mdx/react/popup/examples/TooltipReturnFocus.tsx +5 -5
- package/dist/mdx/react/radio/Radio.mdx +8 -9
- package/dist/mdx/react/radio/examples/Basic.tsx +4 -3
- package/dist/mdx/react/radio/examples/Caution.tsx +2 -1
- package/dist/mdx/react/radio/examples/Disabled.tsx +2 -1
- package/dist/mdx/react/radio/examples/Error.tsx +2 -1
- package/dist/mdx/react/radio/examples/Inverse.tsx +3 -2
- package/dist/mdx/react/radio/examples/LabelPosition.tsx +2 -1
- package/dist/mdx/react/radio/examples/NoValue.tsx +2 -1
- package/dist/mdx/react/radio/examples/RefForwarding.tsx +2 -1
- package/dist/mdx/react/radio/examples/Required.tsx +2 -1
- package/dist/mdx/react/segmented-control/SegmentedControl.mdx +119 -18
- package/dist/mdx/react/segmented-control/examples/Basic.tsx +32 -28
- package/dist/mdx/{preview-react → react}/segmented-control/examples/Disabled.tsx +2 -2
- package/dist/mdx/{preview-react → react}/segmented-control/examples/Dynamic.tsx +3 -2
- package/dist/mdx/{preview-react → react}/segmented-control/examples/RTL.tsx +4 -4
- package/dist/mdx/{preview-react → react}/segmented-control/examples/Sizes.tsx +4 -3
- package/dist/mdx/{preview-react → react}/segmented-control/examples/TextAndIcon.tsx +2 -1
- package/dist/mdx/{preview-react → react}/segmented-control/examples/TextOnly.tsx +2 -1
- package/dist/mdx/{preview-react → react}/segmented-control/examples/Vertical.tsx +2 -2
- package/dist/mdx/react/select/Select.mdx +26 -20
- package/dist/mdx/react/select/examples/Basic.tsx +2 -1
- package/dist/mdx/react/select/examples/Caution.tsx +2 -1
- package/dist/mdx/react/select/examples/Complex.tsx +2 -1
- package/dist/mdx/react/select/examples/Controlled.tsx +3 -2
- package/dist/mdx/react/select/examples/Disabled.tsx +2 -1
- package/dist/mdx/react/select/examples/DisabledOption.tsx +2 -1
- package/dist/mdx/react/select/examples/Error.tsx +2 -1
- package/dist/mdx/react/select/examples/FetchingDynamicItems.tsx +4 -3
- package/dist/mdx/react/select/examples/GroupedItems.tsx +59 -0
- package/dist/mdx/react/select/examples/Grow.tsx +2 -1
- package/dist/mdx/react/select/examples/HoistedModel.tsx +1 -0
- package/dist/mdx/react/select/examples/InitialSelectedItem.tsx +2 -1
- package/dist/mdx/react/select/examples/LabelPosition.tsx +2 -1
- package/dist/mdx/react/select/examples/MenuHeight.tsx +1 -1
- package/dist/mdx/react/select/examples/Placeholder.tsx +2 -1
- package/dist/mdx/react/select/examples/RefForwarding.tsx +1 -0
- package/dist/mdx/react/select/examples/Required.tsx +2 -1
- package/dist/mdx/react/select/examples/WithIcons.tsx +6 -10
- package/dist/mdx/react/side-panel/SidePanel.mdx +287 -0
- package/dist/mdx/react/side-panel/examples/AlwaysOpen.tsx +50 -0
- package/dist/mdx/react/side-panel/examples/Basic.tsx +33 -0
- package/dist/mdx/react/side-panel/examples/ExternalControl.tsx +60 -0
- package/dist/mdx/react/side-panel/examples/Heading.tsx +43 -0
- package/dist/mdx/react/side-panel/examples/OnStateTransition.tsx +52 -0
- package/dist/mdx/react/side-panel/examples/RightOrigin.tsx +67 -0
- package/dist/mdx/react/side-panel/examples/Variant.tsx +51 -0
- package/dist/mdx/react/side-panel/examples/useDirection.ts +24 -0
- package/dist/mdx/react/skeleton/Skeleton.mdx +1 -1
- package/dist/mdx/react/skeleton/examples/Basic.tsx +8 -6
- package/dist/mdx/react/skeleton/examples/Color.tsx +13 -11
- package/dist/mdx/react/skeleton/examples/Header.tsx +1 -0
- package/dist/mdx/react/skeleton/examples/Shape.tsx +4 -3
- package/dist/mdx/react/skeleton/examples/Simulation.tsx +40 -25
- package/dist/mdx/react/skeleton/examples/Text.tsx +1 -0
- package/dist/mdx/react/status-indicator/StatusIndicator.mdx +1 -1
- package/dist/mdx/react/status-indicator/examples/Basic.tsx +6 -7
- package/dist/mdx/react/status-indicator/examples/Emphasis.tsx +6 -7
- package/dist/mdx/react/status-indicator/examples/Icon.tsx +3 -2
- package/dist/mdx/react/status-indicator/examples/MaxWidth.tsx +6 -7
- package/dist/mdx/react/switch/Switch.mdx +22 -9
- package/dist/mdx/react/switch/examples/Basic.tsx +1 -0
- package/dist/mdx/react/switch/examples/Caution.tsx +1 -0
- package/dist/mdx/react/switch/examples/Disabled.tsx +1 -0
- package/dist/mdx/react/switch/examples/Error.tsx +1 -0
- package/dist/mdx/react/switch/examples/LabelPosition.tsx +1 -0
- package/dist/mdx/react/switch/examples/RefForwarding.tsx +1 -0
- package/dist/mdx/react/table/examples/BaseHtmlTable.tsx +1 -3
- package/dist/mdx/react/table/examples/Basic.tsx +1 -3
- package/dist/mdx/react/table/examples/BasicWithHeading.tsx +3 -5
- package/dist/mdx/react/table/examples/FixedColumn.tsx +8 -8
- package/dist/mdx/react/table/examples/RightToLeft.tsx +3 -5
- package/dist/mdx/react/tabs/Tabs.mdx +10 -9
- package/dist/mdx/react/tabs/examples/AlternativeTabStop.tsx +3 -4
- package/dist/mdx/react/tabs/examples/Basic.tsx +3 -3
- package/dist/mdx/react/tabs/examples/DisabledTab.tsx +3 -3
- package/dist/mdx/react/tabs/examples/DynamicTabs.tsx +2 -1
- package/dist/mdx/react/tabs/examples/HoistedModel.tsx +3 -4
- package/dist/mdx/react/tabs/examples/Icons.tsx +4 -5
- package/dist/mdx/react/tabs/examples/NamedTabs.tsx +3 -3
- package/dist/mdx/react/tabs/examples/OverflowTabs.tsx +2 -2
- package/dist/mdx/react/tabs/examples/RightToLeft.tsx +5 -5
- package/dist/mdx/react/tabs/examples/SinglePanel.tsx +2 -4
- package/dist/mdx/react/testing/examples/Basic.tsx +3 -3
- package/dist/mdx/react/text/LabelText.mdx +1 -1
- package/dist/mdx/react/text/Text.mdx +1 -1
- package/dist/mdx/react/text/examples/BodyText/Basic.tsx +1 -0
- package/dist/mdx/react/text/examples/Heading/Basic.tsx +1 -0
- package/dist/mdx/react/text/examples/LabelText/Basic.tsx +1 -0
- package/dist/mdx/react/text/examples/LabelText/Cursor.tsx +1 -0
- package/dist/mdx/react/text/examples/LabelText/Disabled.tsx +3 -5
- package/dist/mdx/react/text/examples/Subtext/Basic.tsx +1 -0
- package/dist/mdx/react/text/examples/Text/Basic.tsx +12 -7
- package/dist/mdx/react/text/examples/Title/Basic.tsx +1 -0
- package/dist/mdx/react/text-area/TextArea.mdx +44 -18
- package/dist/mdx/react/text-area/examples/Basic.tsx +1 -0
- package/dist/mdx/react/text-area/examples/Disabled.tsx +1 -0
- package/dist/mdx/react/text-area/examples/Grow.tsx +1 -0
- package/dist/mdx/react/text-area/examples/LabelPosition.tsx +1 -0
- package/dist/mdx/react/text-area/examples/Placeholder.tsx +1 -0
- package/dist/mdx/react/text-area/examples/RefForwarding.tsx +1 -0
- package/dist/mdx/react/text-area/examples/Required.tsx +1 -0
- package/dist/mdx/react/text-area/examples/ResizeConstraints.tsx +1 -0
- package/dist/mdx/react/text-input/TextInput.mdx +43 -18
- package/dist/mdx/react/text-input/examples/Basic.tsx +1 -0
- package/dist/mdx/react/text-input/examples/Disabled.tsx +1 -0
- package/dist/mdx/react/text-input/examples/Grow.tsx +1 -0
- package/dist/mdx/react/text-input/examples/Icons.tsx +25 -21
- package/dist/mdx/react/text-input/examples/LabelPosition.tsx +1 -0
- package/dist/mdx/react/text-input/examples/Placeholder.tsx +1 -0
- package/dist/mdx/react/text-input/examples/RefForwarding.tsx +1 -0
- package/dist/mdx/react/text-input/examples/Required.tsx +1 -0
- package/dist/mdx/react/toast/examples/Basic.tsx +2 -1
- package/dist/mdx/react/toast/examples/RTL.tsx +4 -6
- package/dist/mdx/react/toast/examples/ToastAlert.tsx +2 -2
- package/dist/mdx/react/toast/examples/ToastDialog.tsx +2 -1
- package/dist/mdx/react/toast/examples/WithActionLinkAndCloseIcon.tsx +2 -4
- package/dist/mdx/react/toast/examples/WithPopper.tsx +4 -4
- package/dist/mdx/react/toast/toast.mdx +4 -3
- package/dist/mdx/react/tokens/Tokens.mdx +1 -1
- package/dist/mdx/react/tokens/examples/Overview.tsx +2 -2
- package/dist/mdx/react/tokens/examples/Tokens.tsx +4 -4
- package/dist/mdx/react/tooltip/Tooltip.mdx +31 -13
- package/dist/mdx/react/tooltip/examples/Default.tsx +1 -1
- package/dist/mdx/react/tooltip/examples/DescriptionType.tsx +3 -3
- package/dist/mdx/react/tooltip/examples/Ellipsis.tsx +8 -8
- package/dist/mdx/react/tooltip/examples/Placements.tsx +13 -14
- package/dist/mdx/react/tooltip/examples/UseTooltip.tsx +2 -2
- package/dist/mdx/style-props/STYLE_PROPS.mdx +1 -1
- package/dist/mdx/style-props/stylePropsMigrationCodemod.mdx +1 -1
- package/dist/mdx/style-props/stylePropsMigrationOverview.mdx +20 -20
- package/dist/mdx/styling/mdx/CreateStyles.mdx +32 -31
- package/dist/mdx/styling/mdx/CustomizingStyles.mdx +4 -4
- package/dist/mdx/styling/mdx/MergingStyles.mdx +6 -4
- package/dist/mdx/styling/mdx/Overview.mdx +15 -15
- package/dist/mdx/styling/mdx/Stencils.mdx +32 -30
- package/dist/mdx/styling/mdx/Utilities.mdx +135 -27
- package/dist/mdx/styling/mdx/examples/CSProp.tsx +7 -9
- package/dist/mdx/styling/mdx/examples/CreateModifiers.tsx +1 -1
- package/dist/mdx/styling/mdx/examples/CreateStencil.tsx +10 -9
- package/dist/mdx/styling/mdx/examples/CreateStyles.tsx +2 -4
- package/dist/mdx/styling/mdx/examples/CustomButton.tsx +16 -23
- package/dist/mdx/styling/mdx/examples/CustomIcon.tsx +5 -6
- package/dist/mdx/styling/mdx/examples/EmotionButton.tsx +1 -1
- package/dist/mdx/styling/mdx/examples/ManualStylesButton.tsx +1 -0
- package/dist/mdx/styling/mdx/examples/StyledButton.tsx +13 -15
- package/dist/mdx/styling/mdx/examples/StylingButton.tsx +2 -1
- package/dist/mdx/styling/mdx/examples/StylingOverrides.tsx +10 -10
- package/dist/mdx/tokens/TokenMigrationCodemod.mdx +9 -0
- package/dist/mdx/tokens/TokenMigrationFinal.mdx +35 -30
- package/dist/mdx/tokens/TokenMigrationInstall.mdx +17 -14
- package/dist/mdx/tokens/TokenMigrationMappingColors.mdx +434 -288
- package/dist/mdx/tokens/TokenMigrationMappingSystem.mdx +51 -199
- package/dist/mdx/tokens/TokenMigrationOverview.mdx +23 -41
- package/dist/mdx/welcome.mdx +14 -16
- package/lib/DescriptionTooltip.tsx +16 -11
- package/lib/DownloadLLMFile.tsx +12 -12
- package/lib/ExampleCodeBlock.tsx +38 -28
- package/lib/MDXElements.tsx +6 -5
- package/lib/MoreTooltip.tsx +12 -10
- package/lib/Specifications.tsx +30 -17
- package/lib/StorybookStatusIndicator.tsx +32 -20
- package/lib/StylePropsTable.tsx +2 -1
- package/lib/SymbolDoc.tsx +2 -1
- package/lib/Table.tsx +37 -39
- package/lib/Value.tsx +22 -15
- package/lib/docs.ts +1 -0
- package/lib/stackblitzFiles/App.tsx +7 -21
- package/lib/stackblitzFiles/main.tsx +6 -4
- package/lib/stackblitzFiles/packageJSONFile.ts +4 -2
- package/lib/stackblitzFiles/types/custom-imports.d.ts +0 -9
- package/lib/stackblitzFiles/vite.config.ts +1 -3
- package/lib/widgetUtils.tsx +42 -43
- package/lib/widgets/array.tsx +1 -1
- package/lib/widgets/callExpression.tsx +1 -2
- package/lib/widgets/canvasColor.tsx +2 -2
- package/lib/widgets/conditional.tsx +1 -1
- package/lib/widgets/enhancedComponent.tsx +12 -8
- package/lib/widgets/external.tsx +1 -2
- package/lib/widgets/function.tsx +3 -3
- package/lib/widgets/index.ts +1 -1
- package/lib/widgets/intersection.tsx +1 -1
- package/lib/widgets/model.tsx +1 -1
- package/lib/widgets/parenthesis.tsx +1 -1
- package/lib/widgets/primitives.tsx +3 -2
- package/lib/widgets/qualifiedName.tsx +1 -1
- package/lib/widgets/tuple.tsx +1 -1
- package/lib/widgets/typeParameter.tsx +1 -1
- package/lib/widgets/union.tsx +1 -1
- package/package.json +14 -12
- package/webpack/extract-exports.js +2 -1
- package/dist/mdx/labs-react/combobox/Combobox.mdx +0 -68
- package/dist/mdx/labs-react/combobox/examples/Basic.tsx +0 -88
- package/dist/mdx/labs-react/combobox/examples/DisabledItem.tsx +0 -88
- package/dist/mdx/labs-react/combobox/examples/GroupOfResult.tsx +0 -88
- package/dist/mdx/labs-react/combobox/examples/Grow.tsx +0 -88
- package/dist/mdx/labs-react/combobox/examples/NoClearButton.tsx +0 -88
- package/dist/mdx/labs-react/combobox/examples/RTL.tsx +0 -90
- package/dist/mdx/labs-react/search-form/SearchForm.mdx +0 -92
- package/dist/mdx/labs-react/search-form/examples/Basic.tsx +0 -63
- package/dist/mdx/labs-react/search-form/examples/Collapsed.tsx +0 -64
- package/dist/mdx/labs-react/search-form/examples/CustomStyles.tsx +0 -91
- package/dist/mdx/labs-react/search-form/examples/CustomTheme.tsx +0 -73
- package/dist/mdx/labs-react/search-form/examples/Grow.tsx +0 -64
- package/dist/mdx/labs-react/search-form/examples/RTL.tsx +0 -72
- package/dist/mdx/labs-react/search-form/examples/Theming.tsx +0 -66
- package/dist/mdx/preview-react/avatar/examples/Basic.tsx +0 -5
- package/dist/mdx/preview-react/avatar/examples/nicholas-avatar.png +0 -0
- package/dist/mdx/preview-react/information-highlight/InformationHighlight.mdx +0 -109
- package/dist/mdx/preview-react/pill/examples/CustomStyles.tsx +0 -53
- package/dist/mdx/preview-react/segmented-control/SegmentedControl.mdx +0 -139
- package/dist/mdx/preview-react/segmented-control/examples/Basic.tsx +0 -42
- package/dist/mdx/preview-react/select/Select.mdx +0 -107
- package/dist/mdx/preview-react/select/examples/Left Label/AlertLeft.tsx +0 -18
- package/dist/mdx/preview-react/select/examples/Left Label/DefaultLeft.tsx +0 -17
- package/dist/mdx/preview-react/select/examples/Left Label/DefaultWithCustomOptionsLeft.tsx +0 -25
- package/dist/mdx/preview-react/select/examples/Left Label/DefaultWithSimpleOptionsLeft.tsx +0 -17
- package/dist/mdx/preview-react/select/examples/Left Label/DisabledLeft.tsx +0 -19
- package/dist/mdx/preview-react/select/examples/Left Label/ErrorLeft.tsx +0 -18
- package/dist/mdx/preview-react/select/examples/Left Label/GrowLeft.tsx +0 -17
- package/dist/mdx/preview-react/select/examples/Left Label/ScrollableLeft.tsx +0 -17
- package/dist/mdx/preview-react/select/examples/Left Label/index.ts +0 -8
- package/dist/mdx/preview-react/select/examples/Top Label/Caution.tsx +0 -16
- package/dist/mdx/preview-react/select/examples/Top Label/Default.tsx +0 -15
- package/dist/mdx/preview-react/select/examples/Top Label/DefaultWithCustomOptions.tsx +0 -23
- package/dist/mdx/preview-react/select/examples/Top Label/DefaultWithSimpleOptions.tsx +0 -15
- package/dist/mdx/preview-react/select/examples/Top Label/Disabled.tsx +0 -17
- package/dist/mdx/preview-react/select/examples/Top Label/Error.tsx +0 -16
- package/dist/mdx/preview-react/select/examples/Top Label/Grow.tsx +0 -15
- package/dist/mdx/preview-react/select/examples/Top Label/Scrollable.tsx +0 -13
- package/dist/mdx/preview-react/select/examples/Top Label/index.ts +0 -8
- package/dist/mdx/preview-react/select/examples/storiesData.tsx +0 -92
- package/dist/mdx/react/_examples/mdx/examples/SegmentControlWithText.tsx +0 -119
- package/dist/mdx/react/avatar/avatar/Avatar.mdx +0 -109
- package/dist/mdx/react/avatar/avatar/examples/Basic.tsx +0 -17
- package/dist/mdx/react/avatar/avatar/examples/Button.tsx +0 -20
- package/dist/mdx/react/avatar/avatar/examples/CustomStyles.tsx +0 -34
- package/dist/mdx/react/avatar/avatar/examples/Image.tsx +0 -25
- package/dist/mdx/react/avatar/avatar/examples/LazyLoad.tsx +0 -20
- package/dist/mdx/react/avatar/avatar/examples/ObjectFit.tsx +0 -30
- package/dist/mdx/react/avatar/avatar/examples/Size.tsx +0 -27
- package/dist/mdx/react/avatar/avatar/examples/Variant.tsx +0 -10
- package/dist/mdx/react/avatar/avatar/examples/test-avatar.png +0 -0
- package/dist/mdx/react/icon/examples/Overview.tsx +0 -42
- package/dist/mdx/react/text-area/examples/Caution.tsx +0 -21
- package/dist/mdx/react/text-area/examples/Error.tsx +0 -21
- package/dist/mdx/react/text-input/examples/Caution.tsx +0 -21
- package/dist/mdx/react/text-input/examples/Error.tsx +0 -21
- /package/dist/mdx/accessibility/{AccessibilityTesting.mdx → TestingTableWithFormFields.mdx} +0 -0
- /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.
|
|
50
|
+
<Specifications file="./cypress/component/ColorPicker.spec.tsx" name="ColorPreview" />
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import React from 'react';
|
|
2
|
-
|
|
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 {
|
|
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
|
-
<
|
|
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
|
-
},
|
|
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](/
|
|
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
|
|
11
|
-
JavaScript-based theme objects to CSS variables. This change provides better performance,
|
|
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
|
|
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-
|
|
90
|
-
--cnvs-brand-primary-
|
|
91
|
-
--cnvs-brand-primary-
|
|
92
|
-
--cnvs-brand-primary-
|
|
93
|
-
--cnvs-brand-primary-
|
|
94
|
-
--cnvs-brand-primary-
|
|
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 `
|
|
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 {
|
|
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
|
-
|
|
133
|
-
|
|
134
|
-
|
|
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-
|
|
158
|
-
--cnvs-brand-primary-
|
|
159
|
-
--cnvs-brand-
|
|
160
|
-
--cnvs-brand-
|
|
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-
|
|
169
|
-
--cnvs-sys-
|
|
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-
|
|
186
|
-
--cnvs-brand-primary-
|
|
187
|
-
--cnvs-brand-primary-
|
|
188
|
-
--cnvs-brand-primary-
|
|
189
|
-
--cnvs-brand-primary-
|
|
190
|
-
--cnvs-brand-primary-
|
|
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
|
-
###
|
|
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
|
-
|
|
204
|
-
|
|
205
|
-
|
|
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
|
-
|
|
266
|
+
You can also set it on any HTML element:
|
|
219
267
|
|
|
220
|
-
|
|
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
|
-
/*
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
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
|
-
|
|
299
|
+
#### Conditional RTL Styles with `:dir()`
|
|
233
300
|
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
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
|
-
|
|
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-
|
|
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
|
-
|
|
342
|
-
|
|
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
|
-
|
|
361
|
-
[brand.primary.base]: base.magenta600
|
|
362
|
-
})
|
|
410
|
+
import {base, brand} from '@workday/canvas-tokens-web';
|
|
363
411
|
|
|
364
412
|
|
|
365
|
-
<CanvasProvider
|
|
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 {
|
|
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
|
|
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 {
|
|
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
|
|
44
|
+
<Card cs={cardStyles} as="section">
|
|
39
45
|
<Card.Heading>Card Heading</Card.Heading>
|
|
40
46
|
</Card>
|
|
41
47
|
);
|
|
@@ -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,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:
|
|
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
|
-
|
|
3
|
-
import {
|
|
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
|
|
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;
|