@gemini-designer/mcp-server 0.1.2 → 0.1.29

package/src/stack/detect.ts

@@ -12,193 +12,244 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 
 export interface StackDetectionResult {
-    root: string;
-    framework: {
-        name: 'nextjs' | 'react' | 'vue' | 'svelte' | 'unknown';
-        version?: string;
-        router?: 'app' | 'pages' | 'unknown';
-    };
-    language: {
-        typescript: boolean;
-    };
-    styling: {
-        primary: 'tailwind' | 'css-modules' | 'emotion' | 'styled-components' | 'sass' | 'vanilla' | 'unknown';
-        detected: string[];
-    };
-    uiLibraries: string[];
-    iconLibraries: string[];
-    tooling: {
-        storybook: boolean;
-        eslint: boolean;
-        prettier: boolean;
-        vitest: boolean;
-        jest: boolean;
-    };
-    conventions: {
-        srcDir: boolean;
-        hasAppDir: boolean;
-        hasPagesDir: boolean;
-        tsconfigPaths?: Record<string, string[]>;
-    };
-    files: {
-        packageJson?: string;
-        tsconfig?: string;
-        tailwindConfig?: string;
-        componentsJson?: string;
-        storybookDir?: string;
-    };
-    warnings: string[];
+  root: string;
+  framework: {
+    name: 'nextjs' | 'react' | 'vue' | 'svelte' | 'unknown';
+    version?: string;
+    router?: 'app' | 'pages' | 'unknown';
+  };
+  language: {
+    typescript: boolean;
+  };
+  styling: {
+    primary:
+      | 'tailwind'
+      | 'css-modules'
+      | 'emotion'
+      | 'styled-components'
+      | 'sass'
+      | 'vanilla'
+      | 'unknown';
+    detected: string[];
+  };
+  uiLibraries: string[];
+  iconLibraries: string[];
+  tooling: {
+    storybook: boolean;
+    eslint: boolean;
+    prettier: boolean;
+    vitest: boolean;
+    jest: boolean;
+  };
+  conventions: {
+    srcDir: boolean;
+    hasAppDir: boolean;
+    hasPagesDir: boolean;
+    tsconfigPaths?: Record<string, string[]>;
+  };
+  files: {
+    packageJson?: string;
+    tsconfig?: string;
+    tailwindConfig?: string;
+    componentsJson?: string;
+    storybookDir?: string;
+  };
+  warnings: string[];
 }
 
