@framingui/mcp-server 0.5.5 → 0.6.0

package/dist/__tests__/cache.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MemoryCache 테스트
+ * SPEC-MCP-007:S-004 - getStale() 메서드: TTL 만료 후에도 캐시 값 반환
+ */
+export {};
+//# sourceMappingURL=cache.test.d.ts.map

package/dist/__tests__/cache.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/cache.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/__tests__/cache.test.js

@@ -0,0 +1,86 @@
+/**
+ * MemoryCache 테스트
+ * SPEC-MCP-007:S-004 - getStale() 메서드: TTL 만료 후에도 캐시 값 반환
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+// vitest에서 .js 확장자는 dist 파일을 참조할 수 있으므로 .ts 확장자로 직접 import
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore
+import { MemoryCache } from '../auth/cache.ts';
+describe('MemoryCache', () => {
+    let cache;
+    beforeEach(() => {
+        cache = new MemoryCache();
+        vi.useRealTimers();
+    });
+    describe('set / get (기본 동작)', () => {
+        it('TTL 이내에 get()으로 값을 반환한다', () => {
+            cache.set('key1', 'value1', 10_000);
+            expect(cache.get('key1')).toBe('value1');
+        });
+        it('존재하지 않는 키에 대해 null을 반환한다', () => {
+            expect(cache.get('non-existent')).toBeNull();
+        });
+        it('TTL 만료 후 get()은 null을 반환한다', () => {
+            vi.useFakeTimers();
+            cache.set('key2', 'expired', 1_000);
+            // TTL(1초) 이후로 시간 이동
+            vi.advanceTimersByTime(1_001);
+            expect(cache.get('key2')).toBeNull();
+            vi.useRealTimers();
+        });
+    });
+    describe('getStale()', () => {
+        it('TTL 이내에 getStale()은 값을 반환한다', () => {
+            cache.set('key3', 'fresh', 10_000);
+            expect(cache.getStale('key3')).toBe('fresh');
+        });
+        it('TTL 만료 후에도 getStale()은 값을 반환한다 (stale 허용)', () => {
+            vi.useFakeTimers();
+            cache.set('key4', 'stale-value', 500);
+            // TTL 만료
+            vi.advanceTimersByTime(1_000);
+            // getStale()은 만료 후에도 값을 반환해야 한다
+            // 주의: get()을 먼저 호출하면 만료된 항목이 삭제됨
+            expect(cache.getStale('key4')).toBe('stale-value');
+            // get()은 만료된 항목을 삭제하고 null을 반환한다
+            const freshCache = new MemoryCache();
+            freshCache.set('key4b', 'stale-value-b', 500);
+            vi.advanceTimersByTime(1_000);
+            expect(freshCache.get('key4b')).toBeNull();
+            // get() 호출 후에는 항목이 삭제되어 getStale()도 null 반환
+            expect(freshCache.getStale('key4b')).toBeNull();
+            vi.useRealTimers();
+        });
+        it('키가 설정된 적 없으면 getStale()은 null을 반환한다', () => {
+            expect(cache.getStale('never-set')).toBeNull();
+        });
+        it('delete() 후 getStale()은 null을 반환한다', () => {
+            cache.set('key5', 'to-delete', 10_000);
+            cache.delete('key5');
+            expect(cache.getStale('key5')).toBeNull();
+        });
+    });
+    describe('delete / clear', () => {
+        it('delete()로 특정 키를 제거한다', () => {
+            cache.set('key6', 'val6', 10_000);
+            cache.delete('key6');
+            expect(cache.get('key6')).toBeNull();
+        });
+        it('clear()로 모든 캐시를 비운다', () => {
+            cache.set('a', 'aa', 10_000);
+            cache.set('b', 'bb', 10_000);
+            cache.clear();
+            expect(cache.size()).toBe(0);
+        });
+    });
+    describe('size()', () => {
+        it('항목 추가 수만큼 size()가 증가한다', () => {
+            expect(cache.size()).toBe(0);
+            cache.set('s1', 'v1', 10_000);
+            cache.set('s2', 'v2', 10_000);
+            expect(cache.size()).toBe(2);
+        });
+    });
+});
+//# sourceMappingURL=cache.test.js.map

package/dist/__tests__/cache.test.js.map

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

package/dist/__tests__/data-client.test.d.ts

@@ -0,0 +1,13 @@
+/**
+ * data-client.ts 테스트
+ * SPEC-MCP-007 Phase 2 - fetchTemplateList, fetchTemplate, fetchComponentList,
+ * fetchComponent, fetchTokenList, fetchCSSVariables, fetchScreenExamples
+ *
+ * 테스트 시나리오:
+ * 1. 캐시 미스: fetch 호출 → 결과 반환
+ * 2. API 실패 + 캐시 없음: 빈 배열/null 반환
+ * 3. 인증 없음: fetch 호출 없이 빈 배열/null 반환
+ * 4. URL 파라미터 전달 확인
+ */
+export {};
+//# sourceMappingURL=data-client.test.d.ts.map

