uilint 0.2.7 → 0.2.9

package/dist/chunk-2RNDQVEK.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+
+// src/commands/install/constants.ts
+var GENSTYLEGUIDE_COMMAND_MD = `# React Style Guide Generator
+
+Analyze the React UI codebase to produce a **prescriptive, semantic** style guide. Focus on consistency, intent, and relationships\u2014not specific values.
+
+## Philosophy
+
+1. **Identify the intended architecture** from the best patterns in use
+2. **Prescribe semantic rules** \u2014 about consistency and relationships, not pixels
+3. **Stay general** \u2014 "primary buttons should be visually consistent" not "buttons use px-4"
+4. **Focus on intent** \u2014 what should FEEL the same, not what values to use
+
+## Analysis Steps
+
+### 1. Detect the Stack
+- Framework: Next.js (App Router? Pages?), Vite, CRA
+- Component system: shadcn, MUI, Chakra, Radix, custom
+- Styling: Tailwind, CSS Modules, styled-components
+- Forms: react-hook-form, Formik, native
+- State: React context, Zustand, Redux, Jotai
+
+### 2. Identify Best Patterns
+Examine the **best-written** components. Look at:
+- \`components/ui/*\` \u2014 the design system
+- Recently modified files \u2014 current standards
+- Shared layouts \u2014 structural patterns
+
+### 3. Infer Visual Hierarchy & Intent
+Understand the design language:
+- What distinguishes primary vs secondary actions?
+- How is visual hierarchy established?
+- What creates consistency across similar elements?
+
+## Output Format
+
+Generate at \`<nextjs app root>/.uilint/styleguide.md\`:
+\`\`\`yaml
+# Stack
+framework: 
+styling: 
+components: 
+component_path: 
+forms: 
+
+# Component Usage (MUST use these)
+use:
+  buttons: 
+  inputs: 
+  modals: 
+  cards: 
+  feedback: 
+  icons: 
+  links: 
+
+# Semantic Rules (consistency & relationships)
+semantics:
+  hierarchy:
+    - <e.g., "primary actions must be visually distinct from secondary">
+    - <e.g., "destructive actions should be visually cautionary">
+    - <e.g., "page titles should be visually heavier than section titles">
+  consistency:
+    - <e.g., "all primary buttons should share the same visual weight">
+    - <e.g., "form inputs should have uniform height and padding">
+    - <e.g., "card padding should be consistent across the app">
+    - <e.g., "interactive elements should have consistent hover/focus states">
+  spacing:
+    - <e.g., "use the spacing scale \u2014 no arbitrary values">
+    - <e.g., "related elements should be closer than unrelated">
+    - <e.g., "section spacing should be larger than element spacing">
+  layout:
+    - <e.g., "use gap for sibling spacing, not margin">
+    - <e.g., "containers should have consistent max-width and padding">
+
+# Patterns (structural, not values)
+patterns:
+  forms: <e.g., "FormField + Controller + zod schema">
+  conditionals: <e.g., "cn() for class merging">
+  loading: <e.g., "Skeleton for content, Spinner for actions">
+  errors: <e.g., "ErrorBoundary at route, inline for forms">
+  responsive: <e.g., "mobile-first, standard breakpoints only">
+
+# Component Authoring
+authoring:
+  - <e.g., "forwardRef for interactive components">
+  - <e.g., "variants via CVA or component props, not className overrides">
+  - <e.g., "extract when used 2+ times">
+  - <e.g., "'use client' only when needed">
+
+# Forbidden
+forbidden:
+  - <e.g., "inline style={{}}">
+  - <e.g., "raw HTML elements when component exists">
+  - <e.g., "arbitrary values \u2014 use scale">
+  - <e.g., "className overrides that break visual consistency">
+  - <e.g., "one-off spacing that doesn't match siblings">
+
+# Legacy (if migration in progress)
+legacy:
+  - <e.g., "old: CSS modules \u2192 new: Tailwind">
+  - <e.g., "old: Formik \u2192 new: react-hook-form">
+
+# Conventions
+conventions:
+  - 
+  - 
+  - 
+\`\`\`
+
+## Rules
+
+- **Semantic over specific**: "consistent padding" not "p-4"
+- **Relationships over absolutes**: "heavier than" not "font-bold"
+- **Intent over implementation**: "visually distinct" not "blue background"
+- **Prescriptive**: Define target state, not current state
+- **Terse**: No prose. Fragments and short phrases only.
+- **Actionable**: Every rule should be human-verifiable
+- **Omit if N/A**: Skip sections that don't apply
+- **Max 5 items** per section \u2014 highest impact only
+`;
+
+// src/utils/skill-loader.ts
+import { readFileSync, readdirSync, statSync, existsSync } from "fs";
+import { join, dirname, relative } from "path";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+function getSkillsDir() {
+  const devPath = join(__dirname, "..", "..", "skills");
+  const prodPath = join(__dirname, "..", "skills");
+  if (existsSync(devPath)) {
+    return devPath;
+  }
+  if (existsSync(prodPath)) {
+    return prodPath;
+  }
+  throw new Error(
+    "Could not find skills directory. This is a bug in uilint installation."
+  );
+}
+function collectFiles(dir, baseDir) {
+  const files = [];
+  const entries = readdirSync(dir);
+  for (const entry of entries) {
+    const fullPath = join(dir, entry);
+    const stat = statSync(fullPath);
+    if (stat.isDirectory()) {
+      files.push(...collectFiles(fullPath, baseDir));
+    } else if (stat.isFile()) {
+      const relativePath = relative(baseDir, fullPath);
+      const content = readFileSync(fullPath, "utf-8");
+      files.push({ relativePath, content });
+    }
+  }
+  return files;
+}
+function loadSkill(name) {
+  const skillsDir = getSkillsDir();
+  const skillDir = join(skillsDir, name);
+  if (!existsSync(skillDir)) {
+    throw new Error(`Skill "${name}" not found in ${skillsDir}`);
+  }
+  const skillMdPath = join(skillDir, "SKILL.md");
+  if (!existsSync(skillMdPath)) {
+    throw new Error(`Skill "${name}" is missing SKILL.md`);
+  }
+  const files = collectFiles(skillDir, skillDir);
+  return { name, files };
+}
+
+export {
+  GENSTYLEGUIDE_COMMAND_MD,
+  loadSkill
+};
+//# sourceMappingURL=chunk-2RNDQVEK.js.map

