figma-to-code-agent 0.6.0 → 0.7.0

package/dist/version/VersionManager.js

@@ -0,0 +1,400 @@
+"use strict";
+/**
+ * 版本管理系统
+ * 管理代码生成的版本历史，支持版本回滚和差异对比
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const uuid_1 = require("uuid");
+/**
+ * 版本管理器
+ */
+class VersionManager {
+    constructor(projectRoot) {
+        this.versions = new Map();
+        this.versionsDir = path.join(projectRoot, '.figma-versions');
+        this.ensureVersionsDir();
+        this.loadVersions();
+    }
+    /**
+     * 创建新版本
+     */
+    async createVersion(files, config, description = 'Auto-generated version') {
+        const version = {
+            id: (0, uuid_1.v4)(),
+            timestamp: new Date(),
+            description,
+            files,
+            config,
+            metadata: {
+                parentVersionId: this.currentVersionId,
+                stats: this.calculateStats(files),
+            },
+        };
+        // 保存版本
+        await this.saveVersion(version);
+        // 更新内存中的版本列表
+        this.versions.set(version.id, version);
+        this.currentVersionId = version.id;
+        return version;
+    }
+    /**
+     * 获取版本列表
+     */
+    listVersions() {
+        return Array.from(this.versions.values()).sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+    }
+    /**
+     * 获取特定版本
+     */
+    getVersion(versionId) {
+        return this.versions.get(versionId);
+    }
+    /**
+     * 获取当前版本
+     */
+    getCurrentVersion() {
+        if (!this.currentVersionId) {
+            return undefined;
+        }
+        return this.versions.get(this.currentVersionId);
+    }
+    /**
+     * 回滚到指定版本
+     */
+    async rollback(versionId, targetDir) {
+        const version = this.versions.get(versionId);
+        if (!version) {
+            throw new Error(`Version ${versionId} not found`);
+        }
+        // 清空目标目录（保留 node_modules 等）
+        await this.cleanTargetDir(targetDir);
+        // 恢复文件
+        for (const [filePath, content] of version.files) {
+            const fullPath = path.join(targetDir, filePath);
+            const dir = path.dirname(fullPath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(fullPath, content, 'utf-8');
+        }
+        // 更新当前版本
+        this.currentVersionId = versionId;
+    }
+    /**
+     * 比较两个版本
+     */
+    async compareVersions(versionIdA, versionIdB) {
+        const versionA = this.versions.get(versionIdA);
+        const versionB = this.versions.get(versionIdB);
+        if (!versionA || !versionB) {
+            throw new Error('One or both versions not found');
+        }
+        const filesAdded = [];
+        const filesRemoved = [];
+        const filesModified = [];
+        const changes = new Map();
+        // 检查版本 B 中的文件
+        for (const [filePath, contentB] of versionB.files) {
+            const contentA = versionA.files.get(filePath);
+            if (!contentA) {
+                // 文件在 A 中不存在，是新增的
+                filesAdded.push(filePath);
+            }
+            else if (contentA !== contentB) {
+                // 文件被修改
+                filesModified.push(filePath);
+                changes.set(filePath, this.calculateFileDiff(filePath, contentA, contentB));
+            }
+        }
+        // 检查版本 A 中被删除的文件
+        for (const filePath of versionA.files.keys()) {
+            if (!versionB.files.has(filePath)) {
+                filesRemoved.push(filePath);
+            }
+        }
+        return {
+            versionA: versionIdA,
+            versionB: versionIdB,
+            filesAdded,
+            filesRemoved,
+            filesModified,
+            changes,
+        };
+    }
+    /**
+     * 删除版本
+     */
+    async deleteVersion(versionId) {
+        const version = this.versions.get(versionId);
+        if (!version) {
+            throw new Error(`Version ${versionId} not found`);
+        }
+        // 删除版本文件
+        const versionFile = path.join(this.versionsDir, `${versionId}.json`);
+        if (fs.existsSync(versionFile)) {
+            fs.unlinkSync(versionFile);
+        }
+        // 从内存中删除
+        this.versions.delete(versionId);
+        // 如果删除的是当前版本，更新当前版本指针
+        if (this.currentVersionId === versionId) {
+            const versions = this.listVersions();
+            this.currentVersionId = versions.length > 0 ? versions[0].id : undefined;
+        }
+    }
+    /**
+     * 添加版本标签
+     */
+    async tagVersion(versionId, tag) {
+        const version = this.versions.get(versionId);
+        if (!version) {
+            throw new Error(`Version ${versionId} not found`);
+        }
+        if (!version.metadata.tags) {
+            version.metadata.tags = [];
+        }
+        if (!version.metadata.tags.includes(tag)) {
+            version.metadata.tags.push(tag);
+            await this.saveVersion(version);
+        }
+    }
+    /**
+     * 按标签查找版本
+     */
+    findVersionsByTag(tag) {
+        return Array.from(this.versions.values()).filter((v) => v.metadata.tags && v.metadata.tags.includes(tag));
+    }
+    /**
+     * 导出版本
+     */
+    async exportVersion(versionId, outputPath) {
+        const version = this.versions.get(versionId);
+        if (!version) {
+            throw new Error(`Version ${versionId} not found`);
+        }
+        const exportData = {
+            version: {
+                id: version.id,
+                timestamp: version.timestamp,
+                description: version.description,
+                config: version.config,
+                metadata: version.metadata,
+            },
+            files: Array.from(version.files.entries()),
+        };
+        fs.writeFileSync(outputPath, JSON.stringify(exportData, null, 2), 'utf-8');
+    }
+    /**
+     * 导入版本
+     */
+    async importVersion(importPath) {
+        const content = fs.readFileSync(importPath, 'utf-8');
+        const importData = JSON.parse(content);
+        const version = {
+            ...importData.version,
+            timestamp: new Date(importData.version.timestamp),
+            files: new Map(importData.files),
+        };
+        // 生成新的 ID 避免冲突
+        version.id = (0, uuid_1.v4)();
+        version.metadata.parentVersionId = undefined;
+        await this.saveVersion(version);
+        this.versions.set(version.id, version);
+        return version;
+    }
+    /**
+     * 保存版本到磁盘
+     */
+    async saveVersion(version) {
+        const versionFile = path.join(this.versionsDir, `${version.id}.json`);
+        const data = {
+            id: version.id,
+            timestamp: version.timestamp.toISOString(),
+            description: version.description,
+            config: version.config,
+            metadata: version.metadata,
+            files: Array.from(version.files.entries()),
+        };
+        fs.writeFileSync(versionFile, JSON.stringify(data, null, 2), 'utf-8');
+    }
+    /**
+     * 从磁盘加载版本
+     */
+    loadVersions() {
+        if (!fs.existsSync(this.versionsDir)) {
+            return;
+        }
+        const files = fs.readdirSync(this.versionsDir);
+        for (const file of files) {
+            if (!file.endsWith('.json')) {
+                continue;
+            }
+            try {
+                const filePath = path.join(this.versionsDir, file);
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const data = JSON.parse(content);
+                const version = {
+                    id: data.id,
+                    timestamp: new Date(data.timestamp),
+                    description: data.description,
+                    config: data.config,
+                    metadata: data.metadata,
+                    files: new Map(data.files),
+                };
+                this.versions.set(version.id, version);
+                // 更新当前版本（最新的）
+                if (!this.currentVersionId ||
+                    version.timestamp > this.versions.get(this.currentVersionId).timestamp) {
+                    this.currentVersionId = version.id;
+                }
+            }
+            catch (error) {
+                console.error(`Failed to load version from ${file}:`, error);
+            }
+        }
+    }
+    /**
+     * 确保版本目录存在
+     */
+    ensureVersionsDir() {
+        if (!fs.existsSync(this.versionsDir)) {
+            fs.mkdirSync(this.versionsDir, { recursive: true });
+        }
+    }
+    /**
+     * 计算统计信息
+     */
+    calculateStats(files) {
+        let linesOfCode = 0;
+        let componentsCount = 0;
+        for (const [filePath, content] of files) {
+            linesOfCode += content.split('\n').length;
+            // 简单的组件计数（检测文件名）
+            const ext = path.extname(filePath);
+            if (['.tsx', '.jsx', '.vue'].includes(ext)) {
+                componentsCount++;
+            }
+        }
+        return {
+            filesCount: files.size,
+            linesOfCode,
+            componentsCount,
+        };
+    }
+    /**
+     * 计算文件差异
+     */
+    calculateFileDiff(filePath, contentA, contentB) {
+        const linesA = contentA.split('\n');
+        const linesB = contentB.split('\n');
+        let linesAdded = 0;
+        let linesRemoved = 0;
+        let linesModified = 0;
+        // 简单的行级差异（实际应该使用更复杂的 diff 算法）
+        const maxLines = Math.max(linesA.length, linesB.length);
+        for (let i = 0; i < maxLines; i++) {
+            const lineA = linesA[i];
+            const lineB = linesB[i];
+            if (lineA === undefined) {
+                linesAdded++;
+            }
+            else if (lineB === undefined) {
+                linesRemoved++;
+            }
+            else if (lineA !== lineB) {
+                linesModified++;
+            }
+        }
+        // 生成简单的 diff 字符串
+        const diff = this.generateSimpleDiff(linesA, linesB);
+        return {
+            path: filePath,
+            linesAdded,
+            linesRemoved,
+            linesModified,
+            diff,
+        };
+    }
+    /**
+     * 生成简单的 diff 字符串
+     */
+    generateSimpleDiff(linesA, linesB) {
+        const diffLines = [];
+        const maxLines = Math.max(linesA.length, linesB.length);
+        for (let i = 0; i < maxLines; i++) {
+            const lineA = linesA[i];
+            const lineB = linesB[i];
+            if (lineA === undefined) {
+                diffLines.push(`+ ${lineB}`);
+            }
+            else if (lineB === undefined) {
+                diffLines.push(`- ${lineA}`);
+            }
+            else if (lineA !== lineB) {
+                diffLines.push(`- ${lineA}`);
+                diffLines.push(`+ ${lineB}`);
+            }
+        }
+        return diffLines.join('\n');
+    }
+    /**
+     * 清空目标目录
+     */
+    async cleanTargetDir(targetDir) {
+        const skipDirs = ['node_modules', '.git', '.figma-versions', '.figma-backups'];
+        if (!fs.existsSync(targetDir)) {
+            return;
+        }
+        const entries = fs.readdirSync(targetDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (skipDirs.includes(entry.name)) {
+                continue;
+            }
+            const fullPath = path.join(targetDir, entry.name);
+            if (entry.isDirectory()) {
+                fs.rmSync(fullPath, { recursive: true, force: true });
+            }
+            else {
+                fs.unlinkSync(fullPath);
+            }
+        }
+    }
+}
+exports.VersionManager = VersionManager;
+//# sourceMappingURL=VersionManager.js.map

package/dist/version/VersionManager.js.map

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

package/dist/version/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 版本管理模块
+ */
+export * from './VersionManager';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/version/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,kBAAkB,CAAC"}

package/dist/version/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * 版本管理模块
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./VersionManager"), exports);
+//# sourceMappingURL=index.js.map

package/dist/version/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/version/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,mDAAiC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "figma-to-code-agent",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "AI Agent that converts Figma designs to production-ready code with optional LLM enhancements",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -73,9 +73,11 @@
   },
   "dependencies": {
     "@aws-sdk/client-bedrock-runtime": "^3.987.0",
+    "@types/uuid": "^10.0.0",
     "axios": "^1.6.7",
     "fast-check": "^3.15.1",
     "puppeteer": "^22.0.0",
+    "uuid": "^13.0.0",
     "ws": "^8.19.0"
   }
 }

