@react-spa-scaffold/mcp 0.3.0

package/dist/utils/scaffold.js

@@ -0,0 +1,500 @@
+/**
+ * Scaffold computation utilities
+ */
+import { readFile } from 'fs/promises';
+import { FEATURES } from '../features/index.js';
+import { computeDocsContent, computeDocsForFeatures } from './docs.js';
+import { resolveTemplatePath } from './paths.js';
+/**
+ * Resolve selected features (always includes core)
+ *
+ * Features are independent - only explicitly selected features are included.
+ */
+export function resolveFeatureDependencies(selectedFeatures) {
+    const resolved = new Set();
+    // Always include core
+    resolved.add('core');
+    // Add all selected features (no recursive dependency resolution)
+    for (const featureId of selectedFeatures) {
+        const feature = FEATURES[featureId];
+        if (feature) {
+            resolved.add(featureId);
+        }
+    }
+    return Array.from(resolved);
+}
+/**
+ * Merge dependencies from multiple features
+ */
+export function mergeDependencies(featureIds) {
+    const dependencies = {};
+    const devDependencies = {};
+    for (const featureId of featureIds) {
+        const feature = FEATURES[featureId];
+        if (!feature)
+            continue;
+        if (feature.dependencies) {
+            Object.assign(dependencies, feature.dependencies);
+        }
+        if (feature.devDependencies) {
+            Object.assign(devDependencies, feature.devDependencies);
+        }
+    }
+    // Sort alphabetically
+    const sortObject = (obj) => Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
+    return {
+        dependencies: sortObject(dependencies),
+        devDependencies: sortObject(devDependencies),
+    };
+}
+/**
+ * Merge scripts from multiple features
+ */
+export function mergeScripts(featureIds) {
+    const scripts = {};
+    for (const featureId of featureIds) {
+        const feature = FEATURES[featureId];
+        if (!feature?.scripts)
+            continue;
+        Object.assign(scripts, feature.scripts);
+    }
+    return scripts;
+}
+/**
+ * Compute file structure for selected features
+ */
+export function computeFileStructure(featureIds) {
+    const files = new Set();
+    for (const featureId of featureIds) {
+        const feature = FEATURES[featureId];
+        if (!feature?.files)
+            continue;
+        for (const file of feature.files) {
+            files.add(file);
+        }
+    }
+    return Array.from(files).sort();
+}
+/**
+ * Get config files needed for selected features
+ */
+export function getConfigFiles(featureIds) {
+    const configs = new Set();
+    for (const featureId of featureIds) {
+        const feature = FEATURES[featureId];
+        if (!feature?.configFiles)
+            continue;
+        for (const config of feature.configFiles) {
+            configs.add(config);
+        }
+    }
+    return Array.from(configs).sort();
+}
+/**
+ * Read config file content from template
+ */
+async function readConfigFileContent(configPath) {
+    const fullPath = resolveTemplatePath(configPath);
+    try {
+        return await readFile(fullPath, 'utf-8');
+    }
+    catch {
+        // File might not exist if running outside react-spa-scaffold
+        return `// File not found: ${configPath}\n// Run MCP server from within react-spa-scaffold repository`;
+    }
+}
+/**
+ * Generate setup commands based on selected features
+ */
+export function getSetupCommands(featureIds) {
+    const commands = ['npm install'];
+    if (featureIds.includes('devtools')) {
+        commands.push('npm run prepare'); // Initialize husky
+    }
+    if (featureIds.includes('testing')) {
+        commands.push('npx playwright install chromium'); // Install Playwright browser
+    }
+    if (featureIds.includes('i18n')) {
+        commands.push('npm run i18n:extract'); // Extract initial translations
+    }
+    return commands;
+}
+/**
+ * Generate CLAUDE.md content based on selected features
+ */
+export function generateClaudeMd(featureIds, projectName, scripts) {
+    const sections = [];
+    // Header
+    sections.push(`# CLAUDE.md
+
+AI assistant guidance for **${projectName}** - a React 19 + TypeScript + Vite 7 codebase.`);
+    // Commands section - based on actual scripts
+    const commandLines = [];
+    const scriptDescriptions = {
+        dev: 'Dev server at localhost:5173',
+        build: 'Production build (typecheck + bundle)',
+        preview: 'Preview production build',
+        typecheck: 'TypeScript only',
+        lint: 'ESLint check',
+        'lint:fix': 'ESLint auto-fix',
+        format: 'Prettier format',
+        'format:check': 'Prettier check',
+        test: 'Vitest once',
+        'test:watch': 'Vitest watch mode',
+        'test:coverage': 'Coverage (80% threshold)',
+        e2e: 'Playwright E2E',
+        'e2e:ui': 'Playwright UI mode',
+        'i18n:extract': 'Extract translations to .po',
+        prepare: 'Initialize Husky hooks',
+    };
+    for (const script of Object.keys(scripts).sort()) {
+        const desc = scriptDescriptions[script] || '';
+        const padding = ' '.repeat(Math.max(1, 20 - script.length));
+        commandLines.push(`npm run ${script}${padding}# ${desc}`);
+    }
+    sections.push(`
+## Commands
+
+\`\`\`bash
+${commandLines.join('\n')}
+\`\`\``);
+    // Project Structure - dynamic based on features
+    const structureParts = ['src/', '├── components/    # ui/ (primitives), layout/, shared/ (features)'];
+    if (featureIds.includes('api') || featureIds.includes('i18n') || featureIds.includes('mobile')) {
+        structureParts.push('├── contexts/      # React Context providers');
+    }
+    structureParts.push('├── hooks/         # Custom hooks');
+    structureParts.push('├── lib/           # config, utils, format' +
+        (featureIds.includes('api') ? ', api' : '') +
+        (featureIds.includes('routing') ? ', routes' : '') +
+        (featureIds.includes('state') ? ', storage' : ''));
+    if (featureIds.includes('routing')) {
+        structureParts.push('├── pages/         # Lazy-loaded route components');
+    }
+    if (featureIds.includes('state')) {
+        structureParts.push('├── stores/        # Zustand stores');
+    }
+    if (featureIds.includes('i18n')) {
+        structureParts.push('├── i18n/          # LinguiJS config and catalogs');
+        structureParts.push('├── locales/       # Translation files (.po)');
+    }
+    structureParts.push('└── types/         # TypeScript definitions');
+    if (featureIds.includes('testing')) {
+        structureParts.push('');
+        structureParts.push('tests/unit/        # Vitest (mirrors src/)');
+        structureParts.push('e2e/               # Playwright tests');
+    }
+    sections.push(`
+## Project Structure
+
+\`\`\`
+${structureParts.join('\n')}
+\`\`\``);
+    // Code Patterns - always included
+    const stateHierarchy = [];
+    if (featureIds.includes('state'))
+        stateHierarchy.push('Zustand (persisted)');
+    if (featureIds.includes('api'))
+        stateHierarchy.push('TanStack Query (server)');
+    stateHierarchy.push('Context (UI)', 'useState (local)');
+    sections.push(`
+## Code Patterns
+
+**Imports**: Always use \`@/\` path alias
+
+**Components**: Named exports + \`Props\` interface. Pages use default exports for lazy loading.
+
+**TypeScript**: \`type\` for unions, \`interface\` for objects
+
+**State hierarchy**: ${stateHierarchy.join(' → ')}`);
+    // UI Components section - only if ui feature
+    if (featureIds.includes('ui')) {
+        sections.push(`
+## UI Components (Shadcn/UI)
+
+This project uses **Shadcn/UI** with radix-nova style. Components live in \`src/components/ui/\`.
+
+### Adding New Components
+
+\`\`\`bash
+npx shadcn@latest add button           # Single component
+npx shadcn@latest add dialog card input # Multiple components
+\`\`\`
+
+**Pattern**: Import directly (no barrel exports for UI):
+
+\`\`\`tsx
+import { Button } from '@/components/ui/button';
+import { cn } from '@/lib/utils';
+\`\`\``);
+    }
+    // Mobile section - only if mobile feature
+    if (featureIds.includes('mobile')) {
+        sections.push(`
+## Mobile & Responsive Design
+
+This project includes mobile-first responsive utilities.
+
+### Viewport Detection
+
+\`\`\`tsx
+import { MobileProvider, useMobileContext } from '@/contexts/mobileContext';
+
+// Wrap app with MobileProvider
+<MobileProvider>{children}</MobileProvider>
+
+// Use in components
+const { isMobile, isTablet, isDesktop, width } = useMobileContext();
+\`\`\`
+
+### Breakpoints
+
+\`\`\`tsx
+import { BREAKPOINTS, useIsMobile, useIsDesktop } from '@/hooks/useMediaQuery';
+
+// BREAKPOINTS: sm (640), md (768), lg (1024), xl (1280)
+const isMobile = useIsMobile();   // width < 768px
+const isDesktop = useIsDesktop(); // width >= 1024px
+\`\`\`
+
+### Touch-Aware Sizing
+
+\`\`\`tsx
+import { useTouchSizes } from '@/hooks/useTouchSizes';
+
+const sizes = useTouchSizes();
+<Button size={sizes.button}>Click</Button>  // 'touch' on mobile, 'default' on desktop
+\`\`\``);
+    }
+    // MCP Servers section - always helpful
+    sections.push(`
+## MCP Servers (PREFER OVER WebSearch)
+
+Use MCP servers for documentation lookup. They provide **structured, version-accurate data** directly from source.
+
+### Context7 MCP (All Libraries)
+
+Use for **any npm package** documentation:
+
+\`\`\`
+resolve-library-id → get-library-docs
+\`\`\`
+
+**Examples**: react-hook-form, @tanstack/react-query, zustand, zod, date-fns`);
+    if (featureIds.includes('ui')) {
+        sections.push(`
+### Shadcn MCP (UI Components)
+
+| Need                | Tool                                             |
+| ------------------- | ------------------------------------------------ |
+| Find component      | \`mcp__shadcn__search_items_in_registries\`        |
+| View component code | \`mcp__shadcn__view_items_in_registries\`          |
+| Usage examples      | \`mcp__shadcn__get_item_examples_from_registries\` |`);
+    }
+    // Translations section - only if i18n feature
+    if (featureIds.includes('i18n')) {
+        sections.push(`
+## Translations (CRITICAL)
+
+All user-facing text MUST have translator comments. ESLint enforces this.
+
+\`\`\`tsx
+<Trans comment="Dashboard heading">Welcome back</Trans>
+t({ message: 'Close', comment: 'Close button' })
+\`\`\``);
+    }
+    // Testing section - only if testing feature
+    if (featureIds.includes('testing')) {
+        sections.push(`
+## Testing
+
+Tests in \`tests/unit/\` mirror \`src/\` structure. 80% coverage required.
+
+\`\`\`typescript
+import { describe, it, expect, vi } from 'vitest';
+import { screen, renderHook } from '@testing-library/react';
+import { render, mockMatchMedia, server } from '@/test';
+\`\`\`
+
+MSW handlers auto-reset after each test.`);
+    }
+    // Common Gotchas - filtered by features
+    const gotchas = [];
+    if (featureIds.includes('devtools')) {
+        gotchas.push('**Node.js >= 22.0.0** required (check `.nvmrc`)');
+        gotchas.push('**Conventional commits** enforced by commitlint');
+    }
+    if (featureIds.includes('mobile')) {
+        gotchas.push('**Context hooks throw** outside provider (e.g., `useMobileContext()`)');
+    }
+    gotchas.push('**Barrel exports** in each directory via `index.ts`');
+    if (featureIds.includes('ui')) {
+        gotchas.push('**UI components** import directly: `@/components/ui/button` (no barrel)');
+    }
+    sections.push(`
+## Common Gotchas
+
+${gotchas.map((g, i) => `${i + 1}. ${g}`).join('\n')}
+`);
+    return sections.join('\n');
+}
+/**
+ * Generate vite-env.d.ts content based on selected features
+ */
+export function generateViteEnvDts(featureIds) {
+    const envVars = [];
+    // Core env vars (always included)
+    envVars.push('  readonly VITE_APP_NAME: string;');
+    envVars.push('  readonly VITE_APP_URL: string;');
+    // API feature env vars
+    if (featureIds.includes('api')) {
+        envVars.push('  readonly VITE_API_URL: string;');
+    }
+    // Observability feature env vars
+    if (featureIds.includes('observability')) {
+        envVars.push('  readonly VITE_SENTRY_DSN: string;');
+        envVars.push('  readonly VITE_SENTRY_ENABLED: string;');
+    }
+    return `/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+${envVars.join('\n')}
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}
+`;
+}
+/**
+ * Generate env.ts content based on selected features
+ */
+export function generateEnvTs(featureIds) {
+    const schemaFields = [];
+    const envFields = [];
+    // Core env vars (always included)
+    schemaFields.push('  VITE_APP_NAME: z.string().min(1).optional(),');
+    schemaFields.push('  VITE_APP_URL: z.string().url().optional(),');
+    envFields.push('    VITE_APP_NAME: import.meta.env.VITE_APP_NAME,');
+    envFields.push('    VITE_APP_URL: import.meta.env.VITE_APP_URL,');
+    // API feature env vars
+    if (featureIds.includes('api')) {
+        schemaFields.push('  VITE_API_URL: z.string().url().optional(),');
+        envFields.push('    VITE_API_URL: import.meta.env.VITE_API_URL,');
+    }
+    // Observability feature env vars
+    if (featureIds.includes('observability')) {
+        schemaFields.push('  VITE_SENTRY_DSN: z.string().url().optional(),');
+        schemaFields.push('  VITE_SENTRY_ENABLED: z.string().optional(),');
+        envFields.push('    VITE_SENTRY_DSN: import.meta.env.VITE_SENTRY_DSN,');
+        envFields.push('    VITE_SENTRY_ENABLED: import.meta.env.VITE_SENTRY_ENABLED,');
+    }
+    // Vite built-in env vars (always included)
+    schemaFields.push("  MODE: z.enum(['development', 'production', 'test']).default('development'),");
+    schemaFields.push('  DEV: z.boolean().default(false),');
+    schemaFields.push('  PROD: z.boolean().default(false),');
+    envFields.push('    MODE: import.meta.env.MODE,');
+    envFields.push('    DEV: import.meta.env.DEV,');
+    envFields.push('    PROD: import.meta.env.PROD,');
+    return `/**
+ * Environment variable validation using Zod.
+ * Validates at runtime to catch missing/invalid env vars early.
+ */
+
+import { z } from 'zod';
+
+const envSchema = z.object({
+${schemaFields.join('\n')}
+});
+
+export type Env = z.infer<typeof envSchema>;
+
+/**
+ * Validate environment variables and return typed env object.
+ * Throws if validation fails in production.
+ */
+export function validateEnv(): Env {
+  const env = {
+${envFields.join('\n')}
+  };
+
+  const result = envSchema.safeParse(env);
+
+  if (!result.success) {
+    const errors = result.error.format();
+    console.error('Environment validation failed:', errors);
+
+    if (import.meta.env.PROD) {
+      throw new Error('Invalid environment configuration');
+    }
+  }
+
+  return result.success ? result.data : (env as Env);
+}
+
+/**
+ * Validated environment variables.
+ * Access this instead of import.meta.env for type safety.
+ */
+export const env = validateEnv();
+`;
+}
+/**
+ * Read and parse the source package.json
+ */
+async function readSourcePackageJson() {
+    const path = resolveTemplatePath('package.json');
+    const content = await readFile(path, 'utf-8');
+    return JSON.parse(content);
+}
+/**
+ * Compute complete scaffold for selected features
+ */
+export async function computeScaffold(selectedFeatures, projectName = 'my-app') {
+    // Resolve all dependencies
+    const resolvedFeatures = resolveFeatureDependencies(selectedFeatures);
+    // Read engines from source package.json
+    const sourcePackageJson = await readSourcePackageJson();
+    const engines = sourcePackageJson.engines || {};
+    // Merge all dependencies
+    const { dependencies, devDependencies } = mergeDependencies(resolvedFeatures);
+    // Merge all scripts
+    const scripts = mergeScripts(resolvedFeatures);
+    // Get file structure (add CLAUDE.md which is generated, not from patterns)
+    // Also add docs based on selected features
+    const docPaths = computeDocsForFeatures(resolvedFeatures);
+    const structure = [...computeFileStructure(resolvedFeatures), 'CLAUDE.md', ...docPaths];
+    // Get config files with actual content read from templates
+    const configFiles = {};
+    const configPaths = getConfigFiles(resolvedFeatures);
+    for (const config of configPaths) {
+        configFiles[config] = await readConfigFileContent(config);
+    }
+    // Get setup commands
+    const setupCommands = getSetupCommands(resolvedFeatures);
+    // Generate CLAUDE.md content
+    const claudeMd = generateClaudeMd(resolvedFeatures, projectName, scripts);
+    // Generate vite-env.d.ts content
+    const viteEnvDts = generateViteEnvDts(resolvedFeatures);
+    // Generate env.ts content
+    const envTs = generateEnvTs(resolvedFeatures);
+    // Get docs with content filtered by features
+    const docs = await computeDocsContent(resolvedFeatures);
+    return {
+        packageJson: {
+            name: projectName,
+            dependencies,
+            devDependencies,
+            scripts,
+            engines,
+        },
+        structure,
+        configFiles,
+        setupCommands,
+        claudeMd,
+        viteEnvDts,
+        envTs,
+        docs,
+    };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/utils/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../src/utils/scaffold.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Package version - read from package.json
+ */
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,eAAO,MAAM,OAAO,QAAe,CAAC"}

package/dist/version.js

@@ -0,0 +1,19 @@
+/**
+ * Package version - read from package.json
+ */
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function getVersion() {
+    try {
+        const packagePath = join(__dirname, '..', 'package.json');
+        const pkg = JSON.parse(readFileSync(packagePath, 'utf-8'));
+        return pkg.version;
+    }
+    catch {
+        return '1.0.0'; // Fallback
+    }
+}
+export const VERSION = getVersion();
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,CAAC,WAAW;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@react-spa-scaffold/mcp",
+  "version": "0.3.0",
+  "description": "MCP server for scaffolding projects based on react-spa-scaffold template",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "react-spa-scaffold-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "bundle": "node scripts/bundle-templates.js",
+    "prepublishOnly": "npm run bundle && npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "react-spa-scaffold",
+    "scaffolding",
+    "react",
+    "typescript"
+  ],
+  "author": "Mariusz Kaczkowski",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mkaczkowski/react-spa-scaffold.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/mkaczkowski/react-spa-scaffold/tree/main/packages/mcp#readme",
+  "bugs": {
+    "url": "https://github.com/mkaczkowski/react-spa-scaffold/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.25.64"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "@react-spa-scaffold/tsconfig": "*",
+    "typescript": "~5.9.0",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}