@pandacss/config 0.30.2 → 0.32.0

package/dist/{chunk-XG56JT63.mjs → chunk-MT2A5AKG.mjs}

@@ -1,6 +1,74 @@
 // src/merge-config.ts
 import { mergeAndConcat } from "merge-anything";
 
+// src/merge-hooks.ts
+import { logger } from "@pandacss/logger";
+var mergeHooks = (plugins) => {
+  const hooksFns = {};
+  plugins.forEach(({ name, hooks }) => {
+    Object.entries(hooks ?? {}).forEach(([key, value]) => {
+      if (!hooksFns[key]) {
+        hooksFns[key] = [];
+      }
+      hooksFns[key].push([name, value]);
+    });
+  });
+  const mergedHooks = Object.fromEntries(
+    Object.entries(hooksFns).map(([key, entries]) => {
+      const fns = entries.map(([name, fn]) => tryCatch(name, fn));
+      if (key === "cssgen:done") {
+        return [key, reducers["cssgen:done"](fns)];
+      }
+      if (key === "codegen:prepare") {
+        return [key, reducers["codegen:prepare"](fns)];
+      }
+      return [key, syncHooks.includes(key) ? callAll(...fns) : callAllAsync(...fns)];
+    })
+  );
+  return mergedHooks;
+};
+var reducers = {
+  "cssgen:done": (fns) => (args) => {
+    let content = args.content;
+    for (const hookFn of fns) {
+      const result = hookFn({ ...args, content, original: args.content });
+      if (result !== void 0) {
+        content = result;
+      }
+    }
+    return content;
+  },
+  "codegen:prepare": (fns) => (args) => {
+    let artifacts = args.artifacts;
+    for (const hookFn of fns) {
+      const result = hookFn({ ...args, artifacts, original: args.artifacts });
+      if (result) {
+        artifacts = result;
+      }
+    }
+    return artifacts;
+  }
+};
+var syncHooks = ["context:created", "parser:before", "parser:after", "cssgen:done"];
+var callAllAsync = (...fns) => async (...a) => {
+  for (const fn of fns) {
+    await fn?.(...a);
+  }
+};
+var callAll = (...fns) => (...a) => {
+  fns.forEach((fn) => fn?.(...a));
+};
+var tryCatch = (name, fn) => {
+  return (...args) => {
+    try {
+      return fn(...args);
+    } catch (e) {
+      logger.error("hooks", `The error below comes from the plugin ${name}`);
+      console.error(e);
+    }
+  };
+};
+
 // src/utils.ts
 import { traverse } from "@pandacss/shared";
 var isObject = (v) => Object.prototype.toString.call(v) === "[object Object]";