package/QUICKSTART.md

@@ -1,178 +0,0 @@
-# Quick Start
-
-## 1. Install
-
-```bash
-npm install -g figma-to-code-agent
-```
-
-Or skip install and use `npx figma-to-code-agent` directly.
-
-## 2. Get Your Figma Token
-
-1. Go to [Figma API Settings](https://www.figma.com/developers/api#access-tokens)
-2. Click "Get personal access token"
-3. Copy the token
-
-## 3. Get File Key & Node ID
-
-From your Figma URL:
-
-```
-https://www.figma.com/design/ABC123DEF456/My-Design?node-id=100-200
-                              ^^^^^^^^^^^^^^                 ^^^^^^^
-                              File Key                       Node ID
-```
-
-Node ID format: `100-200` (use hyphen, not colon)
-
-## 4. Generate Code
-
-```bash
-# React component
-npx figma-to-code-agent \
-  --token YOUR_FIGMA_TOKEN \
-  --file ABC123DEF456 \
-  --node 100-200 \
-  --framework react \
-  --output ./output
-
-# Vue component
-npx figma-to-code-agent \
-  --token YOUR_FIGMA_TOKEN \
-  --file ABC123DEF456 \
-  --node 100-200 \
-  --framework vue \
-  --output ./output
-```
-
-Or use environment variable:
-
-```bash
-export FIGMA_TOKEN="your-token"
-npx figma-to-code-agent --file ABC123DEF456 --node 100-200 --output ./output
-```
-
-## 5. Preview in Browser
-
-Add `--preview` to instantly open the result in your browser:
-
-```bash
-npx figma-to-code-agent \
-  --token YOUR_FIGMA_TOKEN \
-  --file ABC123DEF456 \
-  --node 100-200 \
-  --framework react \
-  --output ./output \
-  --preview
-```
-
-This copies the generated files to the built-in test app, starts a Vite dev server, and opens your browser. Press `Ctrl+C` to stop — temporary files are cleaned up automatically.
-
-## 6. TypeScript Output (Optional)
-
-By default, generates `.jsx` / `.vue`. Add `--typescript` for `.tsx` output:
-
-```bash
-npx figma-to-code-agent \
-  --token YOUR_FIGMA_TOKEN \
-  --file ABC123DEF456 \
-  --node 100-200 \
-  --framework react \
-  --typescript \
-  --output ./output
-```
-
-## Generated Output
-
-For a React component with CSS Modules, you'll get:
-
-```
-output/
-├── Component.jsx          # React component
-├── Component.module.css   # CSS Module styles
-└── assets/                # Downloaded images
-    ├── hero-image.png
-    └── icon-close.png
-```
-
-For plain CSS mode (`--style css`):
-
-```
-output/
-├── Component.jsx          # React component
-├── Component.css          # Standalone CSS file
-└── assets/
-```
-
-For Vue, a single `.vue` file with `<template>`, `<script setup>`, and `<style scoped>`.
-
-## What Gets Generated
-
-- Pixel-accurate layout using absolute positioning
-- Responsive scaling — auto-fits viewport width, no horizontal scrollbar
-- Full typography (font family, size, weight, line-height, letter-spacing, color)
-- Images exported at 2x resolution for retina displays
-- Vector icons auto-detected and exported as PNG
-- Hidden layers and mask shapes filtered out
-- CSS Modules with scoped class names
-
-## CLI Reference
-
-| Option | Description | Default |
-|--------|-------------|---------|
-| `--token <token>` | Figma API token (or `FIGMA_TOKEN` env) | — |
-| `--file <key>` | Figma file key | — |
-| `--node <id>` | Target node ID | root |
-| `--framework` | `react` or `vue` | `react` |
-| `--style` | `css-modules`, `tailwind`, or `css` | `css-modules` |
-| `--typescript` | Enable TypeScript output | `false` |
-| `--output <dir>` | Output directory | `./output` |
-| `--extract-tokens <fmt>` | Extract design tokens: `css`, `scss`, `json`, `js` | — |
-| `--preview` | Preview in browser after generation | — |
-
-## AI Enhancements (Optional)
-
-For smarter component naming and code optimization, add an LLM provider:
-
-```bash
-# AWS Bedrock
-npx figma-to-code-agent \
-  --token YOUR_FIGMA_TOKEN \
-  --file ABC123DEF456 \
-  --framework react \
-  --llm-provider bedrock \
-  --llm-model anthropic.claude-3-5-sonnet-20241022-v2:0 \
-  --ai-naming \
-  --output ./output
-
-# OpenAI
-LLM_API_KEY="sk-..." npx figma-to-code-agent \
-  --token YOUR_FIGMA_TOKEN \
-  --file ABC123DEF456 \
-  --framework react \
-  --llm-provider openai \
-  --llm-model gpt-4o \
-  --ai-naming \
-  --output ./output
-```
-
-| AI Option | What It Does |
-|-----------|-------------|
-| `--ai-naming` | Renames `Frame123` → `UserProfileCard` |
-| `--ai-splitting` | Splits large designs into sub-components |
-| `--ai-optimization` | Improves code quality and accessibility |
-
-## Troubleshooting
-
-**"Figma token is required"**
-Set `--token` or `export FIGMA_TOKEN="your-token"`
-
-**"Rate limited" / 429 errors**
-The tool auto-retries with backoff. If persistent, wait a minute and try again. Downloaded images are cached locally to avoid repeated API calls.
-
-**Images not showing**
-Check that the `assets/` folder was generated alongside your component. Image paths are relative imports.
-
-**Preview not working**
-The `--preview` flag requires the built-in test-app. If installed globally, it should work out of the box. If using npx, the test-app is included in the package.