@idealyst/mcp-server 1.0.92 → 1.0.94

package/{src/data/framework-guides.ts → dist/data/framework-guides.js}

@@ -1,5 +1,5 @@
-export const frameworkGuides: Record<string, string> = {
-  "idealyst://framework/getting-started": `# Getting Started with Idealyst
+export const frameworkGuides = {
+    "idealyst://framework/getting-started": `# Getting Started with Idealyst
 
 Idealyst is a modern, cross-platform framework for building React and React Native applications with a powerful component library, type-safe APIs, and monorepo tooling.
 
@@ -83,8 +83,7 @@ my-app/
 3. Define your API routes in \`packages/api\`
 4. Build your UI in \`packages/web\` or \`packages/mobile\`
 `,
-
-  "idealyst://framework/components-overview": `# Idealyst Components Overview
+    "idealyst://framework/components-overview": `# Idealyst Components Overview
 
 Idealyst provides a comprehensive library of cross-platform React components organized into categories.
 
@@ -185,8 +184,7 @@ All components use the Unistyles theming system:
 import { Button, Card, Text, View } from '@idealyst/components';
 \`\`\`
 `,
-
-  "idealyst://framework/theming": `# Theming Guide
+    "idealyst://framework/theming": `# Theming Guide
 
 Idealyst uses react-native-unistyles for cross-platform theming with full TypeScript support.
 
@@ -379,8 +377,7 @@ const styles = StyleSheet.create(theme => ({
 }));
 \`\`\`
 `,
-
-  "idealyst://framework/cli": `# Idealyst CLI Reference
+    "idealyst://framework/cli": `# Idealyst CLI Reference
 
 The Idealyst CLI provides commands for creating and managing Idealyst projects.
 
@@ -589,5 +586,307 @@ workspace/
 6. **Documentation**: Add README files to packages
 7. **Git**: Use conventional commits
 8. **Dependencies**: Share dependencies across packages when possible
+`,
+    "idealyst://framework/api-overview": `# API Architecture Overview
+
+Idealyst provides a dual API architecture with both tRPC and GraphQL, giving you flexibility for different use cases.
+
+## When to Use Each
+
+### tRPC (Type-Safe RPC)
+- **Best for**: Internal clients, same-team consumption
+- **Benefits**: End-to-end type safety, no code generation, fast development
+- **Use when**: Your frontend and backend are TypeScript
+
+### GraphQL
+- **Best for**: Public APIs, third-party integrations, mobile apps
+- **Benefits**: Flexible queries, schema documentation, wide ecosystem
+- **Use when**: You need schema introspection or have non-TypeScript clients
+
+## Architecture
+
+Both APIs run on the same Express server:
+
+\`\`\`
+Server (port 3000)
+├── /trpc/*    → tRPC handlers
+├── /graphql   → GraphQL Yoga endpoint
+└── Shared context (database, auth)
+\`\`\`
+
+## File Structure
+
+\`\`\`
+packages/api/src/
+├── routers/           # tRPC routers
+│   ├── index.ts       # Root router
+│   └── test.ts        # Example router
+├── graphql/           # GraphQL setup
+│   ├── builder.ts     # Pothos schema builder
+│   ├── index.ts       # Yoga server setup
+│   └── types/         # GraphQL type definitions
+│       └── test.ts    # Example types
+├── context.ts         # Shared context
+├── server.ts          # Express server
+└── index.ts           # Entry point
+\`\`\`
+
+## Shared Context
+
+Both APIs share the same context:
+
+\`\`\`typescript
+// context.ts
+export interface Context {
+  db: PrismaClient;
+  // Add auth, session, etc.
+}
+
+export async function createContext(): Promise<Context> {
+  return {
+    db: prisma,
+  };
+}
+\`\`\`
+
+## Client Setup
+
+The shared package provides clients for both:
+
+\`\`\`typescript
+// In your App component
+import { createTRPCClient, createGraphQLClient } from '@your-app/shared';
+
+// tRPC - automatic type inference
+const trpcClient = createTRPCClient({ apiUrl: 'http://localhost:3000/trpc' });
+
+// GraphQL - manual queries with graphql-request
+createGraphQLClient({ apiUrl: 'http://localhost:3000/graphql' });
+\`\`\`
+
+## Migration Path
+
+Start with tRPC for rapid development, add GraphQL when you need:
+- Public API documentation
+- Third-party integrations
+- Schema-first development
+- Non-TypeScript clients
+`,
+    "idealyst://framework/graphql-setup": `# GraphQL Setup Guide
+
+Idealyst uses Pothos (code-first schema) with GraphQL Yoga server, integrated with Prisma.
+
+## Server Setup
+
+### 1. Schema Builder (builder.ts)
+
+\`\`\`typescript
+import SchemaBuilder from '@pothos/core';
+import PrismaPlugin from '@pothos/plugin-prisma';
+import type PrismaTypes from './generated';
+import { prisma } from '@your-app/database';
+
+export const builder = new SchemaBuilder<{
+  PrismaTypes: PrismaTypes;
+  Context: { db: typeof prisma };
+}>({
+  plugins: [PrismaPlugin],
+  prisma: {
+    client: prisma,
+  },
+});
+
+// Initialize Query and Mutation types
+builder.queryType({});
+builder.mutationType({});
+\`\`\`
+
+### 2. Generate Prisma Types
+
+\`\`\`bash
+# In packages/api
+npx prisma generate --generator pothos
+\`\`\`
+
+Add to your prisma schema:
+
+\`\`\`prisma
+generator pothos {
+  provider = "prisma-pothos-types"
+  output   = "../src/graphql/generated.ts"
+}
+\`\`\`
+
+### 3. Define Types (types/example.ts)
+
+\`\`\`typescript
+import { builder } from '../builder';
+
+// Object type from Prisma model
+builder.prismaObject('Test', {
+  fields: (t) => ({
+    id: t.exposeID('id'),
+    name: t.exposeString('name'),
+    message: t.exposeString('message'),
+    status: t.exposeString('status'),
+    createdAt: t.expose('createdAt', { type: 'DateTime' }),
+  }),
+});
+
+// Input type for mutations
+const CreateTestInput = builder.inputType('CreateTestInput', {
+  fields: (t) => ({
+    name: t.string({ required: true }),
+    message: t.string({ required: true }),
+    status: t.string({ required: true }),
+  }),
+});
+
+// Query
+builder.queryField('tests', (t) =>
+  t.prismaField({
+    type: ['Test'],
+    args: {
+      take: t.arg.int(),
+      skip: t.arg.int(),
+    },
+    resolve: async (query, _root, args, ctx) =>
+      ctx.db.test.findMany({
+        ...query,
+        take: args.take ?? 10,
+        skip: args.skip ?? 0,
+        orderBy: { createdAt: 'desc' },
+      }),
+  })
+);
+
+// Mutation
+builder.mutationField('createTest', (t) =>
+  t.prismaField({
+    type: 'Test',
+    args: {
+      input: t.arg({ type: CreateTestInput, required: true }),
+    },
+    resolve: async (query, _root, args, ctx) =>
+      ctx.db.test.create({
+        ...query,
+        data: args.input,
+      }),
+  })
+);
+\`\`\`
+
+### 4. Yoga Server (index.ts)
+
+\`\`\`typescript
+import { createYoga } from 'graphql-yoga';
+import { builder } from './builder';
+import './types/test'; // Import all type definitions
+
+export const yoga = createYoga({
+  schema: builder.toSchema(),
+  graphqlEndpoint: '/graphql',
+});
+\`\`\`
+
+### 5. Mount in Express (server.ts)
+
+\`\`\`typescript
+import express from 'express';
+import { yoga } from './graphql';
+
+const app = express();
+
+// GraphQL endpoint
+app.use('/graphql', yoga);
+
+// tRPC endpoint
+app.use('/trpc', trpcMiddleware);
+\`\`\`
+
+## Client Setup
+
+### 1. GraphQL Client (shared/src/graphql/client.ts)
+
+\`\`\`typescript
+import { GraphQLClient } from 'graphql-request';
+
+let client: GraphQLClient | null = null;
+
+export function createGraphQLClient(config: { apiUrl: string }) {
+  client = new GraphQLClient(config.apiUrl);
+  return client;
+}
+
+export function getGraphQLClient(): GraphQLClient {
+  if (!client) throw new Error('GraphQL client not initialized');
+  return client;
+}
+
+export { gql } from 'graphql-request';
+\`\`\`
+
+### 2. Using with React Query
+
+\`\`\`typescript
+import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { getGraphQLClient, gql } from '../graphql/client';
+
+const TESTS_QUERY = gql\`
+  query GetTests($take: Int) {
+    tests(take: $take) {
+      id
+      name
+      message
+    }
+  }
+\`;
+
+const CREATE_TEST = gql\`
+  mutation CreateTest($input: CreateTestInput!) {
+    createTest(input: $input) {
+      id
+      name
+    }
+  }
+\`;
+
+// Query hook
+const { data, isLoading } = useQuery({
+  queryKey: ['graphql', 'tests'],
+  queryFn: () => getGraphQLClient().request(TESTS_QUERY, { take: 10 }),
+});
+
+// Mutation hook
+const queryClient = useQueryClient();
+const mutation = useMutation({
+  mutationFn: (input) => getGraphQLClient().request(CREATE_TEST, { input }),
+  onSuccess: () => {
+    queryClient.invalidateQueries({ queryKey: ['graphql', 'tests'] });
+  },
+});
+\`\`\`
+
+## GraphQL Playground
+
+Access the GraphQL playground at:
+\`\`\`
+http://localhost:3000/graphql
+\`\`\`
+
+Features:
+- Schema explorer
+- Query autocompletion
+- Documentation browser
+- Query history
+
+## Best Practices
+
+1. **Use Input Types**: Always use input types for mutations
+2. **Pagination**: Implement cursor-based pagination for lists
+3. **Error Handling**: Use Pothos error types
+4. **Authorization**: Add auth checks in resolvers
+5. **N+1 Prevention**: Use Prisma's query optimization
 `,
 };
