@framingui/mcp-server 0.5.0

package/dist/data/component-registry.js

@@ -0,0 +1,320 @@
+/**
+ * Component Registry (SPEC-MCP-003)
+ * Static component metadata from @framingui/ui
+ *
+ * This registry provides metadata for all UI components
+ * organized by tier (1: Core, 2: Complex, 3: Advanced)
+ */
+/**
+ * All component metadata organized by tier
+ * Data extracted from @framingui/ui exports
+ */
+export const COMPONENT_CATALOG = [
+    // ========================================
+    // Tier 1: Core Components (15)
+    // ========================================
+    {
+        id: 'button',
+        name: 'Button',
+        category: 'core',
+        tier: 1,
+        description: 'Interactive button component with multiple variants and sizes',
+        variantsCount: 6,
+        hasSubComponents: false,
+    },
+    {
+        id: 'input',
+        name: 'Input',
+        category: 'core',
+        tier: 1,
+        description: 'Text input field with validation support',
+        variantsCount: 1,
+        hasSubComponents: false,
+    },
+    {
+        id: 'label',
+        name: 'Label',
+        category: 'core',
+        tier: 1,
+        description: 'Form label component with accessibility support',
+        variantsCount: 1,
+        hasSubComponents: false,
+    },
+    {
+        id: 'card',
+        name: 'Card',
+        category: 'core',
+        tier: 1,
+        description: 'Container card with header, content, and footer sections',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'badge',
+        name: 'Badge',
+        category: 'core',
+        tier: 1,
+        description: 'Badge component for status and labels',
+        variantsCount: 4,
+        hasSubComponents: false,
+    },
+    {
+        id: 'avatar',
+        name: 'Avatar',
+        category: 'core',
+        tier: 1,
+        description: 'Avatar component with image and fallback support',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'separator',
+        name: 'Separator',
+        category: 'core',
+        tier: 1,
+        description: 'Visual separator line component',
+        variantsCount: 2,
+        hasSubComponents: false,
+    },
+    {
+        id: 'checkbox',
+        name: 'Checkbox',
+        category: 'core',
+        tier: 1,
+        description: 'Checkbox input component with indeterminate state',
+        variantsCount: 1,
+        hasSubComponents: false,
+    },
+    {
+        id: 'radio-group',
+        name: 'RadioGroup',
+        category: 'core',
+        tier: 1,
+        description: 'Radio button group for single selection',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'switch',
+        name: 'Switch',
+        category: 'core',
+        tier: 1,
+        description: 'Toggle switch component for boolean states',
+        variantsCount: 1,
+        hasSubComponents: false,
+    },
+    {
+        id: 'textarea',
+        name: 'Textarea',
+        category: 'core',
+        tier: 1,
+        description: 'Multi-line text input area',
+        variantsCount: 1,
+        hasSubComponents: false,
+    },
+    {
+        id: 'skeleton',
+        name: 'Skeleton',
+        category: 'core',
+        tier: 1,
+        description: 'Loading skeleton placeholder component',
+        variantsCount: 1,
+        hasSubComponents: false,
+    },
+    {
+        id: 'scroll-area',
+        name: 'ScrollArea',
+        category: 'core',
+        tier: 1,
+        description: 'Custom scrollable area with styled scrollbar',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'form',
+        name: 'Form',
+        category: 'core',
+        tier: 1,
+        description: 'Form component with validation and error handling',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'select',
+        name: 'Select',
+        category: 'core',
+        tier: 1,
+        description: 'Dropdown select component with search support',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    // ========================================
+    // Tier 2: Complex Components (10)
+    // ========================================
+    {
+        id: 'dialog',
+        name: 'Dialog',
+        category: 'complex',
+        tier: 2,
+        description: 'Modal dialog component with overlay and animations',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'dropdown-menu',
+        name: 'DropdownMenu',
+        category: 'complex',
+        tier: 2,
+        description: 'Contextual dropdown menu with nested items',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'table',
+        name: 'Table',
+        category: 'complex',
+        tier: 2,
+        description: 'Data table component with sorting and pagination',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'tabs',
+        name: 'Tabs',
+        category: 'complex',
+        tier: 2,
+        description: 'Tabbed interface component with keyboard navigation',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'toast',
+        name: 'Toast',
+        category: 'complex',
+        tier: 2,
+        description: 'Toast notification system with queue management',
+        variantsCount: 4,
+        hasSubComponents: true,
+    },
+    {
+        id: 'tooltip',
+        name: 'Tooltip',
+        category: 'complex',
+        tier: 2,
+        description: 'Tooltip component with positioning and delay',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'popover',
+        name: 'Popover',
+        category: 'complex',
+        tier: 2,
+        description: 'Popover component with smart positioning',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'sheet',
+        name: 'Sheet',
+        category: 'complex',
+        tier: 2,
+        description: 'Slide-out panel component from screen edges',
+        variantsCount: 4,
+        hasSubComponents: true,
+    },
+    {
+        id: 'alert-dialog',
+        name: 'AlertDialog',
+        category: 'complex',
+        tier: 2,
+        description: 'Alert dialog for important confirmations',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'progress',
+        name: 'Progress',
+        category: 'complex',
+        tier: 2,
+        description: 'Progress bar component with percentage tracking',
+        variantsCount: 1,
+        hasSubComponents: false,
+    },
+    // ========================================
+    // Tier 3: Advanced Components (5)
+    // ========================================
+    {
+        id: 'sidebar',
+        name: 'Sidebar',
+        category: 'advanced',
+        tier: 3,
+        description: 'Collapsible sidebar navigation with sections and items',
+        variantsCount: 2,
+        hasSubComponents: true,
+    },
+    {
+        id: 'navigation-menu',
+        name: 'NavigationMenu',
+        category: 'advanced',
+        tier: 3,
+        description: 'Accessible navigation menu with dropdown support',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'breadcrumb',
+        name: 'Breadcrumb',
+        category: 'advanced',
+        tier: 3,
+        description: 'Breadcrumb navigation component with custom separators',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'command',
+        name: 'Command',
+        category: 'advanced',
+        tier: 3,
+        description: 'Command palette component with search and keyboard shortcuts',
+        variantsCount: 1,
+        hasSubComponents: true,
+    },
+    {
+        id: 'calendar',
+        name: 'Calendar',
+        category: 'advanced',
+        tier: 3,
+        description: 'Interactive calendar component with date selection',
+        variantsCount: 1,
+        hasSubComponents: false,
+    },
+];
+/**
+ * Get all components
+ */
+export function getAllComponents() {
+    return COMPONENT_CATALOG;
+}
+/**
+ * Get components by category
+ */
+export function getComponentsByCategory(category) {
+    return COMPONENT_CATALOG.filter(c => c.category === category);
+}
+/**
+ * Get component by ID
+ */
+export function getComponentById(id) {
+    return COMPONENT_CATALOG.find(c => c.id === id);
+}
+/**
+ * Search components by keyword
+ */
+export function searchComponents(keyword) {
+    const lowerKeyword = keyword.toLowerCase();
+    return COMPONENT_CATALOG.filter(c => c.id.includes(lowerKeyword) ||
+        c.name.toLowerCase().includes(lowerKeyword) ||
+        c.description.toLowerCase().includes(lowerKeyword));
+}
+//# sourceMappingURL=component-registry.js.map

package/dist/data/component-registry.js.map

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

package/dist/data/examples/screen-examples.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Example Screen Definitions for SPEC-MCP-004 Phase 3.5
+ * Provides reference examples for coding agents to generate screen definitions
+ */
+import type { ScreenExample } from '../../schemas/mcp-schemas.js';
+/**
+ * Team Grid Example
+ * A dashboard-style screen displaying team members in a grid layout
+ */
+export declare const teamGridExample: ScreenExample;
+/**
+ * Data Table Example
+ * A screen displaying data in a tabular format with filtering and sorting
+ */
+export declare const dataTableExample: ScreenExample;
+/**
+ * Login Form Example
+ * Authentication screen with email/password login
+ */
+export declare const loginFormExample: ScreenExample;
+/**
+ * Dashboard Overview Example
+ * Analytics dashboard with metrics cards and charts
+ */
+export declare const dashboardOverviewExample: ScreenExample;
+/**
+ * Get all example screen definitions
+ */
+export declare function getAllExamples(): ScreenExample[];
+/**
+ * Get examples matching a description
+ */
+export declare function getMatchingExamples(description: string, limit?: number): ScreenExample[];
+/**
+ * Get example by ID
+ */
+export declare function getExampleById(id: string): ScreenExample | undefined;
+//# sourceMappingURL=screen-examples.d.ts.map

package/dist/data/examples/screen-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-examples.d.ts","sourceRoot":"","sources":["../../../src/data/examples/screen-examples.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,aAyH7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAmF9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,aA2F9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,aA0HtC,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,IAAI,aAAa,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,aAAa,EAAE,CAkD3F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEpE"}