@sanity/ui 2.0.0-alpha.9 → 2.0.0-beta.2

package/dist/index.d.ts

@@ -2,25 +2,62 @@
 
 import {AnimationEventHandler} from 'react'
 import {AriaRole} from 'react'
+import {BaseTheme} from '@sanity/ui/theme'
+import {BoxShadow} from '@sanity/ui/theme'
+import {buildTheme} from '@sanity/ui/theme'
 import {ClipboardEventHandler} from 'react'
-import {ColorTints} from '@sanity/color'
+import {COLOR_CONFIG_BLEND_KEYS} from '@sanity/ui/theme'
+import {COLOR_CONFIG_CARD_KEYS} from '@sanity/ui/theme'
+import {COLOR_CONFIG_CARD_TONES} from '@sanity/ui/theme'
+import {COLOR_CONFIG_STATE_KEYS} from '@sanity/ui/theme'
+import {COLOR_CONFIG_STATE_TONES} from '@sanity/ui/theme'
+import {ColorBlendModeTokenValue} from '@sanity/ui/theme'
+import {ColorConfigBlendKey} from '@sanity/ui/theme'
+import {ColorConfigCardKey} from '@sanity/ui/theme'
+import {ColorConfigCardTone} from '@sanity/ui/theme'
+import {ColorConfigOpacityValue} from '@sanity/ui/theme'
+import {ColorConfigStateKey} from '@sanity/ui/theme'
+import {ColorConfigStateTone} from '@sanity/ui/theme'
+import {ColorConfigValue} from '@sanity/ui/theme'
 import {Component} from 'react'
 import {CompositionEventHandler} from 'react'
+import {createColorTheme} from '@sanity/ui/theme'
+import {CSSObject} from '@sanity/ui/theme'
 import {CSSProperties} from 'react'
 import {DragEventHandler} from 'react'
 import {ElementType} from 'react'
 import {FocusEventHandler} from 'react'
 import {FormEventHandler} from 'react'
 import {ForwardRefExoticComponent} from 'react'
+import {hexToRgb} from '@sanity/ui/theme'
+import {HSL} from '@sanity/ui/theme'
+import {hslToRgb} from '@sanity/ui/theme'
 import {HTMLProps} from 'react'
+import {isColorBlendModeValue} from '@sanity/ui/theme'
+import {isColorButtonMode} from '@sanity/ui/theme'
+import {isColorConfigBaseKey} from '@sanity/ui/theme'
+import {isColorConfigBaseTone} from '@sanity/ui/theme'
+import {isColorConfigBlendKey} from '@sanity/ui/theme'
+import {isColorConfigStateKey} from '@sanity/ui/theme'
+import {isColorConfigStateTone} from '@sanity/ui/theme'
+import {isColorHueKey} from '@sanity/ui/theme'
+import {isColorOpacityValue} from '@sanity/ui/theme'
+import {isColorTintKey} from '@sanity/ui/theme'
+import {isColorTokenValue} from '@sanity/ui/theme'
+import {isColorValue} from '@sanity/ui/theme'
 import {IStyledComponent} from 'styled-components'
 import {Key} from 'react'
 import {KeyboardEventHandler} from 'react'
 import {LegacyRef} from 'react'
 import {MemoExoticComponent} from 'react'
 import {MouseEventHandler} from 'react'
+import {multiply} from '@sanity/ui/theme'
 import {MutableRefObject} from 'react'
 import {NamedExoticComponent} from 'react'
+import {parseColor} from '@sanity/ui/theme'
+import {parseTokenKey} from '@sanity/ui/theme'
+import {parseTokenValue} from '@sanity/ui/theme'
+import {PartialThemeColorBuilderOpts} from '@sanity/ui/theme'
 import {PointerEventHandler} from 'react'
 import {PropsWithChildren} from 'react'
 import {ReactElement} from 'react'
@@ -29,7 +66,82 @@ import {ReactNode} from 'react'
 import {Ref} from 'react'
 import {RefAttributes} from 'react'
 import {RefCallback} from 'react'
-import type {StyledObject} from 'styled-components'
+import {RGB} from '@sanity/ui/theme'
+import {RGBA} from '@sanity/ui/theme'
+import {rgba} from '@sanity/ui/theme'
+import {rgbaToRGBA} from '@sanity/ui/theme'
+import {rgbToHex} from '@sanity/ui/theme'
+import {rgbToHsl} from '@sanity/ui/theme'
+import {RootTheme} from '@sanity/ui/theme'
+import {screen as screen_2} from '@sanity/ui/theme'
+import {defaultTheme as studioTheme} from '@sanity/ui/theme'
+import {Theme} from '@sanity/ui/theme'
+import {THEME_COLOR_BLEND_MODES} from '@sanity/ui/theme'
+import {THEME_COLOR_BUTTON_MODES} from '@sanity/ui/theme'
+import {THEME_COLOR_CARD_TONES} from '@sanity/ui/theme'
+import {THEME_COLOR_STATE_TONES} from '@sanity/ui/theme'
+import {THEME_COLOR_STATES} from '@sanity/ui/theme'
+import {Theme_v2} from '@sanity/ui/theme'
+import {ThemeAvatar} from '@sanity/ui/theme'
+import {ThemeColor} from '@sanity/ui/theme'
+import {ThemeColorAvatarColorKey} from '@sanity/ui/theme'
+import {ThemeColorBase} from '@sanity/ui/theme'
+import {ThemeColorBaseTokens} from '@sanity/ui/theme'
+import {ThemeColorBlendModeKey} from '@sanity/ui/theme'
+import {ThemeColorBuilderOpts} from '@sanity/ui/theme'
+import {ThemeColorButton} from '@sanity/ui/theme'
+import {ThemeColorButtonModeKey} from '@sanity/ui/theme'
+import {ThemeColorButtonState} from '@sanity/ui/theme'
+import {ThemeColorButtonStates} from '@sanity/ui/theme'
+import {ThemeColorButtonTokens} from '@sanity/ui/theme'
+import {ThemeColorButtonTones} from '@sanity/ui/theme'
+import {ThemeColorCard} from '@sanity/ui/theme'
+import {ThemeColorCardState} from '@sanity/ui/theme'
+import {ThemeColorCardToneKey} from '@sanity/ui/theme'
+import {ThemeColorGenericState} from '@sanity/ui/theme'
+import {ThemeColorInput} from '@sanity/ui/theme'
+import {ThemeColorInputState} from '@sanity/ui/theme'
+import {ThemeColorInputStates} from '@sanity/ui/theme'
+import {ThemeColorMuted} from '@sanity/ui/theme'
+import {ThemeColorMutedTone} from '@sanity/ui/theme'
+import {ThemeColorName} from '@sanity/ui/theme'
+import {ThemeColorScheme} from '@sanity/ui/theme'
+import {ThemeColorSchemeKey} from '@sanity/ui/theme'
+import {ThemeColorSchemes} from '@sanity/ui/theme'
+import {ThemeColorSelectable} from '@sanity/ui/theme'
+import {ThemeColorSelectableState} from '@sanity/ui/theme'
+import {ThemeColorSelectableStates} from '@sanity/ui/theme'
+import {ThemeColorSolid} from '@sanity/ui/theme'
+import {ThemeColorSolidTone} from '@sanity/ui/theme'
+import {ThemeColorSpot} from '@sanity/ui/theme'
+import {ThemeColorSpotKey} from '@sanity/ui/theme'
+import {ThemeColorStateKey} from '@sanity/ui/theme'
+import {ThemeColorStatesTokens} from '@sanity/ui/theme'
+import {ThemeColorStateTokens} from '@sanity/ui/theme'
+import {ThemeColorStateToneKey} from '@sanity/ui/theme'
+import {ThemeColorSyntax} from '@sanity/ui/theme'
+import {ThemeColorTokens} from '@sanity/ui/theme'
+import {ThemeColorTokenValue} from '@sanity/ui/theme'
+import {ThemeColorToneKey} from '@sanity/ui/theme'
+import {ThemeConfig} from '@sanity/ui/theme'
+import {ThemeFocusRing} from '@sanity/ui/theme'
+import {ThemeFont} from '@sanity/ui/theme'
+import {ThemeFontKey} from '@sanity/ui/theme'
+import {ThemeFonts} from '@sanity/ui/theme'
+import {ThemeFontSize} from '@sanity/ui/theme'
+import {ThemeFontWeight} from '@sanity/ui/theme'
+import {ThemeFontWeightKey} from '@sanity/ui/theme'
+import {ThemeInput} from '@sanity/ui/theme'
+import {ThemeLayer} from '@sanity/ui/theme'
+import {ThemeShadow} from '@sanity/ui/theme'
+import {ThemeStyles} from '@sanity/ui/theme'
+import {TokenBaseKeyNode} from '@sanity/ui/theme'
+import {TokenBlendModeValueNode} from '@sanity/ui/theme'
+import {TokenButtonKeyNode} from '@sanity/ui/theme'
+import {TokenColorValueNode} from '@sanity/ui/theme'
+import {TokenHueValueNode} from '@sanity/ui/theme'
+import {TokenKeyNode} from '@sanity/ui/theme'
+import {TokenValueNode} from '@sanity/ui/theme'
 import {TouchEventHandler} from 'react'
 import {TransitionEventHandler} from 'react'
 import {UIEventHandler} from 'react'