package/dist/chunk-2RNDQVEK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/install/constants.ts","../src/utils/skill-loader.ts"],"sourcesContent":["/**\n * Constants for the install command\n *\n * Contains file content templates for commands.\n */\n\n// ============================================================================\n// Cursor Commands\n// ============================================================================\n\nexport const GENSTYLEGUIDE_COMMAND_MD = `# React Style Guide Generator\n\nAnalyze the React UI codebase to produce a **prescriptive, semantic** style guide. Focus on consistency, intent, and relationships—not specific values.\n\n## Philosophy\n\n1. **Identify the intended architecture** from the best patterns in use\n2. **Prescribe semantic rules** — about consistency and relationships, not pixels\n3. **Stay general** — \"primary buttons should be visually consistent\" not \"buttons use px-4\"\n4. **Focus on intent** — what should FEEL the same, not what values to use\n\n## Analysis Steps\n\n### 1. Detect the Stack\n- Framework: Next.js (App Router? Pages?), Vite, CRA\n- Component system: shadcn, MUI, Chakra, Radix, custom\n- Styling: Tailwind, CSS Modules, styled-components\n- Forms: react-hook-form, Formik, native\n- State: React context, Zustand, Redux, Jotai\n\n### 2. Identify Best Patterns\nExamine the **best-written** components. Look at:\n- \\`components/ui/*\\` — the design system\n- Recently modified files — current standards\n- Shared layouts — structural patterns\n\n### 3. Infer Visual Hierarchy & Intent\nUnderstand the design language:\n- What distinguishes primary vs secondary actions?\n- How is visual hierarchy established?\n- What creates consistency across similar elements?\n\n## Output Format\n\nGenerate at \\`<nextjs app root>/.uilint/styleguide.md\\`:\n\\`\\`\\`yaml\n# Stack\nframework: \nstyling: \ncomponents: \ncomponent_path: \nforms: \n\n# Component Usage (MUST use these)\nuse:\n  buttons: \n  inputs: \n  modals: \n  cards: \n  feedback: \n  icons: \n  links: \n\n# Semantic Rules (consistency & relationships)\nsemantics:\n  hierarchy:\n    - <e.g., \"primary actions must be visually distinct from secondary\">\n    - <e.g., \"destructive actions should be visually cautionary\">\n    - <e.g., \"page titles should be visually heavier than section titles\">\n  consistency:\n    - <e.g., \"all primary buttons should share the same visual weight\">\n    - <e.g., \"form inputs should have uniform height and padding\">\n    - <e.g., \"card padding should be consistent across the app\">\n    - <e.g., \"interactive elements should have consistent hover/focus states\">\n  spacing:\n    - <e.g., \"use the spacing scale — no arbitrary values\">\n    - <e.g., \"related elements should be closer than unrelated\">\n    - <e.g., \"section spacing should be larger than element spacing\">\n  layout:\n    - <e.g., \"use gap for sibling spacing, not margin\">\n    - <e.g., \"containers should have consistent max-width and padding\">\n\n# Patterns (structural, not values)\npatterns:\n  forms: <e.g., \"FormField + Controller + zod schema\">\n  conditionals: <e.g., \"cn() for class merging\">\n  loading: <e.g., \"Skeleton for content, Spinner for actions\">\n  errors: <e.g., \"ErrorBoundary at route, inline for forms\">\n  responsive: <e.g., \"mobile-first, standard breakpoints only\">\n\n# Component Authoring\nauthoring:\n  - <e.g., \"forwardRef for interactive components\">\n  - <e.g., \"variants via CVA or component props, not className overrides\">\n  - <e.g., \"extract when used 2+ times\">\n  - <e.g., \"'use client' only when needed\">\n\n# Forbidden\nforbidden:\n  - <e.g., \"inline style={{}}\">\n  - <e.g., \"raw HTML elements when component exists\">\n  - <e.g., \"arbitrary values — use scale\">\n  - <e.g., \"className overrides that break visual consistency\">\n  - <e.g., \"one-off spacing that doesn't match siblings\">\n\n# Legacy (if migration in progress)\nlegacy:\n  - <e.g., \"old: CSS modules → new: Tailwind\">\n  - <e.g., \"old: Formik → new: react-hook-form\">\n\n# Conventions\nconventions:\n  - \n  - \n  - \n\\`\\`\\`\n\n## Rules\n\n- **Semantic over specific**: \"consistent padding\" not \"p-4\"\n- **Relationships over absolutes**: \"heavier than\" not \"font-bold\"\n- **Intent over implementation**: \"visually distinct\" not \"blue background\"\n- **Prescriptive**: Define target state, not current state\n- **Terse**: No prose. Fragments and short phrases only.\n- **Actionable**: Every rule should be human-verifiable\n- **Omit if N/A**: Skip sections that don't apply\n- **Max 5 items** per section — highest impact only\n`;\n\n","/**\n * Skill Loader Utility\n *\n * Loads Agent Skill files from the bundled skills directory for installation\n * into user projects. Skills follow the Agent Skills specification\n * (agentskills.io).\n */\n\nimport { readFileSync, readdirSync, statSync, existsSync } from \"fs\";\nimport { join, dirname, relative } from \"path\";\nimport { fileURLToPath } from \"url\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/**\n * Represents a file in a skill directory\n */\nexport interface SkillFile {\n  /** Relative path within the skill directory */\n  relativePath: string;\n  /** File content */\n  content: string;\n}\n\n/**\n * Represents a complete skill ready for installation\n */\nexport interface Skill {\n  /** Skill name (directory name) */\n  name: string;\n  /** All files in the skill */\n  files: SkillFile[];\n}\n\n/**\n * Get the path to the bundled skills directory\n */\nfunction getSkillsDir(): string {\n  // In development: packages/uilint/skills/\n  // In production (installed): node_modules/uilint/dist/ -> ../skills/\n  const devPath = join(__dirname, \"..\", \"..\", \"skills\");\n  const prodPath = join(__dirname, \"..\", \"skills\");\n\n  if (existsSync(devPath)) {\n    return devPath;\n  }\n  if (existsSync(prodPath)) {\n    return prodPath;\n  }\n\n  throw new Error(\n    \"Could not find skills directory. This is a bug in uilint installation.\"\n  );\n}\n\n/**\n * Recursively collect all files in a directory\n */\nfunction collectFiles(dir: string, baseDir: string): SkillFile[] {\n  const files: SkillFile[] = [];\n  const entries = readdirSync(dir);\n\n  for (const entry of entries) {\n    const fullPath = join(dir, entry);\n    const stat = statSync(fullPath);\n\n    if (stat.isDirectory()) {\n      files.push(...collectFiles(fullPath, baseDir));\n    } else if (stat.isFile()) {\n      const relativePath = relative(baseDir, fullPath);\n      const content = readFileSync(fullPath, \"utf-8\");\n      files.push({ relativePath, content });\n    }\n  }\n\n  return files;\n}\n\n/**\n * Load a specific skill by name\n */\nexport function loadSkill(name: string): Skill {\n  const skillsDir = getSkillsDir();\n  const skillDir = join(skillsDir, name);\n\n  if (!existsSync(skillDir)) {\n    throw new Error(`Skill \"${name}\" not found in ${skillsDir}`);\n  }\n\n  const skillMdPath = join(skillDir, \"SKILL.md\");\n  if (!existsSync(skillMdPath)) {\n    throw new Error(`Skill \"${name}\" is missing SKILL.md`);\n  }\n\n  const files = collectFiles(skillDir, skillDir);\n\n  return { name, files };\n}\n\n/**\n * Load all available skills\n */\nexport function loadAllSkills(): Skill[] {\n  const skillsDir = getSkillsDir();\n  const entries = readdirSync(skillsDir);\n  const skills: Skill[] = [];\n\n  for (const entry of entries) {\n    const skillDir = join(skillsDir, entry);\n    const stat = statSync(skillDir);\n\n    if (stat.isDirectory()) {\n      const skillMdPath = join(skillDir, \"SKILL.md\");\n      if (existsSync(skillMdPath)) {\n        skills.push(loadSkill(entry));\n      }\n    }\n  }\n\n  return skills;\n}\n\n/**\n * Get the list of available skill names\n */\nexport function getAvailableSkillNames(): string[] {\n  const skillsDir = getSkillsDir();\n  const entries = readdirSync(skillsDir);\n  const names: string[] = [];\n\n  for (const entry of entries) {\n    const skillDir = join(skillsDir, entry);\n    const stat = statSync(skillDir);\n\n    if (stat.isDirectory()) {\n      const skillMdPath = join(skillDir, \"SKILL.md\");\n      if (existsSync(skillMdPath)) {\n        names.push(entry);\n      }\n    }\n  }\n\n  return names;\n}\n"],"mappings":";;;AAUO,IAAM,2BAA2B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACFxC,SAAS,cAAc,aAAa,UAAU,kBAAkB;AAChE,SAAS,MAAM,SAAS,gBAAgB;AACxC,SAAS,qBAAqB;AAE9B,IAAM,aAAa,cAAc,YAAY,GAAG;AAChD,IAAM,YAAY,QAAQ,UAAU;AAyBpC,SAAS,eAAuB;AAG9B,QAAM,UAAU,KAAK,WAAW,MAAM,MAAM,QAAQ;AACpD,QAAM,WAAW,KAAK,WAAW,MAAM,QAAQ;AAE/C,MAAI,WAAW,OAAO,GAAG;AACvB,WAAO;AAAA,EACT;AACA,MAAI,WAAW,QAAQ,GAAG;AACxB,WAAO;AAAA,EACT;AAEA,QAAM,IAAI;AAAA,IACR;AAAA,EACF;AACF;AAKA,SAAS,aAAa,KAAa,SAA8B;AAC/D,QAAM,QAAqB,CAAC;AAC5B,QAAM,UAAU,YAAY,GAAG;AAE/B,aAAW,SAAS,SAAS;AAC3B,UAAM,WAAW,KAAK,KAAK,KAAK;AAChC,UAAM,OAAO,SAAS,QAAQ;AAE9B,QAAI,KAAK,YAAY,GAAG;AACtB,YAAM,KAAK,GAAG,aAAa,UAAU,OAAO,CAAC;AAAA,IAC/C,WAAW,KAAK,OAAO,GAAG;AACxB,YAAM,eAAe,SAAS,SAAS,QAAQ;AAC/C,YAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,YAAM,KAAK,EAAE,cAAc,QAAQ,CAAC;AAAA,IACtC;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,UAAU,MAAqB;AAC7C,QAAM,YAAY,aAAa;AAC/B,QAAM,WAAW,KAAK,WAAW,IAAI;AAErC,MAAI,CAAC,WAAW,QAAQ,GAAG;AACzB,UAAM,IAAI,MAAM,UAAU,IAAI,kBAAkB,SAAS,EAAE;AAAA,EAC7D;AAEA,QAAM,cAAc,KAAK,UAAU,UAAU;AAC7C,MAAI,CAAC,WAAW,WAAW,GAAG;AAC5B,UAAM,IAAI,MAAM,UAAU,IAAI,uBAAuB;AAAA,EACvD;AAEA,QAAM,QAAQ,aAAa,UAAU,QAAQ;AAE7C,SAAO,EAAE,MAAM,MAAM;AACvB;","names":[]}

