@pandacss/types 2.0.0-beta.1 → 2.0.0-beta.10

package/dist/config.d.ts

@@ -16,9 +16,10 @@ import type { ExtendableUtilityConfig, UtilityConfig } from './utility'
 
 export type { TSConfig }
 
-export type CascadeLayer = 'reset' | 'base' | 'tokens' | 'recipes' | 'utilities'
+/** The five cascade layers, in emit order. */
+export type StylesheetLayerName = 'reset' | 'base' | 'tokens' | 'recipes' | 'utilities'
 
-export type CascadeLayers = Record<CascadeLayer, string>
+export type StylesheetLayers = Record<StylesheetLayerName, string>
 
 export interface Patterns {
   [pattern: string]: PatternConfig
@@ -198,7 +199,7 @@ export interface ImportMapOutput<T = string> {
   tokens: T[]
 }
 
-type ImportMapOption = string | ImportMapInput
+export type ImportMapOption = string | ImportMapInput
 
 interface FileSystemOptions {
   /**
@@ -215,10 +216,12 @@ interface FileSystemOptions {
    *    recipes: 'styled-system/recipes',
    *    patterns: 'styled-system/patterns',
    *    jsx: 'styled-system/jsx',
+   *    tokens: 'styled-system/tokens',
    * }
    * ```
    */
   importMap?: ImportMapOption | Array<ImportMapOption>
+  designSystem?: string
   /**
    * List of files glob to watch for changes.
    * @default []
@@ -321,7 +324,17 @@ interface CssgenOptions {
    * Layer mappings used in the generated css.
    * @default 'true'
    */
-  layers?: Partial<CascadeLayers>
+  layers?: Partial<StylesheetLayers>
+  /**
+   * Whether to minify the emitted css. The `--minify` CLI flag overrides this.
+   * @default false
+   */
+  minify?: boolean
+  /**
+   * Polyfill cascade layers for older browsers. `--polyfill` overrides this.
+   * @default false
+   */
+  polyfill?: boolean
 }
 
 export interface OptimizeOptions {
@@ -337,6 +350,11 @@ export interface OptimizeOptions {
    * Narrow compound variant CSS to statically selected variant combinations.
    */
   smartCompoundVariants?: boolean
+  /**
+   * Hydrate only build-info modules for design-system exports the app imports.
+   * Off by default. Namespace / side-effect imports still hydrate everything.
+   */
+  treeshakeDesignSystem?: boolean
 }
 
 interface CodegenOptions {

package/dist/hooks.d.ts

@@ -62,19 +62,21 @@ export interface ConfigResolvedHookArgs {
   utils: ConfigResolvedHookUtils
 }
 
-export interface CodegenFile {
+/** Hook-facing codegen file — `dependencies` stay plain strings for plugin authors. */
+export interface CodegenPrepareFile {
   path: string
   code: string
   dependencies: string[]
 }
 
-export interface CodegenArtifact {
+/** Hook-facing codegen artifact — distinct from the compiler `CodegenArtifact` API. */
+export interface CodegenPrepareArtifact {
   id: string
-  files: CodegenFile[]
+  files: CodegenPrepareFile[]
 }
 
 export interface CodegenPrepareHookArgs {
-  artifacts: CodegenArtifact[]
+  artifacts: CodegenPrepareArtifact[]
   outdir: string
   cwd?: string | undefined
 }
@@ -85,6 +87,43 @@ export interface CodegenDoneHookArgs {
   cwd?: string | undefined
 }
 
+export type CssgenArtifact = 'styles.css' | 'styles.layer' | 'styles.split'
+
+export interface CssgenDoneManifestFile {
+  path: string
+  hash: string
+}
+
+export interface CssgenDoneManifest {
+  files: CssgenDoneManifestFile[]
+  tokens: string[]
+}
+
+export interface CssgenDoneLayerRange {
+  start: number
+  end: number
+}
+
+export interface CssgenDoneLayerRanges {
+  reset?: CssgenDoneLayerRange
+  base?: CssgenDoneLayerRange
+  tokens?: CssgenDoneLayerRange
+  recipes?: CssgenDoneLayerRange
+  utilities?: CssgenDoneLayerRange
+}
+
+export interface CssgenDoneHookArgs {
+  artifact: CssgenArtifact
+  content: string
+  /** Absolute path when written to disk; omitted for string sinks (Vite/PostCSS). */
+  path?: string | undefined
+  outfile?: string | undefined
+  outdir?: string | undefined
+  cwd?: string | undefined
+  manifest?: CssgenDoneManifest | undefined
+  layerRanges?: CssgenDoneLayerRanges | undefined
+}
+
 export interface PandaHooks {
   /**
    * Called after authored presets are merged, before defaults and serialization.
@@ -102,11 +141,16 @@ export interface PandaHooks {
   /**
    * Called before generated files are written by a JS host.
    */
-  'codegen:prepare': (args: CodegenPrepareHookArgs) => void | CodegenArtifact[]
+  'codegen:prepare': (args: CodegenPrepareHookArgs) => void | CodegenPrepareArtifact[]
   /**
    * Called after generated files are written by a JS host.
    */
   'codegen:done': (args: CodegenDoneHookArgs) => void
+  /**
+   * Called after final CSS is produced by a JS host (observe-only; no rewrite).
+   * Fires for CLI, Vite, and PostCSS string sinks. Use `optimize` or PostCSS to mutate CSS.
+   */
+  'cssgen:done': (args: CssgenDoneHookArgs) => void
 }
 
 export type HookRegistry = {

package/dist/index.d.ts

@@ -1,18 +1,12 @@
-export type * from './artifact'
 export type * from './composition'
 export type * from './conditions'
 export type * from './config'
 export type * from './hooks'
-export type * from './hooks-api'
-export type * from './logger'
 export type * from './parts'
 export type * from './pattern'
 export type * from './recipe'
-export type * from './runtime'
 export type * from './shared'
-export type * from './spec'
 export type * from './static-css'
-export type * from './style-rules'
 export type * from './system-types'
 export type * from './theme'
 export type * from './tokens'

package/dist/pattern.d.ts

@@ -11,7 +11,7 @@ export type PatternProperty =
   | { type: 'string' | 'boolean' | 'number'; description?: string }
 
 export interface PatternHelpers {
-  map: (value: any, fn: (value: string) => string | undefined) => any
+  map: (value: any, fn: (value: any) => any) => any
   isCssUnit: (value: any) => boolean
   isCssVar: (value: any) => boolean
   isCssFunction: (value: any) => boolean

package/dist/system-types.d.ts

@@ -89,6 +89,15 @@ export type NestedCssProperties = Nested<CssProperties>
 
 export type SystemStyleObject = Nested<(SystemProperties | GenericProperties) & CssVarProperties>
 
+export interface ViewTransitionStyleObject {
+  group?: SystemStyleObject
+  imagePair?: SystemStyleObject
+  old?: SystemStyleObject
+  new?: SystemStyleObject
+}
+
+export type ViewTransitionFn = (options: ViewTransitionStyleObject) => string
+
 export interface GlobalStyleObject {
   [selector: string]: SystemStyleObject
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pandacss/types",
-  "version": "2.0.0-beta.1",
+  "version": "2.0.0-beta.10",
   "description": "The types for css panda",
   "main": "dist/index.d.ts",
   "author": "Segun Adebayo <joseshegs@gmail.com>",
@@ -28,10 +28,11 @@
   ],
   "devDependencies": {
     "csstype": "3.2.3",
-    "microdiff": "1.5.0",
     "ncp": "2.0.0",
-    "pkg-types": "2.3.0",
-    "ts-morph": "28.0.0"
+    "pkg-types": "2.3.0"
+  },
+  "engines": {
+    "node": ">=22"
   },
   "scripts": {
     "dev": "tsx scripts/watch.ts",

package/dist/artifact.d.ts

@@ -1,65 +0,0 @@
-import { type Difference } from 'microdiff'
-
-export interface ArtifactContent {
-  file: string
-  code: string | undefined
-}
-
-export type ArtifactId =
-  | 'helpers'
-  | 'keyframes'
-  | 'design-tokens'
-  | 'types'
-  | 'css-fn'
-  | 'cva'
-  | 'sva'
-  | 'cx'
-  | 'create-recipe'
-  | 'recipes'
-  | 'recipes-index'
-  | 'patterns'
-  | 'patterns-index'
-  | 'jsx-is-valid-prop'
-  | 'jsx-helpers'
-  | 'jsx-factory'
-  | 'jsx-patterns'
-  | 'jsx-create-style-context'
-  | 'jsx-patterns-index'
-  | 'css-index'
-  | 'themes'
-  | 'package.json'
-  | 'types-jsx'
-  | 'types-entry'
-  | 'types-styles'
-  | 'types-conditions'
-  | 'types-gen'
-  | 'types-gen-system'
-  | 'static-css'
-  | 'styles.css'
-  | 'styles'
-  | `recipes.${string}`
-  | `patterns.${string}`
-
-export type CssArtifactType = 'preflight' | 'tokens' | 'static' | 'global' | 'keyframes'
-
-export type Artifact = {
-  id: ArtifactId
-  dir?: string[]
-  files: ArtifactContent[]
-}
-
-export interface AffectedArtifacts {
-  recipes: string[]
-  patterns: string[]
-}
-
-export interface ArtifactFilters {
-  ids?: ArtifactId[]
-  affecteds?: AffectedArtifacts
-}
-
-export interface DiffConfigResult {
-  hasConfigChanged: boolean
-  artifacts: Set<ArtifactId>
-  diffs: Difference[]
-}

package/dist/hooks-api.d.ts

@@ -1,56 +0,0 @@
-import type { UserConfig } from './config'
-import type { RecipeDefinition, RecipeVariantRecord, SlotRecipeDefinition, SlotRecipeVariantRecord } from './recipe'
-import type { AtomicStyleResult, RecipeBaseResult } from './style-rules'
-import type { SystemStyleObject } from './system-types'
-
-export interface BaseRule {
-  getClassNames: () => string[]
-  toCss: () => string
-}
-
-export interface AtomicRule extends BaseRule {
-  styles: SystemStyleObject
-}
-
-export interface AtomicRecipeRule extends BaseRule {
-  config: RecipeDefinition<any> | SlotRecipeDefinition<string, any>
-}
-
-export interface RecipeVariantsRule extends BaseRule {
-  variants: RecipeVariantRecord
-}
-
-export interface ProcessorInterface {
-  css(styles: SystemStyleObject): AtomicRule
-  cva(recipeConfig: RecipeDefinition<RecipeVariantRecord>): AtomicRecipeRule
-  sva(recipeConfig: SlotRecipeDefinition<string, SlotRecipeVariantRecord<string>>): AtomicRecipeRule
-  recipe(name: string, variants?: RecipeVariantRecord): RecipeVariantsRule | undefined
-}
-
-export interface HooksApiInterface {
-  /**
-   * The resolved config (after all the presets are loaded and merged)
-   */
-  config: UserConfig
-  /**
-   * The path to the config file
-   */
-  configPath: string
-  /**
-   * The list of all the config dependencies (direct/transitive imports) filepaths
-   */
-  configDependencies: string[]
-  //
-  /**
-   * The processor can be used to generate atomic or recipe classes
-   */
-  processor: ProcessorInterface
-  /**
-   * Map that contains all the utility classNames
-   */
-  classNames: Map<string, string>
-  /**
-   * Map that contains all the classNames found (and therefore generated) in the app code
-   */
-  generatedClassNames: Map<string, AtomicStyleResult | RecipeBaseResult>
-}

package/dist/logger.d.ts

@@ -1,28 +0,0 @@
-export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent'
-
-export interface LogEntry {
-  level: LogLevel | null
-  msg: string
-  [key: string]: any
-}
-
-export interface LoggerInterface {
-  level: 'debug' | 'info' | 'warn' | 'error' | 'silent'
-  print(data: any): void
-  onLog?: (entry: LogEntry) => void
-  warn: (type: string, data: any) => void
-  info: (type: string, data: any) => void
-  debug: (type: string, data: any) => void
-  error: (type: string, data: any) => void
-  /**
-   * Log a caught error with context. Extracts the message for the error level,
-   * and logs the full stack at debug level.
-   */
-  caughtError: (type: string, context: string, error: unknown) => void
-  log: (data: string) => void
-  time: {
-    info: (msg: string) => (_msg?: string) => void
-    debug: (msg: string) => (_msg?: string) => void
-  }
-  isDebug: boolean
-}

package/dist/runtime.d.ts

@@ -1,48 +0,0 @@
-interface Watcher {
-  on(event: 'add' | 'addDir' | 'change', listener: (path: string) => void): this
-  on(event: 'all', listener: (evt: 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir', path: string) => void): this
-  close(): Promise<void>
-}
-
-interface InputOptions {
-  include: string[]
-  exclude?: string[]
-  cwd?: string
-}
-
-export type WatcherEventType = 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir'
-
-export interface WatchOptions extends InputOptions {
-  poll?: boolean
-}
-
-interface FileSystem {
-  readDirSync(dir: string): string[]
-  existsSync(fileLike: string): boolean
-  glob(opts: InputOptions): string[]
-  readFileSync(filePath: string): string
-  rmDirSync(dirPath: string): void
-  writeFile(file: string, content: string): Promise<void>
-  rmFileSync(file: string): void
-  ensureDirSync(dirPath: string): void
-  writeFileSync(filePath: string, content: string): void
-  watch(options: WatchOptions): Watcher
-}
-
-interface Path {
-  join(...paths: string[]): string
-  dirname(path: string): string
-  resolve(...paths: string[]): string
-  extname(path: string): string
-  relative(from: string, to: string): string
-  isAbsolute(path: string): boolean
-  sep: string
-  abs(cwd: string, path: string): string
-}
-
-export interface Runtime {
-  fs: FileSystem
-  path: Path
-  cwd(): string
-  env(name: string): string | undefined
-}

package/dist/spec.d.ts

@@ -1,197 +0,0 @@
-export type SpecType =
-  | 'tokens'
-  | 'recipes'
-  | 'patterns'
-  | 'conditions'
-  | 'keyframes'
-  | 'semantic-tokens'
-  | 'text-styles'
-  | 'layer-styles'
-  | 'animation-styles'
-  | 'color-palette'
-  | 'themes'
-
-interface Examples {
-  functionExamples: string[]
-  jsxExamples: string[]
-}
-
-export interface TokenValue {
-  name: string
-  value: any
-  description?: string
-  deprecated?: boolean | string
-  cssVar?: string
-}
-
-export interface TokenGroupDefinition extends Examples {
-  type: string
-  values: TokenValue[]
-  tokenFunctionExamples: string[]
-}
-
-export interface TokenSpec {
-  type: 'tokens'
-  data: TokenGroupDefinition[]
-}
-
-export interface SemanticTokenValue {
-  name: string
-  values: Array<{ value: string; condition?: string }>
-  description?: string
-  deprecated?: boolean | string
-  cssVar?: string
-}
-
-export interface SemanticTokenGroupDefinition extends Examples {
-  type: string
-  values: SemanticTokenValue[]
-  tokenFunctionExamples: string[]
-}
-
-export interface SemanticTokenSpec {
-  type: 'semantic-tokens'
-  data: SemanticTokenGroupDefinition[]
-}
-
-export interface RecipeSpecDefinition extends Examples {
-  name: string
-  description?: string
-  variants: Record<string, string[]>
-  defaultVariants: Record<string, any>
-}
-
-export interface RecipeSpec {
-  type: 'recipes'
-  data: RecipeSpecDefinition[]
-}
-
-export interface PatternSpecProperty {
-  name: string
-  type: string
-  description?: string
-  required?: boolean
-  defaultValue?: any
-}
-
-export interface PatternSpecDefinition extends Examples {
-  name: string
-  description?: string
-  properties: PatternSpecProperty[]
-  jsx?: string
-}
-
-export interface PatternSpec {
-  type: 'patterns'
-  data: PatternSpecDefinition[]
-}
-
-export interface ConditionSpecDefinition extends Examples {
-  name: string
-  value: string
-}
-
-export interface ConditionSpec {
-  type: 'conditions'
-  data: ConditionSpecDefinition[]
-}
-
-export interface KeyframeSpecDefinition extends Examples {
-  name: string
-}
-
-export interface KeyframeSpec {
-  type: 'keyframes'
-  data: KeyframeSpecDefinition[]
-}
-
-export interface TextStyleSpecDefinition extends Examples {
-  name: string
-  description?: string
-}
-
-export interface TextStyleSpec {
-  type: 'text-styles'
-  data: TextStyleSpecDefinition[]
-}
-
-export interface LayerStyleSpecDefinition extends Examples {
-  name: string
-  description?: string
-}
-
-export interface LayerStyleSpec {
-  type: 'layer-styles'
-  data: LayerStyleSpecDefinition[]
-}
-
-export interface AnimationStyleSpecDefinition extends Examples {
-  name: string
-  description?: string
-}
-
-export interface AnimationStyleSpec {
-  type: 'animation-styles'
-  data: AnimationStyleSpecDefinition[]
-}
-
-export interface ColorPaletteSpec {
-  type: 'color-palette'
-  data: {
-    values: string[]
-    functionExamples: string[]
-    jsxExamples: string[]
-  }
-}
-
-export interface ThemeTokenValue {
-  name: string
-  values: Array<{ value: string; condition?: string }>
-  description?: string
-  deprecated?: boolean | string
-  cssVar?: string
-}
-
-export interface ThemeTokenGroupDefinition extends Examples {
-  type: string
-  values: ThemeTokenValue[]
-  tokenFunctionExamples: string[]
-}
-
-export interface ThemeSpecDefinition {
-  name: string
-  tokens: ThemeTokenGroupDefinition[]
-  semanticTokens: ThemeTokenGroupDefinition[]
-}
-
-export interface ThemesSpec {
-  type: 'themes'
-  data: ThemeSpecDefinition[]
-}
-
-export type SpecFile =
-  | TokenSpec
-  | SemanticTokenSpec
-  | RecipeSpec
-  | PatternSpec
-  | ConditionSpec
-  | KeyframeSpec
-  | TextStyleSpec
-  | LayerStyleSpec
-  | AnimationStyleSpec
-  | ColorPaletteSpec
-  | ThemesSpec
-
-export interface SpecTypeMap {
-  tokens: TokenSpec
-  'semantic-tokens': SemanticTokenSpec
-  recipes: RecipeSpec
-  patterns: PatternSpec
-  conditions: ConditionSpec
-  keyframes: KeyframeSpec
-  'text-styles': TextStyleSpec
-  'layer-styles': LayerStyleSpec
-  'animation-styles': AnimationStyleSpec
-  'color-palette': ColorPaletteSpec
-  themes: ThemesSpec
-}

package/dist/style-rules.d.ts

@@ -1,41 +0,0 @@
-import type { ConditionDetails } from './conditions'
-
-export interface StyleResultObject {
-  [key: string]: any
-}
-export interface StyleProps extends StyleResultObject {
-  css?: StyleResultObject
-}
-
-export interface StyleEntry {
-  prop: string
-  value: string | number | boolean
-  cond: string
-  recipe?: string
-  slot?: string
-  layer?: string
-  variants?: boolean
-}
-
-export interface AtomicStyleResult {
-  result: StyleResultObject
-  entry: StyleEntry
-  hash: string
-  className: string
-  conditions?: ConditionDetails[]
-  layer?: string
-}
-
-export interface GroupedResult extends Pick<AtomicStyleResult, 'result' | 'className'> {
-  hashSet: Set<string>
-  details: GroupedStyleResultDetails[]
-}
-
-export interface RecipeBaseResult extends GroupedResult {
-  recipe: string
-  slot?: string
-}
-
-export interface GroupedStyleResultDetails extends Pick<AtomicStyleResult, 'hash' | 'entry' | 'conditions'> {
-  result: StyleResultObject
-}