@@ -38,22 +150,36 @@ import {WheelEventHandler} from 'react'
 /** @beta */
 export declare type ArrayPropPrimitive = string | number | boolean | undefined | null
 
+/** @internal */
+export declare const Arrow: ForwardRefExoticComponent<
+  Omit<
+    {
+      width: number
+      height: number
+      radius?: number | undefined
+    } & Omit<HTMLProps<HTMLDivElement>, 'height' | 'width'>,
+    'ref'
+  > &
+    RefAttributes<HTMLDivElement>
+>
+
 /**
  * @internal
  */
 export declare function attemptFocus(element: HTMLElement): boolean
 
 /**
+ * The Autocomplete component is typically used for search components.
+ * It consists of a text input for writing a query, and properties for rendering suggestions.
+ *
  * @public
  */
 export declare const Autocomplete: <Option extends BaseAutocompleteOption>(
   props: AutocompleteProps<Option> &
     Omit<
       HTMLProps<HTMLInputElement>,
-      | 'type'
       | 'value'
       | 'ref'
-      | 'as'
       | 'id'
       | 'spellCheck'
       | 'role'
@@ -67,7 +193,9 @@ export declare const Autocomplete: <Option extends BaseAutocompleteOption>(
       | 'aria-owns'
       | 'onChange'
       | 'onSelect'
+      | 'as'
       | 'autoComplete'
+      | 'type'
     > & {
       ref?: Ref<HTMLInputElement> | undefined
     },
@@ -128,6 +256,7 @@ export declare interface AutocompleteProps<
   onSelect?: (value: string) => void
   /** @beta */
   openButton?: boolean | AutocompleteOpenButtonProps
+  /** The options to render. */
   options?: Option[]
   padding?: number | number[]
   popover?: Omit<PopoverProps, 'content' | 'onMouseEnter' | 'onMouseLeave' | 'open'> &
@@ -136,6 +265,7 @@ export declare interface AutocompleteProps<
   radius?: Radius | Radius[]
   /** @beta */
   relatedElements?: HTMLElement[]
+  /** The callback function for rendering each option. */
   renderOption?: (option: Option) => ReactElement
   /** @beta */
   renderPopover?: (
@@ -150,6 +280,7 @@ export declare interface AutocompleteProps<
   ) => ReactNode
   renderValue?: (value: string, option?: Option) => string
   suffix?: ReactNode
+  /** The current value. */
   value?: string
 }
 
@@ -219,6 +350,8 @@ export declare interface AutocompleteValueChangeMsg {
 }
 
 /**
+ * Avatars are used to represent people and other agents (e.g. bots).
+ *
  * @public
  */
 export declare const Avatar: ForwardRefExoticComponent<
@@ -251,10 +384,12 @@ export declare type AvatarPosition = 'top' | 'bottom' | 'inside'
  * @public
  */
 export declare interface AvatarProps {
+  /** @beta */
+  __unstable_hideInnerStroke?: boolean
   animateArrowFrom?: AvatarPosition
   arrowPosition?: AvatarPosition
   as?: React.ElementType | keyof JSX.IntrinsicElements
-  color?: ThemeColorSpotKey
+  color?: ThemeColorAvatarColorKey
   initials?: string
   onImageLoadError?: (event: Error) => void
   size?: AvatarSize | AvatarSize[]
@@ -271,13 +406,13 @@ export declare interface AvatarProps {
  * @internal
  */
 export declare interface AvatarRootStyleProps {
-  $color: string
+  $color: ThemeColorAvatarColorKey
 }
 
 /**
  * @public
  */
-export declare type AvatarSize = 0 | 1 | 2
+export declare type AvatarSize = 0 | 1 | 2 | 3
 
 /**
  * @public
@@ -303,6 +438,8 @@ export declare interface AvatarStackProps {
 export declare type AvatarStatus = 'online' | 'editing' | 'inactive'
 
 /**
+ * Badges are used to tag resources.
+ *
  * @public
  */
 export declare const Badge: ForwardRefExoticComponent<
@@ -311,6 +448,7 @@ export declare const Badge: ForwardRefExoticComponent<
 
 /**
  * @public
+ * @deprecated No longer used
  */
 export declare type BadgeMode = 'default' | 'outline'
 
@@ -320,6 +458,7 @@ export declare type BadgeMode = 'default' | 'outline'
 export declare interface BadgeProps extends BoxProps, ResponsiveRadiusProps {
   as?: React.ElementType | keyof JSX.IntrinsicElements
   fontSize?: number | number[]
+  /** @deprecated No longer used. */
   mode?: BadgeMode
   tone?: BadgeTone
 }
@@ -327,7 +466,7 @@ export declare interface BadgeProps extends BoxProps, ResponsiveRadiusProps {
 /**
  * @public
  */
-export declare type BadgeTone = 'default' | 'primary' | 'positive' | 'caution' | 'critical'
+export declare type BadgeTone = ThemeColorStateToneKey
 
 /**
  * @public
@@ -336,38 +475,7 @@ export declare interface BaseAutocompleteOption {
   value: string
 }
 
-/**
- * @public
- */
-export declare interface BaseTheme<Styles extends {} = {}> {
-  avatar: ThemeAvatar
-  button: {
-    textWeight: ThemeFontWeightKey
-    focusRing: FocusRing
-  }
-  card: {
-    focusRing: FocusRing
-  }
-  color: ThemeColorSchemes
-  container: number[]
-  /** @deprecated Use component-specific `focusRing` values instead */
-  focusRing: {
-    offset: number
-    width: number
-  }
-  fonts: ThemeFonts
-  input: ThemeInput
-  /**
-   * THIS API MAY BE UNSTABLE. DO NOT USE IN PRODUCTION.
-   * @beta
-   */
-  layer?: ThemeLayer
-  media: number[]
-  radius: number[]
-  shadows: Array<ThemeShadow | null>
-  space: number[]
-  styles?: Styles
-}
+export {BaseTheme}
 
 /**
  * @public
@@ -393,10 +501,13 @@ export declare interface BoundaryElementProviderProps {
 }
 
 /**
+ * The `Box` component is a basic layout wrapper component which provides utility properties
+ * for flex, margins and padding.
+ *
  * @public
  */
 export declare const Box: ForwardRefExoticComponent<
-  Omit<BoxProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'height'>, 'ref'> &
+  Omit<BoxProps & Omit<HTMLProps<HTMLDivElement>, 'height' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -428,11 +539,7 @@ export declare interface BoxProps
   forwardedAs?: React.ElementType | keyof JSX.IntrinsicElements
 }
 
-/**
- * TODO: Rename to `ThemeBoxShadow`
- * @public
- */
-export declare type BoxShadow = [number, number, number, number]
+export {BoxShadow}
 
 /**
  * @public
@@ -444,7 +551,7 @@ export declare type BoxSizing = 'content' | 'border'
  */
 export declare const Breadcrumbs: ForwardRefExoticComponent<
   BreadcrumbsProps &
-    Omit<HTMLProps<HTMLOListElement>, 'type' | 'ref' | 'as'> &
+    Omit<HTMLProps<HTMLOListElement>, 'ref' | 'as' | 'type'> &
     RefAttributes<HTMLOListElement>
 >
 
@@ -457,18 +564,20 @@ export declare interface BreadcrumbsProps {
   space?: number | number[]
 }
 
+export {buildTheme}
+
 /**
  * @public
  */
 export declare const Button: ForwardRefExoticComponent<
-  Omit<ButtonProps & Omit<HTMLProps<HTMLButtonElement>, 'as'>, 'ref'> &
+  Omit<ButtonProps & Omit<HTMLProps<HTMLButtonElement>, 'width' | 'as'>, 'ref'> &
     RefAttributes<HTMLButtonElement>
 >
 
 /**
  * @public
  */
-export declare type ButtonMode = 'default' | 'ghost' | 'bleed'
+export declare type ButtonMode = ThemeColorButtonModeKey
 
 /**
  * @public
@@ -491,6 +600,7 @@ export declare interface ButtonProps extends ResponsivePaddingProps, ResponsiveR
   text?: React.ReactNode
   tone?: ButtonTone
   type?: 'button' | 'reset' | 'submit'
+  width?: ButtonWidth
 }
 
 /**
@@ -501,13 +611,21 @@ export declare type ButtonTextAlign = 'left' | 'right' | 'center'
 /**
  * @public
  */
-export declare type ButtonTone = 'default' | 'primary' | 'positive' | 'caution' | 'critical'
+export declare type ButtonTone = ThemeColorStateToneKey
+
+/**
+ * @public
+ */
+export declare type ButtonWidth = 'fill'
 
 /**
+ * The `Card` component acts much like a `Box`, but with a background and foreground color.
+ * Components within a `Card` inherit its colors.
+ *
  * @public
  */
 export declare const Card: ForwardRefExoticComponent<
-  Omit<CardProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'height'>, 'ref'> &
+  Omit<CardProps & Omit<HTMLProps<HTMLDivElement>, 'height' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -532,12 +650,6 @@ export declare interface CardProps
   pressed?: boolean
   scheme?: ThemeColorSchemeKey
   tone?: CardTone
-  /**
-   * @internal
-   * Used by the popover, as it creates a new html element that it's ouside of the previous scope of the card.
-   * So if it's inheriting styles from the parent, it needs to create a new cars context
-   */
-  updateCssVars?: boolean
 }
 
 /**
@@ -547,20 +659,20 @@ export declare interface CardStyleProps {
   $checkered: boolean
   $focusRing: boolean
   $tone: ThemeColorToneKey
-  $scheme: ThemeColorSchemeKey
-  $updateCssVars: boolean
 }
 
 /**
  * @public
  */
-export declare type CardTone = ThemeColorToneKey | 'inherit'
+export declare type CardTone = ThemeColorCardToneKey | 'inherit'
 
 /**
+ * Checkboxes allow the user to select one or more items from a set.
+ *
  * @public
  */
 export declare const Checkbox: ForwardRefExoticComponent<
-  Omit<Omit<HTMLProps<HTMLInputElement>, 'type' | 'as'> & CheckboxProps, 'ref'> &
+  Omit<Omit<HTMLProps<HTMLInputElement>, 'as' | 'type'> & CheckboxProps, 'ref'> &
     RefAttributes<HTMLInputElement>
 >
 
@@ -581,7 +693,7 @@ export declare type ClickOutsideListener = (event: MouseEvent) => void
  * @public
  */
 export declare const Code: ForwardRefExoticComponent<
-  Omit<CodeProps & Omit<HTMLProps<HTMLElement>, 'as' | 'size'>, 'ref'> & RefAttributes<HTMLElement>
+  Omit<CodeProps & Omit<HTMLProps<HTMLElement>, 'size' | 'as'>, 'ref'> & RefAttributes<HTMLElement>
 >
 
 /**
@@ -589,6 +701,7 @@ export declare const Code: ForwardRefExoticComponent<
  */
 export declare interface CodeProps {
   as?: React.ElementType | keyof JSX.IntrinsicElements
+  /** Define the language to use for syntax highlighting. */
   language?: string
   size?: number | number[]
   weight?: string
@@ -600,7 +713,7 @@ export declare interface CodeProps {
  */
 export declare const CodeSkeleton: ForwardRefExoticComponent<
   Omit<
-    CodeSkeletonProps & Omit<HTMLProps<HTMLDivElement>, 'children' | 'as' | 'size' | 'height'>,
+    CodeSkeletonProps & Omit<HTMLProps<HTMLDivElement>, 'size' | 'children' | 'height' | 'as'>,
     'ref'
   > &
     RefAttributes<HTMLDivElement>
@@ -614,11 +727,39 @@ export declare interface CodeSkeletonProps extends SkeletonProps {
   size?: number | number[]
 }
 
+export {COLOR_CONFIG_BLEND_KEYS}
+
+export {COLOR_CONFIG_CARD_KEYS}
+
+export {COLOR_CONFIG_CARD_TONES}
+
+export {COLOR_CONFIG_STATE_KEYS}
+
+export {COLOR_CONFIG_STATE_TONES}
+
+export {ColorBlendModeTokenValue}
+
+export {ColorConfigBlendKey}
+
+export {ColorConfigCardKey}
+
+export {ColorConfigCardTone}
+
+export {ColorConfigOpacityValue}
+
+export {ColorConfigStateKey}
+
+export {ColorConfigStateTone}
+
+export {ColorConfigValue}
+
 /**
+ * The `Container` component wraps content layout in a defined set of widths.
+ *
  * @public
  */
 export declare const Container: ForwardRefExoticComponent<
-  Omit<ContainerProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'height' | 'width'>, 'ref'> &
+  Omit<ContainerProps & Omit<HTMLProps<HTMLDivElement>, 'height' | 'width' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -632,240 +773,9 @@ export declare interface ContainerProps extends BoxProps, ResponsiveWidthProps {
  */
 export declare function containsOrEqualsElement(element: HTMLElement, node: Node): boolean
 
-/**
- * @internal
- * @deprecated Use studioTheme instead.
- */
-export declare function createColorTheme(): null
-
-/**
- * @beta
- */
-export declare const createCssVars: (
-  scheme: ThemeColorSchemeKey,
-  tones: Record<ThemeColorName, ColorTints>,
-  defaultTone?: ThemeColorName,
-) => Record<string, string>
+export {createColorTheme}
 
-/** @internal */
-export declare type CSSObject = StyledObject<any>
-
-/**
- * @beta
- */
-export declare type CSSVariableKey = ThemeColorName & ('spot' | 'syntax' | 'mutable')
-
-/**
- * @beta
- */
-export declare const cssVars: {
-  /**
-   * This variables are mutable, they can be updated by other components.
-   * The main component that updates them is the card, these are the only ones that should be exposed for use from the cards.
-   */
-  mutable: Record<
-    'bg-color' | 'muted-fg-color' | 'icon-color' | 'fg-color' | 'bg-image' | 'accent-color',
-    string
-  >
-  default: Record<
-    | 'text-primary'
-    | 'text-secondary'
-    | 'text-inactive'
-    | 'text-code'
-    | 'text-muted'
-    | 'text-link'
-    | 'text-accent'
-    | 'bg-base'
-    | 'bg-base-hover'
-    | 'bg-base-active'
-    | 'bg-accent'
-    | 'bg-accent-hover'
-    | 'bg-accent-active'
-    | 'bg-tint'
-    | 'bg-tint-code'
-    | 'icon-default'
-    | 'icon-inverted'
-    | 'border-base'
-    | 'border-base-hover'
-    | 'border-accent'
-    | 'border-accent-inverted'
-    | 'base-bg-card'
-    | 'base-bg-raw'
-    | 'base-shadow-outline-color'
-    | 'base-shadow-umbra-color'
-    | 'base-shadow-penumbra-color'
-    | 'base-shadow-ambient-color'
-    | 'base-text-color'
-    | 'skeleton-from'
-    | 'skeleton-to',
-    string
-  >
-  transparent: Record<
-    | 'text-primary'
-    | 'text-secondary'
-    | 'text-inactive'
-    | 'text-code'
-    | 'text-muted'
-    | 'text-link'
-    | 'text-accent'
-    | 'bg-base'
-    | 'bg-base-hover'
-    | 'bg-base-active'
-    | 'bg-accent'
-    | 'bg-accent-hover'
-    | 'bg-accent-active'
-    | 'bg-tint'
-    | 'bg-tint-code'
-    | 'icon-default'
-    | 'icon-inverted'
-    | 'border-base'
-    | 'border-base-hover'
-    | 'border-accent'
-    | 'border-accent-inverted'
-    | 'base-bg-card'
-    | 'base-bg-raw'
-    | 'base-shadow-outline-color'
-    | 'base-shadow-umbra-color'
-    | 'base-shadow-penumbra-color'
-    | 'base-shadow-ambient-color'
-    | 'base-text-color'
-    | 'skeleton-from'
-    | 'skeleton-to',
-    string
-  >
-  primary: Record<
-    | 'text-primary'
-    | 'text-secondary'
-    | 'text-inactive'
-    | 'text-code'
-    | 'text-muted'
-    | 'text-link'
-    | 'text-accent'
-    | 'bg-base'
-    | 'bg-base-hover'
-    | 'bg-base-active'
-    | 'bg-accent'
-    | 'bg-accent-hover'
-    | 'bg-accent-active'
-    | 'bg-tint'
-    | 'bg-tint-code'
-    | 'icon-default'
-    | 'icon-inverted'
-    | 'border-base'
-    | 'border-base-hover'
-    | 'border-accent'
-    | 'border-accent-inverted'
-    | 'base-bg-card'
-    | 'base-bg-raw'
-    | 'base-shadow-outline-color'
-    | 'base-shadow-umbra-color'
-    | 'base-shadow-penumbra-color'
-    | 'base-shadow-ambient-color'
-    | 'base-text-color'
-    | 'skeleton-from'
-    | 'skeleton-to',
-    string
-  >
-  positive: Record<
-    | 'text-primary'
-    | 'text-secondary'
-    | 'text-inactive'
-    | 'text-code'
-    | 'text-muted'
-    | 'text-link'
-    | 'text-accent'
-    | 'bg-base'
-    | 'bg-base-hover'
-    | 'bg-base-active'
-    | 'bg-accent'
-    | 'bg-accent-hover'
-    | 'bg-accent-active'
-    | 'bg-tint'
-    | 'bg-tint-code'
-    | 'icon-default'
-    | 'icon-inverted'
-    | 'border-base'
-    | 'border-base-hover'
-    | 'border-accent'
-    | 'border-accent-inverted'
-    | 'base-bg-card'
-    | 'base-bg-raw'
-    | 'base-shadow-outline-color'
-    | 'base-shadow-umbra-color'
-    | 'base-shadow-penumbra-color'
-    | 'base-shadow-ambient-color'
-    | 'base-text-color'
-    | 'skeleton-from'
-    | 'skeleton-to',
-    string
-  >
-  caution: Record<
-    | 'text-primary'
-    | 'text-secondary'
-    | 'text-inactive'
-    | 'text-code'
-    | 'text-muted'
-    | 'text-link'
-    | 'text-accent'
-    | 'bg-base'
-    | 'bg-base-hover'
-    | 'bg-base-active'
-    | 'bg-accent'
-    | 'bg-accent-hover'
-    | 'bg-accent-active'
-    | 'bg-tint'
-    | 'bg-tint-code'
-    | 'icon-default'
-    | 'icon-inverted'
-    | 'border-base'
-    | 'border-base-hover'
-    | 'border-accent'
-    | 'border-accent-inverted'
-    | 'base-bg-card'
-    | 'base-bg-raw'
-    | 'base-shadow-outline-color'
-    | 'base-shadow-umbra-color'
-    | 'base-shadow-penumbra-color'
-    | 'base-shadow-ambient-color'
-    | 'base-text-color'
-    | 'skeleton-from'
-    | 'skeleton-to',
-    string
-  >
-  critical: Record<
-    | 'text-primary'
-    | 'text-secondary'
-    | 'text-inactive'
-    | 'text-code'
-    | 'text-muted'
-    | 'text-link'
-    | 'text-accent'
-    | 'bg-base'
-    | 'bg-base-hover'
-    | 'bg-base-active'
-    | 'bg-accent'
-    | 'bg-accent-hover'
-    | 'bg-accent-active'
-    | 'bg-tint'
-    | 'bg-tint-code'
-    | 'icon-default'
-    | 'icon-inverted'
-    | 'border-base'
-    | 'border-base-hover'
-    | 'border-accent'
-    | 'border-accent-inverted'
-    | 'base-bg-card'
-    | 'base-bg-raw'
-    | 'base-shadow-outline-color'
-    | 'base-shadow-umbra-color'
-    | 'base-shadow-penumbra-color'
-    | 'base-shadow-ambient-color'
-    | 'base-text-color'
-    | 'skeleton-from'
-    | 'skeleton-to',
-    string
-  >
-}
+export {CSSObject}
 
 /**
  * @public
@@ -878,10 +788,12 @@ export declare type Delay =
     }>
 
 /**
+ * The Dialog component.
+ *
  * @public
  */
 export declare const Dialog: ForwardRefExoticComponent<
-  Omit<DialogProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'width' | 'id'>, 'ref'> &
+  Omit<DialogProps & Omit<HTMLProps<HTMLDivElement>, 'width' | 'id' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -931,6 +843,13 @@ export declare interface DialogProps extends ResponsivePaddingProps, ResponsiveW
   position?: DialogPosition | DialogPosition[]
   scheme?: ThemeColorSchemeKey
   zOffset?: number | number[]
+  /**
+   * Whether the dialog should animate in on mount.
+   *
+   * @beta
+   * @defaultValue false
+   */
+  animate?: boolean
 }
 
 /**
@@ -1036,10 +955,12 @@ export declare function _fillCSSObject(
 ): CSSObject
 
 /**
+ * The `Flex` component is a wrapper component for flexible elements (`Box`, `Card` and `Flex`).
+ *
  * @public
  */
 export declare const Flex: ForwardRefExoticComponent<
-  Omit<FlexProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'wrap'>, 'ref'> &
+  Omit<FlexProps & Omit<HTMLProps<HTMLDivElement>, 'wrap' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -1094,14 +1015,6 @@ export declare function focusFirstDescendant(element: HTMLElement): boolean
  */
 export declare function focusLastDescendant(element: HTMLElement): boolean
 
-/**
- * @public
- */
-export declare interface FocusRing {
-  offset: number
-  width: number
-}
-
 /**
  * @internal
  */
@@ -1124,10 +1037,12 @@ export declare function _getResponsiveSpace(
 ): CSSObject[] | null
 
 /**
+ * The `Grid` component is for building 2-dimensional layers (based on CSS grid).
+ *
  * @public
  */
 export declare const Grid: ForwardRefExoticComponent<
-  Omit<GridProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'height' | 'rows'>, 'ref'> &
+  Omit<GridProps & Omit<HTMLProps<HTMLDivElement>, 'height' | 'as' | 'rows'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -1187,10 +1102,12 @@ export declare interface GridProps extends Omit<BoxProps, 'display'>, Responsive
 export declare function _hasFocus(element: HTMLElement): boolean
 
 /**
+ * Typographic headings.
+ *
  * @public
  */
 export declare const Heading: ForwardRefExoticComponent<
-  Omit<HeadingProps & Omit<HTMLProps<HTMLElement>, 'as' | 'size'>, 'ref'> &
+  Omit<HeadingProps & Omit<HTMLProps<HTMLElement>, 'size' | 'as'>, 'ref'> &
     RefAttributes<HTMLElement>
 >
 
@@ -1218,7 +1135,7 @@ export declare interface HeadingProps {
  */
 export declare const HeadingSkeleton: ForwardRefExoticComponent<
   Omit<
-    HeadingSkeletonProps & Omit<HTMLProps<HTMLDivElement>, 'children' | 'as' | 'size' | 'height'>,
+    HeadingSkeletonProps & Omit<HTMLProps<HTMLDivElement>, 'size' | 'children' | 'height' | 'as'>,
     'ref'
   > &
     RefAttributes<HTMLDivElement>
@@ -1232,16 +1149,15 @@ export declare interface HeadingSkeletonProps extends SkeletonProps {
   size?: number | number[]
 }
 
-/**
- * @internal
- */
-export declare function hexToRgb(hex: string): RGB
+export {hexToRgb}
 
 /**
+ * Represent hotkeys (a keyboard combination) with semantic `<kbd>` elements.
+ *
  * @public
  */
 export declare const Hotkeys: ForwardRefExoticComponent<
-  HotkeysProps & Omit<HTMLProps<HTMLElement>, 'ref' | 'as' | 'size'> & RefAttributes<HTMLElement>
+  HotkeysProps & Omit<HTMLProps<HTMLElement>, 'size' | 'ref' | 'as'> & RefAttributes<HTMLElement>
 >
 
 /**
@@ -1255,21 +1171,13 @@ export declare interface HotkeysProps {
   keys?: string[]
 }
 
-/**
- * @internal
- */
-export declare interface HSL {
-  h: number
-  s: number
-  l: number
-}
+export {HSL}
 
-/**
- * @internal
- */
-export declare function hslToRgb(hsl: HSL): RGB
+export {hslToRgb}
 
 /**
+ * The `Inline` component is a layout utility for aligning and spacing items horizontally.
+ *
  * @public
  */
 export declare const Inline: ForwardRefExoticComponent<
@@ -1280,9 +1188,34 @@ export declare const Inline: ForwardRefExoticComponent<
  * @public
  */
 export declare interface InlineProps extends Omit<BoxProps, 'display'> {
+  /** The spacing between children. */
   space?: number | number[]
 }
 
+export {isColorBlendModeValue}
+
+export {isColorButtonMode}
+
+export {isColorConfigBaseKey}
+
+export {isColorConfigBaseTone}
+
+export {isColorConfigBlendKey}
+
+export {isColorConfigStateKey}
+
+export {isColorConfigStateTone}
+
+export {isColorHueKey}
+
+export {isColorOpacityValue}
+
+export {isColorTintKey}
+
+export {isColorTokenValue}
+
+export {isColorValue}
+
 /**
  * @internal
  */
@@ -1329,10 +1262,12 @@ export declare function isHTMLTextAreaElement(element: unknown): element is HTML
 export declare function _isScrollable(el: Node): boolean
 
 /**
+ * Used to define some text as keyboard input.
+ *
  * @public
  */
 export declare const KBD: ForwardRefExoticComponent<
-  KBDProps & Omit<HTMLProps<HTMLElement>, 'ref' | 'as' | 'size'> & RefAttributes<HTMLDivElement>
+  KBDProps & Omit<HTMLProps<HTMLElement>, 'size' | 'ref' | 'as'> & RefAttributes<HTMLDivElement>
 >
 
 /**
@@ -1346,10 +1281,12 @@ export declare interface KBDProps {
 }
 
 /**
+ * Typographic labels.
+ *
  * @public
  */
 export declare const Label: ForwardRefExoticComponent<
-  Omit<LabelProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'size'>, 'ref'> &
+  Omit<LabelProps & Omit<HTMLProps<HTMLDivElement>, 'size' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -1377,7 +1314,7 @@ export declare interface LabelProps {
  */
 export declare const LabelSkeleton: ForwardRefExoticComponent<
   Omit<
-    LabelSkeletonProps & Omit<HTMLProps<HTMLDivElement>, 'children' | 'as' | 'size' | 'height'>,
+    LabelSkeletonProps & Omit<HTMLProps<HTMLDivElement>, 'size' | 'children' | 'height' | 'as'>,
     'ref'
   > &
     RefAttributes<HTMLDivElement>
@@ -1449,14 +1386,18 @@ export declare interface _MediaStore {
 }
 
 /**
+ * The `Menu` component is a building block for application menus.
+ *
  * @public
  */
 export declare const Menu: ForwardRefExoticComponent<
-  Omit<MenuProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'height' | 'tabIndex' | 'role'>, 'ref'> &
+  Omit<MenuProps & Omit<HTMLProps<HTMLDivElement>, 'height' | 'tabIndex' | 'role' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
 /**
+ * The `MenuButton` component follows the WAI-ARIA specification for menu buttons.
+ *
  * @public
  */
 export declare const MenuButton: ForwardRefExoticComponent<
@@ -1519,7 +1460,7 @@ export declare const MenuDivider: IStyledComponent<
     accessKey?: string | undefined
     autoFocus?: boolean | undefined
     className?: string | undefined
-    contentEditable?: 'inherit' | (boolean | 'false' | 'true') | undefined
+    contentEditable?: 'inherit' | (boolean | 'false' | 'true') | 'plaintext-only' | undefined
     contextMenu?: string | undefined
     dir?: string | undefined
     draggable?: (boolean | 'false' | 'true') | undefined
@@ -1560,9 +1501,9 @@ export declare const MenuDivider: IStyledComponent<
     security?: string | undefined
     unselectable?: 'on' | 'off' | undefined
     inputMode?:
-      | 'search'
-      | 'text'
       | 'none'
+      | 'text'
+      | 'search'
       | 'tel'
       | 'url'
       | 'email'
@@ -1572,7 +1513,7 @@ export declare const MenuDivider: IStyledComponent<
     is?: string | undefined
     'aria-activedescendant'?: string | undefined
     'aria-atomic'?: (boolean | 'false' | 'true') | undefined
-    'aria-autocomplete'?: 'both' | 'none' | 'inline' | 'list' | undefined
+    'aria-autocomplete'?: 'none' | 'both' | 'inline' | 'list' | undefined
     'aria-braillelabel'?: string | undefined
     'aria-brailleroledescription'?: string | undefined
     'aria-busy'?: (boolean | 'false' | 'true') | undefined
@@ -1584,10 +1525,10 @@ export declare const MenuDivider: IStyledComponent<
     'aria-controls'?: string | undefined
     'aria-current'?:
       | boolean
-      | 'time'
       | 'page'
       | 'false'
       | 'true'
+      | 'time'
       | 'step'
       | 'location'
       | 'date'
@@ -1596,19 +1537,19 @@ export declare const MenuDivider: IStyledComponent<
     'aria-description'?: string | undefined
     'aria-details'?: string | undefined
     'aria-disabled'?: (boolean | 'false' | 'true') | undefined
-    'aria-dropeffect'?: 'link' | 'none' | 'copy' | 'move' | 'execute' | 'popup' | undefined
+    'aria-dropeffect'?: 'none' | 'link' | 'copy' | 'move' | 'execute' | 'popup' | undefined
     'aria-errormessage'?: string | undefined
     'aria-expanded'?: (boolean | 'false' | 'true') | undefined
     'aria-flowto'?: string | undefined
     'aria-grabbed'?: (boolean | 'false' | 'true') | undefined
     'aria-haspopup'?:
       | boolean
-      | 'dialog'
-      | 'menu'
-      | 'listbox'
       | 'grid'
+      | 'listbox'
+      | 'menu'
       | 'false'
       | 'true'
+      | 'dialog'
       | 'tree'
       | undefined
     'aria-hidden'?: (boolean | 'false' | 'true') | undefined
@@ -1851,7 +1792,7 @@ export declare interface MenuGroupProps {
  */
 export declare const MenuItem: ForwardRefExoticComponent<
   MenuItemProps &
-    Omit<HTMLProps<HTMLDivElement>, 'ref' | 'as' | 'height' | 'tabIndex' | 'selected'> &
+    Omit<HTMLProps<HTMLDivElement>, 'ref' | 'height' | 'tabIndex' | 'as' | 'selected'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -1868,7 +1809,7 @@ export declare interface MenuItemProps extends ResponsivePaddingProps, Responsiv
   selected?: boolean
   space?: number | number[]
   text?: React.ReactNode
-  tone?: ThemeColorToneKey
+  tone?: SelectableTone
 }
 
 /**
@@ -1893,17 +1834,15 @@ export declare interface MenuProps extends ResponsivePaddingProps {
   space?: number | number[]
 }
 
-/**
- * Apply the \`multiply\` blend mode
- * Source: https://www.w3.org/TR/compositing-1/#blendingmultiply
- * @internal
- */
-export declare function multiply(b: RGB | RGBA, s: RGB | RGBA): RGB
+export {multiply}
 
-/**
- * @internal
- */
-export declare function parseColor(color: unknown): RGB | RGBA
+export {parseColor}
+
+export {parseTokenKey}
+
+export {parseTokenValue}
+
+export {PartialThemeColorBuilderOpts}
 
 /**
  * Placement of floating UI elements.
@@ -1924,11 +1863,15 @@ export declare type Placement =
   | 'left-start'
   | 'left-end'
 
-/** @public */
+/**
+ * The `Popover` component is used to display some content on top of another.
+ *
+ * @public
+ */
 export declare const Popover: MemoExoticComponent<
   ForwardRefExoticComponent<
     Omit<
-      PopoverProps & Omit<HTMLProps<HTMLDivElement>, 'children' | 'as' | 'content' | 'width'>,
+      PopoverProps & Omit<HTMLProps<HTMLDivElement>, 'content' | 'children' | 'width' | 'as'>,
       'ref'
     > &
       RefAttributes<HTMLDivElement>
@@ -1961,6 +1904,7 @@ export declare interface PopoverProps
   overflow?: BoxOverflow
   padding?: number | number[]
   placement?: Placement
+  /** Whether or not to render the popover in a portal element. */
   portal?: boolean | string
   preventOverflow?: boolean
   referenceBoundary?: HTMLElement | null
@@ -2028,10 +1972,12 @@ export declare interface PortalProviderProps {
 }
 
 /**
+ * The `Radio` component allows the user to select one option from a set.
+ *
  * @public
  */
 export declare const Radio: ForwardRefExoticComponent<
-  Omit<Omit<HTMLProps<HTMLInputElement>, 'type' | 'as'> & RadioProps, 'ref'> &
+  Omit<Omit<HTMLProps<HTMLInputElement>, 'as' | 'type'> & RadioProps, 'ref'> &
     RefAttributes<HTMLInputElement>
 >
 
@@ -2116,6 +2062,7 @@ export declare function responsiveCodeFontStyle(
  * @public
  */
 export declare interface ResponsiveFlexItemProps {
+  /** Sets the flex CSS attribute. The property is responsive. */
   flex?: FlexValue | FlexValue[]
 }
 
@@ -2193,8 +2140,11 @@ export declare function responsiveLabelFont(
  * @public
  */
 export declare interface ResponsiveMarginProps {
+  /** Applies margins to all sides. The property is responsive. */
   margin?: number | number[]
+  /** Applies margins to the left and right sides. The property is responsive. */
   marginX?: number | number[]
+  /** Applies margins to the top and bottom sides. The property is responsive. */
   marginY?: number | number[]
   marginTop?: number | number[]
   marginRight?: number | number[]
@@ -2266,61 +2216,25 @@ export declare interface ResponsiveWidthStyleProps {
   $width: (number | 'auto')[]
 }
 
-/**
- * @internal
- */
-export declare interface RGB {
-  r: number
-  g: number
-  b: number
-  a?: undefined
-}
+export {RGB}
 
-/**
- * @internal
- */
-export declare interface RGBA {
-  r: number
-  g: number
-  b: number
-  a: number
-}
+export {RGBA}
 
-/**
- * @internal
- */
-export declare function rgba(color: unknown, a: number): string
+export {rgba}
 
-/**
- * @internal
- */
-export declare function rgbaToRGBA(rgba: string): RGBA
+export {rgbaToRGBA}
 
-/**
- * @internal
- */
-export declare function rgbToHex({r, g, b}: RGB): string
+export {rgbToHex}
 
-/**
- * @internal
- * @see https://css-tricks.com/converting-color-spaces-in-javascript/
- */
-export declare function rgbToHsl({r, g, b}: RGB): HSL
+export {rgbToHsl}
 
-/**
- * @public
- */
-export declare type RootTheme = BaseTheme<Styles>
+export {RootTheme}
 
-/**
- * Apply the \`screen\` blend mode
- * Source: https://www.w3.org/TR/compositing-1/#blendingscreen
- * @internal
- */
-declare function screen_2(b: RGB | RGBA, s: RGB | RGBA): RGB
 export {screen_2 as screen}
 
 /**
+ * The `Select` component provides control of options.
+ *
  * @public
  */
 export declare const Select: ForwardRefExoticComponent<
@@ -2331,7 +2245,7 @@ export declare const Select: ForwardRefExoticComponent<
 /**
  * @public
  */
-export declare type SelectableTone = 'default' | 'primary' | 'positive' | 'caution' | 'critical'
+export declare type SelectableTone = ThemeColorStateToneKey
 
 /**
  * @public
@@ -2362,10 +2276,12 @@ export declare interface SkeletonProps extends ResponsiveRadiusProps, Omit<BoxPr
 }
 
 /**
+ * Indicate that something is loading for an indeterminate amount of time.
+ *
  * @public
  */
 export declare const Spinner: ForwardRefExoticComponent<
-  Omit<SpinnerProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'size'>, 'ref'> &
+  Omit<SpinnerProps & Omit<HTMLProps<HTMLDivElement>, 'size' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -2381,7 +2297,7 @@ export declare interface SpinnerProps {
  * @public
  */
 export declare const SrOnly: ForwardRefExoticComponent<
-  Omit<SrOnlyProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'aria-hidden'>, 'ref'> &
+  Omit<SrOnlyProps & Omit<HTMLProps<HTMLDivElement>, 'aria-hidden' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -2394,6 +2310,8 @@ export declare interface SrOnlyProps {
 }
 
 /**
+ * The `Stack` component is used to place elements on top of each other.
+ *
  * @public
  */
 export declare const Stack: ForwardRefExoticComponent<
@@ -2408,29 +2326,17 @@ export declare interface StackProps extends BoxProps {
   space?: number | number[]
 }
 
-/**
- * @public
- */
-export declare const studioTheme: RootTheme
-
-/**
- * TODO: Rename to `ThemeStyles`
- * @public
- */
-export declare interface Styles {
-  button?: {
-    root?: CSSObject
-  }
-  card?: {
-    root?: CSSObject
-  }
-}
+export {studioTheme}
 
 /**
+ * The `Switch` component allows the user to toggle a setting on and off.
+ *
+ * Extends all properties of an `<input type="checkbox" />` element, except type.
+ *
  * @public
  */
 export declare const Switch: ForwardRefExoticComponent<
-  Omit<Omit<HTMLProps<HTMLInputElement>, 'type' | 'as'> & SwitchProps, 'ref'> &
+  Omit<Omit<HTMLProps<HTMLInputElement>, 'as' | 'type'> & SwitchProps, 'ref'> &
     RefAttributes<HTMLInputElement>
 >
 
@@ -2446,7 +2352,11 @@ export declare interface SwitchProps {
  */
 export declare const Tab: ForwardRefExoticComponent<
   Omit<
-    TabProps & Omit<HTMLProps<HTMLButtonElement>, 'type' | 'label' | 'as' | 'id' | 'aria-controls'>,
+    TabProps &
+      Omit<
+        HTMLProps<HTMLButtonElement>,
+        'label' | 'width' | 'id' | 'aria-controls' | 'as' | 'type'
+      >,
     'ref'
   > &
     RefAttributes<HTMLButtonElement>
@@ -2456,7 +2366,7 @@ export declare const Tab: ForwardRefExoticComponent<
  * @public
  */
 export declare const TabList: ForwardRefExoticComponent<
-  Omit<TabListProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'height'>, 'ref'> &
+  Omit<TabListProps & Omit<HTMLProps<HTMLDivElement>, 'height' | 'as'>, 'ref'> &
     RefAttributes<unknown>
 >
 
@@ -2472,7 +2382,7 @@ export declare interface TabListProps extends Omit<InlineProps, 'as' | 'height'>
  */
 export declare const TabPanel: ForwardRefExoticComponent<
   Omit<
-    TabPanelProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'id' | 'role' | 'aria-labelledby'>,
+    TabPanelProps & Omit<HTMLProps<HTMLDivElement>, 'id' | 'role' | 'aria-labelledby' | 'as'>,
     'ref'
   > &
     RefAttributes<HTMLDivElement>
@@ -2508,10 +2418,12 @@ export declare interface TabProps {
 }
 
 /**
+ * The `Text` component is an agile, themed typographic element.
+ *
  * @public
  */
 declare const Text_2: ForwardRefExoticComponent<
-  Omit<TextProps & Omit<HTMLProps<HTMLDivElement>, 'as' | 'size'>, 'ref'> &
+  Omit<TextProps & Omit<HTMLProps<HTMLDivElement>, 'size' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 export {Text_2 as Text}
@@ -2522,6 +2434,9 @@ export {Text_2 as Text}
 export declare type TextAlign = 'left' | 'right' | 'center' | 'justify' | 'initial'
 
 /**
+ * A multiline text input.
+ *
+
  * @public
  */
 export declare const TextArea: ForwardRefExoticComponent<
@@ -2538,14 +2453,15 @@ export declare interface TextAreaProps extends ResponsiveRadiusProps {
   fontSize?: number | number[]
   padding?: number | number[]
   weight?: ThemeFontWeightKey
-  tone?: ThemeColorToneKey
 }
 
 /**
+ * Single line text input.
+ *
  * @public
  */
 export declare const TextInput: ForwardRefExoticComponent<
-  Omit<TextInputProps & Omit<HTMLProps<HTMLInputElement>, 'type' | 'as' | 'prefix'>, 'ref'> &
+  Omit<TextInputProps & Omit<HTMLProps<HTMLInputElement>, 'prefix' | 'as' | 'type'>, 'ref'> &
     RefAttributes<HTMLInputElement>
 >
 
@@ -2559,6 +2475,10 @@ export declare type TextInputClearButtonProps = Omit<ButtonProps, 'as'> &
  * @public
  */
 export declare interface TextInputProps {
+  /**
+   * @beta
+   */
+  __unstable_disableFocusRing?: boolean
   border?: boolean
   /**
    * @beta
@@ -2579,7 +2499,6 @@ export declare interface TextInputProps {
   suffix?: React.ReactNode
   type?: TextInputType
   weight?: ThemeFontWeightKey
-  tone?: ThemeColorToneKey
 }
 
 /**
@@ -2606,6 +2525,7 @@ export declare interface TextProps {
   accent?: boolean
   align?: TextAlign | TextAlign[]
   as?: React.ElementType | keyof JSX.IntrinsicElements
+  /** When `true` the text color will be muted. */
   muted?: boolean
   size?: number | number[]
   /**
@@ -2623,7 +2543,7 @@ export declare interface TextProps {
  */
 export declare const TextSkeleton: ForwardRefExoticComponent<
   Omit<
-    TextSkeletonProps & Omit<HTMLProps<HTMLDivElement>, 'children' | 'as' | 'size' | 'height'>,
+    TextSkeletonProps & Omit<HTMLProps<HTMLDivElement>, 'size' | 'children' | 'height' | 'as'>,
     'ref'
   > &
     RefAttributes<HTMLDivElement>
@@ -2637,198 +2557,142 @@ export declare interface TextSkeletonProps extends SkeletonProps {
   size?: number | number[]
 }
 
-/**
- * @public
- */
-export declare interface Theme {
-  sanity: RootTheme
-}
+export {Theme}
 
-/**
- * @public
- */
-export declare interface ThemeAvatar {
-  sizes: {
-    distance: number
-    size: number
-  }[]
-  focusRing: FocusRing
-}
+export {THEME_COLOR_BLEND_MODES}
 
-/**
- * @public
- */
-export declare type ThemeColorName =
-  | 'default'
-  | 'transparent'
-  | 'primary'
-  | 'positive'
-  | 'caution'
-  | 'critical'
+export {THEME_COLOR_BUTTON_MODES}
+
+export {THEME_COLOR_CARD_TONES}
+
+export {THEME_COLOR_STATE_TONES}
+
+export {THEME_COLOR_STATES}
+
+export {ThemeAvatar}
+
+export {ThemeColor}
+
+export {ThemeColorBase}
+
+export {ThemeColorBaseTokens}
+
+export {ThemeColorBlendModeKey}
+
+export {ThemeColorBuilderOpts}
+
+export {ThemeColorButton}
+
+export {ThemeColorButtonModeKey}
+
+export {ThemeColorButtonState}
+
+export {ThemeColorButtonStates}
+
+export {ThemeColorButtonTokens}
+
+export {ThemeColorButtonTones}
+
+export {ThemeColorCard}
+
+export {ThemeColorCardState}
+
+export {ThemeColorCardToneKey}
+
+export {ThemeColorGenericState}
+
+export {ThemeColorInput}
+
+export {ThemeColorInputState}
+
+export {ThemeColorInputStates}
+
+export {ThemeColorMuted}
+
+export {ThemeColorMutedTone}
+
+export {ThemeColorName}
 
 /**
  * @public
- * @deprecated Use `toneContext` instead.
  */
 export declare function ThemeColorProvider(props: ThemeColorProviderProps): React.ReactElement
 
 /**
  * @public
- * @deprecated
  */
 export declare interface ThemeColorProviderProps {
   children?: React.ReactNode
   scheme?: ThemeColorSchemeKey
-  tone?: ThemeColorName
+  tone?: ThemeColorCardToneKey
 }
 
-/**
- * @public
- */
-export declare type ThemeColorSchemeKey = 'dark' | 'light'
+export {ThemeColorScheme}
 
-/**
- * @public
- */
-export declare interface ThemeColorSchemes {
-  tones: Record<ThemeColorName, ColorTints>
-}
+export {ThemeColorSchemeKey}
 
-/**
- * @public
- */
-export declare type ThemeColorSpotKey =
-  | 'gray'
-  | 'blue'
-  | 'purple'
-  | 'magenta'
-  | 'red'
-  | 'orange'
-  | 'yellow'
-  | 'green'
-  | 'cyan'
+export {ThemeColorSchemes}
 
-/**
- * @public
- */
-export declare type ThemeColorToneKey =
-  | 'default'
-  | 'transparent'
-  | 'primary'
-  | 'positive'
-  | 'caution'
-  | 'critical'
+export {ThemeColorSelectable}
+
+export {ThemeColorSelectableState}
+
+export {ThemeColorSelectableStates}
+
+export {ThemeColorSolid}
+
+export {ThemeColorSolidTone}
+
+export {ThemeColorSpot}
+
+export {ThemeColorSpotKey}
+
+export {ThemeColorStateKey}
+
+export {ThemeColorStatesTokens}
+
+export {ThemeColorStateTokens}
+
+export {ThemeColorStateToneKey}
+
+export {ThemeColorSyntax}
+
+export {ThemeColorTokens}
+
+export {ThemeColorTokenValue}
+
+export {ThemeColorToneKey}
+
+export {ThemeConfig}
 
 /**
  * @public
  */
 export declare interface ThemeContextValue {
+  /** @deprecated No longer used */
   version: 0.0
   scheme: ThemeColorSchemeKey
   theme: RootTheme
-  tone: ThemeColorName
+  tone: ThemeColorCardToneKey
 }
 
-/**
- * @public
- */
-export declare interface ThemeFont {
-  family: string
-  weights: ThemeFontWeight
-  sizes: ThemeFontSize[]
-  /** @deprecated No longer supported. */
-  horizontalOffset?: number
-}
+export {ThemeFocusRing}
 
-/**
- * @public
- */
-export declare type ThemeFontKey = 'code' | 'heading' | 'label' | 'text'
+export {ThemeFont}
 
-/**
- * @public
- */
-export declare interface ThemeFonts {
-  code: ThemeFont
-  heading: ThemeFont
-  label: ThemeFont
-  text: ThemeFont
-}
+export {ThemeFontKey}
 
-/**
- * @public
- */
-export declare interface ThemeFontSize {
-  ascenderHeight: number
-  descenderHeight: number
-  fontSize: number
-  iconSize: number
-  letterSpacing: number
-  lineHeight: number
-}
+export {ThemeFonts}
 
-/**
- * @public
- */
-export declare interface ThemeFontWeight {
-  regular: number
-  medium: number
-  semibold: number
-  bold: number
-}
+export {ThemeFontSize}
 
-/**
- * @public
- */
-export declare type ThemeFontWeightKey = 'regular' | 'medium' | 'semibold' | 'bold'
+export {ThemeFontWeight}
 
-/**
- * @public
- */
-export declare interface ThemeInput {
-  checkbox: {
-    size: number
-    focusRing: FocusRing
-  }
-  radio: {
-    size: number
-    markSize: number
-    focusRing: FocusRing
-  }
-  switch: {
-    width: number
-    height: number
-    padding: number
-    transitionDurationMs: number
-    transitionTimingFunction: string
-    focusRing: FocusRing
-  }
-  border: {
-    width: number
-  }
-  select: {
-    focusRing: FocusRing
-  }
-  text: {
-    focusRing: FocusRing
-  }
-}
+export {ThemeFontWeightKey}
 
-/**
- * THIS API MAY BE UNSTABLE. DO NOT USE IN PRODUCTION.
- * @beta
- */
-export declare interface ThemeLayer {
-  dialog: {
-    zOffset: number
-  }
-  popover: {
-    zOffset: number
-  }
-  tooltip: {
-    zOffset: number
-  }
-}
+export {ThemeInput}
+
+export {ThemeLayer}
 
 /**
  * @internal
@@ -2849,19 +2713,18 @@ export declare interface ThemeProviderProps {
   children?: React.ReactNode
   scheme?: ThemeColorSchemeKey
   theme?: RootTheme
-  tone?: ThemeColorName
+  tone?: ThemeColorCardToneKey
 }
 
-/**
- * @public
- */
-export declare interface ThemeShadow {
-  umbra: BoxShadow
-  penumbra: BoxShadow
-  ambient: BoxShadow
-}
+export {ThemeShadow}
+
+export {ThemeStyles}
 
 /**
+ * The `Toast` component gives feedback to users when an action has taken place.
+ *
+ * Toasts can be closed with a close button, or auto-dismiss after a certain timeout.
+ *
  * @public
  */
 export declare function Toast(
@@ -2896,6 +2759,7 @@ export declare interface ToastProps {
   closable?: boolean
   description?: React.ReactNode
   onClose?: () => void
+  radius?: number | number[]
   title?: React.ReactNode
   status?: 'error' | 'warning' | 'success' | 'info'
 }
@@ -2916,11 +2780,27 @@ export declare interface ToastProviderProps {
   zOffset?: number | number[]
 }
 
+export {TokenBaseKeyNode}
+
+export {TokenBlendModeValueNode}
+
+export {TokenButtonKeyNode}
+
+export {TokenColorValueNode}
+
+export {TokenHueValueNode}
+
+export {TokenKeyNode}
+
+export {TokenValueNode}
+
 /**
+ * Tooltips display information when hovering, focusing or tapping.
+ *
  * @public
  */
 export declare const Tooltip: ForwardRefExoticComponent<
-  Omit<TooltipProps & Omit<HTMLProps<HTMLDivElement>, 'children' | 'as' | 'content'>, 'ref'> &
+  Omit<TooltipProps & Omit<HTMLProps<HTMLDivElement>, 'content' | 'children' | 'as'>, 'ref'> &
     RefAttributes<HTMLDivElement>
 >
 
@@ -2956,11 +2836,13 @@ export declare function TooltipDelayGroupProvider(
 export declare interface TooltipDelayGroupProviderProps {
   children?: React.ReactNode
   /**
-   * @public Handles the delays to open or close a tooltip inside a group
+   * Handles the delays to open or close a tooltip inside a group
    *
    * If only a `number` is passed, it will be used for both opening and closing.
    *
    * If an object `{open: number; close:number}` is passed, it can be used to set different delays for each action.
+   *
+   * @public
    */
   delay: Delay
 }
@@ -2971,6 +2853,7 @@ export declare interface TooltipDelayGroupProviderProps {
 export declare interface TooltipProps extends Omit<LayerProps, 'as'> {
   /** @deprecated Use `fallbackPlacements` instead. */
   allowedAutoPlacements?: Placement[]
+  arrow?: boolean
   boundaryElement?: HTMLElement | null
   children?: React.ReactElement
   content?: React.ReactNode
@@ -2978,17 +2861,29 @@ export declare interface TooltipProps extends Omit<LayerProps, 'as'> {
   fallbackPlacements?: Placement[]
   padding?: number | number[]
   placement?: Placement
+  /** Whether or not to render the tooltip in a portal element. */
   portal?: boolean | string
+  radius?: number | number[]
   scheme?: ThemeColorSchemeKey
   shadow?: number | number[]
   /**
-   * @public Adds a delay to open or close the tooltip.  Defaults to 0.
+   * Adds a delay to open or close the tooltip.
    *
    * If only a `number` is passed, it will be used for both opening and closing.
    *
    * If an object `{open: number; close:number}` is passed, it can be used to set different delays for each action.
+   *
+   * @public
+   * @defaultValue 0
    */
   delay?: Delay
+  /**
+   * Whether the tooltip should animate in and out.
+   *
+   * @beta
+   * @defaultValue false
+   */
+  animate?: boolean
 }
 
 /**
@@ -2998,7 +2893,7 @@ export declare interface TooltipProps extends Omit<LayerProps, 'as'> {
 export declare const Tree: MemoExoticComponent<
   ForwardRefExoticComponent<
     TreeProps &
-      Omit<HTMLProps<HTMLDivElement>, 'ref' | 'as' | 'wrap' | 'height' | 'role' | 'align'> &
+      Omit<HTMLProps<HTMLDivElement>, 'wrap' | 'ref' | 'height' | 'role' | 'as' | 'align'> &
       RefAttributes<HTMLDivElement>
   >
 >
@@ -3023,7 +2918,7 @@ export declare interface TreeContextValue {
  * @beta
  */
 export declare const TreeItem: NamedExoticComponent<
-  TreeItemProps & Omit<HTMLProps<HTMLLIElement>, 'ref' | 'as' | 'role'>
+  TreeItemProps & Omit<HTMLProps<HTMLLIElement>, 'ref' | 'role' | 'as'>
 >
 
 /**
@@ -3167,6 +3062,11 @@ export declare function useRootTheme(): ThemeContextValue
  */
 export declare function useTheme(): Theme
 
+/**
+ * @public
+ */
+export declare function useTheme_v2(): Theme_v2
+
 /**
  * @public
  */
@@ -3188,7 +3088,7 @@ export declare function useTree(): TreeContextValue
 export declare const VirtualList: ForwardRefExoticComponent<
   VirtualListProps<any> &
     StackProps &
-    Omit<HTMLProps<HTMLDivElement>, 'children' | 'ref' | 'as' | 'onChange'> &
+    Omit<HTMLProps<HTMLDivElement>, 'children' | 'ref' | 'onChange' | 'as'> &
     RefAttributes<HTMLDivElement>
 >