@kbach/react 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/vite-plugin.js

@@ -20,120 +20,18 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/vite-plugin/index.ts
 var vite_plugin_exports = {};
 __export(vite_plugin_exports, {
-  kbach: () => kbach
+  CSS_SYNC_DEBOUNCE_MS: () => CSS_SYNC_DEBOUNCE_MS,
+  DEFAULT_SCAN_DIRS: () => DEFAULT_SCAN_DIRS,
+  findMainCSSFile: () => findMainCSSFile,
+  kbach: () => kbach,
+  loadConfigFile: () => loadConfigFile,
+  resolveEffectiveTheme: () => resolveEffectiveTheme
 });
 module.exports = __toCommonJS(vite_plugin_exports);
-var import_fs2 = require("fs");
-var import_path3 = require("path");
-
-// src/vite-plugin/wasmNode.ts
-var import_node = require("@kbach/core-engine/node");
-function generateCssForToken(token, themeJson) {
-  return JSON.parse((0, import_node.generate_css)(token, themeJson));
-}
-
-// src/vite-plugin/scan.ts
-var import_fs = require("fs");
-var import_path = require("path");
-function splitClassTokens(str) {
-  return str.split(/\s+/).filter(Boolean);
-}
-var NOT_A_CLASS_NAME_RE = /[${}]|-$|^[?:&|!"'=<>]+$/;
-function pushTokens(str, into) {
-  for (const tok of splitClassTokens(str)) {
-    if (tok && !NOT_A_CLASS_NAME_RE.test(tok)) into.add(tok);
-  }
-}
-function pushTemplateLiteralBody(body, into) {
-  const interpolationRe = /\$\{(?:[^{}]|\{[^{}]*\})*\}/g;
-  let im;
-  while ((im = interpolationRe.exec(body)) !== null) {
-    pushClassLikeStrings(im[0], into);
-  }
-  pushTokens(body.replace(/\$\{(?:[^{}]|\{[^{}]*\})*\}/g, () => "$"), into);
-}
-function pushClassLikeStrings(text, into) {
-  const quotedStringRe = /(["'`])((?:(?!\1).)*)\1/g;
-  let qm;
-  while ((qm = quotedStringRe.exec(text)) !== null) {
-    const [, quote, content] = qm;
-    if (quote === "`") pushTemplateLiteralBody(content, into);
-    else pushTokens(content, into);
-  }
-}
-var JSX_TAG_RE = /<([a-z][a-zA-Z0-9]*)[\s/>]/g;
-function scanUsedTags(code) {
-  const tags = /* @__PURE__ */ new Set();
-  let m;
-  JSX_TAG_RE.lastIndex = 0;
-  while ((m = JSX_TAG_RE.exec(code)) !== null) tags.add(m[1]);
-  return tags;
-}
-function extractClassStrings(code) {
-  const found = /* @__PURE__ */ new Set();
-  const simpleRe = /(?:className|kb)=(["'])((?:(?!\1).)*)\1/g;
-  let m;
-  while ((m = simpleRe.exec(code)) !== null) pushTokens(m[2], found);
-  const jsxExprRe = /(?:className|kb)=\{/g;
-  while ((m = jsxExprRe.exec(code)) !== null) {
-    let depth = 1;
-    let i = m.index + m[0].length;
-    let block = "";
-    while (i < code.length && depth > 0) {
-      const ch = code[i];
-      if (ch === "{") depth++;
-      else if (ch === "}") {
-        if (--depth === 0) break;
-      }
-      block += ch;
-      i++;
-    }
-    jsxExprRe.lastIndex = i + 1;
-    pushClassLikeStrings(block, found);
-  }
-  const classComposerCallRe = /(?:clsx|cn|classnames|cx|kb)\(/g;
-  while ((m = classComposerCallRe.exec(code)) !== null) {
-    let depth = 1;
-    let i = m.index + m[0].length;
-    let block = "";
-    while (i < code.length && depth > 0) {
-      const ch = code[i];
-      if (ch === "(") depth++;
-      else if (ch === ")") {
-        if (--depth === 0) break;
-      }
-      block += ch;
-      i++;
-    }
-    classComposerCallRe.lastIndex = i + 1;
-    pushClassLikeStrings(block, found);
-  }
-  const templateRe = /`([^`]{1,2000})`/g;
-  while ((m = templateRe.exec(code)) !== null) pushTemplateLiteralBody(m[1], found);
-  return [...found];
-}
-var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "build", "out", ".next", ".output", ".git", ".svn", ".cache", "coverage"]);
-var MAX_SCAN_DEPTH = 10;
-var DEFAULT_FILE_MATCH = /\.(tsx?|jsx?)$/;
-function scanDir(dir, onFile, depth = 0, fileMatch = DEFAULT_FILE_MATCH) {
-  if (depth > MAX_SCAN_DEPTH) return;
-  let entries;
-  try {
-    entries = (0, import_fs.readdirSync)(dir);
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    if (entry.startsWith(".") || SKIP_DIRS.has(entry)) continue;
-    const full = (0, import_path.join)(dir, entry);
-    try {
-      const st = (0, import_fs.statSync)(full);
-      if (st.isDirectory()) scanDir(full, onFile, depth + 1, fileMatch);
-      else if (fileMatch.test(entry)) onFile(full, (0, import_fs.readFileSync)(full, "utf-8"));
-    } catch {
-    }
-  }
-}
+var import_fs3 = require("fs");
+var import_path4 = require("path");
+var import_url = require("url");
+var import_module = require("module");
 
 // src/vite-plugin/cssVars.ts
 function hexToRgbTriplet(hex) {
@@ -395,10 +293,10 @@ function formatKbachCSS(tokenRules, theme, usedTags) {
   lines.push("", prettifyCSS(text));
   return lines.join("\n");
 }
-function writeKbachToFile(filePath, css, readFile2, writeFile2) {
+function writeKbachToFile(filePath, css, readFile, writeFile) {
   let existing = "";
   try {
-    existing = readFile2(filePath);
+    existing = readFile(filePath);
   } catch {
   }
   const block = `${KBACH_START}
@@ -410,66 +308,10 @@ ${KBACH_END}`;
 
 ${block}` : block;
   if (next === existing) return false;
-  writeFile2(filePath, next);
+  writeFile(filePath, next);
   return true;
 }
 
-// src/vite-plugin/unknownClassWarnings.ts
-var import_path2 = require("path");
-var CSS_CLASS_SELECTOR_RE = /\.(-?[a-zA-Z_][a-zA-Z0-9_-]*)/g;
-var CSS_FILE_RE = /\.(css|scss|sass|less)$/;
-var useColor = !!process.stdout?.isTTY && !process.env.NO_COLOR;
-var paint = (code, s) => useColor ? `\x1B[${code}m${s}\x1B[0m` : s;
-var green = (s) => paint("32", s);
-var blue = (s) => paint("34", s);
-var white = (s) => paint("97", s);
-var gray = (s) => paint("90", s);
-var bold = (s) => paint("1", s);
-var ARROW = () => green("\u2192");
-var TAG = () => bold(green("[kbach]"));
-var highlight = (s) => bold(white(s));
-function findLineCol(code, needle) {
-  const index = code.indexOf(needle);
-  if (index === -1) return null;
-  let line = 1;
-  let lastNewline = -1;
-  for (let i = 0; i < index; i++) {
-    if (code.charCodeAt(i) === 10) {
-      line++;
-      lastNewline = i;
-    }
-  }
-  return { line, column: index - lastNewline };
-}
-function scanCssFileInto(code, into) {
-  const re = new RegExp(CSS_CLASS_SELECTOR_RE.source, "g");
-  let m;
-  while ((m = re.exec(code)) !== null) into.add(m[1]);
-}
-function scanProjectCssSelectors(root, includeDirs) {
-  const projectCssClasses = /* @__PURE__ */ new Set();
-  for (const dir of includeDirs) {
-    scanDir((0, import_path2.join)(root, dir), (_filePath, code) => scanCssFileInto(code, projectCssClasses), 0, CSS_FILE_RE);
-  }
-  return projectCssClasses;
-}
-function stripModifierPrefix(token) {
-  return token.replace(/^(?:[a-zA-Z0-9_/-]+:)+/, "");
-}
-var MARKER_CLASSES = /* @__PURE__ */ new Set(["group", "peer"]);
-function warnIfUnknownClass(token, filePath, code, isResolvable, projectCssClasses, warnedTokens) {
-  if (isResolvable || warnedTokens.has(token)) return;
-  const base = stripModifierPrefix(token);
-  if (!base || projectCssClasses.has(base) || MARKER_CLASSES.has(base)) return;
-  warnedTokens.add(token);
-  const pos = findLineCol(code, token);
-  const location = pos ? `${blue(filePath)}${green(`:${pos.line}:${pos.column}`)}` : blue(filePath);
-  console.warn(
-    `${ARROW()} ${TAG()} ${gray("Unknown class")} ${highlight(token)} ${gray("\u2014 no Kbach utility or project CSS rule matches it. Typo?")}
-  ${bold("at")} ${location}`
-  );
-}
-
 // src/vite-plugin/classNameHints.ts
 var STRUCTURAL_TOKENS = [
   // layout.rs
@@ -1017,6 +859,41 @@ var STRUCTURAL_TOKENS = [
   "aria-required:",
   "aria-selected:",
   "aria-busy:",
+  // registry.rs modifiers, added later — same "fixed/static, finite" bar
+  // as the Phase 24 block above. Structural -of-type/empty, form-state and
+  // validation pseudo-classes, other native pseudo-classes with no aria-*
+  // counterpart, a pseudo-element, pointer media variants, and the
+  // direct-children/all-descendants variants. "supports-[...]:"/"in-*:" are
+  // deliberately excluded here for the same "no finite enumerable set"
+  // reason as has-[...]:/group-<pseudo>: above.
+  "first-of-type:",
+  "last-of-type:",
+  "only-of-type:",
+  "empty:",
+  "enabled:",
+  "read-only:",
+  "required:",
+  "optional:",
+  "valid:",
+  "invalid:",
+  "in-range:",
+  "out-of-range:",
+  "default:",
+  "indeterminate:",
+  "placeholder-shown:",
+  "autofill:",
+  "user-valid:",
+  "user-invalid:",
+  "target:",
+  "fullscreen:",
+  "popover-open:",
+  "details-content:",
+  "pointer-coarse:",
+  "pointer-fine:",
+  "any-pointer-coarse:",
+  "any-pointer-fine:",
+  "*:",
+  "**:",
   // Phase 25 (container queries & arbitrary properties). "@container" is a
   // real UTILITY (container-type: inline-size), not a modifier — included
   // as a bare token like "flex"/"hidden" above, not with the trailing ":"
@@ -1424,14 +1301,15 @@ var defaultTheme = {
   // Real Tailwind's default spacing scale in full — every step is exactly
   // `n * 4px` (Tailwind's base spacing unit), including the fractional
   // `.5` steps (`1.5` -> 6px, `2.5` -> 10px, `3.5` -> 14px) and the "px"
-  // literal (a bare 1px, for `p-px`-style hairline spacing). Previously
-  // this only had {0,1,2,4,6,8} — a handful of spot-checked values, not
-  // the real scale — so anything else (`p-3`, `w-5`, `border-2`, `gap-10`,
-  // ...) silently failed to resolve (an unknown spacing key returns `None`
-  // the same way an unknown class does, with no error). "0" itself is
-  // still needed explicitly (not derivable as "any number * 4") for the
-  // same reason it always was: `sticky top-0` needs an actual "0" key to
-  // resolve at all, not just fall through as unresolvable.
+  // literal (a bare 1px, for `p-px`-style hairline spacing). This table is
+  // only the "usual stops", though — the Rust/JS engines' shared
+  // `spacing_px`/`spacingPx` helper falls back to Tailwind v4's own live
+  // `n * 4px` formula for any bare numeric step NOT listed here (`p-0.25`,
+  // `gap-1.75`, `w-13`, ...), so this table exists to name the common
+  // values and give a theme customization something to override, not to
+  // enumerate every resolvable step. "px" is the one exception that must
+  // stay listed explicitly — it isn't a number, so the formula can't
+  // derive it.
   spacing: {
     "0": 0,
     "px": 1,
@@ -1476,33 +1354,350 @@ var defaultTheme = {
     xl: 1280,
     "2xl": 1536
   },
-  darkMode: "attribute"
+  // Byte-for-byte the same three stacks
+  // packages/core-engine/src/resolvers/typography.rs's `font_family_value`
+  // falls back to — kept here too (rather than leaving this empty and
+  // relying purely on the Rust-side fallback) so `defaultTheme.fontFamily.sans`
+  // is a real, readable value for anything that wants to extend rather
+  // than replace it (see `KbachConfig.extend.fontFamily` in config.ts).
+  fontFamily: {
+    sans: 'ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"',
+    serif: 'ui-serif, Georgia, Cambria, "Times New Roman", Times, serif',
+    mono: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace'
+  },
+  // Matches real Tailwind's own default (`darkMode: 'media'`): pure
+  // `@media (prefers-color-scheme: dark)`, works with zero JS — a project
+  // using only static `className` strings gets working `dark:` classes
+  // out of the box, with no runtime import required to write `data-theme`/
+  // `.dark` onto `<html>` (see darkModeStore.ts's `applyToDom`). The
+  // tradeoff: `'media'` can't be overridden by a manual light/dark toggle —
+  // `useTheme()`/`toggleGlobalDarkMode()` still track `isDark` correctly
+  // for JS consumers, but flipping it has no visible effect on `dark:`
+  // classes, since the browser's media query only ever reflects the real
+  // OS setting. Opt into `darkMode: 'class'` or `'attribute'` explicitly
+  // (via `kbach.config.js` or the `config`/`theme` plugin option) as soon
+  // as an app wants a real in-app toggle.
+  darkMode: "media",
+  // Empty by default, matching real Tailwind's own defaults (no forced
+  // centering/padding) — see `ContainerConfig`'s own doc comment.
+  container: {}
 };
 var activeThemeJson = JSON.stringify(defaultTheme);
 
-// src/vite-plugin/index.ts
-var DEFAULT_SCAN_DIRS = ["src", "app", "pages", "components"];
+// 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/config.ts
+function applyOpacityToHex(hex, opacityText) {
+  const rgb = parseHexRgb(hex);
+  if (!rgb) return hex;
+  const a = Number(opacityText) / 100;
+  const clamped = Number.isFinite(a) ? Math.min(1, Math.max(0, a)) : 1;
+  return `rgba(${rgb.join(",")},${clamped})`;
+}
+function resolveColorEntry(value, lookup) {
+  if (typeof value !== "string") return value;
+  const slash = value.indexOf("/");
+  const name = slash === -1 ? value : value.slice(0, slash);
+  const opacity = slash === -1 ? void 0 : value.slice(slash + 1);
+  const base = lookup(name);
+  if (base === void 0) return value;
+  if (opacity === void 0) return base;
+  return typeof base === "string" ? applyOpacityToHex(base, opacity) : { light: applyOpacityToHex(base.light, opacity), dark: applyOpacityToHex(base.dark, opacity) };
+}
+function resolveColors(extend, existing) {
+  const resolved = {};
+  const lookup = (name) => resolved[name] ?? existing[name];
+  for (const [name, value] of Object.entries(extend)) {
+    resolved[name] = resolveColorEntry(value, lookup);
+  }
+  return resolved;
+}
+function resolveKbachConfig(config) {
+  let theme = { ...defaultTheme, ...config.theme };
+  if (config.extend?.colors) {
+    theme = { ...theme, colors: { ...theme.colors, ...resolveColors(config.extend.colors, theme.colors) } };
+  }
+  if (config.extend?.spacing) {
+    theme = { ...theme, spacing: { ...theme.spacing, ...config.extend.spacing } };
+  }
+  if (config.extend?.screens) {
+    theme = { ...theme, screens: { ...theme.screens, ...config.extend.screens } };
+  }
+  if (config.extend?.fontFamily) {
+    theme = { ...theme, fontFamily: { ...theme.fontFamily, ...config.extend.fontFamily } };
+  }
+  if (config.extend?.container) {
+    theme = { ...theme, container: { ...theme.container, ...config.extend.container } };
+  }
+  if (config.darkMode) {
+    theme = { ...theme, darkMode: config.darkMode };
+  }
+  return theme;
+}
+
+// src/staticCss/engine.ts
+var import_fs2 = require("fs");
+var import_path3 = require("path");
+
+// src/vite-plugin/wasmNode.ts
+var import_node = require("@kbach/core-engine/node");
+function generateCssForToken(token, themeJson) {
+  return JSON.parse((0, import_node.generate_css)(token, themeJson));
+}
+
+// src/vite-plugin/scan.ts
+var import_fs = require("fs");
+var import_path = require("path");
+function stripComments(code) {
+  let out = "";
+  let i = 0;
+  const n = code.length;
+  while (i < n) {
+    const two = code[i] + (code[i + 1] ?? "");
+    if (two === "//") {
+      i += 2;
+      while (i < n && code[i] !== "\n") i++;
+      continue;
+    }
+    if (two === "/*") {
+      i += 2;
+      while (i < n && code[i] + (code[i + 1] ?? "") !== "*/") i++;
+      i += 2;
+      continue;
+    }
+    const ch = code[i];
+    if (ch === '"' || ch === "'") {
+      out += ch;
+      i++;
+      while (i < n && code[i] !== ch) {
+        if (code[i] === "\\") {
+          out += code[i] + (code[i + 1] ?? "");
+          i += 2;
+          continue;
+        }
+        out += code[i];
+        i++;
+      }
+      out += code[i] ?? "";
+      i++;
+      continue;
+    }
+    if (ch === "`") {
+      out += ch;
+      i++;
+      let interpolationDepth = 0;
+      while (i < n) {
+        if (interpolationDepth === 0 && code[i] === "`") {
+          out += code[i];
+          i++;
+          break;
+        }
+        if (interpolationDepth === 0 && code[i] === "\\") {
+          out += code[i] + (code[i + 1] ?? "");
+          i += 2;
+          continue;
+        }
+        if (interpolationDepth === 0 && code[i] + (code[i + 1] ?? "") === "${") {
+          out += "${";
+          i += 2;
+          interpolationDepth = 1;
+          continue;
+        }
+        if (interpolationDepth > 0) {
+          if (code[i] === "{") interpolationDepth++;
+          else if (code[i] === "}") {
+            interpolationDepth--;
+            if (interpolationDepth === 0) {
+              out += "}";
+              i++;
+              continue;
+            }
+          }
+        }
+        out += code[i];
+        i++;
+      }
+      continue;
+    }
+    out += ch;
+    i++;
+  }
+  return out;
+}
+function splitClassTokens(str) {
+  return str.split(/\s+/).filter(Boolean);
+}
+var NOT_A_CLASS_NAME_RE = /[${}]|-$|^[?:&|!"'=<>]+$/;
+function pushTokens(str, into) {
+  for (const tok of splitClassTokens(str)) {
+    if (tok && !NOT_A_CLASS_NAME_RE.test(tok)) into.add(tok);
+  }
+}
+function pushTemplateLiteralBody(body, into) {
+  const interpolationRe = /\$\{(?:[^{}]|\{[^{}]*\})*\}/g;
+  let im;
+  while ((im = interpolationRe.exec(body)) !== null) {
+    pushClassLikeStrings(im[0], into);
+  }
+  pushTokens(body.replace(/\$\{(?:[^{}]|\{[^{}]*\})*\}/g, () => "$"), into);
+}
+function pushClassLikeStrings(text, into) {
+  const quotedStringRe = /(["'`])((?:(?!\1).)*)\1/g;
+  let qm;
+  while ((qm = quotedStringRe.exec(text)) !== null) {
+    const [, quote, content] = qm;
+    if (quote === "`") pushTemplateLiteralBody(content, into);
+    else pushTokens(content, into);
+  }
+}
+var JSX_TAG_RE = /<([a-z][a-zA-Z0-9]*)[\s/>]/g;
+function scanUsedTags(code) {
+  const cleaned = stripComments(code);
+  const tags = /* @__PURE__ */ new Set();
+  let m;
+  JSX_TAG_RE.lastIndex = 0;
+  while ((m = JSX_TAG_RE.exec(cleaned)) !== null) tags.add(m[1]);
+  return tags;
+}
+function extractClassStrings(rawCode) {
+  const code = stripComments(rawCode);
+  const found = /* @__PURE__ */ new Set();
+  const simpleRe = /(?:className|kb)=(["'])((?:(?!\1).)*)\1/g;
+  let m;
+  while ((m = simpleRe.exec(code)) !== null) pushTokens(m[2], found);
+  const jsxExprRe = /(?:className|kb)=\{/g;
+  while ((m = jsxExprRe.exec(code)) !== null) {
+    let depth = 1;
+    let i = m.index + m[0].length;
+    let block = "";
+    while (i < code.length && depth > 0) {
+      const ch = code[i];
+      if (ch === "{") depth++;
+      else if (ch === "}") {
+        if (--depth === 0) break;
+      }
+      block += ch;
+      i++;
+    }
+    jsxExprRe.lastIndex = i + 1;
+    pushClassLikeStrings(block, found);
+  }
+  const classComposerCallRe = /(?:clsx|cn|classnames|cx|kb)\(/g;
+  while ((m = classComposerCallRe.exec(code)) !== null) {
+    let depth = 1;
+    let i = m.index + m[0].length;
+    let block = "";
+    while (i < code.length && depth > 0) {
+      const ch = code[i];
+      if (ch === "(") depth++;
+      else if (ch === ")") {
+        if (--depth === 0) break;
+      }
+      block += ch;
+      i++;
+    }
+    classComposerCallRe.lastIndex = i + 1;
+    pushClassLikeStrings(block, found);
+  }
+  const templateRe = /`([^`]{1,2000})`/g;
+  while ((m = templateRe.exec(code)) !== null) pushTemplateLiteralBody(m[1], found);
+  return [...found];
+}
+var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "build", "out", ".next", ".output", ".git", ".svn", ".cache", "coverage"]);
+var MAX_SCAN_DEPTH = 10;
+var DEFAULT_FILE_MATCH = /\.(tsx?|jsx?)$/;
+function scanDir(dir, onFile, depth = 0, fileMatch = DEFAULT_FILE_MATCH) {
+  if (depth > MAX_SCAN_DEPTH) return;
+  let entries;
+  try {
+    entries = (0, import_fs.readdirSync)(dir);
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (entry.startsWith(".") || SKIP_DIRS.has(entry)) continue;
+    const full = (0, import_path.join)(dir, entry);
+    try {
+      const st = (0, import_fs.statSync)(full);
+      if (st.isDirectory()) scanDir(full, onFile, depth + 1, fileMatch);
+      else if (fileMatch.test(entry)) onFile(full, (0, import_fs.readFileSync)(full, "utf-8"));
+    } catch {
+    }
+  }
+}
+
+// src/vite-plugin/unknownClassWarnings.ts
+var import_path2 = require("path");
+var CSS_CLASS_SELECTOR_RE = /\.(-?[a-zA-Z_][a-zA-Z0-9_-]*)/g;
+var CSS_FILE_RE = /\.(css|scss|sass|less)$/;
+var useColor = !!process.stdout?.isTTY && !process.env.NO_COLOR;
+var paint = (code, s) => useColor ? `\x1B[${code}m${s}\x1B[0m` : s;
+var green = (s) => paint("32", s);
+var blue = (s) => paint("34", s);
+var white = (s) => paint("97", s);
+var gray = (s) => paint("90", s);
+var bold = (s) => paint("1", s);
+var ARROW = () => green("\u2192");
+var TAG = () => bold(green("[kbach]"));
+var highlight = (s) => bold(white(s));
+function findLineCol(code, needle) {
+  const index = code.indexOf(needle);
+  if (index === -1) return null;
+  let line = 1;
+  let lastNewline = -1;
+  for (let i = 0; i < index; i++) {
+    if (code.charCodeAt(i) === 10) {
+      line++;
+      lastNewline = i;
+    }
+  }
+  return { line, column: index - lastNewline };
+}
+function scanCssFileInto(code, into) {
+  const re = new RegExp(CSS_CLASS_SELECTOR_RE.source, "g");
+  let m;
+  while ((m = re.exec(code)) !== null) into.add(m[1]);
+}
+function scanProjectCssSelectors(root, includeDirs) {
+  const projectCssClasses = /* @__PURE__ */ new Set();
+  for (const dir of includeDirs) {
+    scanDir((0, import_path2.join)(root, dir), (_filePath, code) => scanCssFileInto(code, projectCssClasses), 0, CSS_FILE_RE);
+  }
+  return projectCssClasses;
+}
+function stripModifierPrefix(token) {
+  return token.replace(/^(?:[a-zA-Z0-9_/-]+:)+/, "");
+}
+var MARKER_CLASSES = /* @__PURE__ */ new Set(["group", "peer"]);
+function warnIfUnknownClass(token, filePath, code, isResolvable, projectCssClasses, warnedTokens) {
+  if (isResolvable || warnedTokens.has(token)) return;
+  const base = stripModifierPrefix(token);
+  if (!base || projectCssClasses.has(base) || MARKER_CLASSES.has(base)) return;
+  warnedTokens.add(token);
+  const pos = findLineCol(code, token);
+  const location = pos ? `${blue(filePath)}${green(`:${pos.line}:${pos.column}`)}` : blue(filePath);
+  console.warn(
+    `${ARROW()} ${TAG()} ${gray("Unknown class")} ${highlight(token)} ${gray("\u2014 no Kbach utility or project CSS rule matches it. Typo?")}
+  ${bold("at")} ${location}`
+  );
+}
+
+// src/staticCss/engine.ts
 function normPath(p) {
   const fwd = p.replace(/\\/g, "/");
   return process.platform === "win32" ? fwd.toLowerCase() : fwd;
 }
 var SAFELIST_KEY = "\0kbach-safelist";
-function readFile(path) {
-  return (0, import_fs2.readFileSync)(path, "utf-8");
-}
-function writeFile(path, content) {
-  (0, import_fs2.writeFileSync)(path, content, "utf-8");
-}
-function writeFileEnsuringDir(path, content) {
-  (0, import_fs2.mkdirSync)((0, import_path3.dirname)(path), { recursive: true });
-  (0, import_fs2.writeFileSync)(path, content, "utf-8");
-}
-function kbach(options = {}) {
-  const theme = options.theme ?? defaultTheme;
-  const themeJson = JSON.stringify(theme);
-  const includeDirs = options.include ?? DEFAULT_SCAN_DIRS;
-  const safelist = options.safelist ?? [];
-  let root = process.cwd();
+function createKbachStaticCssEngine(options) {
+  const { root, theme, themeJson, includeDirs, safelist } = options;
   const fileTokens = /* @__PURE__ */ new Map();
   const tokenRules = /* @__PURE__ */ new Map();
   const fileTags = /* @__PURE__ */ new Map();
@@ -1526,6 +1721,10 @@ function kbach(options = {}) {
     fileTokens.set(normPath(filePath), tokens);
     fileTags.set(normPath(filePath), scanUsedTags(code));
   }
+  function removeFile(filePath) {
+    fileTokens.delete(normPath(filePath));
+    fileTags.delete(normPath(filePath));
+  }
   function processSafelist() {
     if (safelist.length === 0) return;
     const tokens = new Set(safelist);
@@ -1549,42 +1748,128 @@ function kbach(options = {}) {
       const rules = tokenRules.get(tok);
       if (rules) view.set(tok, rules);
     }
+    for (const tok of tokenRules.keys()) {
+      if (!active.has(tok)) tokenRules.delete(tok);
+    }
     return formatKbachCSS(view, theme, activeTags());
   }
+  function initialScan() {
+    for (const dir of includeDirs) {
+      scanDir((0, import_path3.join)(root, dir), processFile);
+    }
+  }
+  function scanProjectCssSelectorsOnce() {
+    projectCssClasses = scanProjectCssSelectors(root, includeDirs);
+  }
+  return { processFile, removeFile, initialScan, processSafelist, generateCSS, scanProjectCssSelectorsOnce };
+}
+function readSourceFile(path) {
+  return (0, import_fs2.readFileSync)(path, "utf-8");
+}
+
+// src/vite-plugin/index.ts
+function findMainCSSFile(root, includeDirs, explicitCssFile) {
+  if (explicitCssFile) return (0, import_path4.join)(root, explicitCssFile);
+  const searchDirs = [...includeDirs, "."];
+  for (const dir of searchDirs) {
+    const candidate = (0, import_path4.join)(root, dir, "kbach.css");
+    if (!(0, import_fs3.existsSync)(candidate)) continue;
+    try {
+      const content = (0, import_fs3.readFileSync)(candidate, "utf-8");
+      if (content.includes(KBACH_START) && content.includes(KBACH_END)) return candidate;
+    } catch {
+    }
+  }
+  for (const dir of includeDirs) {
+    const full = (0, import_path4.join)(root, dir);
+    try {
+      if ((0, import_fs3.statSync)(full).isDirectory()) return (0, import_path4.join)(full, "kbach.css");
+    } catch {
+    }
+  }
+  return (0, import_path4.join)(root, includeDirs[0] ?? "src", "kbach.css");
+}
+var DEFAULT_SCAN_DIRS = ["src", "app", "pages", "components"];
+var CSS_SYNC_DEBOUNCE_MS = 50;
+function writeFileEnsuringDir(path, content) {
+  (0, import_fs3.mkdirSync)((0, import_path4.dirname)(path), { recursive: true });
+  (0, import_fs3.writeFileSync)(path, content, "utf-8");
+}
+function isEsmRequireFailure(err) {
+  if (!(err instanceof Error)) return false;
+  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);
+  return mod.default ?? mod;
+}
+function requireConfigModule(root, path) {
+  const mod = (0, import_module.createRequire)(root)(path);
+  return mod.default ?? mod;
+}
+async function loadConfigFile(root) {
+  const cjsPath = (0, import_path4.join)(root, "kbach.config.cjs");
+  if ((0, import_fs3.existsSync)(cjsPath)) return requireConfigModule(root, cjsPath);
+  const mjsPath = (0, import_path4.join)(root, "kbach.config.mjs");
+  if ((0, import_fs3.existsSync)(mjsPath)) return importConfigModule(mjsPath);
+  const jsPath = (0, import_path4.join)(root, "kbach.config.js");
+  if (!(0, import_fs3.existsSync)(jsPath)) return void 0;
+  try {
+    return requireConfigModule(root, jsPath);
+  } catch (err) {
+    if (!isEsmRequireFailure(err)) throw err;
+    return importConfigModule(jsPath);
+  }
+}
+async function resolveEffectiveTheme(root, options) {
+  if (options.theme) return options.theme;
+  if (options.config) return resolveKbachConfig(options.config);
+  const discovered = await loadConfigFile(root);
+  return discovered ? resolveKbachConfig(discovered) : defaultTheme;
+}
+function kbach(options = {}) {
+  const includeDirs = options.include ?? DEFAULT_SCAN_DIRS;
+  const safelist = options.safelist ?? [];
+  let root = process.cwd();
+  let theme = defaultTheme;
+  let engine = createKbachStaticCssEngine({ root, theme, themeJson: JSON.stringify(theme), includeDirs, safelist });
+  let mainCSSFilePath = (0, import_path4.join)(root, "src", "kbach.css");
   function mainCSSFile() {
-    return (0, import_path3.join)(root, "src", "kbach.css");
+    return mainCSSFilePath;
   }
   function classNameHintsFile() {
-    return (0, import_path3.join)(root, ".kbach", "kbach-classnames.d.ts");
+    return (0, import_path4.join)(root, ".kbach", "kbach-classnames.d.ts");
   }
   function writeClassNameHints() {
     const dts = buildClassNameHintsDts(buildClassTokens(theme));
     writeFileEnsuringDir(classNameHintsFile(), dts);
   }
   function syncMainCSSFile(server) {
-    const active = activeTokens();
-    for (const tok of tokenRules.keys()) {
-      if (!active.has(tok)) tokenRules.delete(tok);
-    }
-    const changed = writeKbachToFile(mainCSSFile(), generateCSS(), readFile, writeFile);
+    const changed = writeKbachToFile(mainCSSFile(), engine.generateCSS(), readSourceFile, writeFileEnsuringDir);
     if (changed && server) server.watcher.emit("change", mainCSSFile());
   }
-  function initialScan() {
-    for (const dir of includeDirs) {
-      scanDir((0, import_path3.join)(root, dir), processFile);
-    }
+  let syncTimer = null;
+  function scheduleSync(server) {
+    if (syncTimer) clearTimeout(syncTimer);
+    syncTimer = setTimeout(() => {
+      syncTimer = null;
+      syncMainCSSFile(server);
+    }, CSS_SYNC_DEBOUNCE_MS);
   }
   return {
     name: "kbach",
     enforce: "pre",
-    configResolved(resolved) {
+    async configResolved(resolved) {
       root = resolved.root;
+      theme = await resolveEffectiveTheme(root, options);
+      engine = createKbachStaticCssEngine({ root, theme, themeJson: JSON.stringify(theme), includeDirs, safelist });
+      mainCSSFilePath = findMainCSSFile(root, includeDirs, options.cssFile);
     },
     buildStart() {
-      projectCssClasses = scanProjectCssSelectors(root, includeDirs);
-      initialScan();
-      processSafelist();
-      writeKbachToFile(mainCSSFile(), generateCSS(), readFile, writeFile);
+      engine.scanProjectCssSelectorsOnce();
+      engine.initialScan();
+      engine.processSafelist();
+      writeKbachToFile(mainCSSFile(), engine.generateCSS(), readSourceFile, writeFileEnsuringDir);
       writeClassNameHints();
     },
     // handleHotUpdate covers edits; add/unlink (create/delete) land on the
@@ -1595,17 +1880,15 @@ function kbach(options = {}) {
         if (file.includes("node_modules")) return;
         if (!/\.(tsx?|jsx?)$/.test(file)) return;
         if (isUnlink) {
-          fileTokens.delete(normPath(file));
-          fileTags.delete(normPath(file));
+          engine.removeFile(file);
         } else {
           try {
-            processFile(file, readFile(file));
+            engine.processFile(file, readSourceFile(file));
           } catch {
-            fileTokens.delete(normPath(file));
-            fileTags.delete(normPath(file));
+            engine.removeFile(file);
           }
         }
-        syncMainCSSFile(server);
+        scheduleSync(server);
       };
       server.watcher.on("add", (file) => onAddOrUnlink(file, false));
       server.watcher.on("unlink", (file) => onAddOrUnlink(file, true));
@@ -1614,16 +1897,20 @@ function kbach(options = {}) {
       if (file.includes("node_modules")) return;
       if (!/\.(tsx?|jsx?)$/.test(file)) return;
       try {
-        processFile(file, readFile(file));
+        engine.processFile(file, readSourceFile(file));
       } catch {
-        fileTokens.delete(normPath(file));
-        fileTags.delete(normPath(file));
+        engine.removeFile(file);
       }
-      syncMainCSSFile(server);
+      scheduleSync(server);
     }
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  kbach
+  CSS_SYNC_DEBOUNCE_MS,
+  DEFAULT_SCAN_DIRS,
+  findMainCSSFile,
+  kbach,
+  loadConfigFile,
+  resolveEffectiveTheme
 });