@pandacss/types 0.30.2 → 0.32.0

package/dist/config.d.ts

@@ -184,13 +184,13 @@ interface FileSystemOptions {
   logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'silent'
 }
 
-type JsxFramework = 'react' | 'solid' | 'preact' | 'vue' | 'qwik'
+export type JsxFramework = 'react' | 'solid' | 'preact' | 'vue' | 'qwik'
 
 interface JsxOptions {
   /**
    * The framework to use for generating supercharged elements.
    */
-  jsxFramework?: JsxFramework
+  jsxFramework?: JsxFramework | (string & {})
   /**
    * The factory name of the element
    * @default 'styled'
@@ -273,6 +273,17 @@ interface CssgenOptions {
    * @see https://www.npmjs.com/package/browserslist
    */
   browserslist?: string[]
+  /**
+   * Layer mappings used in the generated css.
+   * @default 'true'
+   */
+  layers?: Partial<CascadeLayers>
+  /**
+   * Polyfill CSS @layers at-rules for older browsers.
+   * @default 'false'
+   * @see https://www.npmjs.com/package/@csstools/postcss-cascade-layers
+   */
+  polyfill?: boolean
 }
 
 interface CodegenOptions {
@@ -310,11 +321,6 @@ interface CodegenOptions {
    * @default 'true'
    */
   shorthands?: boolean
-  /**
-   * Layer mappings used in the generated css.
-   * @default 'true'
-   */
-  layers?: Partial<CascadeLayers>
   /**
    * File extension for generated javascript files.
    * @default 'mjs'
@@ -335,10 +341,18 @@ interface PresetOptions {
   presets?: (string | Preset | Promise<Preset>)[]
 }
 
-interface HooksOptions {
+export interface HooksOptions {
   hooks?: Partial<PandaHooks>
 }
 
+export interface PandaPlugin extends HooksOptions {
+  name: string
+}
+
+export interface PluginsOptions {
+  plugins?: PandaPlugin[]
+}
+
 export interface Config
   extends StudioOptions,
     ExtendableOptions,
@@ -347,7 +361,8 @@ export interface Config
     FileSystemOptions,
     JsxOptions,
     PresetOptions,
-    HooksOptions {
+    HooksOptions,
+    PluginsOptions {
   /**
    * Whether to opt-out of the defaults config presets: [`@pandacss/preset-base`, `@pandacss/preset-panda`]
    * @default 'false'

package/dist/hooks.d.ts

@@ -41,7 +41,14 @@ export interface PandaHooks {
    * Called right before writing the codegen files to disk.
    * You can use this hook to tweak the codegen files before they are written to disk.
    */
-  'codegen:prepare': (args: CodegenPrepareHookArgs) => MaybeAsyncReturn
+  'codegen:prepare': (args: {
+    artifacts: Artifact[]
+    /**
+     * The original state of the artifacts, as it was generated by Panda, without any modification from other preset hooks
+     */
+    original?: Artifact[]
+    changed: ArtifactId[] | undefined
+  }) => MaybeAsyncReturn<Artifact[]>
   /**
    * Called after the codegen is completed
    */
@@ -173,7 +180,14 @@ type CssgenArtifact = 'global' | 'static' | 'reset' | 'tokens' | 'keyframes' | '
 
 export interface CssgenDoneHookArgs {
   artifact: CssgenArtifact
+  /**
+   * The current state of the CSS, if any other preset hook has modified the CSS, this will be the modified state
+   */
   content: string
+  /**
+   * The original state of the CSS, as it was generated by Panda, without any modification from other preset hooks
+   */
+  original?: string
 }
 
 /* -----------------------------------------------------------------------------

package/dist/recipe.d.ts

@@ -13,10 +13,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]>
 }
@@ -63,10 +74,6 @@ 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>
@@ -87,6 +94,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>
@@ -141,10 +152,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pandacss/types",
-  "version": "0.30.2",
+  "version": "0.32.0",
   "description": "The types for css panda",
   "main": "dist/index.d.ts",
   "author": "Segun Adebayo <joseshegs@gmail.com>",
@@ -27,10 +27,10 @@
   ],
   "devDependencies": {
     "csstype": "3.1.3",
-    "microdiff": "^1.3.2",
-    "ncp": "^2.0.0",
+    "microdiff": "1.3.2",
+    "ncp": "2.0.0",
     "pkg-types": "1.0.3",
-    "@pandacss/extractor": "0.30.2"
+    "@pandacss/extractor": "0.32.0"
   },
   "scripts": {
     "dev": "tsx scripts/watch.ts",