@pandacss/config 0.28.0 → 0.29.0

package/dist/{chunk-TP2SOWHU.mjs → chunk-5YOGLJPA.mjs}

@@ -27,11 +27,37 @@ function createMatcher(id, patterns) {
 }
 
 // src/config-deps.ts
-var all = ["outdir", "forceConsistentTypeExtension", "outExtension"];
-var format = ["syntax", "hash", "prefix", "separator"];
-var tokens = ["utilities", "conditions", "theme.tokens", "theme.semanticTokens", "theme.breakpoints"];
+var all = [
+  "clean",
+  "cwd",
+  "eject",
+  "outdir",
+  "forceConsistentTypeExtension",
+  "outExtension",
+  "emitPackage",
+  "emitTokensOnly",
+  "presets",
+  "hooks"
+];
+var format = [
+  "syntax",
+  "hash",
+  "prefix",
+  "separator",
+  "strictTokens",
+  "strictPropertyValues",
+  "shorthands"
+];
+var tokens = [
+  "utilities",
+  "conditions",
+  "theme.tokens",
+  "theme.semanticTokens",
+  "theme.breakpoints",
+  "theme.containerNames",
+  "theme.containerSizes"
+];
 var jsx = ["jsxFramework", "jsxFactory", "jsxStyleProps", "syntax"];
