An open source design system that's fully customizable and agent ready
TypeScript
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
* @file styles.ts
* @input Uses stylex, theme tokens
* @output Exports calendar styles (structural) and theme styles (customizable)
* @position Shared styles; used by Calendar
*
* Style Organization:
* - *Styles objects: Structural/layout styles (spacing, sizing, positioning)
* - *Theme objects: Themeable styles (colors, borders) that can be overridden
*
* SYNC: When modified, update this header
*/
import * as stylex from '@stylexjs/stylex';
import {
colorVars,
spacingVars,
sizeVars,
radiusVars,
durationVars,
easeVars,
fontWeightVars,
typeScaleVars,
} from '../theme/tokens.stylex';
// =============================================================================
// Calendar Container Styles
// =============================================================================
export const calendarStyles = stylex.create({
calendar: {
display: 'inline-block',
padding: spacingVars['--spacing-3'],
minWidth: '220px',
},
header: {
display: 'flex',
alignItems: 'center',
justifyContent: 'space-between',
marginBottom: spacingVars['--spacing-2'],
gap: spacingVars['--spacing-2'],
},
monthYearLabel: {
flex: 1,
textAlign: 'center',
fontWeight: fontWeightVars['--font-weight-semibold'],
fontSize: typeScaleVars['--text-label-size'],
color: colorVars['--color-text-primary'],
},
// The month is not known yet (server render, hydration): keep the space.
monthsPending: {
visibility: 'hidden',
},
monthsContainer: {
display: 'flex',
// Wraps rather than overflowing: two months side by side need ~488px, so
// an unwrapped row scrolls the document sideways below that and puts the
// next-month button off-viewport (WCAG 1.4.10). Above 488px nothing moves.
flexWrap: 'wrap',
gap: spacingVars['--spacing-4'],
},
/**
* Wrapper for the month nav chevrons. RTL mirroring is applied by
* composing the shared `rtlStyles.mirror` transform onto this wrapper
* at the call site (see Calendar.tsx).
*/
navIcon: {
display: 'inline-flex',
},
});
// =============================================================================
// Month Grid Styles
// =============================================================================
export const monthGridStyles = stylex.create({
monthGrid: {
flex: '1 1 0',
},
dayName: {
width: sizeVars['--size-element-md'],
// Restores the small gap the standalone header used to have below it.
height: `calc(${sizeVars['--size-element-md']} + ${spacingVars['--spacing-1']})`,
paddingBottom: spacingVars['--spacing-1'],
boxSizing: 'border-box',
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
fontSize: typeScaleVars['--text-supporting-size'],
fontWeight: fontWeightVars['--font-weight-normal'],
color: colorVars['--color-text-secondary'],
},
weekNumberHeader: {
width: sizeVars['--size-element-md'],
},
daysGrid: {
display: 'grid',
gridTemplateColumns: 'repeat(7, 1fr)',
},
daysGridWithNumbers: {
gridTemplateColumns: 'auto repeat(7, 1fr)',
},
weekNumber: {
width: sizeVars['--size-element-md'],
height: sizeVars['--size-element-md'],
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
fontSize: typeScaleVars['--text-supporting-size'],
color: colorVars['--color-text-secondary'],
},
weekRow: {
display: 'contents',
},
});
// =============================================================================
// Day Cell Styles - Structural (layout, sizing, positioning)
// =============================================================================
// Half the gap between the day button and its cell — (--size-element-md minus
// --size-element-sm) / 2 — so the band's rounded caps line up with the button
// and the button's ::before bleeds out to meet its neighbour's. Deliberately a
// literal and NOT a spacing token: this is a layout value derived from the two
// size tokens, and pinning it to --spacing-0-5 desynchronises it from them
// (matcha sets that step to 3px, which overlaps adjacent days' hit targets by
// 2px). Deriving it with calc() from the size tokens would be better still and
// would close butter's 4px dead gap; that needs its own measured change.
const BAND_INSET = '2px';
const HIT_BLEED = '-2px';
export const dayCellStyles = stylex.create({
// Cell container
cell: {
position: 'relative',
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
// A minimum, so a row grows with a larger text size and its days never
// reach into the next row. The padding keeps the gap the day's hit bleed
// is sized for at every size.
minHeight: sizeVars['--size-element-md'],
boxSizing: 'border-box',
padding: BAND_INSET,
isolation: 'isolate',
},
// Range background - structural positioning
rangeBg: {
position: 'absolute',
top: BAND_INSET,
bottom: BAND_INSET,
insetInlineStart: 0,
insetInlineEnd: 0,
},
rangeBgRadiusStart: {
insetInlineStart: BAND_INSET,
borderStartStartRadius: radiusVars['--radius-full'],
borderEndStartRadius: radiusVars['--radius-full'],
},
rangeBgRadiusEnd: {
insetInlineEnd: BAND_INSET,
borderStartEndRadius: radiusVars['--radius-full'],
borderEndEndRadius: radiusVars['--radius-full'],
},
rangeInsetStart: {
insetInlineStart: BAND_INSET,
},
rangeInsetEnd: {
insetInlineEnd: BAND_INSET,
},
// Preview background - structural positioning
previewBg: {
position: 'absolute',
top: BAND_INSET,
bottom: BAND_INSET,
insetInlineStart: 0,
insetInlineEnd: 0,
},
previewBgRadiusStart: {
insetInlineStart: BAND_INSET,
borderStartStartRadius: radiusVars['--radius-full'],
borderEndStartRadius: radiusVars['--radius-full'],
},
previewBgRadiusEnd: {
insetInlineEnd: BAND_INSET,
borderStartEndRadius: radiusVars['--radius-full'],
borderEndEndRadius: radiusVars['--radius-full'],
},
previewStart: {
insetInlineStart: BAND_INSET,
borderStartStartRadius: radiusVars['--radius-full'],
borderEndStartRadius: radiusVars['--radius-full'],
},
previewEnd: {
insetInlineEnd: BAND_INSET,
borderStartEndRadius: radiusVars['--radius-full'],
borderEndEndRadius: radiusVars['--radius-full'],
},
// Day button - structural
// A minimum size: under a larger text size the day grows with its number,
// so the number stays inside its own tap target.
day: {
minWidth: sizeVars['--size-element-sm'],
minHeight: sizeVars['--size-element-sm'],
display: 'flex',
alignItems: 'center',
justifyContent: 'center',
borderRadius: radiusVars['--radius-full'],
borderWidth: 0,
borderStyle: 'none',
cursor: {
default: 'pointer',
':is(:disabled,[aria-disabled="true"])': 'default',
},
fontFamily: 'inherit',
fontSize: typeScaleVars['--text-body-size'],
padding: 0,
position: 'relative',
zIndex: 1,
transitionProperty: {
default: 'background-color, color',
'@media (prefers-reduced-motion: reduce)': 'none',
},
transitionDuration: durationVars['--duration-fast'],
transitionTimingFunction: easeVars['--ease-standard'],
// Expand hit target so adjacent days meet with no gap
'::before': {
content: '""',
position: 'absolute',
top: HIT_BLEED,
insetInlineEnd: HIT_BLEED,
bottom: HIT_BLEED,
insetInlineStart: HIT_BLEED,
},
},
// State modifiers - structural only
dayOutside: {
opacity: 0.5,
},
dayToday: {},
dayTodayInRange: {},
daySelected: {},
dayDisabled: {
cursor: 'default',
},
});
// =============================================================================
// Day Cell Theme - Colors and visual appearance (customizable)
// =============================================================================
export const dayCellTheme = stylex.create({
// Range background color
rangeBg: {
backgroundColor: colorVars['--color-accent-muted'],
},
// Preview background (muted overlay)
previewBg: {
backgroundColor: colorVars['--color-overlay-hover'],
},
// Day button - default state
day: {
color: colorVars['--color-text-primary'],
backgroundColor: 'transparent',
},
// Outside days (adjacent months)
dayOutside: {
color: colorVars['--color-text-secondary'],
},
// Today indicator
dayToday: {
boxShadow: `inset 0 0 0 1px ${colorVars['--color-border-emphasized']}`,
},
// Today when inside a selected range
dayTodayInRange: {
boxShadow: `inset 0 0 0 1px ${colorVars['--color-text-primary']}`,
},
// Selected state (single selection or range endpoints)
daySelected: {
// Forced colors (Windows High Contrast) strips the accent fill, which
// leaves the selected date looking exactly like every other day.
// Highlight/HighlightText is the platform convention for a selected
// control (WCAG 1.4.11), and `forced-color-adjust: none` is required
// because this is a <button>: the UA otherwise keeps the native
// ButtonFace surface and ignores the authored fill, the same trap
// ToggleButton documents.
forcedColorAdjust: 'none',
backgroundColor: {
default: colorVars['--color-accent'],
'@media (forced-colors: active)': 'Highlight',
},
color: {
default: colorVars['--color-on-accent'],
'@media (forced-colors: active)': 'HighlightText',
},
},
// Disabled state
dayDisabled: {
opacity: 0.3,
backgroundImage: {
default: 'none',
':hover:where(:not(:disabled,[aria-disabled="true"]))': {
'@media (hover: hover)': 'none',
},
},
},
});