@idealyst/mcp-server 1.0.87 → 1.0.88

package/scripts/validate-examples.ts

@@ -0,0 +1,142 @@
+#!/usr/bin/env tsx
+
+/**
+ * Validate Examples Script
+ *
+ * Validates all example TypeScript files against the actual component types
+ * to ensure they are type-correct and will compile.
+ */
+
+import { Project, Diagnostic } from 'ts-morph';
+import * as path from 'path';
+import * as fs from 'fs';
+import chalk from 'chalk';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+interface ValidationResult {
+  file: string;
+  success: boolean;
+  errors: string[];
+}
+
+async function main() {
+  console.log('🔍 Validating TypeScript examples...\n');
+
+  const project = new Project({
+    tsConfigFilePath: path.join(__dirname, '../tsconfig.examples.json'),
+  });
+
+  const examplesDir = path.join(__dirname, '../examples');
+
+  if (!fs.existsSync(examplesDir)) {
+    console.log(chalk.yellow('⚠️  No examples directory found. Skipping validation.'));
+    process.exit(0);
+  }
+
+  // Find all example files
+  const exampleFiles = findExampleFiles(examplesDir);
+
+  if (exampleFiles.length === 0) {
+    console.log(chalk.yellow('⚠️  No example files found. Skipping validation.'));
+    process.exit(0);
+  }
+
+  console.log(`Found ${exampleFiles.length} example files\n`);
+
+  // Add all example files to the project
+  for (const filePath of exampleFiles) {
+    project.addSourceFileAtPath(filePath);
+  }
+
+  // Get diagnostics (type errors)
+  const diagnostics = project.getPreEmitDiagnostics();
+
+  const results: ValidationResult[] = [];
+
+  // Group diagnostics by file
+  const diagnosticsByFile = new Map<string, Diagnostic[]>();
+  for (const diagnostic of diagnostics) {
+    const sourceFile = diagnostic.getSourceFile();
+    if (sourceFile) {
+      const filePath = sourceFile.getFilePath();
+      if (!diagnosticsByFile.has(filePath)) {
+        diagnosticsByFile.set(filePath, []);
+      }
+      diagnosticsByFile.get(filePath)!.push(diagnostic);
+    }
+  }
+
+  // Create results for each file
+  for (const filePath of exampleFiles) {
+    const relativePath = path.relative(process.cwd(), filePath);
+    const fileDiagnostics = diagnosticsByFile.get(filePath) || [];
+
+    const errors = fileDiagnostics.map(diagnostic => {
+      const message = diagnostic.getMessageText();
+      const line = diagnostic.getLineNumber();
+      return `Line ${line}: ${typeof message === 'string' ? message : message.getMessageText()}`;
+    });
+
+    results.push({
+      file: relativePath,
+      success: errors.length === 0,
+      errors,
+    });
+  }
+
+  // Print results
+  let hasErrors = false;
+
+  for (const result of results) {
+    if (result.success) {
+      console.log(chalk.green('✅'), result.file);
+    } else {
+      hasErrors = true;
+      console.log(chalk.red('❌'), result.file);
+      for (const error of result.errors) {
+        console.log(chalk.red('   '), error);
+      }
+      console.log();
+    }
+  }
+
+  console.log('\n📊 Summary:');
+  const successCount = results.filter(r => r.success).length;
+  const failCount = results.filter(r => !r.success).length;
+
+  console.log(`   ${chalk.green('✅ Passed:')} ${successCount}`);
+  console.log(`   ${chalk.red('❌ Failed:')} ${failCount}`);
+
+  if (hasErrors) {
+    console.log(chalk.red('\n❌ Validation failed. Please fix the type errors above.'));
+    process.exit(1);
+  } else {
+    console.log(chalk.green('\n✅ All examples are type-correct!'));
+  }
+}
+
+function findExampleFiles(dir: string): string[] {
+  const files: string[] = [];
+
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+
+    if (entry.isDirectory()) {
+      files.push(...findExampleFiles(fullPath));
+    } else if (entry.name.endsWith('.tsx') || entry.name.endsWith('.ts')) {
+      files.push(fullPath);
+    }
+  }
+
+  return files;
+}
+
+main().catch(error => {
+  console.error(chalk.red('❌ Validation script failed:'), error);
+  process.exit(1);
+});

