@kbach/react 1.0.0-beta.5 → 1.0.0-beta.6

package/dist/vite-plugin.js

@@ -21,200 +21,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var vite_plugin_exports = {};
 __export(vite_plugin_exports, {
   CSS_SYNC_DEBOUNCE_MS: () => CSS_SYNC_DEBOUNCE_MS,
-  kbach: () => kbach
+  DEFAULT_SCAN_DIRS: () => DEFAULT_SCAN_DIRS,
+  kbach: () => kbach,
+  loadConfigFile: () => loadConfigFile,
+  resolveEffectiveTheme: () => resolveEffectiveTheme
 });
 module.exports = __toCommonJS(vite_plugin_exports);
-var import_fs2 = require("fs");
-var import_path3 = require("path");
+var import_fs3 = require("fs");
+var import_path4 = require("path");
 var import_module = require("module");
 
-// 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/cssVars.ts
 function hexToRgbTriplet(hex) {
   const h = hex.replace("#", "");
@@ -475,10 +291,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}
@@ -490,66 +306,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
@@ -1669,36 +1429,261 @@ function resolveKbachConfig(config) {
   return theme;
 }
 
-// src/vite-plugin/index.ts
-var DEFAULT_SCAN_DIRS = ["src", "app", "pages", "components"];
-var CSS_SYNC_DEBOUNCE_MS = 50;
-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");
+// 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));
 }
-function loadConfigFile(root) {
-  const path = (0, import_path3.join)(root, "kbach.config.js");
-  if (!(0, import_fs2.existsSync)(path)) return void 0;
-  const mod = (0, import_module.createRequire)(root)(path);
-  return mod.default ?? mod;
+
+// 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 kbach(options = {}) {
-  let theme = options.theme ?? (options.config ? resolveKbachConfig(options.config) : defaultTheme);
-  let themeJson = JSON.stringify(theme);
-  const includeDirs = options.include ?? DEFAULT_SCAN_DIRS;
-  const safelist = options.safelist ?? [];
-  let root = process.cwd();
+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 createKbachStaticCssEngine(options) {
+  const { root, theme, themeJson, includeDirs, safelist } = options;
   const fileTokens = /* @__PURE__ */ new Map();
   const tokenRules = /* @__PURE__ */ new Map();
   const fileTags = /* @__PURE__ */ new Map();
@@ -1722,6 +1707,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);
@@ -1745,24 +1734,62 @@ 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
+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 loadConfigFile(root) {
+  const path = (0, import_path4.join)(root, "kbach.config.js");
+  if (!(0, import_fs3.existsSync)(path)) return void 0;
+  const mod = (0, import_module.createRequire)(root)(path);
+  return mod.default ?? mod;
+}
+function resolveEffectiveTheme(root, options) {
+  if (options.theme) return options.theme;
+  if (options.config) return resolveKbachConfig(options.config);
+  const discovered = 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 });
   function mainCSSFile() {
-    return (0, import_path3.join)(root, "src", "kbach.css");
+    return (0, import_path4.join)(root, "src", "kbach.css");
   }
   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, (p, c) => (0, import_fs3.writeFileSync)(p, c, "utf-8"));
     if (changed && server) server.watcher.emit("change", mainCSSFile());
   }
   let syncTimer = null;
@@ -1773,29 +1800,19 @@ function kbach(options = {}) {
       syncMainCSSFile(server);
     }, CSS_SYNC_DEBOUNCE_MS);
   }
-  function initialScan() {
-    for (const dir of includeDirs) {
-      scanDir((0, import_path3.join)(root, dir), processFile);
-    }
-  }
   return {
     name: "kbach",
     enforce: "pre",
     configResolved(resolved) {
       root = resolved.root;
-      if (!options.theme && !options.config) {
-        const discovered = loadConfigFile(root);
-        if (discovered) {
-          theme = resolveKbachConfig(discovered);
-          themeJson = JSON.stringify(theme);
-        }
-      }
+      theme = resolveEffectiveTheme(root, options);
+      engine = createKbachStaticCssEngine({ root, theme, themeJson: JSON.stringify(theme), includeDirs, safelist });
     },
     buildStart() {
-      projectCssClasses = scanProjectCssSelectors(root, includeDirs);
-      initialScan();
-      processSafelist();
-      writeKbachToFile(mainCSSFile(), generateCSS(), readFile, writeFile);
+      engine.scanProjectCssSelectorsOnce();
+      engine.initialScan();
+      engine.processSafelist();
+      writeKbachToFile(mainCSSFile(), engine.generateCSS(), readSourceFile, (p, c) => (0, import_fs3.writeFileSync)(p, c, "utf-8"));
       writeClassNameHints();
     },
     // handleHotUpdate covers edits; add/unlink (create/delete) land on the
@@ -1806,14 +1823,12 @@ 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);
           }
         }
         scheduleSync(server);
@@ -1825,10 +1840,9 @@ 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);
       }
       scheduleSync(server);
     }
@@ -1837,5 +1851,8 @@ function kbach(options = {}) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CSS_SYNC_DEBOUNCE_MS,
-  kbach
+  DEFAULT_SCAN_DIRS,
+  kbach,
+  loadConfigFile,
+  resolveEffectiveTheme
 });