@shortwind/cli 0.1.0-beta.0 → 0.1.0-beta.1

package/README.md

@@ -0,0 +1,32 @@
+# @shortwind/cli
+
+The Shortwind command-line tool. Provides the `shortwind` command: `init`, `add`, `remove`, `upgrade`, `dev`, `build`, `lint`, `ls`, `preset`, `bench`.
+
+[Shortwind](https://shortwind.dev) is a token-efficient class layer for Tailwind: you write short `@recipe` names in `class=`/`className=` and they expand to full Tailwind class clusters at build time.
+
+## Install
+
+```bash
+npx @shortwind/cli@beta init      # beta: published on the `beta` tag
+```
+
+`init` is the one command you need — it detects your bundler, installs the right adapter, copies the recipe catalog into `./recipes/`, scaffolds a default theme, wires the plugin into your config, and generates `skills/shortwind/SKILL.md`.
+
+Install it to get the `shortwind` command in scripts:
+
+```bash
+npm i -D @shortwind/cli@beta
+```
+
+## Common commands
+
+```bash
+shortwind init --preset app     # starter | app | content | all | none
+shortwind add table dialog      # add families on demand
+shortwind dev                   # watch recipes/, regenerate SKILL.md
+shortwind build                 # one-shot regenerate SKILL.md
+shortwind lint                  # validate recipe usage, naming, conflicts
+shortwind bench                 # measure token savings
+```
+
+Docs: <https://shortwind.dev>

package/dist/{bench-a_9WmuOE.js → bench-NKKDz3ld.js}

@@ -2,11 +2,11 @@ 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 { buildRegistry, isReservedRecipeName, parseRecipeFile, renderSkillMarkdown } from "@shortwind/core";
 import { createHash } from "node:crypto";
 import { fileURLToPath } from "node:url";
-import chokidar from "chokidar";
 import { glob } from "tinyglobby";
+import chokidar from "chokidar";
 import { Tiktoken } from "js-tiktoken/lite";
 import cl100k_base from "js-tiktoken/ranks/cl100k_base";
 import { loadRegistryFromDir, transformContent } from "@shortwind/tailwind";
@@ -207,6 +207,221 @@ async function writeLockfile(recipesDir, lock) {
 	};
 	await writeFile(lockPath(recipesDir), JSON.stringify(sorted, null, 2) + "\n");
 }