-function readJsonIfExists(filePath: string): any | null {
-    if (!fs.existsSync(filePath)) return null;
-    try {
-        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
-    } catch {
-        return null;
-    }
+function readJsonIfExists(filePath: string): unknown | null {
+  if (!fs.existsSync(filePath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+  } catch {
+    return null;
+  }
 }
 
-function exists(root: string, ...parts: string[]): string | null {
-    const p = path.join(root, ...parts);
-    return fs.existsSync(p) ? p : null;
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
 }
 
-function depVersion(pkg: any, name: string): string | undefined {
-    const d = pkg?.dependencies?.[name] || pkg?.devDependencies?.[name] || pkg?.peerDependencies?.[name];
-    return typeof d === 'string' ? d : undefined;
+function exists(root: string, ...parts: string[]): string | null {
+  const p = path.join(root, ...parts);
+  return fs.existsSync(p) ? p : null;
 }
 
-export function detectUiStack(rootDir: string): StackDetectionResult {
-    const warnings: string[] = [];
-
-    const pkgPath = exists(rootDir, 'package.json');
-    const pkg = pkgPath ? readJsonIfExists(pkgPath) : null;
-    if (!pkg) warnings.push('package.json not found or invalid JSON');
-
-    const hasTs = Boolean(
-        exists(rootDir, 'tsconfig.json') ||
-            exists(rootDir, 'tsconfig.base.json') ||
-            exists(rootDir, 'tsconfig.app.json') ||
-            depVersion(pkg, 'typescript')
-    );
-
-    // Framework detection
-    let framework: StackDetectionResult['framework'] = { name: 'unknown', router: 'unknown' };
-
-    if (depVersion(pkg, 'next')) {
-        framework = { name: 'nextjs', version: depVersion(pkg, 'next'), router: 'unknown' };
-    } else if (depVersion(pkg, 'react')) {
-        framework = { name: 'react', version: depVersion(pkg, 'react'), router: 'unknown' };
-    } else if (depVersion(pkg, 'vue')) {
-        framework = { name: 'vue', version: depVersion(pkg, 'vue'), router: 'unknown' };
-    } else if (depVersion(pkg, 'svelte')) {
-        framework = { name: 'svelte', version: depVersion(pkg, 'svelte'), router: 'unknown' };
-    }
+function depVersion(pkg: unknown, name: string): string | undefined {
+  if (!isRecord(pkg)) return undefined;
 
-    const srcDir = Boolean(exists(rootDir, 'src'));
-    const hasAppDir = Boolean(exists(rootDir, 'app') || exists(rootDir, 'src', 'app'));
-    const hasPagesDir = Boolean(exists(rootDir, 'pages') || exists(rootDir, 'src', 'pages'));
+  const dependencies = isRecord(pkg.dependencies) ? pkg.dependencies : undefined;
+  const devDependencies = isRecord(pkg.devDependencies) ? pkg.devDependencies : undefined;
+  const peerDependencies = isRecord(pkg.peerDependencies) ? pkg.peerDependencies : undefined;
 
-    if (framework.name === 'nextjs') {
-        framework.router = hasAppDir ? 'app' : hasPagesDir ? 'pages' : 'unknown';
-    }
+  const dep =
+    (dependencies?.[name] as unknown) ??
+    (devDependencies?.[name] as unknown) ??
+    (peerDependencies?.[name] as unknown);
 
-    // Styling detection
-    const detectedStyling: string[] = [];
-    if (depVersion(pkg, 'tailwindcss') || exists(rootDir, 'tailwind.config.js') || exists(rootDir, 'tailwind.config.ts')) {
-        detectedStyling.push('tailwind');
-    }
-    if (depVersion(pkg, 'sass') || depVersion(pkg, 'node-sass')) detectedStyling.push('sass');
-    if (depVersion(pkg, 'styled-components')) detectedStyling.push('styled-components');
-    if (depVersion(pkg, '@emotion/react') || depVersion(pkg, '@emotion/styled')) detectedStyling.push('emotion');
-
-    // CSS Modules: heuristic – Next and CRA often use .module.css. We can't scan whole tree here; mark as possible.
-    if (framework.name === 'nextjs') detectedStyling.push('css-modules');
-
-    let primary: StackDetectionResult['styling']['primary'] = 'unknown';
-    if (detectedStyling.includes('tailwind')) primary = 'tailwind';
-    else if (detectedStyling.includes('emotion')) primary = 'emotion';
-    else if (detectedStyling.includes('styled-components')) primary = 'styled-components';
-    else if (detectedStyling.includes('sass')) primary = 'sass';
-    else if (framework.name !== 'unknown') primary = 'vanilla';
-
-    // UI libraries (coarse)
-    const uiCandidates = [
-        '@mui/material',
-        'antd',
-        '@chakra-ui/react',
-        '@radix-ui/react-dialog',
-        '@headlessui/react',
-        'shadcn-ui',
-        'lucide-react',
-        '@mantine/core',
-        '@nextui-org/react',
-    ];
-
-    const uiLibraries = uiCandidates.filter((n) => Boolean(depVersion(pkg, n)));
-
-    // Icon libraries
-    const iconCandidates = ['lucide-react', 'react-icons', '@heroicons/react', '@tabler/icons-react', '@phosphor-icons/react'];
-    const iconLibraries = iconCandidates.filter((n) => Boolean(depVersion(pkg, n)));
-
-    // Storybook / linting / formatting / tests
-    const hasStorybook = Boolean(exists(rootDir, '.storybook')) || Boolean(depVersion(pkg, 'storybook')) || Boolean(depVersion(pkg, '@storybook/react'));
-    const hasEslint = Boolean(depVersion(pkg, 'eslint')) || Boolean(exists(rootDir, '.eslintrc')) || Boolean(exists(rootDir, '.eslintrc.js'));
-    const hasPrettier = Boolean(depVersion(pkg, 'prettier')) || Boolean(exists(rootDir, '.prettierrc'));
-    const hasVitest = Boolean(depVersion(pkg, 'vitest'));
-    const hasJest = Boolean(depVersion(pkg, 'jest'));
-
-    // Shadcn detection
-    const componentsJson = exists(rootDir, 'components.json');
-    if (componentsJson) {
-        if (!uiLibraries.includes('shadcn-ui')) uiLibraries.push('shadcn-ui');
-    }
+  return typeof dep === 'string' ? dep : undefined;
+}
 
-    // tsconfig paths
-    const tsconfigPath = exists(rootDir, 'tsconfig.json') || exists(rootDir, 'tsconfig.base.json');
-    let tsconfigPaths: Record<string, string[]> | undefined;
-    if (tsconfigPath) {
-        const tsconfig = readJsonIfExists(tsconfigPath);
-        const paths = tsconfig?.compilerOptions?.paths;
-        if (paths && typeof paths === 'object') {
-            tsconfigPaths = paths;
+export function detectUiStack(rootDir: string): StackDetectionResult {
+  const warnings: string[] = [];
+
+  const pkgPath = exists(rootDir, 'package.json');
+  const pkg = pkgPath ? readJsonIfExists(pkgPath) : null;
+  if (!pkg) warnings.push('package.json not found or invalid JSON');
+
+  const hasTs = Boolean(
+    exists(rootDir, 'tsconfig.json') ||
+    exists(rootDir, 'tsconfig.base.json') ||
+    exists(rootDir, 'tsconfig.app.json') ||
+    depVersion(pkg, 'typescript')
+  );
+
+  // Framework detection
+  let framework: StackDetectionResult['framework'] = { name: 'unknown', router: 'unknown' };
+
+  if (depVersion(pkg, 'next')) {
+    framework = { name: 'nextjs', version: depVersion(pkg, 'next'), router: 'unknown' };
+  } else if (depVersion(pkg, 'react')) {
+    framework = { name: 'react', version: depVersion(pkg, 'react'), router: 'unknown' };
+  } else if (depVersion(pkg, 'vue')) {
+    framework = { name: 'vue', version: depVersion(pkg, 'vue'), router: 'unknown' };
+  } else if (depVersion(pkg, 'svelte')) {
+    framework = { name: 'svelte', version: depVersion(pkg, 'svelte'), router: 'unknown' };
+  }
+
+  const srcDir = Boolean(exists(rootDir, 'src'));
+  const hasAppDir = Boolean(exists(rootDir, 'app') || exists(rootDir, 'src', 'app'));
+  const hasPagesDir = Boolean(exists(rootDir, 'pages') || exists(rootDir, 'src', 'pages'));
+
+  if (framework.name === 'nextjs') {
+    framework.router = hasAppDir ? 'app' : hasPagesDir ? 'pages' : 'unknown';
+  }
+
+  // Styling detection
+  const detectedStyling: string[] = [];
+  if (
+    depVersion(pkg, 'tailwindcss') ||
+    exists(rootDir, 'tailwind.config.js') ||
+    exists(rootDir, 'tailwind.config.ts')
+  ) {
+    detectedStyling.push('tailwind');
+  }
+  if (depVersion(pkg, 'sass') || depVersion(pkg, 'node-sass')) detectedStyling.push('sass');
+  if (depVersion(pkg, 'styled-components')) detectedStyling.push('styled-components');
+  if (depVersion(pkg, '@emotion/react') || depVersion(pkg, '@emotion/styled'))
+    detectedStyling.push('emotion');
+
+  // CSS Modules: heuristic – Next and CRA often use .module.css. We can't scan whole tree here; mark as possible.
+  if (framework.name === 'nextjs') detectedStyling.push('css-modules');
+
+  let primary: StackDetectionResult['styling']['primary'] = 'unknown';
+  if (detectedStyling.includes('tailwind')) primary = 'tailwind';
+  else if (detectedStyling.includes('emotion')) primary = 'emotion';
+  else if (detectedStyling.includes('styled-components')) primary = 'styled-components';
+  else if (detectedStyling.includes('sass')) primary = 'sass';
+  else if (framework.name !== 'unknown') primary = 'vanilla';
+
+  // UI libraries (coarse)
+  const uiCandidates = [
+    '@mui/material',
+    'antd',
+    '@chakra-ui/react',
+    '@radix-ui/react-dialog',
+    '@headlessui/react',
+    'shadcn-ui',
+    'lucide-react',
+    '@mantine/core',
+    '@nextui-org/react',
+  ];
+
+  const uiLibraries = uiCandidates.filter((n) => Boolean(depVersion(pkg, n)));
+
+  // Icon libraries
+  const iconCandidates = [
+    'lucide-react',
+    'react-icons',
+    '@heroicons/react',
+    '@tabler/icons-react',
+    '@phosphor-icons/react',
+  ];
+  const iconLibraries = iconCandidates.filter((n) => Boolean(depVersion(pkg, n)));
+
+  // Storybook / linting / formatting / tests
+  const hasStorybook =
+    Boolean(exists(rootDir, '.storybook')) ||
+    Boolean(depVersion(pkg, 'storybook')) ||
+    Boolean(depVersion(pkg, '@storybook/react'));
+  const hasEslint =
+    Boolean(depVersion(pkg, 'eslint')) ||
+    Boolean(exists(rootDir, '.eslintrc')) ||
+    Boolean(exists(rootDir, '.eslintrc.js'));
+  const hasPrettier =
+    Boolean(depVersion(pkg, 'prettier')) || Boolean(exists(rootDir, '.prettierrc'));
+  const hasVitest = Boolean(depVersion(pkg, 'vitest'));
+  const hasJest = Boolean(depVersion(pkg, 'jest'));
+
+  // Shadcn detection
+  const componentsJson = exists(rootDir, 'components.json');
+  if (componentsJson) {
+    if (!uiLibraries.includes('shadcn-ui')) uiLibraries.push('shadcn-ui');
+  }
+
+  // tsconfig paths
+  const tsconfigPath = exists(rootDir, 'tsconfig.json') || exists(rootDir, 'tsconfig.base.json');
+  let tsconfigPaths: Record<string, string[]> | undefined;
+  if (tsconfigPath) {
+    const tsconfig = readJsonIfExists(tsconfigPath);
+    if (isRecord(tsconfig)) {
+      const compilerOptions = isRecord(tsconfig.compilerOptions)
+        ? tsconfig.compilerOptions
+        : undefined;
+      const paths =
+        compilerOptions && isRecord(compilerOptions.paths) ? compilerOptions.paths : undefined;
+      if (paths) {
+        const out: Record<string, string[]> = {};
+        for (const [k, v] of Object.entries(paths)) {
+          if (Array.isArray(v) && v.every((x) => typeof x === 'string')) {
+            out[k] = v;
+          }
         }
+        tsconfigPaths = Object.keys(out).length > 0 ? out : undefined;
+      }
     }
-
-    const tailwindConfig =
-        exists(rootDir, 'tailwind.config.ts') ||
-        exists(rootDir, 'tailwind.config.js') ||
-        exists(rootDir, 'tailwind.config.cjs') ||
-        exists(rootDir, 'tailwind.config.mjs');
-
-    return {
-        root: rootDir,
-        framework,
-        language: { typescript: hasTs },
-        styling: { primary, detected: Array.from(new Set(detectedStyling)) },
-        uiLibraries: Array.from(new Set(uiLibraries)),
-        iconLibraries: Array.from(new Set(iconLibraries)),
-        tooling: {
-            storybook: hasStorybook,
-            eslint: hasEslint,
-            prettier: hasPrettier,
-            vitest: hasVitest,
-            jest: hasJest,
-        },
-        conventions: {
-            srcDir,
-            hasAppDir,
-            hasPagesDir,
-            tsconfigPaths,
-        },
-        files: {
-            packageJson: pkgPath || undefined,
-            tsconfig: tsconfigPath || undefined,
-            tailwindConfig: tailwindConfig || undefined,
-            componentsJson: componentsJson || undefined,
-            storybookDir: exists(rootDir, '.storybook') || undefined,
-        },
-        warnings,
-    };
+  }
+
+  const tailwindConfig =
+    exists(rootDir, 'tailwind.config.ts') ||
+    exists(rootDir, 'tailwind.config.js') ||
+    exists(rootDir, 'tailwind.config.cjs') ||
+    exists(rootDir, 'tailwind.config.mjs');
+
+  return {
+    root: rootDir,
+    framework,
+    language: { typescript: hasTs },
+    styling: { primary, detected: Array.from(new Set(detectedStyling)) },
+    uiLibraries: Array.from(new Set(uiLibraries)),
+    iconLibraries: Array.from(new Set(iconLibraries)),
+    tooling: {
+      storybook: hasStorybook,
+      eslint: hasEslint,
+      prettier: hasPrettier,
+      vitest: hasVitest,
+      jest: hasJest,
+    },
+    conventions: {
+      srcDir,
+      hasAppDir,
+      hasPagesDir,
+      tsconfigPaths,
+    },
+    files: {
+      packageJson: pkgPath || undefined,
+      tsconfig: tsconfigPath || undefined,
+      tailwindConfig: tailwindConfig || undefined,
+      componentsJson: componentsJson || undefined,
+      storybookDir: exists(rootDir, '.storybook') || undefined,
+    },
+    warnings,
+  };
 }