Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

feat(theme): motion token primitives — duration, easing, and component migration (#684)

Cindy Zhanga64fd146645c
diff --git a/apps/storybook/stories/ThemeEditor.stories.tsx b/apps/storybook/stories/ThemeEditor.stories.tsx
index eec8037f24..aa7e522319 100644
--- a/apps/storybook/stories/ThemeEditor.stories.tsx
+++ b/apps/storybook/stories/ThemeEditor.stories.tsx
@@ -33,6 +33,8 @@ import {
typeScaleDefaults,
sizeDefaults,
elevationDefaults,
+ durationDefaults,
+ easingDefaults,
transitionDefaults,
} from '@xds/core/theme';
import {defaultIconRegistry} from '@xds/theme-default';
@@ -78,10 +80,15 @@ const TOKEN_GROUPS = {
description: 'Shadow and elevation tokens',
tokens: elevationDefaults,
},
- transition: {
- label: 'Transition',
- description: 'Animation timing tokens',
- tokens: transitionDefaults,
+ duration: {
+ label: 'Duration',
+ description: 'Motion duration tokens',
+ tokens: durationDefaults,
+ },
+ easing: {
+ label: 'Easing',
+ description: 'Motion easing tokens',
+ tokens: easingDefaults,
},
} as const;
@@ -1314,6 +1321,8 @@ function ThemeEditorComponent() {
...typeScaleDefaults,
...sizeDefaults,
...elevationDefaults,
+ ...durationDefaults,
+ ...easingDefaults,
...transitionDefaults,
}),
[],
diff --git a/packages/core/src/Button/XDSButton.tsx b/packages/core/src/Button/XDSButton.tsx
index 5ed901130f..28c28c4128 100644
--- a/packages/core/src/Button/XDSButton.tsx
+++ b/packages/core/src/Button/XDSButton.tsx
@@ -23,7 +23,8 @@ import {
sizeVars,
spacingVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
fontWeightVars,
lineHeightVars,
@@ -58,7 +59,8 @@ const styles = stylex.create({
fontWeight: fontWeightVars['--font-weight-medium'],
cursor: 'pointer',
transitionProperty: 'background-image, transform',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
transform: {
default: 'scale(1)',
':active': 'scale(0.98)',
diff --git a/packages/core/src/Calendar/styles.ts b/packages/core/src/Calendar/styles.ts
index 9a8b34f25f..f461183e4f 100644
--- a/packages/core/src/Calendar/styles.ts
+++ b/packages/core/src/Calendar/styles.ts
@@ -17,7 +17,8 @@ import {
spacingVars,
sizeVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
fontWeightVars,
} from '../theme/tokens.stylex';
@@ -191,7 +192,8 @@ export const dayCellStyles = stylex.create({
position: 'relative',
zIndex: 1,
transitionProperty: 'background-color, color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
// Expand hit target by 2px on each side to prevent gaps
'::before': {
content: '""',
diff --git a/packages/core/src/CheckboxInput/XDSCheckboxInput.tsx b/packages/core/src/CheckboxInput/XDSCheckboxInput.tsx
index 747195aa16..a72f7fb97f 100644
--- a/packages/core/src/CheckboxInput/XDSCheckboxInput.tsx
+++ b/packages/core/src/CheckboxInput/XDSCheckboxInput.tsx
@@ -26,7 +26,8 @@ import {
spacingVars,
radiusVars,
textSizeVars,
- transitionVars,
+ durationVars,
+ easingVars,
typographyVars,
} from '../theme/tokens.stylex';
import {XDSFieldLabel} from '../Field/XDSFieldLabel';
@@ -71,7 +72,8 @@ const styles = stylex.create({
borderStyle: 'solid',
borderRadius: radiusVars['--radius-1'],
transitionProperty: 'background-color, border-color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
checkboxFocused: {
outline: `2px solid ${colorVars['--color-focus-outline']}`,
diff --git a/packages/core/src/Collapsible/XDSCollapsible.tsx b/packages/core/src/Collapsible/XDSCollapsible.tsx
index f6f69c0937..15874cbdbb 100644
--- a/packages/core/src/Collapsible/XDSCollapsible.tsx
+++ b/packages/core/src/Collapsible/XDSCollapsible.tsx
@@ -26,7 +26,8 @@ import {
fontWeightVars,
spacingVars,
textSizeVars,
- transitionVars,
+ durationVars,
+ easingVars,
} from '../theme/tokens.stylex';
import {useXDSCollapsible} from './useXDSCollapsible';
import {getIcon} from '../Icon/globalIconRegistry';
@@ -55,7 +56,9 @@ const styles = stylex.create({
alignItems: 'center',
justifyContent: 'center',
flexShrink: 0,
- transition: `transform ${transitionVars['--transition-fast']}`,
+ transitionProperty: 'transform',
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
color: colorVars['--color-icon-secondary'],
},
chevronOpen: {
diff --git a/packages/core/src/Dialog/XDSDialog.tsx b/packages/core/src/Dialog/XDSDialog.tsx
index ca43f301af..97e02825e9 100644
--- a/packages/core/src/Dialog/XDSDialog.tsx
+++ b/packages/core/src/Dialog/XDSDialog.tsx
@@ -19,7 +19,8 @@ import * as stylex from '@stylexjs/stylex';
import {
colorVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
elevationVars,
} from '../theme/tokens.stylex';
import {xdsClassName, mergeProps} from '../utils';
@@ -78,7 +79,9 @@ const styles = stylex.create({
default: 'scale(0.95) translateY(8px)',
':where([open])': 'scale(1) translateY(0)',
},
- transition: `opacity ${transitionVars['--transition-normal']}, transform ${transitionVars['--transition-normal']}`,
+ transitionProperty: 'opacity, transform',
+ transitionDuration: durationVars['--duration-medium'],
+ transitionTimingFunction: easingVars['--easing-standard'],
outline: {
default: null,
':focus-visible': `2px solid ${colorVars['--color-focus-outline']}`,
diff --git a/packages/core/src/DropdownMenu/XDSDropdownMenu.tsx b/packages/core/src/DropdownMenu/XDSDropdownMenu.tsx
index de70a6d0b9..2cd9af5b34 100644
--- a/packages/core/src/DropdownMenu/XDSDropdownMenu.tsx
+++ b/packages/core/src/DropdownMenu/XDSDropdownMenu.tsx
@@ -34,7 +34,8 @@ import {
elevationVars,
spacingVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
typographyVars,
textSizeVars,
} from '../theme/tokens.stylex';
@@ -51,7 +52,9 @@ const styles = stylex.create({
backgroundColor: colorVars['--color-surface'],
boxShadow: elevationVars['--elevation-menu'],
opacity: 1,
- transition: `opacity ${transitionVars['--transition-fast']}`,
+ transitionProperty: 'opacity',
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
// Popover container (for anchor positioning)
diff --git a/packages/core/src/Field/inputStyles.stylex.ts b/packages/core/src/Field/inputStyles.stylex.ts
index 51894021a8..091ea90496 100644
--- a/packages/core/src/Field/inputStyles.stylex.ts
+++ b/packages/core/src/Field/inputStyles.stylex.ts
@@ -17,7 +17,8 @@ import {
spacingVars,
radiusVars,
elevationVars,
- transitionVars,
+ durationVars,
+ easingVars,
} from '../theme/tokens.stylex';
/**
@@ -45,7 +46,8 @@ export const inputWrapperStyles = stylex.create({
borderRadius: radiusVars['--radius-2'],
backgroundColor: colorVars['--color-surface'],
transitionProperty: 'border-color, outline, box-shadow',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
boxShadow: {
default: 'none',
':hover': {
diff --git a/packages/core/src/HoverCard/useXDSHoverCard.tsx b/packages/core/src/HoverCard/useXDSHoverCard.tsx
index 3aef8ef44e..12e1c58abf 100644
--- a/packages/core/src/HoverCard/useXDSHoverCard.tsx
+++ b/packages/core/src/HoverCard/useXDSHoverCard.tsx
@@ -26,6 +26,8 @@ import {
} from '../Layer/useXDSLayer';
import {
colorVars,
+ durationVars,
+ easingVars,
elevationVars,
radiusVars,
spacingVars,
@@ -48,8 +50,8 @@ const styles = stylex.create({
},
// Transitions with allow-discrete for display/overlay
transitionProperty: 'opacity, transform, overlay, display',
- transitionDuration: '0.15s',
- transitionTimingFunction: 'ease',
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
transitionBehavior: 'allow-discrete',
// Entry animation starting state
'@starting-style': {
diff --git a/packages/core/src/Link/XDSLink.tsx b/packages/core/src/Link/XDSLink.tsx
index e3a69e74ef..2414b5d6bf 100644
--- a/packages/core/src/Link/XDSLink.tsx
+++ b/packages/core/src/Link/XDSLink.tsx
@@ -19,7 +19,8 @@ import * as stylex from '@stylexjs/stylex';
import {
colorVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
lineHeightVars,
spacingVars,
@@ -58,7 +59,8 @@ const styles = stylex.create({
},
cursor: 'pointer',
transitionProperty: 'color, text-decoration',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
outline: {
default: null,
':focus-visible': `2px solid ${colorVars['--color-focus-outline']}`,
diff --git a/packages/core/src/List/XDSListItem.tsx b/packages/core/src/List/XDSListItem.tsx
index 8bbafc2949..d4a1fa816c 100644
--- a/packages/core/src/List/XDSListItem.tsx
+++ b/packages/core/src/List/XDSListItem.tsx
@@ -22,7 +22,8 @@ import {
spacingVars,
textSizeVars,
lineHeightVars,
- transitionVars,
+ durationVars,
+ easingVars,
} from '../theme/tokens.stylex';
import {XDSListContext} from './XDSListContext';
import {xdsClassName, mergeProps} from '../utils';
@@ -149,7 +150,8 @@ const styles = stylex.create({
interactive: {
cursor: 'pointer',
transitionProperty: 'background-image',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
backgroundImage: {
default: null,
':hover': {
diff --git a/packages/core/src/MobileNav/XDSMobileNav.tsx b/packages/core/src/MobileNav/XDSMobileNav.tsx
index 6ec371a140..5df6c5637c 100644
--- a/packages/core/src/MobileNav/XDSMobileNav.tsx
+++ b/packages/core/src/MobileNav/XDSMobileNav.tsx
@@ -25,7 +25,12 @@
import {useCallback, useEffect, useRef, type ReactNode} from 'react';
import * as stylex from '@stylexjs/stylex';
-import {colorVars, spacingVars} from '../theme/tokens.stylex';
+import {
+ colorVars,
+ durationVars,
+ easingVars,
+ spacingVars,
+} from '../theme/tokens.stylex';
import {XDSButton} from '../Button';
import {XDSIcon} from '../Icon';
import {XDSHeading} from '../Text/XDSHeading';
@@ -37,9 +42,6 @@ import {XDSBaseProps} from '../XDSBaseProps';
// Styles
// =============================================================================
-const SLIDE_DURATION = '0.25s';
-const SLIDE_EASING = 'cubic-bezier(0.4, 0, 0.2, 1)';
-
const styles = stylex.create({
dialog: {
// Reset native <dialog> defaults
@@ -73,7 +75,9 @@ const styles = stylex.create({
backgroundColor: colorVars['--color-overlay'],
backdropFilter: 'blur(2px)',
opacity: 0,
- transition: `opacity ${SLIDE_DURATION} ${SLIDE_EASING}`,
+ transitionProperty: 'opacity',
+ transitionDuration: durationVars['--duration-medium'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
'@media (prefers-reduced-motion: reduce)': {
'::backdrop': {
@@ -95,7 +99,9 @@ const styles = stylex.create({
backgroundColor: colorVars['--color-surface'],
boxSizing: 'border-box',
overflow: 'hidden',
- transition: `transform ${SLIDE_DURATION} ${SLIDE_EASING}`,
+ transitionProperty: 'transform',
+ transitionDuration: durationVars['--duration-medium'],
+ transitionTimingFunction: easingVars['--easing-standard'],
outline: 'none',
'@media (prefers-reduced-motion: reduce)': {
transitionDuration: '0.01s',
diff --git a/packages/core/src/MoreMenu/XDSMoreMenu.tsx b/packages/core/src/MoreMenu/XDSMoreMenu.tsx
index f4473bf30b..a6a34905fd 100644
--- a/packages/core/src/MoreMenu/XDSMoreMenu.tsx
+++ b/packages/core/src/MoreMenu/XDSMoreMenu.tsx
@@ -40,7 +40,8 @@ import {
colorVars,
spacingVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
typographyVars,
textSizeVars,
} from '../theme/tokens.stylex';
@@ -60,7 +61,9 @@ const styles = stylex.create({
backgroundColor: colorVars['--color-surface'],
boxShadow: `0 4px 12px ${colorVars['--color-shadow-elevation']}`,
opacity: 1,
- transition: `opacity ${transitionVars['--transition-fast']}`,
+ transitionProperty: 'opacity',
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
popover: {
minWidth: '160px',
diff --git a/packages/core/src/Pagination/XDSPagination.tsx b/packages/core/src/Pagination/XDSPagination.tsx
index 615be36da9..b6938dd4b0 100644
--- a/packages/core/src/Pagination/XDSPagination.tsx
+++ b/packages/core/src/Pagination/XDSPagination.tsx
@@ -24,7 +24,8 @@ import {
colorVars,
sizeVars,
spacingVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
} from '../theme/tokens.stylex';
import {XDSButton} from '../Button';
@@ -196,7 +197,8 @@ const styles = stylex.create({
backgroundColor: colorVars['--color-deemphasized'],
cursor: 'pointer',
transitionProperty: 'background-color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
outline: {
default: 'none',
':focus-visible': `2px solid ${colorVars['--color-focus-outline']}`,
diff --git a/packages/core/src/Popover/XDSPopover.tsx b/packages/core/src/Popover/XDSPopover.tsx
index 4266be588b..09cbc42126 100644
--- a/packages/core/src/Popover/XDSPopover.tsx
+++ b/packages/core/src/Popover/XDSPopover.tsx
@@ -28,6 +28,8 @@ import {useXDSPopover} from './useXDSPopover';
import type {LayerAlignment, LayerPlacement} from '../Layer/useXDSLayer';
import {
colorVars,
+ durationVars,
+ easingVars,
spacingVars,
radiusVars,
elevationVars,
@@ -180,8 +182,8 @@ const styles = stylex.create({
':popover-open': 'scale(1)',
},
transitionProperty: 'opacity, transform, overlay, display',
- transitionDuration: '0.15s',
- transitionTimingFunction: 'ease',
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
transitionBehavior: 'allow-discrete',
'@starting-style': {
opacity: 0,
diff --git a/packages/core/src/ProgressBar/XDSProgressBar.tsx b/packages/core/src/ProgressBar/XDSProgressBar.tsx
index 81f57199db..be835ade06 100644
--- a/packages/core/src/ProgressBar/XDSProgressBar.tsx
+++ b/packages/core/src/ProgressBar/XDSProgressBar.tsx
@@ -23,7 +23,8 @@ import {
textSizeVars,
fontWeightVars,
lineHeightVars,
- transitionVars,
+ durationVars,
+ easingVars,
} from '../theme/tokens.stylex';
import {xdsClassName, mergeProps} from '../utils';
@@ -185,7 +186,8 @@ const styles = stylex.create({
height: '100%',
borderRadius: radiusVars['--radius-rounded'],
transitionProperty: 'width',
- transitionDuration: transitionVars['--transition-normal'],
+ transitionDuration: durationVars['--duration-medium'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
indeterminateFill: {
height: '100%',
diff --git a/packages/core/src/RadioList/XDSRadioListItem.tsx b/packages/core/src/RadioList/XDSRadioListItem.tsx
index 8b9bc6cddf..503ba8b463 100644
--- a/packages/core/src/RadioList/XDSRadioListItem.tsx
+++ b/packages/core/src/RadioList/XDSRadioListItem.tsx
@@ -19,7 +19,8 @@ import {
colorVars,
spacingVars,
textSizeVars,
- transitionVars,
+ durationVars,
+ easingVars,
typographyVars,
fontWeightVars,
} from '../theme/tokens.stylex';
@@ -58,7 +59,8 @@ const styles = stylex.create({
borderStyle: 'solid',
borderRadius: '50%',
transitionProperty: 'background-color, border-color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
boxSizing: 'border-box',
},
radioUnchecked: {
diff --git a/packages/core/src/Selector/XDSSelector.tsx b/packages/core/src/Selector/XDSSelector.tsx
index a5dcd40085..92c0bf4480 100644
--- a/packages/core/src/Selector/XDSSelector.tsx
+++ b/packages/core/src/Selector/XDSSelector.tsx
@@ -37,7 +37,8 @@ import {
spacingVars,
radiusVars,
elevationVars,
- transitionVars,
+ durationVars,
+ easingVars,
typographyVars,
textSizeVars,
fontWeightVars,
@@ -83,7 +84,8 @@ const styles = stylex.create({
color: colorVars['--color-text-primary'],
cursor: 'pointer',
transitionProperty: 'border-color, outline, box-shadow',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
boxShadow: {
default: 'none',
':hover': {
@@ -111,7 +113,9 @@ const styles = stylex.create({
justifyContent: 'center',
width: 16,
height: 16,
- transition: `transform ${transitionVars['--transition-fast']}`,
+ transitionProperty: 'transform',
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
transformOrigin: 'center',
color: colorVars['--color-icon-secondary'],
},
@@ -133,7 +137,7 @@ const styles = stylex.create({
backgroundColor: colorVars['--color-surface'],
boxShadow: `0 4px 12px ${colorVars['--color-shadow-elevation']}`,
opacity: 1,
- transition: `opacity ${transitionVars['--transition-fast']}`,
+ transition: `opacity ${durationVars['--duration-fast']}`,
},
dropdownHidden: {
opacity: 0,
diff --git a/packages/core/src/SideNav/XDSSideNavCollapseButton.tsx b/packages/core/src/SideNav/XDSSideNavCollapseButton.tsx
index 5bdd1923bb..4a9269691e 100644
--- a/packages/core/src/SideNav/XDSSideNavCollapseButton.tsx
+++ b/packages/core/src/SideNav/XDSSideNavCollapseButton.tsx
@@ -16,7 +16,7 @@
import {useCallback, type ReactNode} from 'react';
import * as stylex from '@stylexjs/stylex';
-import {transitionVars} from '../theme/tokens.stylex';
+import {durationVars, easingVars} from '../theme/tokens.stylex';
import {getIcon} from '../Icon/globalIconRegistry';
import {XDSButton} from '../Button';
import {useXDSSideNavCollapse} from './XDSSideNavCollapseContext';
@@ -31,7 +31,8 @@ const styles = stylex.create({
display: 'inline-flex',
alignItems: 'center',
transitionProperty: 'transform',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
chevronCollapsed: {
transform: 'rotate(180deg)',
diff --git a/packages/core/src/SideNav/XDSSideNavItem.tsx b/packages/core/src/SideNav/XDSSideNavItem.tsx
index 3f9518b4f1..82dbb5a287 100644
--- a/packages/core/src/SideNav/XDSSideNavItem.tsx
+++ b/packages/core/src/SideNav/XDSSideNavItem.tsx
@@ -24,7 +24,8 @@ import {
textSizeVars,
fontWeightVars,
lineHeightVars,
- transitionVars,
+ durationVars,
+ easingVars,
} from '../theme/tokens.stylex';
import {XDSIcon} from '../Icon';
import type {XDSIconType} from '../Icon';
@@ -69,7 +70,8 @@ const styles = stylex.create({
display: 'grid',
gridTemplateRows: '1fr',
transitionProperty: 'grid-template-rows',
- transitionDuration: transitionVars['--transition-normal'],
+ transitionDuration: durationVars['--duration-medium'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
childrenCollapsed: {
gridTemplateRows: '0fr',
@@ -83,7 +85,8 @@ const styles = stylex.create({
display: 'inline-flex',
alignItems: 'center',
transitionProperty: 'transform',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
flexShrink: 0,
},
expandChevronCollapsed: {
diff --git a/packages/core/src/Slider/XDSSlider.tsx b/packages/core/src/Slider/XDSSlider.tsx
index a7a67bad81..8c1f6cba97 100644
--- a/packages/core/src/Slider/XDSSlider.tsx
+++ b/packages/core/src/Slider/XDSSlider.tsx
@@ -26,7 +26,8 @@ import {
colorVars,
spacingVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
typographyVars,
textSizeVars,
} from '../theme/tokens.stylex';
@@ -201,7 +202,8 @@ const styles = stylex.create({
backgroundColor: colorVars['--color-accent'],
transform: 'translate(-50%, -50%)',
transitionProperty: 'background-color, box-shadow',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
outline: 'none',
cursor: 'grab',
zIndex: 1,
diff --git a/packages/core/src/Switch/XDSSwitch.tsx b/packages/core/src/Switch/XDSSwitch.tsx
index 3e925e2a6d..78f09248d9 100644
--- a/packages/core/src/Switch/XDSSwitch.tsx
+++ b/packages/core/src/Switch/XDSSwitch.tsx
@@ -25,7 +25,8 @@ import {
colorVars,
spacingVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
typographyVars,
textSizeVars,
} from '../theme/tokens.stylex';
@@ -91,7 +92,8 @@ const styles = stylex.create({
padding: TRACK_PADDING,
borderRadius: radiusVars['--radius-rounded'],
transitionProperty: 'background-color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
boxSizing: 'border-box',
},
trackFocused: {
@@ -125,7 +127,8 @@ const styles = stylex.create({
borderRadius: radiusVars['--radius-rounded'],
backgroundColor: colorVars['--color-surface'],
transitionProperty: 'transform, width, height',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
thumbOff: {
width: THUMB_SIZE_OFF,
diff --git a/packages/core/src/TabList/XDSTab.tsx b/packages/core/src/TabList/XDSTab.tsx
index 71b1dc250a..41afec0679 100644
--- a/packages/core/src/TabList/XDSTab.tsx
+++ b/packages/core/src/TabList/XDSTab.tsx
@@ -19,7 +19,8 @@ import {
spacingVars,
sizeVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
fontWeightVars,
lineHeightVars,
@@ -83,7 +84,8 @@ const styles = stylex.create({
cursor: 'pointer',
textDecoration: 'none',
transitionProperty: 'color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
outline: {
default: null,
':focus-visible': `2px solid ${colorVars['--color-focus-outline']}`,
@@ -124,7 +126,8 @@ const styles = stylex.create({
},
},
transitionProperty: 'opacity',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
pointerEvents: 'none',
},
icon: {
diff --git a/packages/core/src/TabList/XDSTabMenu.tsx b/packages/core/src/TabList/XDSTabMenu.tsx
index 82e4c02f10..66c3b635d1 100644
--- a/packages/core/src/TabList/XDSTabMenu.tsx
+++ b/packages/core/src/TabList/XDSTabMenu.tsx
@@ -21,7 +21,8 @@ import {
spacingVars,
sizeVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
elevationVars,
textSizeVars,
fontWeightVars,
@@ -78,7 +79,8 @@ const styles = stylex.create({
cursor: 'pointer',
textDecoration: 'none',
transitionProperty: 'color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
outline: {
default: null,
':focus-visible': `2px solid ${colorVars['--color-focus-outline']}`,
@@ -136,7 +138,8 @@ const styles = stylex.create({
},
},
transitionProperty: 'opacity',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
pointerEvents: 'none',
},
chevron: {
@@ -144,7 +147,8 @@ const styles = stylex.create({
height: spacingVars['--spacing-4'],
flexShrink: 0,
transitionProperty: 'transform',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
chevronOpen: {
transform: 'rotate(180deg)',
@@ -175,7 +179,8 @@ const styles = stylex.create({
color: colorVars['--color-text-primary'],
cursor: 'pointer',
transitionProperty: 'background-color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
backgroundColor: {
default: 'transparent',
':hover': {
diff --git a/packages/core/src/Table/XDSTableRow.tsx b/packages/core/src/Table/XDSTableRow.tsx
index afb4aa04ad..6c56197872 100644
--- a/packages/core/src/Table/XDSTableRow.tsx
+++ b/packages/core/src/Table/XDSTableRow.tsx
@@ -14,7 +14,7 @@
import {useContext, type ReactNode} from 'react';
import type {XDSBaseProps} from '../XDSBaseProps';
import * as stylex from '@stylexjs/stylex';
-import {colorVars, transitionVars} from '../theme/tokens.stylex';
+import {colorVars, durationVars, easingVars} from '../theme/tokens.stylex';
import type {StyleXStyles} from '../theme/types';
import {XDSTableContext} from './XDSTableContext';
import {xdsClassName, mergeProps} from '../utils';
@@ -49,7 +49,8 @@ const hoverRowStyles = stylex.create({
},
},
transitionProperty: 'background-color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
});
@@ -63,7 +64,8 @@ const stripedHoverRowStyles = stylex.create({
},
},
transitionProperty: 'background-color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
});
diff --git a/packages/core/src/Token/XDSToken.tsx b/packages/core/src/Token/XDSToken.tsx
index b6aaa57841..09a795f999 100644
--- a/packages/core/src/Token/XDSToken.tsx
+++ b/packages/core/src/Token/XDSToken.tsx
@@ -19,7 +19,8 @@ import {
spacingVars,
radiusVars,
sizeVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
fontWeightVars,
lineHeightVars,
@@ -160,7 +161,8 @@ const styles = stylex.create({
interactive: {
cursor: 'pointer',
transitionProperty: 'background-image',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
backgroundImage: {
default: null,
':hover': {
diff --git a/packages/core/src/Tooltip/useXDSTooltip.tsx b/packages/core/src/Tooltip/useXDSTooltip.tsx
index 2dadbaa561..c926c908e7 100644
--- a/packages/core/src/Tooltip/useXDSTooltip.tsx
+++ b/packages/core/src/Tooltip/useXDSTooltip.tsx
@@ -26,6 +26,8 @@ import {
} from '../Layer/useXDSLayer';
import {
colorVars,
+ durationVars,
+ easingVars,
radiusVars,
spacingVars,
typographyVars,
@@ -54,8 +56,8 @@ const styles = stylex.create({
},
// Transitions with allow-discrete for display/overlay
transitionProperty: 'opacity, transform, overlay, display',
- transitionDuration: '0.1s',
- transitionTimingFunction: 'ease',
+ transitionDuration: durationVars['--duration-fast-min'],
+ transitionTimingFunction: easingVars['--easing-standard'],
transitionBehavior: 'allow-discrete',
// Entry animation starting state
'@starting-style': {
diff --git a/packages/core/src/TopNav/XDSTopNavItem.tsx b/packages/core/src/TopNav/XDSTopNavItem.tsx
index 2f0c6c8854..6dad1a19e8 100644
--- a/packages/core/src/TopNav/XDSTopNavItem.tsx
+++ b/packages/core/src/TopNav/XDSTopNavItem.tsx
@@ -20,7 +20,8 @@ import {
colorVars,
spacingVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
fontWeightVars,
lineHeightVars,
@@ -49,7 +50,8 @@ const styles = stylex.create({
textDecoration: 'none',
cursor: 'pointer',
transitionProperty: 'background-color, color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
backgroundColor: {
default: 'transparent',
':hover': {
diff --git a/packages/core/src/TopNav/XDSTopNavMegaMenu.tsx b/packages/core/src/TopNav/XDSTopNavMegaMenu.tsx
index e4ac2718f6..7f29c4abda 100644
--- a/packages/core/src/TopNav/XDSTopNavMegaMenu.tsx
+++ b/packages/core/src/TopNav/XDSTopNavMegaMenu.tsx
@@ -26,7 +26,8 @@ import {
colorVars,
spacingVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
fontWeightVars,
lineHeightVars,
@@ -59,7 +60,8 @@ const styles = stylex.create({
textDecoration: 'none',
cursor: 'pointer',
transitionProperty: 'background-color, color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
backgroundColor: {
default: 'transparent',
':hover': {
@@ -85,7 +87,8 @@ const styles = stylex.create({
display: 'inline-flex',
alignItems: 'center',
transitionProperty: 'transform',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
chevronOpen: {
transform: 'rotate(180deg)',
@@ -102,8 +105,8 @@ const styles = stylex.create({
':popover-open': 'translateY(0)',
},
transitionProperty: 'opacity, transform, overlay, display',
- transitionDuration: '0.2s',
- transitionTimingFunction: 'ease-out',
+ transitionDuration: durationVars['--duration-medium-min'],
+ transitionTimingFunction: easingVars['--easing-standard'],
transitionBehavior: 'allow-discrete',
'@starting-style': {
opacity: 0,
@@ -163,7 +166,8 @@ const styles = stylex.create({
drawerChevron: {
display: 'inline-flex',
transitionProperty: 'transform',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
drawerChevronExpanded: {
transform: 'rotate(180deg)',
@@ -172,7 +176,8 @@ const styles = stylex.create({
display: 'grid',
gridTemplateRows: '0fr',
transitionProperty: 'grid-template-rows',
- transitionDuration: transitionVars['--transition-normal'],
+ transitionDuration: durationVars['--duration-medium'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
drawerItemsExpanded: {
gridTemplateRows: '1fr',
diff --git a/packages/core/src/TopNav/XDSTopNavMegaMenuItem.tsx b/packages/core/src/TopNav/XDSTopNavMegaMenuItem.tsx
index c88eaa232f..e13b8beec3 100644
--- a/packages/core/src/TopNav/XDSTopNavMegaMenuItem.tsx
+++ b/packages/core/src/TopNav/XDSTopNavMegaMenuItem.tsx
@@ -18,7 +18,8 @@ import {
colorVars,
spacingVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
fontWeightVars,
lineHeightVars,
@@ -44,7 +45,8 @@ const styles = stylex.create({
textDecoration: 'none',
cursor: 'pointer',
transitionProperty: 'background-color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
backgroundColor: {
default: 'transparent',
':hover': {
diff --git a/packages/core/src/TopNav/XDSTopNavMenu.tsx b/packages/core/src/TopNav/XDSTopNavMenu.tsx
index 743ebb77f8..4d6cff09d5 100644
--- a/packages/core/src/TopNav/XDSTopNavMenu.tsx
+++ b/packages/core/src/TopNav/XDSTopNavMenu.tsx
@@ -30,7 +30,8 @@ import {
colorVars,
spacingVars,
radiusVars,
- transitionVars,
+ durationVars,
+ easingVars,
textSizeVars,
fontWeightVars,
lineHeightVars,
@@ -56,7 +57,8 @@ const styles = stylex.create({
textDecoration: 'none',
cursor: 'pointer',
transitionProperty: 'background-color, color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
backgroundColor: {
default: 'transparent',
':hover': {
@@ -82,7 +84,8 @@ const styles = stylex.create({
display: 'inline-flex',
alignItems: 'center',
transitionProperty: 'transform',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
chevronOpen: {
transform: 'rotate(180deg)',
@@ -111,7 +114,8 @@ const styles = stylex.create({
textDecoration: 'none',
cursor: 'pointer',
transitionProperty: 'background-color',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
backgroundColor: {
default: 'transparent',
':hover': {
@@ -171,7 +175,8 @@ const drawerStyles = stylex.create({
chevron: {
display: 'inline-flex',
transitionProperty: 'transform',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
chevronExpanded: {
transform: 'rotate(180deg)',
@@ -180,7 +185,8 @@ const drawerStyles = stylex.create({
display: 'grid',
gridTemplateRows: '0fr',
transitionProperty: 'grid-template-rows',
- transitionDuration: transitionVars['--transition-normal'],
+ transitionDuration: durationVars['--duration-medium'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
itemsExpanded: {
gridTemplateRows: '1fr',
diff --git a/packages/core/src/TreeList/XDSTreeListItem.tsx b/packages/core/src/TreeList/XDSTreeListItem.tsx
index 2a1d968adf..469b861a91 100644
--- a/packages/core/src/TreeList/XDSTreeListItem.tsx
+++ b/packages/core/src/TreeList/XDSTreeListItem.tsx
@@ -19,7 +19,8 @@ import {
spacingVars,
textSizeVars,
lineHeightVars,
- transitionVars,
+ durationVars,
+ easingVars,
} from '../theme/tokens.stylex';
import {getIcon} from '../Icon/globalIconRegistry';
import {
@@ -74,7 +75,8 @@ const styles = stylex.create({
interactive: {
cursor: 'pointer',
transitionProperty: 'background-image',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
backgroundImage: {
default: null,
':hover': {
@@ -178,7 +180,8 @@ const styles = stylex.create({
chevronSvg: {
display: 'flex',
transitionProperty: 'transform',
- transitionDuration: transitionVars['--transition-fast'],
+ transitionDuration: durationVars['--duration-fast'],
+ transitionTimingFunction: easingVars['--easing-standard'],
},
chevronExpanded: {
transform: 'rotate(90deg)',
diff --git a/packages/core/src/theme/defineTheme.ts b/packages/core/src/theme/defineTheme.ts
index 7b8a7cda56..7df8faeb69 100644
--- a/packages/core/src/theme/defineTheme.ts
+++ b/packages/core/src/theme/defineTheme.ts
@@ -36,6 +36,8 @@ import {
sizeDefaults,
radiusDefaults,
elevationDefaults,
+ durationDefaults,
+ easingDefaults,
transitionDefaults,
typographyDefaults,
textSizeDefaults,
@@ -64,6 +66,8 @@ export type XDSTokenName =
| keyof typeof sizeDefaults
| keyof typeof radiusDefaults
| keyof typeof elevationDefaults
+ | keyof typeof durationDefaults
+ | keyof typeof easingDefaults
| keyof typeof transitionDefaults
| keyof typeof typographyDefaults
| keyof typeof textSizeDefaults
@@ -211,6 +215,8 @@ export const xdsTokenDefaults: Record<string, string> = {
...sizeDefaults,
...radiusDefaults,
...elevationDefaults,
+ ...durationDefaults,
+ ...easingDefaults,
...transitionDefaults,
...typographyDefaults,
...textSizeDefaults,
diff --git a/packages/core/src/theme/index.ts b/packages/core/src/theme/index.ts
index fb5d025fb9..8b33e50ef7 100644
--- a/packages/core/src/theme/index.ts
+++ b/packages/core/src/theme/index.ts
@@ -44,6 +44,8 @@ export {
sizeDefaults,
radiusDefaults,
elevationDefaults,
+ durationDefaults,
+ easingDefaults,
transitionDefaults,
typographyDefaults,
textSizeDefaults,
@@ -55,6 +57,8 @@ export {
sizeVars,
radiusVars,
elevationVars,
+ durationVars,
+ easingVars,
transitionVars,
typographyVars,
textSizeVars,
@@ -70,6 +74,8 @@ export type {
SizeVarName,
RadiusVarName,
ElevationVarName,
+ DurationVarName,
+ EasingVarName,
TransitionVarName,
TypographyVarName,
TextSizeVarName,
diff --git a/packages/core/src/theme/tokens.stylex.ts b/packages/core/src/theme/tokens.stylex.ts
index 5f71f03e61..379b9bfbd9 100644
--- a/packages/core/src/theme/tokens.stylex.ts
+++ b/packages/core/src/theme/tokens.stylex.ts
@@ -225,17 +225,51 @@ export const elevationRaw = elevationDefaults;
export const elevationVars = stylex.defineVars(elevationDefaults);
// =============================================================================
-// Transition Tokens
+// Motion Tokens — Duration
+// =============================================================================
+// Duration primitives: pick a duration that matches the visual weight.
+// min/max variants derive from base × ratio (default ratio ≈ 0.75).
+// See motionScale in defineTheme for computed generation.
+
+export const durationDefaults = {
+ '--duration-fast-min': '130ms',
+ '--duration-fast': '175ms',
+ '--duration-fast-max': '230ms',
+ '--duration-medium-min': '310ms',
+ '--duration-medium': '410ms',
+ '--duration-medium-max': '550ms',
+} as const;
+
+export const durationVars = stylex.defineVars(durationDefaults);
+
+export type DurationVarName = keyof typeof durationDefaults;
+
+// =============================================================================
+// Motion Tokens — Easing
+// =============================================================================
+
+export const easingDefaults = {
+ '--easing-standard': 'cubic-bezier(0.24, 1, 0.4, 1)',
+} as const;
+
+export const easingVars = stylex.defineVars(easingDefaults);
+
+export type EasingVarName = keyof typeof easingDefaults;
+
+// =============================================================================
+// Motion Tokens — Deprecated (transition shorthand)
// =============================================================================
+/** @deprecated Use durationVars + easingVars instead */
export const transitionDefaults = {
'--transition-fast': '0.15s ease',
'--transition-normal': '0.2s ease',
} as const;
-/** @deprecated Use transitionDefaults */
+/** @deprecated Use durationVars + easingVars instead */
export const transitionRaw = transitionDefaults;
+/** @deprecated Use durationVars + easingVars instead */
export const transitionVars = stylex.defineVars(transitionDefaults);
// =============================================================================
@@ -320,6 +354,7 @@ export type SpacingVarName = keyof typeof spacingDefaults;
export type SizeVarName = keyof typeof sizeDefaults;
export type RadiusVarName = keyof typeof radiusDefaults;
export type ElevationVarName = keyof typeof elevationDefaults;
+/** @deprecated Use DurationVarName | EasingVarName instead */
export type TransitionVarName = keyof typeof transitionDefaults;
export type TypographyVarName = keyof typeof typographyDefaults;
export type TextSizeVarName = keyof typeof textSizeDefaults;