package/src/data/components/Icon.ts

@@ -2,7 +2,7 @@ export const Icon = {
   category: "display",
   description: "Material Design icon display component with size and color variants",
       props: `
-- \`name\`: IconName | `mdi:${IconName}` - The name of the icon to display
+- \`name\`: IconName | 'mdi:\${IconName}' - The name of the icon to display
 - \`size\`: IconSizeVariant - The size variant of the icon
 - \`color\`: Color - Predefined color variant based on theme
 - \`intent\`: Intent - Intent variant for the icon

package/src/data/components/index.ts

@@ -28,6 +28,7 @@ export { SVGImage } from './SVGImage.js';
 export { Switch } from './Switch.js';
 export { TabBar } from './TabBar.js';
 export { Table } from './Table.js';
+export { Tabs } from './Tabs.js';
 export { Text } from './Text.js';
 export { TextArea } from './TextArea.js';
 export { Tooltip } from './Tooltip.js';
@@ -64,6 +65,7 @@ import { SVGImage } from './SVGImage.js';
 import { Switch } from './Switch.js';
 import { TabBar } from './TabBar.js';
 import { Table } from './Table.js';
+import { Tabs } from './Tabs.js';
 import { Text } from './Text.js';
 import { TextArea } from './TextArea.js';
 import { Tooltip } from './Tooltip.js';

package/src/index.ts

@@ -14,11 +14,18 @@ import { frameworkGuides } from "./data/framework-guides.js";
 import { navigationGuides } from "./data/navigation-guides.js";
 import { iconGuide } from "./data/icon-guide.js";
 import iconsData from "./data/icons.json" with { type: "json" };
+import {
+  getComponentTypes,
+  getThemeTypes,
+  getNavigationTypes,
+  getAvailableComponents,
+  getComponentExamples,
+} from "./tools/get-types.js";
 
 const server = new Server(
   {
     name: "@idealyst/mcp-server",
-    version: "1.0.87",
+    version: "1.0.88",
   },
   {
     capabilities: {
@@ -122,6 +129,67 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["query"],
         },
       },
+      {
+        name: "get_component_types",
+        description: "Get TypeScript type definitions for a specific component directly from the source. Returns the actual TypeScript interface and/or JSON schema.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            component: {
+              type: "string",
+              description: "The name of the component (e.g., 'Button', 'Card', 'Input')",
+            },
+            format: {
+              type: "string",
+              description: "Output format: 'typescript' for raw TypeScript definitions, 'json' for parsed schema, 'both' for combined output (default: 'both')",
+              enum: ["typescript", "json", "both"],
+            },
+          },
+          required: ["component"],
+        },
+      },
+      {
+        name: "get_theme_types",
+        description: "Get TypeScript type definitions for theme types (Size, Intent, Color, etc.) directly from @idealyst/theme",
+        inputSchema: {
+          type: "object",
+          properties: {
+            format: {
+              type: "string",
+              description: "Output format: 'typescript', 'json', or 'both' (default: 'both')",
+              enum: ["typescript", "json", "both"],
+            },
+          },
+        },
+      },
+      {
+        name: "get_navigation_types",
+        description: "Get TypeScript type definitions for navigation types directly from @idealyst/navigation",
+        inputSchema: {
+          type: "object",
+          properties: {
+            format: {
+              type: "string",
+              description: "Output format: 'typescript', 'json', or 'both' (default: 'both')",
+              enum: ["typescript", "json", "both"],
+            },
+          },
+        },
+      },
+      {
+        name: "get_component_examples_ts",
+        description: "Get validated TypeScript example code for a component. These examples are type-checked and guaranteed to compile.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            component: {
+              type: "string",
+              description: "The name of the component (e.g., 'Button', 'Card')",
+            },
+          },
+          required: ["component"],
+        },
+      },
     ],
   };
 });
@@ -353,6 +421,118 @@ ${command.examples.map((ex: string) => `\`\`\`bash\n${ex}\n\`\`\``).join("\n\n")
       };
     }
 