-var css = ["layers", "optimize", "minify"];
 var common = tokens.concat(jsx, format);
 var artifactConfigDeps = {
   helpers: ["syntax", "jsxFramework"],
@@ -53,11 +79,7 @@ var artifactConfigDeps = {
   "jsx-patterns": jsx.concat("patterns"),
   "jsx-patterns-index": jsx.concat("patterns"),
   "css-index": ["syntax"],
-  "reset.css": ["preflight", "layers"],
-  "global.css": ["globalCss"].concat(css),
-  "static.css": ["staticCss", "theme.breakpoints"].concat(css),
-  "styles.css": tokens.concat(format),
-  "package.json": ["emitPackage"]
+  "package.json": ["emitPackage", "forceConsistentTypeExtension", "outExtension"]
 };
 var artifactMatchers = Object.entries(artifactConfigDeps).map(([key, paths]) => {
   if (!paths.length)

package/dist/diff-config.d.mts

@@ -1,8 +1,6 @@
 import { Config, DiffConfigResult } from '@pandacss/types';
-export { DiffConfigResult } from '@pandacss/types';
 
 type ConfigOrFn = Config | (() => Config);
-
 /**
  * Diff the two config objects and return the list of affected properties
  */

package/dist/diff-config.d.ts

@@ -1,8 +1,6 @@
 import { Config, DiffConfigResult } from '@pandacss/types';
-export { DiffConfigResult } from '@pandacss/types';
 
 type ConfigOrFn = Config | (() => Config);
-
 /**
  * Diff the two config objects and return the list of affected properties
  */

package/dist/diff-config.js

@@ -61,11 +61,37 @@ function createMatcher(id, patterns) {
 }
 
 // src/config-deps.ts
-var all = ["outdir", "forceConsistentTypeExtension", "outExtension"];
-var format = ["syntax", "hash", "prefix", "separator"];
-var tokens = ["utilities", "conditions", "theme.tokens", "theme.semanticTokens", "theme.breakpoints"];
+var all = [
+  "clean",
+  "cwd",
+  "eject",
+  "outdir",
+  "forceConsistentTypeExtension",
+  "outExtension",
+  "emitPackage",
+  "emitTokensOnly",
+  "presets",
+  "hooks"
+];
+var format = [
+  "syntax",
+  "hash",
+  "prefix",
+  "separator",
+  "strictTokens",
+  "strictPropertyValues",
+  "shorthands"
+];
+var tokens = [
+  "utilities",
+  "conditions",
+  "theme.tokens",
+  "theme.semanticTokens",
+  "theme.breakpoints",
+  "theme.containerNames",
+  "theme.containerSizes"
+];
 var jsx = ["jsxFramework", "jsxFactory", "jsxStyleProps", "syntax"];
-var css = ["layers", "optimize", "minify"];
 var common = tokens.concat(jsx, format);
 var artifactConfigDeps = {
   helpers: ["syntax", "jsxFramework"],
@@ -87,11 +113,7 @@ var artifactConfigDeps = {
   "jsx-patterns": jsx.concat("patterns"),
   "jsx-patterns-index": jsx.concat("patterns"),
   "css-index": ["syntax"],
-  "reset.css": ["preflight", "layers"],
-  "global.css": ["globalCss"].concat(css),
-  "static.css": ["staticCss", "theme.breakpoints"].concat(css),
-  "styles.css": tokens.concat(format),
-  "package.json": ["emitPackage"]
+  "package.json": ["emitPackage", "forceConsistentTypeExtension", "outExtension"]
 };
 var artifactMatchers = Object.entries(artifactConfigDeps).map(([key, paths]) => {
   if (!paths.length)

package/dist/diff-config.mjs

@@ -1,6 +1,6 @@
 import {
   diffConfigs
-} from "./chunk-TP2SOWHU.mjs";
+} from "./chunk-5YOGLJPA.mjs";
 export {
   diffConfigs
 };

package/dist/index.d.mts

@@ -1,6 +1,5 @@
 import * as _pandacss_types from '@pandacss/types';
 import { Config, ConfigTsOptions } from '@pandacss/types';
-export { DiffConfigResult } from '@pandacss/types';
 export { diffConfigs } from './diff-config.mjs';
 import { P as PathMapping } from './ts-config-paths-2lh9mwzL.mjs';
 export { c as convertTsPathsToRegexes } from './ts-config-paths-2lh9mwzL.mjs';
@@ -11,15 +10,15 @@ interface ConfigFileOptions {
     cwd: string;
     file?: string;
 }
-
 interface BundleConfigResult<T = Config> {
     config: T;
     dependencies: string[];
     path: string;
 }
+
 declare function bundleConfig(options: ConfigFileOptions): Promise<BundleConfigResult>;
 
-declare function findConfig({ cwd, file }: Partial<ConfigFileOptions>): string | undefined;
+declare function findConfig(options: Partial<ConfigFileOptions>): string;
 
 interface GetDepsOptions {
     filename: string;

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import * as _pandacss_types from '@pandacss/types';
 import { Config, ConfigTsOptions } from '@pandacss/types';
-export { DiffConfigResult } from '@pandacss/types';
 export { diffConfigs } from './diff-config.js';
 import { P as PathMapping } from './ts-config-paths-2lh9mwzL.js';
 export { c as convertTsPathsToRegexes } from './ts-config-paths-2lh9mwzL.js';
@@ -11,15 +10,15 @@ interface ConfigFileOptions {
     cwd: string;
     file?: string;
 }
-
 interface BundleConfigResult<T = Config> {
     config: T;
     dependencies: string[];
     path: string;
 }
+
 declare function bundleConfig(options: ConfigFileOptions): Promise<BundleConfigResult>;
 
-declare function findConfig({ cwd, file }: Partial<ConfigFileOptions>): string | undefined;
+declare function findConfig(options: Partial<ConfigFileOptions>): string;
 
 interface GetDepsOptions {
     filename: string;

package/dist/index.js

@@ -42,47 +42,58 @@ __export(src_exports, {
 module.exports = __toCommonJS(src_exports);
 
 // src/bundle-config.ts
-var import_error = require("@pandacss/error");
 var import_logger = require("@pandacss/logger");
+var import_shared2 = require("@pandacss/shared");
 var import_bundle_n_require = require("bundle-n-require");
 
 // src/find-config.ts
+var import_shared = require("@pandacss/shared");
 var import_sync = __toESM(require("escalade/sync"));
 var import_path = require("path");
+
+// src/is-panda-config.ts
 var configs = [".ts", ".js", ".mts", ".mjs", ".cts", ".cjs"];
 var pandaConfigRegex = new RegExp(`panda.config(${configs.join("|")})$`);
 var isPandaConfig = (file) => pandaConfigRegex.test(file);
-function findConfig({ cwd, file }) {
-  cwd = cwd ?? process.cwd();
-  if (file)
+
+// src/find-config.ts
+function findConfig(options) {
+  const { cwd = process.cwd(), file } = options;
+  if (file) {
     return (0, import_path.resolve)(cwd, file);
-  const result = (0, import_sync.default)(cwd, (_dir, paths) => paths.find(isPandaConfig));
-  return result ?? void 0;
+  }
+  const configPath = (0, import_sync.default)(cwd, (_dir, paths) => paths.find(isPandaConfig));
+  if (!configPath) {
+    throw new import_shared.PandaError(
+      "CONFIG_NOT_FOUND",
+      `Cannot find config file \`panda.config.{ts,js,mjs,mts}\`. Did you forget to run \`panda init\`?`
+    );
+  }
+  return configPath;
 }
 
 // src/bundle-config.ts
 async function bundle(filepath, cwd) {
-  const { mod: config, dependencies } = await (0, import_bundle_n_require.bundleNRequire)(filepath, {
+  const { mod, dependencies } = await (0, import_bundle_n_require.bundleNRequire)(filepath, {
     cwd,
     interopDefault: true
   });
+  const config = mod?.default ?? mod;
   return {
-    config: config?.default ?? config,
+    config,
     dependencies
   };
 }
 async function bundleConfig(options) {
   const { cwd, file } = options;
   const filePath = findConfig({ cwd, file });
-  if (!filePath) {
-    throw new import_error.ConfigNotFoundError();
-  }
   import_logger.logger.debug("config:path", filePath);
   const result = await bundle(filePath, cwd);
   if (typeof result.config !== "object") {
-    throw new import_error.ConfigError(`\u{1F4A5} Config must export or return an object.`);
+    throw new import_shared2.PandaError("CONFIG_ERROR", `\u{1F4A5} Config must export or return an object.`);
   }
   result.config.outdir ??= "styled-system";
+  result.config.validation ??= "error";
   return {
     ...result,
     config: result.config,
@@ -91,7 +102,7 @@ async function bundleConfig(options) {
 }
 
 // src/diff-config.ts
-var import_shared = require("@pandacss/shared");
+var import_shared3 = require("@pandacss/shared");
 var import_microdiff = __toESM(require("microdiff"));
 
 // src/create-matcher.ts
@@ -119,11 +130,37 @@ function createMatcher(id, patterns) {
 }
 
 // src/config-deps.ts
-var all = ["outdir", "forceConsistentTypeExtension", "outExtension"];
-var format = ["syntax", "hash", "prefix", "separator"];
-var tokens = ["utilities", "conditions", "theme.tokens", "theme.semanticTokens", "theme.breakpoints"];
+var all = [
+  "clean",
+  "cwd",
+  "eject",
+  "outdir",
+  "forceConsistentTypeExtension",
+  "outExtension",
+  "emitPackage",
+  "emitTokensOnly",
+  "presets",
+  "hooks"
+];
+var format = [
+  "syntax",
+  "hash",
+  "prefix",
+  "separator",
+  "strictTokens",
+  "strictPropertyValues",
+  "shorthands"
+];
+var tokens = [
+  "utilities",
+  "conditions",
+  "theme.tokens",
+  "theme.semanticTokens",
+  "theme.breakpoints",
+  "theme.containerNames",
+  "theme.containerSizes"
+];
 var jsx = ["jsxFramework", "jsxFactory", "jsxStyleProps", "syntax"];
-var css = ["layers", "optimize", "minify"];
 var common = tokens.concat(jsx, format);
 var artifactConfigDeps = {
   helpers: ["syntax", "jsxFramework"],
@@ -145,11 +182,7 @@ var artifactConfigDeps = {
   "jsx-patterns": jsx.concat("patterns"),
   "jsx-patterns-index": jsx.concat("patterns"),
   "css-index": ["syntax"],
-  "reset.css": ["preflight", "layers"],
-  "global.css": ["globalCss"].concat(css),
-  "static.css": ["staticCss", "theme.breakpoints"].concat(css),
-  "styles.css": tokens.concat(format),
-  "package.json": ["emitPackage"]
+  "package.json": ["emitPackage", "forceConsistentTypeExtension", "outExtension"]
 };
 var artifactMatchers = Object.entries(artifactConfigDeps).map(([key, paths]) => {
   if (!paths.length)
@@ -182,11 +215,11 @@ function diffConfigs(config, prevConfig) {
       if (!id)
         return;
       if (id === "recipes") {
-        const name = (0, import_shared.dashCase)(change.path.slice(1, 3).join("."));
+        const name = (0, import_shared3.dashCase)(change.path.slice(1, 3).join("."));
         affected.artifacts.add(name);
       }
       if (id === "patterns") {
-        const name = (0, import_shared.dashCase)(change.path.slice(0, 2).join("."));
+        const name = (0, import_shared3.dashCase)(change.path.slice(0, 2).join("."));
         affected.artifacts.add(name);
       }
       affected.artifacts.add(id);
@@ -448,7 +481,7 @@ async function getResolvedConfig(config, cwd) {
 }
 
 // src/resolve-config.ts
-var import_shared2 = require("@pandacss/shared");
+var import_shared7 = require("@pandacss/shared");
 
 // src/bundled-preset.ts
 var import_preset_base = require("@pandacss/preset-base");
@@ -464,6 +497,227 @@ var getBundledPreset = (preset) => {
   return typeof preset === "string" && isBundledPreset(preset) ? bundledPresets[preset] : void 0;
 };
 
+// src/validate-config.ts
+var import_logger2 = require("@pandacss/logger");
+var import_shared6 = require("@pandacss/shared");
+
+// src/validation/validate-artifact.ts
+var validateArtifactNames = (names, addError) => {
+  names.recipes.forEach((recipeName) => {
+    if (names.slotRecipes.has(recipeName)) {
+      addError("recipes", `This recipe name is already used in \`config.theme.slotRecipes\`: ${recipeName}`);
+    }
+    if (names.patterns.has(recipeName)) {
+      addError("recipes", `This recipe name is already used in \`config.patterns\`: \`${recipeName}\``);
+    }
+  });
+  names.slotRecipes.forEach((recipeName) => {
+    if (names.patterns.has(recipeName)) {
+      addError("recipes", `This recipe name is already used in \`config.patterns\`: ${recipeName}`);
+    }
+  });
+};
+
+// src/validation/validate-breakpoints.ts
+var import_shared4 = require("@pandacss/shared");
+var validateBreakpoints = (breakpoints, addError) => {
+  if (!breakpoints)
+    return;
+  const units = /* @__PURE__ */ new Set();
+  const values = Object.values(breakpoints);
+  for (const value of values) {
+    const unit = (0, import_shared4.getUnit)(value) ?? "px";
+    units.add(unit);
+  }
+  if (units.size > 1) {
+    addError("breakpoints", `All breakpoints must use the same unit: \`${values.join(", ")}\``);
+  }
+};
+
+// src/validation/validate-condition.ts
+var validateConditions = (conditions, addError) => {
+  if (!conditions)
+    return;
+  Object.values(conditions).forEach((condition) => {
+    if (!condition.startsWith("@") && !condition.includes("&")) {
+      addError("conditions", `Selectors should contain the \`&\` character: \`${condition}\``);
+    }
+  });
+};
+
+// src/validation/validate-patterns.ts
+var validatePatterns = (patterns, names) => {
+  if (!patterns)
+    return;
+  Object.keys(patterns).forEach((patternName) => {
+    names.patterns.add(patternName);
+  });
+};
+
+// src/validation/validate-recipes.ts
+var validateRecipes = (options) => {
+  const {
+    config: { theme },
+    artifacts
+  } = options;
+  if (!theme)
+    return;
+  if (theme.recipes) {
+    Object.keys(theme.recipes).forEach((recipeName) => {
+      artifacts.recipes.add(recipeName);
+    });
+  }
+  if (theme.slotRecipes) {
+    Object.keys(theme.slotRecipes).forEach((recipeName) => {
+      artifacts.slotRecipes.add(recipeName);
+    });
+  }
+  return artifacts;
+};
+
+// src/validation/validate-tokens.ts
+var import_shared5 = require("@pandacss/shared");
+
+// src/validation/get-final-paths.ts
+var getFinalPaths = (paths) => {
+  paths.forEach((path2) => {
+    paths.forEach((potentialExtension) => {
+      if (potentialExtension.startsWith(path2 + ".")) {
+        paths.delete(path2);
+      }
+    });
+  });
+  return paths;
+};
+
+// src/validation/validate-token-references.ts
+var validateTokenReferences = (valueAtPath, refsByPath, addError) => {
+  refsByPath.forEach((refs, path2) => {
+    if (refs.has(path2)) {
+      addError("tokens", `Self token reference: \`${path2}\``);
+    }
+    const stack = [path2];
+    while (stack.length > 0) {
+      const current = stack.pop();
+      const value = valueAtPath.get(current);
+      if (!value) {
+        addError("tokens", `Missing token: \`${current}\` used in \`config.semanticTokens.${path2}\``);
+      }
+      const deps = refsByPath.get(current);
+      if (!deps)
+        continue;
+      for (const transitiveDep of deps) {
+        if (path2 === transitiveDep) {
+          addError("tokens", `Circular token reference: \`${transitiveDep}\` -> \`${current}\` -> ... -> \`${path2}\``);
+          break;
+        }
+        stack.push(transitiveDep);
+      }
+    }
+  });
+};
+
+// src/validation/validate-tokens.ts
+var validateTokens = (options) => {
+  const {
+    config: { theme },
+    tokens: tokens2,
+    addError
+  } = options;
+  if (!theme)
+    return;
+  const { tokenNames, semanticTokenNames, valueAtPath, refsByPath } = tokens2;
+  if (theme.tokens) {
+    (0, import_shared5.traverse)(theme.tokens, (node) => {
+      if (node.depth >= 1) {
+        tokenNames.add(node.path);
+        valueAtPath.set(node.path, node.value);
+      }
+    });
+    const finalPaths = getFinalPaths(tokenNames);
+    finalPaths.forEach((path2) => {
+      if (!path2.includes("value")) {
+        addError("tokens", `Token paths must end with 'value': \`theme.tokens.${path2}\``);
+      }
+      const atPath = valueAtPath.get(path2);
+      if (typeof atPath === "string" && atPath.startsWith("{")) {
+        refsByPath.set(path2, /* @__PURE__ */ new Set([]));
+      }
+    });
+  }
+  if (theme.semanticTokens) {
+    (0, import_shared5.traverse)(theme.semanticTokens, (node) => {
+      if (node.depth >= 1) {
+        semanticTokenNames.add(node.path);
+        valueAtPath.set(node.path, node.value);
+        if (typeof node.value === "string" && node.value.startsWith("{") && node.path.includes("value")) {
+          const tokenPath = node.path.split(".value")[0];
+          if (!refsByPath.has(tokenPath)) {
+            refsByPath.set(tokenPath, /* @__PURE__ */ new Set());
+          }
+          const values = refsByPath.get(tokenPath);
+          const tokenRef = node.value.slice(1, -1);
+          values.add(tokenRef);
+        }
+      }
+    });
+    const finalPaths = getFinalPaths(semanticTokenNames);
+    finalPaths.forEach((path2) => {
+      if (!path2.includes("value")) {
+        addError("tokens", `Semantic token paths must contain 'value': \`theme.semanticTokens.${path2}\``);
+      }
+    });
+    validateTokenReferences(valueAtPath, refsByPath, addError);
+  }
+  semanticTokenNames.forEach((semanticTokenName) => {
+    if (tokenNames.has(semanticTokenName)) {
+      addError("tokens", `This token name is already used in \`config.theme.token\`: \`${semanticTokenName}\``);
+    }
+  });
+};
+
+// src/validate-config.ts
+var validateConfig = (config) => {
+  if (config.validation === "none")
+    return;
+  const warnings = /* @__PURE__ */ new Set();
+  const addError = (scope, message) => {
+    if (config.validation === "warn") {
+      warnings.add(`[${scope}]: ` + message);
+    } else {
+      throw new import_shared6.PandaError("CONFIG_ERROR", `[${scope}]: ` + message);
+    }
+  };
+  validateBreakpoints(config.theme?.breakpoints, addError);
+  validateConditions(config.conditions, addError);
+  const artifacts = {
+    recipes: /* @__PURE__ */ new Set(),
+    slotRecipes: /* @__PURE__ */ new Set(),
+    patterns: /* @__PURE__ */ new Set()
+  };
+  const tokens2 = {
+    tokenNames: /* @__PURE__ */ new Set(),
+    semanticTokenNames: /* @__PURE__ */ new Set(),
+    valueAtPath: /* @__PURE__ */ new Map(),
+    refsByPath: /* @__PURE__ */ new Map()
+  };
+  if (config.theme) {
+    validateTokens({ config, tokens: tokens2, addError });
+    validateRecipes({ config, tokens: tokens2, artifacts, addError });
+  }
+  validatePatterns(config.patterns, artifacts);
+  validateArtifactNames(artifacts, addError);
+  if (warnings.size) {
+    import_logger2.logger.warn(
+      "config",
+      `\u26A0\uFE0F Invalid config:
+${Array.from(warnings).map((err) => "- " + err).join("\n")}
+`
+    );
+    return warnings;
+  }
+};
+
 // src/resolve-config.ts
 async function resolveConfig(result, cwd) {
   const presets = /* @__PURE__ */ new Set();
@@ -478,12 +732,16 @@ async function resolveConfig(result, cwd) {
     presets.add(import_preset_panda.preset);
   }
   result.config.presets = Array.from(presets);
-  const mergedConfig = await getResolvedConfig(result.config, cwd);
-  const hooks = result.config.hooks ?? {};
-  const loadConfigResult = { ...result, config: mergedConfig };
+  const config = await getResolvedConfig(result.config, cwd);
+  validateConfig(config);
+  const { hooks = {} } = result.config;
+  const loadConfigResult = {
+    ...result,
+    config
+  };
   await hooks["config:resolved"]?.({ conf: loadConfigResult });
-  const serialized = (0, import_shared2.stringifyJson)(loadConfigResult.config);
-  const deserialize = () => (0, import_shared2.parseJson)(serialized);
+  const serialized = (0, import_shared7.stringifyJson)(loadConfigResult.config);
+  const deserialize = () => (0, import_shared7.parseJson)(serialized);
   return { ...loadConfigResult, serialized, deserialize, hooks };
 }
 

package/dist/index.mjs

@@ -3,53 +3,64 @@ import {
 } from "./chunk-PROY5XLZ.mjs";
 import {
   diffConfigs
-} from "./chunk-TP2SOWHU.mjs";
+} from "./chunk-5YOGLJPA.mjs";
 import {
   resolveTsPathPattern
 } from "./chunk-RPIVZP2I.mjs";
 
 // src/bundle-config.ts
-import { ConfigError, ConfigNotFoundError } from "@pandacss/error";
 import { logger } from "@pandacss/logger";
+import { PandaError as PandaError2 } from "@pandacss/shared";
 import { bundleNRequire } from "bundle-n-require";
 
 // src/find-config.ts
+import { PandaError } from "@pandacss/shared";
 import findUp from "escalade/sync";
 import { resolve } from "path";
+
+// src/is-panda-config.ts
 var configs = [".ts", ".js", ".mts", ".mjs", ".cts", ".cjs"];
 var pandaConfigRegex = new RegExp(`panda.config(${configs.join("|")})$`);
 var isPandaConfig = (file) => pandaConfigRegex.test(file);
-function findConfig({ cwd, file }) {
-  cwd = cwd ?? process.cwd();
-  if (file)
+
+// src/find-config.ts
+function findConfig(options) {
+  const { cwd = process.cwd(), file } = options;
+  if (file) {
     return resolve(cwd, file);
-  const result = findUp(cwd, (_dir, paths) => paths.find(isPandaConfig));
-  return result ?? void 0;
+  }
+  const configPath = findUp(cwd, (_dir, paths) => paths.find(isPandaConfig));
+  if (!configPath) {
+    throw new PandaError(
+      "CONFIG_NOT_FOUND",
+      `Cannot find config file \`panda.config.{ts,js,mjs,mts}\`. Did you forget to run \`panda init\`?`
+    );
+  }
+  return configPath;
 }
 
 // src/bundle-config.ts
 async function bundle(filepath, cwd) {
-  const { mod: config, dependencies } = await bundleNRequire(filepath, {
+  const { mod, dependencies } = await bundleNRequire(filepath, {
     cwd,
     interopDefault: true
   });
+  const config = mod?.default ?? mod;
   return {
-    config: config?.default ?? config,
+    config,
     dependencies
   };
 }
 async function bundleConfig(options) {
   const { cwd, file } = options;
   const filePath = findConfig({ cwd, file });
-  if (!filePath) {
-    throw new ConfigNotFoundError();
-  }
   logger.debug("config:path", filePath);
   const result = await bundle(filePath, cwd);
   if (typeof result.config !== "object") {
-    throw new ConfigError(`\u{1F4A5} Config must export or return an object.`);
+    throw new PandaError2("CONFIG_ERROR", `\u{1F4A5} Config must export or return an object.`);
   }
   result.config.outdir ??= "styled-system";
+  result.config.validation ??= "error";
   return {
     ...result,
     config: result.config,
@@ -218,6 +229,227 @@ var getBundledPreset = (preset) => {
   return typeof preset === "string" && isBundledPreset(preset) ? bundledPresets[preset] : void 0;
 };
 
+// src/validate-config.ts
+import { logger as logger2 } from "@pandacss/logger";
+import { PandaError as PandaError3 } from "@pandacss/shared";
+
+// src/validation/validate-artifact.ts
+var validateArtifactNames = (names, addError) => {
+  names.recipes.forEach((recipeName) => {
+    if (names.slotRecipes.has(recipeName)) {
+      addError("recipes", `This recipe name is already used in \`config.theme.slotRecipes\`: ${recipeName}`);
+    }
+    if (names.patterns.has(recipeName)) {
+      addError("recipes", `This recipe name is already used in \`config.patterns\`: \`${recipeName}\``);
+    }
+  });
+  names.slotRecipes.forEach((recipeName) => {
+    if (names.patterns.has(recipeName)) {
+      addError("recipes", `This recipe name is already used in \`config.patterns\`: ${recipeName}`);
+    }
+  });
+};
+
+// src/validation/validate-breakpoints.ts
+import { getUnit } from "@pandacss/shared";
+var validateBreakpoints = (breakpoints, addError) => {
+  if (!breakpoints)
+    return;
+  const units = /* @__PURE__ */ new Set();
+  const values = Object.values(breakpoints);
+  for (const value of values) {
+    const unit = getUnit(value) ?? "px";
+    units.add(unit);
+  }
+  if (units.size > 1) {
+    addError("breakpoints", `All breakpoints must use the same unit: \`${values.join(", ")}\``);
+  }
+};
+
+// src/validation/validate-condition.ts
+var validateConditions = (conditions, addError) => {
+  if (!conditions)
+    return;
+  Object.values(conditions).forEach((condition) => {
+    if (!condition.startsWith("@") && !condition.includes("&")) {
+      addError("conditions", `Selectors should contain the \`&\` character: \`${condition}\``);
+    }
+  });
+};
+
+// src/validation/validate-patterns.ts
+var validatePatterns = (patterns, names) => {
+  if (!patterns)
+    return;
+  Object.keys(patterns).forEach((patternName) => {
+    names.patterns.add(patternName);
+  });
+};
+
+// src/validation/validate-recipes.ts
+var validateRecipes = (options) => {
+  const {
+    config: { theme },
+    artifacts
+  } = options;
+  if (!theme)
+    return;
+  if (theme.recipes) {
+    Object.keys(theme.recipes).forEach((recipeName) => {
+      artifacts.recipes.add(recipeName);
+    });
+  }
+  if (theme.slotRecipes) {
+    Object.keys(theme.slotRecipes).forEach((recipeName) => {
+      artifacts.slotRecipes.add(recipeName);
+    });
+  }
+  return artifacts;
+};
+
+// src/validation/validate-tokens.ts
+import { traverse } from "@pandacss/shared";
+
+// src/validation/get-final-paths.ts
+var getFinalPaths = (paths) => {
+  paths.forEach((path2) => {
+    paths.forEach((potentialExtension) => {
+      if (potentialExtension.startsWith(path2 + ".")) {
+        paths.delete(path2);
+      }
+    });
+  });
+  return paths;
+};
+
+// src/validation/validate-token-references.ts
+var validateTokenReferences = (valueAtPath, refsByPath, addError) => {
+  refsByPath.forEach((refs, path2) => {
+    if (refs.has(path2)) {
+      addError("tokens", `Self token reference: \`${path2}\``);
+    }
+    const stack = [path2];
+    while (stack.length > 0) {
+      const current = stack.pop();
+      const value = valueAtPath.get(current);
+      if (!value) {
+        addError("tokens", `Missing token: \`${current}\` used in \`config.semanticTokens.${path2}\``);
+      }
+      const deps = refsByPath.get(current);
+      if (!deps)
+        continue;
+      for (const transitiveDep of deps) {
+        if (path2 === transitiveDep) {
+          addError("tokens", `Circular token reference: \`${transitiveDep}\` -> \`${current}\` -> ... -> \`${path2}\``);
+          break;
+        }
+        stack.push(transitiveDep);
+      }
+    }
+  });
+};
+
+// src/validation/validate-tokens.ts
+var validateTokens = (options) => {
+  const {
+    config: { theme },
+    tokens,
+    addError
+  } = options;
+  if (!theme)
+    return;
+  const { tokenNames, semanticTokenNames, valueAtPath, refsByPath } = tokens;
+  if (theme.tokens) {
+    traverse(theme.tokens, (node) => {
+      if (node.depth >= 1) {
+        tokenNames.add(node.path);
+        valueAtPath.set(node.path, node.value);
+      }
+    });
+    const finalPaths = getFinalPaths(tokenNames);
+    finalPaths.forEach((path2) => {
+      if (!path2.includes("value")) {
+        addError("tokens", `Token paths must end with 'value': \`theme.tokens.${path2}\``);
+      }
+      const atPath = valueAtPath.get(path2);
+      if (typeof atPath === "string" && atPath.startsWith("{")) {
+        refsByPath.set(path2, /* @__PURE__ */ new Set([]));
+      }
+    });
+  }
+  if (theme.semanticTokens) {
+    traverse(theme.semanticTokens, (node) => {
+      if (node.depth >= 1) {
+        semanticTokenNames.add(node.path);
+        valueAtPath.set(node.path, node.value);
+        if (typeof node.value === "string" && node.value.startsWith("{") && node.path.includes("value")) {
+          const tokenPath = node.path.split(".value")[0];
+          if (!refsByPath.has(tokenPath)) {
+            refsByPath.set(tokenPath, /* @__PURE__ */ new Set());
+          }
+          const values = refsByPath.get(tokenPath);
+          const tokenRef = node.value.slice(1, -1);
+          values.add(tokenRef);
+        }
+      }
+    });
+    const finalPaths = getFinalPaths(semanticTokenNames);
+    finalPaths.forEach((path2) => {
+      if (!path2.includes("value")) {
+        addError("tokens", `Semantic token paths must contain 'value': \`theme.semanticTokens.${path2}\``);
+      }
+    });
+    validateTokenReferences(valueAtPath, refsByPath, addError);
+  }
+  semanticTokenNames.forEach((semanticTokenName) => {
+    if (tokenNames.has(semanticTokenName)) {
+      addError("tokens", `This token name is already used in \`config.theme.token\`: \`${semanticTokenName}\``);
+    }
+  });
+};
+
+// src/validate-config.ts
+var validateConfig = (config) => {
+  if (config.validation === "none")
+    return;
+  const warnings = /* @__PURE__ */ new Set();
+  const addError = (scope, message) => {
+    if (config.validation === "warn") {
+      warnings.add(`[${scope}]: ` + message);
+    } else {
+      throw new PandaError3("CONFIG_ERROR", `[${scope}]: ` + message);
+    }
+  };
+  validateBreakpoints(config.theme?.breakpoints, addError);
+  validateConditions(config.conditions, addError);
+  const artifacts = {
+    recipes: /* @__PURE__ */ new Set(),
+    slotRecipes: /* @__PURE__ */ new Set(),
+    patterns: /* @__PURE__ */ new Set()
+  };
+  const tokens = {
+    tokenNames: /* @__PURE__ */ new Set(),
+    semanticTokenNames: /* @__PURE__ */ new Set(),
+    valueAtPath: /* @__PURE__ */ new Map(),
+    refsByPath: /* @__PURE__ */ new Map()
+  };
+  if (config.theme) {
+    validateTokens({ config, tokens, addError });
+    validateRecipes({ config, tokens, artifacts, addError });
+  }
+  validatePatterns(config.patterns, artifacts);
+  validateArtifactNames(artifacts, addError);
+  if (warnings.size) {
+    logger2.warn(
+      "config",
+      `\u26A0\uFE0F Invalid config:
+${Array.from(warnings).map((err) => "- " + err).join("\n")}
+`
+    );
+    return warnings;
+  }
+};
+
 // src/resolve-config.ts
 async function resolveConfig(result, cwd) {
   const presets = /* @__PURE__ */ new Set();
@@ -232,9 +464,13 @@ async function resolveConfig(result, cwd) {
     presets.add(presetPanda);
   }
   result.config.presets = Array.from(presets);
-  const mergedConfig = await getResolvedConfig(result.config, cwd);
-  const hooks = result.config.hooks ?? {};
-  const loadConfigResult = { ...result, config: mergedConfig };
+  const config = await getResolvedConfig(result.config, cwd);
+  validateConfig(config);
+  const { hooks = {} } = result.config;
+  const loadConfigResult = {
+    ...result,
+    config
+  };
   await hooks["config:resolved"]?.({ conf: loadConfigResult });
   const serialized = stringifyJson(loadConfigResult.config);
   const deserialize = () => parseJson(serialized);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pandacss/config",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Find and load panda config",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -64,12 +64,11 @@
     "merge-anything": "^5.1.7",
     "microdiff": "^1.3.2",
     "typescript": "^5.3.3",
-    "@pandacss/error": "0.28.0",
-    "@pandacss/logger": "0.28.0",
-    "@pandacss/preset-base": "0.28.0",
-    "@pandacss/preset-panda": "0.28.0",
-    "@pandacss/shared": "0.28.0",
-    "@pandacss/types": "0.28.0"
+    "@pandacss/logger": "0.29.0",
+    "@pandacss/preset-base": "0.29.0",
+    "@pandacss/preset-panda": "0.29.0",
+    "@pandacss/shared": "0.29.0",
+    "@pandacss/types": "0.29.0"
   },
   "devDependencies": {
     "pkg-types": "1.0.3"