mcp-react-toolkit 1.0.1 → 1.3.0

package/tools/render-analyzer/build/index.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+interface RenderIssue {
+    type: 'missing-memo' | 'missing-usememo' | 'missing-usecallback' | 'inline-object' | 'inline-array' | 'inline-function' | 'new-object-prop' | 'context-value';
+    component: string;
+    file: string;
+    line: number;
+    description: string;
+    severity: 'high' | 'medium' | 'low';
+    fix: string;
+}
+interface ComponentRenderProfile {
+    name: string;
+    file: string;
+    hasMemo: boolean;
+    hasUseMemo: boolean;
+    hasUseCallback: boolean;
+    propsCount: number;
+    inlineObjects: number;
+    inlineFunctions: number;
+    issues: RenderIssue[];
+}
+export declare function extractComponents(content: string): string[];
+export declare function analyzeComponent(content: string, componentName: string, filePath: string): ComponentRenderProfile;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/tools/render-analyzer/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,UAAU,WAAW;IACnB,IAAI,EAAE,cAAc,GAAG,iBAAiB,GAAG,qBAAqB,GAAG,eAAe,GAAG,cAAc,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC;IAC9J,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,sBAAsB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAwBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ3D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,sBAAsB,CAgKjH"}

package/tools/render-analyzer/build/index.js

