@promptui-lib/mcp-agent 0.1.0

package/bin/agent.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+import { startAgent } from '../dist/index.js';
+
+startAgent().catch((error) => {
+  console.error('[PromptUI] Failed to start agent:', error.message);
+  process.exit(1);
+});

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { loadConfig, resolveConfig, validateConfig } from './load-config.js';
+export type { IResolvedConfig } from './load-config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7E,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1 @@
+export { loadConfig, resolveConfig, validateConfig } from './load-config.js';

package/dist/config/load-config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Config Loader
+ * Carrega configuração do projeto
+ */
+import type { IPromptUIConfig } from '@promptui-lib/core';
+export interface IResolvedConfig {
+    figmaToken: string;
+    figmaFileId: string;
+    outputBasePath: string;
+    port: number;
+}
+/**
+ * Carrega configuração do projeto
+ */
+export declare function loadConfig(cwd?: string): Promise<IPromptUIConfig | null>;
+/**
+ * Resolve configuração com valores padrão e env vars
+ */
+export declare function resolveConfig(config: IPromptUIConfig | null, envOverrides?: Partial<IResolvedConfig>): IResolvedConfig;
+/**
+ * Valida configuração resolvida
+ */
+export declare function validateConfig(config: IResolvedConfig): string[];
+//# sourceMappingURL=load-config.d.ts.map

package/dist/config/load-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-config.d.ts","sourceRoot":"","sources":["../../src/config/load-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAS1D,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAuCD;;GAEG;AACH,wBAAsB,UAAU,CAC9B,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAQjC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,YAAY,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GACtC,eAAe,CA+BjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAYhE"}

package/dist/config/load-config.js