@@ -87,6 +155,11 @@ var compact = (obj) => {
   }, {});
 };
 function mergeConfigs(configs) {
+  const [userConfig] = configs;
+  const pluginHooks = userConfig.plugins ?? [];
+  if (userConfig.hooks) {
+    pluginHooks.push({ name: "__panda.config__", hooks: userConfig.hooks });
+  }
   const mergedResult = assign(
     {
       conditions: mergeExtensions(configs.map((config) => config.conditions ?? {})),
@@ -94,7 +167,8 @@ function mergeConfigs(configs) {
       patterns: mergeExtensions(configs.map((config) => config.patterns ?? {})),
       utilities: mergeExtensions(configs.map((config) => config.utilities ?? {})),
       globalCss: mergeExtensions(configs.map((config) => config.globalCss ?? {})),
-      staticCss: mergeExtensions(configs.map((config) => config.staticCss ?? {}))
+      staticCss: mergeExtensions(configs.map((config) => config.staticCss ?? {})),
+      hooks: mergeHooks(pluginHooks)
     },
     ...configs
   );

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _pandacss_types from '@pandacss/types';
-import { Config, ConfigTsOptions } from '@pandacss/types';
+import { Config, ConfigTsOptions, LoadConfigResult } 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';
@@ -49,4 +49,11 @@ declare function getResolvedConfig(config: ExtendableConfig, cwd: string): Promi
  */
 declare function loadConfig(options: ConfigFileOptions): Promise<_pandacss_types.LoadConfigResult>;
 
-export { type BundleConfigResult, type GetDepsOptions, bundleConfig, findConfig, getConfigDependencies, getResolvedConfig, loadConfig };
+/**
+ * Resolve the final config (including presets)
+ * @pandacss/preset-base: ALWAYS included if NOT using eject: true
+ * @pandacss/preset-panda: only included by default if no presets
+ */
+declare function resolveConfig(result: BundleConfigResult, cwd: string): Promise<LoadConfigResult>;
+
+export { type BundleConfigResult, type GetDepsOptions, bundleConfig, findConfig, getConfigDependencies, getResolvedConfig, loadConfig, resolveConfig };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _pandacss_types from '@pandacss/types';
-import { Config, ConfigTsOptions } from '@pandacss/types';
+import { Config, ConfigTsOptions, LoadConfigResult } 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';
@@ -49,4 +49,11 @@ declare function getResolvedConfig(config: ExtendableConfig, cwd: string): Promi
  */
 declare function loadConfig(options: ConfigFileOptions): Promise<_pandacss_types.LoadConfigResult>;
 
-export { type BundleConfigResult, type GetDepsOptions, bundleConfig, findConfig, getConfigDependencies, getResolvedConfig, loadConfig };
+/**
+ * Resolve the final config (including presets)
+ * @pandacss/preset-base: ALWAYS included if NOT using eject: true
+ * @pandacss/preset-panda: only included by default if no presets
+ */
+declare function resolveConfig(result: BundleConfigResult, cwd: string): Promise<LoadConfigResult>;
+
+export { type BundleConfigResult, type GetDepsOptions, bundleConfig, findConfig, getConfigDependencies, getResolvedConfig, loadConfig, resolveConfig };

package/dist/index.js

@@ -37,7 +37,8 @@ __export(src_exports, {
   getConfigDependencies: () => getConfigDependencies,
   getResolvedConfig: () => getResolvedConfig,
   loadConfig: () => loadConfig,
-  mergeConfigs: () => mergeConfigs
+  mergeConfigs: () => mergeConfigs,
+  resolveConfig: () => resolveConfig
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -375,6 +376,74 @@ function getConfigDependencies(filePath, tsOptions = { pathMappings: [] }, compi
 // src/merge-config.ts
 var import_merge_anything = require("merge-anything");
 
+// src/merge-hooks.ts
+var import_logger2 = require("@pandacss/logger");
+var mergeHooks = (plugins) => {
+  const hooksFns = {};
+  plugins.forEach(({ name, hooks }) => {
+    Object.entries(hooks ?? {}).forEach(([key, value]) => {
+      if (!hooksFns[key]) {
+        hooksFns[key] = [];
+      }
+      hooksFns[key].push([name, value]);
+    });
+  });
+  const mergedHooks = Object.fromEntries(
+    Object.entries(hooksFns).map(([key, entries]) => {
+      const fns = entries.map(([name, fn]) => tryCatch(name, fn));
+      if (key === "cssgen:done") {
+        return [key, reducers["cssgen:done"](fns)];
+      }
+      if (key === "codegen:prepare") {
+        return [key, reducers["codegen:prepare"](fns)];
+      }
+      return [key, syncHooks.includes(key) ? callAll(...fns) : callAllAsync(...fns)];
+    })
+  );
+  return mergedHooks;
+};
+var reducers = {
+  "cssgen:done": (fns) => (args) => {
+    let content = args.content;
+    for (const hookFn of fns) {
+      const result = hookFn({ ...args, content, original: args.content });
+      if (result !== void 0) {
+        content = result;
+      }
+    }
+    return content;
+  },
+  "codegen:prepare": (fns) => (args) => {
+    let artifacts = args.artifacts;
+    for (const hookFn of fns) {
+      const result = hookFn({ ...args, artifacts, original: args.artifacts });
+      if (result) {
+        artifacts = result;
+      }
+    }
+    return artifacts;
+  }
+};
+var syncHooks = ["context:created", "parser:before", "parser:after", "cssgen:done"];
+var callAllAsync = (...fns) => async (...a) => {
+  for (const fn of fns) {
+    await fn?.(...a);
+  }
+};
+var callAll = (...fns) => (...a) => {
+  fns.forEach((fn) => fn?.(...a));
+};
+var tryCatch = (name, fn) => {
+  return (...args) => {
+    try {
+      return fn(...args);
+    } catch (e) {
+      import_logger2.logger.error("hooks", `The error below comes from the plugin ${name}`);
+      console.error(e);
+    }
+  };
+};
+
 // src/utils.ts
 var import_shared4 = require("@pandacss/shared");
 var isObject = (v) => Object.prototype.toString.call(v) === "[object Object]";
@@ -461,6 +530,11 @@ var compact = (obj) => {
   }, {});
 };
 function mergeConfigs(configs2) {
+  const [userConfig] = configs2;
+  const pluginHooks = userConfig.plugins ?? [];
+  if (userConfig.hooks) {
+    pluginHooks.push({ name: "__panda.config__", hooks: userConfig.hooks });
+  }
   const mergedResult = assign(
     {
       conditions: mergeExtensions(configs2.map((config) => config.conditions ?? {})),
@@ -468,7 +542,8 @@ function mergeConfigs(configs2) {
       patterns: mergeExtensions(configs2.map((config) => config.patterns ?? {})),
       utilities: mergeExtensions(configs2.map((config) => config.utilities ?? {})),
       globalCss: mergeExtensions(configs2.map((config) => config.globalCss ?? {})),
-      staticCss: mergeExtensions(configs2.map((config) => config.staticCss ?? {}))
+      staticCss: mergeExtensions(configs2.map((config) => config.staticCss ?? {})),
+      hooks: mergeHooks(pluginHooks)
     },
     ...configs2
   );
@@ -495,6 +570,7 @@ async function getResolvedConfig(config, cwd) {
 }
 
 // src/resolve-config.ts
+var import_logger4 = require("@pandacss/logger");
 var import_shared8 = require("@pandacss/shared");
 
 // src/bundled-preset.ts
@@ -512,7 +588,7 @@ var getBundledPreset = (preset) => {
 };
 
 // src/validate-config.ts
-var import_logger2 = require("@pandacss/logger");
+var import_logger3 = require("@pandacss/logger");
 var import_shared7 = require("@pandacss/shared");
 
 // src/validation/validate-artifact.ts
@@ -592,17 +668,11 @@ var validateRecipes = (options) => {
 // src/validation/validate-tokens.ts
 var import_shared6 = 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/utils.ts
+var isValidToken = (token) => Object.hasOwnProperty.call(token, "value");
+var isTokenReference = (value) => typeof value === "string" && value.startsWith("{");
+var formatPath = (path2) => path2;
+var SEP = ".";
 
 // src/validation/validate-token-references.ts
 var validateTokenReferences = (valueAtPath, refsByPath, addError) => {
@@ -612,17 +682,23 @@ var validateTokenReferences = (valueAtPath, refsByPath, addError) => {
     }
     const stack = [path2];
     while (stack.length > 0) {
-      const current = stack.pop();
-      const value = valueAtPath.get(current);
+      const currentPath = stack.pop();
+      const value = valueAtPath.get(currentPath);
       if (!value) {
-        addError("tokens", `Missing token: \`${current}\` used in \`config.semanticTokens.${path2}\``);
+        addError("tokens", `Missing token: \`${currentPath}\` used in \`config.semanticTokens.${path2}\``);
       }
-      const deps = refsByPath.get(current);
+      if (isTokenReference(value) && !refsByPath.has(value)) {
+        addError("tokens", `Unknown token reference: \`${currentPath}\` used in \`${value}\``);
+      }
+      const deps = refsByPath.get(currentPath);
       if (!deps)
         continue;
       for (const transitiveDep of deps) {
         if (path2 === transitiveDep) {
-          addError("tokens", `Circular token reference: \`${transitiveDep}\` -> \`${current}\` -> ... -> \`${path2}\``);
+          addError(
+            "tokens",
+            `Circular token reference: \`${transitiveDep}\` -> \`${currentPath}\` -> ... -> \`${path2}\``
+          );
           break;
         }
         stack.push(transitiveDep);
@@ -642,43 +718,65 @@ var validateTokens = (options) => {
     return;
   const { tokenNames, semanticTokenNames, valueAtPath, refsByPath } = tokens2;
   if (theme.tokens) {
-    (0, import_shared6.traverse)(theme.tokens, (node) => {
-      if (node.depth >= 1) {
-        tokenNames.add(node.path);
-        valueAtPath.set(node.path, node.value);
+    const tokenPaths = /* @__PURE__ */ new Set();
+    (0, import_shared6.walkObject)(
+      theme.tokens,
+      (value, paths) => {
+        const path2 = paths.join(SEP);
+        tokenNames.add(path2);
+        tokenPaths.add(path2);
+        valueAtPath.set(path2, value);
+      },
+      {
+        stop: isValidToken
       }
-    });
-    const finalPaths = getFinalPaths(tokenNames);
-    finalPaths.forEach((path2) => {
-      if (!path2.includes("value")) {
-        addError("tokens", `Token paths must end with 'value': \`theme.tokens.${path2}\``);
+    );
+    tokenPaths.forEach((path2) => {
+      const value = valueAtPath.get(path2);
+      const formattedPath = formatPath(path2);
+      if (!isValidToken(value)) {
+        addError("tokens", `Token must contain 'value': \`theme.tokens.${formattedPath}\``);
+        return;
       }
-      const atPath = valueAtPath.get(path2);
-      if (typeof atPath === "string" && atPath.startsWith("{")) {
-        refsByPath.set(path2, /* @__PURE__ */ new Set([]));
+      if (isTokenReference(value)) {
+        refsByPath.set(formattedPath, /* @__PURE__ */ new Set([]));
       }
     });
   }
   if (theme.semanticTokens) {
-    (0, import_shared6.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 tokenPaths = /* @__PURE__ */ new Set();
+    (0, import_shared6.walkObject)(
+      theme.semanticTokens,
+      (value, paths) => {
+        const path2 = paths.join(SEP);
+        semanticTokenNames.add(path2);
+        valueAtPath.set(path2, value);
+        tokenPaths.add(path2);
+        if (!isValidToken(value))
+          return;
+        (0, import_shared6.walkObject)(value, (itemValue) => {
+          if (isTokenReference(itemValue)) {
+            const formattedPath = formatPath(path2);
+            if (!refsByPath.has(formattedPath)) {
+              refsByPath.set(formattedPath, /* @__PURE__ */ new Set());
+            }
+            const references = refsByPath.get(formattedPath);
+            if (!references)
+              return;
+            const reference = itemValue.slice(1, -1);
+            references.add(reference);
           }
-          const values = refsByPath.get(tokenPath);
-          const tokenRef = node.value.slice(1, -1);
-          values.add(tokenRef);
-        }
+        });
+      },
+      {
+        stop: isValidToken
       }
-    });
-    const finalPaths = getFinalPaths(semanticTokenNames);
-    finalPaths.forEach((path2) => {
-      if (!path2.includes("value")) {
-        addError("tokens", `Semantic token paths must contain 'value': \`theme.semanticTokens.${path2}\``);
+    );
+    tokenPaths.forEach((path2) => {
+      const formattedPath = formatPath(path2);
+      const value = valueAtPath.get(path2);
+      if (!(0, import_shared6.isObject)(value) && !path2.includes("value")) {
+        addError("tokens", `Token must contain 'value': \`theme.semanticTokens.${formattedPath}\``);
       }
     });
     validateTokenReferences(valueAtPath, refsByPath, addError);
@@ -691,11 +789,7 @@ var validateConfig = (config) => {
     return;
   const warnings = /* @__PURE__ */ new Set();
   const addError = (scope, message) => {
-    if (config.validation === "warn") {
-      warnings.add(`[${scope}]: ` + message);
-    } else {
-      throw new import_shared7.PandaError("CONFIG_ERROR", `[${scope}]: ` + message);
-    }
+    warnings.add(`[${scope}] ` + message);
   };
   validateBreakpoints(config.theme?.breakpoints, addError);
   validateConditions(config.conditions, addError);
@@ -717,12 +811,13 @@ var validateConfig = (config) => {
   validatePatterns(config.patterns, artifacts);
   validateArtifactNames(artifacts, addError);
   if (warnings.size) {
-    import_logger2.logger.warn(
-      "config",
-      `\u26A0\uFE0F Invalid config:
+    const errors = `\u26A0\uFE0F Invalid config:
 ${Array.from(warnings).map((err) => "- " + err).join("\n")}
-`
-    );
+`;
+    if (config.validation === "error") {
+      throw new import_shared7.PandaError("CONFIG_ERROR", errors);
+    }
+    import_logger3.logger.warn("config", errors);
     return warnings;
   }
 };
@@ -741,12 +836,15 @@ async function resolveConfig(result, cwd) {
     presets.add(import_preset_panda.preset);
   }
   result.config.presets = Array.from(presets);
-  const config = await getResolvedConfig(result.config, cwd);
-  validateConfig(config);
-  const { hooks = {} } = result.config;
+  const mergedConfig = await getResolvedConfig(result.config, cwd);
+  const hooks = mergedConfig.hooks ?? {};
+  if (mergedConfig.logLevel) {
+    import_logger4.logger.level = mergedConfig.logLevel;
+  }
+  validateConfig(mergedConfig);
   const loadConfigResult = {
     ...result,
-    config
+    config: mergedConfig
   };
   if (hooks["config:resolved"]) {
     const result2 = await hooks["config:resolved"]({
@@ -778,5 +876,6 @@ async function loadConfig(options) {
   getConfigDependencies,
   getResolvedConfig,
   loadConfig,
-  mergeConfigs
+  mergeConfigs,
+  resolveConfig
 });

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   mergeConfigs,
   utils
-} from "./chunk-XG56JT63.mjs";
+} from "./chunk-MT2A5AKG.mjs";
 import {
   diffConfigs
 } from "./chunk-5YOGLJPA.mjs";
@@ -214,6 +214,7 @@ async function getResolvedConfig(config, cwd) {
 }
 
 // src/resolve-config.ts
+import { logger as logger3 } from "@pandacss/logger";
 import { parseJson, stringifyJson } from "@pandacss/shared";
 
 // src/bundled-preset.ts
@@ -309,19 +310,13 @@ var validateRecipes = (options) => {
 };
 
 // src/validation/validate-tokens.ts
-import { traverse } from "@pandacss/shared";
+import { isObject, walkObject } 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/utils.ts
+var isValidToken = (token) => Object.hasOwnProperty.call(token, "value");
+var isTokenReference = (value) => typeof value === "string" && value.startsWith("{");
+var formatPath = (path2) => path2;
+var SEP = ".";
 
 // src/validation/validate-token-references.ts
 var validateTokenReferences = (valueAtPath, refsByPath, addError) => {
@@ -331,17 +326,23 @@ var validateTokenReferences = (valueAtPath, refsByPath, addError) => {
     }
     const stack = [path2];
     while (stack.length > 0) {
-      const current = stack.pop();
-      const value = valueAtPath.get(current);
+      const currentPath = stack.pop();
+      const value = valueAtPath.get(currentPath);
       if (!value) {
-        addError("tokens", `Missing token: \`${current}\` used in \`config.semanticTokens.${path2}\``);
+        addError("tokens", `Missing token: \`${currentPath}\` used in \`config.semanticTokens.${path2}\``);
+      }
+      if (isTokenReference(value) && !refsByPath.has(value)) {
+        addError("tokens", `Unknown token reference: \`${currentPath}\` used in \`${value}\``);
       }
-      const deps = refsByPath.get(current);
+      const deps = refsByPath.get(currentPath);
       if (!deps)
         continue;
       for (const transitiveDep of deps) {
         if (path2 === transitiveDep) {
-          addError("tokens", `Circular token reference: \`${transitiveDep}\` -> \`${current}\` -> ... -> \`${path2}\``);
+          addError(
+            "tokens",
+            `Circular token reference: \`${transitiveDep}\` -> \`${currentPath}\` -> ... -> \`${path2}\``
+          );
           break;
         }
         stack.push(transitiveDep);
@@ -361,43 +362,65 @@ var validateTokens = (options) => {
     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 tokenPaths = /* @__PURE__ */ new Set();
+    walkObject(
+      theme.tokens,
+      (value, paths) => {
+        const path2 = paths.join(SEP);
+        tokenNames.add(path2);
+        tokenPaths.add(path2);
+        valueAtPath.set(path2, value);
+      },
+      {
+        stop: isValidToken
       }
-    });
-    const finalPaths = getFinalPaths(tokenNames);
-    finalPaths.forEach((path2) => {
-      if (!path2.includes("value")) {
-        addError("tokens", `Token paths must end with 'value': \`theme.tokens.${path2}\``);
+    );
+    tokenPaths.forEach((path2) => {
+      const value = valueAtPath.get(path2);
+      const formattedPath = formatPath(path2);
+      if (!isValidToken(value)) {
+        addError("tokens", `Token must contain 'value': \`theme.tokens.${formattedPath}\``);
+        return;
       }
-      const atPath = valueAtPath.get(path2);
-      if (typeof atPath === "string" && atPath.startsWith("{")) {
-        refsByPath.set(path2, /* @__PURE__ */ new Set([]));
+      if (isTokenReference(value)) {
+        refsByPath.set(formattedPath, /* @__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 tokenPaths = /* @__PURE__ */ new Set();
+    walkObject(
+      theme.semanticTokens,
+      (value, paths) => {
+        const path2 = paths.join(SEP);
+        semanticTokenNames.add(path2);
+        valueAtPath.set(path2, value);
+        tokenPaths.add(path2);
+        if (!isValidToken(value))
+          return;
+        walkObject(value, (itemValue) => {
+          if (isTokenReference(itemValue)) {
+            const formattedPath = formatPath(path2);
+            if (!refsByPath.has(formattedPath)) {
+              refsByPath.set(formattedPath, /* @__PURE__ */ new Set());
+            }
+            const references = refsByPath.get(formattedPath);
+            if (!references)
+              return;
+            const reference = itemValue.slice(1, -1);
+            references.add(reference);
           }
-          const values = refsByPath.get(tokenPath);
-          const tokenRef = node.value.slice(1, -1);
-          values.add(tokenRef);
-        }
+        });
+      },
+      {
+        stop: isValidToken
       }
-    });
-    const finalPaths = getFinalPaths(semanticTokenNames);
-    finalPaths.forEach((path2) => {
-      if (!path2.includes("value")) {
-        addError("tokens", `Semantic token paths must contain 'value': \`theme.semanticTokens.${path2}\``);
+    );
+    tokenPaths.forEach((path2) => {
+      const formattedPath = formatPath(path2);
+      const value = valueAtPath.get(path2);
+      if (!isObject(value) && !path2.includes("value")) {
+        addError("tokens", `Token must contain 'value': \`theme.semanticTokens.${formattedPath}\``);
       }
     });
     validateTokenReferences(valueAtPath, refsByPath, addError);
@@ -410,11 +433,7 @@ var validateConfig = (config) => {
     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);
-    }
+    warnings.add(`[${scope}] ` + message);
   };
   validateBreakpoints(config.theme?.breakpoints, addError);
   validateConditions(config.conditions, addError);
@@ -436,12 +455,13 @@ var validateConfig = (config) => {
   validatePatterns(config.patterns, artifacts);
   validateArtifactNames(artifacts, addError);
   if (warnings.size) {
-    logger2.warn(
-      "config",
-      `\u26A0\uFE0F Invalid config:
+    const errors = `\u26A0\uFE0F Invalid config:
 ${Array.from(warnings).map((err) => "- " + err).join("\n")}
-`
-    );
+`;
+    if (config.validation === "error") {
+      throw new PandaError3("CONFIG_ERROR", errors);
+    }
+    logger2.warn("config", errors);
     return warnings;
   }
 };
@@ -460,12 +480,15 @@ async function resolveConfig(result, cwd) {
     presets.add(presetPanda);
   }
   result.config.presets = Array.from(presets);
-  const config = await getResolvedConfig(result.config, cwd);
-  validateConfig(config);
-  const { hooks = {} } = result.config;
+  const mergedConfig = await getResolvedConfig(result.config, cwd);
+  const hooks = mergedConfig.hooks ?? {};
+  if (mergedConfig.logLevel) {
+    logger3.level = mergedConfig.logLevel;
+  }
+  validateConfig(mergedConfig);
   const loadConfigResult = {
     ...result,
-    config
+    config: mergedConfig
   };
   if (hooks["config:resolved"]) {
     const result2 = await hooks["config:resolved"]({
@@ -496,5 +519,6 @@ export {
   getConfigDependencies,
   getResolvedConfig,
   loadConfig,
-  mergeConfigs
+  mergeConfigs,
+  resolveConfig
 };

package/dist/merge-config.js

@@ -25,6 +25,74 @@ __export(merge_config_exports, {
 module.exports = __toCommonJS(merge_config_exports);
 var import_merge_anything = require("merge-anything");
 
+// src/merge-hooks.ts
+var import_logger = require("@pandacss/logger");
+var mergeHooks = (plugins) => {
+  const hooksFns = {};
+  plugins.forEach(({ name, hooks }) => {
+    Object.entries(hooks ?? {}).forEach(([key, value]) => {
+      if (!hooksFns[key]) {
+        hooksFns[key] = [];
+      }
+      hooksFns[key].push([name, value]);
+    });
+  });
+  const mergedHooks = Object.fromEntries(
+    Object.entries(hooksFns).map(([key, entries]) => {
+      const fns = entries.map(([name, fn]) => tryCatch(name, fn));
+      if (key === "cssgen:done") {
+        return [key, reducers["cssgen:done"](fns)];
+      }
+      if (key === "codegen:prepare") {
+        return [key, reducers["codegen:prepare"](fns)];
+      }
+      return [key, syncHooks.includes(key) ? callAll(...fns) : callAllAsync(...fns)];
+    })
+  );
+  return mergedHooks;
+};
+var reducers = {
+  "cssgen:done": (fns) => (args) => {
+    let content = args.content;
+    for (const hookFn of fns) {
+      const result = hookFn({ ...args, content, original: args.content });
+      if (result !== void 0) {
+        content = result;
+      }
+    }
+    return content;
+  },
+  "codegen:prepare": (fns) => (args) => {
+    let artifacts = args.artifacts;
+    for (const hookFn of fns) {
+      const result = hookFn({ ...args, artifacts, original: args.artifacts });
+      if (result) {
+        artifacts = result;
+      }
+    }
+    return artifacts;
+  }
+};
+var syncHooks = ["context:created", "parser:before", "parser:after", "cssgen:done"];
+var callAllAsync = (...fns) => async (...a) => {
+  for (const fn of fns) {
+    await fn?.(...a);
+  }
+};
+var callAll = (...fns) => (...a) => {
+  fns.forEach((fn) => fn?.(...a));
+};
+var tryCatch = (name, fn) => {
+  return (...args) => {
+    try {
+      return fn(...args);
+    } catch (e) {
+      import_logger.logger.error("hooks", `The error below comes from the plugin ${name}`);
+      console.error(e);
+    }
+  };
+};
+
 // src/utils.ts
 var import_shared = require("@pandacss/shared");
 var isObject = (v) => Object.prototype.toString.call(v) === "[object Object]";
@@ -98,6 +166,11 @@ var compact = (obj) => {
   }, {});
 };
 function mergeConfigs(configs) {
+  const [userConfig] = configs;
+  const pluginHooks = userConfig.plugins ?? [];
+  if (userConfig.hooks) {
+    pluginHooks.push({ name: "__panda.config__", hooks: userConfig.hooks });
+  }
   const mergedResult = assign(
     {
       conditions: mergeExtensions(configs.map((config) => config.conditions ?? {})),
@@ -105,7 +178,8 @@ function mergeConfigs(configs) {
       patterns: mergeExtensions(configs.map((config) => config.patterns ?? {})),
       utilities: mergeExtensions(configs.map((config) => config.utilities ?? {})),
       globalCss: mergeExtensions(configs.map((config) => config.globalCss ?? {})),
-      staticCss: mergeExtensions(configs.map((config) => config.staticCss ?? {}))
+      staticCss: mergeExtensions(configs.map((config) => config.staticCss ?? {})),
+      hooks: mergeHooks(pluginHooks)
     },
     ...configs
   );

package/dist/merge-config.mjs

@@ -1,6 +1,6 @@
 import {
   mergeConfigs
-} from "./chunk-XG56JT63.mjs";
+} from "./chunk-MT2A5AKG.mjs";
 export {
   mergeConfigs
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pandacss/config",
-  "version": "0.30.2",
+  "version": "0.32.0",
   "description": "Find and load panda config",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -60,15 +60,15 @@
   ],
   "dependencies": {
     "bundle-n-require": "1.1.1",
-    "escalade": "3.1.1",
+    "escalade": "3.1.2",
     "merge-anything": "5.1.7",
     "microdiff": "1.3.2",
     "typescript": "5.3.3",
-    "@pandacss/logger": "0.30.2",
-    "@pandacss/preset-base": "0.30.2",
-    "@pandacss/preset-panda": "0.30.2",
-    "@pandacss/shared": "0.30.2",
-    "@pandacss/types": "0.30.2"
+    "@pandacss/logger": "0.32.0",
+    "@pandacss/preset-base": "0.32.0",
+    "@pandacss/preset-panda": "0.32.0",
+    "@pandacss/shared": "0.32.0",
+    "@pandacss/types": "0.32.0"
   },
   "devDependencies": {
     "pkg-types": "1.0.3"