@@ -0,0 +1,342 @@
+#!/usr/bin/env node
+import { McpServerBase, safeReadFile } from '@mcp-showcase/shared';
+import * as fs from 'fs';
+import * as path from 'path';
+// ============================================================================
+// SOURCE ANALYSIS
+// ============================================================================
+function scanDirectory(dir) {
+    const files = [];
+    if (!fs.existsSync(dir))
+        return files;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isSymbolicLink())
+            continue;
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (['node_modules', 'build', 'dist', '.next', '__tests__', '.turbo', '.git'].includes(entry.name))
+                continue;
+            files.push(...scanDirectory(fullPath));
+        }
+        else if (entry.name.match(/\.(tsx|jsx)$/)) {
+            if (entry.name.includes('.test.') || entry.name.includes('.spec.') || entry.name.includes('.stories.'))
+                continue;
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+export function extractComponents(content) {
+    const components = [];
+    const fnRegex = /(?:export\s+(?:default\s+)?)?(?:const|function)\s+([A-Z]\w+)/g;
+    let match;
+    while ((match = fnRegex.exec(content)) !== null) {
+        if (!components.includes(match[1]))
+            components.push(match[1]);
+    }
+    return components;
+}
+export function analyzeComponent(content, componentName, filePath) {
+    const hasMemo = content.includes(`memo(${componentName})`) || content.includes('React.memo');
+    const hasUseMemo = content.includes('useMemo');
+    const hasUseCallback = content.includes('useCallback');
+    let inlineObjects = 0;
+    let inlineFunctions = 0;
+    let propsCount = 0;
+    const issues = [];
+    const compStart = content.indexOf(componentName);
+    if (compStart === -1) {
+        return { name: componentName, file: filePath, hasMemo, hasUseMemo, hasUseCallback, propsCount, inlineObjects, inlineFunctions, issues };
+    }
+    const componentBody = content.slice(compStart);
+    const bodyLines = componentBody.split('\n');
+    for (let i = 0; i < bodyLines.length; i++) {
+        const line = bodyLines[i];
+        const lineNum = content.slice(0, compStart).split('\n').length + i;
+        // Inline object literals as props: style={{...}}
+        const inlineObjMatches = line.match(/\{\{[^}]+\}\}/g);
+        if (inlineObjMatches) {
+            inlineObjects += inlineObjMatches.length;
+            for (const _m of inlineObjMatches) {
+                issues.push({
+                    type: 'inline-object',
+                    component: componentName,
+                    file: filePath,
+                    line: lineNum,
+                    description: 'Inline object literal creates a new reference on every render, causing child re-renders.',
+                    severity: 'medium',
+                    fix: 'Extract to a const outside the component or wrap with useMemo:\nconst style = useMemo(() => ({ /* styles */ }), []);',
+                });
+            }
+        }
+        // Inline array literals as props: items={[...]}
+        const inlineArrMatches = line.match(/=\s*\[[^\]]*\]/g);
+        if (inlineArrMatches && line.includes('<')) {
+            inlineObjects += inlineArrMatches.length;
+            for (const _m of inlineArrMatches) {
+                issues.push({
+                    type: 'inline-array',
+                    component: componentName,
+                    file: filePath,
+                    line: lineNum,
+                    description: 'Inline array literal creates a new reference on every render.',
+                    severity: 'medium',
+                    fix: 'Extract to useMemo:\nconst items = useMemo(() => [...], [deps]);',
+                });
+            }
+        }
+        // Inline arrow functions as props: onClick={() => ...}
+        const inlineFnMatches = line.match(/on\w+=\{(?:\([^)]*\)\s*=>|[\w]+\s*=>)/g);
+        if (inlineFnMatches) {
+            inlineFunctions += inlineFnMatches.length;
+            for (const _m of inlineFnMatches) {
+                issues.push({
+                    type: 'inline-function',
+                    component: componentName,
+                    file: filePath,
+                    line: lineNum,
+                    description: 'Inline function creates a new reference on every render. Use useCallback to memoize.',
+                    severity: 'medium',
+                    fix: 'const handler = useCallback((e) => { /* handler logic */ }, [deps]);',
+                });
+            }
+        }
+        // Count props
+        const propsMatch = line.match(/\(\s*\{\s*([^}]+)\s*\}/);
+        if (propsMatch) {
+            propsCount = propsMatch[1].split(',').length;
+        }
+        // new Date/Object inside component
+        if (line.match(/new\s+(Date|Object|Array|Map|Set|RegExp)\(/)) {
+            issues.push({
+                type: 'new-object-prop',
+                component: componentName,
+                file: filePath,
+                line: lineNum,
+                description: 'Creating new object instance on every render. Move outside component or memoize.',
+                severity: 'low',
+                fix: 'const obj = useMemo(() => new Date(), []);',
+            });
+        }
+        // Context value without useMemo
+        if (line.includes('value=') && line.includes('{') && !hasUseMemo) {
+            issues.push({
+                type: 'context-value',
+                component: componentName,
+                file: filePath,
+                line: lineNum,
+                description: 'Context value object is recreated on every render. Wrap with useMemo.',
+                severity: 'high',
+                fix: 'const contextValue = useMemo(() => ({ prop1, prop2 }), [prop1, prop2]);',
+            });
+        }
+    }
+    // Missing memo check (only flag if component has props)
+    if (!hasMemo && !content.includes('export default memo(') && propsCount > 0) {
+        issues.push({
+            type: 'missing-memo',
+            component: componentName,
+            file: filePath,
+            line: 1,
+            description: 'Component is not wrapped with React.memo. It will re-render whenever parent re-renders, even if props haven\'t changed.',
+            severity: 'medium',
+            fix: `export default memo(${componentName});`,
+        });
+    }
+    // Missing key prop in .map() renders
+    const mapMatches = [...componentBody.matchAll(/\.map\s*\(\s*(?:\([^)]*\)|[\w]+)\s*=>/g)];
+    for (const mapMatch of mapMatches) {
+        const mapIdx = mapMatch.index ?? 0;
+        const mapBlock = componentBody.slice(mapIdx, mapIdx + 300);
+        // Check if the returned JSX element has a key prop
+        if (!mapBlock.includes('key=') && mapBlock.includes('<')) {
+            const lineNum = content.slice(0, compStart + mapIdx).split('\n').length;
+            issues.push({
+                type: 'inline-function',
+                component: componentName,
+                file: filePath,
+                line: lineNum,
+                description: '.map() render missing key prop. React uses key to identify list items — missing keys cause unnecessary re-renders and reconciliation bugs.',
+                severity: 'high',
+                fix: 'Add a stable key prop to the root element: items.map((item) => <Component key={item.id} />)',
+            });
+        }
+    }
+    // useEffect with no dependency array (runs on every render)
+    const effectMatches = [...componentBody.matchAll(/useEffect\s*\(\s*(?:async\s*)?\(\s*\)\s*=>/g)];
+    for (const effectMatch of effectMatches) {
+        const effectIdx = effectMatch.index ?? 0;
+        const effectBlock = componentBody.slice(effectIdx, effectIdx + 200);
+        // If no closing ", [" or ", []" pattern → missing deps array
+        if (!effectBlock.includes(', [') && !effectBlock.includes(',[')) {
+            const lineNum = content.slice(0, compStart + effectIdx).split('\n').length;
+            issues.push({
+                type: 'missing-usecallback',
+                component: componentName,
+                file: filePath,
+                line: lineNum,
+                description: 'useEffect missing dependency array — runs on every render. This is likely a bug or performance issue.',
+                severity: 'high',
+                fix: 'Add dependency array as second argument: useEffect(() => { ... }, [dep1, dep2])\nUse [] for mount-only effects.',
+            });
+        }
+    }
+    return { name: componentName, file: filePath, hasMemo, hasUseMemo, hasUseCallback, propsCount, inlineObjects, inlineFunctions, issues };
+}
+// ============================================================================
+// MAIN SERVER
+// ============================================================================
+class RenderAnalyzerServer extends McpServerBase {
+    constructor() {
+        super({ name: 'render-analyzer', version: '1.0.0' });
+    }
+    registerTools() {
+        this.addTool('detect_rerenders', 'Analyze React component files for unnecessary re-render patterns: inline objects/arrays/functions, missing memo, context value issues.', {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Path to component file or directory to analyze' },
+                severity: { type: 'string', enum: ['high', 'medium', 'low', 'all'], description: 'Minimum severity to report (default: all)' },
+            },
+            required: ['path'],
+        }, (args) => this.handleDetectRerenders(args));
+        this.addTool('check_memo', 'Check which components are wrapped with React.memo, use useMemo, or useCallback — and which are not.', {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Path to component file or directory' },
+            },
+            required: ['path'],
+        }, (args) => this.handleCheckMemo(args));
+        this.addTool('analyze_props', 'Find components that pass inline objects or functions as props — the most common cause of unnecessary child re-renders.', {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Path to component file or directory' },
+            },
+            required: ['path'],
+        }, (args) => this.handleAnalyzeProps(args));
+    }
+    async handleDetectRerenders(args) {
+        const { path: targetPath, severity = 'all' } = args;
+        try {
+            const stat = fs.statSync(targetPath);
+            const files = stat.isDirectory() ? scanDirectory(targetPath) : [targetPath];
+            const severityOrder = { high: 0, medium: 1, low: 2 };
+            const minSeverity = severityOrder[severity] ?? 2;
+            const profiles = [];
+            let totalIssues = 0;
+            for (const file of files) {
+                const content = safeReadFile(file);
+                if (content === null)
+                    continue;
+                const components = extractComponents(content);
+                for (const comp of components) {
+                    const profile = analyzeComponent(content, comp, file);
+                    const filteredIssues = profile.issues.filter(i => severityOrder[i.severity] <= minSeverity);
+                    profile.issues = filteredIssues;
+                    totalIssues += filteredIssues.length;
+                    profiles.push(profile);
+                }
+            }
+            return this.success({
+                summary: {
+                    totalComponents: profiles.length,
+                    totalIssues,
+                    componentsWithIssues: profiles.filter(p => p.issues.length > 0).length,
+                },
+                profiles: profiles.filter(p => p.issues.length > 0),
+            });
+        }
+        catch (error) {
+            return this.error(error);
+        }
+    }
+    async handleCheckMemo(args) {
+        const { path: targetPath } = args;
+        try {
+            const stat = fs.statSync(targetPath);
+            const files = stat.isDirectory() ? scanDirectory(targetPath) : [targetPath];
+            const results = [];
+            let totalComponents = 0;
+            let memoizedCount = 0;
+            let useMemoCount = 0;
+            let useCallbackCount = 0;
+            for (const file of files) {
+                const content = safeReadFile(file);
+                if (content === null)
+                    continue;
+                const components = extractComponents(content);
+                for (const comp of components) {
+                    totalComponents++;
+                    const profile = analyzeComponent(content, comp, file);
+                    if (profile.hasMemo)
+                        memoizedCount++;
+                    if (profile.hasUseMemo)
+                        useMemoCount++;
+                    if (profile.hasUseCallback)
+                        useCallbackCount++;
+                    results.push({
+                        component: comp,
+                        file,
+                        hasMemo: profile.hasMemo,
+                        hasUseMemo: profile.hasUseMemo,
+                        hasUseCallback: profile.hasUseCallback,
+                        propsCount: profile.propsCount,
+                    });
+                }
+            }
+            return this.success({
+                summary: {
+                    totalComponents,
+                    memoized: memoizedCount,
+                    notMemoized: totalComponents - memoizedCount,
+                    useMemoUsage: useMemoCount,
+                    useCallbackUsage: useCallbackCount,
+                    memoizationRate: totalComponents > 0 ? Math.round((memoizedCount / totalComponents) * 100) : 100,
+                },
+                components: results,
+            });
+        }
+        catch (error) {
+            return this.error(error);
+        }
+    }
+    async handleAnalyzeProps(args) {
+        const { path: targetPath } = args;
+        try {
+            const stat = fs.statSync(targetPath);
+            const files = stat.isDirectory() ? scanDirectory(targetPath) : [targetPath];
+            const results = [];
+            for (const file of files) {
+                const content = safeReadFile(file);
+                if (content === null)
+                    continue;
+                const components = extractComponents(content);
+                for (const comp of components) {
+                    const profile = analyzeComponent(content, comp, file);
+                    if (profile.inlineObjects > 0 || profile.inlineFunctions > 0) {
+                        results.push({
+                            component: comp,
+                            file,
+                            inlineObjects: profile.inlineObjects,
+                            inlineFunctions: profile.inlineFunctions,
+                            propsCount: profile.propsCount,
+                            issues: profile.issues.filter(i => ['inline-object', 'inline-array', 'inline-function'].includes(i.type)),
+                        });
+                    }
+                }
+            }
+            return this.success({
+                componentsWithPropIssues: results.length,
+                results,
+            });
+        }
+        catch (error) {
+            return this.error(error);
+        }
+    }
+}
+// ============================================================================
+// ENTRY POINT
+// ============================================================================
+new RenderAnalyzerServer().run().catch(console.error);
+//# sourceMappingURL=index.js.map

