@framingui/mcp-server 0.6.26 → 0.6.28

package/dist/data/component-fallback-catalog.js

@@ -0,0 +1,149 @@
+const web = (id, name, category, description, options = {}) => ({
+    id,
+    name,
+    category,
+    tier: options.tier ?? (category === 'advanced' ? 3 : category === 'complex' ? 2 : 1),
+    description,
+    props: options.props ?? [],
+    variants: options.variants,
+    subComponents: options.subComponents,
+    importStatement: options.importStatement ?? `import { ${name} } from '@framingui/ui';`,
+    dependencies: options.dependencies ?? {
+        internal: ['@framingui/ui'],
+        external: ['react'],
+    },
+    examples: options.examples ?? [
+        { title: `${name} example`, code: `import { ${name} } from '@framingui/ui';` },
+    ],
+    accessibility: options.accessibility ?? 'Follow FramingUI semantics and ARIA guidance.',
+});
+const fallbackComponents = [
+    web('button', 'Button', 'core', 'Action button for primary and secondary actions.', {
+        props: [
+            { name: 'variant', type: 'string', required: false, defaultValue: 'default' },
+            { name: 'size', type: 'string', required: false, defaultValue: 'default' },
+            { name: 'disabled', type: 'boolean', required: false, defaultValue: 'false' },
+        ],
+        variants: [
+            { name: 'variant', value: 'default' },
+            { name: 'variant', value: 'secondary' },
+            { name: 'variant', value: 'outline' },
+        ],
+        examples: [
+            {
+                title: 'Primary button',
+                code: 'import { Button } from \'@framingui/ui\';\n<Button variant="default">Continue</Button>',
+            },
+        ],
+    }),
+    web('input', 'Input', 'core', 'Single-line form input control.'),
+    web('textarea', 'Textarea', 'core', 'Multi-line form input control.'),
+    web('checkbox', 'Checkbox', 'core', 'Checkbox form control.'),
+    web('switch', 'Switch', 'core', 'Toggle switch control.'),
+    web('badge', 'Badge', 'core', 'Status label or metadata badge.'),
+    web('avatar', 'Avatar', 'core', 'Avatar primitive for people and organizations.'),
+    web('heading', 'Heading', 'core', 'Heading and title typography component.'),
+    web('text', 'Text', 'core', 'Body and supporting typography component.'),
+    web('link', 'Link', 'core', 'Navigational text link component.'),
+    web('separator', 'Separator', 'core', 'Visual separator between sections or controls.'),
+    web('label', 'Label', 'core', 'Form label component.'),
+    web('icon', 'Icon', 'core', 'Icon wrapper for system icons.'),
+    web('progress', 'Progress', 'core', 'Progress indicator component.'),
+    web('slider', 'Slider', 'core', 'Range slider control.'),
+    web('radio-group', 'RadioGroup', 'core', 'Single-select radio control group.'),
+    web('card', 'Card', 'complex', 'Surface container with header, content, and footer slots.', {
+        subComponents: ['CardHeader', 'CardContent', 'CardFooter'],
+        importStatement: "import { Card, CardHeader, CardContent, CardFooter } from '@framingui/ui';",
+    }),
+    web('dialog', 'Dialog', 'complex', 'Modal dialog and overlay surface.', {
+        description: 'Modal dialog component with overlay, trigger, and content areas.',
+        subComponents: ['DialogTrigger', 'DialogContent', 'DialogHeader', 'DialogFooter'],
+        importStatement: "import { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogFooter } from '@framingui/ui';",
+    }),
+    web('popover', 'Popover', 'complex', 'Anchored floating surface for contextual content.'),
+    web('select', 'Select', 'complex', 'Select input with trigger and option list.'),
+    web('tabs', 'Tabs', 'complex', 'Tabs container for segmenting related content.'),
+    web('table', 'Table', 'complex', 'Structured data table surface.'),
+    web('form', 'Form', 'complex', 'Composable form wrapper and field grouping.', {
+        props: [{ name: 'control', type: 'Control', required: true }],
+    }),
+    web('list', 'List', 'complex', 'List layout primitive for repeated rows.'),
+    web('dropdown-menu', 'DropdownMenu', 'complex', 'Menu surface for contextual actions.'),
+    web('navigation-menu', 'NavigationMenu', 'complex', 'Composable navigation menu surface.'),
+    web('toast', 'Toast', 'complex', 'Transient feedback notification surface.'),
+    web('sheet', 'Sheet', 'complex', 'Side sheet / drawer overlay surface.'),
+    web('calendar', 'Calendar', 'advanced', 'Date-picker and calendar grid surface.'),
+    web('command', 'Command', 'advanced', 'Command palette surface for search-driven actions.'),
+    web('chart', 'Chart', 'advanced', 'Chart and visualization wrapper.'),
+    web('data-table', 'DataTable', 'advanced', 'Rich data table with sorting and filtering.'),
+    web('file-upload', 'FileUpload', 'advanced', 'File upload and dropzone surface.'),
+];
+export function listFallbackWebComponents(options = {}) {
+    const { category = 'all', search } = options;
+    const lowerSearch = search?.toLowerCase();
+    return fallbackComponents
+        .filter(component => (category === 'all' ? true : component.category === category))
+        .filter(component => {
+        if (!lowerSearch) {
+            return true;
+        }
+        return (component.id.includes(lowerSearch) ||
+            component.name.toLowerCase().includes(lowerSearch) ||
+            component.description.toLowerCase().includes(lowerSearch));
+    })
+        .map(component => ({
+        id: component.id,
+        name: component.name,
+        category: component.category,
+        description: component.description,
+        variantsCount: component.variants?.length ?? 0,
+        hasSubComponents: Boolean(component.subComponents?.length),
+        tier: component.tier,
+        platforms: ['web'],
+        platformSupport: {
+            reactNative: {
+                supported: false,
+                recommended: false,
+                status: 'avoid',
+            },
+        },
+    }));
+}
+export function getFallbackWebComponent(componentId) {
+    return fallbackComponents.find(component => component.id === componentId);
+}
+export function buildFallbackWebPreview(componentId) {
+    const component = getFallbackWebComponent(componentId);
+    if (!component) {
+        return null;
+    }
+    return {
+        success: true,
+        component: {
+            id: component.id,
+            name: component.name,
+            category: component.category,
+            description: component.description,
+            tier: component.tier,
+            props: component.props ?? [],
+            variants: component.variants,
+            subComponents: component.subComponents,
+            importStatement: component.importStatement ?? `import { ${component.name} } from '@framingui/ui';`,
+            dependencies: component.dependencies,
+            examples: component.examples,
+            accessibility: component.accessibility,
+            platformSupport: {
+                target: 'web',
+                supported: true,
+                recommended: true,
+                status: 'full',
+                notes: ['Use @framingui/ui for the canonical web component surface.'],
+                recommendedImports: [
+                    component.importStatement ?? `import { ${component.name} } from '@framingui/ui';`,
+                ],
+                recommendedPackages: ['@framingui/ui', 'react'],
+            },
+        },
+    };
+}
+//# sourceMappingURL=component-fallback-catalog.js.map