package/dist/__tests__/data-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/data-client.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/__tests__/data-client.test.js

@@ -0,0 +1,323 @@
+/**
+ * data-client.ts 테스트
+ * SPEC-MCP-007 Phase 2 - fetchTemplateList, fetchTemplate, fetchComponentList,
+ * fetchComponent, fetchTokenList, fetchCSSVariables, fetchScreenExamples
+ *
+ * 테스트 시나리오:
+ * 1. 캐시 미스: fetch 호출 → 결과 반환
+ * 2. API 실패 + 캐시 없음: 빈 배열/null 반환
+ * 3. 인증 없음: fetch 호출 없이 빈 배열/null 반환
+ * 4. URL 파라미터 전달 확인
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+// ─────────────────────────────────────────────────────────────────────────────
+// vi.mock 호이스팅: factory 안에서 참조할 mock 함수를 vi.hoisted()로 선언
+// ─────────────────────────────────────────────────────────────────────────────
+const { mockGetAuthData, mockGetRawApiKey, mockResolveFraminguiApiUrl } = vi.hoisted(() => ({
+    mockGetAuthData: vi.fn(),
+    mockGetRawApiKey: vi.fn(),
+    mockResolveFraminguiApiUrl: vi.fn(),
+}));
+// data-client.ts가 .js 확장자로 import하므로 mock도 동일 경로 사용
+vi.mock('../auth/state.js', () => ({
+    getAuthData: mockGetAuthData,
+    getRawApiKey: mockGetRawApiKey,
+}));
+vi.mock('../utils/api-url.js', () => ({
+    resolveFraminguiApiUrl: mockResolveFraminguiApiUrl,
+}));
+vi.mock('../utils/logger.js', () => ({
+    info: vi.fn(),
+    error: vi.fn(),
+}));
+// MemoryCache를 mock으로 교체 - 캐시가 항상 miss인 상태로 테스트
+// (data-client.ts의 스코프에서 MemoryCache new 호출 결과를 제어)
+vi.mock('../auth/cache.js', () => {
+    return {
+        MemoryCache: vi.fn().mockImplementation(() => ({
+            get: vi.fn().mockReturnValue(null), // 캐시 미스
+            getStale: vi.fn().mockReturnValue(null), // stale 캐시도 없음
+            set: vi.fn(),
+            delete: vi.fn(),
+            clear: vi.fn(),
+            size: vi.fn().mockReturnValue(0),
+        })),
+    };
+});
+// global fetch 목업
+const mockFetch = vi.fn();
+global.fetch = mockFetch;
+// ─────────────────────────────────────────────────────────────────────────────
+// 테스트 대상 import (.ts 확장자로 직접 import해서 최신 소스 사용)
+// ─────────────────────────────────────────────────────────────────────────────
+import { fetchTemplateList, fetchTemplate, fetchComponentList, fetchComponent, fetchTokenList, fetchCSSVariables, fetchScreenExamples, } from '../api/data-client.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// 헬퍼
+// ─────────────────────────────────────────────────────────────────────────────
+function makeOkResponse(body) {
+    return {
+        ok: true,
+        status: 200,
+        json: vi.fn().mockResolvedValue(body),
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// 공통 beforeEach
+// ─────────────────────────────────────────────────────────────────────────────
+beforeEach(() => {
+    vi.clearAllMocks();
+    mockGetAuthData.mockReturnValue({ valid: true });
+    mockGetRawApiKey.mockReturnValue('tk_live_test_key_00000000000000000000000000000000000000000000000000000000000000000');
+    mockResolveFraminguiApiUrl.mockReturnValue({ apiUrl: 'https://framingui.com' });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// fetchTemplateList
+// ─────────────────────────────────────────────────────────────────────────────
+describe('fetchTemplateList()', () => {
+    it('API 성공 시 템플릿 목록을 반환한다', async () => {
+        const templates = [
+            {
+                id: 'dashboard',
+                name: 'Dashboard',
+                category: 'web',
+                description: '',
+                requiredComponentsCount: 3,
+            },
+        ];
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, templates }));
+        const result = await fetchTemplateList();
+        expect(result).toHaveLength(1);
+        expect(result[0].id).toBe('dashboard');
+        expect(mockFetch).toHaveBeenCalledOnce();
+    });
+    it('category 파라미터를 쿼리스트링으로 전달한다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, templates: [] }));
+        await fetchTemplateList({ category: 'mobile' });
+        const calledUrl = mockFetch.mock.calls[0][0];
+        expect(calledUrl).toContain('category=mobile');
+    });
+    it('search 파라미터를 쿼리스트링으로 전달한다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, templates: [] }));
+        await fetchTemplateList({ search: 'login' });
+        const calledUrl = mockFetch.mock.calls[0][0];
+        expect(calledUrl).toContain('search=login');
+    });
+    it('API 실패 시 빈 배열을 반환한다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: false, error: 'not found' }));
+        const result = await fetchTemplateList();
+        expect(result).toEqual([]);
+    });
+    it('fetch 네트워크 오류 시 빈 배열을 반환한다', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('Network error'));
+        const result = await fetchTemplateList();
+        expect(result).toEqual([]);
+    });
+    it('인증 없는 상태에서 빈 배열을 반환한다', async () => {
+        mockGetAuthData.mockReturnValue(null);
+        const result = await fetchTemplateList();
+        expect(result).toEqual([]);
+        expect(mockFetch).not.toHaveBeenCalled();
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// fetchTemplate
+// ─────────────────────────────────────────────────────────────────────────────
+describe('fetchTemplate()', () => {
+    it('API 성공 시 템플릿 상세를 반환한다', async () => {
+        const template = { id: 'dashboard', name: 'Dashboard', sections: [] };
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, template }));
+        const result = await fetchTemplate('dashboard');
+        expect(result).not.toBeNull();
+        expect(result.id).toBe('dashboard');
+    });
+    it('API 실패 시 null을 반환한다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: false, error: 'not found' }));
+        const result = await fetchTemplate('nonexistent');
+        expect(result).toBeNull();
+    });
+    it('fetch 네트워크 오류 시 null을 반환한다', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('timeout'));
+        const result = await fetchTemplate('dashboard');
+        expect(result).toBeNull();
+    });
+    it('ID가 URL 인코딩되어 전달된다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, template: { id: 'my template' } }));
+        await fetchTemplate('my template');
+        const calledUrl = mockFetch.mock.calls[0][0];
+        expect(calledUrl).toContain('my%20template');
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// fetchComponentList
+// ─────────────────────────────────────────────────────────────────────────────
+describe('fetchComponentList()', () => {
+    it('API 성공 시 컴포넌트 목록을 반환한다', async () => {
+        const components = [
+            {
+                id: 'button',
+                name: 'Button',
+                category: 'core',
+                tier: 1,
+                description: '',
+                variantsCount: 6,
+                hasSubComponents: false,
+            },
+        ];
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, components }));
+        const result = await fetchComponentList();
+        expect(result).toHaveLength(1);
+        expect(result[0].id).toBe('button');
+    });
+    it('API 실패 시 빈 배열을 반환한다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: false }));
+        const result = await fetchComponentList();
+        expect(result).toEqual([]);
+    });
+    it('fetch 네트워크 오류 시 빈 배열을 반환한다', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('Network error'));
+        const result = await fetchComponentList();
+        expect(result).toEqual([]);
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// fetchComponent
+// ─────────────────────────────────────────────────────────────────────────────
+describe('fetchComponent()', () => {
+    it('API 성공 시 컴포넌트 상세를 반환한다', async () => {
+        const component = {
+            id: 'button',
+            name: 'Button',
+            category: 'core',
+            tier: 1,
+            description: 'Button desc',
+            variantsCount: 6,
+            hasSubComponents: false,
+            props: [],
+            variants: [],
+        };
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, component }));
+        const result = await fetchComponent('button');
+        expect(result).not.toBeNull();
+        expect(result?.id).toBe('button');
+        expect(result?.props).toBeDefined();
+    });
+    it('API 실패 시 null을 반환한다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: false, error: 'not found' }));
+        const result = await fetchComponent('nonexistent');
+        expect(result).toBeNull();
+    });
+    it('fetch 네트워크 오류 시 null을 반환한다', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('timeout'));
+        const result = await fetchComponent('button');
+        expect(result).toBeNull();
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// fetchTokenList
+// ─────────────────────────────────────────────────────────────────────────────
+describe('fetchTokenList()', () => {
+    it('type=all 요청 시 shells/pages/sections 포함 응답을 반환한다', async () => {
+        const responseBody = {
+            success: true,
+            shells: [{ id: 'shell.web.dashboard' }],
+            pages: [{ id: 'page.dashboard' }],
+            sections: [{ id: 'section.container' }],
+            metadata: { total: 3 },
+        };
+        mockFetch.mockResolvedValueOnce(makeOkResponse(responseBody));
+        const result = await fetchTokenList('all');
+        expect(result.metadata.total).toBe(3);
+        expect(result.shells).toHaveLength(1);
+        expect(result.pages).toHaveLength(1);
+        expect(result.sections).toHaveLength(1);
+    });
+    it('type=shell 쿼리파라미터가 전달된다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, shells: [], metadata: { total: 0 } }));
+        await fetchTokenList('shell');
+        const calledUrl = mockFetch.mock.calls[0][0];
+        expect(calledUrl).toContain('type=shell');
+    });
+    it('API 실패 시 빈 metadata를 반환한다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: false }));
+        const result = await fetchTokenList('all');
+        expect(result.metadata.total).toBe(0);
+        expect(result.shells).toBeUndefined();
+    });
+    it('tokenType 미지정 시 type=all로 요청된다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, metadata: { total: 0 } }));
+        await fetchTokenList();
+        const calledUrl = mockFetch.mock.calls[0][0];
+        expect(calledUrl).toContain('type=all');
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// fetchCSSVariables
+// ─────────────────────────────────────────────────────────────────────────────
+describe('fetchCSSVariables()', () => {
+    it('API 성공 시 CSS 문자열을 반환한다', async () => {
+        const css = ':root { --color-brand-500: oklch(0.5 0.2 240); }';
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, css }));
+        const result = await fetchCSSVariables('square-minimalism');
+        expect(result).toBe(css);
+        expect(result).toContain(':root');
+    });
+    it('API 실패 시 null을 반환한다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: false, error: 'not found' }));
+        const result = await fetchCSSVariables('nonexistent');
+        expect(result).toBeNull();
+    });
+    it('fetch 네트워크 오류 시 null을 반환한다', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('timeout'));
+        const result = await fetchCSSVariables('square-minimalism');
+        expect(result).toBeNull();
+    });
+    it('themeId와 /css 경로가 URL에 포함된다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, css: ':root {}' }));
+        await fetchCSSVariables('dark-boldness');
+        const calledUrl = mockFetch.mock.calls[0][0];
+        expect(calledUrl).toContain('dark-boldness');
+        expect(calledUrl).toContain('/css');
+    });
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// fetchScreenExamples
+// ─────────────────────────────────────────────────────────────────────────────
+describe('fetchScreenExamples()', () => {
+    it('API 성공 시 스크린 예제 목록을 반환한다', async () => {
+        const examples = [
+            { name: 'Team Grid', description: 'Grid layout', definition: { id: 'team-grid' } },
+            { name: 'Login Form', description: 'Auth screen', definition: { id: 'login-screen' } },
+        ];
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, examples }));
+        const result = await fetchScreenExamples();
+        expect(result).toHaveLength(2);
+        expect(result[0].name).toBe('Team Grid');
+        expect(result[1].definition.id).toBe('login-screen');
+    });
+    it('API 실패 시 빈 배열을 반환한다', async () => {
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: false }));
+        const result = await fetchScreenExamples();
+        expect(result).toEqual([]);
+    });
+    it('fetch 네트워크 오류 시 빈 배열을 반환한다', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('Network error'));
+        const result = await fetchScreenExamples();
+        expect(result).toEqual([]);
+    });
+    it('응답 예제에 name, description, definition이 포함된다', async () => {
+        const examples = [
+            {
+                name: 'Dashboard',
+                description: 'Analytics',
+                definition: { id: 'dashboard-overview', shell: 'shell.web.dashboard' },
+            },
+        ];
+        mockFetch.mockResolvedValueOnce(makeOkResponse({ success: true, examples }));
+        const result = await fetchScreenExamples();
+        expect(result[0]).toHaveProperty('name');
+        expect(result[0]).toHaveProperty('description');
+        expect(result[0]).toHaveProperty('definition');
+        expect(result[0].definition.shell).toBe('shell.web.dashboard');
+    });
+});
+//# sourceMappingURL=data-client.test.js.map

package/dist/__tests__/data-client.test.js.map

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

package/dist/api/data-client.d.ts

@@ -0,0 +1,124 @@
+/**
+ * MCP 서버 API 데이터 클라이언트
+ * 로컬 파일 시스템 읽기를 framingui.com API fetch로 대체
+ *
+ * 기존 인프라 재사용:
+ * - resolveFraminguiApiUrl(): base URL 결정
+ * - getAuthData(): API key 가져오기
+ * - MemoryCache: 인메모리 캐시 (TTL: 10분)
+ */
+export interface ThemeMeta {
+    id: string;
+    name: string;
+    description?: string;
+    brandTone: string;
+    schemaVersion: string;
+}
+export interface IconLibMeta {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    license: string;
+    totalIcons: number;
+    categories: string[];
+}
+export interface ComponentMeta {
+    id: string;
+    name: string;
+    category: string;
+    tier: number;
+    description: string;
+    variantsCount: number;
+    hasSubComponents: boolean;
+}
+export interface ComponentDetail extends ComponentMeta {
+    props?: any[];
+    variants?: any[];
+    subComponents?: string[];
+    importStatement?: string;
+    dependencies?: {
+        internal: string[];
+        external: string[];
+    };
+    examples?: any[];
+    accessibility?: string;
+}
+export interface TemplateMeta {
+    id: string;
+    name: string;
+    category: string;
+    description: string;
+    requiredComponentsCount: number;
+    layoutType?: string;
+    version?: string;
+    tags?: string[];
+}
+export interface TokenListResponse {
+    shells?: any[];
+    pages?: any[];
+    sections?: any[];
+    metadata: {
+        total: number;
+    };
+}
+export interface ScreenExample {
+    name: string;
+    description: string;
+    definition: any;
+}
+/**
+ * 테마 목록 조회 (라이선스 보유 테마만)
+ */
+export declare function fetchThemeList(): Promise<ThemeMeta[]>;
+/**
+ * 단일 테마 상세 조회 (전체 ThemeV2 JSON)
+ */
+export declare function fetchTheme(themeId: string): Promise<any | null>;
+/**
+ * 아이콘 라이브러리 목록 조회
+ */
+export declare function fetchIconLibraryList(): Promise<IconLibMeta[]>;
+/**
+ * 단일 아이콘 라이브러리 상세 조회 (전체 IconLibrary JSON)
+ */
+export declare function fetchIconLibrary(libraryId: string): Promise<any | null>;
+/**
+ * 스크린 템플릿 목록 조회
+ * [SPEC-MCP-007:E-001]
+ */
+export declare function fetchTemplateList(params?: {
+    category?: string;
+    search?: string;
+}): Promise<TemplateMeta[]>;
+/**
+ * 단일 스크린 템플릿 상세 조회
+ * [SPEC-MCP-007:E-002]
+ */
+export declare function fetchTemplate(templateId: string): Promise<any | null>;
+/**
+ * UI 컴포넌트 목록 조회 (전체 카탈로그)
+ * [SPEC-MCP-007:E-003]
+ */
+export declare function fetchComponentList(): Promise<ComponentMeta[]>;
+/**
+ * 단일 컴포넌트 상세 정보 조회 (props + variants + examples 포함)
+ * [SPEC-MCP-007:E-004]
+ */
+export declare function fetchComponent(componentId: string): Promise<ComponentDetail | null>;
+/**
+ * 레이아웃 토큰 목록 조회 (shell / page / section)
+ * [SPEC-MCP-007:E-005]
+ */
+export declare function fetchTokenList(tokenType?: 'shell' | 'page' | 'section' | 'all'): Promise<TokenListResponse>;
+/**
+ * 테마 CSS 변수 문자열 조회
+ * [SPEC-MCP-007:E-006]
+ */
+export declare function fetchCSSVariables(themeId: string): Promise<string | null>;
+/**
+ * 스크린 예제 정의 목록 조회
+ * [SPEC-MCP-007:E-007]
+ */
+export declare function fetchScreenExamples(): Promise<ScreenExample[]>;
+//# sourceMappingURL=data-client.d.ts.map

package/dist/api/data-client.d.ts.map

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