+    case "get_component_types": {
+      const componentName = args?.component as string;
+      const format = (args?.format as 'typescript' | 'json' | 'both') || 'both';
+
+      try {
+        const result = getComponentTypes(componentName, format);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            },
+          ],
+        };
+      }
+    }
+
+    case "get_theme_types": {
+      const format = (args?.format as 'typescript' | 'json' | 'both') || 'both';
+
+      try {
+        const result = getThemeTypes(format);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            },
+          ],
+        };
+      }
+    }
+
+    case "get_navigation_types": {
+      const format = (args?.format as 'typescript' | 'json' | 'both') || 'both';
+
+      try {
+        const result = getNavigationTypes(format);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(result, null, 2),
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            },
+          ],
+        };
+      }
+    }
+
+    case "get_component_examples_ts": {
+      const componentName = args?.component as string;
+
+      try {
+        const examples = getComponentExamples(componentName);
+        if (!examples) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `No TypeScript examples found for component "${componentName}". Available components with examples: ${getAvailableComponents().join(', ')}`,
+              },
+            ],
+          };
+        }
+
+        return {
+          content: [
+            {
+              type: "text",
+              text: examples,
+            },
+          ],
+        };
+      } catch (error) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            },
+          ],
+        };
+      }
+    }
+
     default:
       return {
         content: [

package/src/tools/get-types.ts

@@ -0,0 +1,169 @@
+/**
+ * Get Types Tool
+ *
+ * Returns TypeScript type definitions for Idealyst components, theme, and navigation.
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+interface TypesData {
+  version: string;
+  extractedAt: string;
+  components: Record<string, any>;
+  theme: Record<string, any>;
+  navigation: Record<string, any>;
+}
+
+let cachedTypes: TypesData | null = null;
+
+/**
+ * Load extracted types from JSON file
+ */
+function loadTypes(): TypesData {
+  if (cachedTypes) {
+    return cachedTypes;
+  }
+
+  const typesPath = path.join(__dirname, '../generated/types.json');
+
+  if (!fs.existsSync(typesPath)) {
+    throw new Error(
+      'Types file not found. Please run "yarn extract-types" to generate type definitions.'
+    );
+  }
+
+  const content = fs.readFileSync(typesPath, 'utf-8');
+  cachedTypes = JSON.parse(content);
+
+  return cachedTypes!;
+}
+
+/**
+ * Get component types by name
+ */
+export function getComponentTypes(componentName: string, format: 'typescript' | 'json' | 'both' = 'both') {
+  const types = loadTypes();
+  const component = types.components[componentName];
+
+  if (!component) {
+    throw new Error(
+      `Component "${componentName}" not found. Available components: ${Object.keys(types.components).join(', ')}`
+    );
+  }
+
+  const result: any = {
+    component: componentName,
+  };
+
+  if (format === 'typescript' || format === 'both') {
+    result.typescript = formatTypeScriptOutput(component);
+  }
+
+  if (format === 'json' || format === 'both') {
+    result.schema = {
+      propsInterface: component.propsInterface,
+      props: component.props,
+      relatedTypes: component.relatedTypes,
+    };
+  }
+
+  return result;
+}
+
+/**
+ * Get theme types
+ */
+export function getThemeTypes(format: 'typescript' | 'json' | 'both' = 'both') {
+  const types = loadTypes();
+
+  const result: any = {
+    name: 'Theme Types',
+  };
+
+  if (format === 'typescript' || format === 'both') {
+    const tsOutput = Object.entries(types.theme)
+      .map(([name, info]: [string, any]) => info.definition)
+      .join('\n\n');
+    result.typescript = tsOutput;
+  }
+
+  if (format === 'json' || format === 'both') {
+    result.schema = types.theme;
+  }
+
+  return result;
+}
+
+/**
+ * Get navigation types
+ */
+export function getNavigationTypes(format: 'typescript' | 'json' | 'both' = 'both') {
+  const types = loadTypes();
+
+  const result: any = {
+    name: 'Navigation Types',
+  };
+
+  if (format === 'typescript' || format === 'both') {
+    const tsOutput = Object.entries(types.navigation)
+      .map(([name, definition]) => definition)
+      .join('\n\n');
+    result.typescript = tsOutput;
+  }
+
+  if (format === 'json' || format === 'both') {
+    result.schema = types.navigation;
+  }
+
+  return result;
+}
+
+/**
+ * Format TypeScript output for better readability
+ */
+function formatTypeScriptOutput(component: any): string {
+  const sections: string[] = [];
+
+  // Main props interface
+  sections.push(`// ${component.propsInterface}`);
+  sections.push(component.typeDefinition);
+
+  // Related types
+  if (Object.keys(component.relatedTypes).length > 0) {
+    sections.push('\n// Related Types');
+    for (const [name, definition] of Object.entries(component.relatedTypes)) {
+      sections.push(definition as string);
+    }
+  }
+
+  return sections.join('\n\n');
+}
+
+/**
+ * Get list of all available components
+ */
+export function getAvailableComponents() {
+  const types = loadTypes();
+  return Object.keys(types.components);
+}
+
+/**
+ * Get examples for a component
+ */
+export function getComponentExamples(componentName: string): string | null {
+  const examplesPath = path.join(
+    __dirname,
+    `../../examples/components/${componentName}.examples.tsx`
+  );
+
+  if (!fs.existsSync(examplesPath)) {
+    return null;
+  }
+
+  return fs.readFileSync(examplesPath, 'utf-8');
+}

package/tsconfig.examples.json

@@ -0,0 +1,14 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "jsx": "react",
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true
+  },
+  "include": [
+    "examples/**/*"
+  ]
+}

