@theme-ui/css
Version:
Theme UI CSS lets you write style objects with responsive, theme-aware ergonomic shortcuts. This package powers the `sx` prop in Theme UI.
795 lines (794 loc) • 33.7 kB
TypeScript
import * as CSS from 'csstype';
import type { ThemeUIConfig } from './options';
declare type StandardCSSProperties = CSS.Properties<number | string>;
declare type Empty = undefined | null | false;
/**
* The `css` function accepts arrays as values for mobile-first responsive styles.
* Note that this extends to non-theme values also. For example `display=['none', 'block']`
* will also works.
*
* For more information see: https://styled-system.com/responsive-styles
*/
export declare type ResponsiveStyleValue<T> = T | Empty | Array<T | Empty>;
/**
* All non-vendor-prefixed CSS properties. (Allow `number` to support CSS-in-JS libs,
* since they are converted to pixels)
*/
export interface CSSProperties extends CSS.StandardProperties<number | string>, CSS.SvgProperties<number | string>, CSS.VendorProperties<number | string> {
}
/**
* Map of all CSS pseudo selectors (`:hover`, `:focus`, ...)
*/
export declare type CSSPseudoSelectorProps = {
[K in CSS.Pseudos]?: ThemeUIStyleObject;
};
/**
* CSS as POJO that is compatible with CSS-in-JS libaries.
* Copied directly from [emotion](https://github.com/emotion-js/emotion/blob/ca3ad1c1dcabf78a95b55cc2dc94cad1998a3196/packages/serialize/types/index.d.ts#L45) types
*/
export interface CSSObject extends CSSPropertiesWithMultiValues, CSSPseudosForCSSObject, CSSOthersObjectForCSSObject {
}
declare type CSSPropertiesWithMultiValues = {
[K in keyof CSSProperties]: CSSProperties[K];
};
declare type CSSPseudosForCSSObject = {
[K in CSS.Pseudos]?: CSSObject;
};
declare type CSSInterpolation = undefined | number | string | CSSObject;
interface CSSOthersObjectForCSSObject {
[propertiesName: string]: CSSInterpolation;
}
interface AliasesCSSProperties {
/**
* The **`background-color`** CSS property sets the background color of an element.
*
* **Initial value**: `transparent`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/background-color
*/
bg?: StandardCSSProperties['backgroundColor'];
/**
* The **`margin`** CSS property sets the margin area on all four sides of an element. It is a shorthand for `margin-top`, `margin-right`, `margin-bottom`, and `margin-left`.
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **3** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/margin
*/
m?: StandardCSSProperties['margin'];
/**
* The **`margin-top`** CSS property sets the margin area on the top of an element. A positive value places it farther from its neighbors, while a negative value places it closer.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **3** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/margin-top
*/
mt?: StandardCSSProperties['marginTop'];
/**
* The **`margin-right`** CSS property sets the margin area on the right side of an element. A positive value places it farther from its neighbors, while a negative value places it closer.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **3** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/margin-right
*/
mr?: StandardCSSProperties['marginRight'];
/**
* The **`margin-bottom`** CSS property sets the margin area on the bottom of an element. A positive value places it farther from its neighbors, while a negative value places it closer.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **3** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/margin-bottom
*/
mb?: StandardCSSProperties['marginBottom'];
/**
* The **`margin-left`** CSS property sets the margin area on the left side of an element. A positive value places it farther from its neighbors, while a negative value places it closer.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **3** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/margin-left
*/
ml?: StandardCSSProperties['marginLeft'];
/**
* The **`mx`** is shorthand for using both **`margin-left`** and **`margin-right`** CSS properties. They set the margin area on the left and right side of an element. A positive value placesit
* farther from its neighbors, while a negative value places it closer.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **3** |
*
* @see https://styled-system.com/#margin-props
* @see https://developer.mozilla.org/docs/Web/CSS/margin-left
* @see https://developer.mozilla.org/docs/Web/CSS/margin-right
*/
mx?: StandardCSSProperties['marginLeft'];
/**
* The **`marginX`** is shorthand for using both **`margin-left`** and **`margin-right`** CSS properties. They set the margin area on the left and right side of an element. A positive value
* places it farther from its neighbors, while a negative value places it closer.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **3** |
*
* @see https://styled-system.com/#margin-props
* @see https://developer.mozilla.org/docs/Web/CSS/margin-left
* @see https://developer.mozilla.org/docs/Web/CSS/margin-right
*/
marginX?: StandardCSSProperties['marginLeft'];
/**
* The **`my`** is shorthard for using both **`margin-top`** and **`margin-bottom`** CSS properties. They set the margin area on the top and bottom of an element. A positive value places it
* farther from its neighbors, while a negative value places it closer.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **3** |
*
* @see https://styled-system.com/#margin-props
* @see https://developer.mozilla.org/docs/Web/CSS/margin-top
* @see https://developer.mozilla.org/docs/Web/CSS/margin-bottom
*/
my?: StandardCSSProperties['marginTop'];
/**
* The **`marginY`** is shorthard for using both **`margin-top`** and **`margin-bottom`** CSS properties. They set the margin area on the top and bottom of an element. A positive value places
* it farther from its neighbors, while a negative value places it closer.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **3** |
*
* @see https://styled-system.com/#margin-props
* @see https://developer.mozilla.org/docs/Web/CSS/margin-top
* @see https://developer.mozilla.org/docs/Web/CSS/margin-bottom
*/
marginY?: StandardCSSProperties['marginTop'];
/**
* The **`padding`** CSS property sets the padding area on all four sides of an element. It is a shorthand for `padding-top`, `padding-right`, `padding-bottom`, and `padding-left`.
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/padding
*/
p?: StandardCSSProperties['padding'];
/**
* The **`padding-top`** padding area on the top of an element.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/padding-top
*/
pt?: StandardCSSProperties['paddingTop'];
/**
* The **`padding-right`** CSS property sets the width of the padding area on the right side of an element.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/padding-right
*/
pr?: StandardCSSProperties['paddingRight'];
/**
* The **`padding-bottom`** CSS property sets the height of the padding area on the bottom of an element.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/padding-bottom
*/
pb?: StandardCSSProperties['paddingBottom'];
/**
* The **`padding-left`** CSS property sets the width of the padding area on the left side of an element.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/padding-left
*/
pl?: StandardCSSProperties['paddingLeft'];
/**
* The **`px`** is shorthand property for CSS properties **`padding-left`** and **`padding-right`**. They set the width of the padding area on the left and right side of an element.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://styled-system.com/#padding-props
* @see https://developer.mozilla.org/docs/Web/CSS/padding-left
* @see https://developer.mozilla.org/docs/Web/CSS/padding-right
*/
px?: StandardCSSProperties['paddingLeft'];
/**
* The **`paddingX`** is shorthand property for CSS properties **`padding-left`** and **`padding-right`**. They set the width of the padding area on the left and right side of an element.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://styled-system.com/#padding-props
* @see https://developer.mozilla.org/docs/Web/CSS/padding-left
* @see https://developer.mozilla.org/docs/Web/CSS/padding-right
*/
paddingX?: StandardCSSProperties['paddingLeft'];
/**
* The **`py`** is shorthand property for CSS properties **`padding-top`** and **`padding-bottom`**. They set the width of the padding area on the top and bottom of an element.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://styled-system.com/#padding-props
* @see https://developer.mozilla.org/docs/Web/CSS/padding-top
* @see https://developer.mozilla.org/docs/Web/CSS/padding-bottom
*/
py?: StandardCSSProperties['paddingTop'];
/**
* The **`paddingY`** is shorthand property for CSS properties **`padding-top`** and **`padding-bottom`**. They set the width of the padding area on the top and bottom of an element.
*
* **Initial value**: `0`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://styled-system.com/#padding-props
* @see https://developer.mozilla.org/docs/Web/CSS/padding-top
* @see https://developer.mozilla.org/docs/Web/CSS/padding-bottom
*/
paddingY?: StandardCSSProperties['paddingTop'];
/**
* The **`size`** is a shorthand property for CSS properties **`width`** and **`height`**.
*
* @see https://theme-ui.com/sx-prop#theme-aware-properties
* @see https://developer.mozilla.org/docs/Web/CSS/width
* @see https://developer.mozilla.org/docs/Web/CSS/height
*/
/**
* The **`scrollMarginX`** is shorthand property for CSS properties **`scroll-margin-left`** and **`scroll-margin-right`**. They set the margin of the scroll snap area that is used for snapping the element to the snapport.
*
* @see https://developer.mozilla.org/en-US/docs/Web/CSS/scroll-margin-left
* @see https://developer.mozilla.org/en-US/docs/Web/CSS/scroll-margin-right
*/
scrollMarginX?: StandardCSSProperties['scrollMarginLeft'];
/**
* The **`scrollMarginY`** is shorthand property for CSS properties **`scroll-margin-top`** and **`scroll-margin-bottom`**. They set the margin of the scroll snap area that is used for snapping the element to the snapport.
*
* @see https://developer.mozilla.org/en-US/docs/Web/CSS/scroll-margin-top
* @see https://developer.mozilla.org/en-US/docs/Web/CSS/scroll-margin-bottom
*/
scrollMarginY?: StandardCSSProperties['scrollMarginTop'];
/**
* The **`scrollPaddingX`** is shorthand property for CSS properties **`scroll-padding-left`** and **`scroll-padding-right`**. They set the width of the scroll padding area on the left and right side of an element.
*
* @see https://developer.mozilla.org/en-US/docs/Web/CSS/scroll-padding-left
* @see https://developer.mozilla.org/en-US/docs/Web/CSS/scroll-padding-right
*/
scrollPaddingX?: StandardCSSProperties['scrollPaddingLeft'];
/**
* The **`scrollPaddingY`** is shorthand property for CSS properties **`scroll-padding-top`** and **`scroll-padding-bottom`**. They set the width of the scroll padding area on the top and bottom side of an element.
*
* @see https://developer.mozilla.org/en-US/docs/Web/CSS/scroll-padding-top
* @see https://developer.mozilla.org/en-US/docs/Web/CSS/scroll-padding-bottom
*/
scrollPaddingY?: StandardCSSProperties['scrollPaddingTop'];
size?: StandardCSSProperties['width'];
}
interface OverwriteCSSProperties {
/**
* The **`box-shadow`** CSS property adds shadow effects around an element's frame. You can set multiple effects separated by commas. A box shadow is described by X and Y offsets relative to the
* element, blur and spread radii, and color.
*
* **Initial value**: `none`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :-----: | :-----: | :-----: | :----: | :---: |
* | **10** | **4** | **5.1** | **12** | **9** |
* | 1 _-x-_ | | 3 _-x-_ | | |
*
* @see https://developer.mozilla.org/docs/Web/CSS/box-shadow
*/
boxShadow?: CSS.Property.BoxShadow | number;
/**
* The **`font-weight`** CSS property specifies the weight (or boldness) of the font. The font weights available to you will depend on the `font-family` you are using. Some fonts are only
* available in `normal` and `bold`.
*
* **Initial value**: `normal`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **2** | **1** | **1** | **12** | **3** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/font-weight
*/
fontWeight?: CSS.Property.FontWeight | string;
/**
* The **`border-top-style`** CSS property sets the line style of an element's top `border`.
*
* **Initial value**: `none`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :-----: |
* | **1** | **1** | **1** | **12** | **5.5** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/border-top-style
*/
borderTopStyle?: CSS.Property.BorderTopStyle | string;
/**
* The **`border-bottom-style`** CSS property sets the line style of an element's bottom `border`.
*
* **Initial value**: `none`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :-----: |
* | **1** | **1** | **1** | **12** | **5.5** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/border-bottom-style
*/
borderBottomStyle?: CSS.Property.BorderBottomStyle | string;
/**
* The **`border-right-style`** CSS property sets the line style of an element's right `border`.
*
* **Initial value**: `none`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :-----: |
* | **1** | **1** | **1** | **12** | **5.5** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/border-right-style
*/
borderRightStyle?: CSS.Property.BorderRightStyle | string;
/**
* The **`border-left-style`** CSS property sets the line style of an element's left `border`.
*
* **Initial value**: `none`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :-----: |
* | **1** | **1** | **1** | **12** | **5.5** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/border-left-style
*/
borderLeftStyle?: CSS.Property.BorderLeftStyle | string;
/**
* The **`border-radius`** CSS property rounds the corners of an element's outer border edge. You can set a single radius to make circular corners, or two radii to make elliptical corners.
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :-----: | :-----: | :-----: | :----: | :---: |
* | **4** | **4** | **5** | **12** | **9** |
* | 1 _-x-_ | | 3 _-x-_ | | |
*
* @see https://developer.mozilla.org/docs/Web/CSS/border-radius
*/
borderRadius?: CSS.Property.BorderRadius<string | number>;
/**
* The **`z-index`** CSS property sets the z-order of a positioned element and its descendants or flex items. Overlapping elements with a larger z-index cover those with a smaller one.
*
* **Initial value**: `auto`
*
* | Chrome | Firefox | Safari | Edge | IE |
* | :----: | :-----: | :----: | :----: | :---: |
* | **1** | **1** | **1** | **12** | **4** |
*
* @see https://developer.mozilla.org/docs/Web/CSS/z-index
*/
zIndex?: CSS.Property.ZIndex | string;
}
/**
* Map of all available CSS properties (including aliases and overwrites)
* and their raw value.
*/
export interface ThemeUIExtendedCSSProperties extends Omit<CSSProperties, keyof OverwriteCSSProperties>, AliasesCSSProperties, OverwriteCSSProperties {
}
declare type ThemeUIStyleValue<T> = ResponsiveStyleValue<T | ObjectWithDefault<T> | T[]>;
export declare type StylePropertyValue<T> = ThemeUIStyleValue<Exclude<T, undefined>> | ((theme: Theme) => ThemeUIStyleValue<Exclude<T, undefined>> | undefined) | ThemeUIStyleObject | Empty;
export declare type ThemeUICSSProperties = {
[K in keyof ThemeUIExtendedCSSProperties]: StylePropertyValue<ThemeUIExtendedCSSProperties[K]>;
};
export interface VariantProperty {
/**
* **`Variants`** can be useful for applying complex styles to a component based on a single prop.
*
* @example
* const theme = {
* buttons: {
* primary: {
* p: 3,
* fontWeight: 'bold',
* color: 'white',
* bg: 'primary',
* borderRadius: 2,
* },
* },
* }
* const result = css({
* variant: 'buttons.primary',
* })(theme)
*
* @see https://styled-system.com/variants
*/
variant?: string;
}
export interface ThemeDerivedStyles {
(theme: Theme): ThemeUICSSObject;
}
export declare type Label = {
label?: string;
};
export interface CSSOthersObject {
[k: string]: StylePropertyValue<string | number>;
}
export interface ThemeUICSSObject extends ThemeUICSSProperties, CSSPseudoSelectorProps, CSSOthersObject, VariantProperty, Label {
}
/**
* The `ThemeUIStyleObject` extends [style props](https://emotion.sh/docs/object-styles)
* such that properties that are part of the `Theme` will be transformed to
* their corresponding values. Other valid CSS properties are also allowed.
*/
export declare type ThemeUIStyleObject = ThemeUICSSObject | ThemeDerivedStyles;
export declare type TLengthStyledSystem = string | 0 | number;
export interface ScaleDict<T> {
[K: string]: T | T[] | NestedScaleDict<T> | undefined;
[I: number]: T;
}
export interface ObjectWithDefault<T> {
/**
* Default value in nested scale.
*
* Given theme
* ```
* {
* colors: {
* primary: { __default: '#00f', light: '#33f' }
* }
* }
* ```
* `sx={{ color: 'primary' }}` resolves to `color: #00f`.
*/
__default?: T;
}
export interface NestedScaleDict<T> extends ScaleDict<T>, ObjectWithDefault<T> {
}
/**
* An array or object (possibly nested) of related CSS properties
* @see https://theme-ui.com/theme-spec#theme-scales
*/
export declare type Scale<T> = T[] | ScaleDict<T>;
export declare type NestedScale<T> = T[] | NestedScaleDict<T>;
export declare type ColorOrNestedColorScale = CSS.Property.Color | NestedScale<CSS.Property.Color>;
/**
* Color modes can be used to create a user-configurable dark mode
* or any number of other color modes.
*/
export interface ColorMode extends ScaleDict<CSS.Property.Color> {
/**
* Body background color
*/
background?: ColorOrNestedColorScale;
/**
* Body foreground color
*/
text?: ColorOrNestedColorScale;
/**
* Primary brand color for links, buttons, etc.
*/
primary?: ColorOrNestedColorScale;
/**
* A secondary brand color for alternative styling
*/
secondary?: ColorOrNestedColorScale;
/**
* A contrast color for emphasizing UI
*/
accent?: ColorOrNestedColorScale;
/**
* A background color for highlighting text
*/
highlight?: ColorOrNestedColorScale;
/**
* A faint color for backgrounds, borders, and accents that do not require
* high contrast with the background color
*/
muted?: ColorOrNestedColorScale;
}
export declare type ColorModesScale = ColorMode & {
/**
* Nested color modes can provide overrides when used in conjunction with
* `Theme.initialColorModeName` and `useColorMode()`
*/
modes?: {
[k: string]: ColorMode;
};
};
export interface ThemeStyles {
tr?: ThemeUIStyleObject;
th?: ThemeUIStyleObject;
td?: ThemeUIStyleObject;
em?: ThemeUIStyleObject;
strong?: ThemeUIStyleObject;
div?: ThemeUIStyleObject;
p?: ThemeUIStyleObject;
b?: ThemeUIStyleObject;
i?: ThemeUIStyleObject;
a?: ThemeUIStyleObject;
h1?: ThemeUIStyleObject;
h2?: ThemeUIStyleObject;
h3?: ThemeUIStyleObject;
h4?: ThemeUIStyleObject;
h5?: ThemeUIStyleObject;
h6?: ThemeUIStyleObject;
img?: ThemeUIStyleObject;
pre?: ThemeUIStyleObject;
code?: ThemeUIStyleObject;
ol?: ThemeUIStyleObject;
ul?: ThemeUIStyleObject;
li?: ThemeUIStyleObject;
blockquote?: ThemeUIStyleObject;
hr?: ThemeUIStyleObject;
table?: ThemeUIStyleObject;
delete?: ThemeUIStyleObject;
inlineCode?: ThemeUIStyleObject;
thematicBreak?: ThemeUIStyleObject;
root?: ThemeUIStyleObject;
[key: string]: ThemeUIStyleObject | undefined;
}
export interface Theme {
breakpoints?: Array<string>;
mediaQueries?: {
[size: string]: string;
};
space?: Scale<CSS.Property.Margin<number | string>>;
fontSizes?: Scale<CSS.Property.FontSize<number>>;
fonts?: Scale<CSS.Property.FontFamily>;
fontWeights?: Scale<CSS.Property.FontWeight>;
lineHeights?: Scale<CSS.Property.LineHeight<TLengthStyledSystem>>;
letterSpacings?: Scale<CSS.Property.LetterSpacing<TLengthStyledSystem>>;
sizes?: Scale<CSS.Property.Height<{}> | CSS.Property.Width<{}>>;
borders?: Scale<CSS.Property.Border<{}>>;
borderStyles?: Scale<CSS.Property.Border<{}>>;
borderWidths?: Scale<CSS.Property.BorderWidth<TLengthStyledSystem>>;
radii?: Scale<CSS.Property.BorderRadius<TLengthStyledSystem>>;
shadows?: Scale<CSS.Property.BoxShadow>;
zIndices?: Scale<CSS.Property.ZIndex>;
colorStyles?: Scale<ThemeUICSSProperties>;
textStyles?: Scale<ThemeUICSSProperties>;
opacities?: Scale<CSS.Property.Opacity>;
transitions?: Scale<CSS.Property.Transition>;
config?: ThemeUIConfig;
/**
* @deprecated Deprecated in favor of nesting inside `config`
*
* Enable/disable custom CSS properties/variables if lower browser
* support is required (for eg. IE 11).
*
* References: https://theme-ui.com/color-modes/#turn-off-custom-properties
*/
useCustomProperties?: boolean;
/**
* @deprecated Deprecated in favor of nesting inside `config`
*
* Provide a value here to enable color modes
*/
initialColorModeName?: string;
/**
* @deprecated Deprecated in favor of nesting inside `config`
*
* Provide a value here to set a color mode for printing
*/
printColorModeName?: string;
/**
* @deprecated Deprecated in favor of nesting inside `config`
*
* Adds styles defined in theme.styles.root to the <html> element along with color and background-color
*/
useRootStyles?: boolean;
/**
* @deprecated Deprecated in favor of nesting inside `config`
*
* Initializes the color mode based on the prefers-color-scheme media query
*/
useColorSchemeMediaQuery?: boolean;
/**
* @deprecated Deprecated in favor of nesting inside `config`
*
* Adds a global box-sizing: border-box style
*/
useBorderBox?: boolean;
/**
* @deprecated Deprecated in favor of nesting inside `config`
*
* If false, does not save color mode as a localStorage value.
*/
useLocalStorage?: boolean;
/**
* Define the colors that are available through this theme
*/
colors?: ColorModesScale;
/**
* Colors are transformed into CSS custom properties.
*
* If you need to read their raw values to pass them somewhere where CSS
* custom properties are not supported, use `rawColors`.
*
* Additionally, you can access all the color modes in this objects.
*/
rawColors?: ColorModesScale;
/**
* Styles for elements rendered in MDX can be added to the theme.styles
* object. This is the primary, low-level way to control typographic and
* other styles in markdown content. Styles within this object are processed
* with @styled-system/css and have access to base theme values like colors,
* fonts, etc.
*/
styles?: ThemeStyles;
/**
* You can define additional CSS grid layouts by adding variants to the
* `theme.grids` object. These styles can be used to create a wide variety of
* different reusable layouts.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/grid#variants
*/
grids?: Record<string, ThemeUIStyleObject>;
/**
* Button variants can be defined in the `theme.buttons` object. The `Button`
* component uses `theme.buttons.primary` as its default variant style.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/button#variants
*/
buttons?: Record<string, ThemeUIStyleObject>;
/**
* Text style variants can be defined in the `theme.text` object. The `Text`
* component uses `theme.text.default` as its default variant style.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/text#variants
*/
text?: Record<string, ThemeUIStyleObject>;
/**
* Link variants can be defined in the `theme.links` object. By default the
* `Link` component will use styles defined in `theme.styles.a`.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/link#variants
*/
links?: Record<string, ThemeUIStyleObject>;
/**
* Image style variants can be defined in the `theme.images` object.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/image#variants
*/
images?: Record<string, ThemeUIStyleObject>;
/**
* Card style variants can be defined in `the theme.cards` object. By default
* the `Card` component uses the `theme.cards.primary` variant.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/card#variants
*/
cards?: Record<string, ThemeUIStyleObject>;
/**
* Container variants can be defined in the `theme.layout` object. The
* `Container` component uses `theme.layout.container` as its default variant
* style.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/container#variants
*/
layout?: Record<string, ThemeUIStyleObject>;
/**
* Label variants can be defined in `theme.forms` and the component uses the
* `theme.forms.label` variant by default.
*
* Input variants can be defined in `theme.forms` and the component uses the
* `theme.forms.input` variant by default.
*
* Select variants can be defined in `theme.forms` and the component uses the
* `theme.forms.select` variant by default.
*
* Textarea variants can be defined in `theme.forms` and the component uses
* the `theme.forms.textarea` variant by default.
*
* Radio variants can be defined in `theme.forms` and the component uses the
* `theme.forms.radio` variant by default.
*
* Checkbox variants can be defined in `theme.forms` and the component uses
* the `theme.forms.checkbox` variant by default.
*
* Slider variants can be defined in the `theme.forms` object. The `Slider`
* component uses `theme.forms.slider` as its default variant style.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/label#variants
* @see https://theme-ui.com/components/input#variants
* @see https://theme-ui.com/components/select#variants
* @see https://theme-ui.com/components/textarea#variants
* @see https://theme-ui.com/components/radio#variants
* @see https://theme-ui.com/components/checkbox#variants
* @see https://theme-ui.com/components/slider#variants
*/
forms?: Record<string, ThemeUIStyleObject>;
/**
* Badge variants can be defined in `theme.badges`. The `Badge` component uses
* `theme.badges.primary` as its default variant.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/badge#variants
*/
badges?: Record<string, ThemeUIStyleObject>;
/**
* Alert variants can be defined in `theme.alerts`. The `Alert` component uses
* `theme.alerts.primary` as its default variant.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/alert#variants
*/
alerts?: Record<string, ThemeUIStyleObject>;
/**
* Message variants can be defined in the `theme.messages` object.
*
* @see https://theme-ui.com/theme-spec#variants
* @see https://theme-ui.com/components/variants
* @see https://theme-ui.com/components/message#variants
*/
messages?: Record<string, ThemeUIStyleObject>;
}
export {};