@framingui/mcp-server 0.5.0

package/dist/tools/validate-environment.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Validate Environment MCP Tool
+ * SPEC-MCP-005 Phase 2: Check if user's project has required NPM packages installed
+ * SPEC-MCP-005: Tailwind CSS 설정 검증 확장
+ */
+import type { ValidateEnvironmentInput, ValidateEnvironmentOutput } from '../schemas/mcp-schemas.js';
+/**
+ * Validate user's environment for required dependencies
+ *
+ * Compares required packages against installed packages in package.json
+ * and provides installation commands for missing packages.
+ * Optionally validates Tailwind CSS configuration for @framingui/ui compatibility.
+ *
+ * @param input - Project path and required packages to validate
+ * @returns Validation result with installed/missing packages and install commands
+ *
+ * @example
+ * ```typescript
+ * const result = await validateEnvironmentTool({
+ *   projectPath: '/path/to/project',
+ *   requiredPackages: ['framer-motion', 'react'],
+ *   checkTailwind: true
+ * });
+ *
+ * if (result.success && result.missing.length > 0) {
+ *   console.log(`Missing packages: ${result.missing.join(', ')}`);
+ *   console.log(`Install with: ${result.installCommands.npm}`);
+ * }
+ *
+ * if (result.tailwind?.issues.length) {
+ *   console.log('Tailwind issues:', result.tailwind.issues);
+ *   console.log('Fixes:', result.tailwind.fixes);
+ * }
+ * ```
+ */
+export declare function validateEnvironmentTool(input: ValidateEnvironmentInput): Promise<ValidateEnvironmentOutput>;
+//# sourceMappingURL=validate-environment.d.ts.map

package/dist/tools/validate-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-environment.d.ts","sourceRoot":"","sources":["../../src/tools/validate-environment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAKnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CAqGpC"}

package/dist/tools/validate-environment.js

