@kbach/react 1.0.0-beta.2 → 1.0.0-beta.20

package/dist/vite-plugin.js

@@ -20,122 +20,19 @@ 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");
+var import_fs3 = require("fs");
+var import_path4 = require("path");
+var import_url = require("url");
 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 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 {
-    }
-  }
-}
-
 // src/vite-plugin/cssVars.ts
 function hexToRgbTriplet(hex) {
   const h = hex.replace("#", "");
@@ -388,18 +285,16 @@ function formatKbachCSS(tokenRules, theme, usedTags) {
   const spacingMap = buildSpacingVarMap(theme, compact);
   const { text, declarations } = applyVarMap(compact, colorMap, spacingMap);
   const lines = ["/* Generated by Kbach \u2014 do not edit */", "", buildResetCSS(usedTags)];
-  if (declarations.size > 0) {
-    lines.push("", ":root {");
-    for (const [varName, val] of declarations) lines.push(`  ${varName}: ${val};`);
-    lines.push("}");
-  }
+  lines.push("", ":root {", `  --kb-dark-mode: ${theme.darkMode};`);
+  for (const [varName, val] of declarations) lines.push(`  ${varName}: ${val};`);
+  lines.push("}");
   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}
@@ -411,734 +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
-  "flex",
-  "flex-row",
-  "flex-col",
-  "flex-row-reverse",
-  "flex-col-reverse",
-  "flex-wrap",
-  "flex-wrap-reverse",
-  "flex-nowrap",
-  "flex-1",
-  "flex-auto",
-  "flex-initial",
-  "flex-none",
-  "flex-grow",
-  "flex-grow-0",
-  "flex-shrink",
-  "flex-shrink-0",
-  "grow",
-  "grow-0",
-  "shrink",
-  "shrink-0",
-  "grid",
-  "block",
-  "inline-block",
-  "inline",
-  "inline-flex",
-  "inline-grid",
-  "contents",
-  "flow-root",
-  "hidden",
-  "items-center",
-  "items-start",
-  "items-end",
-  "items-baseline",
-  "items-stretch",
-  "justify-center",
-  "justify-start",
-  "justify-end",
-  "justify-between",
-  "justify-around",
-  "justify-evenly",
-  "content-start",
-  "content-end",
-  "content-center",
-  "content-between",
-  "content-around",
-  "content-evenly",
-  "content-stretch",
-  "self-auto",
-  "self-center",
-  "self-start",
-  "self-end",
-  "self-stretch",
-  "self-baseline",
-  "overflow-hidden",
-  "overflow-auto",
-  "overflow-scroll",
-  "overflow-visible",
-  "static",
-  "relative",
-  "absolute",
-  "fixed",
-  "sticky",
-  "aspect-square",
-  "aspect-video",
-  "w-full",
-  "h-full",
-  "min-w-full",
-  "max-w-full",
-  "min-h-full",
-  "max-h-full",
-  "w-screen",
-  "h-screen",
-  "min-w-screen",
-  "max-w-screen",
-  "min-h-screen",
-  "max-h-screen",
-  "w-auto",
-  "h-auto",
-  "m-auto",
-  "mx-auto",
-  "my-auto",
-  // grid.rs — web-only (see the module's own doc comment for why)
-  "grid-cols-none",
-  "grid-rows-none",
-  "grid-flow-row",
-  "grid-flow-col",
-  "grid-flow-dense",
-  "grid-flow-row-dense",
-  "grid-flow-col-dense",
-  "auto-cols-auto",
-  "auto-cols-min",
-  "auto-cols-max",
-  "auto-cols-fr",
-  "auto-rows-auto",
-  "auto-rows-min",
-  "auto-rows-max",
-  "auto-rows-fr",
-  "col-span-full",
-  "row-span-full",
-  "col-start-auto",
-  "col-end-auto",
-  "row-start-auto",
-  "row-end-auto",
-  "col",
-  "col-auto",
-  "row",
-  "row-auto",
-  "place-items-start",
-  "place-items-end",
-  "place-items-center",
-  "place-items-stretch",
-  "place-items-baseline",
-  "place-content-start",
-  "place-content-end",
-  "place-content-center",
-  "place-content-stretch",
-  "place-content-between",
-  "place-content-around",
-  "place-content-evenly",
-  "place-content-baseline",
-  "place-self-auto",
-  "place-self-start",
-  "place-self-end",
-  "place-self-center",
-  "place-self-stretch",
-  "justify-items-start",
-  "justify-items-end",
-  "justify-items-center",
-  "justify-items-stretch",
-  "justify-self-auto",
-  "justify-self-start",
-  "justify-self-end",
-  "justify-self-center",
-  "justify-self-stretch",
-  // transform.rs — web-only (see the module's own doc comment for why)
-  "transform-none",
-  "origin-center",
-  "origin-top",
-  "origin-top-right",
-  "origin-right",
-  "origin-bottom-right",
-  "origin-bottom",
-  "origin-bottom-left",
-  "origin-left",
-  "origin-top-left",
-  // filters.rs — web-only (see the module's own doc comment for why)
-  "blur",
-  "blur-sm",
-  "blur-md",
-  "blur-lg",
-  "blur-xl",
-  "blur-2xl",
-  "blur-3xl",
-  "blur-none",
-  "grayscale",
-  "grayscale-0",
-  "invert",
-  "invert-0",
-  "sepia",
-  "sepia-0",
-  "drop-shadow",
-  "drop-shadow-sm",
-  "drop-shadow-md",
-  "drop-shadow-lg",
-  "drop-shadow-xl",
-  "drop-shadow-2xl",
-  "drop-shadow-none",
-  "filter-none",
-  "backdrop-filter-none",
-  "backdrop-blur",
-  "backdrop-blur-sm",
-  "backdrop-blur-md",
-  "backdrop-blur-lg",
-  "backdrop-blur-xl",
-  "backdrop-blur-2xl",
-  "backdrop-blur-3xl",
-  "backdrop-blur-none",
-  "backdrop-grayscale",
-  "backdrop-grayscale-0",
-  "backdrop-invert",
-  "backdrop-invert-0",
-  "backdrop-sepia",
-  "backdrop-sepia-0",
-  // border.rs
-  "border",
-  "border-t",
-  "border-r",
-  "border-b",
-  "border-l",
-  "rounded",
-  "rounded-none",
-  "rounded-sm",
-  "rounded-md",
-  "rounded-lg",
-  "rounded-xl",
-  "rounded-2xl",
-  "rounded-3xl",
-  "rounded-full",
-  "ring",
-  "ring-0",
-  "ring-1",
-  "ring-2",
-  "ring-4",
-  "ring-8",
-  "ring-inset",
-  "ring-offset-0",
-  "ring-offset-1",
-  "ring-offset-2",
-  "ring-offset-4",
-  "ring-offset-8",
-  "outline",
-  "outline-none",
-  "border-solid",
-  "border-dashed",
-  "border-dotted",
-  "border-none",
-  // typography.rs
-  "font-thin",
-  "font-normal",
-  "font-medium",
-  "font-semibold",
-  "font-bold",
-  "font-extrabold",
-  "uppercase",
-  "lowercase",
-  "capitalize",
-  "underline",
-  "line-through",
-  "no-underline",
-  "truncate",
-  "text-xs",
-  "text-sm",
-  "text-base",
-  "text-lg",
-  "text-xl",
-  "text-2xl",
-  "text-3xl",
-  "text-4xl",
-  "text-left",
-  "text-center",
-  "text-right",
-  "text-justify",
-  // typography.rs — Phase 20 (typography completeness)
-  "italic",
-  "not-italic",
-  "leading-none",
-  "leading-tight",
-  "leading-snug",
-  "leading-normal",
-  "leading-relaxed",
-  "leading-loose",
-  "tracking-tighter",
-  "tracking-tight",
-  "tracking-normal",
-  "tracking-wide",
-  "tracking-wider",
-  "tracking-widest",
-  "decoration-auto",
-  "decoration-from-font",
-  "decoration-solid",
-  "decoration-dashed",
-  "decoration-dotted",
-  "decoration-double",
-  "decoration-wavy",
-  "underline-offset-auto",
-  "underline-offset-0",
-  "underline-offset-1",
-  "underline-offset-2",
-  "underline-offset-4",
-  "underline-offset-8",
-  "text-wrap",
-  "text-nowrap",
-  "text-balance",
-  "text-pretty",
-  "whitespace-normal",
-  "whitespace-nowrap",
-  "whitespace-pre",
-  "whitespace-pre-wrap",
-  "whitespace-pre-line",
-  "break-normal",
-  "break-words",
-  "break-all",
-  "align-baseline",
-  "align-top",
-  "align-middle",
-  "align-bottom",
-  "align-text-top",
-  "align-text-bottom",
-  "align-sub",
-  "align-super",
-  "list-none",
-  "list-disc",
-  "list-decimal",
-  "list-inside",
-  "list-outside",
-  "hyphens-none",
-  "hyphens-manual",
-  "hyphens-auto",
-  // effects.rs
-  "shadow",
-  "shadow-sm",
-  "shadow-md",
-  "shadow-lg",
-  "shadow-xl",
-  "shadow-2xl",
-  "shadow-inner",
-  "shadow-none",
-  "transition",
-  "transition-none",
-  "ease-linear",
-  "ease-in",
-  "ease-out",
-  "ease-in-out",
-  "cursor-pointer",
-  "cursor-default",
-  "cursor-not-allowed",
-  "cursor-wait",
-  "select-none",
-  "select-text",
-  "select-all",
-  "pointer-events-none",
-  "pointer-events-auto",
-  // effects.rs — Phase 22 (effects completeness)
-  "text-shadow",
-  "text-shadow-sm",
-  "text-shadow-lg",
-  "text-shadow-none",
-  "mix-blend-normal",
-  "mix-blend-multiply",
-  "mix-blend-screen",
-  "mix-blend-overlay",
-  "mix-blend-darken",
-  "mix-blend-lighten",
-  "mix-blend-color-dodge",
-  "mix-blend-color-burn",
-  "mix-blend-hard-light",
-  "mix-blend-soft-light",
-  "mix-blend-difference",
-  "mix-blend-exclusion",
-  "mix-blend-hue",
-  "mix-blend-saturation",
-  "mix-blend-color",
-  "mix-blend-luminosity",
-  "mix-blend-plus-lighter",
-  "bg-blend-normal",
-  "bg-blend-multiply",
-  "bg-blend-screen",
-  "bg-blend-overlay",
-  "bg-blend-darken",
-  "bg-blend-lighten",
-  "bg-blend-color-dodge",
-  "bg-blend-color-burn",
-  "bg-blend-hard-light",
-  "bg-blend-soft-light",
-  "bg-blend-difference",
-  "bg-blend-exclusion",
-  "bg-blend-hue",
-  "bg-blend-saturation",
-  "bg-blend-color",
-  "bg-blend-luminosity",
-  "bg-blend-plus-lighter",
-  "animate-spin",
-  "animate-ping",
-  "animate-pulse",
-  "animate-bounce",
-  "animate-none",
-  // interactivity.rs — Phase 23 (interactivity & sizing rest)
-  "resize",
-  "resize-none",
-  "resize-y",
-  "resize-x",
-  "touch-auto",
-  "touch-none",
-  "touch-pan-x",
-  "touch-pan-left",
-  "touch-pan-right",
-  "touch-pan-y",
-  "touch-pan-up",
-  "touch-pan-down",
-  "touch-pinch-zoom",
-  "touch-manipulation",
-  "will-change-auto",
-  "will-change-scroll",
-  "will-change-contents",
-  "will-change-transform",
-  "sr-only",
-  "not-sr-only",
-  "border-collapse",
-  "border-separate",
-  "table-auto",
-  "table-fixed",
-  "caption-top",
-  "caption-bottom",
-  "stroke-width-0",
-  "stroke-width-1",
-  "stroke-width-2",
-  // spacing.rs — Phase 23 (size-* shorthand + fraction-based width/height)
-  "size-full",
-  "size-auto",
-  "size-px",
-  "w-1/2",
-  "w-1/3",
-  "w-2/3",
-  "w-1/4",
-  "w-2/4",
-  "w-3/4",
-  "w-1/5",
-  "w-2/5",
-  "w-3/5",
-  "w-4/5",
-  "w-1/6",
-  "w-5/6",
-  "w-1/12",
-  "w-5/12",
-  "w-7/12",
-  "w-11/12",
-  "h-1/2",
-  "h-1/3",
-  "h-2/3",
-  "h-1/4",
-  "h-2/4",
-  "h-3/4",
-  "h-1/5",
-  "h-2/5",
-  "h-3/5",
-  "h-4/5",
-  "h-1/6",
-  "h-5/6",
-  // scroll.rs — Phase 23 (scroll-behavior/-margin/-padding, scroll-snap)
-  "scroll-auto",
-  "scroll-smooth",
-  "snap-start",
-  "snap-end",
-  "snap-center",
-  "snap-align-none",
-  "snap-normal",
-  "snap-always",
-  "snap-none",
-  "snap-x",
-  "snap-y",
-  "snap-both",
-  "snap-mandatory",
-  "snap-proximity",
-  // divide.rs
-  "divide-x",
-  "divide-y",
-  // background.rs — web-only (see the module's own doc comment for why)
-  "bg-top",
-  "bg-bottom",
-  "bg-left",
-  "bg-right",
-  "bg-center",
-  "bg-left-top",
-  "bg-left-bottom",
-  "bg-right-top",
-  "bg-right-bottom",
-  "bg-auto",
-  "bg-cover",
-  "bg-contain",
-  "bg-repeat",
-  "bg-no-repeat",
-  "bg-repeat-x",
-  "bg-repeat-y",
-  "bg-repeat-round",
-  "bg-repeat-space",
-  "bg-fixed",
-  "bg-local",
-  "bg-scroll",
-  "bg-clip-border",
-  "bg-clip-padding",
-  "bg-clip-content",
-  "bg-clip-text",
-  "bg-origin-border",
-  "bg-origin-padding",
-  "bg-origin-content",
-  "bg-none",
-  "bg-linear-to-t",
-  "bg-linear-to-tr",
-  "bg-linear-to-r",
-  "bg-linear-to-br",
-  "bg-linear-to-b",
-  "bg-linear-to-bl",
-  "bg-linear-to-l",
-  "bg-linear-to-tl",
-  "bg-radial",
-  "bg-conic",
-  // Ancestor/sibling-state marker classes — carry no styles of their own,
-  // just a selector target for group-hover:/peer-hover:/etc. below (see
-  // unknownClassWarnings.ts's MARKER_CLASSES for why they need special
-  // handling there too).
-  "group",
-  "peer",
-  // registry.rs modifiers — bare tokens only, not composed with a
-  // following utility (see this module's doc header / the Phase 15 plan).
-  "hover:",
-  "focus:",
-  "focus-visible:",
-  "focus-within:",
-  "active:",
-  "visited:",
-  "disabled:",
-  "checked:",
-  "group-hover:",
-  "group-focus:",
-  "peer-hover:",
-  "peer-focus:",
-  "peer-checked:",
-  "dark:",
-  "motion-safe:",
-  "motion-reduce:",
-  "print:",
-  "sm:",
-  "md:",
-  "lg:",
-  "xl:",
-  "2xl:",
-  // registry.rs modifiers — Phase 24 (expanded variant system), the
-  // FIXED/static additions only. Deliberately excluded: every genuinely
-  // parameterized modifier (has-[...]/group-has-[...]/peer-has-[...]/
-  // data-[...]/aria-[...]/not-[...]/min-[...]/max-[...], and the
-  // generalized group-<pseudo>/peer-<pseudo> beyond the five hardcoded
-  // combos above) — these have no finite enumerable set (their whole point
-  // is arbitrary user-supplied content), so there's nothing meaningful to
-  // suggest beyond the bare prefix, same reasoning as every other
-  // arbitrary-value exclusion in this file. `not-hover:`/`not-disabled:`/
-  // etc. (wrapping a KNOWN static modifier) are excluded for the same
-  // reason — enumerable in principle, but a full cross-product with every
-  // modifier above would be more noise than signal for an editor hint list.
-  "first:",
-  "last:",
-  "only:",
-  "odd:",
-  "even:",
-  "open:",
-  "inert:",
-  "aria-checked:",
-  "aria-disabled:",
-  "aria-expanded:",
-  "aria-hidden:",
-  "aria-pressed:",
-  "aria-readonly:",
-  "aria-required:",
-  "aria-selected:",
-  "aria-busy:",
-  // 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 ":"
-  // the modifier tokens below get. "@sm:"/"@md:"/"@lg:"/"@xl:"/"@2xl:" are
-  // container-responsive modifiers (registry.rs's `is_container_responsive`),
-  // and "starting:" wraps in @starting-style. Deliberately excluded, same
-  // "no finite enumerable set" reasoning as Phase 24's exclusions:
-  // "@min-[...]:"/"@max-[...]:" (arbitrary container breakpoints) and every
-  // `[property:value]` arbitrary property — both are open-ended by design.
-  "@container",
-  "@sm:",
-  "@md:",
-  "@lg:",
-  "@xl:",
-  "@2xl:",
-  "starting:"
-];
-var COLOR_PREFIXES = [
-  "bg-",
-  "text-",
-  "border-",
-  "divide-",
-  "decoration-",
-  "from-",
-  "via-",
-  "to-",
-  "text-shadow-",
-  "ring-",
-  "ring-offset-",
-  "caret-",
-  "accent-",
-  "fill-",
-  "stroke-"
-];
-var SPACING_PREFIXES = [
-  "p-",
-  "px-",
-  "py-",
-  "pt-",
-  "pr-",
-  "pb-",
-  "pl-",
-  "m-",
-  "mx-",
-  "my-",
-  "mt-",
-  "mr-",
-  "mb-",
-  "ml-",
-  "gap-",
-  "gap-x-",
-  "gap-y-",
-  "w-",
-  "h-",
-  "min-w-",
-  "max-w-",
-  "min-h-",
-  "max-h-",
-  "size-",
-  "top-",
-  "right-",
-  "bottom-",
-  "left-",
-  "inset-",
-  "space-x-",
-  "space-y-",
-  "indent-",
-  "scroll-m-",
-  "scroll-mx-",
-  "scroll-my-",
-  "scroll-mt-",
-  "scroll-mr-",
-  "scroll-mb-",
-  "scroll-ml-",
-  "scroll-p-",
-  "scroll-px-",
-  "scroll-py-",
-  "scroll-pt-",
-  "scroll-pr-",
-  "scroll-pb-",
-  "scroll-pl-"
-];
-var SIZE_PREFIXES = ["w-", "h-", "min-w-", "max-w-", "min-h-", "max-h-", "size-"];
-var NAMED_SIZES = ["sm", "md", "lg", "xl", "2xl", "3xl", "4xl", "5xl", "6xl", "7xl", "8xl", "9xl"];
-function buildClassTokens(theme) {
-  const tokens = new Set(STRUCTURAL_TOKENS);
-  for (const colorKey of Object.keys(theme.colors)) {
-    for (const prefix of COLOR_PREFIXES) tokens.add(`${prefix}${colorKey}`);
-  }
-  for (const spacingKey of Object.keys(theme.spacing)) {
-    for (const prefix of SPACING_PREFIXES) tokens.add(`${prefix}${spacingKey}`);
-  }
-  for (const size of NAMED_SIZES) {
-    for (const prefix of SIZE_PREFIXES) tokens.add(`${prefix}${size}`);
-  }
-  return Array.from(tokens).sort();
-}
-function buildClassNameHintsDts(tokens) {
-  const literals = tokens.map((t) => `  | '${t}'`).join("\n");
-  return [
-    "// Generated by Kbach \u2014 do not edit",
-    "// Editor autocomplete for className \u2014 see packages/react/src/vite-plugin/classNameHints.ts",
-    "",
-    "type KbachClassToken =",
-    literals,
-    ";",
-    "",
-    "export type KbachClassName = KbachClassToken | `${string} ${KbachClassToken}` | (string & {});",
-    "",
-    "declare module 'react' {",
-    "  interface HTMLAttributes<T> {",
-    "    className?: KbachClassName | undefined;",
-    "  }",
-    "  interface SVGAttributes<T> {",
-    "    className?: KbachClassName | undefined;",
-    "  }",
-    "}",
-    ""
-  ].join("\n");
-}
-
 // src/generatedPalette.ts
 var PALETTE = {
   "amber-1": "#fffbeb",
@@ -1489,12 +660,39 @@ var defaultTheme = {
     serif: 'ui-serif, Georgia, Cambria, "Times New Roman", Times, serif',
     mono: 'ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace'
   },
-  darkMode: "attribute",
+  // 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 activeTheme = defaultTheme;
 var activeThemeJson = JSON.stringify(defaultTheme);
+function setTheme(theme) {
+  activeTheme = theme;
+  activeThemeJson = JSON.stringify(theme);
+}
+function getTheme() {
+  return activeTheme;
+}
+var DARK_MODE_STRATEGIES = /* @__PURE__ */ new Set(["attribute", "class", "media"]);
+function detectDarkModeStrategyFromDom() {
+  if (typeof document === "undefined") return;
+  const raw = getComputedStyle(document.documentElement).getPropertyValue("--kb-dark-mode").trim();
+  if (!DARK_MODE_STRATEGIES.has(raw) || raw === activeTheme.darkMode) return;
+  setTheme({ ...activeTheme, darkMode: raw });
+}
 
 // src/colorVariables.ts
 function parseHexRgb(hex) {
@@ -1506,6 +704,61 @@ function parseHexRgb(hex) {
   return [n >> 16 & 255, n >> 8 & 255, n & 255];
 }
 
+// src/darkModeStore.ts
+var STORAGE_KEY = "kbach-theme";
+var listeners = /* @__PURE__ */ new Set();
+function systemPrefersDark() {
+  if (typeof window === "undefined" || !window.matchMedia) return false;
+  return window.matchMedia("(prefers-color-scheme: dark)").matches;
+}
+function storage() {
+  return typeof window === "undefined" ? null : window.localStorage;
+}
+function readPersistedMode() {
+  const ls = storage();
+  if (!ls) return null;
+  try {
+    const raw = ls.getItem(STORAGE_KEY);
+    return raw === "light" || raw === "dark" || raw === "system" ? raw : null;
+  } catch {
+    return null;
+  }
+}
+function resolveIsDark(m) {
+  return m === "system" ? systemPrefersDark() : m === "dark";
+}
+function applyToDom(dark) {
+  if (typeof document === "undefined") return;
+  const root = document.documentElement;
+  const strategy = getTheme().darkMode;
+  root.classList.toggle("dark", strategy === "class" && dark);
+  root.classList.toggle("light", strategy === "class" && !dark);
+  if (strategy === "attribute") {
+    root.setAttribute("data-theme", dark ? "dark" : "light");
+  } else {
+    root.removeAttribute("data-theme");
+  }
+}
+detectDarkModeStrategyFromDom();
+var persistedMode = readPersistedMode();
+var mode = persistedMode ?? "system";
+var isDark = resolveIsDark(mode);
+applyToDom(isDark);
+if (typeof window !== "undefined" && window.matchMedia) {
+  const mq = window.matchMedia("(prefers-color-scheme: dark)");
+  const onSystemChange = (event) => {
+    if (mode !== "system") return;
+    isDark = event.matches;
+    applyToDom(isDark);
+    notify();
+  };
+  if (mq.addEventListener) mq.addEventListener("change", onSystemChange);
+  else mq.addListener(onSystemChange);
+}
+function notify() {
+  for (const listener of listeners) listener();
+}
+
 // src/config.ts
 function applyOpacityToHex(hex, opacityText) {
   const rgb = parseHexRgb(hex);
@@ -1525,11 +778,29 @@ function resolveColorEntry(value, lookup) {
   return typeof base === "string" ? applyOpacityToHex(base, opacity) : { light: applyOpacityToHex(base.light, opacity), dark: applyOpacityToHex(base.dark, opacity) };
 }
 function resolveColors(extend, existing) {
+  const { dark: darkExtend, ...lightExtend } = extend;
   const resolved = {};
   const lookup = (name) => resolved[name] ?? existing[name];
-  for (const [name, value] of Object.entries(extend)) {
+  for (const [name, value] of Object.entries(lightExtend)) {
+    if (typeof value === "object" && value !== null && !("light" in value) && !("dark" in value)) continue;
     resolved[name] = resolveColorEntry(value, lookup);
   }
+  if (darkExtend) {
+    const resolvedDark = {};
+    const lookupDark = (name) => {
+      const found = resolvedDark[name] ?? existing[name];
+      return typeof found === "string" ? found : void 0;
+    };
+    for (const [name, value] of Object.entries(darkExtend)) {
+      const entry = resolveColorEntry(value, lookupDark);
+      resolvedDark[name] = typeof entry === "string" ? entry : entry.dark;
+    }
+    for (const [name, darkValue] of Object.entries(resolvedDark)) {
+      const lightEntry = resolved[name];
+      if (lightEntry === void 0 || typeof lightEntry !== "string") continue;
+      resolved[name] = { light: lightEntry, dark: darkValue };
+    }
+  }
   return resolved;
 }
 function resolveKbachConfig(config) {
@@ -1555,35 +826,272 @@ function resolveKbachConfig(config) {
   return theme;
 }
 
-// src/vite-plugin/index.ts
-var DEFAULT_SCAN_DIRS = ["src", "app", "pages", "components"];
-function normPath(p) {
-  const fwd = p.replace(/\\/g, "/");
-  return process.platform === "win32" ? fwd.toLowerCase() : fwd;
+// 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));
 }
-var SAFELIST_KEY = "\0kbach-safelist";
-function readFile(path) {
-  return (0, import_fs2.readFileSync)(path, "utf-8");
+
+// 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 writeFile(path, content) {
-  (0, import_fs2.writeFileSync)(path, content, "utf-8");
+function splitClassTokens(str) {
+  return str.split(/\s+/).filter(Boolean);
 }
-function writeFileEnsuringDir(path, content) {
-  (0, import_fs2.mkdirSync)((0, import_path3.dirname)(path), { recursive: true });
-  (0, import_fs2.writeFileSync)(path, content, "utf-8");
+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 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;
+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 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 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");
+
+// src/terminalWarn.ts
+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 highlight = (s) => bold(white(s));
+function kbachTag() {
+  return `${green("\u2192")} ${bold(green("[Kbach]"))}`;
+}
+
+// src/vite-plugin/unknownClassWarnings.ts
+var CSS_CLASS_SELECTOR_RE = /\.(-?[a-zA-Z_][a-zA-Z0-9_-]*)/g;
+var CSS_FILE_RE = /\.(css|scss|sass|less)$/;
+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 isMarkerClass(base) {
+  if (MARKER_CLASSES.has(base)) return true;
+  const slashIdx = base.lastIndexOf("/");
+  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) {
+  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}`
+  );
+}
+
+// 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();
@@ -1607,6 +1115,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);
@@ -1630,50 +1142,121 @@ function kbach(options = {}) {
       const rules = tokenRules.get(tok);
       if (rules) view.set(tok, rules);
     }
-    return formatKbachCSS(view, theme, activeTags());
-  }
-  function mainCSSFile() {
-    return (0, import_path3.join)(root, "src", "kbach.css");
-  }
-  function classNameHintsFile() {
-    return (0, import_path3.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);
-    if (changed && server) server.watcher.emit("change", mainCSSFile());
+    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 mainCSSFilePath;
+  }
+  function syncMainCSSFile(server) {
+    const changed = writeKbachToFile(mainCSSFile(), engine.generateCSS(), readSourceFile, writeFileEnsuringDir);
+    if (changed && server) server.watcher.emit("change", mainCSSFile());
+  }
+  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;
-      if (!options.theme && !options.config) {
-        const discovered = loadConfigFile(root);
-        if (discovered) {
-          theme = resolveKbachConfig(discovered);
-          themeJson = JSON.stringify(theme);
-        }
-      }
+      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);
-      writeClassNameHints();
+      engine.scanProjectCssSelectorsOnce();
+      engine.initialScan();
+      engine.processSafelist();
+      writeKbachToFile(mainCSSFile(), engine.generateCSS(), readSourceFile, writeFileEnsuringDir);
     },
     // handleHotUpdate covers edits; add/unlink (create/delete) land on the
     // raw watcher instead — Vite's handleHotUpdate hook only fires for
@@ -1683,17 +1266,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));
@@ -1702,16 +1283,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
 });