@@ -0,0 +1,98 @@
+/**
+ * Config Loader
+ * Carrega configuração do projeto
+ */
+import { readFile, access } from 'node:fs/promises';
+import { join } from 'node:path';
+const CONFIG_FILES = [
+    'promptui.config.json',
+    'promptui.config.js',
+    '.promptuirc',
+    '.promptuirc.json',
+];
+/**
+ * Verifica se arquivo existe
+ */
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Carrega configuração de um arquivo JSON
+ */
+async function loadJsonConfig(path) {
+    try {
+        const content = await readFile(path, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Busca arquivo de configuração no diretório
+ */
+async function findConfigFile(dir) {
+    for (const file of CONFIG_FILES) {
+        const path = join(dir, file);
+        if (await fileExists(path)) {
+            return path;
+        }
+    }
+    return null;
+}
+/**
+ * Carrega configuração do projeto
+ */
+export async function loadConfig(cwd = process.cwd()) {
+    const configPath = await findConfigFile(cwd);
+    if (!configPath) {
+        return null;
+    }
+    return loadJsonConfig(configPath);
+}
+/**
+ * Resolve configuração com valores padrão e env vars
+ */
+export function resolveConfig(config, envOverrides) {
+    // Prioridade: env vars > config file > defaults
+    const figmaToken = envOverrides?.figmaToken ??
+        process.env.FIGMA_TOKEN ??
+        config?.figma?.token ??
+        '';
+    const figmaFileId = envOverrides?.figmaFileId ??
+        process.env.FIGMA_FILE_ID ??
+        config?.figma?.fileId ??
+        '';
+    const outputBasePath = envOverrides?.outputBasePath ??
+        process.env.PROMPTUI_OUTPUT_PATH ??
+        config?.output?.basePath ??
+        'src/components';
+    const port = envOverrides?.port ??
+        (process.env.PROMPTUI_PORT ? parseInt(process.env.PROMPTUI_PORT, 10) : null) ??
+        17890;
+    return {
+        figmaToken,
+        figmaFileId,
+        outputBasePath,
+        port,
+    };
+}
+/**
+ * Valida configuração resolvida
+ */
+export function validateConfig(config) {
+    const errors = [];
+    if (!config.figmaToken) {
+        errors.push('Missing FIGMA_TOKEN. Set via environment variable or config file.');
+    }
+    if (!config.figmaFileId) {
+        errors.push('Missing FIGMA_FILE_ID. Set via environment variable or config file.');
+    }
+    return errors;
+}

package/dist/handlers/generate-handler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generate Handler
+ * Orquestra o pipeline de geração: Figma → Parser → Codegen → Files
+ */
+import type { IGenerateRequest, IGenerateResponse } from '@promptui-lib/core';
+export interface IGenerateHandlerOptions {
+    request: IGenerateRequest;
+    figmaToken: string;
+    figmaFileId: string;
+    outputBasePath: string;
+}
+/**
+ * Handler principal de geração
+ */
+export declare function handleGenerate(options: IGenerateHandlerOptions): Promise<IGenerateResponse>;
+//# sourceMappingURL=generate-handler.d.ts.map

package/dist/handlers/generate-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-handler.d.ts","sourceRoot":"","sources":["../../src/handlers/generate-handler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAK9E,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CA6F5B"}

package/dist/handlers/generate-handler.js

@@ -0,0 +1,90 @@
+/**
+ * Generate Handler
+ * Orquestra o pipeline de geração: Figma → Parser → Codegen → Files
+ */
+import { createFigmaClient } from '@promptui-lib/figma-parser';
+import { parseNode } from '@promptui-lib/figma-parser';
+import { writeComponent, generateCode } from '@promptui-lib/codegen';
+/**
+ * Handler principal de geração
+ */
+export async function handleGenerate(options) {
+    const { request, figmaToken, figmaFileId, outputBasePath } = options;
+    const errors = [];
+    const warnings = [];
+    try {
+        console.log(`[PromptUI] Generating component for node: ${request.nodeId}`);
+        // 1. Busca node do Figma
+        const figmaClient = createFigmaClient({ token: figmaToken });
+        const fileId = request.fileId ?? figmaFileId;
+        const node = await figmaClient.getNode(fileId, request.nodeId);
+        if (!node) {
+            return {
+                success: false,
+                componentName: '',
+                layer: 'atoms',
+                files: { tsx: '', scss: '', index: '' },
+                outputPath: '',
+                errors: [`Node not found: ${request.nodeId}`],
+            };
+        }
+        console.log(`[PromptUI] Found node: ${node.name} (${node.type})`);
+        // 2. Parseia node para AST
+        const ast = parseNode(node, {
+            forceLayer: request.options?.layer,
+            componentName: request.options?.componentName,
+        });
+        console.log(`[PromptUI] Parsed: ${ast.name} (${ast.layer})`);
+        // 3. Se é preview, retorna apenas o código
+        if (request.options?.preview) {
+            const code = generateCode(ast);
+            return {
+                success: true,
+                componentName: ast.name,
+                layer: ast.layer,
+                files: { tsx: '', scss: '', index: '' },
+                outputPath: '',
+                code,
+                warnings,
+            };
+        }
+        // 4. Escreve arquivos
+        const basePath = request.outputPath ?? outputBasePath;
+        const writeResult = await writeComponent(ast, {
+            basePath,
+            forceOverwrite: request.options?.forceOverwrite,
+        });
+        if (!writeResult.success) {
+            return {
+                success: false,
+                componentName: ast.name,
+                layer: ast.layer,
+                files: writeResult.files,
+                outputPath: basePath,
+                errors: writeResult.errors,
+            };
+        }
+        console.log(`[PromptUI] Generated: ${writeResult.files.tsx}`);
+        return {
+            success: true,
+            componentName: ast.name,
+            layer: ast.layer,
+            files: writeResult.files,
+            outputPath: basePath,
+            warnings,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        errors.push(message);
+        console.error(`[PromptUI] Error:`, message);
+        return {
+            success: false,
+            componentName: '',
+            layer: 'atoms',
+            files: { tsx: '', scss: '', index: '' },
+            outputPath: '',
+            errors,
+        };
+    }
+}

package/dist/handlers/index.d.ts

@@ -0,0 +1,3 @@
+export { handleGenerate } from './generate-handler.js';
+export type { IGenerateHandlerOptions } from './generate-handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/handlers/index.js

@@ -0,0 +1 @@
+export { handleGenerate } from './generate-handler.js';

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @promptui-lib/mcp-agent
+ * MCP Agent server for PromptUI
+ */
+export * from './server/index.js';
+export * from './handlers/index.js';
+export * from './config/index.js';
+/**
+ * Inicia o agente MCP
+ */
+export declare function startAgent(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAElC;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAkDhD"}

package/dist/index.js

@@ -0,0 +1,57 @@
+/**
+ * @promptui-lib/mcp-agent
+ * MCP Agent server for PromptUI
+ */
+import { createHttpServer } from './server/index.js';
+import { loadConfig, resolveConfig, validateConfig } from './config/index.js';
+export * from './server/index.js';
+export * from './handlers/index.js';
+export * from './config/index.js';
+/**
+ * Inicia o agente MCP
+ */
+export async function startAgent() {
+    console.log('[PromptUI] Starting agent...');
+    // Carrega configuração
+    const config = await loadConfig();
+    const resolved = resolveConfig(config);
+    // Valida configuração
+    const errors = validateConfig(resolved);
+    if (errors.length > 0) {
+        console.error('[PromptUI] Configuration errors:');
+        for (const error of errors) {
+            console.error(`  - ${error}`);
+        }
+        console.error('\n[PromptUI] Create a promptui.config.json or set environment variables.');
+        console.error('Example config:');
+        console.error(JSON.stringify({
+            figma: {
+                token: 'your-figma-token',
+                fileId: 'your-file-id'
+            },
+            output: {
+                basePath: 'src/components'
+            }
+        }, null, 2));
+        process.exit(1);
+    }
+    // Cria e inicia servidor
+    const server = createHttpServer({
+        port: resolved.port,
+        figmaToken: resolved.figmaToken,
+        figmaFileId: resolved.figmaFileId,
+        outputBasePath: resolved.outputBasePath,
+    });
+    await server.start();
+    // Handle graceful shutdown
+    process.on('SIGINT', async () => {
+        console.log('\n[PromptUI] Shutting down...');
+        await server.stop();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        console.log('\n[PromptUI] Shutting down...');
+        await server.stop();
+        process.exit(0);
+    });
+}

package/dist/server/http-server.d.ts

@@ -0,0 +1,19 @@
+/**
+ * HTTP Server
+ * Expõe API REST para comunicação com o Figma Plugin
+ */
+export interface IServerConfig {
+    port: number;
+    figmaToken: string;
+    figmaFileId: string;
+    outputBasePath: string;
+}
+export interface IHttpServer {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+/**
+ * Cria o servidor HTTP
+ */
+export declare function createHttpServer(config: IServerConfig): IHttpServer;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/server/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../src/server/http-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAsCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CA2EnE"}

package/dist/server/http-server.js

@@ -0,0 +1,110 @@
+/**
+ * HTTP Server
+ * Expõe API REST para comunicação com o Figma Plugin
+ */
+import { createServer } from 'node:http';
+import { parse as parseUrl } from 'node:url';
+import { handleGenerate } from '../handlers/generate-handler.js';
+/**
+ * Parseia body JSON de uma request
+ */
+async function parseBody(req) {
+    return new Promise((resolve, reject) => {
+        let body = '';
+        req.on('data', (chunk) => {
+            body += chunk.toString();
+        });
+        req.on('end', () => {
+            try {
+                resolve(JSON.parse(body));
+            }
+            catch {
+                reject(new Error('Invalid JSON body'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+/**
+ * Envia resposta JSON
+ */
+function sendJson(res, status, data) {
+    res.writeHead(status, {
+        'Content-Type': 'application/json',
+        'Access-Control-Allow-Origin': '*',
+        'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+        'Access-Control-Allow-Headers': 'Content-Type',
+    });
+    res.end(JSON.stringify(data));
+}
+/**
+ * Cria o servidor HTTP
+ */
+export function createHttpServer(config) {
+    const server = createServer(async (req, res) => {
+        const { pathname } = parseUrl(req.url ?? '/', true);
+        const method = req.method ?? 'GET';
+        // CORS preflight
+        if (method === 'OPTIONS') {
+            res.writeHead(204, {
+                'Access-Control-Allow-Origin': '*',
+                'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+                'Access-Control-Allow-Headers': 'Content-Type',
+            });
+            res.end();
+            return;
+        }
+        try {
+            // Health check
+            if (pathname === '/health' && method === 'GET') {
+                sendJson(res, 200, { status: 'ok', version: '0.1.0' });
+                return;
+            }
+            // Generate component
+            if (pathname === '/generate' && method === 'POST') {
+                const body = await parseBody(req);
+                const result = await handleGenerate({
+                    request: body,
+                    figmaToken: config.figmaToken,
+                    figmaFileId: config.figmaFileId,
+                    outputBasePath: config.outputBasePath,
+                });
+                sendJson(res, result.success ? 200 : 400, result);
+                return;
+            }
+            // List available frames
+            if (pathname === '/frames' && method === 'GET') {
+                // TODO: implementar listagem de frames
+                sendJson(res, 200, { frames: [] });
+                return;
+            }
+            // 404
+            sendJson(res, 404, { error: 'Not found' });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            console.error('[PromptUI] Error:', message);
+            sendJson(res, 500, { error: message });
+        }
+    });
+    return {
+        start: () => new Promise((resolve) => {
+            server.listen(config.port, () => {
+                console.log(`[PromptUI] Agent running at http://localhost:${config.port}`);
+                console.log('[PromptUI] Endpoints:');
+                console.log(`  GET  /health   - Health check`);
+                console.log(`  POST /generate - Generate component from Figma node`);
+                console.log(`  GET  /frames   - List available frames`);
+                resolve();
+            });
+        }),
+        stop: () => new Promise((resolve, reject) => {
+            server.close((err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        }),
+    };
+}

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export { createHttpServer } from './http-server.js';
+export type { IServerConfig, IHttpServer } from './http-server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/server/index.js

@@ -0,0 +1 @@
+export { createHttpServer } from './http-server.js';

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@promptui-lib/mcp-agent",
+  "version": "0.1.0",
+  "private": false,
+  "description": "MCP Agent server for PromptUI - bridges Figma Plugin to code generation",
+  "license": "UNLICENSED",
+  "author": {
+    "name": "Desiree Menezes",
+    "url": "https://github.com/desireemenezes"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/desireemenezes/promptUI.git",
+    "directory": "packages/mcp-agent"
+  },
+  "homepage": "https://github.com/desireemenezes/promptUI#readme",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "promptui-agent": "./bin/agent.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "dependencies": {
+    "@promptui-lib/core": "0.1.0",
+    "@promptui-lib/figma-parser": "0.1.0",
+    "@promptui-lib/codegen": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0",
+    "rimraf": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "clean": "rimraf dist"
+  }
+}