@@ -0,0 +1,153 @@
+/**
+ * Validate Environment MCP Tool
+ * SPEC-MCP-005 Phase 2: Check if user's project has required NPM packages installed
+ * SPEC-MCP-005: Tailwind CSS 설정 검증 확장
+ */
+import { readPackageJson } from '../utils/package-json-reader.js';
+import { readTailwindConfig } from '../utils/tailwind-config-reader.js';
+import { extractErrorMessage } from '../utils/error-handler.js';
+/**
+ * Validate user's environment for required dependencies
+ *
+ * Compares required packages against installed packages in package.json
+ * and provides installation commands for missing packages.
+ * Optionally validates Tailwind CSS configuration for @framingui/ui compatibility.
+ *
+ * @param input - Project path and required packages to validate
+ * @returns Validation result with installed/missing packages and install commands
+ *
+ * @example
+ * ```typescript
+ * const result = await validateEnvironmentTool({
+ *   projectPath: '/path/to/project',
+ *   requiredPackages: ['framer-motion', 'react'],
+ *   checkTailwind: true
+ * });
+ *
+ * if (result.success && result.missing.length > 0) {
+ *   console.log(`Missing packages: ${result.missing.join(', ')}`);
+ *   console.log(`Install with: ${result.installCommands.npm}`);
+ * }
+ *
+ * if (result.tailwind?.issues.length) {
+ *   console.log('Tailwind issues:', result.tailwind.issues);
+ *   console.log('Fixes:', result.tailwind.fixes);
+ * }
+ * ```
+ */
+export async function validateEnvironmentTool(input) {
+    try {
+        const { projectPath, requiredPackages, checkTailwind } = input;
+        // Step 1: Read package.json from the project
+        const readResult = readPackageJson(projectPath);
+        if (!readResult.success || !readResult.installedPackages) {
+            return {
+                success: false,
+                error: readResult.error || 'Failed to read package.json',
+            };
+        }
+        const installedPackages = readResult.installedPackages;
+        // Step 2: Compare required packages with installed packages
+        const installed = {};
+        const missing = [];
+        for (const packageName of requiredPackages) {
+            const version = installedPackages[packageName];
+            if (version !== undefined) {
+                // Package is installed
+                installed[packageName] = version;
+            }
+            else {
+                // Package is missing
+                missing.push(packageName);
+            }
+        }
+        // Step 3: Generate install commands for missing packages
+        const installCommands = generateInstallCommands(missing);
+        // Step 4: Check for potential warnings (optional enhancement)
+        const warnings = [];
+        // Step 5: Tailwind CSS 설정 검증
+        let tailwind;
+        if (checkTailwind !== false) {
+            const tailwindResult = readTailwindConfig(projectPath);
+            const issues = [];
+            const fixes = [];
+            if (!tailwindResult.found) {
+                issues.push('tailwind.config.{ts,js,mjs,cjs} not found in project root');
+                fixes.push('Create a tailwind.config.ts file in your project root. ' +
+                    'See https://tailwindcss.com/docs/configuration for setup guide.');
+            }
+            else {
+                if (!tailwindResult.hasUiContentPath) {
+                    issues.push('tailwind.config content paths do not include @framingui/ui — ' +
+                        'component styles (Dialog, AlertDialog, Popover, etc.) will not be compiled');
+                    fixes.push("Add '../../packages/ui/src/**/*.{ts,tsx}' (monorepo) or " +
+                        "'node_modules/@framingui/ui/dist/**/*.{js,ts,jsx,tsx}' (standalone) " +
+                        'to the content array in your tailwind.config');
+                }
+                if (!tailwindResult.hasAnimatePlugin) {
+                    issues.push('tailwindcss-animate plugin is not configured — ' +
+                        'Radix UI component animations (Dialog open/close, Popover, Tooltip) will not work');
+                    fixes.push('Install tailwindcss-animate (npm install tailwindcss-animate) and add it to plugins array: ' +
+                        "import animate from 'tailwindcss-animate'; plugins: [animate]");
+                }
+            }
+            tailwind = {
+                configFound: tailwindResult.found,
+                configPath: tailwindResult.configPath,
+                hasUiContentPath: tailwindResult.hasUiContentPath,
+                hasAnimatePlugin: tailwindResult.hasAnimatePlugin,
+                issues,
+                fixes,
+            };
+        }
+        return {
+            success: true,
+            installed,
+            missing,
+            installCommands,
+            warnings: warnings.length > 0 ? warnings : undefined,
+            tailwind,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: extractErrorMessage(error),
+        };
+    }
+}
+/**
+ * Generate installation commands for multiple package managers
+ *
+ * @param packages - Array of package names to install
+ * @returns Install commands for npm, yarn, pnpm, and bun
+ *
+ * @example
+ * ```typescript
+ * const commands = generateInstallCommands(['react', 'react-dom']);
+ * // {
+ * //   npm: 'npm install react react-dom',
+ * //   yarn: 'yarn add react react-dom',
+ * //   pnpm: 'pnpm add react react-dom',
+ * //   bun: 'bun add react react-dom'
+ * // }
+ * ```
+ */
+function generateInstallCommands(packages) {
+    if (packages.length === 0) {
+        return {
+            npm: '',
+            yarn: '',
+            pnpm: '',
+            bun: '',
+        };
+    }
+    const packageList = packages.join(' ');
+    return {
+        npm: `npm install ${packageList}`,
+        yarn: `yarn add ${packageList}`,
+        pnpm: `pnpm add ${packageList}`,
+        bun: `bun add ${packageList}`,
+    };
+}
+//# sourceMappingURL=validate-environment.js.map

package/dist/tools/validate-environment.js.map

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

package/dist/tools/validate-screen-definition.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Validate Screen Definition MCP Tool
+ * SPEC-MCP-004 Phase 3.5: Validates screen definitions with helpful feedback
+ */
+import type { ValidateScreenDefinitionInput, ValidateScreenDefinitionOutput } from '../schemas/mcp-schemas.js';
+/**
+ * Validate Screen Definition tool implementation
+ */
+export declare function validateScreenDefinitionTool(input: ValidateScreenDefinitionInput): Promise<ValidateScreenDefinitionOutput>;
+//# sourceMappingURL=validate-screen-definition.d.ts.map

package/dist/tools/validate-screen-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-screen-definition.d.ts","sourceRoot":"","sources":["../../src/tools/validate-screen-definition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAK/B,MAAM,2BAA2B,CAAC;AAqgBnC;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,8BAA8B,CAAC,CA0HzC"}