@shortwind/cli 0.1.0-beta.0

package/dist/bench-a_9WmuOE.js

@@ -0,0 +1,1836 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { mkdir, open, readFile, rename, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { applyEdits, modify, parse } from "jsonc-parser";
+import { buildRegistry, parseRecipeFile, renderSkillMarkdown } from "@shortwind/core";
+import { createHash } from "node:crypto";
+import { fileURLToPath } from "node:url";
+import chokidar from "chokidar";
+import { glob } from "tinyglobby";
+import { Tiktoken } from "js-tiktoken/lite";
+import cl100k_base from "js-tiktoken/ranks/cl100k_base";
+import { loadRegistryFromDir, transformContent } from "@shortwind/tailwind";
+//#region src/fingerprint.ts
+const HEADER_PATTERN = /^\/\*\s*shortwind:\s+(\S+)@(\S+)\s+sha:([^\s*]+)(?:\s+—\s+DO NOT EDIT THIS LINE)?\s*\*\/\s*$/;
+function extractHeader(source) {
+	const eol = source.indexOf("\n");
+	const m = (eol === -1 ? source : source.slice(0, eol)).replace(/\r$/, "").match(HEADER_PATTERN);
+	if (!m) return null;
+	return {
+		family: m[1],
+		version: m[2],
+		sha: m[3]
+	};
+}
+function bodyAfterHeader(source) {
+	const eol = source.indexOf("\n");
+	return eol === -1 ? "" : source.slice(eol + 1);
+}
+function normalizeBody(body) {
+	return body.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n").map((line) => line.replace(/[\t ]+$/, "")).join("\n");
+}
+function computeBodySha(source) {
+	const normalized = normalizeBody(bodyAfterHeader(source));
+	return createHash("sha256").update(normalized).digest("hex").slice(0, 6);
+}
+function buildHeaderLine(family, version, sha) {
+	return `/* shortwind: ${family}@${version} sha:${sha} — DO NOT EDIT THIS LINE */`;
+}
+function rewriteHeaderSha(source, sha) {
+	const header = extractHeader(source);
+	if (!header) return source;
+	const newHeader = buildHeaderLine(header.family, header.version, sha);
+	const eol = source.indexOf("\n");
+	if (eol === -1) return newHeader;
+	return newHeader + source.slice(eol);
+}
+function sealRecipeFile(source, family, version) {
+	const header = buildHeaderLine(family, version, computeBodySha(source));
+	const eol = source.indexOf("\n");
+	return header + (eol === -1 ? "" : source.slice(eol));
+}
+//#endregion
+//#region src/detect.ts
+function detectProject(cwd) {
+	const pkgPath = path.join(cwd, "package.json");
+	const hasPackageJson = existsSync(pkgPath);
+	const pkg = hasPackageJson ? JSON.parse(readFileSync(pkgPath, "utf8")) : {
+		dependencies: {},
+		devDependencies: {}
+	};
+	const deps = {
+		...pkg.dependencies ?? {},
+		...pkg.devDependencies ?? {}
+	};
+	const packageManager = detectPackageManager(cwd, pkg.packageManager);
+	const tailwindVersion = deps["tailwindcss"] ?? null;
+	return {
+		packageManager,
+		tailwindVersion,
+		tailwindMajor: parseMajor(tailwindVersion),
+		bundler: detectBundler(deps),
+		framework: detectFramework(deps),
+		hasPackageJson
+	};
+}
+function detectPackageManager(cwd, declared) {
+	if (declared) {
+		const name = declared.split("@")[0];
+		if (name === "pnpm" || name === "yarn" || name === "bun" || name === "npm") return name;
+	}
+	if (existsSync(path.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+	if (existsSync(path.join(cwd, "yarn.lock"))) return "yarn";
+	if (existsSync(path.join(cwd, "bun.lockb"))) return "bun";
+	if (existsSync(path.join(cwd, "package-lock.json"))) return "npm";
+	return "npm";
+}
+function parseMajor(version) {
+	if (!version) return null;
+	const m = version.match(/(\d+)/);
+	if (!m) return null;
+	const n = Number(m[1]);
+	if (n === 3) return 3;
+	if (n === 4) return 4;
+	return null;
+}
+function detectBundler(deps) {
+	if (deps["next"]) return "next";
+	if (deps["astro"]) return "astro";
+	if (deps["vite"] || deps["@vitejs/plugin-react"] || deps["@vitejs/plugin-vue"]) return "vite";
+	return "unknown";
+}
+function detectFramework(deps) {
+	if (deps["astro"]) return "astro";
+	if (deps["react"] || deps["next"]) return "react";
+	if (deps["vue"]) return "vue";
+	if (deps["svelte"] || deps["@sveltejs/kit"]) return "svelte";
+	return "plain";
+}
+//#endregion
+//#region src/registry-source.ts
+const FAMILY_RE = /^[a-z0-9][a-z0-9-]{0,63}$/i;
+function assertValidFamilyName(family) {
+	if (!FAMILY_RE.test(family)) throw new Error(`invalid family name: ${JSON.stringify(family)} (must match ${FAMILY_RE})`);
+}
+function createRegistrySource(origin) {
+	if (origin.startsWith("http://") || origin.startsWith("https://")) return httpSource(origin);
+	return fileSource(origin);
+}
+function fileSource(origin) {
+	const root = origin.startsWith("file://") ? fileURLToPath(origin) : origin;
+	return {
+		origin,
+		async loadPresets() {
+			const body = await readFile(path.join(root, "presets.json"), "utf8");
+			return JSON.parse(body);
+		},
+		async loadFamily(family) {
+			assertValidFamilyName(family);
+			return readFile(path.join(root, "recipes", `${family}.css`), "utf8");
+		},
+		async listAllFamilies() {
+			const { readdir } = await import("node:fs/promises");
+			return (await readdir(path.join(root, "recipes"))).filter((f) => f.endsWith(".css")).map((f) => f.replace(/\.css$/, "")).filter((name) => FAMILY_RE.test(name)).sort();
+		}
+	};
+}
+function httpSource(origin) {
+	const base = origin.replace(/\/+$/, "");
+	return {
+		origin,
+		async loadPresets() {
+			const res = await fetch(`${base}/presets.json`);
+			if (!res.ok) throw new Error(`presets.json: ${res.status} ${res.statusText}`);
+			return await res.json();
+		},
+		async loadFamily(family) {
+			assertValidFamilyName(family);
+			const res = await fetch(`${base}/recipes/${family}.css`);
+			if (!res.ok) throw new Error(`${family}.css: ${res.status} ${res.statusText}`);
+			return res.text();
+		},
+		async listAllFamilies() {
+			const res = await fetch(`${base}/index.json`);
+			if (!res.ok) throw new Error(`index.json: ${res.status} ${res.statusText}`);
+			return (await res.json()).families.filter((name) => FAMILY_RE.test(name));
+		}
+	};
+}
+function resolvePresetFamilies(preset, presets, allFamilies) {
+	if (preset === "none") return [];
+	const entry = presets[preset];
+	if (entry === void 0) throw new Error(`Unknown preset '${preset}'. Available: ${Object.keys(presets).join(", ")}`);
+	if (entry === "*") return allFamilies;
+	return entry;
+}
+//#endregion
+//#region src/lockfile.ts
+const LOCK_FILENAME = ".shortwind-lock.json";
+function lockPath(recipesDir) {
+	return path.join(recipesDir, LOCK_FILENAME);
+}
+async function readLockfile(recipesDir) {
+	const p = lockPath(recipesDir);
+	if (!existsSync(p)) return {
+		version: 1,
+		registry: "",
+		families: {}
+	};
+	const body = await readFile(p, "utf8");
+	const raw = JSON.parse(body);
+	if (typeof raw !== "object" || raw === null) throw new Error(`${p}: lockfile must be a JSON object`);
+	const r = raw;
+	const families = {};
+	if (r["families"] !== void 0) {
+		if (typeof r["families"] !== "object" || r["families"] === null) throw new Error(`${p}: "families" must be an object`);
+		for (const [name, entry] of Object.entries(r["families"])) {
+			if (typeof entry !== "object" || entry === null) throw new Error(`${p}: families["${name}"] must be an object`);
+			const e = entry;
+			if (typeof e["version"] !== "string" || typeof e["sha"] !== "string") throw new Error(`${p}: families["${name}"] must have string "version" and "sha"`);
+			families[name] = {
+				version: e["version"],
+				sha: e["sha"]
+			};
+		}
+	}
+	return {
+		version: typeof r["version"] === "number" ? r["version"] : 1,
+		registry: typeof r["registry"] === "string" ? r["registry"] : "",
+		families
+	};
+}
+async function writeLockfile(recipesDir, lock) {
+	const sorted = {
+		version: lock.version || 1,
+		registry: lock.registry,
+		families: Object.fromEntries(Object.entries(lock.families).sort(([a], [b]) => a.localeCompare(b)))
+	};
+	await writeFile(lockPath(recipesDir), JSON.stringify(sorted, null, 2) + "\n");
+}
+//#endregion
+//#region src/init.ts
+const DEFAULT_REGISTRY = "https://shortwind.dev/registry";
+async function init(options) {
+	const cwd = path.resolve(options.cwd);
+	const registry = options.registry ?? "https://shortwind.dev/registry";
+	const source = createRegistrySource(registry);
+	const shape = detectProject(cwd);
+	const families = await resolveFamilies(options.preset, source);
+	const pkgs = pickPackages(shape.bundler);
+	const installer = options.installPackages ?? defaultInstall;
+	if (pkgs.length > 0) await installer(shape.packageManager, pkgs, cwd);
+	const recipesDir = path.join(cwd, "recipes");
+	const { installed, skipped } = await copyRecipes(source, families, recipesDir);
+	await updateLockfile(recipesDir, registry, installed);
+	const configPath = path.join(cwd, "shortwind.config.json");
+	await writeConfig(configPath, {
+		registry,
+		recipesDir: "recipes"
+	});
+	const vscodePath = path.join(cwd, ".vscode", "settings.json");
+	await wireVscodeClassRegex(vscodePath);
+	const huskyPath = path.join(cwd, ".husky", "pre-commit");
+	await installHuskyHook(huskyPath);
+	const skillPath = path.join(cwd, "skills", "shortwind", "SKILL.md");
+	await writeSkillMd(skillPath, recipesDir, families);
+	return {
+		packageManager: shape.packageManager,
+		preset: options.preset,
+		registry,
+		families,
+		installedPackages: pkgs,
+		installedFamilies: installed,
+		skippedFamilies: skipped,
+		configPath,
+		vscodePath,
+		huskyPath,
+		skillPath
+	};
+}
+async function resolveFamilies(preset, source) {
+	if (preset === "none") return [];
+	return resolvePresetFamilies(preset, await source.loadPresets(), await source.listAllFamilies());
+}
+function pickPackages(bundler) {
+	const base = ["@shortwind/tailwind"];
+	switch (bundler) {
+		case "vite": return [...base, "@shortwind/vite"];
+		case "next": return [...base, "@shortwind/next"];
+		case "astro": return [...base, "@shortwind/astro"];
+		default: return base;
+	}
+}
+const defaultInstall = async (pm, packages, cwd) => {
+	const { spawn } = await import("node:child_process");
+	const args = installArgs(pm, packages);
+	await new Promise((resolve, reject) => {
+		const child = spawn(pm, args, {
+			cwd,
+			stdio: "inherit"
+		});
+		child.on("error", reject);
+		child.on("exit", (code) => code === 0 ? resolve() : reject(/* @__PURE__ */ new Error(`${pm} ${args.join(" ")} exited ${code}`)));
+	});
+};
+function installArgs(pm, packages) {
+	switch (pm) {
+		case "pnpm": return [
+			"add",
+			"-D",
+			...packages
+		];
+		case "yarn": return [
+			"add",
+			"-D",
+			...packages
+		];
+		case "bun": return [
+			"add",
+			"-d",
+			...packages
+		];
+		default: return [
+			"install",
+			"-D",
+			...packages
+		];
+	}
+}
+async function updateLockfile(recipesDir, registry, newlyInstalled) {
+	const lock = await readLockfile(recipesDir);
+	if (!lock.registry) lock.registry = registry;
+	for (const family of newlyInstalled) {
+		const target = path.join(recipesDir, `${family}.css`);
+		if (!existsSync(target)) continue;
+		const header = extractHeader(readFileSync(target, "utf8"));
+		if (!header) throw new Error(`recipe "${family}" has no fingerprint header — refusing to add to lockfile`);
+		lock.families[family] = {
+			version: header.version,
+			sha: header.sha
+		};
+	}
+	await writeLockfile(recipesDir, lock);
+}
+async function copyRecipes(source, families, recipesDir) {
+	await mkdir(recipesDir, { recursive: true });
+	const installed = [];
+	const skipped = [];
+	for (const family of families) {
+		const target = path.join(recipesDir, `${family}.css`);
+		if (existsSync(target)) {
+			skipped.push(family);
+			continue;
+		}
+		const body = await source.loadFamily(family);
+		await writeFile(target, rewriteHeaderSha(body, computeBodySha(body)));
+		installed.push(family);
+	}
+	return {
+		installed,
+		skipped
+	};
+}
+async function writeConfig(configPath, next) {
+	const desired = {
+		registry: next.registry,
+		recipesDir: next.recipesDir,
+		outputPath: "skills/shortwind/SKILL.md"
+	};
+	if (!existsSync(configPath)) {
+		await writeFile(configPath, JSON.stringify(desired, null, 2) + "\n");
+		return;
+	}
+	const merged = {
+		...JSON.parse(await readFile(configPath, "utf8")),
+		...desired
+	};
+	await writeFile(configPath, JSON.stringify(merged, null, 2) + "\n");
+}
+const CLASS_REGEX_KEY = ["tailwindCSS.experimental.classRegex"];
+const CLASS_REGEX_VALUE = [["class\\s*[=:]\\s*['\"]([^'\"]*)['\"]", "([\\w-@/:]+)"], ["className\\s*=\\s*['\"]([^'\"]*)['\"]", "([\\w-@/:]+)"]];
+async function wireVscodeClassRegex(vscodePath) {
+	await mkdir(path.dirname(vscodePath), { recursive: true });
+	let body;
+	if (existsSync(vscodePath)) body = await readFile(vscodePath, "utf8");
+	else body = "{}\n";
+	const edits = modify(body, CLASS_REGEX_KEY, CLASS_REGEX_VALUE, { formattingOptions: {
+		tabSize: 2,
+		insertSpaces: true
+	} });
+	const next = applyEdits(body, edits);
+	parse(next);
+	await writeFile(vscodePath, next.endsWith("\n") ? next : next + "\n");
+}
+const HUSKY_LINE = "npx shortwind build";
+async function installHuskyHook(huskyPath) {
+	await mkdir(path.dirname(huskyPath), { recursive: true });
+	if (!existsSync(huskyPath)) {
+		await writeFile(huskyPath, `${HUSKY_LINE}\n`, { mode: 493 });
+		return;
+	}
+	const current = await readFile(huskyPath, "utf8");
+	if (current.includes(HUSKY_LINE)) return;
+	await writeFile(huskyPath, current.endsWith("\n") ? current + HUSKY_LINE + "\n" : current + "\nnpx shortwind build\n", { mode: 493 });
+}
+async function writeSkillMd(skillPath, recipesDir, families) {
+	await mkdir(path.dirname(skillPath), { recursive: true });
+	const allRecipes = [];
+	const guidance = {};
+	for (const family of families) {
+		const filePath = path.join(recipesDir, `${family}.css`);
+		if (!existsSync(filePath)) continue;
+		const parsed = parseRecipeFile(readFileSync(filePath, "utf8"), `${family}.css`);
+		if (parsed.ok) {
+			allRecipes.push(...parsed.value.recipes);
+			if (parsed.value.guidance) guidance[family] = parsed.value.guidance;
+		}
+	}
+	let registry = {
+		families: {},
+		flattened: {}
+	};
+	const resolved = buildRegistry(allRecipes, { guidance });
+	if (resolved.ok) registry = resolved.value;
+	await writeFile(skillPath, renderSkillMarkdown(registry, { order: families }));
+}
+//#endregion
+//#region src/project.ts
+const DEFAULT_CONFIG = {
+	registry: "https://shortwind.dev/registry",
+	recipesDir: "recipes",
+	outputPath: "skills/shortwind/SKILL.md"
+};
+async function readConfig(cwd) {
+	const configPath = path.join(cwd, "shortwind.config.json");
+	if (!existsSync(configPath)) return DEFAULT_CONFIG;
+	const body = await readFile(configPath, "utf8");
+	let parsed;
+	try {
+		parsed = JSON.parse(body);
+	} catch (err) {
+		throw new Error(`${configPath}: invalid JSON — ${err.message}`);
+	}
+	return {
+		...DEFAULT_CONFIG,
+		...parsed
+	};
+}
+function installedFamilies(recipesDir) {
+	if (!existsSync(recipesDir)) return [];
+	return readdirSync(recipesDir).filter((f) => f.endsWith(".css")).map((f) => f.replace(/\.css$/, "")).sort();
+}
+function parseInstalledFamily(recipesDir, family) {
+	const filePath = path.join(recipesDir, `${family}.css`);
+	if (!existsSync(filePath)) return null;
+	const result = parseRecipeFile(readFileSync(filePath, "utf8"), `${family}.css`);
+	if (!result.ok) return null;
+	return {
+		recipes: result.value.recipes,
+		header: result.value.header
+	};
+}
+async function regenerateSkillMd(cwd, config) {
+	const recipesDir = path.join(cwd, config.recipesDir);
+	const families = installedFamilies(recipesDir);
+	const skillPath = path.join(cwd, config.outputPath);
+	const { mkdir } = await import("node:fs/promises");
+	await mkdir(path.dirname(skillPath), { recursive: true });
+	const allRecipes = [];
+	const guidance = {};
+	for (const family of families) {
+		const parsed = parseRecipeFile(readFileSync(path.join(recipesDir, `${family}.css`), "utf8"), `${family}.css`);
+		if (parsed.ok) {
+			allRecipes.push(...parsed.value.recipes);
+			if (parsed.value.guidance) guidance[family] = parsed.value.guidance;
+		}
+	}
+	let registry = {
+		families: {},
+		flattened: {}
+	};
+	const resolved = buildRegistry(allRecipes, { guidance });
+	if (resolved.ok) registry = resolved.value;
+	await writeFile(skillPath, renderSkillMarkdown(registry, { order: families }));
+	return skillPath;
+}
+/**
+* Rewrite a recipe file so that every occurrence of `<from>` is replaced with `<to>`:
+*   - fingerprint header family slot
+*   - recipe names (after `@recipe `)
+*   - cross-recipe `@from` / `@from-*` references in bodies
+*
+* Descriptions and unrelated text are untouched.
+*/
+function renameFamilyInSource(source, from, to) {
+	const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	const f = escape(from);
+	let out = source;
+	out = out.replace(new RegExp(`(\\bshortwind:\\s+)${f}(\\b|@)`, "g"), `$1${to}$2`);
+	out = out.replace(new RegExp(`(@recipe\\s+)${f}(\\b|-)`, "g"), `$1${to}$2`);
+	out = out.replace(new RegExp(`@${f}(\\b|-)`, "g"), `@${to}$1`);
+	return out;
+}
+//#endregion
+//#region src/commands/add.ts
+async function add(options) {
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const registry = options.registry ?? config.registry;
+	const source = createRegistrySource(registry);
+	const recipesDir = path.join(cwd, config.recipesDir);
+	await mkdir(recipesDir, { recursive: true });
+	const lock = await readLockfile(recipesDir);
+	if (!lock.registry) lock.registry = registry;
+	const requested = options.all ? await source.listAllFamilies() : options.families;
+	if (options.all && options.as) throw new Error("--as cannot be combined with --all");
+	if (options.as && requested.length !== 1) throw new Error("--as requires exactly one family argument");
+	const added = [];
+	const skipped = [];
+	const overwritten = [];
+	const missingDependencies = [];
+	const installedRecipeNames = readAllInstalledRecipeNames(recipesDir);
+	for (const family of requested) {
+		const targetName = options.as ?? family;
+		const targetPath = path.join(recipesDir, `${targetName}.css`);
+		const exists = existsSync(targetPath);
+		if (exists && !options.force) {
+			skipped.push(targetName);
+			continue;
+		}
+		const sourceCss = await source.loadFamily(family);
+		const renamed = options.as ? renameFamilyInSource(sourceCss, family, options.as) : sourceCss;
+		const sha = computeBodySha(renamed);
+		const finalCss = rewriteHeaderSha(renamed, sha);
+		await writeFile(targetPath, finalCss);
+		const header = extractHeader(finalCss);
+		if (header) lock.families[targetName] = {
+			version: header.version,
+			sha
+		};
+		if (exists) overwritten.push(targetName);
+		else added.push(targetName);
+		const parsed = parseInstalledFamily(recipesDir, targetName);
+		if (parsed) {
+			for (const r of parsed.recipes) installedRecipeNames.add(r.name);
+			const ownNames = new Set(parsed.recipes.map((r) => r.name));
+			const missing = /* @__PURE__ */ new Set();
+			for (const recipe of parsed.recipes) for (const ref of recipe.references) {
+				if (ownNames.has(ref)) continue;
+				if (installedRecipeNames.has(ref)) continue;
+				missing.add(ref);
+			}
+			if (missing.size > 0) missingDependencies.push({
+				family: targetName,
+				references: Array.from(missing).sort()
+			});
+		}
+	}
+	await writeLockfile(recipesDir, lock);
+	return {
+		added,
+		skipped,
+		overwritten,
+		missingDependencies,
+		lockfile: lock,
+		skillPath: await regenerateSkillMd(cwd, config)
+	};
+}
+function readAllInstalledRecipeNames(recipesDir) {
+	const names = /* @__PURE__ */ new Set();
+	for (const fam of readDirFamilies(recipesDir)) {
+		const p = parseInstalledFamily(recipesDir, fam);
+		if (!p) continue;
+		for (const r of p.recipes) names.add(r.name);
+	}
+	return names;
+}
+function readDirFamilies(recipesDir) {
+	if (!existsSync(recipesDir)) return [];
+	return readdirSync(recipesDir).filter((f) => f.endsWith(".css")).map((f) => f.replace(/\.css$/, ""));
+}
+//#endregion
+//#region src/commands/remove.ts
+async function remove(options) {
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const recipesDir = path.join(cwd, config.recipesDir);
+	const lock = await readLockfile(recipesDir);
+	const removed = [];
+	const notFound = [];
+	const removedRecipeNames = /* @__PURE__ */ new Set();
+	for (const family of options.families) {
+		const target = path.join(recipesDir, `${family}.css`);
+		if (!existsSync(target)) {
+			notFound.push(family);
+			continue;
+		}
+		const parsed = parseInstalledFamily(recipesDir, family);
+		if (parsed) for (const r of parsed.recipes) removedRecipeNames.add(r.name);
+		await rm(target);
+		delete lock.families[family];
+		removed.push(family);
+	}
+	await writeLockfile(recipesDir, lock);
+	return {
+		removed,
+		notFound,
+		brokenDependents: collectBrokenDependents(recipesDir, removedRecipeNames),
+		lockfile: lock,
+		skillPath: await regenerateSkillMd(cwd, config)
+	};
+}
+function collectBrokenDependents(recipesDir, removedRecipeNames) {
+	if (removedRecipeNames.size === 0) return [];
+	const out = [];
+	for (const family of installedFamilies(recipesDir)) {
+		const parsed = parseInstalledFamily(recipesDir, family);
+		if (!parsed) continue;
+		const broken = /* @__PURE__ */ new Set();
+		for (const recipe of parsed.recipes) for (const ref of recipe.references) if (removedRecipeNames.has(ref)) broken.add(ref);
+		if (broken.size > 0) out.push({
+			dependent: family,
+			references: Array.from(broken).sort()
+		});
+	}
+	return out;
+}
+//#endregion
+//#region src/commands/preset.ts
+async function preset(options) {
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const source = createRegistrySource(options.registry ?? config.registry);
+	if (options.name === "none") throw new Error("Use `shortwind remove` to uninstall families; preset 'none' is for `init` only.");
+	const presets = await source.loadPresets();
+	const all = await source.listAllFamilies();
+	const addOptions = {
+		cwd,
+		families: resolvePresetFamilies(options.name, presets, all)
+	};
+	if (options.registry !== void 0) addOptions.registry = options.registry;
+	return {
+		...await add(addOptions),
+		preset: options.name
+	};
+}
+//#endregion
+//#region src/commands/ls.ts
+async function ls(options) {
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const recipesDir = path.join(cwd, config.recipesDir);
+	const lock = await readLockfile(recipesDir);
+	const installed = options.availableOnly ? [] : installedFamilies(recipesDir).map((family) => {
+		return {
+			family,
+			version: lock.families[family]?.version ?? null
+		};
+	});
+	let available = [];
+	if (!options.installedOnly) {
+		const source = createRegistrySource(options.registry ?? config.registry);
+		try {
+			available = await source.listAllFamilies();
+		} catch {
+			available = [];
+		}
+	}
+	return {
+		installed,
+		available
+	};
+}
+function formatLsText(result) {
+	const installedSet = new Set(result.installed.map((i) => i.family));
+	const lines = [];
+	lines.push("Installed:");
+	if (result.installed.length === 0) lines.push("  (none)");
+	for (const { family, version } of result.installed) lines.push(`  ${family}${version ? `  ${version}` : ""}`);
+	lines.push("");
+	lines.push("Available:");
+	if (result.available.length === 0) lines.push("  (registry unreachable)");
+	for (const family of result.available) {
+		const marker = installedSet.has(family) ? "*" : " ";
+		lines.push(`  ${marker} ${family}`);
+	}
+	return lines.join("\n");
+}
+//#endregion
+//#region src/commands/build.ts
+var BuildError = class extends Error {
+	diagnostics;
+	constructor(diagnostics) {
+		super(`shortwind build failed:\n${diagnostics.map((d) => `  ${d.file}:${d.line}${d.column ? `:${d.column}` : ""} ${d.code} — ${d.message}`).join("\n")}`);
+		this.diagnostics = diagnostics;
+		this.name = "BuildError";
+	}
+};
+async function build(options) {
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const recipesDir = path.join(cwd, config.recipesDir);
+	const families = installedFamilies(recipesDir);
+	const allRecipes = [];
+	const guidance = {};
+	const errors = [];
+	for (const family of families) {
+		const parsed = parseRecipeFile(readFileSync(path.join(recipesDir, `${family}.css`), "utf8"), `${family}.css`);
+		if (!parsed.ok) {
+			errors.push(...parsed.errors);
+			continue;
+		}
+		allRecipes.push(...parsed.value.recipes);
+		if (parsed.value.guidance) guidance[family] = parsed.value.guidance;
+	}
+	if (errors.length > 0) throw new BuildError(errors);
+	const resolved = buildRegistry(allRecipes, { guidance });
+	if (!resolved.ok) throw new BuildError(resolved.errors);
+	const skillPath = path.join(cwd, config.outputPath);
+	const next = renderSkillMarkdown(resolved.value, { order: families });
+	const current = existsSync(skillPath) ? readFileSync(skillPath, "utf8") : null;
+	let changed = false;
+	if (current !== next) {
+		await mkdir(path.dirname(skillPath), { recursive: true });
+		await writeFile(skillPath, next);
+		changed = true;
+	}
+	return {
+		changed,
+		families,
+		skillPath
+	};
+}
+//#endregion
+//#region src/commands/dev.ts
+async function dev(options) {
+	options.signal?.throwIfAborted();
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const recipesDir = path.join(cwd, config.recipesDir);
+	const debounceMs = options.debounceMs ?? 50;
+	const reconcileIntervalMs = options.reconcileIntervalMs ?? Math.max(1e3, debounceMs * 5);
+	const status = (s) => options.onStatus?.(s);
+	const watcher = chokidar.watch(recipesDir, {
+		ignoreInitial: true,
+		awaitWriteFinish: {
+			stabilityThreshold: 25,
+			pollInterval: 10
+		}
+	});
+	let timer = null;
+	let reconcileTimer = null;
+	let running = false;
+	let pending = false;
+	let pendingSilent = true;
+	const runBuild = async (silentNoChange = false) => {
+		if (running) {
+			pending = true;
+			pendingSilent = pendingSilent && silentNoChange;
+			return;
+		}
+		running = true;
+		try {
+			let currentSilent = silentNoChange;
+			do {
+				pending = false;
+				pendingSilent = true;
+				try {
+					const result = await build({ cwd });
+					if (!currentSilent || result.changed) status({
+						kind: "rebuilt",
+						families: result.families,
+						changed: result.changed
+					});
+				} catch (err) {
+					if (err instanceof BuildError) status({
+						kind: "error",
+						message: err.message
+					});
+					else status({
+						kind: "error",
+						message: err instanceof Error ? err.message : String(err)
+					});
+				}
+				currentSilent = pendingSilent;
+			} while (pending);
+		} finally {
+			running = false;
+		}
+	};
+	const schedule = () => {
+		if (timer) clearTimeout(timer);
+		timer = setTimeout(() => void runBuild(false), debounceMs);
+	};
+	watcher.on("add", schedule).on("change", schedule).on("unlink", schedule);
+	let stopped = false;
+	const stop = async () => {
+		if (stopped) return;
+		stopped = true;
+		if (timer) clearTimeout(timer);
+		if (reconcileTimer) clearInterval(reconcileTimer);
+		await watcher.close();
+	};
+	if (options.signal) {
+		if (options.signal.aborted) {
+			await stop();
+			return { stop };
+		}
+		options.signal.addEventListener("abort", () => void stop(), { once: true });
+	}
+	await new Promise((resolve) => watcher.once("ready", () => resolve()));
+	if (stopped) return { stop };
+	await runBuild();
+	if (stopped) return { stop };
+	status({
+		kind: "ready",
+		recipesDir
+	});
+	reconcileTimer = setInterval(() => void runBuild(true), reconcileIntervalMs);
+	return { stop };
+}
+//#endregion
+//#region src/commands/upgrade.ts
+var UpgradeError = class extends Error {
+	errors;
+	constructor(errors) {
+		super(`shortwind upgrade failed:\n${errors.map((e) => `  ${e.family}: ${e.message}`).join("\n")}`);
+		this.errors = errors;
+		this.name = "UpgradeError";
+	}
+};
+async function upgrade(options) {
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const registry = options.registry ?? config.registry;
+	const source = options.source ?? createRegistrySource(registry);
+	const recipesDir = path.join(cwd, config.recipesDir);
+	const installed = installedFamilies(recipesDir);
+	const targets = options.families && options.families.length > 0 ? options.families : installed;
+	const lock = await readLockfile(recipesDir);
+	let lockfileDirty = false;
+	if (!lock.registry) {
+		lock.registry = registry;
+		lockfileDirty = true;
+	}
+	const outcomes = [];
+	const errors = [];
+	let hasUpdates = false;
+	let hasTouched = false;
+	let anyWritten = false;
+	for (const family of targets) {
+		const filePath = path.join(recipesDir, `${family}.css`);
+		if (!existsSync(filePath)) {
+			outcomes.push({
+				family,
+				action: "skipped",
+				reason: "not installed",
+				state: "missing"
+			});
+			continue;
+		}
+		let incomingBody;
+		try {
+			incomingBody = await source.loadFamily(family);
+		} catch (err) {
+			errors.push({
+				family,
+				message: err.message
+			});
+			continue;
+		}
+		const incomingHeader = extractHeader(incomingBody);
+		if (!incomingHeader) {
+			errors.push({
+				family,
+				message: "registry recipe has no fingerprint header"
+			});
+			continue;
+		}
+		const incomingVersion = incomingHeader.version;
+		const localBody = readFileSync(filePath, "utf8");
+		const localHeader = extractHeader(localBody);
+		const recordedSha = localHeader?.sha ?? "";
+		const actualSha = computeBodySha(localBody);
+		const lockedVersion = lock.families[family]?.version ?? localHeader?.version ?? "";
+		const isTouched = recordedSha !== "" && recordedSha !== actualSha;
+		if ((isTouched ? "touched" : lockedVersion === incomingVersion ? "unchanged" : "pristine") === "unchanged" && !isTouched) {
+			outcomes.push({
+				family,
+				action: "kept",
+				reason: "unchanged",
+				state: "unchanged"
+			});
+			continue;
+		}
+		if (options.check) {
+			if (isTouched) {
+				hasTouched = true;
+				if (lockedVersion !== incomingVersion) hasUpdates = true;
+				outcomes.push({
+					family,
+					action: "would-review",
+					from: lockedVersion,
+					to: incomingVersion,
+					state: "touched"
+				});
+			} else {
+				hasUpdates = true;
+				outcomes.push({
+					family,
+					action: "would-update",
+					from: lockedVersion,
+					to: incomingVersion,
+					state: "pristine"
+				});
+			}
+			continue;
+		}
+		if (isTouched && !options.force) {
+			hasTouched = true;
+			const choice = options.resolver ? await options.resolver({
+				family,
+				local: localBody,
+				baseline: {
+					version: lockedVersion,
+					sha: recordedSha
+				},
+				incoming: {
+					version: incomingVersion,
+					body: incomingBody
+				}
+			}) : "skip";
+			if (choice === "keep") {
+				outcomes.push({
+					family,
+					action: "kept",
+					reason: "user-chose-keep",
+					state: "touched"
+				});
+				continue;
+			}
+			if (choice === "skip") {
+				outcomes.push({
+					family,
+					action: "skipped",
+					reason: "touched",
+					state: "touched"
+				});
+				continue;
+			}
+		}
+		const newSha = computeBodySha(incomingBody);
+		await atomicWrite(filePath, rewriteHeaderSha(incomingBody, newSha));
+		lock.families[family] = {
+			version: incomingVersion,
+			sha: newSha
+		};
+		outcomes.push({
+			family,
+			action: "updated",
+			from: lockedVersion,
+			to: incomingVersion,
+			state: isTouched ? "touched" : "pristine"
+		});
+		hasUpdates = true;
+		anyWritten = true;
+		lockfileDirty = true;
+	}
+	if (errors.length > 0) throw new UpgradeError(errors);
+	let skillPath = null;
+	if (!options.check) {
+		if (lockfileDirty) await writeLockfile(recipesDir, lock);
+		if (anyWritten) skillPath = await regenerateSkillMd(cwd, config);
+	}
+	return {
+		outcomes,
+		hasUpdates,
+		hasTouched,
+		lockfile: lock,
+		skillPath
+	};
+}
+async function atomicWrite(filePath, body) {
+	const tmp = filePath + ".tmp";
+	const fh = await open(tmp, "w");
+	try {
+		await fh.writeFile(body);
+		await fh.sync();
+	} finally {
+		await fh.close();
+	}
+	await rename(tmp, filePath);
+}
+//#endregion
+//#region src/commands/verify.ts
+async function verify(options) {
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const recipesDir = path.join(cwd, config.recipesDir);
+	const installed = installedFamilies(recipesDir);
+	const lock = await readLockfile(recipesDir);
+	const issues = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const family of installed) {
+		seen.add(family);
+		const filePath = path.join(recipesDir, `${family}.css`);
+		const source = readFileSync(filePath, "utf8");
+		const header = extractHeader(source);
+		if (!header) {
+			issues.push({
+				family,
+				kind: "missing-header",
+				file: filePath
+			});
+			continue;
+		}
+		const actual = computeBodySha(source);
+		if (header.sha !== actual) issues.push({
+			family,
+			kind: "header-tampered",
+			file: filePath,
+			recorded: header.sha,
+			actual
+		});
+		const locked = lock.families[family];
+		if (!locked) issues.push({
+			family,
+			kind: "missing-lock-entry",
+			file: filePath
+		});
+		else if (locked.sha !== actual) issues.push({
+			family,
+			kind: "lockfile-mismatch",
+			file: filePath,
+			locked: locked.sha,
+			actual
+		});
+	}
+	for (const family of Object.keys(lock.families)) {
+		if (seen.has(family)) continue;
+		const filePath = path.join(recipesDir, `${family}.css`);
+		if (!existsSync(filePath)) issues.push({
+			family,
+			kind: "missing-file",
+			file: filePath
+		});
+	}
+	return {
+		ok: issues.length === 0,
+		checked: installed,
+		issues
+	};
+}
+//#endregion
+//#region src/bench-corpus/default-recipes.ts
+const DEFAULT_RECIPES_CSS = {
+	"badge.css": "/* shortwind: badge@0.0.1 sha:000000 */\n\n/* @guide\n   @badge is the neutral default; tone variants @badge-success/warning/danger/\n   info carry their own color; @badge-outline is unfilled. One tone per badge.\n   @badge-base is a color-less shell for building custom tones — not for direct\n   use.\n*/\n\n/* Badge shell — shape, sizing, focus ring. No bg/text/border color so\n   variants can supply their own tone without conflicts. */\n@recipe badge-base {\n  inline-flex items-center rounded-full border px-2.5 py-0.5 text-xs font-medium transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2\n}\n\n/* Default neutral badge. */\n@recipe badge {\n  inline-flex items-center gap-1 rounded-full bg-muted px-2 py-0.5 text-xs font-medium text-muted-foreground\n}\n\n/* Success tone badge. */\n@recipe badge-success {\n  inline-flex items-center gap-1 rounded-full bg-green-100 px-2 py-0.5 text-xs font-medium text-green-800 dark:bg-green-900 dark:text-green-200\n}\n\n/* Warning tone badge. */\n@recipe badge-warning {\n  inline-flex items-center gap-1 rounded-full bg-amber-100 px-2 py-0.5 text-xs font-medium text-amber-800 dark:bg-amber-900 dark:text-amber-200\n}\n\n/* Danger tone badge. */\n@recipe badge-danger {\n  inline-flex items-center gap-1 rounded-full bg-destructive/15 px-2 py-0.5 text-xs font-medium text-destructive\n}\n\n/* Info tone badge. */\n@recipe badge-info {\n  inline-flex items-center gap-1 rounded-full bg-primary/15 px-2 py-0.5 text-xs font-medium text-primary\n}\n\n/* Outline badge — no fill. */\n@recipe badge-outline {\n  inline-flex items-center gap-1 rounded-full border border-border px-2 py-0.5 text-xs font-medium text-foreground\n}\n",
+	"button.css": "/* shortwind: button@0.0.1 sha:000000 */\n\n/* @guide\n   Name order is @btn-<intent>[-<size>]: intent first (primary/secondary/ghost/\n   danger/outline), size second (sm/lg; omit for default). One intent per\n   button — never combine @btn-primary with @btn-danger. @btn-ghost is text-only,\n   @btn-outline is bordered with no fill, @btn-icon is a square icon button.\n   @btn-base is the shared shell; don't use it on its own.\n*/\n\n/* Shared button base — sizing, focus ring, disabled state. */\n@recipe btn-base {\n  inline-flex items-center justify-center gap-2 rounded-md px-4 py-2 text-sm font-medium transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring disabled:cursor-not-allowed disabled:opacity-50\n}\n\n/* Primary call-to-action button. */\n@recipe btn-primary {\n  @btn-base bg-primary text-primary-foreground hover:bg-primary/90\n}\n\n/* Small primary button. */\n@recipe btn-primary-sm {\n  @btn-primary px-3 py-1.5 text-xs\n}\n\n/* Large primary button. */\n@recipe btn-primary-lg {\n  @btn-primary px-6 py-3 text-base\n}\n\n/* Secondary button — bordered surface tone. */\n@recipe btn-secondary {\n  @btn-base border border-border bg-secondary text-secondary-foreground hover:bg-secondary/80\n}\n\n/* Small secondary button. */\n@recipe btn-secondary-sm {\n  @btn-secondary px-3 py-1.5 text-xs\n}\n\n/* Large secondary button. */\n@recipe btn-secondary-lg {\n  @btn-secondary px-6 py-3 text-base\n}\n\n/* Ghost button — text only, no background. */\n@recipe btn-ghost {\n  @btn-base text-foreground hover:bg-muted\n}\n\n/* Small ghost button. */\n@recipe btn-ghost-sm {\n  @btn-ghost px-3 py-1.5 text-xs\n}\n\n/* Large ghost button. */\n@recipe btn-ghost-lg {\n  @btn-ghost px-6 py-3 text-base\n}\n\n/* Destructive button. */\n@recipe btn-danger {\n  @btn-base bg-destructive text-destructive-foreground hover:bg-destructive/90\n}\n\n/* Outline button — bordered without fill. */\n@recipe btn-outline {\n  @btn-base border border-primary text-primary hover:bg-primary/10\n}\n\n/* Square icon-only button. */\n@recipe btn-icon {\n  inline-flex h-9 w-9 items-center justify-center rounded-md text-foreground transition-colors hover:bg-muted focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring disabled:cursor-not-allowed disabled:opacity-50\n}\n",
+	"card.css": "/* shortwind: card@0.0.1 sha:000000 */\n\n/* @guide\n   Pick exactly one container: @card (default), @card-elevated (raised shadow),\n   @card-flat (no border), or @card-interactive (clickable hover/focus) — don't\n   stack two container variants on one element. Lay out the inside with\n   @card-header / @card-body / @card-footer.\n*/\n\n/* Default content card with border, padding, and surface color. */\n@recipe card {\n  rounded-lg border border-border bg-card text-card-foreground p-4\n}\n\n/* Card with raised shadow for emphasis. */\n@recipe card-elevated {\n  @card shadow-md\n}\n\n/* Card without border, on a muted surface. */\n@recipe card-flat {\n  rounded-lg bg-muted text-foreground p-4\n}\n\n/* Clickable card with hover and focus-visible states. */\n@recipe card-interactive {\n  @card cursor-pointer transition-shadow hover:shadow-md focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring\n}\n\n/* Card header region with bottom divider. */\n@recipe card-header {\n  mb-3 border-b border-border pb-3\n}\n\n/* Card body region. */\n@recipe card-body {\n  py-1\n}\n\n/* Card footer with top divider and right-aligned actions. */\n@recipe card-footer {\n  mt-3 flex items-center justify-end gap-2 border-t border-border pt-3\n}\n",
+	"code.css": "/* shortwind: code@0.0.1 sha:000000 */\n\n/* @guide\n   @code-inline for a code span inside prose, @code-block for a multi-line\n   preformatted block, @kbd for a keyboard-shortcut hint. Pick by context, not\n   by size.\n*/\n\n/* Inline code span. */\n@recipe code-inline {\n  rounded bg-muted px-1.5 py-0.5 font-mono text-[0.875em] text-foreground\n}\n\n/* Block of preformatted code. */\n@recipe code-block {\n  overflow-x-auto rounded-md border border-border bg-muted p-4 font-mono text-sm leading-6 text-foreground\n}\n\n/* Keyboard shortcut hint. */\n@recipe kbd {\n  inline-flex items-center rounded border border-border bg-muted px-1.5 py-0.5 font-mono text-xs text-foreground shadow-sm\n}\n",
+	"dialog.css": "/* shortwind: dialog@0.0.1 sha:000000 */\n\n/* @guide\n   A modal is three layers: @dialog-overlay (dimmed backdrop), @dialog (the\n   centering wrapper), and @dialog-content (the panel). Structure the panel with\n   @dialog-header and @dialog-footer. Don't put content styling on @dialog\n   itself — it's only the positioner.\n*/\n\n/* Modal dialog wrapper — covers the viewport, centers content. */\n@recipe dialog {\n  fixed inset-0 z-50 flex items-center justify-center p-4\n}\n\n/* Dimmed overlay behind the dialog. */\n@recipe dialog-overlay {\n  fixed inset-0 z-40 bg-black/50\n}\n\n/* Dialog content panel. */\n@recipe dialog-content {\n  relative z-50 w-full max-w-md rounded-lg border border-border bg-popover text-popover-foreground p-6 shadow-xl\n}\n\n/* Dialog header region with title. */\n@recipe dialog-header {\n  mb-4 flex flex-col gap-1\n}\n\n/* Dialog footer with right-aligned actions. */\n@recipe dialog-footer {\n  mt-6 flex items-center justify-end gap-2\n}\n",
+	"empty.css": "/* shortwind: empty@0.0.1 sha:000000 */\n\n/* @guide\n   @empty is the container for a no-data state; fill it with @empty-icon,\n   @empty-title, and @empty-description. These are slots for that pattern — use\n   @heading-* / @body from the text family for ordinary copy.\n*/\n\n/* Empty-state container. */\n@recipe empty {\n  flex flex-col items-center justify-center gap-3 rounded-md border border-dashed border-border p-8 text-center\n}\n\n/* Empty-state icon slot. */\n@recipe empty-icon {\n  flex h-12 w-12 items-center justify-center rounded-full bg-muted text-muted-foreground\n}\n\n/* Empty-state title text. */\n@recipe empty-title {\n  text-base font-semibold text-foreground\n}\n\n/* Empty-state supporting description. */\n@recipe empty-description {\n  max-w-sm text-sm text-muted-foreground\n}\n",
+	"feedback.css": "/* shortwind: feedback@0.0.1 sha:000000 */\n\n/* @guide\n   Inline messages use @alert (neutral) or a tone variant @alert-success/\n   warning/danger/info — one tone each. @callout is a left-accent inline note,\n   @toast is a floating notification, @banner spans the full viewport width.\n*/\n\n/* Default informational alert. */\n@recipe alert {\n  flex items-start gap-3 rounded-md border border-border bg-card p-4 text-sm text-card-foreground\n}\n\n/* Success alert. */\n@recipe alert-success {\n  flex items-start gap-3 rounded-md border border-green-200 bg-green-50 p-4 text-sm text-green-900 dark:border-green-900 dark:bg-green-950 dark:text-green-100\n}\n\n/* Warning alert. */\n@recipe alert-warning {\n  flex items-start gap-3 rounded-md border border-amber-200 bg-amber-50 p-4 text-sm text-amber-900 dark:border-amber-900 dark:bg-amber-950 dark:text-amber-100\n}\n\n/* Danger alert. */\n@recipe alert-danger {\n  flex items-start gap-3 rounded-md border border-destructive/30 bg-destructive/10 p-4 text-sm text-destructive\n}\n\n/* Informational alert. */\n@recipe alert-info {\n  flex items-start gap-3 rounded-md border border-primary/30 bg-primary/10 p-4 text-sm text-primary\n}\n\n/* Inline callout — flush left edge accent. */\n@recipe callout {\n  border-l-4 border-primary bg-primary/10 p-4 text-sm text-foreground\n}\n\n/* Floating toast notification. */\n@recipe toast {\n  pointer-events-auto flex items-start gap-3 rounded-md border border-border bg-popover p-4 text-sm text-popover-foreground shadow-lg\n}\n\n/* Full-width banner spanning the viewport. */\n@recipe banner {\n  w-full bg-primary px-4 py-2 text-center text-sm font-medium text-primary-foreground\n}\n",
+	"form.css": "/* shortwind: form@0.0.1 sha:000000 */\n\n/* @guide\n   Wrap each label+control+message in @field (use @field-error for the invalid\n   state); group related fields with @fieldset. Controls are bare: @input,\n   @textarea, @select, @checkbox, @radio, plus @input-error for invalid text\n   and @input-shell for the transparent shadcn-style shell. Helper text is\n   @help. There is no @form-group (use @field), @form-input (use @input),\n   @form-helper (use @help) or @form-checkbox (use @checkbox); the field label\n   recipe is @label, in the text family.\n*/\n\n/* Text input field. */\n@recipe input {\n  block w-full rounded-md border border-input bg-background px-3 py-2 text-sm text-foreground placeholder:text-muted-foreground focus:border-ring focus:outline-2 focus:outline-offset-2 focus:outline-ring disabled:cursor-not-allowed disabled:opacity-50\n}\n\n/* shadcn/dinachi-style input shell — transparent background, h-9, file/\n   placeholder/selection/aria-invalid/focus-visible states baked in. */\n@recipe input-shell {\n  flex h-9 w-full min-w-0 rounded-md border border-input bg-transparent px-3 py-1 text-base shadow-xs outline-none transition-[color,box-shadow] placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:border-destructive aria-invalid:ring-destructive/20 disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm dark:bg-input/30 dark:aria-invalid:ring-destructive/40\n}\n\n/* Input in error state. */\n@recipe input-error {\n  @input border-destructive focus:border-destructive focus:outline-destructive\n}\n\n/* Multi-line textarea. */\n@recipe textarea {\n  block w-full rounded-md border border-input bg-background px-3 py-2 text-sm text-foreground placeholder:text-muted-foreground focus:border-ring focus:outline-2 focus:outline-offset-2 focus:outline-ring disabled:cursor-not-allowed disabled:opacity-50\n}\n\n/* Native select control. */\n@recipe select {\n  block w-full rounded-md border border-input bg-background px-3 py-2 text-sm text-foreground focus:border-ring focus:outline-2 focus:outline-offset-2 focus:outline-ring disabled:cursor-not-allowed disabled:opacity-50\n}\n\n/* Checkbox input. */\n@recipe checkbox {\n  h-4 w-4 rounded border-input text-primary focus:outline-2 focus:outline-offset-2 focus:outline-ring\n}\n\n/* Radio input. */\n@recipe radio {\n  h-4 w-4 border-input text-primary focus:outline-2 focus:outline-offset-2 focus:outline-ring\n}\n\n/* Form field wrapper — label + input + help/error. */\n@recipe field {\n  flex flex-col gap-1.5\n}\n\n/* Form field in error state. */\n@recipe field-error {\n  flex flex-col gap-1.5\n}\n\n/* Grouped form section with optional legend. */\n@recipe fieldset {\n  flex flex-col gap-4 rounded-md border border-border p-4\n}\n\n/* Field-level helper text. */\n@recipe help {\n  text-xs text-muted-foreground\n}\n",
+	"icon.css": "/* shortwind: icon@0.0.1 sha:000000 */\n\n/* @guide\n   Size an icon with @icon-sm/md/lg (16/20/24px) — these set width and height\n   only; add @icon-muted for secondary color. They're for SVG/icon elements, not\n   to be confused with @btn-icon (the icon button in the button family).\n*/\n\n/* Small icon — 16px. */\n@recipe icon-sm {\n  h-4 w-4 shrink-0\n}\n\n/* Default icon size — 20px. */\n@recipe icon-md {\n  h-5 w-5 shrink-0\n}\n\n/* Large icon — 24px. */\n@recipe icon-lg {\n  h-6 w-6 shrink-0\n}\n\n/* Icon with muted color. */\n@recipe icon-muted {\n  text-muted-foreground\n}\n",
+	"layout.css": "/* shortwind: layout@0.0.1 sha:000000 */\n\n/* @guide\n   Composition primitives. @stack-* stacks children vertically (flex-col);\n   @row* lays them out horizontally (flex-row). Choose the gap with the size\n   suffix (xs/sm/md/lg on stacks). Use @grid-2/3/4 only for true multi-column\n   grids, @center to center on both axes, @full to fill the parent. Common\n   slips: there is no @flex-row (use @row) or @flex-col (use a @stack-*), and\n   the grids are @grid-3, not @grid-cols-3.\n*/\n\n/* Vertical stack with extra-small gap. */\n@recipe stack-xs {\n  flex flex-col gap-1\n}\n\n/* Vertical stack with small gap. */\n@recipe stack-sm {\n  flex flex-col gap-2\n}\n\n/* Vertical stack with medium gap. */\n@recipe stack-md {\n  flex flex-col gap-4\n}\n\n/* Vertical stack with large gap. */\n@recipe stack-lg {\n  flex flex-col gap-8\n}\n\n/* Horizontal row with default gap and centered items. */\n@recipe row {\n  flex flex-row items-center gap-2\n}\n\n/* Horizontal row with space between children. */\n@recipe row-between {\n  flex flex-row items-center justify-between gap-2\n}\n\n/* Horizontal row aligned to the end. */\n@recipe row-end {\n  flex flex-row items-center justify-end gap-2\n}\n\n/* Two-column responsive grid. */\n@recipe grid-2 {\n  grid grid-cols-1 gap-4 sm:grid-cols-2\n}\n\n/* Three-column responsive grid. */\n@recipe grid-3 {\n  grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3\n}\n\n/* Four-column responsive grid. */\n@recipe grid-4 {\n  grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4\n}\n\n/* Center content horizontally and vertically. */\n@recipe center {\n  flex items-center justify-center\n}\n\n/* Fill the available width and height. */\n@recipe full {\n  h-full w-full\n}\n",
+	"list.css": "/* shortwind: list@0.0.1 sha:000000 */\n\n/* @guide\n   @list wraps a stack of @list-item rows; use @list-bordered for divided rows.\n   Definition lists are separate: @dl with @dt (term) and @dd (description).\n   For site navigation reach for the navigation family (@nav), not @list.\n*/\n\n/* Vertical list with default gap. */\n@recipe list {\n  flex flex-col gap-1\n}\n\n/* Single list item. */\n@recipe list-item {\n  flex items-center gap-2 rounded-md px-3 py-2 text-sm text-foreground\n}\n\n/* List with dividing borders between items. */\n@recipe list-bordered {\n  divide-y divide-border rounded-md border border-border\n}\n\n/* Definition list container. */\n@recipe dl {\n  grid grid-cols-1 gap-2 sm:grid-cols-3 sm:gap-4\n}\n\n/* Definition term. */\n@recipe dt {\n  text-sm font-medium text-muted-foreground\n}\n\n/* Definition description. */\n@recipe dd {\n  text-sm text-foreground sm:col-span-2\n}\n",
+	"media.css": "/* shortwind: media@0.0.1 sha:000000 */\n\n/* @guide\n   @avatar (with @avatar-sm/lg) is a round user image; @thumb is a small square\n   thumbnail. For responsive embeds use @aspect-square or @aspect-video. Avatars\n   are circular by default — don't restyle the radius.\n*/\n\n/* User/profile avatar. */\n@recipe avatar {\n  inline-flex h-10 w-10 items-center justify-center overflow-hidden rounded-full bg-muted text-sm font-medium text-muted-foreground\n}\n\n/* Small avatar. */\n@recipe avatar-sm {\n  @avatar h-6 w-6 text-xs\n}\n\n/* Large avatar. */\n@recipe avatar-lg {\n  @avatar h-14 w-14 text-base\n}\n\n/* Small image thumbnail. */\n@recipe thumb {\n  h-16 w-16 rounded-md object-cover\n}\n\n/* 1:1 aspect-ratio wrapper. */\n@recipe aspect-square {\n  aspect-square w-full overflow-hidden rounded-md\n}\n\n/* 16:9 aspect-ratio wrapper. */\n@recipe aspect-video {\n  aspect-video w-full overflow-hidden rounded-md\n}\n",
+	"navigation.css": "/* shortwind: navigation@0.0.1 sha:000000 */\n\n/* @guide\n   @nav is the container; links are @nav-link with @nav-link-active for the\n   current page. Tabs mirror that pair: @tab and @tab-active. Use @breadcrumb\n   for trail navigation. Active and inactive are separate recipes — swap the\n   whole class rather than combining them.\n*/\n\n/* Top-level nav container. */\n@recipe nav {\n  flex items-center gap-1\n}\n\n/* Inactive nav link with hover/focus states. */\n@recipe nav-link {\n  inline-flex items-center gap-2 rounded-md px-3 py-1.5 text-sm font-medium text-muted-foreground transition-colors hover:bg-muted hover:text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring\n}\n\n/* Active nav link. */\n@recipe nav-link-active {\n  inline-flex items-center gap-2 rounded-md bg-muted px-3 py-1.5 text-sm font-medium text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring\n}\n\n/* Breadcrumb trail container. */\n@recipe breadcrumb {\n  flex items-center gap-1.5 text-sm text-muted-foreground\n}\n\n/* Inactive tab control. */\n@recipe tab {\n  inline-flex items-center gap-2 border-b-2 border-transparent px-3 py-2 text-sm font-medium text-muted-foreground transition-colors hover:border-border hover:text-foreground focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring\n}\n\n/* Active tab control. */\n@recipe tab-active {\n  inline-flex items-center gap-2 border-b-2 border-primary px-3 py-2 text-sm font-medium text-primary focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring\n}\n",
+	"progress.css": "/* shortwind: progress@0.0.1 sha:000000 */\n\n/* @guide\n   A bar is two pieces: @progress-track (the background) wrapping @progress-bar\n   (the fill). For an indeterminate state use @spinner instead — it's a\n   standalone loader, not a bar.\n*/\n\n/* Progress bar track (background). */\n@recipe progress-track {\n  h-2 w-full overflow-hidden rounded-full bg-muted\n}\n\n/* Progress bar fill. */\n@recipe progress-bar {\n  h-full rounded-full bg-primary transition-all\n}\n\n/* Indeterminate loading spinner. */\n@recipe spinner {\n  inline-block h-4 w-4 animate-spin rounded-full border-2 border-border border-t-primary\n}\n",
+	"skeleton.css": "/* shortwind: skeleton@0.0.1 sha:000000 */\n\n/* @guide\n   Match the skeleton to the shape it stands in for: @skeleton (block),\n   @skeleton-text (a text line), @skeleton-circle (avatar/icon). Size block and\n   text skeletons with raw width/height utilities.\n*/\n\n/* Default rectangular skeleton placeholder. */\n@recipe skeleton {\n  animate-pulse rounded-md bg-muted\n}\n\n/* Single-line text skeleton. */\n@recipe skeleton-text {\n  h-4 w-full animate-pulse rounded bg-muted\n}\n\n/* Circular skeleton (avatar/icon). */\n@recipe skeleton-circle {\n  h-10 w-10 animate-pulse rounded-full bg-muted\n}\n",
+	"surface.css": "/* shortwind: surface@0.0.1 sha:000000 */\n\n/* @guide\n   @surface / @surface-muted / @surface-accent set a background+foreground pair\n   for a region — one per section. @container (or @container-tight for prose)\n   centers and width-caps content; there is no @container-lg, set a different cap\n   with max-w-* yourself. @divider-h and @divider-v are hairline rules.\n*/\n\n/* Default page/section surface. */\n@recipe surface {\n  bg-background text-foreground\n}\n\n/* Muted surface — secondary background. */\n@recipe surface-muted {\n  bg-muted text-foreground\n}\n\n/* Accent surface — soft brand background. */\n@recipe surface-accent {\n  bg-accent text-accent-foreground\n}\n\n/* Standard content container with max width. */\n@recipe container {\n  mx-auto w-full max-w-6xl px-4 sm:px-6 lg:px-8\n}\n\n/* Narrow content container for prose. */\n@recipe container-tight {\n  mx-auto w-full max-w-3xl px-4 sm:px-6\n}\n\n/* Horizontal divider line. */\n@recipe divider-h {\n  shrink-0 h-px w-full bg-border\n}\n\n/* Vertical divider line. */\n@recipe divider-v {\n  shrink-0 h-full w-px bg-border\n}\n",
+	"table.css": "/* shortwind: table@0.0.1 sha:000000 */\n\n/* @guide\n   Wrap the table in @table-container for horizontal overflow, then put @table\n   (or @table-zebra for striped rows) on the <table>. Cells are @th (header) and\n   @td (body); add @tr-hover to a <tr> for row highlighting.\n*/\n\n/* Scroll container for a wide table — keeps overflow horizontal. */\n@recipe table-container {\n  w-full overflow-x-auto rounded-md border border-border\n}\n\n/* Data table base. */\n@recipe table {\n  w-full border-collapse text-left text-sm text-foreground\n}\n\n/* Table header cell. */\n@recipe th {\n  border-b border-border px-3 py-2 text-xs font-semibold uppercase tracking-wide text-muted-foreground\n}\n\n/* Table body cell. */\n@recipe td {\n  border-b border-border px-3 py-2\n}\n\n/* Row hover state. */\n@recipe tr-hover {\n  transition-colors hover:bg-muted\n}\n\n/* Table with zebra striping on alternating rows. */\n@recipe table-zebra {\n  w-full border-collapse text-left text-sm text-foreground [&_tbody_tr:nth-child(odd)]:bg-muted\n}\n",
+	"text.css": "/* shortwind: text@0.0.1 sha:000000 */\n\n/* @guide\n   Headings are sized by weight, not HTML level: @heading-xl/lg/md/sm — there\n   is no @h1..@h6. Body copy: @body (default), @lead (intro paragraphs), @muted\n   (secondary), @caption (fine print). Use @label for form labels and @link for\n   inline links. Don't append a -text suffix: it's @body not @body-text, @muted\n   not @muted-text, @link not @link-text.\n*/\n\n/* Top-level page heading. */\n@recipe heading-xl {\n  text-4xl font-bold tracking-tight text-foreground\n}\n\n/* Large section heading. */\n@recipe heading-lg {\n  text-2xl font-semibold tracking-tight text-foreground\n}\n\n/* Medium heading. */\n@recipe heading-md {\n  text-xl font-semibold text-foreground\n}\n\n/* Small heading. */\n@recipe heading-sm {\n  text-base font-semibold text-foreground\n}\n\n/* Default body text. */\n@recipe body {\n  text-sm leading-6 text-foreground\n}\n\n/* Lead paragraph — larger body copy for hero/intro sections. */\n@recipe lead {\n  text-lg leading-relaxed text-muted-foreground\n}\n\n/* Muted secondary text. */\n@recipe muted {\n  text-sm text-muted-foreground\n}\n\n/* Form label text. */\n@recipe label {\n  text-sm font-medium text-foreground\n}\n\n/* Caption — small supporting text. */\n@recipe caption {\n  text-xs text-muted-foreground\n}\n\n/* Inline link with hover/focus states. */\n@recipe link {\n  text-primary underline-offset-2 hover:underline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-ring\n}\n",
+	"tooltip.css": "/* shortwind: tooltip@0.0.1 sha:000000 */\n\n/* @guide\n   @tooltip is the floating label bubble — it styles appearance only, so pair it\n   with your own positioning.\n*/\n\n/* Floating tooltip bubble. */\n@recipe tooltip {\n  pointer-events-none z-50 rounded-md bg-foreground px-2 py-1 text-xs font-medium text-background shadow-md\n}\n"
+};
+//#endregion
+//#region src/bench-corpus/corpus.ts
+const CORPUS_FILES = {
+	"button.tsx": `export function ButtonShowcase() {
+  return (
+    <div className="@row gap-4 p-6">
+      <button className="@btn-primary">Primary Button</button>
+      <button className="@btn-primary-sm">Small Primary</button>
+      <button className="@btn-primary-lg">Large Primary</button>
+      <button className="@btn-secondary">Secondary Button</button>
+      <button className="@btn-outline">Outline Button</button>
+      <button className="@btn-ghost">Ghost Button</button>
+      <button className="@btn-danger">Danger Button</button>
+    </div>
+  );
+}`,
+	"card.tsx": `export function ProductCard() {
+  return (
+    <div className="@card-interactive max-w-sm">
+      <div className="@card-header">
+        <h3 className="@heading-md">Premium Product</h3>
+        <span className="@badge-success">In Stock</span>
+      </div>
+      <div className="@card-body">
+        <p className="@body">
+          This is a beautiful product description. It uses multiple utility classes and shortwind recipes to keep output clean and readable for agents.
+        </p>
+        <div className="@row-between mt-4">
+          <span className="text-2xl font-bold">$99.99</span>
+          <span className="@muted">Save 20%</span>
+        </div>
+      </div>
+      <div className="@card-footer">
+        <button className="@btn-secondary-sm">View Details</button>
+        <button className="@btn-primary-sm">Buy Now</button>
+      </div>
+    </div>
+  );
+}`,
+	"form.tsx": `export function LoginForm() {
+  return (
+    <div className="@card max-w-md mx-auto p-8">
+      <h2 className="@heading-lg mb-6 text-center">Welcome Back</h2>
+      <form className="@stack-md">
+        <div className="@field">
+          <label className="@label" htmlFor="email">Email Address</label>
+          <input className="@input" id="email" type="email" placeholder="you@example.com" required />
+          <span className="@help">We will never share your email.</span>
+        </div>
+        <div className="@field">
+          <label className="@label" htmlFor="password">Password</label>
+          <input className="@input" id="password" type="password" required />
+        </div>
+        <div className="@row gap-2">
+          <input className="@checkbox" id="remember" type="checkbox" />
+          <label className="@label" htmlFor="remember">Remember me</label>
+        </div>
+        <button className="@btn-primary w-full mt-4" type="submit">Sign In</button>
+      </form>
+    </div>
+  );
+}`,
+	"table.tsx": `export function UsersTable() {
+  return (
+    <div className="@table-container">
+      <table className="@table">
+        <thead>
+          <tr className="bg-muted/50">
+            <th className="@th">User</th>
+            <th className="@th">Status</th>
+            <th className="@th">Role</th>
+            <th className="@th">Actions</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr className="@tr-hover">
+            <td className="@td font-medium">Alice Johnson</td>
+            <td className="@td"><span className="@badge-success">Active</span></td>
+            <td className="@td">Administrator</td>
+            <td className="@td"><button className="@btn-ghost-sm">Edit</button></td>
+          </tr>
+          <tr className="@tr-hover">
+            <td className="@td font-medium">Bob Smith</td>
+            <td className="@td"><span className="@badge-warning">Pending</span></td>
+            <td className="@td">Editor</td>
+            <td className="@td"><button className="@btn-ghost-sm">Edit</button></td>
+          </tr>
+          <tr className="@tr-hover">
+            <td className="@td font-medium">Charlie Brown</td>
+            <td className="@td"><span className="@badge-danger">Suspended</span></td>
+            <td className="@td">Subscriber</td>
+            <td className="@td"><button className="@btn-ghost-sm">Edit</button></td>
+          </tr>
+        </tbody>
+      </table>
+    </div>
+  );
+}`,
+	"layout.tsx": `export function DashboardLayout({ children }) {
+  return (
+    <div className="@row min-h-screen items-stretch bg-background">
+      <aside className="@stack-md w-64 border-r border-border bg-card p-4">
+        <div className="flex h-12 items-center px-2 font-bold text-lg">
+          Shortwind Console
+        </div>
+        <nav className="@nav flex-col items-stretch">
+          <a className="@nav-link-active" href="/dashboard">Dashboard</a>
+          <a className="@nav-link" href="/analytics">Analytics</a>
+          <a className="@nav-link" href="/settings">Settings</a>
+        </nav>
+      </aside>
+      <div className="@stack-md flex-1">
+        <header className="@row-between h-16 border-b border-border bg-card px-6">
+          <h1 className="@heading-sm">Overview</h1>
+          <div className="@row gap-4">
+            <button className="@btn-icon"><span className="sr-only">Notifications</span></button>
+            <div className="h-8 w-8 rounded-full bg-primary/20" />
+          </div>
+        </header>
+        <main className="@container @stack-lg py-8">
+          <div className="@grid-3">
+            <div className="@card-elevated">Card 1</div>
+            <div className="@card-elevated">Card 2</div>
+            <div className="@card-elevated">Card 3</div>
+          </div>
+          <div className="flex-1">{children}</div>
+        </main>
+      </div>
+    </div>
+  );
+}`
+};
+//#endregion
+//#region src/commands/lint.ts
+const ALL_RULES = [
+	"recipe/unknown",
+	"recipe/cycle",
+	"recipe/duplicate",
+	"recipe/unused",
+	"recipe/no-redundant-utility",
+	"recipe/bad-suffix-order",
+	"recipe/conflicting-intent",
+	"recipe/dynamic-class",
+	"recipe/no-sibling-overlap"
+];
+const DEFAULT_CONTENT = ["src/**/*.{html,js,jsx,ts,tsx,vue,svelte,astro,md,mdx}"];
+async function lint(options) {
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const recipesDir = path.join(cwd, config.recipesDir);
+	const enabledRules = new Set(options.rules ?? ALL_RULES);
+	const findings = [];
+	const { registry, parseFindings } = loadRegistry(recipesDir, enabledRules);
+	findings.push(...parseFindings);
+	findings.push(...checkRecipeNames(registry, recipesDir, enabledRules));
+	const files = await glob(options.content ?? DEFAULT_CONTENT, {
+		cwd,
+		absolute: true,
+		onlyFiles: true,
+		ignore: [
+			"**/node_modules/**",
+			"**/dist/**",
+			"**/.next/**",
+			path.posix.join(path.relative(cwd, recipesDir).split(path.sep).join("/") || ".", "**")
+		]
+	});
+	const usedRecipes = /* @__PURE__ */ new Set();
+	const filesFixed = [];
+	for (const file of files) {
+		const source = await readFile(file, "utf8");
+		const usages = extractClassUsages(source);
+		for (const u of usages) {
+			for (const token of u.tokens) {
+				if (!token.value.startsWith("@")) continue;
+				const name = token.value.slice(1);
+				if (registry.flattened[name]) usedRecipes.add(name);
+				else if (enabledRules.has("recipe/unknown")) findings.push({
+					rule: "recipe/unknown",
+					severity: "error",
+					file,
+					line: token.line,
+					column: token.column,
+					message: `unknown recipe @${name}`
+				});
+			}
+			if (enabledRules.has("recipe/bad-suffix-order")) findings.push(...checkUsageSuffixOrder(file, u.tokens, registry));
+			if (enabledRules.has("recipe/conflicting-intent")) findings.push(...checkConflictingIntent(file, u.tokens, registry));
+			if (enabledRules.has("recipe/no-sibling-overlap")) findings.push(...checkSiblingOverlap(file, u.tokens, registry));
+			if (enabledRules.has("recipe/dynamic-class")) findings.push(...checkDynamicClass(file, u.dynamicTokens));
+		}
+		if (enabledRules.has("recipe/no-redundant-utility")) {
+			const result = checkRedundantUtility(file, source, registry, options.fix === true);
+			findings.push(...result.findings);
+			if (options.fix && result.fixed !== null && result.fixed !== source) {
+				await writeFile(file, result.fixed);
+				filesFixed.push(file);
+			}
+		}
+	}
+	if (enabledRules.has("recipe/unused")) {
+		const recipesByName = /* @__PURE__ */ new Map();
+		for (const recs of Object.values(registry.families)) for (const r of recs) recipesByName.set(r.name, r);
+		for (const name of Object.keys(registry.flattened)) {
+			if (usedRecipes.has(name)) continue;
+			const recipe = recipesByName.get(name);
+			if (!recipe) continue;
+			findings.push({
+				rule: "recipe/unused",
+				severity: "info",
+				file: path.join(recipesDir, recipe.sourceFile),
+				line: recipe.sourceLine,
+				column: 1,
+				message: `recipe @${name} is defined but never referenced`
+			});
+		}
+	}
+	findings.sort((a, b) => {
+		if (a.file !== b.file) return a.file.localeCompare(b.file);
+		if (a.line !== b.line) return a.line - b.line;
+		return a.column - b.column;
+	});
+	return {
+		ok: !findings.some((f) => f.severity === "error"),
+		findings,
+		filesFixed
+	};
+}
+function loadRegistry(recipesDir, rules) {
+	const families = installedFamilies(recipesDir);
+	const allRecipes = [];
+	const parseFindings = [];
+	for (const family of families) {
+		const filePath = path.join(recipesDir, `${family}.css`);
+		const parsed = parseRecipeFile(readFileSync(filePath, "utf8"), `${family}.css`);
+		if (!parsed.ok) {
+			for (const err of parsed.errors) parseFindings.push({
+				rule: "recipe/unknown",
+				severity: "error",
+				file: filePath,
+				line: err.line,
+				column: err.column ?? 1,
+				message: err.message
+			});
+			continue;
+		}
+		for (const r of parsed.value.recipes) allRecipes.push(r);
+	}
+	const built = buildRegistry(allRecipes);
+	if (!built.ok) {
+		for (const err of built.errors) {
+			const rule = mapErrorCodeToRule(err.code);
+			if (!rules.has(rule)) continue;
+			parseFindings.push({
+				rule,
+				severity: "error",
+				file: path.join(recipesDir, err.file),
+				line: err.line,
+				column: err.column ?? 1,
+				message: err.message
+			});
+		}
+		return {
+			registry: {
+				flattened: {},
+				families: {}
+			},
+			parseFindings
+		};
+	}
+	return {
+		registry: built.value,
+		parseFindings
+	};
+}
+const ERROR_CODE_RULE = {
+	"resolve/cycle": "recipe/cycle",
+	"resolve/duplicate-name": "recipe/duplicate",
+	"resolve/unknown-reference": "recipe/unknown"
+};
+function mapErrorCodeToRule(code) {
+	return ERROR_CODE_RULE[code] ?? "recipe/unknown";
+}
+const SIZE_SUFFIXES = new Set([
+	"xs",
+	"sm",
+	"md",
+	"lg",
+	"xl"
+]);
+const INTENT_SUFFIXES = new Set([
+	"primary",
+	"secondary",
+	"ghost",
+	"danger",
+	"warning",
+	"success",
+	"info"
+]);
+function recipeMeta(name, familyHint) {
+	const family = familyHint && (name === familyHint || name.startsWith(`${familyHint}-`)) ? familyHint : name.split("-")[0] ?? name;
+	const suffix = name === family ? [] : name.slice(family.length + 1).split("-").filter(Boolean);
+	let intent = null;
+	let firstSizeIdx = -1;
+	let laterIntentIdx = -1;
+	for (let i = 0; i < suffix.length; i++) {
+		const part = suffix[i] ?? "";
+		if (SIZE_SUFFIXES.has(part)) {
+			if (firstSizeIdx === -1) firstSizeIdx = i;
+		}
+		if (INTENT_SUFFIXES.has(part)) {
+			intent ??= part;
+			if (firstSizeIdx !== -1) laterIntentIdx = i;
+		}
+	}
+	let badOrder = null;
+	if (firstSizeIdx !== -1 && laterIntentIdx !== -1) badOrder = [
+		family,
+		...suffix.filter((p) => INTENT_SUFFIXES.has(p)),
+		...suffix.filter((p) => !INTENT_SUFFIXES.has(p) && !SIZE_SUFFIXES.has(p)),
+		...suffix.filter((p) => SIZE_SUFFIXES.has(p))
+	].join("-");
+	return {
+		family,
+		intent,
+		badOrder
+	};
+}
+function checkRecipeNames(registry, recipesDir, enabledRules) {
+	if (!enabledRules.has("recipe/bad-suffix-order")) return [];
+	const findings = [];
+	for (const [family, recipes] of Object.entries(registry.families)) for (const recipe of recipes) {
+		const meta = recipeMeta(recipe.name, family);
+		if (!meta.badOrder) continue;
+		findings.push({
+			rule: "recipe/bad-suffix-order",
+			severity: "warning",
+			file: path.join(recipesDir, recipe.sourceFile),
+			line: recipe.sourceLine,
+			column: 1,
+			message: `recipe @${recipe.name} uses size before intent; prefer @${meta.badOrder}`
+		});
+	}
+	return findings;
+}
+function checkUsageSuffixOrder(file, tokens, registry) {
+	const findings = [];
+	for (const token of tokens) {
+		if (!token.value.startsWith("@")) continue;
+		const name = token.value.slice(1);
+		if (!registry.flattened[name]) continue;
+		const meta = recipeMeta(name, familyForRecipe(registry, name));
+		if (!meta.badOrder) continue;
+		findings.push({
+			rule: "recipe/bad-suffix-order",
+			severity: "warning",
+			file,
+			line: token.line,
+			column: token.column,
+			message: `@${name} uses size before intent; prefer @${meta.badOrder}`
+		});
+	}
+	return findings;
+}
+function checkConflictingIntent(file, tokens, registry) {
+	const byFamily = /* @__PURE__ */ new Map();
+	for (const token of tokens) {
+		if (!token.value.startsWith("@")) continue;
+		const name = token.value.slice(1);
+		if (!registry.flattened[name]) continue;
+		const meta = recipeMeta(name, familyForRecipe(registry, name));
+		if (!meta.intent) continue;
+		const familyIntents = byFamily.get(meta.family) ?? /* @__PURE__ */ new Map();
+		familyIntents.set(meta.intent, {
+			token,
+			name
+		});
+		byFamily.set(meta.family, familyIntents);
+	}
+	const findings = [];
+	for (const [family, intents] of byFamily) {
+		if (intents.size < 2) continue;
+		const intentNames = Array.from(intents.values()).map((entry) => `@${entry.name}`).sort();
+		const first = Array.from(intents.values()).map((entry) => entry.token).sort((a, b) => a.column - b.column)[0];
+		findings.push({
+			rule: "recipe/conflicting-intent",
+			severity: "warning",
+			file,
+			line: first.line,
+			column: first.column,
+			message: `multiple ${family} intents on one element: ${intentNames.join(", ")}`
+		});
+	}
+	return findings;
+}
+function familyForRecipe(registry, name) {
+	for (const [family, recipes] of Object.entries(registry.families)) if (recipes.some((recipe) => recipe.name === name)) return family;
+}
+function checkSiblingOverlap(file, tokens, registry) {
+	const byFamily = /* @__PURE__ */ new Map();
+	for (const token of tokens) {
+		if (!token.value.startsWith("@")) continue;
+		const name = token.value.slice(1);
+		if (!registry.flattened[name]) continue;
+		const family = familyForRecipe(registry, name) ?? name.split("-")[0] ?? name;
+		const arr = byFamily.get(family) ?? [];
+		arr.push({
+			token,
+			name
+		});
+		byFamily.set(family, arr);
+	}
+	const findings = [];
+	for (const [family, entries] of byFamily) {
+		const unique = new Set(entries.map((e) => e.name));
+		if (unique.size < 2) continue;
+		const first = entries.map((e) => e.token).sort((a, b) => a.column - b.column)[0];
+		const names = Array.from(unique).map((n) => `@${n}`).sort();
+		findings.push({
+			rule: "recipe/no-sibling-overlap",
+			severity: "warning",
+			file,
+			line: first.line,
+			column: first.column,
+			message: `multiple ${family} recipes on one element: ${names.join(", ")}`
+		});
+	}
+	return findings;
+}
+function checkDynamicClass(file, dynamicTokens) {
+	const findings = [];
+	for (const token of dynamicTokens) {
+		if (!token.value.includes("@")) continue;
+		findings.push({
+			rule: "recipe/dynamic-class",
+			severity: "warning",
+			file,
+			line: token.line,
+			column: token.column,
+			message: `dynamic recipe name ${token.value} — Tailwind cannot statically resolve this`
+		});
+	}
+	return findings;
+}
+const CLASS_ATTR_STR_RE = /\b(?:class|className)\s*=\s*(["'])([^"']*)\1/g;
+const CLASS_ATTR_BRACE_RE = /\b(?:class|className)\s*=\s*\{/g;
+const STRING_LITERAL_RE = /(["'`])((?:\\.|(?!\1)[^\\])*)\1/g;
+function extractClassUsages(source) {
+	const usages = [];
+	for (const m of source.matchAll(CLASS_ATTR_STR_RE)) {
+		const value = m[2] ?? "";
+		const attrStart = m.index ?? 0;
+		const valueStart = attrStart + m[0].length - 1 - value.length;
+		const { tokens, dynamicTokens } = tokenizeClassString(source, value, valueStart);
+		usages.push({
+			fileOffset: attrStart,
+			valueStart,
+			raw: value,
+			tokens,
+			dynamicTokens,
+			fixable: true
+		});
+	}
+	for (const m of source.matchAll(CLASS_ATTR_BRACE_RE)) {
+		const openBrace = (m.index ?? 0) + m[0].length - 1;
+		const close = findMatchingBrace(source, openBrace);
+		if (close === -1) continue;
+		const inner = source.slice(openBrace + 1, close);
+		for (const sm of inner.matchAll(STRING_LITERAL_RE)) {
+			const value = sm[2] ?? "";
+			if (value.length === 0) continue;
+			const literalStart = openBrace + 1 + (sm.index ?? 0);
+			const valueStart = literalStart + 1;
+			const { tokens, dynamicTokens } = tokenizeClassString(source, value, valueStart);
+			if (tokens.length === 0 && dynamicTokens.length === 0) continue;
+			usages.push({
+				fileOffset: literalStart,
+				valueStart,
+				raw: value,
+				tokens,
+				dynamicTokens,
+				fixable: false
+			});
+		}
+	}
+	return usages;
+}
+function tokenizeClassString(source, value, valueStart) {
+	const tokens = [];
+	const dynamicTokens = [];
+	let offset = 0;
+	for (const piece of value.split(/(\s+)/)) {
+		if (/^\s+$/.test(piece) || piece.length === 0) {
+			offset += piece.length;
+			continue;
+		}
+		const { line, column } = offsetToLineCol(source, valueStart + offset);
+		if (piece.includes("${")) {
+			dynamicTokens.push({
+				value: piece,
+				line,
+				column
+			});
+			offset += piece.length;
+			continue;
+		}
+		tokens.push({
+			value: piece,
+			line,
+			column
+		});
+		offset += piece.length;
+	}
+	return {
+		tokens,
+		dynamicTokens
+	};
+}
+function findMatchingBrace(source, openIdx) {
+	let depth = 1;
+	let i = openIdx + 1;
+	while (i < source.length && depth > 0) {
+		const ch = source[i];
+		if (ch === "\"" || ch === "'") {
+			const quote = ch;
+			i++;
+			while (i < source.length) {
+				if (source[i] === "\\") {
+					i += 2;
+					continue;
+				}
+				if (source[i] === quote) {
+					i++;
+					break;
+				}
+				i++;
+			}
+			continue;
+		}
+		if (ch === "`") {
+			i++;
+			while (i < source.length) {
+				if (source[i] === "\\") {
+					i += 2;
+					continue;
+				}
+				if (source[i] === "`") {
+					i++;
+					break;
+				}
+				if (source[i] === "$" && source[i + 1] === "{") {
+					i += 2;
+					let exprDepth = 1;
+					while (i < source.length && exprDepth > 0) {
+						if (source[i] === "{") exprDepth++;
+						else if (source[i] === "}") exprDepth--;
+						i++;
+					}
+					continue;
+				}
+				i++;
+			}
+			continue;
+		}
+		if (ch === "{") depth++;
+		else if (ch === "}") depth--;
+		i++;
+	}
+	return depth === 0 ? i - 1 : -1;
+}
+function offsetToLineCol(source, offset) {
+	const limit = Math.min(offset, source.length);
+	let line = 1;
+	let lastNl = -1;
+	for (let i = 0; i < limit; i++) if (source[i] === "\n") {
+		line++;
+		lastNl = i;
+	}
+	return {
+		line,
+		column: offset - lastNl
+	};
+}
+function checkRedundantUtility(file, source, registry, applyFix) {
+	const findings = [];
+	let fixed = applyFix ? "" : null;
+	let cursor = 0;
+	const usages = extractClassUsages(source).sort((a, b) => a.fileOffset - b.fileOffset);
+	for (const usage of usages) {
+		const expansions = /* @__PURE__ */ new Set();
+		for (const tok of usage.tokens) {
+			if (!tok.value.startsWith("@")) continue;
+			const exp = registry.flattened[tok.value.slice(1)];
+			if (!exp) continue;
+			for (const t of exp) expansions.add(t);
+		}
+		if (expansions.size === 0) continue;
+		const kept = [];
+		for (const tok of usage.tokens) {
+			if (!tok.value.startsWith("@") && expansions.has(tok.value)) {
+				findings.push({
+					rule: "recipe/no-redundant-utility",
+					severity: "info",
+					file,
+					line: tok.line,
+					column: tok.column,
+					message: `${tok.value} is already included by a recipe on this element`
+				});
+				continue;
+			}
+			kept.push(tok.value);
+		}
+		if (fixed !== null && usage.fixable) {
+			if (usage.valueStart < cursor) continue;
+			fixed += source.slice(cursor, usage.valueStart);
+			fixed += kept.join(" ");
+			cursor = usage.valueStart + usage.raw.length;
+		}
+	}
+	if (fixed !== null) fixed += source.slice(cursor);
+	return {
+		findings,
+		fixed
+	};
+}
+function formatFindingsText(findings) {
+	if (findings.length === 0) return "";
+	return findings.map((f) => `${f.file}:${f.line}:${f.column} ${f.severity}  ${f.message}  [${f.rule}]`).join("\n");
+}
+//#endregion
+//#region src/commands/bench.ts
+const DEFAULT_CONTENT_GLOBS = ["src/**/*.{html,js,jsx,ts,tsx,vue,svelte,astro,md,mdx}"];
+async function bench(options) {
+	const cwd = path.resolve(options.cwd);
+	let registry;
+	const runOnCorpus = options.corpus || !hasShortwindConfig(cwd);
+	if (runOnCorpus) registry = loadDefaultRegistry();
+	else {
+		const config = await readConfig(cwd);
+		registry = loadRegistryFromDir(path.join(cwd, config.recipesDir));
+	}
+	const filesToBench = [];
+	if (runOnCorpus) for (const [filename, content] of Object.entries(CORPUS_FILES)) filesToBench.push({
+		filename,
+		content
+	});
+	else {
+		const config = await readConfig(cwd);
+		const recipesDir = path.join(cwd, config.recipesDir);
+		const recipesIgnore = path.posix.join(path.relative(cwd, recipesDir).split(path.sep).join("/") || ".", "**");
+		const matchedFiles = await glob(options.path ? [options.path] : DEFAULT_CONTENT_GLOBS, {
+			cwd,
+			absolute: true,
+			onlyFiles: true,
+			ignore: [
+				"**/node_modules/**",
+				"**/dist/**",
+				"**/.next/**",
+				recipesIgnore
+			]
+		});
+		for (const file of matchedFiles) {
+			const content = await readFile(file, "utf8");
+			const relative = path.relative(cwd, file);
+			filesToBench.push({
+				filename: relative,
+				content
+			});
+		}
+	}
+	const results = [];
+	const totals = {
+		compactClassTokens: 0,
+		expandedClassTokens: 0,
+		compactClassBytes: 0,
+		expandedClassBytes: 0,
+		compactFileBytes: 0,
+		expandedFileBytes: 0,
+		compactLlmTokens: 0,
+		expandedLlmTokens: 0
+	};
+	for (const { filename, content } of filesToBench) {
+		const expanded = transformContent(content, registry, { mode: filename.endsWith(".html") ? "html" : "jsx" });
+		const compactUsages = extractClassUsages(content);
+		const expandedUsages = extractClassUsages(expanded);
+		const fileResult = {
+			filename,
+			compactClassTokens: sumTokens(compactUsages),
+			expandedClassTokens: sumTokens(expandedUsages),
+			compactClassBytes: sumBytes(compactUsages),
+			expandedClassBytes: sumBytes(expandedUsages),
+			compactFileBytes: Buffer.byteLength(content, "utf8"),
+			expandedFileBytes: Buffer.byteLength(expanded, "utf8"),
+			compactLlmTokens: countLlmTokens(content),
+			expandedLlmTokens: countLlmTokens(expanded)
+		};
+		results.push(fileResult);
+		totals.compactClassTokens += fileResult.compactClassTokens;
+		totals.expandedClassTokens += fileResult.expandedClassTokens;
+		totals.compactClassBytes += fileResult.compactClassBytes;
+		totals.expandedClassBytes += fileResult.expandedClassBytes;
+		totals.compactFileBytes += fileResult.compactFileBytes;
+		totals.expandedFileBytes += fileResult.expandedFileBytes;
+		totals.compactLlmTokens += fileResult.compactLlmTokens;
+		totals.expandedLlmTokens += fileResult.expandedLlmTokens;
+	}
+	return {
+		files: results,
+		totals
+	};
+}
+function hasShortwindConfig(cwd) {
+	return existsSync(path.join(cwd, "shortwind.config.json"));
+}
+function loadDefaultRegistry() {
+	const allRecipes = [];
+	for (const [filename, source] of Object.entries(DEFAULT_RECIPES_CSS)) {
+		const parsed = parseRecipeFile(source, filename);
+		if (parsed.ok) allRecipes.push(...parsed.value.recipes);
+	}
+	const resolved = buildRegistry(allRecipes);
+	if (!resolved.ok) throw new Error(`Failed to build default registry: ${resolved.errors.map((e) => e.message).join("; ")}`);
+	return resolved.value;
+}
+function sumTokens(usages) {
+	let count = 0;
+	for (const u of usages) count += u.tokens.length;
+	return count;
+}
+function sumBytes(usages) {
+	let count = 0;
+	for (const u of usages) count += Buffer.byteLength(u.raw, "utf8");
+	return count;
+}
+let _encoder = null;
+function getEncoder() {
+	if (!_encoder) _encoder = new Tiktoken(cl100k_base);
+	return _encoder;
+}
+function countLlmTokens(str) {
+	return getEncoder().encode(str).length;
+}
+function formatBenchTable(result) {
+	const lines = [];
+	const colWidths = {
+		file: 20,
+		metric: 12,
+		shortwind: 12,
+		expanded: 12,
+		saved: 10
+	};
+	for (const f of result.files) colWidths.file = Math.max(colWidths.file, f.filename.length);
+	const padR = (str, width) => str.padEnd(width);
+	const padL = (str, width) => str.padStart(width);
+	const formatPct = (compact, exp) => {
+		if (exp === 0) return "0.0%";
+		return `${((1 - compact / exp) * 100).toFixed(1)}%`;
+	};
+	const row = (file, metric, compact, exp) => [
+		padR(file, colWidths.file),
+		padR(metric, colWidths.metric),
+		padL(compact.toString(), colWidths.shortwind),
+		padL(exp.toString(), colWidths.expanded),
+		padL(formatPct(compact, exp), colWidths.saved)
+	].join("  ");
+	const header = [
+		padR("File", colWidths.file),
+		padR("Metric", colWidths.metric),
+		padL("Shortwind", colWidths.shortwind),
+		padL("Expanded", colWidths.expanded),
+		padL("Saved", colWidths.saved)
+	].join("  ");
+	lines.push(header);
+	lines.push("-".repeat(header.length));
+	for (const f of result.files) {
+		lines.push(row(f.filename, "Class Words", f.compactClassTokens, f.expandedClassTokens));
+		lines.push(row("", "Class Bytes", f.compactClassBytes, f.expandedClassBytes));
+		lines.push(row("", "File Bytes", f.compactFileBytes, f.expandedFileBytes));
+		lines.push(row("", "File Tokens", f.compactLlmTokens, f.expandedLlmTokens));
+		lines.push("-".repeat(header.length));
+	}
+	lines.push(row("TOTAL", "Class Words", result.totals.compactClassTokens, result.totals.expandedClassTokens));
+	lines.push(row("", "Class Bytes", result.totals.compactClassBytes, result.totals.expandedClassBytes));
+	lines.push(row("", "File Bytes", result.totals.compactFileBytes, result.totals.expandedFileBytes));
+	lines.push(row("", "File Tokens", result.totals.compactLlmTokens, result.totals.expandedLlmTokens));
+	lines.push("-".repeat(header.length));
+	return lines.join("\n");
+}
+//#endregion
+export { rewriteHeaderSha as A, createRegistrySource as C, computeBodySha as D, buildHeaderLine as E, extractHeader as O, writeLockfile as S, detectProject as T, add as _, formatFindingsText as a, init as b, UpgradeError as c, BuildError as d, build as f, remove as g, preset as h, extractClassUsages as i, sealRecipeFile as j, normalizeBody as k, upgrade as l, ls as m, formatBenchTable as n, lint as o, formatLsText as p, ALL_RULES as r, verify as s, bench as t, dev as u, renameFamilyInSource as v, resolvePresetFamilies as w, readLockfile as x, DEFAULT_REGISTRY as y };
+
+//# sourceMappingURL=bench-a_9WmuOE.js.map