uifying 0.0.0-stage → 0.1.0

package/dist/uifying.mjs

@@ -0,0 +1,2036 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { existsSync as existsSync7, readFileSync as readFileSync4 } from "node:fs";
+import { join as join7, resolve as resolve2 } from "node:path";
+
+// ../core/dist/util.js
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, extname, join, relative } from "node:path";
+var DEFAULT_IGNORE = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  ".next",
+  ".nuxt",
+  ".svelte-kit",
+  ".turbo",
+  ".cache",
+  ".vercel",
+  "dist",
+  "build",
+  "out",
+  "coverage",
+  ".uifying",
+  ".wrangler",
+  ".pnpm-store",
+  "public",
+  "test",
+  "tests",
+  "__tests__",
+  ".storybook",
+  "stories"
+]);
+function toPosix(value2) {
+  return value2.split("\\").join("/");
+}
+function readText(file) {
+  return readFileSync(file, "utf8");
+}
+function readJson(file) {
+  return JSON.parse(readText(file));
+}
+function parseJsonc(file) {
+  const raw = readText(file).replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1").replace(/,\s*([}\]])/g, "$1");
+  return JSON.parse(raw);
+}
+function writeText(file, content) {
+  mkdirSync(dirname(file), { recursive: true });
+  writeFileSync(file, content, "utf8");
+}
+function writeJson(file, value2) {
+  writeText(file, JSON.stringify(value2, null, 2) + "\n");
+}
+function ensureDir(dir) {
+  mkdirSync(dir, { recursive: true });
+}
+function walk(root, ignore = []) {
+  const ignored = /* @__PURE__ */ new Set([...DEFAULT_IGNORE, ...ignore]);
+  const output = [];
+  const visit = (dir) => {
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      return;
+    }
+    entries.sort();
+    for (const entry of entries) {
+      if (output.length >= 5e3)
+        return;
+      const full = join(dir, entry);
+      let stat2;
+      try {
+        stat2 = statSync(full);
+      } catch {
+        continue;
+      }
+      if (stat2.isSymbolicLink())
+        continue;
+      if (stat2.isDirectory()) {
+        if (ignored.has(entry))
+          continue;
+        visit(full);
+        continue;
+      }
+      if (stat2.size > 15e5)
+        continue;
+      const rel = toPosix(relative(root, full));
+      if (rel.split("/").some((part) => ignored.has(part)))
+        continue;
+      if (/\.(test|spec|stories|story)\.[jt]sx?$/.test(rel))
+        continue;
+      output.push(rel);
+    }
+  };
+  visit(root);
+  return output;
+}
+function lineAt(source, index) {
+  const before = source.slice(0, Math.max(0, index));
+  const lines = before.split("\n");
+  return { line: lines.length, column: (lines[lines.length - 1]?.length ?? 0) + 1 };
+}
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function resolveCssValue(value2, variables, depth = 0) {
+  if (depth > 6)
+    return value2;
+  const next = value2.replace(/var\(\s*--([\w-]+)\s*(?:,\s*([^)]*))?\)/g, (_match, name, fallback) => {
+    return variables.get(name) ?? fallback ?? _match;
+  });
+  if (next === value2)
+    return value2;
+  return resolveCssValue(next, variables, depth + 1);
+}
+function numericPx(value2) {
+  const match = value2.trim().match(/^(-?\d+(?:\.\d+)?)(px|rem|em)?$/);
+  if (!match)
+    return null;
+  const number = Number(match[1]);
+  if (!Number.isFinite(number))
+    return null;
+  if (match[2] === "rem" || match[2] === "em")
+    return number * 16;
+  return number;
+}
+function detectPackageManager(root) {
+  if (existsSync(join(root, "pnpm-lock.yaml")))
+    return "pnpm";
+  if (existsSync(join(root, "yarn.lock")))
+    return "yarn";
+  if (existsSync(join(root, "bun.lockb")) || existsSync(join(root, "bun.lock")))
+    return "bun";
+  if (existsSync(join(root, "package-lock.json")))
+    return "npm";
+  return null;
+}
+function runGit(root, args) {
+  const result = spawnSync("git", ["-C", root, ...args], { encoding: "utf8" });
+  if (result.status !== 0)
+    return "";
+  return result.stdout.trim();
+}
+var useColor = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+var paint = (code, value2) => useColor ? `\x1B[${code}m${value2}\x1B[0m` : value2;
+var color = {
+  red: (value2) => paint("31", value2),
+  yellow: (value2) => paint("33", value2),
+  green: (value2) => paint("32", value2),
+  cyan: (value2) => paint("36", value2),
+  dim: (value2) => paint("2", value2),
+  bold: (value2) => paint("1", value2)
+};
+function escapeHtml(value2) {
+  return value2.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+function extensionless(file) {
+  return file.slice(0, file.length - extname(file).length);
+}
+
+// ../core/dist/scan.js
+import { existsSync as existsSync2 } from "node:fs";
+import { basename, join as join2 } from "node:path";
+function scanProject(root, ignore = []) {
+  const packagePath = join2(root, "package.json");
+  if (!existsSync2(packagePath)) {
+    throw new Error("No package.json found. Run this from a React or Next.js project, or use uifying spec init for a new project.");
+  }
+  const pkg = readJson(packagePath);
+  const deps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
+  const files = walk(root, ignore);
+  const cssFiles = files.filter((file) => file.endsWith(".css"));
+  const tsconfig = existsSync2(join2(root, "tsconfig.json")) ? safeJsonc(join2(root, "tsconfig.json")) : null;
+  const importAlias = detectImportAlias(tsconfig);
+  const tailwindConfig = files.find((file) => /(^|\/)tailwind\.config\.(ts|js|mjs|cjs)$/.test(file)) ?? null;
+  const globalsCss = pickGlobalsCss(root, cssFiles);
+  const tailwind = detectTailwind(deps, globalsCss ? readText(join2(root, globalsCss)) : "", tailwindConfig);
+  const componentDirs = ["src/components", "components", "src/ui", "ui"].filter((dir) => existsSync2(join2(root, dir)));
+  const pageDirs = ["app", "src/app", "pages", "src/pages"].filter((dir) => existsSync2(join2(root, dir)));
+  const raw = [];
+  const variables = /* @__PURE__ */ new Map();
+  if (globalsCss)
+    raw.push(...parseCssTokens(root, globalsCss, variables));
+  if (tailwindConfig)
+    raw.push(...parseTailwindConfig(root, tailwindConfig));
+  const tokens = normalizeTokens(dedupeTokens(raw), variables);
+  const components = scanComponents(root, files, importAlias).filter((component) => !isPageFile(component.path, pageDirs));
+  const patterns = scanPages(root, files, pageDirs, components);
+  const info = {
+    name: pkg.name ?? basename(root),
+    framework: deps.next ? "next" : deps.react ? "react" : "unknown",
+    typescript: Boolean(tsconfig) || files.some((file) => file.endsWith(".tsx") || file.endsWith(".ts")),
+    tailwind,
+    packageManager: detectPackageManager(root),
+    componentDirs,
+    pageDirs,
+    globalsCss,
+    tailwindConfig,
+    importAlias
+  };
+  return { info, tokens, components, patterns };
+}
+function emptyScan(root, name = basename(root)) {
+  const info = { name, framework: "unknown", typescript: existsSync2(join2(root, "tsconfig.json")), tailwind: null, packageManager: detectPackageManager(root), componentDirs: [], pageDirs: [], globalsCss: null, tailwindConfig: null, importAlias: null };
+  return { info, tokens: normalizeTokens(defaultRawTokens(), /* @__PURE__ */ new Map()), components: [], patterns: [] };
+}
+function safeJsonc(file) {
+  try {
+    return parseJsonc(file);
+  } catch {
+    return null;
+  }
+}
+function detectImportAlias(tsconfig) {
+  if (!tsconfig || typeof tsconfig !== "object")
+    return null;
+  const paths = tsconfig.compilerOptions?.paths;
+  if (!paths)
+    return null;
+  for (const [pattern, targets] of Object.entries(paths)) {
+    const star = pattern.indexOf("*");
+    if (star < 0 || !targets?.[0])
+      continue;
+    const prefix = pattern.slice(0, star);
+    const target = targets[0].slice(0, targets[0].indexOf("*")).replace(/^\.\//, "").replace(/\/$/, "");
+    if (prefix && target !== void 0)
+      return { prefix, target };
+  }
+  return null;
+}
+function pickGlobalsCss(root, cssFiles) {
+  const preferred = ["app/globals.css", "src/app/globals.css", "src/styles/globals.css", "styles/globals.css", "app/global.css", "src/index.css", "src/styles/index.css"].find((file) => cssFiles.includes(file));
+  if (preferred)
+    return preferred;
+  for (const file of cssFiles) {
+    const body = readText(join2(root, file));
+    if (/--[\w-]+\s*:/.test(body) || /@tailwind\s|@import\s+["']tailwindcss["']/.test(body))
+      return file;
+  }
+  return cssFiles[0] ?? null;
+}
+function detectTailwind(deps, css2, config) {
+  const version = deps.tailwindcss ?? "";
+  if (/^\D*4\./.test(version) || /@import\s+["']tailwindcss["']/.test(css2) || /@theme\b/.test(css2))
+    return "v4";
+  if (/^\D*3\./.test(version) || config || /@tailwind\s/.test(css2))
+    return "v3";
+  return null;
+}
+function parseCssTokens(root, relPath, variables) {
+  const source = readText(join2(root, relPath));
+  const entries = [];
+  const regex = /--([\w-]+)\s*:\s*([^;]+);/g;
+  for (const match of source.matchAll(regex)) {
+    const value2 = match[2].trim().replace(/\s+/g, " ");
+    if (value2)
+      entries.push({ name: match[1], value: value2, index: match.index ?? 0 });
+  }
+  const rawMap = new Map(entries.map((entry) => [entry.name, entry.value]));
+  for (const [name, value2] of rawMap)
+    variables.set(name, resolveCssValue(value2, rawMap));
+  const tokens = entries.map((entry) => ({ name: entry.name, value: resolveCssValue(entry.value, rawMap), type: classifyToken(entry.name, entry.value), source: relPath + ":" + lineAt(source, entry.index).line, status: "confirmed" }));
+  const known = new Set(tokens.map((token) => token.value.toLowerCase()));
+  const seen = /* @__PURE__ */ new Set();
+  for (const match of source.matchAll(/#([0-9a-fA-F]{3,8})\b/g)) {
+    const value2 = "#" + match[1].toLowerCase();
+    if (known.has(value2) || seen.has(value2))
+      continue;
+    seen.add(value2);
+    tokens.push({ name: "literal." + value2, value: value2, type: "color", source: relPath + ":" + lineAt(source, match.index ?? 0).line, status: "candidate" });
+  }
+  return tokens;
+}
+function classifyToken(name, value2) {
+  const n = name.toLowerCase();
+  const v = value2.trim().toLowerCase();
+  if (/^(#|rgb|hsl|oklch|lab|color\()/.test(v) || /(color|colour|background|foreground|border|primary|brand|accent|success|warning|danger|muted|surface|text)/.test(n))
+    return "color";
+  if (/radius|rounded/.test(n))
+    return "radius";
+  if (/font-size|text-size|textsize/.test(n))
+    return "fontSize";
+  if (/font|family/.test(n))
+    return "font";
+  if (/space|spacing|gap|padding|margin/.test(n))
+    return "spacing";
+  if (/shadow|elevation/.test(n))
+    return "shadow";
+  return "other";
+}
+function parseTailwindConfig(root, relPath) {
+  const source = readText(join2(root, relPath));
+  const tokens = [];
+  const add = (section, type, prefix) => {
+    const body = extractSection(source, section);
+    if (!body)
+      return;
+    const object = parseObjectBody(body);
+    addObjectTokens(tokens, object, prefix, type, relPath);
+  };
+  add("colors", "color", "color");
+  add("borderRadius", "radius", "radius");
+  add("spacing", "spacing", "space");
+  add("fontFamily", "font", "font");
+  add("fontSize", "fontSize", "fontSize");
+  add("boxShadow", "shadow", "shadow");
+  return tokens;
+}
+function extractSection(source, key) {
+  const match = new RegExp("\\b" + key + "\\s*:\\s*\\{").exec(source);
+  if (!match)
+    return null;
+  const open = source.indexOf("{", match.index + match[0].length - 1);
+  if (open < 0)
+    return null;
+  const close = findMatching(source, open, "{", "}");
+  return close < 0 ? null : source.slice(open + 1, close);
+}
+function findMatching(source, open, openChar, closeChar) {
+  let depth = 0;
+  let quote = null;
+  for (let i = open; i < source.length; i++) {
+    const char = source[i];
+    if (quote) {
+      if (char === "\\") {
+        i++;
+        continue;
+      }
+      if (char === quote)
+        quote = null;
+      continue;
+    }
+    if (char === '"' || char === "'") {
+      quote = char;
+      continue;
+    }
+    if (char === openChar)
+      depth++;
+    if (char === closeChar) {
+      depth--;
+      if (depth === 0)
+        return i;
+    }
+  }
+  return -1;
+}
+function parseObjectBody(body) {
+  const result = {};
+  let i = 0;
+  while (i < body.length) {
+    while (i < body.length && /[\s,]/.test(body[i]))
+      i++;
+    if (i >= body.length)
+      break;
+    let key = "";
+    if (body[i] === '"' || body[i] === "'") {
+      const quote = body[i++];
+      while (i < body.length && body[i] !== quote)
+        key += body[i++];
+      i++;
+    } else {
+      while (i < body.length && body[i] !== ":" && body[i] !== ",")
+        key += body[i++];
+    }
+    key = key.trim();
+    while (i < body.length && /\s/.test(body[i]))
+      i++;
+    if (!key || body[i] !== ":") {
+      while (i < body.length && body[i] !== ",")
+        i++;
+      i++;
+      continue;
+    }
+    i++;
+    while (i < body.length && /\s/.test(body[i]))
+      i++;
+    if (body[i] === "{") {
+      const end = findMatching(body, i, "{", "}");
+      if (end < 0)
+        break;
+      result[key] = parseObjectBody(body.slice(i + 1, end));
+      i = end + 1;
+    } else if (body[i] === '"' || body[i] === "'") {
+      const quote = body[i++];
+      let value2 = "";
+      while (i < body.length && body[i] !== quote) {
+        if (body[i] === "\\")
+          i++;
+        value2 += body[i++];
+      }
+      i++;
+      result[key] = value2;
+    } else {
+      let value2 = "";
+      let depth = 0;
+      while (i < body.length) {
+        const char = body[i];
+        if (char === "[" || char === "(")
+          depth++;
+        if (char === "]" || char === ")")
+          depth = Math.max(0, depth - 1);
+        if (char === "," && depth === 0)
+          break;
+        value2 += char;
+        i++;
+      }
+      result[key] = value2.trim();
+    }
+    while (i < body.length && body[i] !== ",")
+      i++;
+    i++;
+  }
+  return result;
+}
+function addObjectTokens(tokens, object, prefix, type, source) {
+  const visit = (value2, current) => {
+    for (const [key, child] of Object.entries(value2)) {
+      const name = key === "DEFAULT" ? current : current ? current + "." + key : key;
+      if (typeof child === "object") {
+        visit(child, name);
+        continue;
+      }
+      const extracted = type === "color" ? extractColorValue(child) : type === "font" ? extractFontValue(child) : extractFirstValue(child);
+      if (extracted)
+        tokens.push({ name: prefix + "." + name, value: extracted, type, source, status: "confirmed" });
+    }
+  };
+  visit(object, "");
+}
+function extractColorValue(value2) {
+  const trimmed = value2.trim();
+  if (/^(#|rgb|hsl|oklch|lab|color\()/.test(trimmed))
+    return trimmed;
+  return trimmed.match(/['"]([^'"]+)['"]/)?.[1] ?? null;
+}
+function extractFontValue(value2) {
+  const quoted = [...value2.matchAll(/['"]([^'"]+)['"]/g)].map((match) => match[1]);
+  return quoted.length ? quoted.join(", ") : extractFirstValue(value2);
+}
+function extractFirstValue(value2) {
+  const quoted = value2.match(/['"]([^'"]+)['"]/);
+  if (quoted)
+    return quoted[1];
+  const trimmed = value2.trim();
+  return /^(\d|#|rgb|hsl|oklch)/.test(trimmed) ? trimmed : null;
+}
+function dedupeTokens(tokens) {
+  const seen = /* @__PURE__ */ new Set();
+  return tokens.filter((token) => {
+    const key = token.name + "|" + token.value;
+    if (seen.has(key))
+      return false;
+    seen.add(key);
+    return true;
+  });
+}
+function normalizeTokens(raw, variables) {
+  const colors = /* @__PURE__ */ new Map();
+  const radii = /* @__PURE__ */ new Map();
+  const spacing = /* @__PURE__ */ new Map();
+  const fonts = /* @__PURE__ */ new Map();
+  const fontSizes = /* @__PURE__ */ new Map();
+  const shadows = /* @__PURE__ */ new Map();
+  for (const token of raw) {
+    const value2 = resolveCssValue(token.value, variables);
+    if (token.type === "color" && token.status === "confirmed" && !token.name.startsWith("literal."))
+      colors.set(token.name.toLowerCase(), value2);
+    if (token.type === "radius")
+      radii.set(token.name.toLowerCase(), value2);
+    if (token.type === "spacing")
+      spacing.set(token.name.toLowerCase(), value2);
+    if (token.type === "font")
+      fonts.set(token.name.toLowerCase(), value2);
+    if (token.type === "fontSize")
+      fontSizes.set(token.name.toLowerCase(), value2);
+    if (token.type === "shadow")
+      shadows.set(token.name.toLowerCase(), value2);
+  }
+  const pick = (map, patterns, fallback) => {
+    for (const pattern of patterns)
+      for (const [name, value2] of map)
+        if (name.includes(pattern) && value2)
+          return value2;
+    return fallback;
+  };
+  const dim = (map, key, fallback) => {
+    for (const [name, value2] of map)
+      if (name.endsWith("-" + key) || name.endsWith("." + key) || name === key)
+        return value2;
+    return fallback;
+  };
+  const normalizedSpacing = {};
+  for (const [name, value2] of spacing) {
+    const key = name.split(/[-.]/).pop() ?? name;
+    if (numericPx(value2) !== null)
+      normalizedSpacing[key] = value2;
+  }
+  if (Object.keys(normalizedSpacing).length === 0)
+    Object.assign(normalizedSpacing, { "4": "4px", "8": "8px", "12": "12px", "16": "16px", "24": "24px", "32": "32px" });
+  const normalizedFontSizes = {};
+  for (const [name, value2] of fontSizes)
+    normalizedFontSizes[name.split(/[-.]/).pop() ?? name] = value2;
+  return {
+    colors: { background: pick(colors, ["background", "bg", "canvas"], "#f8fafc"), surface: pick(colors, ["surface", "card", "panel"], "#ffffff"), primary: pick(colors, ["primary", "brand", "accent"], "#2f5cff"), text: pick(colors, ["foreground", "text", "ink", "on-background"], "#0b1a35"), muted: pick(colors, ["muted", "secondary", "subtle"], "#5a7094"), border: pick(colors, ["border", "line", "divider"], "#e2e8f0"), success: pick(colors, ["success", "positive", "ok"], "#0c7354"), warning: pick(colors, ["warning", "warn", "caution"], "#946007"), danger: pick(colors, ["danger", "destructive", "error"], "#bd332e") },
+    radius: { sm: dim(radii, "sm", "4px"), md: dim(radii, "md", "8px"), lg: dim(radii, "lg", "12px") },
+    spacing: normalizedSpacing,
+    fonts: { sans: pick(fonts, ["sans", "body"], "ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, sans-serif"), serif: pick(fonts, ["serif"], "Georgia, serif"), mono: pick(fonts, ["mono", "code"], "ui-monospace, SFMono-Regular, Menlo, monospace") },
+    fontSizes: normalizedFontSizes,
+    shadows: Object.fromEntries(shadows),
+    raw
+  };
+}
+function defaultRawTokens() {
+  const source = "UIfying dashboard baseline";
+  const add = (name, value2, type) => ({ name, value: value2, type, source, status: "confirmed" });
+  return [
+    add("color.background", "#f8fafc", "color"),
+    add("color.surface", "#ffffff", "color"),
+    add("color.primary", "#2f5cff", "color"),
+    add("color.text", "#0b1a35", "color"),
+    add("color.muted", "#5a7094", "color"),
+    add("color.border", "#e2e8f0", "color"),
+    add("color.success", "#0c7354", "color"),
+    add("color.warning", "#946007", "color"),
+    add("color.danger", "#bd332e", "color"),
+    add("radius.sm", "4px", "radius"),
+    add("radius.md", "8px", "radius"),
+    add("radius.lg", "12px", "radius"),
+    add("space.4", "4px", "spacing"),
+    add("space.8", "8px", "spacing"),
+    add("space.12", "12px", "spacing"),
+    add("space.16", "16px", "spacing"),
+    add("space.24", "24px", "spacing"),
+    add("space.32", "32px", "spacing"),
+    add("font.sans", "ui-sans-serif, system-ui, sans-serif", "font"),
+    add("fontSize.sm", "12px", "fontSize"),
+    add("fontSize.base", "14px", "fontSize"),
+    add("fontSize.lg", "16px", "fontSize"),
+    add("fontSize.xl", "24px", "fontSize"),
+    add("shadow.card", "0 1px 2px rgba(15, 23, 42, 0.06)", "shadow")
+  ];
+}
+function scanComponents(root, files, alias) {
+  const components = [];
+  for (const file of files) {
+    if (!/\.(tsx|jsx)$/.test(file))
+      continue;
+    for (const component of extractComponents(file, readText(join2(root, file))))
+      components.push(component);
+  }
+  for (const component of components) {
+    const usages = [];
+    for (const file of files) {
+      if (!/\.(tsx|jsx|ts)$/.test(file) || file === component.path)
+        continue;
+      for (const imported of collectImports(readText(join2(root, file)))) {
+        if (imported.imported === component.name)
+          usages.push({ file, specifier: imported.specifier });
+      }
+    }
+    component.usedBy = [...new Set(usages.map((usage) => usage.file))];
+    const counts = /* @__PURE__ */ new Map();
+    for (const usage of usages)
+      counts.set(usage.specifier, (counts.get(usage.specifier) ?? 0) + 1);
+    component.importPath = [...counts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0] ?? fallbackImportPath(component.path, alias);
+    component.status = /(^|\/)ui\//.test(component.path) ? "approved" : "candidate";
+  }
+  return components.sort((a, b) => a.path.localeCompare(b.path) || a.name.localeCompare(b.name));
+}
+function extractComponents(file, content) {
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const match of content.matchAll(/export\s+(default\s+)?(?:async\s+)?function\s+([A-Z][A-Za-z0-9_]*)\s*\(([^)]*)\)/g)) {
+    if (seen.has(match[2]))
+      continue;
+    if (!hasJsx(content.slice(match.index ?? 0, (match.index ?? 0) + 5e3)))
+      continue;
+    seen.add(match[2]);
+    result.push(makeComponent(match[2], file, match[1] ? "default" : "named", match[3], content));
+  }
+  for (const match of content.matchAll(/export\s+(default\s+)?const\s+([A-Z][A-Za-z0-9_]*)\s*=/g)) {
+    if (seen.has(match[2]))
+      continue;
+    if (!hasJsx(content.slice(match.index ?? 0, (match.index ?? 0) + 5e3)))
+      continue;
+    seen.add(match[2]);
+    result.push(makeComponent(match[2], file, match[1] ? "default" : "named", "", content));
+  }
+  return result;
+}
+function hasJsx(value2) {
+  return /<[A-Za-z][^>]*>/.test(value2) || /React\.createElement/.test(value2);
+}
+function makeComponent(name, file, exportKind, params, content) {
+  const props = [];
+  if (params.includes("{")) {
+    const inside = params.slice(params.indexOf("{") + 1, params.lastIndexOf("}"));
+    for (const part of inside.split(",")) {
+      const clean = part.trim().replace(/^\.\.\./, "").split(":")[0].split("=")[0].trim();
+      if (/^[A-Za-z_$][\w$]*$/.test(clean))
+        props.push(clean);
+    }
+  } else {
+    const typeName = params.split(":").pop()?.trim();
+    if (typeName) {
+      const typeRegex = new RegExp("(?:interface|type)\\s+" + typeName.replace(/[^\w]/g, "") + "[^\\{]*\\{([\\s\\S]*?)\\}");
+      const typeMatch = typeRegex.exec(content);
+      if (typeMatch)
+        for (const line of typeMatch[1].split("\n")) {
+          const prop = line.match(/^\s*([A-Za-z_$][\w$]*)\??\s*:/);
+          if (prop)
+            props.push(prop[1]);
+        }
+    }
+  }
+  return { name, path: file, exportKind, props: [...new Set(props)], variants: extractVariants(content), usedBy: [], status: "candidate" };
+}
+function extractVariants(source) {
+  const result = {};
+  const match = /cva\s*\(/.exec(source);
+  if (!match)
+    return result;
+  const open = source.indexOf("(", match.index);
+  const close = findMatching(source, open, "(", ")");
+  if (close < 0)
+    return result;
+  const call = source.slice(open + 1, close);
+  const variantsMatch = /variants\s*:\s*\{/.exec(call);
+  if (!variantsMatch)
+    return result;
+  const openBrace = call.indexOf("{", variantsMatch.index);
+  const closeBrace = findMatching(call, openBrace, "{", "}");
+  if (closeBrace < 0)
+    return result;
+  const groups = parseObjectBody(call.slice(openBrace + 1, closeBrace));
+  for (const [key, value2] of Object.entries(groups))
+    if (typeof value2 === "object")
+      result[key] = Object.keys(value2);
+  return result;
+}
+function collectImports(content) {
+  const result = [];
+  for (const match of content.matchAll(/import\s+([^;]+?)\s+from\s+['"]([^'"]+)['"]/g)) {
+    const clause = match[1].trim();
+    const specifier = match[2];
+    const beforeBraces = clause.split("{")[0].trim();
+    if (beforeBraces && /^[A-Za-z_$][\w$]*$/.test(beforeBraces) && beforeBraces !== "*")
+      result.push({ imported: beforeBraces, specifier });
+    const named = clause.match(/\{([^}]*)\}/);
+    if (named)
+      for (const part of named[1].split(",")) {
+        const name = part.trim().split(/\s+as\s+/)[0].trim();
+        if (/^[A-Za-z_$][\w$]*$/.test(name))
+          result.push({ imported: name, specifier });
+      }
+  }
+  return result;
+}
+function fallbackImportPath(file, alias) {
+  const noExt = extensionless(file);
+  if (alias && noExt.startsWith(alias.target + "/"))
+    return alias.prefix + noExt.slice(alias.target.length + 1);
+  return noExt;
+}
+function scanPages(root, files, pageDirs, components) {
+  const pages = [];
+  for (const file of files) {
+    if (!isPageFile(file, pageDirs))
+      continue;
+    const content = readText(join2(root, file));
+    const tags = [...content.matchAll(/<([A-Z][A-Za-z0-9_]*)/g)].map((match) => match[1]);
+    pages.push({ path: file, type: classifyPage(file, content, tags), components: [...new Set(tags)].sort(), reference: false });
+  }
+  const preferred = pages.find((page) => page.type === "data-list" && /orders|users|list/.test(page.path)) ?? pages.find((page) => page.type === "data-list");
+  if (preferred)
+    preferred.reference = true;
+  return pages;
+}
+function isPageFile(file, pageDirs) {
+  if (!/\.(tsx|jsx)$/.test(file))
+    return false;
+  const base = basename(file);
+  if (base === "page.tsx" || base === "page.jsx")
+    return true;
+  if (pageDirs.some((dir) => file.startsWith(dir + "/"))) {
+    if (/\.(test|spec|stories)\./.test(file))
+      return false;
+    if (/(^|\/)(_app|_document|api)(\/|\.)/.test(file))
+      return false;
+    return true;
+  }
+  return false;
+}
+function classifyPage(file, content, tags) {
+  const path = file.toLowerCase();
+  if (/(login|signin|sign-in|register|auth)/.test(path))
+    return "auth";
+  if (/settings/.test(path))
+    return "settings";
+  if (/\[.*\]/.test(path) || /detail/.test(path))
+    return "detail";
+  if (tags.some((tag) => /DataTable|Table/.test(tag)) || /<table\b/.test(content))
+    return "data-list";
+  if (/dashboard/.test(path) || tags.some((tag) => /Chart|Stat|Kpi/.test(tag)))
+    return "dashboard";
+  if (tags.some((tag) => /Form|Input|Field/.test(tag)) || /<form\b/.test(content))
+    return "form";
+  return "page";
+}
+
+// ../core/dist/spec.js
+import { existsSync as existsSync4 } from "node:fs";
+import { join as join4 } from "node:path";
+
+// ../core/dist/preview.js
+function css(value2) {
+  return String(value2).replace(/[;{}<>"']/g, "").trim();
+}
+function renderPreview(spec) {
+  const c = spec.tokens.colors;
+  const r = spec.tokens.radius;
+  const font = spec.tokens.fonts.sans;
+  const statusLabel = spec.status === "approved" ? "APPROVED" : "DRAFT";
+  const statusClass = spec.status === "approved" ? "ok" : "draft";
+  const project = escapeHtml(spec.project.name);
+  const items = spec.items.map((item) => "<tr><td><code>" + escapeHtml(item.id) + "</code></td><td>" + escapeHtml(item.title) + "</td><td>" + item.status + "</td></tr>").join("");
+  const kpis = [
+    ["Revenue", "$48.2k", "+12.4%", [34, 48, 42, 58, 52, 71, 66, 84]],
+    ["Active users", "1,284", "+8.2%", [28, 36, 44, 40, 55, 58, 64, 72]],
+    ["Conversion", "3.8%", "+0.6%", [42, 38, 48, 45, 54, 51, 62, 66]],
+    ["Churn", "1.2%", "-0.3%", [72, 66, 68, 58, 54, 49, 44, 38]]
+  ].map(([label, value2, delta, bars]) => '<article class="u-kpi"><div class="u-kpi__top"><span>' + label + "</span><i></i></div><strong>" + value2 + '</strong><div class="u-kpi__meta"><em>' + delta + '</em><span>vs last month</span></div><div class="u-spark">' + bars.map((height) => '<i style="height:' + height + '%"></i>').join("") + "</div></article>").join("");
+  const rows = [
+    ["AM", "Avery Moss", "avery@northwind.dev", "Owner", "Active", "2m ago", true],
+    ["JL", "Jonas Lee", "jonas@northwind.dev", "Admin", "Active", "1h ago", false],
+    ["RK", "Rina Kato", "rina@northwind.dev", "Editor", "Invited", "3h ago", false],
+    ["TS", "Tom\xE1s Silva", "tomas@northwind.dev", "Viewer", "Active", "1d ago", false]
+  ].map(([initials, name, email, role, state, seen, selected]) => '<div class="u-tr' + (selected ? " is-selected" : "") + '"><span class="u-check">' + (selected ? "\u2713" : "") + '</span><span class="u-person"><b class="u-avatar">' + initials + "</b><span><strong>" + name + "</strong><small>" + email + '</small></span></span><span><span class="u-badge">' + role + '</span></span><span class="u-state"><i></i>' + state + '</span><span class="u-muted">' + seen + "</span></div>").join("");
+  const specRows = spec.items.map((item) => "<tr><td><code>" + escapeHtml(item.id) + "</code></td><td>" + escapeHtml(item.title) + "</td><td>" + item.rules.map(escapeHtml).join(" ") + "</td></tr>").join("");
+  const doc = [
+    "<!doctype html>",
+    '<html lang="en">',
+    "<head>",
+    '<meta charset="utf-8">',
+    '<meta name="viewport" content="width=device-width, initial-scale=1">',
+    '<meta name="robots" content="noindex, nofollow">',
+    "<title>" + project + " \u2014 UI spec preview</title>",
+    "<style>",
+    ":root{--u-bg:" + css(c.background) + ";--u-surface:" + css(c.surface) + ";--u-primary:" + css(c.primary) + ";--u-ink:" + css(c.text) + ";--u-muted:" + css(c.muted) + ";--u-border:" + css(c.border) + ";--u-ok:" + css(c.success) + ";--u-warn:" + css(c.warning) + ";--u-danger:" + css(c.danger) + ";--u-radius:" + css(r.md) + ";--u-radius-sm:" + css(r.sm) + ";--u-radius-lg:" + css(r.lg) + ";--u-font:" + css(font) + ";}",
+    "*{box-sizing:border-box}html{background:var(--u-bg);color-scheme:light}body{margin:0;background:var(--u-bg);color:var(--u-ink);font-family:var(--u-font);font-size:14px;line-height:1.5;-webkit-font-smoothing:antialiased}button{font:inherit;cursor:pointer}code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:.86em}",
+    ".u-bar{display:flex;align-items:center;justify-content:space-between;gap:16px;padding:12px 22px;border-bottom:1px solid var(--u-border);background:var(--u-surface);font-size:11px;color:var(--u-muted)}.u-bar__brand{display:flex;align-items:center;gap:10px;color:var(--u-ink);font-weight:650}.u-mark{display:inline-flex;align-items:center;justify-content:center;width:22px;height:22px;border-radius:6px;background:var(--u-primary);color:#fff;font-size:9px;font-weight:700;letter-spacing:.02em}.u-status{display:inline-flex;align-items:center;gap:6px;padding:4px 8px;border:1px solid var(--u-border);border-radius:999px;font-size:10px;letter-spacing:.05em;text-transform:uppercase;color:var(--u-muted)}.u-status i{width:5px;height:5px;border-radius:50%;background:var(--u-warn)}.u-status.ok i{background:var(--u-ok)}",
+    ".u-wrap{width:min(calc(100% - 32px),1240px);margin:0 auto;padding:28px 0 54px}.u-intro{max-width:720px;margin:0 auto 24px;text-align:center}.u-kicker{margin:0 0 8px;color:var(--u-primary);font-size:10px;font-weight:650;letter-spacing:.12em;text-transform:uppercase}.u-intro h1{margin:0;font-size:clamp(26px,4vw,42px);font-weight:650;letter-spacing:-.04em;line-height:1.08}.u-intro p{margin:10px auto 0;max-width:58ch;color:var(--u-muted);font-size:13px}.u-approve{display:inline-flex;align-items:center;gap:7px;margin-top:14px;padding:7px 10px;border:1px solid var(--u-border);border-radius:999px;background:var(--u-surface);font-size:10px;color:var(--u-muted)}.u-approve code{color:var(--u-ink)}",
+    ".u-shell{display:grid;grid-template-columns:220px minmax(0,1fr);overflow:hidden;border:1px solid var(--u-border);border-radius:16px;background:var(--u-surface);box-shadow:0 24px 60px -36px rgba(15,23,42,.35)}",
+    ".u-side{display:flex;flex-direction:column;padding:16px 12px;background:color-mix(in srgb,var(--u-primary) 5%,var(--u-surface));border-right:1px solid var(--u-border)}.u-brand{display:flex;align-items:center;gap:8px;padding:2px 8px;font-weight:700;letter-spacing:-.02em}.u-brand b{display:inline-flex;align-items:center;justify-content:center;width:22px;height:22px;border-radius:6px;background:var(--u-ink);color:var(--u-surface);font-size:9px}.u-nav{display:grid;gap:2px;margin-top:22px}.u-nav span{padding:8px 10px;border-radius:7px;color:var(--u-muted);font-size:12px}.u-nav span.is-active{background:var(--u-surface);color:var(--u-ink);font-weight:650;box-shadow:0 1px 3px rgba(15,23,42,.08);border-left:2px solid var(--u-primary)}.u-nav small{display:block;margin:14px 10px 5px;color:var(--u-muted);font-size:9px;font-weight:600;letter-spacing:.1em;text-transform:uppercase}.u-side__foot{margin-top:auto;padding:10px;border:1px solid var(--u-border);border-radius:9px;background:var(--u-surface);font-size:10px;color:var(--u-muted)}.u-side__foot strong{display:block;margin-top:3px;color:var(--u-ink);font-size:14px}.u-side__meter{height:5px;margin-top:7px;border-radius:99px;background:var(--u-border);overflow:hidden}.u-side__meter i{display:block;width:62%;height:100%;background:var(--u-primary)}",
+    ".u-main{min-width:0;padding:16px 20px 22px}.u-top{display:flex;align-items:center;justify-content:space-between;gap:12px;padding-bottom:10px;border-bottom:1px solid var(--u-border);color:var(--u-muted);font-size:10px}.u-top__right{display:flex;align-items:center;gap:8px}.u-search{padding:5px 9px;border:1px solid var(--u-border);border-radius:999px;color:var(--u-muted);font-size:10px;background:var(--u-bg)}.u-avatar{display:inline-flex;align-items:center;justify-content:center;width:24px;height:24px;border-radius:50%;background:color-mix(in srgb,var(--u-primary) 14%,var(--u-surface));color:var(--u-primary);font-size:9px;font-weight:700;font-style:normal}.u-pagehead{display:flex;align-items:flex-start;justify-content:space-between;gap:14px;margin:18px 0 14px}.u-pagehead h2{margin:0;font-size:24px;line-height:1.1;letter-spacing:-.04em}.u-pagehead p{margin:4px 0 0;color:var(--u-muted);font-size:11px}.u-btn{display:inline-flex;align-items:center;gap:6px;padding:7px 10px;border:1px solid var(--u-primary);border-radius:7px;background:var(--u-primary);color:#fff;font-size:11px;font-weight:650}.u-btn--ghost{background:var(--u-surface);color:var(--u-muted);border-color:var(--u-border)}",
+    ".u-kpis{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:10px}.u-kpi{padding:11px;border:1px solid var(--u-border);border-radius:var(--u-radius);background:var(--u-surface)}.u-kpi__top{display:flex;align-items:center;justify-content:space-between;color:var(--u-muted);font-size:10px}.u-kpi__top i{width:6px;height:6px;border:1px solid var(--u-border)}.u-kpi strong{display:block;margin-top:5px;font-size:22px;font-weight:650;letter-spacing:-.04em;line-height:1}.u-kpi__meta{display:flex;align-items:center;gap:5px;margin-top:4px;color:var(--u-muted);font-size:9px}.u-kpi__meta em{color:var(--u-ok);font-style:normal;font-weight:650}.u-spark{display:flex;align-items:flex-end;gap:3px;height:24px;margin-top:7px}.u-spark i{flex:1;min-height:2px;border-radius:2px 2px 0 0;background:color-mix(in srgb,var(--u-primary) 55%,var(--u-surface))}.u-spark i:last-child{background:var(--u-primary)}",
+    ".u-grid{display:grid;grid-template-columns:minmax(0,1.5fr) minmax(0,.9fr);gap:10px;margin-top:10px}.u-card{min-width:0;padding:12px;border:1px solid var(--u-border);border-radius:var(--u-radius);background:var(--u-surface)}.u-card__head{display:flex;align-items:center;justify-content:space-between;gap:10px;margin-bottom:10px}.u-card__head h3{margin:0;font-size:12px;font-weight:650}.u-card__head span{color:var(--u-muted);font-size:9px}.u-chart{width:100%;height:150px;overflow:visible}.u-axis{display:flex;justify-content:space-between;margin-top:4px;color:var(--u-muted);font-size:8px}.u-legend{display:inline-flex;align-items:center;gap:4px;color:var(--u-muted);font-size:9px}.u-legend i{width:6px;height:6px;border-radius:2px;background:var(--u-primary)}.u-tip{position:relative;margin-top:-34px;margin-left:58%;width:max-content;padding:3px 5px;border-radius:4px;background:var(--u-ink);color:var(--u-surface);font-size:8px}",
+    ".u-tabs{display:flex;gap:8px;border-bottom:1px solid var(--u-border);margin-bottom:9px}.u-tabs span{padding:6px 2px;color:var(--u-muted);font-size:10px;border-bottom:2px solid transparent}.u-tabs span.is-active{color:var(--u-ink);border-bottom-color:var(--u-primary);font-weight:650}.u-table{border:1px solid var(--u-border);border-radius:var(--u-radius-sm);overflow:hidden}.u-tr{display:grid;grid-template-columns:14px minmax(0,1.4fr) .55fr .58fr .45fr;align-items:center;gap:7px;padding:7px 8px;border-top:1px solid var(--u-border);font-size:9px;color:var(--u-muted)}.u-tr:first-child{border-top:0}.u-tr.is-selected{background:color-mix(in srgb,var(--u-primary) 7%,var(--u-surface));color:var(--u-ink)}.u-check{display:inline-flex;align-items:center;justify-content:center;width:11px;height:11px;border:1px solid var(--u-border);border-radius:3px;color:var(--u-primary);font-size:8px}.u-tr.is-selected .u-check{border-color:var(--u-primary);background:var(--u-primary);color:#fff}.u-person{display:flex;align-items:center;gap:6px;min-width:0}.u-person>span{display:grid;min-width:0}.u-person strong{font-size:9px;font-weight:650;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.u-person small{color:var(--u-muted);font-size:8px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.u-avatar{width:19px;height:19px;font-size:7px}.u-badge{display:inline-block;padding:2px 5px;border:1px solid var(--u-border);border-radius:4px;font-size:8px;color:var(--u-muted)}.u-state{display:inline-flex;align-items:center;gap:3px;font-size:8px}.u-state i{width:4px;height:4px;border-radius:50%;background:var(--u-ok)}.u-muted{color:var(--u-muted)}",
+    ".u-lower{display:grid;grid-template-columns:minmax(0,1.15fr) minmax(0,.85fr);gap:10px;margin-top:10px}.u-back{display:inline-flex;align-items:center;gap:5px;margin-bottom:7px;color:var(--u-primary);font-size:10px;font-weight:650}.u-crumb{color:var(--u-muted);font-size:9px}.u-subtitle{display:flex;align-items:center;gap:8px;margin-top:3px;font-size:17px;font-weight:650;letter-spacing:-.03em}.u-lines{display:grid;gap:6px;margin-top:9px}.u-lines label{color:var(--u-muted);font-size:8px;text-transform:uppercase;letter-spacing:.08em}.u-lines div{height:24px;border:1px solid var(--u-border);border-radius:5px;background:var(--u-bg)}.u-form{display:grid;grid-template-columns:1fr 1fr;gap:7px;margin-top:8px}.u-form .u-lines{margin:0}.u-modal{padding:0;overflow:hidden}.u-modal__head{display:flex;align-items:center;justify-content:space-between;padding:11px 12px;border-bottom:1px solid var(--u-border);font-size:12px;font-weight:650}.u-modal__body{display:grid;gap:8px;padding:12px}.u-modal__foot{display:flex;align-items:center;justify-content:space-between;padding:9px 12px;border-top:1px solid var(--u-border);font-size:10px}.u-danger{color:var(--u-danger)}.u-modal__save{padding:5px 9px;border-radius:5px;background:var(--u-primary);color:#fff;font-size:10px;font-weight:650}",
+    ".u-states{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:10px;margin-top:10px}.u-state-card{min-height:108px;display:grid;align-content:center;justify-items:center;gap:5px;text-align:center;color:var(--u-muted);font-size:10px}.u-state-card b{color:var(--u-ink);font-size:11px}.u-state-box{width:34px;height:24px;border:1px dashed var(--u-border);border-radius:5px;background:var(--u-bg)}.u-skeleton{display:grid;gap:5px;width:70%}.u-skeleton i{height:6px;border-radius:99px;background:var(--u-border)}.u-skeleton i:last-child{width:62%}.u-error{width:26px;height:26px;display:grid;place-items:center;border-radius:50%;background:color-mix(in srgb,var(--u-danger) 12%,var(--u-surface));color:var(--u-danger);font-weight:700}",
+    ".u-index{margin-top:24px}.u-index h2{font-size:22px;letter-spacing:-.03em;margin:0 0 4px}.u-index p{margin:0 0 12px;color:var(--u-muted);font-size:12px}.u-index table{width:100%;border-collapse:collapse;border:1px solid var(--u-border);border-radius:10px;overflow:hidden;background:var(--u-surface);font-size:11px}.u-index th{padding:9px 10px;border-bottom:1px solid var(--u-border);color:var(--u-muted);font-size:9px;text-align:left;letter-spacing:.06em;text-transform:uppercase;font-weight:600}.u-index td{padding:9px 10px;border-bottom:1px solid var(--u-border);color:var(--u-muted);vertical-align:top}.u-index tr:last-child td{border-bottom:0}.u-index td:first-child{white-space:nowrap}.u-index code{color:var(--u-primary)}",
+    ".u-foot{margin:24px auto 0;max-width:820px;text-align:center;color:var(--u-muted);font-size:10px}.u-foot strong{color:var(--u-ink)}",
+    "@media(max-width:980px){.u-shell{grid-template-columns:64px minmax(0,1fr)}.u-side{padding:12px 8px}.u-brand span,.u-nav span:not(.is-active),.u-nav small,.u-side__foot{display:none}.u-nav span{display:flex;justify-content:center;padding:8px 0;font-size:0}.u-nav span::before{content:'';width:6px;height:6px;border:1px solid currentColor;border-radius:2px}.u-nav span.is-active{display:flex}.u-nav span.is-active::after{content:'';width:14px;height:2px;background:var(--u-primary)}}",
+    "@media(max-width:760px){.u-wrap{width:calc(100% - 20px);padding-top:18px}.u-shell{grid-template-columns:1fr}.u-side{flex-direction:row;align-items:center;gap:8px;border-right:0;border-bottom:1px solid var(--u-border);padding:8px 10px}.u-brand span{display:inline}.u-nav{display:flex;margin:0;gap:2px;overflow:auto}.u-nav span{display:block;padding:6px 7px;font-size:9px}.u-nav span::before{display:none}.u-nav small{display:none}.u-side__foot{display:none}.u-main{padding:12px}.u-kpis{grid-template-columns:1fr 1fr}.u-grid,.u-lower,.u-states{grid-template-columns:1fr}.u-pagehead h2{font-size:20px}.u-table{overflow-x:auto}.u-tr{min-width:520px}.u-index{overflow-x:auto}.u-index table{min-width:640px}.u-intro h1{font-size:26px}}",
+    "@media(max-width:460px){.u-kpis{grid-template-columns:1fr}.u-form{grid-template-columns:1fr}.u-bar{padding:10px 12px}.u-bar__brand span:last-child{display:none}}",
+    "</style>",
+    "</head>",
+    "<body>",
+    '<header class="u-bar"><div class="u-bar__brand"><span class="u-mark">UI</span><span>' + project + '</span><span>UI spec preview</span></div><span class="u-status ' + statusClass + '"><i></i>' + statusLabel + " \xB7 v" + escapeHtml(spec.specVersion) + "</span></header>",
+    '<main class="u-wrap">',
+    '<header class="u-intro"><p class="u-kicker">UI-only preview / ' + escapeHtml(spec.archetype) + "</p><h1>" + project + ' UI spec</h1><p>Navigation, selected states, cards, charts, dialogs, secondary pages, back buttons, forms, and data states. Static fixtures only; no API, auth, or mutations.</p><span class="u-approve"><code>npx uifying spec approve</code> when this looks right</span></header>',
+    '<div class="u-shell">',
+    '<aside class="u-side" id="nav"><div class="u-brand"><b>N</b><span>Northwind</span></div><nav class="u-nav"><small>Workspace</small><span class="is-active">Overview</span><span>Orders</span><span>Customers</span><span>Products</span><small>Settings</small><span>Team</span><span>Billing</span></nav><div class="u-side__foot">Seats<strong>12 / 20</strong><div class="u-side__meter"><i></i></div></div></aside>',
+    '<section class="u-main">',
+    '<div class="u-top"><span>Workspace / Overview</span><span class="u-top__right"><span class="u-search">Search</span><span class="u-avatar">AM</span></span></div>',
+    '<div class="u-pagehead"><div><h2>Overview</h2><p>Manage access, roles, and workspace health.</p></div><div><button class="u-btn">+ New report</button></div></div>',
+    '<div class="u-kpis" id="card">' + kpis + "</div>",
+    '<div class="u-grid"><section class="u-card" id="chart"><div class="u-card__head"><h3>Revenue</h3><span class="u-legend"><i></i>Net</span></div><svg class="u-chart" viewBox="0 0 560 150" preserveAspectRatio="none" aria-hidden="true"><defs><linearGradient id="u-fill" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="var(--u-primary)" stop-opacity=".22"/><stop offset="1" stop-color="var(--u-primary)" stop-opacity="0"/></linearGradient></defs><path d="M0 120H560M0 80H560M0 40H560" stroke="var(--u-border)" stroke-width="1"/><path d="M0 112 C40 104 58 108 88 82 S146 58 178 70 S226 98 260 62 S308 36 348 48 S408 22 442 32 S500 18 560 24 L560 150 L0 150 Z" fill="url(#u-fill)"/><path d="M0 112 C40 104 58 108 88 82 S146 58 178 70 S226 98 260 62 S308 36 348 48 S408 22 442 32 S500 18 560 24" fill="none" stroke="var(--u-primary)" stroke-width="2"/><circle cx="442" cy="32" r="4" fill="var(--u-surface)" stroke="var(--u-primary)" stroke-width="2"/></svg><div class="u-tip">$6.4k</div><div class="u-axis"><span>Mon</span><span>Wed</span><span>Fri</span><span>Sun</span></div></section>',
+    '<section class="u-card"><div class="u-card__head"><h3>Top channels</h3><span>Last 30 days</span></div><div class="u-lines"><label>Direct</label><div style="background:var(--u-primary);border-color:var(--u-primary);width:78%"></div><label>Organic</label><div style="width:61%"></div><label>Referral</label><div style="width:42%"></div></div><div style="margin-top:11px;color:var(--u-muted);font-size:9px">4 channels \xB7 12,840 visits</div></section></div>',
+    '<section class="u-card" id="selected" style="margin-top:10px"><div class="u-card__head"><h3>Recent members</h3><span>Selected row uses SEL-01</span></div><div class="u-tabs"><span class="is-active">All</span><span>Paid</span><span>Pending</span></div><div class="u-table">' + rows + "</div></section>",
+    "</section></div>",
+    '<div class="u-lower"><section class="u-card" id="page"><span class="u-back">\u2190 Back to orders</span><div class="u-crumb">Orders / #1042</div><div class="u-subtitle">Order #1042 <span class="u-badge">Paid</span></div><div class="u-tabs" style="margin-top:10px"><span class="is-active">Summary</span><span>Items</span><span>Activity</span></div><div class="u-form"><div class="u-lines"><label>Customer</label><div></div></div><div class="u-lines"><label>Status</label><div></div></div><div class="u-lines"><label>Total</label><div></div></div><div class="u-lines"><label>Created</label><div></div></div></div></section>',
+    '<section class="u-card u-modal" id="modal"><div class="u-modal__head">Edit user <span class="u-muted">\xD7</span></div><div class="u-modal__body"><div class="u-lines"><label>Role</label><div></div></div><div class="u-lines"><label>Status</label><div></div></div></div><div class="u-modal__foot"><span class="u-danger">Remove access</span><span class="u-modal__save">Save changes</span></div></section></div>',
+    '<div class="u-states" id="states"><section class="u-card u-state-card"><div class="u-state-box"></div><b>Empty</b><span>Nothing here yet. Use the same card shell.</span></section><section class="u-card u-state-card"><div class="u-skeleton"><i></i><i></i><i></i></div><b>Loading</b><span>Skeleton matches the final layout.</span></section><section class="u-card u-state-card"><div class="u-error">!</div><b>Error</b><span>Actionable message and retry.</span></section></div>',
+    '<section class="u-index" id="spec-index"><h2>Spec index</h2><p>Each rule is versioned and traceable. The checker cites these IDs.</p><table><thead><tr><th>ID</th><th>Rule</th><th>Definition</th></tr></thead><tbody>' + specRows + "</tbody></table></section>",
+    '<p class="u-foot"><strong>' + statusLabel + " spec v" + escapeHtml(spec.specVersion) + "</strong> \xB7 Generated by UIfying. Static fixtures, no API calls, auth, or mutations. Approve with <code>uifying spec approve</code>.</p>",
+    "</main>",
+    "</body>",
+    "</html>"
+  ];
+  return doc.join("\n");
+}
+
+// ../core/dist/skill.js
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
+import { join as join3 } from "node:path";
+
+// ../core/dist/skill-template.js
+var SKILL_TEMPLATE = '---\nname: uifying\ndescription: Use when creating or changing UI in a project with a .uifying/ directory. Read the approved UI spec, retrieve task-scoped context, reuse existing components, and run the consistency checker after implementation.\n---\n\n<!-- uifying:managed:start -->\n# UIfying \u2014 UI consistency workflow\n\nThis project has UIfying installed.\n\n**Spec files:** `.uifying/spec.json` and `.uifying/spec.md`\n**Preview:** `.uifying/preview/index.html`\n\n## Before any UI work\n\n1. Read `.uifying/spec.json` and `.uifying/spec.md`.\n2. Run `uifying status`. If the spec is not approved, do not invent a new pattern. Show the preview with `uifying spec preview --serve` and ask the user to approve it with `uifying spec approve`.\n3. Retrieve task-scoped context:\n\n   ~~~bash\n   uifying context "<task description>" --json\n   ~~~\n\n4. Reuse the returned components and import paths. Follow the returned spec IDs and tokens.\n5. If the task needs a pattern the spec does not cover, propose a spec change and a preview update first. Do not silently deviate.\n\n## After UI work\n\n1. Run the checker:\n\n   ~~~bash\n   uifying check --base <base-branch>\n   ~~~\n\n2. Fix findings that have clear evidence. Do not delete or weaken a rule to make the check pass.\n3. Re-run the checker after fixes. Report remaining ambiguous findings to the user.\n4. Do not modify unrelated pages, global tokens, or the spec baseline without explicit approval.\n\n## Source of truth\n\n- The approved spec wins over current code for new UI.\n- Current code is evidence, not the destination.\n- The checker cites spec IDs, file paths, lines, and evidence.\n- No source upload and no account are required.\n\n## When a command is unavailable\n\nRead `.uifying/spec.json` directly, follow its items and tokens, and report that the CLI could not be run. Do not guess the approved pattern.\n<!-- uifying:managed:end -->\n';
+
+// ../core/dist/skill.js
+var START = "<!-- uifying:managed:start -->";
+var END = "<!-- uifying:managed:end -->";
+function renderSkill(spec) {
+  void spec;
+  return SKILL_TEMPLATE.endsWith("\n") ? SKILL_TEMPLATE : SKILL_TEMPLATE + "\n";
+}
+function codexBlock(spec) {
+  return renderSkill(spec).replace(/^---\n[\s\S]*?\n---\n+/, "");
+}
+function installSkill(root, agent, spec) {
+  const installed = [];
+  if (!agent)
+    return installed;
+  if (agent === "claude") {
+    const file = join3(root, ".claude", "skills", "uifying", "SKILL.md");
+    if (existsSync3(file)) {
+      const existing = readFileSync2(file, "utf8");
+      if (!existing.includes(START))
+        return installed;
+    }
+    ensureDir(join3(root, ".claude", "skills", "uifying"));
+    writeText(file, renderSkill(spec));
+    installed.push(file);
+  }
+  if (agent === "codex") {
+    const file = join3(root, "AGENTS.md");
+    const content = codexBlock(spec);
+    if (!existsSync3(file)) {
+      writeText(file, content);
+      installed.push(file);
+    } else {
+      const existing = readFileSync2(file, "utf8");
+      if (existing.includes(START) && existing.includes(END)) {
+        const before = existing.slice(0, existing.indexOf(START));
+        const after = existing.slice(existing.indexOf(END) + END.length);
+        writeText(file, before + content + after.replace(/^\n/, ""));
+      } else {
+        writeText(file, existing.replace(/\s*$/, "") + "\n\n" + content + "\n");
+      }
+      installed.push(file);
+    }
+  }
+  return installed;
+}
+
+// ../core/dist/spec.js
+var SPEC_VERSION = "0.1.0";
+function memoryPaths(root) {
+  const dir = join4(root, ".uifying");
+  const preview2 = join4(dir, "preview");
+  const skill = join4(dir, "skill");
+  return {
+    dir,
+    config: join4(dir, "config.json"),
+    spec: join4(dir, "spec.json"),
+    specMd: join4(dir, "spec.md"),
+    tokens: join4(dir, "tokens.json"),
+    components: join4(dir, "components.json"),
+    patterns: join4(dir, "patterns.json"),
+    evidence: join4(dir, "evidence.json"),
+    baseline: join4(dir, "baseline.json"),
+    preview: preview2,
+    previewFile: join4(preview2, "index.html"),
+    skill,
+    skillFile: join4(skill, "SKILL.md")
+  };
+}
+function readSpec(root) {
+  const paths = memoryPaths(root);
+  if (!existsSync4(paths.spec))
+    return null;
+  return readJson(paths.spec);
+}
+function readConfig(root) {
+  const paths = memoryPaths(root);
+  if (!existsSync4(paths.config))
+    return null;
+  return readJson(paths.config);
+}
+function buildSpec(scan, existing, options = {}) {
+  const archetype = detectArchetype(scan);
+  const now = nowIso();
+  const preserve = Boolean(existing && !options.force);
+  const status2 = preserve && existing ? existing.status : "draft";
+  const existingById = new Map((existing?.items ?? []).map((item) => [item.id, item]));
+  const generatedItems = archetype === "dashboard-admin" ? dashboardItems(scan) : appItems(scan);
+  const items = generatedItems.map((item) => {
+    const previous = existingById.get(item.id);
+    if (previous) {
+      return {
+        ...item,
+        rules: previous.rules?.length ? previous.rules : item.rules,
+        evidence: previous.evidence?.length ? previous.evidence : item.evidence,
+        status: previous.status
+      };
+    }
+    return { ...item, status: status2 };
+  });
+  const createdAt = preserve && existing ? existing.createdAt : now;
+  const specVersion = preserve && existing ? existing.specVersion : SPEC_VERSION;
+  const approvedAt = preserve && existing ? existing.approvedAt : void 0;
+  return {
+    schemaVersion: "1",
+    specVersion,
+    status: status2,
+    archetype,
+    createdAt,
+    updatedAt: now,
+    approvedAt,
+    project: scan.info,
+    tokens: scan.tokens,
+    components: scan.components,
+    patterns: scan.patterns,
+    items,
+    preview: "preview/index.html"
+  };
+}
+function writeMemory(root, spec, options = {}) {
+  const paths = memoryPaths(root);
+  ensureDir(paths.preview);
+  ensureDir(paths.skill);
+  const config = {
+    schemaVersion: "1",
+    projectRoot: ".",
+    ignore: options.ignore ?? readConfig(root)?.ignore ?? [],
+    componentDirs: spec.project.componentDirs,
+    pageDirs: spec.project.pageDirs,
+    agent: options.agent ?? readConfig(root)?.agent ?? null,
+    generatedAt: nowIso()
+  };
+  const baseline = {
+    specVersion: spec.specVersion,
+    status: spec.status,
+    approvedAt: spec.approvedAt,
+    authoritativeComponents: spec.components.filter((component) => component.status === "approved").map((component) => component.path),
+    goldenPages: spec.patterns.filter((page) => page.reference).map((page) => page.path),
+    exceptions: []
+  };
+  writeJson(paths.config, config);
+  writeJson(paths.spec, spec);
+  writeJson(paths.tokens, spec.tokens);
+  writeJson(paths.components, spec.components);
+  writeJson(paths.patterns, spec.patterns);
+  writeJson(paths.evidence, Object.fromEntries(spec.items.map((item) => [item.id, item.evidence])));
+  writeJson(paths.baseline, baseline);
+  writeText(paths.specMd, renderSpecMarkdown(spec));
+  writeText(paths.previewFile, renderPreview(spec));
+  writeText(paths.skillFile, renderSkill(spec));
+  return paths;
+}
+function approveMemory(root) {
+  const spec = readSpec(root);
+  if (!spec)
+    throw new Error("No .uifying/spec.json found. Run uifying init first.");
+  const approved = {
+    ...spec,
+    status: "approved",
+    approvedAt: nowIso(),
+    updatedAt: nowIso(),
+    items: spec.items.map((item) => ({ ...item, status: "approved" }))
+  };
+  const paths = writeMemory(root, approved, { agent: readConfig(root)?.agent ?? null });
+  writeText(paths.previewFile, renderPreview(approved));
+  return approved;
+}
+function renderSpecMarkdown(spec) {
+  const lines = [];
+  lines.push("# " + spec.project.name + " UI Spec");
+  lines.push("");
+  lines.push("**Status:** " + spec.status);
+  lines.push("**Spec version:** " + spec.specVersion);
+  lines.push("**Archetype:** " + spec.archetype);
+  lines.push("**Updated:** " + spec.updatedAt);
+  if (spec.approvedAt)
+    lines.push("**Approved:** " + spec.approvedAt);
+  lines.push("");
+  lines.push("> This file is generated by UIfying. The approved spec is the contract for new UI. The current code is evidence, not the specification.");
+  lines.push("");
+  lines.push("## Project");
+  lines.push("");
+  lines.push("| Key | Value |");
+  lines.push("|---|---|");
+  lines.push("| Framework | " + spec.project.framework + " |");
+  lines.push("| TypeScript | " + (spec.project.typescript ? "yes" : "no") + " |");
+  lines.push("| Tailwind | " + (spec.project.tailwind ?? "not detected") + " |");
+  lines.push("| Component dirs | " + (spec.project.componentDirs.join(", ") || "none") + " |");
+  lines.push("| Page dirs | " + (spec.project.pageDirs.join(", ") || "none") + " |");
+  lines.push("| Global CSS | " + (spec.project.globalsCss ?? "none") + " |");
+  lines.push("");
+  lines.push("## Foundations");
+  lines.push("");
+  lines.push("| Token | Value |");
+  lines.push("|---|---|");
+  for (const [key, value2] of Object.entries(spec.tokens.colors))
+    lines.push("| color." + key + " | " + value2 + " |");
+  for (const [key, value2] of Object.entries(spec.tokens.radius))
+    lines.push("| radius." + key + " | " + value2 + " |");
+  for (const [key, value2] of Object.entries(spec.tokens.spacing))
+    lines.push("| space." + key + " | " + value2 + " |");
+  lines.push("| font.sans | " + spec.tokens.fonts.sans + " |");
+  lines.push("");
+  lines.push("## Components");
+  lines.push("");
+  if (spec.components.length === 0) {
+    lines.push("No components indexed yet. The spec still defines the target UI, but new components should be added to the approved library.");
+  } else {
+    lines.push("| Component | Import | Props | Used by |");
+    lines.push("|---|---|---|---|");
+    for (const component of spec.components.slice(0, 40)) {
+      lines.push("| " + component.name + " | " + (component.importPath ?? component.path) + " | " + (component.props.slice(0, 8).join(", ") || "-") + " | " + (component.usedBy.length ? component.usedBy.join(", ") : "-") + " |");
+    }
+  }
+  lines.push("");
+  lines.push("## Page patterns");
+  lines.push("");
+  if (spec.patterns.length === 0) {
+    lines.push("No pages indexed yet.");
+  } else {
+    lines.push("| Page | Type | Reference |");
+    lines.push("|---|---|---|");
+    for (const page of spec.patterns)
+      lines.push("| " + page.path + " | " + page.type + " | " + (page.reference ? "yes" : "no") + " |");
+  }
+  lines.push("");
+  lines.push("## Spec rules");
+  lines.push("");
+  for (const item of spec.items) {
+    lines.push("### " + item.id + " \u2014 " + item.title);
+    lines.push("");
+    lines.push("**Status:** " + item.status);
+    lines.push("");
+    for (const rule of item.rules)
+      lines.push("- " + rule);
+    if (item.evidence.length) {
+      lines.push("");
+      lines.push("**Evidence:** " + item.evidence.join("; "));
+    }
+    lines.push("");
+  }
+  lines.push("## Preview and approval");
+  lines.push("");
+  lines.push("Open the UI-only preview:");
+  lines.push("");
+  lines.push("~~~bash");
+  lines.push("npx uifying spec preview");
+  lines.push("~~~");
+  lines.push("");
+  lines.push("When the spec is right, approve the current version:");
+  lines.push("");
+  lines.push("~~~bash");
+  lines.push("npx uifying spec approve");
+  lines.push("~~~");
+  lines.push("");
+  lines.push("The checker only treats the approved spec as the contract. A new pattern requires a spec change and a new preview, not a checker bypass.");
+  lines.push("");
+  return lines.join("\n");
+}
+function detectArchetype(scan) {
+  if (scan.patterns.some((page) => page.type === "dashboard" || page.type === "data-list"))
+    return "dashboard-admin";
+  if (scan.components.some((component) => /DataTable|Table|PageHeader|Sidebar/.test(component.name)))
+    return "dashboard-admin";
+  return scan.info.framework === "unknown" ? "dashboard-admin" : "app";
+}
+function findComponent(scan, names) {
+  return scan.components.find((component) => names.some((name) => new RegExp(name, "i").test(component.name)));
+}
+function componentEvidence(scan, names) {
+  const component = findComponent(scan, names);
+  return component ? [component.path + " (" + component.name + ")"] : [];
+}
+function dashboardItems(scan) {
+  const primary = scan.tokens.colors.primary;
+  const surface = scan.tokens.colors.surface;
+  const border = scan.tokens.colors.border;
+  const md = scan.tokens.radius.md;
+  const table = findComponent(scan, ["DataTable", "Table"]);
+  const modal = findComponent(scan, ["Dialog", "Modal", "Sheet"]);
+  const pageHeader = findComponent(scan, ["PageHeader", "Header"]);
+  const back = findComponent(scan, ["BackButton", "Back"]);
+  const rootEvidence = scan.info.globalsCss ? [scan.info.globalsCss] : ["UIfying dashboard baseline"];
+  return [
+    { id: "FOUND-01", section: "foundations", title: "Foundations", status: "draft", rules: ["Use the semantic colors, type ramp, spacing scale, and radius scale in this spec.", "Do not add one-off colors or arbitrary spacing values."], evidence: rootEvidence, previewRef: "preview#foundations" },
+    { id: "NAV-01", section: "navigation", title: "Navigation and active state", status: "draft", rules: ["Desktop sidebar is 240px wide; collapsed rail is 64px below 1024px.", "Active item uses " + primary + " as an accent and a surface change.", "Active, hover, focus, and disabled states are visually distinct."], evidence: rootEvidence, previewRef: "preview#nav" },
+    { id: "SEL-01", section: "selected-states", title: "Global selected states", status: "draft", rules: ["Nav active, table row selected, tab active, and filter chip active share one treatment.", "Selection is never communicated by color alone; use a mark, check, or border."], evidence: rootEvidence, previewRef: "preview#selected" },
+    { id: "CARD-01", section: "surfaces", title: "Card and KPI recipe", status: "draft", rules: ["Cards use " + surface + " surface, " + border + " border, " + md + " radius, and 12-16px padding.", "KPI cards lead with the metric, then the label, then context or a sparkline.", "Card headers and actions use a consistent vertical rhythm."], evidence: componentEvidence(scan, ["Card", "Kpi", "Stat"]), previewRef: "preview#card" },
+    { id: "CHART-01", section: "charts", title: "Chart recipe", status: "draft", rules: ["Use " + primary + " as the primary series; reserve success, warning, and danger for state.", "Hairline grid, minimal axes, one legend, and a tooltip.", "Every chart has loading, empty, and error states."], evidence: componentEvidence(scan, ["Chart", "Graph"]), previewRef: "preview#chart" },
+    { id: "TABLE-01", section: "tables", title: "Table recipe", status: "draft", rules: [table ? "Reuse " + table.name + " from " + (table.importPath ?? table.path) + " before creating another table." : "Use a shared table primitive rather than a page-specific table.", "Header, row height, selected row, status badge, pagination, and empty state are part of the recipe.", "Row actions stay inside the table pattern."], evidence: componentEvidence(scan, ["DataTable", "Table"]), previewRef: "preview#table" },
+    { id: "FORM-01", section: "forms", title: "Form recipe", status: "draft", rules: ["Labels sit above fields; help text and errors use the same reserved space.", "Use the shared Input, Select, and Button components.", "Form groups use the same spacing and column rhythm as the rest of the product."], evidence: componentEvidence(scan, ["Form", "Input", "Select"]), previewRef: "preview#form" },
+    { id: "MODAL-01", section: "overlays", title: "Dialog recipe", status: "draft", rules: [modal ? "Reuse " + modal.name + " from " + (modal.importPath ?? modal.path) + " before building a new dialog." : "Use one shared dialog primitive.", "Dialog is 480px wide on desktop, full-screen on small screens, with a sticky footer.", "Destructive action is separated from the primary action."], evidence: componentEvidence(scan, ["Dialog", "Modal", "Sheet"]), previewRef: "preview#modal" },
+    { id: "PAGE-02", section: "secondary-pages", title: "Secondary page shell", status: "draft", rules: [pageHeader ? "Use " + pageHeader.name + " for the page header." : "Secondary pages share one page-header recipe.", "Breadcrumb, title, actions, tabs, and content width follow the primary page shell.", "Content max width and responsive padding come from the layout recipe."], evidence: componentEvidence(scan, ["PageHeader", "Header"]), previewRef: "preview#page" },
+    { id: "BACK-01", section: "secondary-pages", title: "Back button", status: "draft", rules: [back ? "Reuse " + back.name + " from " + (back.importPath ?? back.path) + "." : "Use one back-button treatment on secondary pages.", "Back sits top-left, before the breadcrumb; label and arrow are stable.", "Behavior is route-aware and does not use a generic history fallback without intent."], evidence: componentEvidence(scan, ["BackButton", "Back"]), previewRef: "preview#back" },
+    { id: "STATE-01", section: "states", title: "Data states", status: "draft", rules: ["Every data surface defines empty, loading, error, and partial states.", "Skeletons match the final layout; do not use a spinner on first load if a skeleton is possible.", "Permission denied is a distinct state, not an empty result."], evidence: rootEvidence, previewRef: "preview#states" },
+    { id: "RESP-01", section: "responsive", title: "Responsive rules", status: "draft", rules: ["Collapse the rail before the content becomes cramped.", "Stack KPI cards; let tables scroll horizontally rather than hiding columns.", "Dialogs become full-screen; back buttons remain reachable."], evidence: rootEvidence, previewRef: "preview#responsive" }
+  ];
+}
+function appItems(scan) {
+  const rootEvidence = scan.info.globalsCss ? [scan.info.globalsCss] : ["UIfying app baseline"];
+  const modal = findComponent(scan, ["Dialog", "Modal", "Sheet"]);
+  return [
+    { id: "FOUND-01", section: "foundations", title: "Foundations", status: "draft", rules: ["Use the semantic colors, type ramp, spacing scale, and radius scale in this spec.", "Do not add one-off colors or arbitrary spacing values."], evidence: rootEvidence, previewRef: "preview#foundations" },
+    { id: "SHELL-01", section: "shell", title: "App shell", status: "draft", rules: ["Navigation, page header, content width, and responsive behavior come from one shell recipe.", "Active and selected states are explicit."], evidence: rootEvidence, previewRef: "preview#shell" },
+    { id: "CARD-01", section: "surfaces", title: "Card recipe", status: "draft", rules: ["Use one card surface, border, radius, and padding recipe."], evidence: rootEvidence, previewRef: "preview#card" },
+    { id: "FORM-01", section: "forms", title: "Form recipe", status: "draft", rules: ["Labels above fields; reserved help and error space; shared inputs and buttons."], evidence: componentEvidence(scan, ["Form", "Input"]), previewRef: "preview#form" },
+    { id: "MODAL-01", section: "overlays", title: "Dialog recipe", status: "draft", rules: [modal ? "Reuse " + modal.name + " from " + (modal.importPath ?? modal.path) + "." : "Use one shared dialog primitive.", "Dialog width, footer, and destructive action are consistent."], evidence: componentEvidence(scan, ["Dialog", "Modal", "Sheet"]), previewRef: "preview#modal" },
+    { id: "STATE-01", section: "states", title: "Data states", status: "draft", rules: ["Every data surface defines empty, loading, error, and partial states."], evidence: rootEvidence, previewRef: "preview#states" },
+    { id: "RESP-01", section: "responsive", title: "Responsive rules", status: "draft", rules: ["Stack content before it becomes cramped; keep primary actions reachable."], evidence: rootEvidence, previewRef: "preview#responsive" }
+  ];
+}
+
+// ../core/dist/context.js
+function buildContext(spec, task, limit = 8) {
+  const text = task.toLowerCase();
+  const words = text.split(/[^a-z0-9]+/).filter((word) => word.length > 2);
+  const components = spec.components.map((component) => {
+    let score = 0;
+    const name = component.name.toLowerCase();
+    const path = component.path.toLowerCase();
+    for (const word of words) {
+      if (name === word)
+        score += 5;
+      else if (name.includes(word) || word.includes(name))
+        score += 2;
+      if (path.includes(word))
+        score += 1;
+      if (component.props.some((prop) => prop.toLowerCase().includes(word)))
+        score += 0.5;
+    }
+    if (component.usedBy.some((file) => words.some((word) => file.toLowerCase().includes(word))))
+      score += 2;
+    if (/(table|list|grid|user|order)/.test(text) && /(DataTable|Table|List)/i.test(component.name))
+      score += 4;
+    if (/(dialog|modal|popup|edit|user)/.test(text) && /(Dialog|Modal|Sheet)/i.test(component.name))
+      score += 3;
+    if (/(button|action|cta)/.test(text) && /Button/i.test(component.name))
+      score += 2;
+    if (/(page|header|title)/.test(text) && /(PageHeader|Header)/i.test(component.name))
+      score += 2;
+    if (/(card|kpi|stat|metric)/.test(text) && /(Card|Kpi|Stat|Metric)/i.test(component.name))
+      score += 2;
+    if (/(chart|graph|trend)/.test(text) && /(Chart|Graph)/i.test(component.name))
+      score += 2;
+    return {
+      name: component.name,
+      path: component.path,
+      importPath: component.importPath,
+      score: Math.round(score * 100) / 100,
+      props: component.props,
+      variants: component.variants,
+      usedBy: component.usedBy
+    };
+  }).filter((component) => component.score > 0).sort((a, b) => b.score - a.score || a.name.localeCompare(b.name)).slice(0, limit);
+  const referencePage = pickReference(spec, text);
+  const specItems = pickItems(spec.items, text);
+  const note = components.length === 0 ? "No project component matched this task. Do not invent a component silently; check the spec or propose a new component." : void 0;
+  return {
+    task,
+    specVersion: spec.specVersion,
+    specStatus: spec.status,
+    components,
+    referencePage,
+    specItems,
+    tokens: {
+      colors: spec.tokens.colors,
+      radius: spec.tokens.radius,
+      spacing: spec.tokens.spacing
+    },
+    note
+  };
+}
+function pickReference(spec, text) {
+  const scored = spec.patterns.map((page) => {
+    let score = page.reference ? 2 : 0;
+    if (/(list|table|user|order)/.test(text) && page.type === "data-list")
+      score += 3;
+    if (/(detail|edit|secondary)/.test(text) && page.type === "detail")
+      score += 2;
+    if (/(setting|form)/.test(text) && page.type === "settings")
+      score += 2;
+    if (page.path.toLowerCase().split(/[^a-z0-9]+/).some((part) => text.includes(part) && part.length > 2))
+      score += 1;
+    return { page, score };
+  }).sort((a, b) => b.score - a.score);
+  return scored[0]?.page.path;
+}
+function pickItems(items, text) {
+  const priorities = ["FOUND-01"];
+  if (/(nav|sidebar|menu)/.test(text))
+    priorities.push("NAV-01");
+  if (/(select|active|focus)/.test(text))
+    priorities.push("SEL-01");
+  if (/(table|list|user|order|data)/.test(text))
+    priorities.push("TABLE-01", "STATE-01");
+  if (/(form|input|field|search)/.test(text))
+    priorities.push("FORM-01");
+  if (/(dialog|modal|edit|popup)/.test(text))
+    priorities.push("MODAL-01");
+  if (/(card|kpi|stat|metric)/.test(text))
+    priorities.push("CARD-01");
+  if (/(chart|graph|trend)/.test(text))
+    priorities.push("CHART-01");
+  if (/(page|header|secondary|detail)/.test(text))
+    priorities.push("PAGE-02", "BACK-01");
+  if (/(state|empty|loading|error)/.test(text))
+    priorities.push("STATE-01");
+  priorities.push("RESP-01");
+  const unique = [...new Set(priorities)];
+  return unique.map((id) => items.find((item) => item.id === id)).filter((item) => Boolean(item)).slice(0, 8);
+}
+function formatContext(result) {
+  const lines = [];
+  lines.push("UI context for: " + result.task);
+  lines.push("Spec: v" + result.specVersion + " (" + result.specStatus + ")");
+  lines.push("");
+  if (result.components.length === 0) {
+    lines.push("Components: no match");
+  } else {
+    lines.push("Components");
+    for (const component of result.components) {
+      lines.push("  " + component.score.toFixed(2).padStart(5) + "  " + component.name + "  " + (component.importPath ?? component.path));
+      if (component.props.length)
+        lines.push("         props: " + component.props.slice(0, 8).join(", "));
+      if (component.usedBy.length)
+        lines.push("         used by: " + component.usedBy.slice(0, 3).join(", "));
+    }
+  }
+  lines.push("");
+  lines.push("Reference page: " + (result.referencePage ?? "none found"));
+  lines.push("");
+  lines.push("Spec rules");
+  for (const item of result.specItems)
+    lines.push("  " + item.id + "  " + item.title);
+  lines.push("");
+  lines.push("Tokens");
+  lines.push("  colors: " + Object.entries(result.tokens.colors).map(([key, value2]) => key + "=" + value2).join("  "));
+  lines.push("  radius: " + Object.entries(result.tokens.radius).map(([key, value2]) => key + "=" + value2).join("  "));
+  if (result.note) {
+    lines.push("");
+    lines.push("Note: " + result.note);
+  }
+  return lines.join("\n");
+}
+
+// ../core/dist/check.js
+import { existsSync as existsSync5 } from "node:fs";
+import { join as join5 } from "node:path";
+var CHECKABLE = /\.(tsx|jsx|ts|js|vue|svelte|astro|css|html)$/;
+var SKIP_FILE = /(^|\/)(vite|next|tailwind|postcss|astro|svelte|nuxt|webpack|eslint|prettier|vitest|jest|playwright)\.config\.(ts|js|mjs|cjs)$/;
+var TOKEN_FILE = /(^|\/)(globals|tokens|theme|design-tokens)\.(css|ts|js|mjs)$/;
+function runCheck(root, spec, config, options = {}) {
+  const approved = spec.status === "approved";
+  const files = collectFiles(root, config, options);
+  const ctx = {
+    root,
+    spec,
+    config,
+    approved,
+    tokenSources: new Set([spec.project.globalsCss, spec.project.tailwindConfig].filter((value2) => Boolean(value2))),
+    componentPaths: new Set(spec.components.map((component) => component.path)),
+    componentDirs: config.componentDirs.length ? config.componentDirs : spec.project.componentDirs
+  };
+  const report = {
+    schemaVersion: "1",
+    specVersion: spec.specVersion,
+    specStatus: spec.status,
+    base: options.base,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    checkedFiles: files.length,
+    unknown: 0,
+    files: [],
+    summary: { error: 0, warning: 0, info: 0 }
+  };
+  if (!approved) {
+    const finding = {
+      file: ".uifying/spec.json",
+      line: 1,
+      rule: "spec/approved-version",
+      severity: "warning",
+      message: "The UI spec is still a draft, so every finding is advisory.",
+      evidence: { specVersion: spec.specVersion, source: ".uifying/spec.json" },
+      suggestion: "Review the preview, then run: uifying spec approve"
+    };
+    report.files.push({ path: finding.file, findings: [finding] });
+    report.summary.warning += 1;
+  }
+  for (const file of files) {
+    let source;
+    try {
+      source = readText(join5(root, file));
+    } catch {
+      report.unknown += 1;
+      continue;
+    }
+    const findings = [];
+    if (!isTokenSource(file, ctx)) {
+      findings.push(...checkColors(file, source, ctx));
+      findings.push(...checkSpacing(file, source, ctx));
+    }
+    findings.push(...checkComponents(file, source, ctx));
+    findings.push(...checkBackNavigation(file, source, ctx));
+    if (findings.length) {
+      const sorted = findings.sort((a, b) => a.line - b.line || a.rule.localeCompare(b.rule));
+      report.files.push({ path: file, findings: sorted });
+      for (const finding of sorted)
+        report.summary[finding.severity] += 1;
+    }
+  }
+  report.files.sort((a, b) => a.path.localeCompare(b.path));
+  return report;
+}
+function shouldFail(report, failOn = "error") {
+  if (failOn === "none")
+    return false;
+  if (failOn === "warning")
+    return report.summary.error + report.summary.warning > 0;
+  return report.summary.error > 0;
+}
+function formatCheck(report) {
+  const lines = [];
+  lines.push("UI check  spec v" + report.specVersion + " (" + report.specStatus + ")" + (report.base ? "  base " + report.base : ""));
+  lines.push("Checked " + report.checkedFiles + " files" + (report.unknown ? ", " + report.unknown + " unreadable" : ""));
+  lines.push("");
+  if (report.files.length === 0) {
+    lines.push(color.green("No findings. The UI matches the approved spec."));
+    return lines.join("\n");
+  }
+  for (const file of report.files) {
+    lines.push(color.bold(file.path));
+    for (const finding of file.findings) {
+      const label = finding.severity === "error" ? color.red("error") : finding.severity === "warning" ? color.yellow("warn ") : color.dim("info ");
+      lines.push("  " + label + "  " + finding.line + ":" + (finding.column ?? 1) + "  " + finding.message);
+      lines.push("         " + color.dim(finding.rule + "  " + finding.suggestion));
+    }
+    lines.push("");
+  }
+  const summary = report.summary;
+  const paint2 = summary.error > 0 ? color.red : summary.warning > 0 ? color.yellow : color.green;
+  lines.push(paint2(summary.error + " error, " + summary.warning + " warning, " + summary.info + " info"));
+  return lines.join("\n");
+}
+function collectFiles(root, config, options) {
+  let files;
+  if (options.base && !options.all) {
+    const valid = runGit(root, ["rev-parse", "--verify", options.base]);
+    if (!valid)
+      throw new Error("Unknown git base: " + options.base);
+    const changed = runGit(root, ["diff", "--name-only", options.base]);
+    const untracked = runGit(root, ["ls-files", "--others", "--exclude-standard"]);
+    files = [...changed.split("\n"), ...untracked.split("\n")].map((file) => toPosix(file.trim())).filter(Boolean);
+  } else {
+    files = walk(root, config.ignore);
+  }
+  const dirs = [...config.componentDirs, ...config.pageDirs].map((dir) => dir.replace(/^\.\//, "").replace(/\/$/, ""));
+  const seen = /* @__PURE__ */ new Set();
+  return files.filter((file) => {
+    if (seen.has(file))
+      return false;
+    if (!CHECKABLE.test(file))
+      return false;
+    if (file.endsWith(".d.ts"))
+      return false;
+    if (SKIP_FILE.test(file))
+      return false;
+    if (!existsSync5(join5(root, file)))
+      return false;
+    if (dirs.length > 0 && !dirs.some((dir) => file === dir || file.startsWith(dir + "/"))) {
+      if (!TOKEN_FILE.test(file) || !file.startsWith("src/"))
+        return false;
+    }
+    seen.add(file);
+    return true;
+  });
+}
+function isTokenSource(file, ctx) {
+  if (ctx.tokenSources.has(file))
+    return true;
+  if (TOKEN_FILE.test(file))
+    return true;
+  return false;
+}
+function severity(ctx) {
+  return ctx.approved ? "error" : "warning";
+}
+function normalizeColor(value2) {
+  let next = value2.trim().toLowerCase().replace(/\s+/g, "");
+  if (/^#[0-9a-f]{3}$/.test(next))
+    next = "#" + next[1] + next[1] + next[2] + next[2] + next[3] + next[3];
+  if (/^#[0-9a-f]{4}$/.test(next))
+    next = "#" + next[1] + next[1] + next[2] + next[2] + next[3] + next[3] + next[4] + next[4];
+  const rgb = next.match(/^rgba?\(([^)]+)\)$/);
+  if (rgb) {
+    const parts = rgb[1].split(",").slice(0, 3).map((part) => Number(part));
+    if (parts.length === 3 && parts.every((part) => Number.isFinite(part)))
+      return "rgb(" + parts.join(",") + ")";
+  }
+  return next;
+}
+function allowedColors(spec) {
+  const allowed = /* @__PURE__ */ new Set();
+  for (const value2 of Object.values(spec.tokens.colors)) {
+    if (!value2)
+      continue;
+    allowed.add(normalizeColor(value2));
+    for (const fallback of value2.matchAll(/#[0-9a-fA-F]{3,8}\b/g))
+      allowed.add(normalizeColor(fallback[0]));
+    for (const fallback of value2.matchAll(/rgba?\([^)]*\)/g))
+      allowed.add(normalizeColor(fallback[0]));
+  }
+  return allowed;
+}
+function checkColors(file, source, ctx) {
+  if (!Object.keys(ctx.spec.tokens.colors).length)
+    return [];
+  const allowed = allowedColors(ctx.spec);
+  const findings = [];
+  const seen = /* @__PURE__ */ new Set();
+  const regex = /#[0-9a-fA-F]{8}\b|#[0-9a-fA-F]{6}\b|#[0-9a-fA-F]{3}\b|rgba?\([^)]*\)|hsla?\([^)]*\)/g;
+  for (const match of source.matchAll(regex)) {
+    const index = match.index ?? 0;
+    const lineText = source.slice(source.lastIndexOf("\n", index - 1) + 1, source.indexOf("\n", index) === -1 ? source.length : source.indexOf("\n", index));
+    if (/^\s*(\/\/|\*|<!--)/.test(lineText))
+      continue;
+    if (/url\([^)]*$/.test(source.slice(Math.max(0, index - 40), index)))
+      continue;
+    const value2 = match[0];
+    const normalized = normalizeColor(value2);
+    if (allowed.has(normalized))
+      continue;
+    if (normalized === "transparent" || normalized === "currentcolor")
+      continue;
+    const position = lineAt(source, index);
+    const key = position.line + ":" + normalized;
+    if (seen.has(key))
+      continue;
+    seen.add(key);
+    findings.push({
+      file,
+      line: position.line,
+      column: position.column,
+      rule: "token/no-unknown-color",
+      severity: severity(ctx),
+      message: "Color " + value2 + " is not one of the spec color tokens.",
+      evidence: { specId: "FOUND-01", specVersion: ctx.spec.specVersion, source: file, reference: value2 },
+      suggestion: "Use a token such as " + tokenHint(ctx.spec) + " or add the color to the spec first."
+    });
+  }
+  return findings;
+}
+function tokenHint(spec) {
+  const preferred = ["primary", "accent", "text", "foreground"].find((name) => spec.tokens.colors[name]);
+  if (preferred)
+    return "var(--color-" + preferred + ")";
+  const entry = Object.entries(spec.tokens.colors)[0];
+  if (!entry)
+    return "var(--color-primary)";
+  return entry[0].startsWith("--") ? "var(" + entry[0] + ")" : entry[1];
+}
+function checkSpacing(file, source, ctx) {
+  const allowed = /* @__PURE__ */ new Set([0]);
+  for (const value2 of Object.values(ctx.spec.tokens.spacing)) {
+    const px = numericPx(value2);
+    if (px !== null)
+      allowed.add(Math.round(px * 100) / 100);
+  }
+  if (allowed.size <= 1)
+    return [];
+  const findings = [];
+  const seen = /* @__PURE__ */ new Set();
+  const classRegex = /(?:^|[\s"'])(?:p|px|py|pt|pb|pl|pr|m|mx|my|mt|mb|ml|mr|gap|space-x|space-y)-\[(-?\d+(?:\.\d+)?)(px|rem)\]/g;
+  const styleRegex = /(?:padding|margin|gap)(?:-[a-z]+)?\s*:\s*(-?\d+(?:\.\d+)?)(px|rem)/g;
+  for (const regex of [classRegex, styleRegex]) {
+    for (const match of source.matchAll(regex)) {
+      const index = match.index ?? 0;
+      const px = Number(match[1]) * (match[2] === "rem" ? 16 : 1);
+      if (!Number.isFinite(px))
+        continue;
+      if ([...allowed].some((value2) => Math.abs(value2 - px) < 0.5))
+        continue;
+      const token = match[0].replace(/^[\s"']+/, "").trim();
+      const position = lineAt(source, index);
+      if (seen.has(position.line))
+        continue;
+      seen.add(position.line);
+      findings.push({
+        file,
+        line: position.line,
+        column: position.column,
+        rule: "token/use-spacing-scale",
+        severity: severity(ctx),
+        message: "Spacing value " + token + " is off the spec spacing scale.",
+        evidence: { specId: "RESP-01", specVersion: ctx.spec.specVersion, source: file, reference: token },
+        suggestion: "Use a spacing token from the spec or add the value to the scale deliberately."
+      });
+    }
+  }
+  return findings;
+}
+function checkComponents(file, source, ctx) {
+  const findings = [];
+  if (isComponentPath(file, ctx))
+    return findings;
+  const rules = [
+    { tag: /<button\b/, names: ["Button"], label: "button", rule: "component/prefer-existing", specId: "FOUND-01" },
+    { tag: /<table\b/, names: ["DataTable", "Table"], label: "table", rule: "component/prefer-existing", specId: "TABLE-01" },
+    { tag: /<dialog\b/, names: ["Dialog", "Modal", "Sheet"], label: "dialog", rule: "component/prefer-existing", specId: "MODAL-01" },
+    { tag: /<input\b/, names: ["Input", "TextField"], label: "input", rule: "component/prefer-existing", specId: "FORM-01" },
+    { tag: /<select\b/, names: ["Select", "Dropdown"], label: "select", rule: "component/prefer-existing", specId: "FORM-01" }
+  ];
+  for (const entry of rules) {
+    const match = entry.tag.exec(source);
+    if (!match)
+      continue;
+    const component = findComponent2(ctx.spec, entry.names);
+    if (!component)
+      continue;
+    const position = lineAt(source, match.index);
+    findings.push({
+      file,
+      line: position.line,
+      column: position.column,
+      rule: entry.rule,
+      severity: severity(ctx),
+      message: "Raw <" + entry.label + "> used while " + component.name + " exists in the project.",
+      evidence: { specId: entry.specId, specVersion: ctx.spec.specVersion, source: component.path },
+      suggestion: "Import " + (component.importPath ?? component.path) + " and use its existing variants."
+    });
+  }
+  const modal = /<dialog\b|role\s*=\s*["']dialog["']/.exec(source);
+  if (modal && !findComponent2(ctx.spec, ["Dialog", "Modal", "Sheet"])) {
+    const specItem = ctx.spec.items.find((item) => item.id === "MODAL-01");
+    if (specItem) {
+      const position = lineAt(source, modal.index);
+      findings.push({
+        file,
+        line: position.line,
+        column: position.column,
+        rule: "spec/use-modal-recipe",
+        severity: severity(ctx),
+        message: "Modal markup is not using the approved modal recipe.",
+        evidence: { specId: "MODAL-01", specVersion: ctx.spec.specVersion, source: specItem.title },
+        suggestion: "Use the modal shell from the spec: focus trap, Escape to close, title, body, and a single primary action."
+      });
+    }
+  }
+  void ctx.config;
+  return findings;
+}
+function isComponentPath(file, ctx) {
+  if (ctx.componentPaths.has(file))
+    return true;
+  return ctx.componentDirs.some((dir) => file.startsWith(dir.replace(/\/$/, "") + "/"));
+}
+function findComponent2(spec, names) {
+  return spec.components.find((component) => names.includes(component.name)) ?? spec.components.find((component) => names.some((name) => component.name.endsWith(name)));
+}
+function checkBackNavigation(file, source, ctx) {
+  const page = ctx.spec.patterns.find((pattern) => pattern.path === file);
+  if (!page)
+    return [];
+  if (!["detail", "settings", "form"].includes(page.type))
+    return [];
+  if (/(ArrowLeft|ChevronLeft|router\.back|history\.back|Back to|←|href\s*=\s*["'][^"']*(settings|list|dashboard)[^"']*["'])/.test(source))
+    return [];
+  const item = ctx.spec.items.find((entry) => entry.id === "BACK-01" || entry.id === "PAGE-02");
+  if (!item)
+    return [];
+  return [{
+    file,
+    line: 1,
+    column: 1,
+    rule: "spec/use-back-button",
+    severity: severity(ctx),
+    message: "Secondary page has no visible back navigation.",
+    evidence: { specId: "BACK-01", specVersion: ctx.spec.specVersion, source: item.title },
+    suggestion: "Add a back control that returns to the parent list or previous page."
+  }];
+}
+
+// ../core/dist/doctor.js
+import { existsSync as existsSync6, readFileSync as readFileSync3 } from "node:fs";
+import { join as join6 } from "node:path";
+function runDoctor(root) {
+  const checks = [];
+  let spec = null;
+  let config = null;
+  let loadError = null;
+  try {
+    spec = readSpec(root);
+    config = readConfig(root);
+  } catch (error) {
+    loadError = error instanceof Error ? error.message : String(error);
+  }
+  const paths = memoryPaths(root);
+  const major = Number(process.versions.node.split(".")[0]);
+  checks.push({
+    label: "Node",
+    status: Number.isFinite(major) && major >= 20 ? "ok" : "fail",
+    detail: "v" + process.versions.node + (Number.isFinite(major) && major >= 20 ? "" : " (requires Node 20 or newer)")
+  });
+  checks.push({
+    label: "Project",
+    status: existsSync6(join6(root, "package.json")) ? "ok" : "warn",
+    detail: existsSync6(join6(root, "package.json")) ? config ? "memory initialized" : "package.json found, memory not initialized" : "no package.json at this root"
+  });
+  if (loadError) {
+    checks.push({
+      label: "UI spec",
+      status: "fail",
+      detail: "could not read .uifying/spec.json: " + loadError
+    });
+  } else if (!spec) {
+    checks.push({
+      label: "UI spec",
+      status: "fail",
+      detail: "not found. Run: uifying spec init"
+    });
+  } else {
+    checks.push({
+      label: "UI spec",
+      status: spec.status === "approved" ? "ok" : "warn",
+      detail: "v" + spec.specVersion + " (" + spec.status + ")" + (spec.approvedAt ? ", approved " + spec.approvedAt.slice(0, 10) : "")
+    });
+    checks.push({
+      label: "Tokens",
+      status: Object.keys(spec.tokens.colors).length > 0 ? "ok" : "warn",
+      detail: Object.keys(spec.tokens.colors).length + " colors, " + Object.keys(spec.tokens.spacing).length + " spacing values, " + Object.keys(spec.tokens.radius).length + " radii"
+    });
+    checks.push({
+      label: "Components",
+      status: spec.components.length > 0 ? "ok" : "warn",
+      detail: spec.components.length + " detected, " + spec.components.filter((component) => component.status === "approved").length + " approved"
+    });
+    const previewFile = join6(paths.dir, spec.preview);
+    checks.push({
+      label: "Preview",
+      status: existsSync6(previewFile) ? "ok" : "fail",
+      detail: existsSync6(previewFile) ? spec.preview : "missing " + spec.preview + ". Run: uifying spec preview"
+    });
+    checks.push({
+      label: "Agent skill",
+      status: existsSync6(paths.skillFile) ? "ok" : "warn",
+      detail: existsSync6(paths.skillFile) ? paths.skillFile : "missing. Run: uifying spec init"
+    });
+    const claude = join6(root, ".claude/skills/uifying/SKILL.md");
+    const agents = join6(root, "AGENTS.md");
+    let agentDetail = "no agent integration";
+    let agentStatus = "warn";
+    if (existsSync6(claude)) {
+      agentStatus = "ok";
+      agentDetail = ".claude/skills/uifying/SKILL.md";
+    } else if (existsSync6(agents)) {
+      const text = readFileSync3(agents, "utf8");
+      if (/UIfying/i.test(text)) {
+        agentStatus = "ok";
+        agentDetail = "managed block in AGENTS.md";
+      }
+    }
+    checks.push({ label: "Agent setup", status: agentStatus, detail: agentDetail });
+    const framework = spec.project.framework === "unknown" ? "warn" : "ok";
+    checks.push({
+      label: "Framework",
+      status: framework,
+      detail: spec.project.framework + (spec.project.tailwind ? " + Tailwind " + spec.project.tailwind : "") + (spec.project.typescript ? " + TypeScript" : "")
+    });
+  }
+  return {
+    ok: checks.every((check2) => check2.status !== "fail"),
+    root,
+    checks
+  };
+}
+function formatDoctor(report) {
+  const lines = [];
+  lines.push("UIfying doctor  " + report.root);
+  lines.push("");
+  for (const check2 of report.checks) {
+    const mark = check2.status === "ok" ? color.green("ok  ") : check2.status === "warn" ? color.yellow("warn") : color.red("fail");
+    lines.push("  " + mark + "  " + check2.label.padEnd(12) + check2.detail);
+  }
+  lines.push("");
+  lines.push(report.ok ? color.green("Ready.") : color.red("Blocking issues found."));
+  return lines.join("\n");
+}
+
+// ../core/dist/server.js
+import { createServer } from "node:http";
+import { readFile, stat } from "node:fs/promises";
+import { extname as extname2, resolve, sep } from "node:path";
+var MIME = {
+  ".html": "text/html; charset=utf-8",
+  ".css": "text/css; charset=utf-8",
+  ".js": "text/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp",
+  ".woff2": "font/woff2",
+  ".ico": "image/x-icon"
+};
+async function startPreviewServer(previewDir, options = {}) {
+  const root = resolve(previewDir);
+  const port = options.port ?? 4173;
+  const host = options.host ?? "127.0.0.1";
+  const server = createServer(async (request, response) => {
+    if (request.method !== "GET" && request.method !== "HEAD") {
+      response.writeHead(405, { Allow: "GET, HEAD" });
+      response.end("Method not allowed");
+      return;
+    }
+    let pathname = "/";
+    try {
+      pathname = decodeURIComponent(new URL(request.url ?? "/", "http://" + host).pathname);
+    } catch {
+      response.writeHead(400);
+      response.end("Bad request");
+      return;
+    }
+    if (pathname.includes("\0")) {
+      response.writeHead(400);
+      response.end("Bad request");
+      return;
+    }
+    let target = resolve(root, "." + pathname);
+    if (target !== root && !target.startsWith(root + sep)) {
+      response.writeHead(403);
+      response.end("Forbidden");
+      return;
+    }
+    try {
+      const info = await stat(target);
+      if (info.isDirectory())
+        target = resolve(target, "index.html");
+      const body = await readFile(target);
+      const headers = {
+        "Content-Type": MIME[extname2(target).toLowerCase()] ?? "application/octet-stream",
+        "Content-Length": String(body.byteLength),
+        "Cache-Control": "no-store",
+        "X-Content-Type-Options": "nosniff"
+      };
+      response.writeHead(200, headers);
+      if (request.method === "HEAD")
+        response.end();
+      else
+        response.end(body);
+    } catch {
+      const fallback = resolve(root, "index.html");
+      try {
+        const body = await readFile(fallback);
+        response.writeHead(404, {
+          "Content-Type": "text/html; charset=utf-8",
+          "Content-Length": String(body.byteLength),
+          "Cache-Control": "no-store"
+        });
+        response.end(body);
+      } catch {
+        response.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" });
+        response.end("Not found");
+      }
+    }
+  });
+  await new Promise((resolvePromise, reject) => {
+    server.once("error", reject);
+    server.listen(port, host, () => {
+      server.off("error", reject);
+      resolvePromise();
+    });
+  });
+  const address = server.address();
+  const actualPort = typeof address === "object" && address ? address.port : port;
+  return {
+    url: "http://" + host + ":" + actualPort + "/",
+    close: () => new Promise((resolvePromise, reject) => {
+      server.close((error) => error ? reject(error) : resolvePromise());
+    })
+  };
+}
+
+// src/index.ts
+var HELP = [
+  "UIfying - a UI spec your coding agent can follow.",
+  "",
+  "Usage:",
+  "  uifying init [--agent claude|codex] [--force] [--name name]",
+  "  uifying spec init [options]        Scan a project and write the draft spec",
+  "  uifying spec preview [--serve]     Regenerate the UI-only preview",
+  "  uifying spec approve               Approve the spec as the UI contract",
+  "  uifying preview [--serve]          Serve the preview (rebuilds it first)",
+  "  uifying context <task> [--json]    Retrieve components and spec rules for a task",
+  "  uifying check [--base ref] [--all] [--json]",
+  "  uifying doctor [--json]            Check the local setup",
+  "  uifying status                     Show the current spec",
+  "",
+  "Options:",
+  "  --root <dir>   Run against another project root",
+  "  --port <n>     Preview server port (default 4173)",
+  "  --host <host>  Preview server host (default 127.0.0.1)",
+  "  --fail-on <level>  check: error (default), warning, or none",
+  "  --out <file>   check: write the JSON report to a custom path",
+  "  --help         Show this help",
+  "  --version      Show the version",
+  "",
+  "Typical flow:",
+  "  uifying init",
+  "  uifying spec preview --serve",
+  "  uifying spec approve",
+  '  uifying context "add a user table"',
+  "  uifying check --base main"
+].join("\n");
+var VERSION = "0.1.0";
+try {
+  const pkg = JSON.parse(readFileSync4(new URL("../package.json", import.meta.url), "utf8"));
+  if (pkg.version) VERSION = pkg.version;
+} catch {
+}
+function parseRoot(argv) {
+  let root = process.cwd();
+  const args = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--root") {
+      const next = argv[++i];
+      if (next) root = resolve2(next);
+      continue;
+    }
+    if (arg.startsWith("--root=")) {
+      root = resolve2(arg.slice("--root=".length));
+      continue;
+    }
+    args.push(arg);
+  }
+  return { root, args };
+}
+function has(args, name) {
+  return args.includes(name);
+}
+function value(args, name) {
+  const index = args.indexOf(name);
+  if (index >= 0 && args[index + 1] && !args[index + 1].startsWith("--")) return args[index + 1];
+  const inline = args.find((arg) => arg.startsWith(name + "="));
+  return inline ? inline.slice(name.length + 1) : void 0;
+}
+function values(args, name) {
+  const result = [];
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === name && args[i + 1] && !args[i + 1].startsWith("--")) result.push(args[i + 1]);
+    if (args[i].startsWith(name + "=")) result.push(args[i].slice(name.length + 1));
+  }
+  return result;
+}
+function positional(args, skip) {
+  return args.filter((arg, index) => index >= skip && !arg.startsWith("--") && !(index > 0 && args[index - 1].startsWith("--") && !args[index - 1].includes("=")));
+}
+function fail(message) {
+  console.error(color.red("error") + "  " + message);
+  process.exit(1);
+}
+function ensureSpec(root) {
+  const spec = readSpec(root);
+  if (!spec) fail("No UI spec found. Run: uifying init");
+  return spec;
+}
+async function init(root, args, label) {
+  const agentRaw = value(args, "--agent");
+  if (agentRaw && agentRaw !== "claude" && agentRaw !== "codex") fail("--agent must be claude or codex");
+  const agent = agentRaw ?? readConfig(root)?.agent ?? null;
+  const force = has(args, "--force");
+  const name = value(args, "--name");
+  const ignore = values(args, "--ignore");
+  const existing = readSpec(root);
+  const hasPackage = existsSync7(join7(root, "package.json"));
+  const scan = hasPackage ? scanProject(root, [...readConfig(root)?.ignore ?? [], ...ignore]) : emptyScan(root, name);
+  if (!hasPackage && !name) {
+    console.log(color.yellow("warn") + "  No package.json found. Using default dashboard tokens and an empty component set.");
+  }
+  const spec = buildSpec(scan, existing, { force, agent, ignore });
+  writeMemory(root, spec, { force, agent, ignore });
+  const installed = installSkill(root, agent, spec);
+  const paths = memoryPaths(root);
+  console.log("");
+  console.log(color.green("UIfying initialized") + "  " + spec.project.name);
+  console.log("  Spec        v" + spec.specVersion + " " + spec.status + "  .uifying/spec.json");
+  console.log("  Components  " + spec.components.length + (spec.components.length ? " detected" : " found"));
+  console.log("  Tokens      " + Object.keys(spec.tokens.colors).length + " colors  " + Object.keys(spec.tokens.spacing).length + " spacing");
+  console.log("  Preview     " + paths.previewFile);
+  console.log("  Skill       " + paths.skillFile);
+  for (const file of installed) console.log("  Installed   " + file);
+  console.log("");
+  console.log(color.bold("Next"));
+  console.log("  1. uifying spec preview --serve");
+  console.log("  2. Review and edit .uifying/spec.json or .uifying/spec.md");
+  console.log("  3. uifying spec approve");
+  console.log("");
+  void label;
+}
+async function preview(root, args, serveByDefault) {
+  const spec = ensureSpec(root);
+  const paths = memoryPaths(root);
+  writeText(paths.previewFile, renderPreview(spec));
+  console.log("Preview  " + paths.previewFile);
+  const serve = serveByDefault || has(args, "--serve");
+  if (!serve) {
+    console.log(color.dim("Serve it with: uifying preview"));
+    return;
+  }
+  const port = Number(value(args, "--port") ?? 4173);
+  if (!Number.isInteger(port) || port < 0 || port > 65535) fail("--port must be a number between 0 and 65535");
+  const host = value(args, "--host") ?? "127.0.0.1";
+  const server = await startPreviewServer(paths.preview, { port, host });
+  console.log("");
+  console.log(color.green("UI-only preview") + "  " + server.url);
+  console.log(color.dim("Static fixtures only. No API, auth, or mutations. Press Ctrl+C to stop."));
+  const stop = async () => {
+    await server.close().catch(() => void 0);
+    process.exit(0);
+  };
+  process.once("SIGINT", stop);
+  process.once("SIGTERM", stop);
+  await new Promise(() => void 0);
+}
+function approve(root, args) {
+  const approved = approveMemory(root);
+  const installed = installSkill(root, readConfig(root)?.agent ?? null, approved);
+  const paths = memoryPaths(root);
+  console.log(color.green("Spec approved") + "  v" + approved.specVersion);
+  console.log("  " + paths.spec);
+  console.log("  " + paths.specMd);
+  console.log("  " + paths.previewFile);
+  for (const file of installed) console.log("  " + file);
+  console.log("");
+  console.log(color.dim("New UI work must follow this spec. Existing code is not refactored automatically."));
+  void args;
+}
+function context(root, args) {
+  const spec = ensureSpec(root);
+  const skip = args[0] === "context" ? 1 : 0;
+  const task = positional(args, skip).join(" ").trim();
+  if (!task) fail("Usage: uifying context <task>");
+  const limitValue = value(args, "--limit");
+  const limit = limitValue ? Number(limitValue) : 8;
+  if (!Number.isInteger(limit) || limit < 1 || limit > 50) fail("--limit must be an integer between 1 and 50");
+  const result = buildContext(spec, task, limit);
+  if (has(args, "--json")) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(formatContext(result));
+}
+function check(root, args) {
+  const spec = ensureSpec(root);
+  const config = readConfig(root);
+  if (!config) fail("No .uifying/config.json found. Run: uifying init");
+  const all = has(args, "--all");
+  const base = value(args, "--base") ?? (all ? void 0 : detectBase(root));
+  const failOnRaw = value(args, "--fail-on") ?? "error";
+  if (failOnRaw !== "error" && failOnRaw !== "warning" && failOnRaw !== "none") fail("--fail-on must be error, warning, or none");
+  const options = { base, all, failOn: failOnRaw };
+  const report = runCheck(root, spec, config, options);
+  const out = value(args, "--out") ?? join7(memoryPaths(root).dir, "check-report.json");
+  writeJson(out, report);
+  if (has(args, "--json")) {
+    console.log(JSON.stringify(report, null, 2));
+  } else {
+    console.log(formatCheck(report));
+    console.log(color.dim("Report: " + out));
+  }
+  if (shouldFail(report, failOnRaw)) process.exitCode = 1;
+}
+function detectBase(root) {
+  for (const candidate of ["main", "master"]) {
+    if (runGit(root, ["rev-parse", "--verify", candidate])) return candidate;
+  }
+  return void 0;
+}
+function doctor(root, args) {
+  const report = runDoctor(root);
+  if (has(args, "--json")) console.log(JSON.stringify(report, null, 2));
+  else console.log(formatDoctor(report));
+  if (!report.ok) process.exitCode = 1;
+}
+function status(root) {
+  const spec = readSpec(root);
+  if (!spec) {
+    console.log("No UI spec found. Run: uifying init");
+    process.exitCode = 1;
+    return;
+  }
+  const paths = memoryPaths(root);
+  console.log("Project  " + spec.project.name + "  (" + spec.project.framework + (spec.project.tailwind ? ", Tailwind " + spec.project.tailwind : "") + ")");
+  console.log("Spec     v" + spec.specVersion + "  " + spec.status + (spec.approvedAt ? "  approved " + spec.approvedAt.slice(0, 10) : ""));
+  console.log("Memory   " + paths.dir);
+  console.log("Preview  " + paths.previewFile + (existsSync7(paths.previewFile) ? "" : " (missing)"));
+  console.log("Skill    " + paths.skillFile + (existsSync7(paths.skillFile) ? "" : " (missing)"));
+  console.log("Items    " + spec.items.length + " spec rules, " + spec.components.length + " components, " + spec.patterns.length + " pages");
+}
+async function main() {
+  const parsed = parseRoot(process.argv.slice(2));
+  const args = parsed.args;
+  if (args.length === 0 || args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+    console.log(HELP);
+    return;
+  }
+  if (args[0] === "--version" || args[0] === "-v" || args[0] === "version") {
+    console.log(VERSION);
+    return;
+  }
+  const command = args[0];
+  const root = parsed.root;
+  if (command === "init") {
+    await init(root, args.slice(1), "init");
+    return;
+  }
+  if (command === "spec") {
+    const sub = args[1] ?? "status";
+    const rest = args.slice(2);
+    if (sub === "init") return await init(root, rest, "spec init");
+    if (sub === "preview") return await preview(root, rest, false);
+    if (sub === "approve") return approve(root, rest);
+    if (sub === "status") return status(root);
+    fail("Unknown spec command: " + sub + ". Try: init, preview, approve, status");
+  }
+  if (command === "preview") return await preview(root, args.slice(1), true);
+  if (command === "context") return context(root, args);
+  if (command === "check") return check(root, args.slice(1));
+  if (command === "doctor") return doctor(root, args.slice(1));
+  if (command === "status") return status(root);
+  fail("Unknown command: " + command + ". Run uifying --help");
+}
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(color.red("error") + "  " + message);
+  process.exit(1);
+});