package/dist/data/cli-commands.d.ts

@@ -1,2 +0,0 @@
-export declare const cliCommands: Record<string, any>;
-//# sourceMappingURL=cli-commands.d.ts.map

package/dist/data/cli-commands.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-commands.d.ts","sourceRoot":"","sources":["../../src/data/cli-commands.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAsG3C,CAAC"}

package/dist/data/cli-commands.js

@@ -1,100 +0,0 @@
-export const cliCommands = {
-    init: {
-        description: "Initialize a new Idealyst workspace with monorepo structure",
-        usage: "idealyst init <workspace-name> [options]",
-        options: [
-            {
-                flag: "workspace-name",
-                description: "Name for the new workspace (required)",
-            },
-            {
-                flag: "--git",
-                description: "Initialize git repository (default: true)",
-            },
-            {
-                flag: "--install",
-                description: "Install dependencies after creation (default: true)",
-            },
-        ],
-        examples: [
-            "idealyst init my-app",
-            "idealyst init my-company-workspace --no-git",
-        ],
-    },
-    create: {
-        description: "Create a new package within the Idealyst workspace",
-        usage: "idealyst create <name> --type <type> [options]",
-        options: [
-            {
-                flag: "name",
-                description: "Name for the new package (required)",
-            },
-            {
-                flag: "--type",
-                description: "Package type: web | native | api | database | shared (required)",
-            },
-            {
-                flag: "--app-name",
-                description: "Display name for native app (required for native type)",
-            },
-            {
-                flag: "--with-trpc",
-                description: "Include tRPC setup (for web/native)",
-            },
-            {
-                flag: "--no-trpc",
-                description: "Exclude tRPC setup (for web/native)",
-            },
-        ],
-        examples: [
-            "idealyst create web --type web --with-trpc",
-            "idealyst create mobile --type native --app-name \"My App\" --with-trpc",
-            "idealyst create api --type api",
-            "idealyst create database --type database",
-            "idealyst create shared --type shared",
-        ],
-    },
-    dev: {
-        description: "Start development server for a package",
-        usage: "cd packages/<name> && yarn dev",
-        options: [
-            {
-                flag: "--port",
-                description: "Port number for dev server (web only)",
-            },
-        ],
-        examples: [
-            "cd packages/web && yarn dev",
-            "cd packages/native && yarn dev",
-        ],
-    },
-    build: {
-        description: "Build a package for production",
-        usage: "cd packages/<name> && yarn build",
-        options: [],
-        examples: [
-            "cd packages/web && yarn build",
-            "cd packages/api && yarn build",
-        ],
-    },
-    test: {
-        description: "Run tests for packages",
-        usage: "yarn test [options]",
-        options: [
-            {
-                flag: "--watch",
-                description: "Run tests in watch mode",
-            },
-            {
-                flag: "--coverage",
-                description: "Generate coverage report",
-            },
-        ],
-        examples: [
-            "yarn test",
-            "yarn test:watch",
-            "yarn test:coverage",
-        ],
-    },
-};
-//# sourceMappingURL=cli-commands.js.map

