@mekari/pixel3-styled-system 0.0.7 → 0.0.8-dev.0

package/types/conditions.d.ts

@@ -150,9 +150,9 @@ export interface Conditions {
 	"_landscape": string
 	/** `@media (orientation: portrait)` */
 	"_portrait": string
-	/** ` &.dark, .dark &` */
+	/** `.dark &` */
 	"_dark": string
-	/** ` &.light, .light &` */
+	/** `.light &` */
 	"_light": string
 	/** `@media (prefers-color-scheme: dark)` */
 	"_osDark": string
@@ -178,6 +178,8 @@ export interface Conditions {
 	"_horizontal": string
 	/** `&[data-orientation=vertical]` */
 	"_vertical": string
+	/** `@starting-style` */
+	"_starting": string
 	/** `&:is([hidden])` */
 	"_hidden": string
 	/** `&:is([aria-collapsed=true], [data-collapsed], [data-state="collapsed"])` */
@@ -198,57 +200,53 @@ export interface Conditions {
 	"_placementLeft": string
 	/** `&[data-placement=right]` */
 	"_placementRight": string
-	/** `@media screen and (min-width: 22.5em)` */
+	/** `@media screen and (min-width: 22.5rem)` */
 	"sm": string
-	/** `@media screen and (min-width: 22.5em) and (max-width: 47.9975em)` */
+	/** `@media screen and (min-width: 22.5rem) and (max-width: 47.9975rem)` */
 	"smOnly": string
-	/** `@media screen and (max-width: 22.4975em)` */
+	/** `@media screen and (max-width: 22.4975rem)` */
 	"smDown": string
-	/** `@media screen and (min-width: 48em)` */
+	/** `@media screen and (min-width: 48rem)` */
 	"md": string
-	/** `@media screen and (min-width: 48em) and (max-width: 63.9975em)` */
+	/** `@media screen and (min-width: 48rem) and (max-width: 63.9975rem)` */
 	"mdOnly": string
-	/** `@media screen and (max-width: 47.9975em)` */
+	/** `@media screen and (max-width: 47.9975rem)` */
 	"mdDown": string
-	/** `@media screen and (min-width: 64em)` */
+	/** `@media screen and (min-width: 64rem)` */
 	"lg": string
-	/** `@media screen and (min-width: 64em) and (max-width: 79.9975em)` */
+	/** `@media screen and (min-width: 64rem) and (max-width: 79.9975rem)` */
 	"lgOnly": string
-	/** `@media screen and (max-width: 63.9975em)` */
+	/** `@media screen and (max-width: 63.9975rem)` */
 	"lgDown": string
-	/** `@media screen and (min-width: 80em)` */
+	/** `@media screen and (min-width: 80rem)` */
 	"xl": string
-	/** `@media screen and (min-width: 80em)` */
+	/** `@media screen and (min-width: 80rem)` */
 	"xlOnly": string
-	/** `@media screen and (max-width: 79.9975em)` */
+	/** `@media screen and (max-width: 79.9975rem)` */
 	"xlDown": string
-	/** `@media screen and (min-width: 22.5em) and (max-width: 47.9975em)` */
+	/** `@media screen and (min-width: 22.5rem) and (max-width: 47.9975rem)` */
 	"smToMd": string
-	/** `@media screen and (min-width: 22.5em) and (max-width: 63.9975em)` */
+	/** `@media screen and (min-width: 22.5rem) and (max-width: 63.9975rem)` */
 	"smToLg": string
-	/** `@media screen and (min-width: 22.5em) and (max-width: 79.9975em)` */
+	/** `@media screen and (min-width: 22.5rem) and (max-width: 79.9975rem)` */
 	"smToXl": string
-	/** `@media screen and (min-width: 48em) and (max-width: 63.9975em)` */
+	/** `@media screen and (min-width: 48rem) and (max-width: 63.9975rem)` */
 	"mdToLg": string
-	/** `@media screen and (min-width: 48em) and (max-width: 79.9975em)` */
+	/** `@media screen and (min-width: 48rem) and (max-width: 79.9975rem)` */
 	"mdToXl": string
-	/** `@media screen and (min-width: 64em) and (max-width: 79.9975em)` */
+	/** `@media screen and (min-width: 64rem) and (max-width: 79.9975rem)` */
 	"lgToXl": string
 	/** The base (=no conditions) styles to apply  */
 	"base": string
 }
 
-export type Condition = keyof Conditions
-
-export type Conditional<V> =
+export type ConditionalValue<V> =
   | V
   | Array<V | null>
   | {
-      [K in keyof Conditions]?: Conditional<V>
+      [K in keyof Conditions]?: ConditionalValue<V>
     }
 
-export type ConditionalValue<T> = Conditional<T>
-
 export type Nested<P> = P & {
   [K in Selectors]?: Nested<P>
 } & {

package/types/pattern.d.ts

@@ -50,6 +50,10 @@ export interface PatternConfig<T extends PatternProperties = PatternProperties>
    * The css object this pattern will generate.
    */
   transform?: (props: InferProps<T>, helpers: PatternHelpers) => SystemStyleObject
+  /**
+   * Whether the pattern is deprecated.
+   */
+  deprecated?: boolean | string
   /**
    * The jsx element name this pattern will generate.
    */

package/types/prop-type.d.ts

@@ -3,8 +3,7 @@ import type { ConditionalValue } from './conditions';
 import type { CssProperties } from './system-types';
 import type { Tokens } from '../tokens/index';
 
-interface PropertyValueTypes {
-	aspectRatio: Tokens["aspectRatios"];
+export interface UtilityValues {
 	zIndex: Tokens["zIndex"];
 	top: Tokens["spacing"];
 	left: Tokens["spacing"];
@@ -17,9 +16,7 @@ interface PropertyValueTypes {
 	insetInlineStart: Tokens["spacing"];
 	right: Tokens["spacing"];
 	bottom: Tokens["spacing"];
-	insetX: Tokens["spacing"] | CssProperties["insetInline"];
-	insetY: Tokens["spacing"] | CssProperties["insetBlock"];
-	float: "left" | "right" | "start" | "end";
+	float: "start" | "end" | CssProperties["float"];
 	hideFrom: Tokens["breakpoints"];
 	hideBelow: Tokens["breakpoints"];
 	flexBasis: Tokens["spacing"] | "1/2" | "1/3" | "2/3" | "1/4" | "2/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "full";
@@ -58,12 +55,11 @@ interface PropertyValueTypes {
 	marginInline: "auto" | Tokens["spacing"];
 	marginInlineEnd: "auto" | Tokens["spacing"];
 	marginInlineStart: "auto" | Tokens["spacing"];
-	outlineWidth: Tokens["borderWidths"];
+	spaceX: "auto" | Tokens["spacing"] | CssProperties["marginInlineStart"];
+	spaceY: "auto" | Tokens["spacing"] | CssProperties["marginBlockStart"];
 	outlineColor: Tokens["colors"];
 	outline: Tokens["borders"];
 	outlineOffset: Tokens["spacing"];
-	divideX: string;
-	divideY: string;
 	divideColor: Tokens["colors"];
 	divideStyle: CssProperties["borderStyle"];
 	width: "auto" | Tokens["sizes"] | "1/2" | "1/3" | "2/3" | "1/4" | "2/4" | "3/4" | "1/5" | "2/5" | "3/5" | "4/5" | "1/6" | "2/6" | "3/6" | "4/6" | "5/6" | "1/12" | "2/12" | "3/12" | "4/12" | "5/12" | "6/12" | "7/12" | "8/12" | "9/12" | "10/12" | "11/12" | "screen";
@@ -89,14 +85,13 @@ interface PropertyValueTypes {
 	textEmphasisColor: Tokens["colors"];
 	textIndent: Tokens["spacing"];
 	textShadow: Tokens["shadows"];
+	textShadowColor: Tokens["colors"];
 	textWrap: "wrap" | "balance" | "nowrap";
 	truncate: boolean;
-	listStyleImage: Tokens["assets"];
 	background: Tokens["colors"];
 	backgroundColor: Tokens["colors"];
-	backgroundImage: Tokens["assets"];
-	backgroundGradient: Tokens["gradients"] | "to-t" | "to-tr" | "to-r" | "to-br" | "to-b" | "to-bl" | "to-l" | "to-tl";
-	textGradient: Tokens["gradients"] | "to-t" | "to-tr" | "to-r" | "to-br" | "to-b" | "to-bl" | "to-l" | "to-tl";
+	backgroundGradient: "to-t" | "to-tr" | "to-r" | "to-br" | "to-b" | "to-bl" | "to-l" | "to-tl";
+	textGradient: "to-t" | "to-tr" | "to-r" | "to-br" | "to-b" | "to-bl" | "to-l" | "to-tl";
 	gradientFrom: Tokens["colors"];
 	gradientTo: Tokens["colors"];
 	gradientVia: Tokens["colors"];
@@ -116,27 +111,18 @@ interface PropertyValueTypes {
 	borderEndEndRadius: Tokens["radii"];
 	borderEndRadius: Tokens["radii"] | CssProperties["borderRadius"];
 	border: Tokens["borders"];
-	borderWidth: Tokens["borderWidths"];
-	borderTopWidth: Tokens["borderWidths"];
-	borderLeftWidth: Tokens["borderWidths"];
-	borderRightWidth: Tokens["borderWidths"];
-	borderBottomWidth: Tokens["borderWidths"];
 	borderColor: Tokens["colors"];
 	borderInline: Tokens["borders"];
-	borderInlineWidth: Tokens["borderWidths"];
 	borderInlineColor: Tokens["colors"];
 	borderBlock: Tokens["borders"];
-	borderBlockWidth: Tokens["borderWidths"];
 	borderBlockColor: Tokens["colors"];
 	borderLeft: Tokens["borders"];
 	borderLeftColor: Tokens["colors"];
 	borderInlineStart: Tokens["borders"];
-	borderInlineStartWidth: Tokens["borderWidths"];
 	borderInlineStartColor: Tokens["colors"];
 	borderRight: Tokens["borders"];
 	borderRightColor: Tokens["colors"];
 	borderInlineEnd: Tokens["borders"];
-	borderInlineEndWidth: Tokens["borderWidths"];
 	borderInlineEndColor: Tokens["colors"];
 	borderTop: Tokens["borders"];
 	borderTopColor: Tokens["colors"];
@@ -150,30 +136,29 @@ interface PropertyValueTypes {
 	boxShadow: Tokens["shadows"];
 	boxShadowColor: Tokens["colors"];
 	filter: "auto";
-	dropShadow: Tokens["dropShadows"];
-	blur: Tokens["blurs"];
 	backdropFilter: "auto";
-	backdropBlur: Tokens["blurs"];
-	borderSpacing: Tokens["spacing"];
+	borderSpacing: Tokens["spacing"] | "auto";
 	borderSpacingX: Tokens["spacing"];
 	borderSpacingY: Tokens["spacing"];
-	transitionTimingFunction: Tokens["easings"];
 	transitionDelay: Tokens["durations"];
 	transitionDuration: Tokens["durations"];
 	transition: "all" | "common" | "background" | "colors" | "opacity" | "shadow" | "transform";
-	animation: Tokens["animations"];
-	animationName: Tokens["animationName"];
+	animationName: "fade-in" | "fade-out" | "spin";
+	animationDuration: Tokens["durations"];
 	animationDelay: Tokens["durations"];
+	rotate: "auto" | "auto-3d" | CssProperties["rotate"];
+	rotateX: CssProperties["rotate"];
+	rotateY: CssProperties["rotate"];
+	rotateZ: CssProperties["rotate"];
 	scale: "auto" | CssProperties["scale"];
-	translate: "auto" | CssProperties["translate"];
+	translate: "auto" | "auto-3d" | CssProperties["translate"];
 	translateX: Tokens["spacing"] | "1/2" | "1/3" | "2/3" | "1/4" | "2/4" | "3/4" | "full" | "-1/2" | "-1/3" | "-2/3" | "-1/4" | "-2/4" | "-3/4" | "-full";
 	translateY: Tokens["spacing"] | "1/2" | "1/3" | "2/3" | "1/4" | "2/4" | "3/4" | "full" | "-1/2" | "-1/3" | "-2/3" | "-1/4" | "-2/4" | "-3/4" | "-full";
+	translateZ: Tokens["spacing"] | "1/2" | "1/3" | "2/3" | "1/4" | "2/4" | "3/4" | "full" | "-1/2" | "-1/3" | "-2/3" | "-1/4" | "-2/4" | "-3/4" | "-full";
 	accentColor: Tokens["colors"];
 	caretColor: Tokens["colors"];
 	scrollbar: "visible" | "hidden";
 	scrollMargin: Tokens["spacing"];
-	scrollMarginX: Tokens["spacing"] | CssProperties["scrollMarginInline"];
-	scrollMarginY: Tokens["spacing"] | CssProperties["scrollMarginBlock"];
 	scrollMarginLeft: Tokens["spacing"];
 	scrollMarginRight: Tokens["spacing"];
 	scrollMarginTop: Tokens["spacing"];
@@ -191,8 +176,6 @@ interface PropertyValueTypes {
 	scrollPaddingInline: Tokens["spacing"];
 	scrollPaddingInlineEnd: Tokens["spacing"];
 	scrollPaddingInlineStart: Tokens["spacing"];
-	scrollPaddingX: Tokens["spacing"] | CssProperties["scrollPaddingInline"];
-	scrollPaddingY: Tokens["spacing"] | CssProperties["scrollPaddingBlock"];
 	scrollPaddingLeft: Tokens["spacing"];
 	scrollPaddingRight: Tokens["spacing"];
 	scrollPaddingTop: Tokens["spacing"];
@@ -206,205 +189,50 @@ interface PropertyValueTypes {
 	scrollSnapMarginRight: Tokens["spacing"];
 	fill: Tokens["colors"];
 	stroke: Tokens["colors"];
-	strokeWidth: Tokens["borderWidths"];
 	srOnly: boolean;
 	debug: boolean;
-	containerName: Tokens["containerNames"] | CssProperties["containerName"];
+	containerName: CssProperties["containerName"];
 	colorPalette: "currentcolor" | "dark" | "white" | "background" | "overlay" | "brand" | "whiteAlpha" | "blackAlpha" | "gray" | "blue" | "red" | "green" | "orange" | "sky" | "teal" | "violet" | "amber" | "rose" | "stone" | "lime" | "pink" | "apricot" | "aqua" | "leaf" | "fuchsia" | "ice" | "ash";
 	textStyle: "overline" | "body.sm" | "body.md" | "label.sm" | "label.md" | "h3" | "h2" | "h1";
 }
 
 
 
-  type CssValue<T> = T extends keyof CssProperties ? CssProperties[T] : never
+type WithColorOpacityModifier<T> = T extends string ? `${T}/${string}` : T
 
-  type Shorthand<T> = T extends keyof PropertyValueTypes ? PropertyValueTypes[T] | CssValue<T> : CssValue<T>
+type ImportantMark = "!" | "!important"
+type WhitespaceImportant = ` ${ImportantMark}`
+type Important = ImportantMark | WhitespaceImportant
+type WithImportant<T> = T extends string ? `${T}${Important}` & { __important?: true } : T;
 
-  export interface PropertyTypes extends PropertyValueTypes {
-  
-	pos: Shorthand<"position">;
-	insetEnd: Shorthand<"insetInlineEnd">;
-	end: Shorthand<"insetInlineEnd">;
-	insetStart: Shorthand<"insetInlineStart">;
-	start: Shorthand<"insetInlineStart">;
-	flexDir: Shorthand<"flexDirection">;
-	p: Shorthand<"padding">;
-	pl: Shorthand<"paddingLeft">;
-	pr: Shorthand<"paddingRight">;
-	pt: Shorthand<"paddingTop">;
-	pb: Shorthand<"paddingBottom">;
-	py: Shorthand<"paddingBlock">;
-	paddingY: Shorthand<"paddingBlock">;
-	paddingX: Shorthand<"paddingInline">;
-	px: Shorthand<"paddingInline">;
-	pe: Shorthand<"paddingInlineEnd">;
-	paddingEnd: Shorthand<"paddingInlineEnd">;
-	ps: Shorthand<"paddingInlineStart">;
-	paddingStart: Shorthand<"paddingInlineStart">;
-	ml: Shorthand<"marginLeft">;
-	mr: Shorthand<"marginRight">;
-	mt: Shorthand<"marginTop">;
-	mb: Shorthand<"marginBottom">;
-	m: Shorthand<"margin">;
-	my: Shorthand<"marginBlock">;
-	marginY: Shorthand<"marginBlock">;
-	mx: Shorthand<"marginInline">;
-	marginX: Shorthand<"marginInline">;
-	me: Shorthand<"marginInlineEnd">;
-	marginEnd: Shorthand<"marginInlineEnd">;
-	ms: Shorthand<"marginInlineStart">;
-	marginStart: Shorthand<"marginInlineStart">;
-	ringWidth: Shorthand<"outlineWidth">;
-	ringColor: Shorthand<"outlineColor">;
-	ring: Shorthand<"outline">;
-	ringOffset: Shorthand<"outlineOffset">;
-	w: Shorthand<"width">;
-	minW: Shorthand<"minWidth">;
-	maxW: Shorthand<"maxWidth">;
-	h: Shorthand<"height">;
-	minH: Shorthand<"minHeight">;
-	maxH: Shorthand<"maxHeight">;
-	bgPosition: Shorthand<"backgroundPosition">;
-	bgPositionX: Shorthand<"backgroundPositionX">;
-	bgPositionY: Shorthand<"backgroundPositionY">;
-	bgAttachment: Shorthand<"backgroundAttachment">;
-	bgClip: Shorthand<"backgroundClip">;
-	bg: Shorthand<"background">;
-	bgColor: Shorthand<"backgroundColor">;
-	bgOrigin: Shorthand<"backgroundOrigin">;
-	bgImage: Shorthand<"backgroundImage">;
-	bgRepeat: Shorthand<"backgroundRepeat">;
-	bgBlendMode: Shorthand<"backgroundBlendMode">;
-	bgSize: Shorthand<"backgroundSize">;
-	bgGradient: Shorthand<"backgroundGradient">;
-	rounded: Shorthand<"borderRadius">;
-	roundedTopLeft: Shorthand<"borderTopLeftRadius">;
-	roundedTopRight: Shorthand<"borderTopRightRadius">;
-	roundedBottomRight: Shorthand<"borderBottomRightRadius">;
-	roundedBottomLeft: Shorthand<"borderBottomLeftRadius">;
-	roundedTop: Shorthand<"borderTopRadius">;
-	roundedRight: Shorthand<"borderRightRadius">;
-	roundedBottom: Shorthand<"borderBottomRadius">;
-	roundedLeft: Shorthand<"borderLeftRadius">;
-	roundedStartStart: Shorthand<"borderStartStartRadius">;
-	roundedStartEnd: Shorthand<"borderStartEndRadius">;
-	roundedStart: Shorthand<"borderStartRadius">;
-	roundedEndStart: Shorthand<"borderEndStartRadius">;
-	roundedEndEnd: Shorthand<"borderEndEndRadius">;
-	roundedEnd: Shorthand<"borderEndRadius">;
-	borderX: Shorthand<"borderInline">;
-	borderXWidth: Shorthand<"borderInlineWidth">;
-	borderXColor: Shorthand<"borderInlineColor">;
-	borderY: Shorthand<"borderBlock">;
-	borderYWidth: Shorthand<"borderBlockWidth">;
-	borderYColor: Shorthand<"borderBlockColor">;
-	borderStart: Shorthand<"borderInlineStart">;
-	borderStartWidth: Shorthand<"borderInlineStartWidth">;
-	borderStartColor: Shorthand<"borderInlineStartColor">;
-	borderEnd: Shorthand<"borderInlineEnd">;
-	borderEndWidth: Shorthand<"borderInlineEndWidth">;
-	borderEndColor: Shorthand<"borderInlineEndColor">;
-	shadow: Shorthand<"boxShadow">;
-	shadowColor: Shorthand<"boxShadowColor">;
-	x: Shorthand<"translateX">;
-	y: Shorthand<"translateY">;
-}
-
-type StrictableProps =
-  | 'alignContent'
-  | 'alignItems'
-  | 'alignSelf'
-  | 'all'
-  | 'animationComposition'
-  | 'animationDirection'
-  | 'animationFillMode'
-  | 'appearance'
-  | 'backfaceVisibility'
-  | 'backgroundAttachment'
-  | 'backgroundClip'
-  | 'borderCollapse'
-  | 'border'
-  | 'borderBlock'
-  | 'borderBlockEnd'
-  | 'borderBlockStart'
-  | 'borderBottom'
-  | 'borderInline'
-  | 'borderInlineEnd'
-  | 'borderInlineStart'
-  | 'borderLeft'
-  | 'borderRight'
-  | 'borderTop'
-  | 'borderBlockEndStyle'
-  | 'borderBlockStartStyle'
-  | 'borderBlockStyle'
-  | 'borderBottomStyle'
-  | 'borderInlineEndStyle'
-  | 'borderInlineStartStyle'
-  | 'borderInlineStyle'
-  | 'borderLeftStyle'
-  | 'borderRightStyle'
-  | 'borderTopStyle'
-  | 'boxDecorationBreak'
-  | 'boxSizing'
-  | 'breakAfter'
-  | 'breakBefore'
-  | 'breakInside'
-  | 'captionSide'
-  | 'clear'
-  | 'columnFill'
-  | 'columnRuleStyle'
-  | 'contentVisibility'
-  | 'direction'
-  | 'display'
-  | 'emptyCells'
-  | 'flexDirection'
-  | 'flexWrap'
-  | 'float'
-  | 'fontKerning'
-  | 'forcedColorAdjust'
-  | 'isolation'
-  | 'lineBreak'
-  | 'mixBlendMode'
-  | 'objectFit'
-  | 'outlineStyle'
-  | 'overflow'
-  | 'overflowX'
-  | 'overflowY'
-  | 'overflowBlock'
-  | 'overflowInline'
-  | 'overflowWrap'
-  | 'pointerEvents'
-  | 'position'
-  | 'resize'
-  | 'scrollBehavior'
-  | 'touchAction'
-  | 'transformBox'
-  | 'transformStyle'
-  | 'userSelect'
-  | 'visibility'
-  | 'wordBreak'
-  | 'writingMode'
+/**
+ * Only relevant when using `strictTokens` or `strictPropertyValues` in your config.
+ * - Allows you to use an escape hatch (e.g. `[123px]`) to use any string as a value.
+ * - Allows you to use a color opacity modifier (e.g. `red/300`) with known color values.
+ * - Allows you to use an important mark (e.g. `!` or `!important`) in the value.
+ *
+ * This is useful when you want to use a value that is not defined in the config or want to opt-out of the defaults.
+ *
+ * @example
+ * css({
+ *   fontSize: '[123px]', // ⚠️ will not throw even if you haven't defined 123px as a token
+ * })
+ *
+ * @see https://panda-css.com/docs/concepts/writing-styles#stricttokens
+ * @see https://panda-css.com/docs/concepts/writing-styles#strictpropertyvalues
+ */
+export type WithEscapeHatch<T> = T | `[${string}]` | WithColorOpacityModifier<T> | WithImportant<T>
 
-type WithEscapeHatch<T> = T | `[${string}]`
-
-type FilterVagueString<Key, Value> = Value extends boolean
+/**
+ * Will restrict the value of properties that have predefined values to those values only.
+ *
+ * @example
+ * css({
+ *   display: 'abc', // ❌ will throw
+ * })
+ *
+ * @see https://panda-css.com/docs/concepts/writing-styles#strictpropertyvalues
+ */
+export type OnlyKnown<Key, Value> = Value extends boolean
   ? Value
-  : Key extends StrictableProps
-    ? Value extends `${infer _}` ? Value : never
-    : Value
-
-type PropOrCondition<Key, Value> = ConditionalValue<Value | (string & {})>
-
-type PropertyTypeValue<T extends string> = T extends keyof PropertyTypes
-  ? PropOrCondition<T, PropertyTypes[T] | CssValue<T>>
-  : never;
-
-type CssPropertyValue<T extends string> = T extends keyof CssProperties
-  ? PropOrCondition<T, CssProperties[T]>
-  : never;
-
-export type PropertyValue<T extends string> = T extends keyof PropertyTypes
-  ? PropertyTypeValue<T>
-  : T extends keyof CssProperties
-    ? CssPropertyValue<T>
-    : PropOrCondition<T, string | number>
+  : Value extends `${infer _}` ? Value : never

package/types/recipe.d.ts

@@ -14,10 +14,21 @@ export type RecipeSelection<T extends RecipeVariantRecord> = keyof any extends k
 
 export type RecipeVariantFn<T extends RecipeVariantRecord> = (props?: RecipeSelection<T>) => string
 
+/**
+ * Extract the variant as optional props from a `cva` function.
+ * Intended to be used with a JSX component, prefer `RecipeVariant` for a more strict type.
+ */
 export type RecipeVariantProps<
   T extends RecipeVariantFn<RecipeVariantRecord> | SlotRecipeVariantFn<string, SlotRecipeVariantRecord<string>>,
 > = Pretty<Parameters<T>[0]>
 
+/**
+ * Extract the variants from a `cva` function.
+ */
+export type RecipeVariant<
+  T extends RecipeVariantFn<RecipeVariantRecord> | SlotRecipeVariantFn<string, SlotRecipeVariantRecord<string>>,
+> = Exclude<Pretty<Required<RecipeVariantProps<T>>>, undefined>
+
 type RecipeVariantMap<T extends RecipeVariantRecord> = {
   [K in keyof T]: Array<keyof T[K]>
 }
@@ -35,6 +46,7 @@ export interface RecipeRuntimeFn<T extends RecipeVariantRecord> extends RecipeVa
   splitVariantProps<Props extends RecipeSelection<T>>(
     props: Props,
   ): [RecipeSelection<T>, Pretty<DistributiveOmit<Props, keyof T>>]
+  getVariantProps: (props?: RecipeSelection<T>) => RecipeSelection<T>
 }
 
 type OneOrMore<T> = T | Array<T>
@@ -52,6 +64,10 @@ export interface RecipeDefinition<T extends RecipeVariantRecord = RecipeVariantR
    * The base styles of the recipe.
    */
   base?: SystemStyleObject
+  /**
+   * Whether the recipe is deprecated.
+   */
+  deprecated?: boolean | string
   /**
    * The multi-variant styles of the recipe.
    */
@@ -64,17 +80,13 @@ export interface RecipeDefinition<T extends RecipeVariantRecord = RecipeVariantR
    * The styles to apply when a combination of variants is selected.
    */
   compoundVariants?: Pretty<RecipeCompoundVariant<RecipeCompoundSelection<T>>>[]
-  /**
-   * Variants to pre-generate, will be include in the final `config.staticCss`
-   */
-  staticCss?: RecipeRule[]
 }
 
 export type RecipeCreatorFn = <T extends RecipeVariantRecord>(config: RecipeDefinition<T>) => RecipeRuntimeFn<T>
 
 interface RecipeConfigMeta {
   /**
-   * The name of the recipe.
+   * The class name of the recipe.
    */
   className: string
   /**
@@ -88,6 +100,10 @@ interface RecipeConfigMeta {
    * @example ['Button', 'Link', /Button$/]
    */
   jsx?: Array<string | RegExp>
+  /**
+   * Variants to pre-generate, will be include in the final `config.staticCss`
+   */
+  staticCss?: RecipeRule[]
 }
 
 export interface RecipeConfig<T extends RecipeVariantRecord = RecipeVariantRecord>
@@ -111,7 +127,10 @@ export interface SlotRecipeRuntimeFn<S extends string, T extends SlotRecipeVaria
   raw: (props?: RecipeSelection<T>) => Record<S, SystemStyleObject>
   variantKeys: (keyof T)[]
   variantMap: RecipeVariantMap<T>
-  splitVariantProps<Props extends RecipeSelection<T>>(props: Props): [RecipeSelection<T>, Pretty<Omit<Props, keyof T>>]
+  splitVariantProps<Props extends RecipeSelection<T>>(
+    props: Props,
+  ): [RecipeSelection<T>, Pretty<DistributiveOmit<Props, keyof T>>]
+  getVariantProps: (props?: RecipeSelection<T>) => RecipeSelection<T>
 }
 
 export type SlotRecipeCompoundVariant<S extends string, T> = T & {
@@ -122,6 +141,14 @@ export interface SlotRecipeDefinition<
   S extends string = string,
   T extends SlotRecipeVariantRecord<S> = SlotRecipeVariantRecord<S>,
 > {
+  /**
+   * An optional class name that can be used to target slots in the DOM.
+   */
+  className?: string
+  /**
+   * Whether the recipe is deprecated.
+   */
+  deprecated?: boolean | string
   /**
    * The parts/slots of the recipe.
    */
@@ -142,10 +169,6 @@ export interface SlotRecipeDefinition<
    * The styles to apply when a combination of variants is selected.
    */
   compoundVariants?: Pretty<SlotRecipeCompoundVariant<S, RecipeCompoundSelection<T>>>[]
-  /**
-   * Variants to pre-generate, will be include in the final `config.staticCss`
-   */
-  staticCss?: RecipeRule[]
 }
 
 export type SlotRecipeCreatorFn = <S extends string, T extends SlotRecipeVariantRecord<S>>(

package/types/static-css.d.ts

@@ -44,4 +44,8 @@ export interface StaticCssOptions {
   patterns?: {
     [pattern: string]: PatternRule[]
   }
+  /**
+   * The CSS themes to generate
+   */
+  themes?: string[]
 }