+const THEME_BLOCK = `/* shortwind:theme — default tokens for the recipe catalog. Edit freely. */
+@custom-variant dark (&:is(.dark *));
+
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --destructive-foreground: oklch(0.985 0 0);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --destructive-foreground: oklch(0.985 0 0);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+}
+
+@layer base {
+  body {
+    @apply bg-background text-foreground;
+  }
+}
+/* end shortwind theme */
+`;
+const TAILWIND_IMPORT_RE = /@import\s+["']tailwindcss["'][^;\n]*;?/;
+async function scaffoldTheme(cwd) {
+	const cssFiles = await glob(["**/*.css"], {
+		cwd,
+		absolute: true,
+		onlyFiles: true,
+		ignore: [
+			"**/node_modules/**",
+			"**/dist/**",
+			"**/.next/**",
+			"**/.output/**",
+			"recipes/**"
+		]
+	});
+	for (const file of cssFiles) {
+		const source = await readFile(file, "utf8");
+		if (!TAILWIND_IMPORT_RE.test(source)) continue;
+		if (source.includes("/* shortwind:theme")) return {
+			themePath: file,
+			action: "skipped",
+			reason: "already scaffolded"
+		};
+		if (/--background\s*:/.test(source) || /@theme\b/.test(source)) return {
+			themePath: file,
+			action: "skipped",
+			reason: "project already defines a theme"
+		};
+		const m = source.match(TAILWIND_IMPORT_RE);
+		const at = (m.index ?? 0) + m[0].length;
+		await writeFile(file, source.slice(0, at) + "\n\n" + THEME_BLOCK + source.slice(at));
+		return {
+			themePath: file,
+			action: "injected"
+		};
+	}
+	if (!isTailwindV4(cwd)) return {
+		themePath: null,
+		action: "skipped",
+		reason: "no Tailwind v4 CSS entry found"
+	};
+	const target = path.join(cwd, "src", "index.css");
+	if (existsSync(target)) return {
+		themePath: target,
+		action: "skipped",
+		reason: "src/index.css exists without a tailwindcss import"
+	};
+	await mkdir(path.dirname(target), { recursive: true });
+	await writeFile(target, `@import "tailwindcss";\n\n${THEME_BLOCK}`);
+	return {
+		themePath: target,
+		action: "created"
+	};
+}
+function isTailwindV4(cwd) {
+	try {
+		const pkg = JSON.parse(readFileSync(path.join(cwd, "package.json"), "utf8"));
+		const m = (pkg.devDependencies?.["tailwindcss"] ?? pkg.dependencies?.["tailwindcss"] ?? "").match(/(\d+)/);
+		return m ? Number(m[1]) >= 4 : false;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+//#region src/bundler-config.ts
+const VITE_CONFIGS = [
+	"vite.config.ts",
+	"vite.config.mts",
+	"vite.config.cts",
+	"vite.config.js",
+	"vite.config.mjs",
+	"vite.config.cjs"
+];
+const VITE_SNIPPET = [
+	`import { shortwind } from "@shortwind/vite";`,
+	`// add shortwind() to the Vite plugins array — it runs in the pre phase,`,
+	`// before Tailwind's scan:`,
+	`//   plugins: [shortwind(), tailwindcss(), react()]`
+].join("\n");
+async function wireBundler(cwd, bundler) {
+	if (bundler === "vite") return wireVite(cwd);
+	if (bundler === "next") return {
+		configPath: null,
+		action: "manual",
+		snippet: `import { withShortwind } from "@shortwind/next";\n// wrap your Next config: export default withShortwind(nextConfig);`,
+		reason: "Next config wiring is manual"
+	};
+	if (bundler === "astro") return {
+		configPath: null,
+		action: "manual",
+		snippet: `import shortwind from "@shortwind/astro";\n// add to integrations: integrations: [shortwind()]`,
+		reason: "Astro config wiring is manual"
+	};
+	return {
+		configPath: null,
+		action: "skipped",
+		reason: "no supported bundler detected"
+	};
+}
+async function wireVite(cwd) {
+	const configPath = VITE_CONFIGS.map((f) => path.join(cwd, f)).find((p) => existsSync(p));
+	if (!configPath) return {
+		configPath: null,
+		action: "manual",
+		snippet: VITE_SNIPPET,
+		reason: "no vite config found"
+	};
+	const source = await readFile(configPath, "utf8");
+	if (/@shortwind\/vite/.test(source)) return {
+		configPath,
+		action: "skipped",
+		reason: "plugin already wired"
+	};
+	const pluginsMatch = source.match(/plugins\s*:\s*\[/);
+	if (!pluginsMatch) return {
+		configPath,
+		action: "manual",
+		snippet: VITE_SNIPPET,
+		reason: "no plugins array found"
+	};
+	const withImport = addImport(source, `import { shortwind } from "@shortwind/vite";`);
+	const at = withImport.indexOf(pluginsMatch[0]) + pluginsMatch[0].length;
+	await writeFile(configPath, withImport.slice(0, at) + "shortwind(), " + withImport.slice(at));
+	return {
+		configPath,
+		action: "patched"
+	};
+}
+function addImport(source, line) {
+	const importRe = /^[ \t]*import[\s\S]*?from\s+["'][^"']+["'];?[ \t]*$/gm;
+	let lastEnd = -1;
+	for (const m of source.matchAll(importRe)) lastEnd = (m.index ?? 0) + m[0].length;
+	if (lastEnd === -1) return `${line}\n${source}`;
+	return source.slice(0, lastEnd) + `\n${line}` + source.slice(lastEnd);
+}
 //#endregion
 //#region src/init.ts
 const DEFAULT_REGISTRY = "https://shortwind.dev/registry";
@@ -233,6 +448,8 @@ async function init(options) {
 	await installHuskyHook(huskyPath);
 	const skillPath = path.join(cwd, "skills", "shortwind", "SKILL.md");
 	await writeSkillMd(skillPath, recipesDir, families);
+	const theme = await scaffoldTheme(cwd);
+	const bundlerConfig = await wireBundler(cwd, shape.bundler);
 	return {
 		packageManager: shape.packageManager,
 		preset: options.preset,
@@ -244,7 +461,12 @@ async function init(options) {
 		configPath,
 		vscodePath,
 		huskyPath,
-		skillPath
+		skillPath,
+		themePath: theme.themePath,
+		themeAction: theme.action,
+		bundlerConfigPath: bundlerConfig.configPath,
+		bundlerConfigAction: bundlerConfig.action,
+		...bundlerConfig.snippet ? { bundlerConfigSnippet: bundlerConfig.snippet } : {}
 	};
 }
 async function resolveFamilies(preset, source) {
@@ -595,6 +817,43 @@ function collectBrokenDependents(recipesDir, removedRecipeNames) {
 	return out;
 }
 //#endregion
+//#region src/commands/new.ts
+var NewFamilyError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "NewFamilyError";
+	}
+};
+function template(family) {
+	return [
+		`/* shortwind: ${family}@0.0.1 sha:000000 */`,
+		``,
+		`/* @guide`,
+		`   TODO: one or two lines on when to reach for these recipes, and which`,
+		`   easy-to-confuse name to prefer. */`,
+		``,
+		`/* TODO: describe this recipe. */`,
+		`@recipe ${family} {`,
+		`  p-4`,
+		`}`,
+		``
+	].join("\n");
+}
+async function newFamily(options) {
+	assertValidFamilyName(options.family);
+	const cwd = path.resolve(options.cwd);
+	const config = await readConfig(cwd);
+	const recipesDir = path.join(cwd, config.recipesDir);
+	const familyPath = path.join(recipesDir, `${options.family}.css`);
+	if (existsSync(familyPath) && !options.force) throw new NewFamilyError(`${path.join(config.recipesDir, `${options.family}.css`)} already exists (use --force to overwrite)`);
+	await mkdir(recipesDir, { recursive: true });
+	await writeFile(familyPath, template(options.family));
+	return {
+		familyPath,
+		skillPath: await regenerateSkillMd(cwd, config)
+	};
+}
+//#endregion
 //#region src/commands/preset.ts
 async function preset(options) {
 	const cwd = path.resolve(options.cwd);
@@ -1038,7 +1297,7 @@ const DEFAULT_RECIPES_CSS = {
 	"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",
+	"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. @wrapper (or @wrapper-tight for prose)\n   centers and width-caps content; there is no @wrapper-lg, set a different cap\n   with max-w-* yourself. (Note: @container is reserved for Tailwind's\n   container-query utility, so the content wrapper is @wrapper.) @divider-h and\n   @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/* Centered content wrapper with a max width. */\n@recipe wrapper {\n  mx-auto w-full max-w-6xl px-4 sm:px-6 lg:px-8\n}\n\n/* Narrow content wrapper for prose. */\n@recipe wrapper-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"
@@ -1162,7 +1421,7 @@ const CORPUS_FILES = {
             <div className="h-8 w-8 rounded-full bg-primary/20" />
           </div>
         </header>
-        <main className="@container @stack-lg py-8">
+        <main className="@wrapper @stack-lg py-8">
           <div className="@grid-3">
             <div className="@card-elevated">Card 1</div>
             <div className="@card-elevated">Card 2</div>
@@ -1186,7 +1445,8 @@ const ALL_RULES = [
 	"recipe/bad-suffix-order",
 	"recipe/conflicting-intent",
 	"recipe/dynamic-class",
-	"recipe/no-sibling-overlap"
+	"recipe/no-sibling-overlap",
+	"recipe/reserved-name"
 ];
 const DEFAULT_CONTENT = ["src/**/*.{html,js,jsx,ts,tsx,vue,svelte,astro,md,mdx}"];
 async function lint(options) {
@@ -1198,6 +1458,7 @@ async function lint(options) {
 	const { registry, parseFindings } = loadRegistry(recipesDir, enabledRules);
 	findings.push(...parseFindings);
 	findings.push(...checkRecipeNames(registry, recipesDir, enabledRules));
+	findings.push(...checkReservedNames(registry, recipesDir, enabledRules));
 	const files = await glob(options.content ?? DEFAULT_CONTENT, {
 		cwd,
 		absolute: true,
@@ -1387,6 +1648,22 @@ function checkRecipeNames(registry, recipesDir, enabledRules) {
 	}
 	return findings;
 }
+function checkReservedNames(registry, recipesDir, enabledRules) {
+	if (!enabledRules.has("recipe/reserved-name")) return [];
+	const findings = [];
+	for (const recipes of Object.values(registry.families)) for (const recipe of recipes) {
+		if (!isReservedRecipeName(recipe.name)) continue;
+		findings.push({
+			rule: "recipe/reserved-name",
+			severity: "error",
+			file: path.join(recipesDir, recipe.sourceFile),
+			line: recipe.sourceLine,
+			column: 1,
+			message: `recipe @${recipe.name} collides with a reserved Tailwind @-utility; rename it`
+		});
+	}
+	return findings;
+}
 function checkUsageSuffixOrder(file, tokens, registry) {
 	const findings = [];
 	for (const token of tokens) {
@@ -1831,6 +2108,6 @@ function formatBenchTable(result) {
 	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 };
+export { extractHeader as A, readLockfile as C, detectProject as D, resolvePresetFamilies as E, rewriteHeaderSha as M, sealRecipeFile as N, buildHeaderLine as O, init as S, createRegistrySource as T, newFamily as _, formatFindingsText as a, renameFamilyInSource as b, UpgradeError as c, BuildError as d, build as f, NewFamilyError as g, preset as h, extractClassUsages as i, normalizeBody as j, computeBodySha 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, remove as v, writeLockfile as w, DEFAULT_REGISTRY as x, add as y };
 
-//# sourceMappingURL=bench-a_9WmuOE.js.map
+//# sourceMappingURL=bench-NKKDz3ld.js.map