@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.
- 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 +198703 -185317
- 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 +40 -24
- package/dist/mdx/14.0-VISUAL-CHANGES.mdx +19 -19
- package/dist/mdx/15.0-UPGRADE-GUIDE.mdx +1090 -1
- 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/examples/ContextualHelp/ContextualHelpDialogFocusRedirect.tsx +14 -10
- package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpDialogFocusTrap.tsx +12 -10
- package/dist/mdx/react/_examples/mdx/examples/ContextualHelp/ContextualHelpTooltip.tsx +6 -5
- 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/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 -159
- 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/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}/avatar/examples/nicholas-avatar.jpg +0 -0
- /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
|
-
},
|
|
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,66 +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
|
-
})
|
|
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
|
-
|
|
163
|
-
|
|
164
|
-
|
|
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-
|
|
188
|
-
--cnvs-brand-primary-
|
|
189
|
-
--cnvs-brand-
|
|
190
|
-
--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);
|
|
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-
|
|
199
|
-
--cnvs-sys-
|
|
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-
|
|
216
|
-
--cnvs-brand-primary-
|
|
217
|
-
--cnvs-brand-primary-
|
|
218
|
-
--cnvs-brand-primary-
|
|
219
|
-
--cnvs-brand-primary-
|
|
220
|
-
--cnvs-brand-primary-
|
|
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
|
-
###
|
|
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
|
-
|
|
234
|
-
|
|
235
|
-
|
|
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
|
-
|
|
266
|
+
You can also set it on any HTML element:
|
|
249
267
|
|
|
250
|
-
|
|
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
|
-
/*
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
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
|
-
|
|
299
|
+
#### Conditional RTL Styles with `:dir()`
|
|
263
300
|
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
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
|
-
|
|
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-
|
|
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
|
-
|
|
372
|
-
|
|
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
|
-
|
|
391
|
-
[brand.primary.base]: base.magenta600
|
|
392
|
-
})
|
|
410
|
+
import {base, brand} from '@workday/canvas-tokens-web';
|
|
393
411
|
|
|
394
412
|
|
|
395
|
-
<CanvasProvider
|
|
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 {
|
|
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
|
|
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;
|