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

package/dist/chunk-MRBB55KV.mjs

@@ -0,0 +1,687 @@
+import {
+  resolveKbachConfig
+} from "./chunk-43FOLRQA.mjs";
+import {
+  buildResetCSS,
+  defaultTheme
+} from "./chunk-OVKVZA7B.mjs";
+
+// src/vite-plugin/index.ts
+import { readFileSync as readFileSync3, writeFileSync, mkdirSync, existsSync, statSync as statSync2 } from "fs";
+import { join as join4, dirname } from "path";
+import { pathToFileURL } from "url";
+import { createRequire } from "module";
+
+// src/vite-plugin/cssVars.ts
+function hexToRgbTriplet(hex) {
+  const h = hex.replace("#", "");
+  const expand = (s) => s.length === 3 ? s.split("").map((c) => c + c).join("") : s;
+  const full = expand(h);
+  if (full.length !== 6) return null;
+  const r = parseInt(full.slice(0, 2), 16);
+  const g = parseInt(full.slice(2, 4), 16);
+  const b = parseInt(full.slice(4, 6), 16);
+  if ([r, g, b].some((n) => Number.isNaN(n))) return null;
+  return `${r},${g},${b}`;
+}
+function buildColorVarMap(theme, cssText) {
+  const replacements = /* @__PURE__ */ new Map();
+  const declarations = /* @__PURE__ */ new Map();
+  for (const [name, value] of Object.entries(theme.colors)) {
+    if (typeof value !== "string") continue;
+    const varName = `--color-${name}`;
+    if (cssText.includes(value)) {
+      replacements.set(value, `var(${varName})`);
+      declarations.set(varName, value);
+    }
+    const triplet = hexToRgbTriplet(value);
+    if (!triplet) continue;
+    const rgbaPrefix = `rgba(${triplet},`;
+    if (cssText.includes(rgbaPrefix)) {
+      const rgbVarName = `--color-${name}-rgb`;
+      replacements.set(rgbaPrefix, `rgba(var(${rgbVarName}),`);
+      declarations.set(rgbVarName, triplet);
+    }
+  }
+  return { replacements, declarations };
+}
+var SPACING_PROPS = /* @__PURE__ */ new Set([
+  "padding",
+  "padding-top",
+  "padding-right",
+  "padding-bottom",
+  "padding-left",
+  "margin",
+  "margin-top",
+  "margin-right",
+  "margin-bottom",
+  "margin-left",
+  "gap",
+  "column-gap",
+  "row-gap",
+  "width",
+  "height",
+  "min-width",
+  "min-height",
+  "max-width",
+  "max-height",
+  "top",
+  "right",
+  "bottom",
+  "left"
+]);
+function buildSpacingVarMap(theme, cssText) {
+  const replacements = /* @__PURE__ */ new Map();
+  const declarations = /* @__PURE__ */ new Map();
+  const pxToKey = /* @__PURE__ */ new Map();
+  for (const [key, val] of Object.entries(theme.spacing)) {
+    if (!pxToKey.has(val)) pxToKey.set(val, key);
+  }
+  const varNameFor = (key) => `--spacing-${key.replace(/\./g, "_")}`;
+  const declRe = /([a-z-]+): (\d+(?:\.\d+)?)px/g;
+  let m;
+  while ((m = declRe.exec(cssText)) !== null) {
+    const [, prop, numStr] = m;
+    if (!SPACING_PROPS.has(prop)) continue;
+    const key = pxToKey.get(parseFloat(numStr));
+    if (key === void 0) continue;
+    const varName = varNameFor(key);
+    replacements.set(`${prop}: ${numStr}px`, `${prop}: var(${varName})`);
+    declarations.set(varName, `${numStr}px`);
+  }
+  return { replacements, declarations };
+}
+function applyVarMap(cssText, ...maps) {
+  const replacements = /* @__PURE__ */ new Map();
+  const declarations = /* @__PURE__ */ new Map();
+  for (const map of maps) {
+    for (const [k, v] of map.replacements) replacements.set(k, v);
+    for (const [k, v] of map.declarations) declarations.set(k, v);
+  }
+  const sorted = [...replacements].sort(([a], [b]) => b.length - a.length);
+  const escapeRegex = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const patterns = sorted.map(([pattern, replacement]) => [new RegExp(escapeRegex(pattern), "g"), replacement]);
+  const text = cssText.replace(/\{([^{}]*)\}/g, (_whole, inner) => {
+    let replaced = inner;
+    for (const [re, replacement] of patterns) {
+      replaced = replaced.replace(re, () => replacement);
+    }
+    return `{${replaced}}`;
+  });
+  return { text, declarations };
+}
+
+// src/vite-plugin/mediaMerge.ts
+var RESPONSIVE_MEDIA_RE = /^@media \(min-width: (\d+)px\) \{ (.+) \}$/;
+function mergeResponsiveMediaBlocks(rules) {
+  const byWidth = /* @__PURE__ */ new Map();
+  const widthOrder = [];
+  const unwrapped = [];
+  for (const rule of rules) {
+    const m = RESPONSIVE_MEDIA_RE.exec(rule);
+    if (!m) {
+      unwrapped.push(rule);
+      continue;
+    }
+    const width = Number(m[1]);
+    if (!byWidth.has(width)) {
+      byWidth.set(width, []);
+      widthOrder.push(width);
+    }
+    byWidth.get(width).push(m[2]);
+  }
+  widthOrder.sort((a, b) => a - b);
+  const merged = widthOrder.map((w) => `@media (min-width: ${w}px) { ${byWidth.get(w).join(" ")} }`);
+  return [...unwrapped, ...merged];
+}
+
+// src/vite-plugin/prettify.ts
+function prettifyCSS(css) {
+  const out = [];
+  let depth = 0;
+  let current = "";
+  for (const ch of css) {
+    if (ch === "{") {
+      const selector = current.trim();
+      if (selector) out.push(`${"  ".repeat(depth)}${selector} {`);
+      depth++;
+      current = "";
+    } else if (ch === "}") {
+      const decl = current.trim();
+      if (decl) out.push(`${"  ".repeat(depth)}${decl};`);
+      depth = Math.max(0, depth - 1);
+      out.push(`${"  ".repeat(depth)}}`);
+      current = "";
+    } else if (ch === ";") {
+      const decl = current.trim();
+      if (decl) out.push(`${"  ".repeat(depth)}${decl};`);
+      current = "";
+    } else {
+      current += ch;
+    }
+  }
+  const trailing = current.trim();
+  if (trailing) out.push(trailing);
+  return out.join("\n");
+}
+
+// src/vite-plugin/format.ts
+var KBACH_START = "/* kbach:start */";
+var KBACH_END = "/* kbach:end */";
+function formatKbachCSS(tokenRules, theme, usedTags) {
+  const allEntries = [];
+  for (const rules of tokenRules.values()) {
+    for (const entry of rules) allEntries.push(entry);
+  }
+  allEntries.sort((a, b) => a.order - b.order);
+  const allRules = allEntries.map((e) => e.rule);
+  const merged = mergeResponsiveMediaBlocks(allRules);
+  const compact = merged.join("\n");
+  const colorMap = buildColorVarMap(theme, compact);
+  const spacingMap = buildSpacingVarMap(theme, compact);
+  const { text, declarations } = applyVarMap(compact, colorMap, spacingMap);
+  const lines = ["/* Generated by Kbach \u2014 do not edit */", "", buildResetCSS(usedTags)];
+  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, readFile, writeFile) {
+  let existing = "";
+  try {
+    existing = readFile(filePath);
+  } catch {
+  }
+  const block = `${KBACH_START}
+${css}
+${KBACH_END}`;
+  const start = existing.indexOf(KBACH_START);
+  const end = existing.indexOf(KBACH_END);
+  const next = start !== -1 && end !== -1 && end > start ? existing.slice(0, start) + block + existing.slice(end + KBACH_END.length) : existing ? `${existing}
+
+${block}` : block;
+  if (next === existing) return false;
+  writeFile(filePath, next);
+  return true;
+}
+
+// src/staticCss/engine.ts
+import { readFileSync as readFileSync2 } from "fs";
+import { join as join3 } from "path";
+
+// src/vite-plugin/wasmNode.ts
+import { generate_css } from "@kbach/core-engine/node";
+function generateCssForToken(token, themeJson) {
+  return JSON.parse(generate_css(token, themeJson));
+}
+
+// src/vite-plugin/scan.ts
+import { readdirSync, readFileSync, statSync } from "fs";
+import { join } from "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 = readdirSync(dir);
+  } catch {
+    return;
+  }
+  for (const entry of entries) {
+    if (entry.startsWith(".") || SKIP_DIRS.has(entry)) continue;
+    const full = join(dir, entry);
+    try {
+      const st = statSync(full);
+      if (st.isDirectory()) scanDir(full, onFile, depth + 1, fileMatch);
+      else if (fileMatch.test(entry)) onFile(full, readFileSync(full, "utf-8"));
+    } catch {
+    }
+  }
+}
+
+// src/vite-plugin/unknownClassWarnings.ts
+import { join as join2 } from "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(join2(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();
+  let projectCssClasses = /* @__PURE__ */ new Set();
+  const warnedTokens = /* @__PURE__ */ new Set();
+  function resolveToken(tok) {
+    if (!tokenRules.has(tok)) {
+      tokenRules.set(tok, generateCssForToken(tok, themeJson).rules);
+    }
+    return tokenRules.get(tok);
+  }
+  function processFile(filePath, code) {
+    const tokens = /* @__PURE__ */ new Set();
+    for (const tok of extractClassStrings(code)) {
+      tokens.add(tok);
+      const rules = resolveToken(tok);
+      if (process.env.NODE_ENV !== "production") {
+        warnIfUnknownClass(tok, filePath, code, rules.length > 0, projectCssClasses, warnedTokens);
+      }
+    }
+    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);
+    for (const tok of tokens) resolveToken(tok);
+    fileTokens.set(SAFELIST_KEY, tokens);
+  }
+  function activeTokens() {
+    const active = /* @__PURE__ */ new Set();
+    for (const tokens of fileTokens.values()) for (const t of tokens) active.add(t);
+    return active;
+  }
+  function activeTags() {
+    const active = /* @__PURE__ */ new Set();
+    for (const tags of fileTags.values()) for (const t of tags) active.add(t);
+    return active;
+  }
+  function generateCSS() {
+    const active = activeTokens();
+    const view = /* @__PURE__ */ new Map();
+    for (const tok of active) {
+      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(join3(root, dir), processFile);
+    }
+  }
+  function scanProjectCssSelectorsOnce() {
+    projectCssClasses = scanProjectCssSelectors(root, includeDirs);
+  }
+  return { processFile, removeFile, initialScan, processSafelist, generateCSS, scanProjectCssSelectorsOnce };
+}
+function readSourceFile(path) {
+  return readFileSync2(path, "utf-8");
+}
+
+// src/vite-plugin/index.ts
+function findMainCSSFile(root, includeDirs, explicitCssFile) {
+  if (explicitCssFile) return join4(root, explicitCssFile);
+  const searchDirs = [...includeDirs, "."];
+  for (const dir of searchDirs) {
+    const candidate = join4(root, dir, "kbach.css");
+    if (!existsSync(candidate)) continue;
+    try {
+      const content = readFileSync3(candidate, "utf-8");
+      if (content.includes(KBACH_START) && content.includes(KBACH_END)) return candidate;
+    } catch {
+    }
+  }
+  for (const dir of includeDirs) {
+    const full = join4(root, dir);
+    try {
+      if (statSync2(full).isDirectory()) return join4(full, "kbach.css");
+    } catch {
+    }
+  }
+  return join4(root, includeDirs[0] ?? "src", "kbach.css");
+}
+var DEFAULT_SCAN_DIRS = ["src", "app", "pages", "components"];
+var CSS_SYNC_DEBOUNCE_MS = 50;
+function writeFileEnsuringDir(path, content) {
+  mkdirSync(dirname(path), { recursive: true });
+  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(pathToFileURL(path).href);
+  return mod.default ?? mod;
+}
+function requireConfigModule(root, path) {
+  const mod = createRequire(root)(path);
+  return mod.default ?? mod;
+}
+async function loadConfigFile(root) {
+  const cjsPath = join4(root, "kbach.config.cjs");
+  if (existsSync(cjsPath)) return requireConfigModule(root, cjsPath);
+  const mjsPath = join4(root, "kbach.config.mjs");
+  if (existsSync(mjsPath)) return importConfigModule(mjsPath);
+  const jsPath = join4(root, "kbach.config.js");
+  if (!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 = join4(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",
+    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() {
+      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
+    // type === "update".
+    configureServer(server) {
+      const onAddOrUnlink = (file, isUnlink) => {
+        if (file.includes("node_modules")) return;
+        if (!/\.(tsx?|jsx?)$/.test(file)) return;
+        if (isUnlink) {
+          engine.removeFile(file);
+        } else {
+          try {
+            engine.processFile(file, readSourceFile(file));
+          } catch {
+            engine.removeFile(file);
+          }
+        }
+        scheduleSync(server);
+      };
+      server.watcher.on("add", (file) => onAddOrUnlink(file, false));
+      server.watcher.on("unlink", (file) => onAddOrUnlink(file, true));
+    },
+    handleHotUpdate({ file, server }) {
+      if (file.includes("node_modules")) return;
+      if (!/\.(tsx?|jsx?)$/.test(file)) return;
+      try {
+        engine.processFile(file, readSourceFile(file));
+      } catch {
+        engine.removeFile(file);
+      }
+      scheduleSync(server);
+    }
+  };
+}
+
+export {
+  gray,
+  bold,
+  highlight,
+  kbachTag,
+  createKbachStaticCssEngine,
+  findMainCSSFile,
+  DEFAULT_SCAN_DIRS,
+  CSS_SYNC_DEBOUNCE_MS,
+  loadConfigFile,
+  resolveEffectiveTheme,
+  kbach
+};