package/dist/chunk-RHTG6DUD.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+// src/utils/next-detect.ts
+import { existsSync, readdirSync } from "fs";
+import { join } from "path";
+function fileExists(projectPath, relPath) {
+  return existsSync(join(projectPath, relPath));
+}
+function detectNextAppRouter(projectPath) {
+  const roots = ["app", join("src", "app")];
+  const candidates = [];
+  let chosenRoot = null;
+  for (const root of roots) {
+    if (existsSync(join(projectPath, root))) {
+      chosenRoot = root;
+      break;
+    }
+  }
+  if (!chosenRoot) return null;
+  const entryCandidates = [
+    join(chosenRoot, "layout.tsx"),
+    join(chosenRoot, "layout.jsx"),
+    join(chosenRoot, "layout.ts"),
+    join(chosenRoot, "layout.js"),
+    // Fallbacks (less ideal, but can work):
+    join(chosenRoot, "page.tsx"),
+    join(chosenRoot, "page.jsx")
+  ];
+  for (const rel of entryCandidates) {
+    if (fileExists(projectPath, rel)) candidates.push(rel);
+  }
+  return {
+    appRoot: chosenRoot,
+    appRootAbs: join(projectPath, chosenRoot),
+    candidates
+  };
+}
+var DEFAULT_IGNORE_DIRS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  ".next",
+  "dist",
+  "build",
+  "out",
+  ".turbo",
+  ".vercel",
+  ".cursor",
+  "coverage",
+  ".uilint"
+]);
+function findNextAppRouterProjects(rootDir, options) {
+  const maxDepth = options?.maxDepth ?? 4;
+  const ignoreDirs = options?.ignoreDirs ?? DEFAULT_IGNORE_DIRS;
+  const results = [];
+  const visited = /* @__PURE__ */ new Set();
+  function walk(dir, depth) {
+    if (depth > maxDepth) return;
+    if (visited.has(dir)) return;
+    visited.add(dir);
+    const detection = detectNextAppRouter(dir);
+    if (detection) {
+      results.push({ projectPath: dir, detection });
+      return;
+    }
+    let entries = [];
+    try {
+      entries = readdirSync(dir, { withFileTypes: true }).map((d) => ({
+        name: d.name,
+        isDirectory: d.isDirectory()
+      }));
+    } catch {
+      return;
+    }
+    for (const ent of entries) {
+      if (!ent.isDirectory) continue;
+      if (ignoreDirs.has(ent.name)) continue;
+      if (ent.name.startsWith(".") && ent.name !== ".") continue;
+      walk(join(dir, ent.name), depth + 1);
+    }
+  }
+  walk(rootDir, 0);
+  return results;
+}
+
+export {
+  detectNextAppRouter,
+  findNextAppRouterProjects
+};
+//# sourceMappingURL=chunk-RHTG6DUD.js.map