+//# sourceMappingURL=framework-guides.js.map

package/dist/data/framework-guides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-guides.js","sourceRoot":"","sources":["../../src/data/framework-guides.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,sCAAsC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFzC;IAEC,0CAA0C,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoG7C;IAEC,8BAA8B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgMjC;IAEC,0BAA0B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiN7B;IAEC,mCAAmC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFtC;IAEC,oCAAoC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuNvC;CACA,CAAC"}

package/dist/data/icon-guide.d.ts

@@ -0,0 +1,2 @@
+export declare const iconGuide = "# Material Design Icons Reference\n\nIdealyst uses Material Design Icons (@mdi/react) with **7,447 icons** available.\n\n## Icon Usage\n\n### In Components\n\nIcons can be used by providing the icon name as a string:\n\n```tsx\nimport { Button, Icon, List, Badge } from '@idealyst/components';\n\n// Button with icon\n<Button icon=\"check\">Save</Button>\n\n// Standalone Icon\n<Icon name=\"home\" size=\"md\" color=\"primary\" />\n\n// List with icons\n<ListItem label=\"Settings\" leading=\"cog\" trailing=\"chevron-right\" />\n\n// Badge with icon\n<Badge icon=\"star\">Featured</Badge>\n```\n\n### Icon Properties\n\n```tsx\n<Icon\n  name=\"home\"                    // Icon name (required)\n  size=\"xs|sm|md|lg|xl|number\"   // Icon size\n  color=\"primary|secondary|...\"   // Theme color\n/>\n```\n\n## Common Icons by Category\n\n### Navigation & Actions\n- **home** - Home/dashboard\n- **menu** - Hamburger menu\n- **arrow-left** - Back/previous\n- **arrow-right** - Forward/next\n- **chevron-left** - Small back arrow\n- **chevron-right** - Small forward arrow\n- **chevron-up** - Collapse/up\n- **chevron-down** - Expand/down\n- **close** - Close/dismiss\n- **check** - Confirm/success\n- **plus** - Add/create\n- **minus** - Remove/subtract\n- **delete** - Delete/trash\n- **dots-vertical** - More options (vertical)\n- **dots-horizontal** - More options (horizontal)\n\n### User & Account\n- **account** - User profile\n- **account-circle** - User avatar\n- **account-multiple** - Multiple users/team\n- **account-plus** - Add user\n- **account-minus** - Remove user\n- **account-edit** - Edit profile\n- **account-cog** - User settings\n- **login** - Login/sign in\n- **logout** - Logout/sign out\n- **account-key** - Authentication\n\n### Communication\n- **email** - Email/mail\n- **email-outline** - Email outline variant\n- **message** - Message/chat\n- **message-text** - Text message\n- **message-reply** - Reply to message\n- **phone** - Phone/call\n- **bell** - Notifications\n- **bell-outline** - Notifications outline\n- **comment** - Comment/feedback\n- **forum** - Discussion/forum\n\n### File & Document\n- **file** - Generic file\n- **file-document** - Document\n- **file-pdf** - PDF file\n- **file-image** - Image file\n- **folder** - Folder\n- **folder-open** - Open folder\n- **download** - Download\n- **upload** - Upload\n- **attachment** - Attach file\n- **cloud-upload** - Cloud upload\n- **cloud-download** - Cloud download\n\n### Media\n- **play** - Play media\n- **pause** - Pause media\n- **stop** - Stop media\n- **skip-next** - Next track\n- **skip-previous** - Previous track\n- **volume-high** - High volume\n- **volume-low** - Low volume\n- **volume-off** - Muted\n- **image** - Picture/photo\n- **camera** - Camera\n- **video** - Video\n\n### Edit & Create\n- **pencil** - Edit\n- **pencil-outline** - Edit outline\n- **content-save** - Save\n- **content-copy** - Copy\n- **content-cut** - Cut\n- **content-paste** - Paste\n- **undo** - Undo\n- **redo** - Redo\n- **format-bold** - Bold text\n- **format-italic** - Italic text\n- **format-underline** - Underline text\n\n### Status & Alerts\n- **check-circle** - Success\n- **check-circle-outline** - Success outline\n- **alert** - Warning\n- **alert-circle** - Alert circle\n- **alert-octagon** - Critical alert\n- **information** - Information\n- **information-outline** - Info outline\n- **help-circle** - Help/question\n- **close-circle** - Error\n- **clock** - Time/pending\n\n### UI Elements\n- **magnify** - Search\n- **filter** - Filter\n- **sort** - Sort\n- **tune** - Settings/adjust\n- **cog** - Settings\n- **palette** - Theme/colors\n- **eye** - View/visible\n- **eye-off** - Hidden\n- **heart** - Favorite/like\n- **heart-outline** - Like outline\n- **star** - Star/rating\n- **star-outline** - Star outline\n- **bookmark** - Bookmark\n- **bookmark-outline** - Bookmark outline\n\n### Shopping & Commerce\n- **cart** - Shopping cart\n- **cart-outline** - Cart outline\n- **cash** - Money/payment\n- **credit-card** - Credit card\n- **tag** - Tag/label\n- **sale** - Sale/discount\n- **receipt** - Receipt\n- **store** - Store/shop\n\n### Social\n- **share** - Share\n- **share-variant** - Share variant\n- **thumb-up** - Like/upvote\n- **thumb-down** - Dislike/downvote\n- **emoticon** - Emoji/mood\n- **emoticon-happy** - Happy\n- **emoticon-sad** - Sad\n\n### Location & Map\n- **map** - Map\n- **map-marker** - Location pin\n- **navigation** - Navigation\n- **compass** - Compass\n- **earth** - Globe/world\n\n### Calendar & Time\n- **calendar** - Calendar\n- **calendar-today** - Today\n- **calendar-month** - Month view\n- **clock-outline** - Clock\n- **timer** - Timer\n\n### Device & Hardware\n- **laptop** - Laptop\n- **cellphone** - Mobile phone\n- **tablet** - Tablet\n- **desktop-mac** - Desktop\n- **monitor** - Monitor\n- **printer** - Printer\n- **wifi** - WiFi\n- **bluetooth** - Bluetooth\n\n### Weather\n- **weather-sunny** - Sunny\n- **weather-cloudy** - Cloudy\n- **weather-rainy** - Rainy\n- **weather-snowy** - Snowy\n- **weather-night** - Night\n- **white-balance-sunny** - Light mode\n- **weather-night** - Dark mode\n\n## Finding Icons\n\n### Total Available Icons\n**7,447 icons** from Material Design Icons\n\n### Browse All Icons\nVisit: https://pictogrammers.com/library/mdi/\n\n### Search Patterns\nIcons follow naming patterns:\n- Base name: `home`, `account`, `file`\n- Variants: `-outline`, `-filled`, `-off`, `-plus`, `-minus`\n- Combinations: `account-plus`, `file-document-outline`\n\n### Common Suffixes\n- **-outline**: Outline version\n- **-off**: Disabled/off state\n- **-plus**: Add/create\n- **-minus**: Remove/subtract\n- **-edit**: Edit action\n- **-check**: Verified/checked\n- **-alert**: Warning state\n\n## Icon Naming Tips\n\n1. **Be Specific**: Use descriptive names\n   - \u2705 `account-circle` for user avatar\n   - \u274C `user` (not available)\n\n2. **Check Variants**: Try outline versions\n   - `email` and `email-outline`\n   - `heart` and `heart-outline`\n\n3. **Common Prefixes**:\n   - `account-*`: User-related\n   - `file-*`: File-related\n   - `folder-*`: Folder-related\n   - `arrow-*`: Arrows\n   - `chevron-*`: Small arrows\n   - `content-*`: Content actions\n\n4. **Use Hyphens**: Icon names use kebab-case\n   - \u2705 `arrow-left`\n   - \u274C `arrowLeft` or `arrow_left`\n\n## Best Practices\n\n1. **Semantic Meaning**: Choose icons that match their function\n2. **Consistency**: Use the same icon for the same action throughout the app\n3. **Size Appropriately**: Match icon size to context\n4. **Color Purposefully**: Use theme colors for semantic meaning\n5. **Accessibility**: Always provide labels/tooltips for icon-only buttons\n\n## Examples\n\n### Button Icons\n```tsx\n<Button icon=\"content-save\">Save</Button>\n<Button icon=\"delete\" intent=\"error\">Delete</Button>\n<Button icon=\"pencil\">Edit</Button>\n<Button icon=\"plus\">Add New</Button>\n```\n\n### List Icons\n```tsx\n<ListItem label=\"Dashboard\" leading=\"view-dashboard\" />\n<ListItem label=\"Users\" leading=\"account-multiple\" />\n<ListItem label=\"Settings\" leading=\"cog\" />\n<ListItem label=\"Logout\" leading=\"logout\" intent=\"error\" />\n```\n\n### Navigation Icons\n```tsx\n<Button icon=\"arrow-left\" variant=\"text\">Back</Button>\n<Button icon=\"menu\" variant=\"text\">Menu</Button>\n<Button icon=\"close\" variant=\"text\">Close</Button>\n```\n\n### Status Icons\n```tsx\n<Icon name=\"check-circle\" color=\"success\" />\n<Icon name=\"alert-circle\" color=\"warning\" />\n<Icon name=\"close-circle\" color=\"error\" />\n<Icon name=\"information-outline\" color=\"primary\" />\n```\n";
+//# sourceMappingURL=icon-guide.d.ts.map

package/dist/data/icon-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-guide.d.ts","sourceRoot":"","sources":["../../src/data/icon-guide.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,8+OA2RrB,CAAC"}

package/{src/data/icon-guide.ts → dist/data/icon-guide.js}

@@ -282,3 +282,4 @@ Icons follow naming patterns:
 <Icon name="information-outline" color="primary" />
 \`\`\`
 `;
+//# sourceMappingURL=icon-guide.js.map

package/dist/data/icon-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-guide.js","sourceRoot":"","sources":["../../src/data/icon-guide.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2RxB,CAAC"}