package/dist/data/cli-commands.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli-commands.js","sourceRoot":"","sources":["../../src/data/cli-commands.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAwB;IAC9C,IAAI,EAAE;QACJ,WAAW,EAAE,6DAA6D;QAC1E,KAAK,EAAE,0CAA0C;QACjD,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,uCAAuC;aACrD;YACD;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,2CAA2C;aACzD;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,qDAAqD;aACnE;SACF;QACD,QAAQ,EAAE;YACR,sBAAsB;YACtB,6CAA6C;SAC9C;KACF;IAED,MAAM,EAAE;QACN,WAAW,EAAE,oDAAoD;QACjE,KAAK,EAAE,gDAAgD;QACvD,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,qCAAqC;aACnD;YACD;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iEAAiE;aAC/E;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,wDAAwD;aACtE;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,qCAAqC;aACnD;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,qCAAqC;aACnD;SACF;QACD,QAAQ,EAAE;YACR,4CAA4C;YAC5C,wEAAwE;YACxE,gCAAgC;YAChC,0CAA0C;YAC1C,sCAAsC;SACvC;KACF;IAED,GAAG,EAAE;QACH,WAAW,EAAE,wCAAwC;QACrD,KAAK,EAAE,gCAAgC;QACvC,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;SACF;QACD,QAAQ,EAAE;YACR,6BAA6B;YAC7B,gCAAgC;SACjC;KACF;IAED,KAAK,EAAE;QACL,WAAW,EAAE,gCAAgC;QAC7C,KAAK,EAAE,kCAAkC;QACzC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE;YACR,+BAA+B;YAC/B,+BAA+B;SAChC;KACF;IAED,IAAI,EAAE;QACJ,WAAW,EAAE,wBAAwB;QACrC,KAAK,EAAE,qBAAqB;QAC5B,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,yBAAyB;aACvC;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,0BAA0B;aACxC;SACF;QACD,QAAQ,EAAE;YACR,WAAW;YACX,iBAAiB;YACjB,oBAAoB;SACrB;KACF;CACF,CAAC"}

package/dist/data/components/Accordion.d.ts

@@ -1,15 +0,0 @@
-export declare const Accordion: {
-    category: string;
-    description: string;
-    props: string;
-    features: string[];
-    bestPractices: string[];
-    usage: string;
-    examples: {
-        basic: string;
-        variants: string;
-        "with-icons": string;
-        interactive: string;
-    };
-};
-//# sourceMappingURL=Accordion.d.ts.map

package/dist/data/components/Accordion.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Accordion.d.ts","sourceRoot":"","sources":["../../../src/data/components/Accordion.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS;;;;;;;;;;;;;CAiHrB,CAAC"}