@pandacss/types 0.8.0 → 0.10.0

package/dist/config.d.ts

@@ -126,6 +126,30 @@ type JsxOptions = {
    * ```
    */
   jsxFactory?: string
+  /**
+   * The style props allowed on generated JSX components
+   * - When set to 'all', all style props are allowed.
+   * - When set to 'minimal', only the `css` prop is allowed.
+   * - When set to 'none', no style props are allowed and therefore the jsxFactory will not be importable.
+   *
+   * @default 'all'
+   *
+   * @example with 'all':
+   * ```jsx
+   * <styled.button marginTop="40px">Click me</styled.button>
+   * ```
+   *
+   * @example with 'minimal':
+   * ```jsx
+   * <styled.button css={{ marginTop: "40px" }}>Click me</styled.button>
+   * ```
+   *
+   * @example with 'none':
+   * ```jsx
+   * <button className={css({ marginTop: "40px" })}>Click me</button>
+   * ```
+   */
+  jsxStyleProps?: 'all' | 'minimal' | 'none'
 }
 
 type CssgenOptions = {
@@ -198,7 +222,7 @@ type CodegenOptions = {
    */
   gitignore?: boolean
   /**
-   * Whether to generate disabled shorthand properties
+   * Whether to allow shorthand properties
    * @default 'true'
    */
   shorthands?: boolean

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export type { ConfigResultWithHooks, PandaHooks, PandaHookable } from './hooks'
 export type { ParserResultType, ResultItem } from './parser'
 export type { Part, Parts } from './parts'
 export type { PatternConfig, PatternHelpers, PatternProperty } from './pattern'
-export type { RecipeConfig, RecipeVariantRecord } from './recipe'
+export type { RecipeConfig, RecipeVariantRecord, SlotRecipeConfig, SlotRecipeVariantRecord } from './recipe'
 export type { Runtime } from './runtime'
 export type { AnyFunction, Artifact, Dict, RequiredBy } from './shared'
 export type { StaticCssOptions } from './static-css'

package/dist/parser.d.ts

@@ -3,7 +3,7 @@ import type { BoxNodeMap, BoxNodeLiteral, Unboxed } from '@pandacss/extractor'
 export type ResultItem = {
   name?: string
   data: Array<Unboxed['raw']>
-  type?: 'object' | 'cva' | 'pattern' | 'recipe' | 'jsx-factory' | 'jsx-pattern' | 'jsx-recipe' | 'jsx'
+  type?: 'object' | 'cva' | 'sva' | 'pattern' | 'recipe' | 'jsx-factory' | 'jsx-pattern' | 'jsx-recipe' | 'jsx'
   box: BoxNodeMap | BoxNodeLiteral
 }
 
@@ -11,10 +11,12 @@ export type ParserResultType = {
   jsx: Set<ResultItem>
   css: Set<ResultItem>
   cva: Set<ResultItem>
+  sva: Set<ResultItem>
   recipe: Map<string, Set<ResultItem>>
   pattern: Map<string, Set<ResultItem>>
   filePath: string | undefined
   set: (name: 'cva' | 'css', result: ResultItem) => void
+  setSva: (result: ResultItem) => void
   setCva: (result: ResultItem) => void
   setJsx: (result: ResultItem) => void
   setRecipe: (name: string, result: ResultItem) => void
@@ -23,6 +25,7 @@ export type ParserResultType = {
   setFilePath: (filePath: string) => ParserResultType
   toArray: () => Array<ResultItem>
   toJSON: () => {
+    sva: Array<ResultItem>
     css: Array<ResultItem>
     cva: Array<ResultItem>
     recipe: Record<string, ResultItem[]>

package/dist/pattern.d.ts

@@ -39,7 +39,14 @@ export type PatternConfig<T extends PatternProperties = PatternProperties> = {
   /**
    * The jsx element name this pattern will generate.
    */
-  jsx?: string
+  jsxName?: string
+  /**
+   * The jsx elements to track for this pattern. Can be string or Regexp.
+   *
+   * @default capitalize(pattern.name)
+   * @example ['Button', 'Link', /Button$/]
+   */
+  jsx?: Array<string | RegExp>
   /**
    * Whether to only generate types for the specified properties.
    * This will disallow css properties

package/dist/recipe.d.ts

@@ -1,6 +1,6 @@
 import type { SystemStyleObject } from './system-types'
 
-type Pretty<T> = T extends infer U ? { [K in keyof U]: U[K] } : never
+type Pretty<T> = { [K in keyof T]: T[K] } & {}
 
 type StringToBoolean<T> = T extends 'true' | 'false' ? boolean : T
 
@@ -14,12 +14,18 @@ export type RecipeSelection<T extends RecipeVariantRecord> = keyof any extends k
 
 export type RecipeVariantFn<T extends RecipeVariantRecord> = (props?: RecipeSelection<T>) => string
 
-export type RecipeVariantProps<T extends RecipeVariantFn<RecipeVariantRecord>> = Pretty<Parameters<T>[0]>
+export type RecipeVariantProps<
+  T extends RecipeVariantFn<RecipeVariantRecord> | SlotRecipeVariantFn<string, SlotRecipeVariantRecord<string>>,
+> = Pretty<Parameters<T>[0]>
 
 type RecipeVariantMap<T extends RecipeVariantRecord> = {
   [K in keyof T]: Array<keyof T[K]>
 }
 
+/* -----------------------------------------------------------------------------
+ * Recipe / Standard
+ * -----------------------------------------------------------------------------*/
+
 export type RecipeRuntimeFn<T extends RecipeVariantRecord> = RecipeVariantFn<T> & {
   __type: RecipeSelection<T>
   variantKeys: (keyof T)[]
@@ -58,11 +64,11 @@ export type RecipeDefinition<T extends RecipeVariantRecord> = {
 
 export type RecipeCreatorFn = <T extends RecipeVariantRecord>(config: RecipeDefinition<T>) => RecipeRuntimeFn<T>
 
-export type RecipeConfig<T extends RecipeVariantRecord = RecipeVariantRecord> = RecipeDefinition<T> & {
+type RecipeConfigMeta = {
   /**
    * The name of the recipe.
    */
-  name: string
+  className: string
   /**
    * The description of the recipe. This will be used in the JSDoc comment.
    */
@@ -75,3 +81,59 @@ export type RecipeConfig<T extends RecipeVariantRecord = RecipeVariantRecord> =
    */
   jsx?: Array<string | RegExp>
 }
+
+export type RecipeConfig<T extends RecipeVariantRecord = RecipeVariantRecord> = RecipeDefinition<T> & RecipeConfigMeta
+
+/* -----------------------------------------------------------------------------
+ * Recipe / Slot
+ * -----------------------------------------------------------------------------*/
+
+type SlotRecord<S extends string, T> = Partial<Record<S, T>>
+
+export type SlotRecipeVariantRecord<S extends string> = Record<any, Record<any, SlotRecord<S, SystemStyleObject>>>
+
+export type SlotRecipeVariantFn<S extends string, T extends RecipeVariantRecord> = (
+  props?: RecipeSelection<T>,
+) => SlotRecord<S, string>
+
+export type SlotRecipeRuntimeFn<S extends string, T extends SlotRecipeVariantRecord<S>> = SlotRecipeVariantFn<S, T> & {
+  variantKeys: (keyof T)[]
+  variantMap: RecipeVariantMap<T>
+  splitVariantProps<Props extends RecipeSelection<T>>(props: Props): [RecipeSelection<T>, Pretty<Omit<Props, keyof T>>]
+}
+
+export type SlotRecipeCompoundVariant<S extends string, T extends RecipeVariantRecord> = RecipeCompoundSelection<T> & {
+  css: SlotRecord<S, SystemStyleObject>
+}
+
+export type SlotRecipeDefinition<S extends string, T extends SlotRecipeVariantRecord<S>> = {
+  /**
+   * The parts/slots of the recipe.
+   */
+  slots: S[] | Readonly<S[]>
+  /**
+   * The base styles of the recipe.
+   */
+  base?: SlotRecord<S, SystemStyleObject>
+  /**
+   * The multi-variant styles of the recipe.
+   */
+  variants?: T | SlotRecipeVariantRecord<S>
+  /**
+   * The default variants of the recipe.
+   */
+  defaultVariants?: RecipeSelection<T>
+  /**
+   * The styles to apply when a combination of variants is selected.
+   */
+  compoundVariants?: Array<SlotRecipeCompoundVariant<S, T>>
+}
+
+export type SlotRecipeCreatorFn = <S extends string, T extends SlotRecipeVariantRecord<S>>(
+  config: SlotRecipeDefinition<S, T>,
+) => SlotRecipeRuntimeFn<S, T>
+
+export type SlotRecipeConfig<
+  S extends string = string,
+  T extends SlotRecipeVariantRecord<S> = SlotRecipeVariantRecord<S>,
+> = SlotRecipeDefinition<S, T> & RecipeConfigMeta

package/dist/system-types.d.ts

@@ -50,11 +50,10 @@ export type CompositionStyleObject<Property extends string> = Nested<{
 /* -----------------------------------------------------------------------------
  * Jsx style props
  * -----------------------------------------------------------------------------*/
+type WithCss = { css?: SystemStyleObject }
+type StyleProps = SystemProperties & MinimalNested<SystemStyleObject>
 
-export type JsxStyleProps = SystemProperties &
-  MinimalNested<SystemStyleObject> & {
-    css?: SystemStyleObject
-  }
+export type JsxStyleProps = StyleProps & WithCss
 
 export type Assign<T, U> = Omit<T, keyof U> & U
 

package/dist/theme.d.ts

@@ -1,5 +1,5 @@
 import type { LayerStyles, TextStyles } from './composition'
-import type { RecipeConfig } from './recipe'
+import type { RecipeConfig, SlotRecipeConfig } from './recipe'
 import type { CssKeyframes } from './system-types'
 import type { SemanticTokens, Tokens } from './tokens'
 
@@ -33,4 +33,8 @@ export type Theme = {
    * Useful for defining component styles.
    */
   recipes?: Record<string, RecipeConfig>
+  /**
+   * Multi-variant style definitions for component slots.
+   */
+  slotRecipes?: Record<string, SlotRecipeConfig>
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pandacss/types",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "The types for css panda",
   "main": "dist/index.d.ts",
   "author": "Segun Adebayo <joseshegs@gmail.com>",
@@ -15,9 +15,10 @@
     "chokidar-cli": "^3.0.0",
     "csstype": "3.1.2",
     "hookable": "5.5.3",
+    "ncp": "^2.0.0",
     "pkg-types": "1.0.3",
-    "@pandacss/extractor": "0.8.0",
-    "@pandacss/token-dictionary": "0.8.0"
+    "@pandacss/extractor": "0.10.0",
+    "@pandacss/token-dictionary": "0.10.0"
   },
   "scripts": {
     "build": "tsx scripts/build.ts",