@kbach/react 1.0.0-beta.27 → 1.0.0-beta.29

package/dist/jsx-dev-runtime.js

@@ -418,11 +418,87 @@ var defaultTheme = {
   // centering/padding) — see `ContainerConfig`'s own doc comment.
   container: {}
 };
+var activeTheme = defaultTheme;
 var activeThemeJson = JSON.stringify(defaultTheme);
+function getTheme() {
+  return activeTheme;
+}
 function getThemeJson() {
   return activeThemeJson;
 }
 
+// src/colorVariables.ts
+function parseHexRgb(hex) {
+  const m = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(hex.trim());
+  if (!m) return null;
+  let h = m[1];
+  if (h.length === 3) h = h.split("").map((c) => c + c).join("");
+  const n = parseInt(h, 16);
+  return [n >> 16 & 255, n >> 8 & 255, n & 255];
+}
+function wrapDarkDecls(strategy, decls) {
+  switch (strategy) {
+    case "class":
+      return `.dark { ${decls} }`;
+    case "media":
+      return `@media (prefers-color-scheme: dark) { :root { ${decls} } }`;
+    case "attribute":
+    default:
+      return `[data-theme="dark"] { ${decls} }`;
+  }
+}
+function modeAwareDecls(theme) {
+  const light = [];
+  const dark = [];
+  for (const [name, value] of Object.entries(theme.colors)) {
+    if (typeof value === "string") continue;
+    const l = parseHexRgb(value.light);
+    const d = parseHexRgb(value.dark);
+    if (!l || !d) continue;
+    light.push(`--kb-color-${name}: ${l.join(",")};`);
+    dark.push(`--kb-color-${name}: ${d.join(",")};`);
+  }
+  return { light, dark };
+}
+function colorVariablesCss(theme) {
+  const { light, dark } = modeAwareDecls(theme);
+  if (light.length === 0) return "";
+  return `:root { ${light.join(" ")} }
+${wrapDarkDecls(theme.darkMode, dark.join(" "))}`;
+}
+function withColorVariables(theme) {
+  let changed = false;
+  const colors = {};
+  for (const [name, value] of Object.entries(theme.colors)) {
+    if (typeof value !== "string" && parseHexRgb(value.light) && parseHexRgb(value.dark)) {
+      colors[name] = `rgb(var(--kb-color-${name}))`;
+      changed = true;
+    } else {
+      colors[name] = value;
+    }
+  }
+  return changed ? { ...theme, colors } : theme;
+}
+var STYLE_ID = "kbach-colors";
+var injectedForTheme = null;
+function ensureColorVariablesInjected(theme) {
+  if (typeof document === "undefined") return;
+  if (injectedForTheme === theme) return;
+  injectedForTheme = theme;
+  const css = colorVariablesCss(theme);
+  let el = document.getElementById(STYLE_ID);
+  if (!css) {
+    el?.remove();
+    return;
+  }
+  if (!el) {
+    el = document.createElement("style");
+    el.id = STYLE_ID;
+    document.head.insertBefore(el, document.head.firstChild);
+  }
+  el.textContent = css;
+}
+
 // src/reset.ts
 var RESET_STYLE_ID = "kbach-reset";
 var RESET_RULES = [
@@ -551,27 +627,88 @@ function ensureResetInjected() {
 var KB_CACHE_MAX = 500;
 var kbCache = /* @__PURE__ */ new Map();
 var cachedForThemeJson = null;
+var engineThemeJson = "";
+var hasModeAware = false;
+function refreshEngineTheme() {
+  const theme = getTheme();
+  const withVars = withColorVariables(theme);
+  hasModeAware = withVars !== theme;
+  engineThemeJson = hasModeAware ? JSON.stringify(withVars) : getThemeJson();
+}
+var staticOwner = null;
+var staticSheet = null;
+var staticRuleCount = -1;
+var staticTokens = /* @__PURE__ */ new Set();
+function unescapeCssIdent(s) {
+  return s.replace(/\\([0-9a-fA-F]{1,6})\s?/g, (_, hex) => String.fromCodePoint(parseInt(hex, 16))).replace(/\\(.)/g, "$1");
+}
+function isStaticKbachSheet(sheet) {
+  try {
+    return Array.from(sheet.cssRules).some((r) => r instanceof CSSStyleRule && r.selectorText === ":root" && r.cssText.includes("--kb-dark-mode"));
+  } catch {
+    return false;
+  }
+}
+function collectClasses(rules, into) {
+  for (const r of Array.from(rules)) {
+    if (r instanceof CSSStyleRule) {
+      for (const m of r.selectorText.matchAll(/\.((?:\\[0-9a-fA-F]{1,6}\s?|\\.|[\w-])+)/g)) into.add(unescapeCssIdent(m[1]));
+    } else if ("cssRules" in r) {
+      collectClasses(r.cssRules, into);
+    }
+  }
+}
+function staticClasses() {
+  if (typeof document === "undefined") return staticTokens;
+  let sheet = staticOwner && staticOwner.sheet;
+  if (!sheet || !isStaticKbachSheet(sheet)) {
+    sheet = Array.from(document.styleSheets).find((s) => s !== styleEl?.sheet && isStaticKbachSheet(s)) ?? null;
+    staticOwner = sheet?.ownerNode ?? null;
+  }
+  if (!sheet) {
+    staticSheet = null;
+    staticTokens = /* @__PURE__ */ new Set();
+    return staticTokens;
+  }
+  if (sheet !== staticSheet || sheet.cssRules.length !== staticRuleCount) {
+    staticSheet = sheet;
+    staticRuleCount = sheet.cssRules.length;
+    staticTokens = /* @__PURE__ */ new Set();
+    collectClasses(sheet.cssRules, staticTokens);
+  }
+  return staticTokens;
+}
 function kb(classString) {
   const themeJson = getThemeJson();
   if (themeJson !== cachedForThemeJson) {
     kbCache.clear();
     cachedForThemeJson = themeJson;
+    refreshEngineTheme();
+  }
+  const statics = runtimeCSSDisabled ? null : staticClasses();
+  let toResolve = classString;
+  let alreadyStatic = "";
+  if (statics && statics.size > 0) {
+    const tokens = classString.split(/\s+/).filter(Boolean);
+    toResolve = tokens.filter((t) => !statics.has(t)).join(" ");
+    alreadyStatic = tokens.filter((t) => statics.has(t)).join(" ");
   }
-  let result = kbCache.get(classString);
+  let result = kbCache.get(toResolve);
   if (result === void 0) {
-    const json = generateCss(classString, themeJson);
+    const json = generateCss(toResolve, engineThemeJson);
     result = JSON.parse(json);
     if (kbCache.size >= KB_CACHE_MAX) kbCache.clear();
-    kbCache.set(classString, result);
+    kbCache.set(toResolve, result);
   }
   const { className, rules } = result;
   if (!runtimeCSSDisabled) {
     ensureResetInjected();
+    if (hasModeAware) ensureColorVariablesInjected(getTheme());
     for (const { rule, order } of rules) {
       injectRule(rule, order);
     }
   }
-  return className;
+  return alreadyStatic ? (alreadyStatic + " " + className).trim() : className;
 }
 
 // src/jsx-runtime.tsx

package/dist/jsx-dev-runtime.mjs

@@ -2,9 +2,9 @@ import {
   Fragment,
   jsx,
   jsxs
-} from "./chunk-UP7MWEU5.mjs";
-import "./chunk-DJKDEDPE.mjs";
-import "./chunk-OVKVZA7B.mjs";
+} from "./chunk-6KXERZP3.mjs";
+import "./chunk-K6AUD64N.mjs";
+import "./chunk-FBYS4BI3.mjs";
 
 // src/jsx-dev-runtime.tsx
 function jsxDEV(type, props, key, isStaticChildren, source, self) {

package/dist/jsx-runtime.js

@@ -417,11 +417,87 @@ var defaultTheme = {
   // centering/padding) — see `ContainerConfig`'s own doc comment.
   container: {}
 };
+var activeTheme = defaultTheme;
 var activeThemeJson = JSON.stringify(defaultTheme);
+function getTheme() {
+  return activeTheme;
+}
 function getThemeJson() {
   return activeThemeJson;
 }
 
+// src/colorVariables.ts
+function parseHexRgb(hex) {
+  const m = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(hex.trim());
+  if (!m) return null;
+  let h = m[1];
+  if (h.length === 3) h = h.split("").map((c) => c + c).join("");
+  const n = parseInt(h, 16);
+  return [n >> 16 & 255, n >> 8 & 255, n & 255];
+}
+function wrapDarkDecls(strategy, decls) {
+  switch (strategy) {
+    case "class":
+      return `.dark { ${decls} }`;
+    case "media":
+      return `@media (prefers-color-scheme: dark) { :root { ${decls} } }`;
+    case "attribute":
+    default:
+      return `[data-theme="dark"] { ${decls} }`;
+  }
+}
+function modeAwareDecls(theme) {
+  const light = [];
+  const dark = [];
+  for (const [name, value] of Object.entries(theme.colors)) {
+    if (typeof value === "string") continue;
+    const l = parseHexRgb(value.light);
+    const d = parseHexRgb(value.dark);
+    if (!l || !d) continue;
+    light.push(`--kb-color-${name}: ${l.join(",")};`);
+    dark.push(`--kb-color-${name}: ${d.join(",")};`);
+  }
+  return { light, dark };
+}
+function colorVariablesCss(theme) {
+  const { light, dark } = modeAwareDecls(theme);
+  if (light.length === 0) return "";
+  return `:root { ${light.join(" ")} }
+${wrapDarkDecls(theme.darkMode, dark.join(" "))}`;
+}
+function withColorVariables(theme) {
+  let changed = false;
+  const colors = {};
+  for (const [name, value] of Object.entries(theme.colors)) {
+    if (typeof value !== "string" && parseHexRgb(value.light) && parseHexRgb(value.dark)) {
+      colors[name] = `rgb(var(--kb-color-${name}))`;
+      changed = true;
+    } else {
+      colors[name] = value;
+    }
+  }
+  return changed ? { ...theme, colors } : theme;
+}
+var STYLE_ID = "kbach-colors";
+var injectedForTheme = null;
+function ensureColorVariablesInjected(theme) {
+  if (typeof document === "undefined") return;
+  if (injectedForTheme === theme) return;
+  injectedForTheme = theme;
+  const css = colorVariablesCss(theme);
+  let el = document.getElementById(STYLE_ID);
+  if (!css) {
+    el?.remove();
+    return;
+  }
+  if (!el) {
+    el = document.createElement("style");
+    el.id = STYLE_ID;
+    document.head.insertBefore(el, document.head.firstChild);
+  }
+  el.textContent = css;
+}
+
 // src/reset.ts
 var RESET_STYLE_ID = "kbach-reset";
 var RESET_RULES = [
@@ -550,27 +626,88 @@ function ensureResetInjected() {
 var KB_CACHE_MAX = 500;
 var kbCache = /* @__PURE__ */ new Map();
 var cachedForThemeJson = null;
+var engineThemeJson = "";
+var hasModeAware = false;
+function refreshEngineTheme() {
+  const theme = getTheme();
+  const withVars = withColorVariables(theme);
+  hasModeAware = withVars !== theme;
+  engineThemeJson = hasModeAware ? JSON.stringify(withVars) : getThemeJson();
+}
+var staticOwner = null;
+var staticSheet = null;
+var staticRuleCount = -1;
+var staticTokens = /* @__PURE__ */ new Set();
+function unescapeCssIdent(s) {
+  return s.replace(/\\([0-9a-fA-F]{1,6})\s?/g, (_, hex) => String.fromCodePoint(parseInt(hex, 16))).replace(/\\(.)/g, "$1");
+}
+function isStaticKbachSheet(sheet) {
+  try {
+    return Array.from(sheet.cssRules).some((r) => r instanceof CSSStyleRule && r.selectorText === ":root" && r.cssText.includes("--kb-dark-mode"));
+  } catch {
+    return false;
+  }
+}
+function collectClasses(rules, into) {
+  for (const r of Array.from(rules)) {
+    if (r instanceof CSSStyleRule) {
+      for (const m of r.selectorText.matchAll(/\.((?:\\[0-9a-fA-F]{1,6}\s?|\\.|[\w-])+)/g)) into.add(unescapeCssIdent(m[1]));
+    } else if ("cssRules" in r) {
+      collectClasses(r.cssRules, into);
+    }
+  }
+}
+function staticClasses() {
+  if (typeof document === "undefined") return staticTokens;
+  let sheet = staticOwner && staticOwner.sheet;
+  if (!sheet || !isStaticKbachSheet(sheet)) {
+    sheet = Array.from(document.styleSheets).find((s) => s !== styleEl?.sheet && isStaticKbachSheet(s)) ?? null;
+    staticOwner = sheet?.ownerNode ?? null;
+  }
+  if (!sheet) {
+    staticSheet = null;
+    staticTokens = /* @__PURE__ */ new Set();
+    return staticTokens;
+  }
+  if (sheet !== staticSheet || sheet.cssRules.length !== staticRuleCount) {
+    staticSheet = sheet;
+    staticRuleCount = sheet.cssRules.length;
+    staticTokens = /* @__PURE__ */ new Set();
+    collectClasses(sheet.cssRules, staticTokens);
+  }
+  return staticTokens;
+}
 function kb(classString) {
   const themeJson = getThemeJson();
   if (themeJson !== cachedForThemeJson) {
     kbCache.clear();
     cachedForThemeJson = themeJson;
+    refreshEngineTheme();
+  }
+  const statics = runtimeCSSDisabled ? null : staticClasses();
+  let toResolve = classString;
+  let alreadyStatic = "";
+  if (statics && statics.size > 0) {
+    const tokens = classString.split(/\s+/).filter(Boolean);
+    toResolve = tokens.filter((t) => !statics.has(t)).join(" ");
+    alreadyStatic = tokens.filter((t) => statics.has(t)).join(" ");
   }
-  let result = kbCache.get(classString);
+  let result = kbCache.get(toResolve);
   if (result === void 0) {
-    const json = generateCss(classString, themeJson);
+    const json = generateCss(toResolve, engineThemeJson);
     result = JSON.parse(json);
     if (kbCache.size >= KB_CACHE_MAX) kbCache.clear();
-    kbCache.set(classString, result);
+    kbCache.set(toResolve, result);
   }
   const { className, rules } = result;
   if (!runtimeCSSDisabled) {
     ensureResetInjected();
+    if (hasModeAware) ensureColorVariablesInjected(getTheme());
     for (const { rule, order } of rules) {
       injectRule(rule, order);
     }
   }
-  return className;
+  return alreadyStatic ? (alreadyStatic + " " + className).trim() : className;
 }
 
 // src/jsx-runtime.tsx

package/dist/jsx-runtime.mjs

@@ -2,9 +2,9 @@ import {
   Fragment,
   jsx,
   jsxs
-} from "./chunk-UP7MWEU5.mjs";
-import "./chunk-DJKDEDPE.mjs";
-import "./chunk-OVKVZA7B.mjs";
+} from "./chunk-6KXERZP3.mjs";
+import "./chunk-K6AUD64N.mjs";
+import "./chunk-FBYS4BI3.mjs";
 export {
   Fragment,
   jsx,

package/dist/postcss-plugin.js

@@ -34,6 +34,7 @@ __export(postcss_plugin_exports, {
 });
 module.exports = __toCommonJS(postcss_plugin_exports);
 var import_postcss = __toESM(require("postcss"));
+var import_fs3 = require("fs");
 var import_path5 = require("path");
 
 // src/staticCss/engine.ts
@@ -44,6 +45,9 @@ var import_node = require("@kbach/core-engine/node");
 function generateCssForToken(token, themeJson) {
   return JSON.parse((0, import_node.generate_css)(token, themeJson));
 }
+function suggestClassForToken(token, themeJson) {
+  return (0, import_node.suggest_class)(token, themeJson) || null;
+}
 
 // src/vite-plugin/scan.ts
 var import_fs = require("fs");
@@ -485,6 +489,59 @@ function buildResetCSS(usedTags) {
   return RESET_RULES.filter((r) => !r.tags || r.tags.some((t) => usedTags.has(t))).map((r) => r.css).join("\n");
 }
 
+// src/colorVariables.ts
+function parseHexRgb(hex) {
+  const m = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(hex.trim());
+  if (!m) return null;
+  let h = m[1];
+  if (h.length === 3) h = h.split("").map((c) => c + c).join("");
+  const n = parseInt(h, 16);
+  return [n >> 16 & 255, n >> 8 & 255, n & 255];
+}
+function wrapDarkDecls(strategy, decls) {
+  switch (strategy) {
+    case "class":
+      return `.dark { ${decls} }`;
+    case "media":
+      return `@media (prefers-color-scheme: dark) { :root { ${decls} } }`;
+    case "attribute":
+    default:
+      return `[data-theme="dark"] { ${decls} }`;
+  }
+}
+function modeAwareDecls(theme) {
+  const light = [];
+  const dark = [];
+  for (const [name, value] of Object.entries(theme.colors)) {
+    if (typeof value === "string") continue;
+    const l = parseHexRgb(value.light);
+    const d = parseHexRgb(value.dark);
+    if (!l || !d) continue;
+    light.push(`--kb-color-${name}: ${l.join(",")};`);
+    dark.push(`--kb-color-${name}: ${d.join(",")};`);
+  }
+  return { light, dark };
+}
+function colorVariablesCss(theme) {
+  const { light, dark } = modeAwareDecls(theme);
+  if (light.length === 0) return "";
+  return `:root { ${light.join(" ")} }
+${wrapDarkDecls(theme.darkMode, dark.join(" "))}`;
+}
+function withColorVariables(theme) {
+  let changed = false;
+  const colors = {};
+  for (const [name, value] of Object.entries(theme.colors)) {
+    if (typeof value !== "string" && parseHexRgb(value.light) && parseHexRgb(value.dark)) {
+      colors[name] = `rgb(var(--kb-color-${name}))`;
+      changed = true;
+    } else {
+      colors[name] = value;
+    }
+  }
+  return changed ? { ...theme, colors } : theme;
+}
+
 // src/vite-plugin/format.ts
 function formatKbachCSS(tokenRules, theme, usedTags) {
   const allEntries = [];
@@ -502,6 +559,8 @@ function formatKbachCSS(tokenRules, theme, usedTags) {
   lines.push("", ":root {", `  --kb-dark-mode: ${theme.darkMode};`);
   for (const [varName, val] of declarations) lines.push(`  ${varName}: ${val};`);
   lines.push("}");
+  const colorVars = colorVariablesCss(theme);
+  if (colorVars) lines.push("", prettifyCSS(colorVars));
   lines.push("", prettifyCSS(text));
   return lines.join("\n");
 }
@@ -560,17 +619,18 @@ function isMarkerClass(base) {
   if (slashIdx === -1) return false;
   return MARKER_CLASSES.has(base.slice(0, slashIdx)) && slashIdx < base.length - 1;
 }
-function warnIfUnknownClass(token, filePath, code, isResolvable, projectCssClasses, warnedTokens) {
+var TAILWIND_SHADE = /-(?:50|[1-9]00|950)(?:\/|$)/;
+function warnIfUnknownClass(token, filePath, code, isResolvable, projectCssClasses, warnedTokens, suggest) {
   if (isResolvable || warnedTokens.has(token)) return;
   const base = stripModifierPrefix(token);
   if (!base || projectCssClasses.has(base) || isMarkerClass(base)) return;
   warnedTokens.add(token);
   const pos = findLineCol(code, token);
   const location = pos ? `${blue(filePath)}${green(`:${pos.line}:${pos.column}`)}` : blue(filePath);
-  console.warn(
-    `${kbachTag()} ${gray("Unknown class")} ${highlight(token)} ${gray("\u2014 no Kbach utility or project CSS rule matches it. Typo?")}
-  ${bold("at")} ${location}`
-  );
+  const suggestion = suggest?.(token) ?? null;
+  const hint = suggestion ? `${gray("\u2014 did you mean")} ${highlight(suggestion)}${gray("?")}${TAILWIND_SHADE.test(token) ? gray(" Kbach color shades run 1\u201312, not 50\u2013950.") : ""}` : gray("\u2014 no Kbach utility or project CSS rule matches it. Typo?");
+  console.warn(`${kbachTag()} ${gray("Unknown class")} ${highlight(token)} ${hint}
+  ${bold("at")} ${location}`);
 }
 
 // src/staticCss/engine.ts
@@ -580,7 +640,8 @@ function normPath(p) {
 }
 var SAFELIST_KEY = "\0kbach-safelist";
 function createKbachStaticCssEngine(options) {
-  const { root, theme, themeJson, includeDirs, safelist } = options;
+  const { root, theme, includeDirs, safelist } = options;
+  const themeJson = JSON.stringify(withColorVariables(theme));
   const fileTokens = /* @__PURE__ */ new Map();
   const tokenRules = /* @__PURE__ */ new Map();
   const fileTags = /* @__PURE__ */ new Map();
@@ -598,7 +659,7 @@ function createKbachStaticCssEngine(options) {
       tokens.add(tok);
       const rules = resolveToken(tok);
       if (process.env.NODE_ENV !== "production") {
-        warnIfUnknownClass(tok, filePath, code, rules.length > 0, projectCssClasses, warnedTokens);
+        warnIfUnknownClass(tok, filePath, code, rules.length > 0, projectCssClasses, warnedTokens, (t) => suggestClassForToken(t, themeJson));
       }
     }
     fileTokens.set(normPath(filePath), tokens);
@@ -1037,16 +1098,6 @@ function detectDarkModeStrategyFromDom() {
   setTheme({ ...activeTheme, darkMode: raw });
 }
 
-// src/colorVariables.ts
-function parseHexRgb(hex) {
-  const m = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(hex.trim());
-  if (!m) return null;
-  let h = m[1];
-  if (h.length === 3) h = h.split("").map((c) => c + c).join("");
-  const n = parseInt(h, 16);
-  return [n >> 16 & 255, n >> 8 & 255, n & 255];
-}
-
 // src/darkModeStore.ts
 var STORAGE_KEY = "kbach-theme";
 var listeners = /* @__PURE__ */ new Set();
@@ -1111,7 +1162,13 @@ function applyOpacityToHex(hex, opacityText) {
   return `rgba(${rgb.join(",")},${clamped})`;
 }
 function resolveColorEntry(value, lookup) {
-  if (typeof value !== "string") return value;
+  if (typeof value !== "string") {
+    const side = (v, mode2) => {
+      const r = resolveColorEntry(v, lookup);
+      return typeof r === "string" ? r : r[mode2];
+    };
+    return { light: side(value.light, "light"), dark: side(value.dark, "dark") };
+  }
   const slash = value.indexOf("/");
   const name = slash === -1 ? value : value.slice(0, slash);
   const opacity = slash === -1 ? void 0 : value.slice(slash + 1);
@@ -1176,11 +1233,21 @@ function isEsmRequireFailure(err) {
   return err.code === "ERR_REQUIRE_ESM" || /is not defined in ES module scope/.test(err.message);
 }
 async function importConfigModule(path) {
-  const mod = await import((0, import_url.pathToFileURL)(path).href);
+  const url = (0, import_url.pathToFileURL)(path).href;
+  let mod;
+  try {
+    mod = await nativeImport(url + "?t=" + Date.now());
+  } catch (err) {
+    if (err.code !== "ERR_VM_DYNAMIC_IMPORT_CALLBACK_MISSING") throw err;
+    mod = await import(url);
+  }
   return mod.default ?? mod;
 }
+var nativeImport = new Function("url", "return import(url)");
 function requireConfigModule(root, path) {
-  const mod = (0, import_module.createRequire)(root)(path);
+  const req = (0, import_module.createRequire)(root);
+  delete req.cache[req.resolve(path)];
+  const mod = req(path);
   return mod.default ?? mod;
 }
 async function loadConfigFile(root) {
@@ -1190,6 +1257,7 @@ async function loadConfigFile(root) {
   if ((0, import_fs2.existsSync)(mjsPath)) return importConfigModule(mjsPath);
   const jsPath = (0, import_path4.join)(root, "kbach.config.js");
   if (!(0, import_fs2.existsSync)(jsPath)) return void 0;
+  if (isEsmProject(root)) return importConfigModule(jsPath);
   try {
     return requireConfigModule(root, jsPath);
   } catch (err) {
@@ -1197,6 +1265,13 @@ async function loadConfigFile(root) {
     return importConfigModule(jsPath);
   }
 }
+function isEsmProject(root) {
+  try {
+    return JSON.parse((0, import_fs2.readFileSync)((0, import_path4.join)(root, "package.json"), "utf-8")).type === "module";
+  } catch {
+    return false;
+  }
+}
 async function resolveEffectiveTheme(root, options) {
   if (options.theme) return options.theme;
   if (options.config) return resolveKbachConfig(options.config);
@@ -1251,7 +1326,6 @@ function kbachPostcss(options = {}) {
       const engine = createKbachStaticCssEngine({
         root: projectRoot,
         theme,
-        themeJson: JSON.stringify(theme),
         includeDirs,
         safelist
       });
@@ -1266,6 +1340,10 @@ function kbachPostcss(options = {}) {
           glob: "**/*"
         });
       }
+      for (const name of ["kbach.config.js", "kbach.config.mjs", "kbach.config.cjs"]) {
+        const file = (0, import_path5.resolve)(projectRoot, name);
+        if ((0, import_fs3.existsSync)(file)) result.messages.push({ type: "dependency", plugin: "kbach", file });
+      }
       spliceGeneratedCss(root, engine.generateCSS());
     }
   };

package/dist/postcss-plugin.mjs

@@ -6,12 +6,13 @@ import {
   highlight,
   kbachTag,
   resolveEffectiveTheme
-} from "./chunk-KTRJZDVE.mjs";
-import "./chunk-43FOLRQA.mjs";
-import "./chunk-OVKVZA7B.mjs";
+} from "./chunk-NHWKWY2T.mjs";
+import "./chunk-UK5S55DF.mjs";
+import "./chunk-FBYS4BI3.mjs";
 
 // src/postcss-plugin/index.ts
 import postcss from "postcss";
+import { existsSync } from "fs";
 import { resolve as resolvePath } from "path";
 var KBACH_START_TEXT = "kbach:start";
 var KBACH_END_TEXT = "kbach:end";
@@ -59,7 +60,6 @@ function kbachPostcss(options = {}) {
       const engine = createKbachStaticCssEngine({
         root: projectRoot,
         theme,
-        themeJson: JSON.stringify(theme),
         includeDirs,
         safelist
       });
@@ -74,6 +74,10 @@ function kbachPostcss(options = {}) {
           glob: "**/*"
         });
       }
+      for (const name of ["kbach.config.js", "kbach.config.mjs", "kbach.config.cjs"]) {
+        const file = resolvePath(projectRoot, name);
+        if (existsSync(file)) result.messages.push({ type: "dependency", plugin: "kbach", file });
+      }
       spliceGeneratedCss(root, engine.generateCSS());
     }
   };

package/dist/vite-plugin.d.mts

@@ -64,6 +64,8 @@ interface KbachPluginOptions {
 declare function findMainCSSFile(root: string, includeDirs: string[], explicitCssFile?: string): string;
 declare const DEFAULT_SCAN_DIRS: string[];
 declare const CSS_SYNC_DEBOUNCE_MS = 50;
+/** `kbach.config.js` / `.mjs` / `.cjs` directly in `root`. */
+declare function isConfigFile(root: string, file: string): boolean;
 /**
  * Auto-discovers a `kbach.config.*` file at the project root — `undefined`
  * if none exists (the common case: most projects have no customization at
@@ -127,4 +129,4 @@ declare function resolveEffectiveTheme(root: string, options: {
  */
 declare function kbach(options?: KbachPluginOptions): Plugin;
 
-export { CSS_SYNC_DEBOUNCE_MS, DEFAULT_SCAN_DIRS, type KbachPluginOptions, findMainCSSFile, kbach, loadConfigFile, resolveEffectiveTheme };
+export { CSS_SYNC_DEBOUNCE_MS, DEFAULT_SCAN_DIRS, type KbachPluginOptions, findMainCSSFile, isConfigFile, kbach, loadConfigFile, resolveEffectiveTheme };

package/dist/vite-plugin.d.ts

@@ -64,6 +64,8 @@ interface KbachPluginOptions {
 declare function findMainCSSFile(root: string, includeDirs: string[], explicitCssFile?: string): string;
 declare const DEFAULT_SCAN_DIRS: string[];
 declare const CSS_SYNC_DEBOUNCE_MS = 50;
+/** `kbach.config.js` / `.mjs` / `.cjs` directly in `root`. */
+declare function isConfigFile(root: string, file: string): boolean;
 /**
  * Auto-discovers a `kbach.config.*` file at the project root — `undefined`
  * if none exists (the common case: most projects have no customization at
@@ -127,4 +129,4 @@ declare function resolveEffectiveTheme(root: string, options: {
  */
 declare function kbach(options?: KbachPluginOptions): Plugin;
 
-export { CSS_SYNC_DEBOUNCE_MS, DEFAULT_SCAN_DIRS, type KbachPluginOptions, findMainCSSFile, kbach, loadConfigFile, resolveEffectiveTheme };
+export { CSS_SYNC_DEBOUNCE_MS, DEFAULT_SCAN_DIRS, type KbachPluginOptions, findMainCSSFile, isConfigFile, kbach, loadConfigFile, resolveEffectiveTheme };