package/tools/render-analyzer/build/index.js.map

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

package/tools/render-analyzer/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@mcp-showcase/render-analyzer",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./build/index.js",
+  "scripts": {
+    "build": "tsc && chmod +x build/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@mcp-showcase/shared": "*",
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
+  }
+}

package/tools/shared/build/fs.d.ts

@@ -0,0 +1,8 @@
+export declare const MAX_FILE_BYTES: number;
+export declare const DEFAULT_SKIP_DIRS: Set<string>;
+export declare function safeReadJson<T>(filePath: string): T | null;
+export declare function safeReadFile(filePath: string): string | null;
+export declare function isNextJsProject(dir: string): boolean;
+export declare const NEXTJS_ROUTE_FILES: Set<string>;
+export declare function isServerComponent(filePath: string, content: string): boolean;
+//# sourceMappingURL=fs.d.ts.map

package/tools/shared/build/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc,QAAmB,CAAC;AAE/C,eAAO,MAAM,iBAAiB,aAG5B,CAAC;AAEH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAO1D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ5D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMpD;AAED,eAAO,MAAM,kBAAkB,aAK7B,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAI5E"}

package/tools/shared/build/fs.js

@@ -0,0 +1,45 @@
+import * as fs from 'fs';
+import * as path from 'path';
+export const MAX_FILE_BYTES = 10 * 1024 * 1024; // 10 MB
+export const DEFAULT_SKIP_DIRS = new Set([
+    'node_modules', 'build', 'dist', '.next', '.turbo', '__tests__',
+    '.git', 'coverage', '.cache', 'out', '.vercel', '.svelte-kit',
+]);
+export function safeReadJson(filePath) {
+    try {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function safeReadFile(filePath) {
+    try {
+        const stat = fs.statSync(filePath);
+        if (stat.size > MAX_FILE_BYTES)
+            return null;
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+export function isNextJsProject(dir) {
+    return (fs.existsSync(path.join(dir, 'next.config.js')) ||
+        fs.existsSync(path.join(dir, 'next.config.ts')) ||
+        fs.existsSync(path.join(dir, 'next.config.mjs')));
+}
+export const NEXTJS_ROUTE_FILES = new Set([
+    'page.tsx', 'page.ts', 'layout.tsx', 'layout.ts',
+    'loading.tsx', 'loading.ts', 'error.tsx', 'error.ts',
+    'not-found.tsx', 'not-found.ts', 'template.tsx', 'template.ts',
+    'route.ts', 'route.tsx',
+]);
+export function isServerComponent(filePath, content) {
+    const name = path.basename(filePath);
+    if (!NEXTJS_ROUTE_FILES.has(name))
+        return false;
+    return !content.includes("'use client'") && !content.includes('"use client"');
+}
+//# sourceMappingURL=fs.js.map

package/tools/shared/build/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACvC,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW;IAC/D,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa;CAC9D,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAI,QAAgB;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,IAAI,GAAG,cAAc;YAAE,OAAO,IAAI,CAAC;QAC5C,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,CACL,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC/C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC/C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC,CACjD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW;IAChD,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU;IACpD,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa;IAC9D,UAAU,EAAE,WAAW;CACxB,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,OAAe;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAChF,CAAC"}

package/tools/shared/build/index.d.ts

@@ -1,4 +1,5 @@
 export * from './types.js';
 export { McpServerBase } from './McpServerBase.js';
 export { ToolRegistry } from './ToolRegistry.js';
+export { safeReadJson, safeReadFile, isNextJsProject, isServerComponent, NEXTJS_ROUTE_FILES, DEFAULT_SKIP_DIRS, MAX_FILE_BYTES, } from './fs.js';
 //# sourceMappingURL=index.d.ts.map

package/tools/shared/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC"}

package/tools/shared/build/index.js

@@ -1,4 +1,5 @@
 export * from './types.js';
 export { McpServerBase } from './McpServerBase.js';
 export { ToolRegistry } from './ToolRegistry.js';
+export { safeReadJson, safeReadFile, isNextJsProject, isServerComponent, NEXTJS_ROUTE_FILES, DEFAULT_SKIP_DIRS, MAX_FILE_BYTES, } from './fs.js';
 //# sourceMappingURL=index.js.map

package/tools/shared/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,SAAS,CAAC"}

package/tools/shared/package.json

@@ -13,10 +13,11 @@
     "build": "tsc",
     "dev": "tsc --watch"
   },
-  "dependencies": {
+  "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0"
   },
   "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0"
   }

package/tools/storybook-generator/README.md

@@ -0,0 +1,39 @@
+# storybook-generator
+
+MCP server that auto-generates comprehensive Storybook stories for React components — Default, Playground, per-variant, per-size, callbacks, accessibility, and interactive play functions.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `generate_stories` | Generate `.stories.tsx` for a component file or directory |
+| `check_story_coverage` | Report which components have stories and which don't |
+
+## Usage
+
+```sh
+# Generate stories for a single component
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_stories","arguments":{"path":"src/components/Button.tsx"}}}' \
+  | node build/index.js
+
+# Check coverage across a directory
+echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"check_story_coverage","arguments":{"path":"src/components"}}}' \
+  | node build/index.js
+```
+
+## Generated stories include
+
+- `Default` — basic render with sensible defaults
+- `Playground` — full `argTypes` enabling Storybook controls
+- Per-variant stories (extracted from union types or `cva()`)
+- Per-size stories
+- `Disabled` / `Loading` states (when props exist)
+- `WithCallbacks` — `vi.fn()` handlers shown in Actions panel
+- `play` function for interactive components (button, input)
+
+## Build & test
+
+```sh
+npm run build
+npm test
+```

package/tools/storybook-generator/build/index.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+interface PropField {
+    name: string;
+    type: string;
+    optional: boolean;
+}
+export declare function extractPropsInterface(content: string, componentName: string): PropField[];
+export declare function extractVariantValues(content: string, key: 'variant' | 'size'): string[];
+export declare function propTypeToControl(propType: string): string;
+export declare function generateArgTypes(props: PropField[]): string;
+export declare function getMockValue(propName: string, propType: string, componentName: string): string | null;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/tools/storybook-generator/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AASA,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AA2CD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,EAAE,CAqBzF;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,CAwBvF;AAoCD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY1D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAY3D;AAMD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwDrG"}