package/dist/data/component-fallback-catalog.js.map

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

package/dist/data/component-props.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared Component Props Data Module
+ * 실제 @framingui/ui 컴포넌트에서 추출한 Tier 1 (15개 core) props/variants 데이터
+ *
+ * 사용처:
+ * - preview-component.ts: 컴포넌트 상세 정보 제공
+ * - get-screen-generation-context.ts: 인라인 props 컨텍스트 제공
+ * - validate-screen-definition.ts: props 유효성 검증
+ */
+import type { PropDefinition, Variant, UsageExample } from '../schemas/mcp-schemas.js';
+export interface ComponentPropsData {
+    props: PropDefinition[];
+    variants?: Variant[];
+    subComponents?: string[];
+    dependencies: {
+        internal: string[];
+        external: string[];
+    };
+    examples?: UsageExample[];
+    accessibility?: string;
+}
+/**
+ * 컴포넌트 ID로 props 데이터 조회
+ */
+export declare function getComponentPropsData(componentId: string): ComponentPropsData | undefined;
+/**
+ * 모든 컴포넌트 props 데이터가 있는 컴포넌트 ID 목록 반환
+ */
+export declare function getComponentIdsWithProps(): string[];
+//# sourceMappingURL=component-props.d.ts.map

package/dist/data/component-props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-props.d.ts","sourceRoot":"","sources":["../../src/data/component-props.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACzD,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAuhBD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEzF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD"}