package/dist/chunk-RHTG6DUD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/next-detect.ts"],"sourcesContent":["import { existsSync, readdirSync } from \"fs\";\nimport { join } from \"path\";\n\nexport interface NextAppRouterDetection {\n  /**\n   * Relative path to the Next App Router root dir (either \"app\" or \"src/app\").\n   */\n  appRoot: string;\n  /**\n   * Absolute path to the App Router root dir.\n   */\n  appRootAbs: string;\n  /**\n   * Candidate entry files (relative paths) that are good injection targets.\n   */\n  candidates: string[];\n}\n\nfunction fileExists(projectPath: string, relPath: string): boolean {\n  return existsSync(join(projectPath, relPath));\n}\n\nexport function detectNextAppRouter(\n  projectPath: string\n): NextAppRouterDetection | null {\n  const roots = [\"app\", join(\"src\", \"app\")];\n  const candidates: string[] = [];\n\n  let chosenRoot: string | null = null;\n  for (const root of roots) {\n    if (existsSync(join(projectPath, root))) {\n      chosenRoot = root;\n      break;\n    }\n  }\n\n  if (!chosenRoot) return null;\n\n  // Prioritize layout files (Next App Router canonical integration point).\n  const entryCandidates = [\n    join(chosenRoot, \"layout.tsx\"),\n    join(chosenRoot, \"layout.jsx\"),\n    join(chosenRoot, \"layout.ts\"),\n    join(chosenRoot, \"layout.js\"),\n    // Fallbacks (less ideal, but can work):\n    join(chosenRoot, \"page.tsx\"),\n    join(chosenRoot, \"page.jsx\"),\n  ];\n\n  for (const rel of entryCandidates) {\n    if (fileExists(projectPath, rel)) candidates.push(rel);\n  }\n\n  // If nothing exists, still return detection so routes can be installed.\n  return {\n    appRoot: chosenRoot,\n    appRootAbs: join(projectPath, chosenRoot),\n    candidates,\n  };\n}\n\nexport interface NextAppRouterProjectMatch {\n  /**\n   * Absolute path to the Next project root (dir containing app/ or src/app/).\n   */\n  projectPath: string;\n  detection: NextAppRouterDetection;\n}\n\nconst DEFAULT_IGNORE_DIRS = new Set([\n  \"node_modules\",\n  \".git\",\n  \".next\",\n  \"dist\",\n  \"build\",\n  \"out\",\n  \".turbo\",\n  \".vercel\",\n  \".cursor\",\n  \"coverage\",\n  \".uilint\",\n]);\n\n/**\n * Best-effort monorepo discovery for Next.js App Router apps.\n *\n * Walks down from `rootDir` looking for directories that contain `app/` or\n * `src/app/`. Skips common large/irrelevant dirs.\n */\nexport function findNextAppRouterProjects(\n  rootDir: string,\n  options?: { maxDepth?: number; ignoreDirs?: Set<string> }\n): NextAppRouterProjectMatch[] {\n  const maxDepth = options?.maxDepth ?? 4;\n  const ignoreDirs = options?.ignoreDirs ?? DEFAULT_IGNORE_DIRS;\n  const results: NextAppRouterProjectMatch[] = [];\n  const visited = new Set<string>();\n\n  function walk(dir: string, depth: number) {\n    if (depth > maxDepth) return;\n    if (visited.has(dir)) return;\n    visited.add(dir);\n\n    const detection = detectNextAppRouter(dir);\n    if (detection) {\n      results.push({ projectPath: dir, detection });\n      // Don't descend further once we found a project root (avoid nested hits).\n      return;\n    }\n\n    let entries: Array<{ name: string; isDirectory: boolean }> = [];\n    try {\n      entries = readdirSync(dir, { withFileTypes: true }).map((d) => ({\n        name: d.name,\n        isDirectory: d.isDirectory(),\n      }));\n    } catch {\n      return;\n    }\n\n    for (const ent of entries) {\n      if (!ent.isDirectory) continue;\n      if (ignoreDirs.has(ent.name)) continue;\n      // Skip hidden dirs by default (except `src` which matters)\n      if (ent.name.startsWith(\".\") && ent.name !== \".\") continue;\n      walk(join(dir, ent.name), depth + 1);\n    }\n  }\n\n  walk(rootDir, 0);\n  return results;\n}\n"],"mappings":";;;AAAA,SAAS,YAAY,mBAAmB;AACxC,SAAS,YAAY;AAiBrB,SAAS,WAAW,aAAqB,SAA0B;AACjE,SAAO,WAAW,KAAK,aAAa,OAAO,CAAC;AAC9C;AAEO,SAAS,oBACd,aAC+B;AAC/B,QAAM,QAAQ,CAAC,OAAO,KAAK,OAAO,KAAK,CAAC;AACxC,QAAM,aAAuB,CAAC;AAE9B,MAAI,aAA4B;AAChC,aAAW,QAAQ,OAAO;AACxB,QAAI,WAAW,KAAK,aAAa,IAAI,CAAC,GAAG;AACvC,mBAAa;AACb;AAAA,IACF;AAAA,EACF;AAEA,MAAI,CAAC,WAAY,QAAO;AAGxB,QAAM,kBAAkB;AAAA,IACtB,KAAK,YAAY,YAAY;AAAA,IAC7B,KAAK,YAAY,YAAY;AAAA,IAC7B,KAAK,YAAY,WAAW;AAAA,IAC5B,KAAK,YAAY,WAAW;AAAA;AAAA,IAE5B,KAAK,YAAY,UAAU;AAAA,IAC3B,KAAK,YAAY,UAAU;AAAA,EAC7B;AAEA,aAAW,OAAO,iBAAiB;AACjC,QAAI,WAAW,aAAa,GAAG,EAAG,YAAW,KAAK,GAAG;AAAA,EACvD;AAGA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,YAAY,KAAK,aAAa,UAAU;AAAA,IACxC;AAAA,EACF;AACF;AAUA,IAAM,sBAAsB,oBAAI,IAAI;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAQM,SAAS,0BACd,SACA,SAC6B;AAC7B,QAAM,WAAW,SAAS,YAAY;AACtC,QAAM,aAAa,SAAS,cAAc;AAC1C,QAAM,UAAuC,CAAC;AAC9C,QAAM,UAAU,oBAAI,IAAY;AAEhC,WAAS,KAAK,KAAa,OAAe;AACxC,QAAI,QAAQ,SAAU;AACtB,QAAI,QAAQ,IAAI,GAAG,EAAG;AACtB,YAAQ,IAAI,GAAG;AAEf,UAAM,YAAY,oBAAoB,GAAG;AACzC,QAAI,WAAW;AACb,cAAQ,KAAK,EAAE,aAAa,KAAK,UAAU,CAAC;AAE5C;AAAA,IACF;AAEA,QAAI,UAAyD,CAAC;AAC9D,QAAI;AACF,gBAAU,YAAY,KAAK,EAAE,eAAe,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO;AAAA,QAC9D,MAAM,EAAE;AAAA,QACR,aAAa,EAAE,YAAY;AAAA,MAC7B,EAAE;AAAA,IACJ,QAAQ;AACN;AAAA,IACF;AAEA,eAAW,OAAO,SAAS;AACzB,UAAI,CAAC,IAAI,YAAa;AACtB,UAAI,WAAW,IAAI,IAAI,IAAI,EAAG;AAE9B,UAAI,IAAI,KAAK,WAAW,GAAG,KAAK,IAAI,SAAS,IAAK;AAClD,WAAK,KAAK,KAAK,IAAI,IAAI,GAAG,QAAQ,CAAC;AAAA,IACrC;AAAA,EACF;AAEA,OAAK,SAAS,CAAC;AACf,SAAO;AACT;","names":[]}