figma-to-code-agent 0.3.0

package/dist/FigmaToCodeAgent.js

@@ -0,0 +1,251 @@
+"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.FigmaToCodeAgent = void 0;
+const FigmaAPIClient_1 = require("./extraction/FigmaAPIClient");
+const ASTParser_1 = require("./transformation/ASTParser");
+const TransformationPipeline_1 = require("./transformation/TransformationPipeline");
+const FigmaStructureOptimizer_1 = require("./transformation/transformers/FigmaStructureOptimizer");
+const ComponentExtractor_1 = require("./transformation/transformers/ComponentExtractor");
+const LayoutOptimizer_1 = require("./transformation/transformers/LayoutOptimizer");
+const SemanticNamer_1 = require("./transformation/transformers/SemanticNamer");
+const AILayoutAnalyzer_1 = require("./transformation/transformers/AILayoutAnalyzer");
+const ReactGenerator_1 = require("./generation/ReactGenerator");
+const VueGenerator_1 = require("./generation/VueGenerator");
+const llm_1 = require("./llm");
+const AISemanticNamer_1 = require("./transformation/transformers/AISemanticNamer");
+const AIComponentSplitter_1 = require("./transformation/transformers/AIComponentSplitter");
+const AICodeOptimizer_1 = require("./generation/AICodeOptimizer");
+class FigmaToCodeAgent {
+    constructor(config) {
+        this.config = config;
+        this.figmaClient = new FigmaAPIClient_1.FigmaAPIClient(config.figmaToken);
+        this.parser = new ASTParser_1.ASTParser();
+        this.pipeline = new TransformationPipeline_1.TransformationPipeline();
+        // Initialize LLM if configured
+        if (config.llm) {
+            this.llm = llm_1.LLMFactory.create(config.llm);
+            if (config.llm.enableAIOptimization) {
+                this.aiOptimizer = new AICodeOptimizer_1.AICodeOptimizer(this.llm);
+            }
+        }
+        // Register transformers (order matters!)
+        // NOTE: Use FigmaStructureOptimizer instead of aggressive SimplifyTransformer/FlattenTransformer
+        // to preserve Figma layer structure for better readability
+        this.pipeline.register(new FigmaStructureOptimizer_1.FigmaStructureOptimizer()); // 1. Light optimization, preserve structure
+        // AI layout analysis (before component extraction)
+        if (config.llm?.enableAILayout && this.llm) {
+            this.pipeline.register(new AILayoutAnalyzer_1.AILayoutAnalyzer(this.llm)); // 2. AI semantic analysis
+        }
+        this.pipeline
+            .register(new ComponentExtractor_1.ComponentExtractor()) // 3. Extract components
+            .register(new LayoutOptimizer_1.LayoutOptimizer()); // 4. Optimize layout
+        // Use AI or rule-based naming
+        if (config.llm?.enableAINaming && this.llm) {
+            this.pipeline.register(new AISemanticNamer_1.AISemanticNamer(this.llm)); // 5. AI naming
+        }
+        else {
+            this.pipeline.register(new SemanticNamer_1.SemanticNamer()); // 5. Rule-based naming
+        }
+        // Add AI component splitting if enabled
+        if (config.llm?.enableAISplitting && this.llm) {
+            this.pipeline.register(new AIComponentSplitter_1.AIComponentSplitter(this.llm)); // 6. AI splitting
+        }
+    }
+    async convert() {
+        // Step 1: Extract design from Figma
+        const figmaFile = await this.figmaClient.getFile(this.config.fileKey);
+        // Step 2: Find target node(s) or use entire document
+        let targetNode = figmaFile.document;
+        if (this.config.nodeIds && this.config.nodeIds.length > 0) {
+            const nodeId = this.config.nodeIds[0].replace('-', ':');
+            const found = this.findNodeById(figmaFile.document, nodeId);
+            if (found) {
+                targetNode = found;
+                console.log(`✓ Found target node: ${found.name} (${found.type})`);
+            }
+            else {
+                console.log(`⚠ Node ${nodeId} not found, using entire document`);
+            }
+        }
+        // Step 3: Parse to AST
+        const ast = this.parser.parse(targetNode);
+        // Step 4: Download images for Image nodes
+        await this.downloadImages(ast);
+        // Step 5: Transform AST
+        const transformedAst = await this.pipeline.execute(ast);
+        // Step 6: Generate code
+        const generator = this.config.framework === 'react' ? new ReactGenerator_1.ReactGenerator() : new VueGenerator_1.VueGenerator();
+        const generatorConfig = {
+            framework: this.config.framework,
+            styleMode: this.config.styleMode,
+            typescript: this.config.typescript,
+            outputDir: this.config.outputDir,
+        };
+        let files = generator.generate(transformedAst, generatorConfig);
+        // Step 7: AI optimization (optional)
+        if (this.aiOptimizer) {
+            files = await this.aiOptimizer.optimize(files);
+        }
+        return files;
+    }
+    /**
+     * Download images for all Image nodes in the AST
+     */
+    async downloadImages(ast) {
+        const imageNodes = [];
+        this.collectImageNodes(ast, imageNodes);
+        this.collectIconNodes(ast, imageNodes);
+        if (imageNodes.length === 0)
+            return;
+        console.log(`Found ${imageNodes.length} image(s) to download...`);
+        const fs = await Promise.resolve().then(() => __importStar(require('fs')));
+        const path = await Promise.resolve().then(() => __importStar(require('path')));
+        const assetsDir = path.join(this.config.outputDir, 'assets');
+        // Try to use locally cached files first before hitting API
+        const nodesNeedingDownload = [];
+        for (const node of imageNodes) {
+            const fileName = this.sanitizeFileName(node.name) + '.png';
+            const filePath = path.join(assetsDir, fileName);
+            if (fs.existsSync(filePath)) {
+                console.log(`✓ Using cached image: ${fileName}`);
+                node.metadata.imageRef = `./assets/${fileName}`;
+                if (node.type !== 'Image') {
+                    node.type = 'Image';
+                    node.children = [];
+                }
+            }
+            else {
+                nodesNeedingDownload.push(node);
+            }
+        }
+        if (nodesNeedingDownload.length === 0)
+            return;
+        const nodeIds = nodesNeedingDownload.map((n) => n.metadata.figmaId);
+        try {
+            const imageMap = await this.figmaClient.getImages(this.config.fileKey, nodeIds, 'png');
+            if (imageMap.images) {
+                if (!fs.existsSync(assetsDir)) {
+                    fs.mkdirSync(assetsDir, { recursive: true });
+                }
+                for (const node of nodesNeedingDownload) {
+                    const imageUrl = imageMap.images[node.metadata.figmaId];
+                    if (imageUrl) {
+                        const fileName = this.sanitizeFileName(node.name) + '.png';
+                        const filePath = path.join(assetsDir, fileName);
+                        try {
+                            await this.figmaClient.downloadImage(imageUrl, filePath);
+                            node.metadata.imageRef = `./assets/${fileName}`;
+                            if (node.type !== 'Image') {
+                                node.type = 'Image';
+                                node.children = [];
+                            }
+                        }
+                        catch (err) {
+                            console.log(`⚠ Failed to download image: ${node.name}`);
+                        }
+                    }
+                }
+            }
+        }
+        catch (err) {
+            console.log(`⚠ Failed to fetch image URLs, using placeholders`);
+        }
+    }
+    collectImageNodes(node, result) {
+        if (node.type === 'Image') {
+            result.push(node);
+        }
+        node.children.forEach((child) => this.collectImageNodes(child, result));
+    }
+    /**
+     * Find containers whose children are all Shape/Vector nodes (icons).
+     * These should be exported as images since CSS can't render SVG paths.
+     */
+    /**
+     * Find containers whose children are all Shape/Vector nodes (icons).
+     * These should be exported as images since CSS can't render SVG paths.
+     * Only matches small containers (< 200px) to avoid exporting large sections.
+     */
+    /**
+     * Find containers whose descendants are all Shape/Vector nodes.
+     * These should be exported as images since CSS can't render SVG paths.
+     * Skips containers that also have Text or Image children (mixed content).
+     */
+    collectIconNodes(node, result) {
+        if (node.type === 'Container' && node.children.length > 0) {
+            const hasShape = this.hasShapeDescendant(node);
+            const hasTextOrImage = this.hasTextOrImageDescendant(node);
+            if (hasShape && !hasTextOrImage) {
+                result.push(node);
+                return; // Don't recurse — export this whole container
+            }
+        }
+        node.children.forEach((child) => this.collectIconNodes(child, result));
+    }
+    hasShapeDescendant(node) {
+        if (node.type === 'Shape')
+            return true;
+        return node.children.some((c) => this.hasShapeDescendant(c));
+    }
+    hasTextOrImageDescendant(node) {
+        if (node.type === 'Text' || node.type === 'Image')
+            return true;
+        return node.children.some((c) => this.hasTextOrImageDescendant(c));
+    }
+    sanitizeFileName(name) {
+        return (name
+            // eslint-disable-next-line no-control-regex
+            .replace(/[^\x00-\x7F]/g, '') // Remove non-ASCII (Chinese, etc.)
+            .replace(/[^\w\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .toLowerCase()
+            .substring(0, 50) || 'icon');
+    }
+    findNodeById(node, id) {
+        if (node.id === id)
+            return node;
+        if (node.children) {
+            for (const child of node.children) {
+                const found = this.findNodeById(child, id);
+                if (found)
+                    return found;
+            }
+        }
+        return null;
+    }
+}
+exports.FigmaToCodeAgent = FigmaToCodeAgent;
+//# sourceMappingURL=FigmaToCodeAgent.js.map

package/dist/FigmaToCodeAgent.js.map

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

package/dist/assets/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Asset Management Layer
+ * Handles images and static resources
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/assets/index.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Asset Management Layer
+ * Handles images and static resources
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/assets/index.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,261 @@
+#!/usr/bin/env node
+"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 });
+const FigmaToCodeAgent_1 = require("./FigmaToCodeAgent");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes('--help')) {
+        console.log(`
+Figma-to-Code AI Agent
+
+Usage:
+  figma-to-code --token <token> --file <fileKey> [options]
+
+Options:
+  --token <token>       Figma API token (required)
+  --file <fileKey>      Figma file key (required)
+  --node <nodeId>       Specific node ID to convert
+  --framework <name>    Framework: react or vue (default: react)
+  --style <mode>        Style mode: css-modules, tailwind, or css (default: css-modules)
+  --typescript          Enable TypeScript output (default: false)
+  --output <dir>        Output directory (default: ./output)
+  --preview             Preview in browser after generation
+
+  AI Options:
+  --llm-provider <name> LLM provider: bedrock, openai, anthropic
+  --llm-model <model>   Model name
+  --llm-region <region> AWS region for Bedrock (default: us-east-1)
+  --llm-api-key <key>   API key for OpenAI/Anthropic
+  --ai-naming           Enable AI-powered component naming
+  --ai-splitting        Enable AI-powered component splitting
+  --ai-optimization     Enable AI-powered code optimization
+  --ai-layout           Enable AI-powered layout analysis
+
+  --help                Show this help message
+
+Example:
+  figma-to-code --token abc123 --file xyz789 --framework react --output ./src/components
+  figma-to-code --token abc123 --file xyz789 --framework react --preview
+    `);
+        process.exit(0);
+    }
+    const preview = args.includes('--preview');
+    const config = {
+        figmaToken: getArg('--token', args) || process.env.FIGMA_TOKEN || '',
+        fileKey: getArg('--file', args) || '',
+        nodeIds: getArgs('--node', args),
+        framework: (getArg('--framework', args) || 'react'),
+        styleMode: (getArg('--style', args) || 'css-modules'),
+        typescript: args.includes('--typescript'),
+        outputDir: getArg('--output', args) || './output',
+        llm: getArg('--llm-provider', args)
+            ? {
+                provider: getArg('--llm-provider', args),
+                model: getArg('--llm-model', args) || '',
+                region: getArg('--llm-region', args),
+                apiKey: getArg('--llm-api-key', args) || process.env.LLM_API_KEY,
+                enableAINaming: args.includes('--ai-naming'),
+                enableAISplitting: args.includes('--ai-splitting'),
+                enableAIOptimization: args.includes('--ai-optimization'),
+                enableAILayout: args.includes('--ai-layout'),
+            }
+            : undefined,
+    };
+    if (!config.figmaToken) {
+        console.error('Error: Figma token is required. Use --token or set FIGMA_TOKEN environment variable.');
+        process.exit(1);
+    }
+    if (!config.fileKey) {
+        console.error('Error: Figma file key is required. Use --file option.');
+        process.exit(1);
+    }
+    console.log('Starting Figma-to-Code conversion...');
+    console.log(`Framework: ${config.framework}`);
+    console.log(`Style mode: ${config.styleMode}`);
+    console.log(`TypeScript: ${config.typescript}`);
+    console.log(`Output: ${config.outputDir}`);
+    console.log('');
+    try {
+        console.log('Step 1/4: Extracting design from Figma...');
+        const agent = new FigmaToCodeAgent_1.FigmaToCodeAgent(config);
+        const files = await agent.convert();
+        console.log('\nStep 4/4: Writing files...');
+        // Create output directory
+        if (!fs.existsSync(config.outputDir)) {
+            fs.mkdirSync(config.outputDir, { recursive: true });
+        }
+        // Write generated files to output directory
+        for (const file of files) {
+            const filePath = path.join(process.cwd(), file.path);
+            const dir = path.dirname(filePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(filePath, file.content, 'utf-8');
+            console.log(`✓ Generated: ${file.path}`);
+        }
+        console.log(`\n✓ Successfully generated ${files.length} file(s)`);
+        // Preview mode: copy to test-app and launch Vite
+        if (preview) {
+            await startPreview(config.framework, config.outputDir, files);
+        }
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+async function startPreview(framework, outputDir, files) {
+    const cliDir = path.dirname(path.dirname(path.resolve(__filename)));
+    const testAppDir = framework === 'react'
+        ? path.join(cliDir, 'test-app', 'test-react')
+        : path.join(cliDir, 'test-app', 'test-vue');
+    const srcDir = path.join(testAppDir, 'src');
+    if (!fs.existsSync(testAppDir)) {
+        console.error('Error: test-app directory not found at', testAppDir);
+        process.exit(1);
+    }
+    console.log('\n🔍 Starting preview...');
+    // Copy generated files and assets to test-app/src
+    const outputAbsolute = path.resolve(outputDir);
+    const copiedFiles = [];
+    for (const file of files) {
+        const srcPath = path.join(process.cwd(), file.path);
+        const fileName = path.basename(file.path);
+        const destPath = path.join(srcDir, fileName);
+        fs.copyFileSync(srcPath, destPath);
+        copiedFiles.push(destPath);
+    }
+    // Copy assets directory if it exists in output
+    const outputAssetsDir = path.join(outputAbsolute, 'assets');
+    const destAssetsDir = path.join(srcDir, 'assets');
+    if (fs.existsSync(outputAssetsDir)) {
+        if (!fs.existsSync(destAssetsDir)) {
+            fs.mkdirSync(destAssetsDir, { recursive: true });
+        }
+        for (const assetFile of fs.readdirSync(outputAssetsDir)) {
+            const assetSrc = path.join(outputAssetsDir, assetFile);
+            const assetDest = path.join(destAssetsDir, assetFile);
+            if (fs.statSync(assetSrc).isFile()) {
+                fs.copyFileSync(assetSrc, assetDest);
+                copiedFiles.push(assetDest);
+            }
+        }
+    }
+    // Find the main component file name
+    const componentFile = files.find((f) => framework === 'react'
+        ? f.path.endsWith('.jsx') || f.path.endsWith('.tsx')
+        : f.path.endsWith('.vue'));
+    if (!componentFile) {
+        console.error('Error: No component file found in generated output');
+        return;
+    }
+    const componentFileName = path.basename(componentFile.path);
+    const componentName = componentFileName.replace(/\.(jsx|tsx|vue)$/, '');
+    // Update entry file to import the generated component
+    if (framework === 'react') {
+        const ext = componentFileName.endsWith('.tsx') ? '.tsx' : '.jsx';
+        const entryContent = `import React from 'react'
+import ReactDOM from 'react-dom/client'
+import { ${componentName} } from './${componentName}${ext}'
+
+ReactDOM.createRoot(document.getElementById('root')).render(
+  <React.StrictMode>
+    <${componentName} />
+  </React.StrictMode>
+)
+`;
+        fs.writeFileSync(path.join(srcDir, 'main.jsx'), entryContent, 'utf-8');
+    }
+    else {
+        const entryContent = `import { createApp } from 'vue'
+import ${componentName} from './${componentName}.vue'
+
+createApp(${componentName}).mount('#app')
+`;
+        fs.writeFileSync(path.join(srcDir, 'main.js'), entryContent, 'utf-8');
+    }
+    console.log(`✓ Copied files to ${testAppDir}`);
+    console.log(`✓ Starting Vite dev server...\n`);
+    // Launch Vite with --open
+    const viteProcess = (0, child_process_1.spawn)('npx', ['vite', '--open'], {
+        cwd: testAppDir,
+        stdio: 'inherit',
+        shell: true,
+    });
+    // Cleanup on exit: remove copied files
+    const cleanup = () => {
+        console.log('\n🧹 Cleaning up preview files...');
+        for (const f of copiedFiles) {
+            try {
+                fs.unlinkSync(f);
+            }
+            catch { /* ignore cleanup errors */ }
+        }
+        viteProcess.kill();
+        process.exit(0);
+    };
+    process.on('SIGINT', cleanup);
+    process.on('SIGTERM', cleanup);
+    viteProcess.on('close', (code) => {
+        // Clean up when Vite exits
+        for (const f of copiedFiles) {
+            try {
+                fs.unlinkSync(f);
+            }
+            catch { /* ignore cleanup errors */ }
+        }
+        process.exit(code ?? 0);
+    });
+}
+function getArg(flag, args) {
+    const index = args.indexOf(flag);
+    return index !== -1 && index + 1 < args.length ? args[index + 1] : undefined;
+}
+function getArgs(flag, args) {
+    const values = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === flag && i + 1 < args.length) {
+            values.push(args[i + 1]);
+        }
+    }
+    return values.length > 0 ? values : undefined;
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/extraction/FigmaAPIClient.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Figma API Client
+ * Handles communication with Figma REST API
+ */
+import { FigmaFile, GetFileOptions, ImageFormat, ImageMap } from './types';
+export declare class FigmaAPIClient {
+    private readonly accessToken;
+    private readonly baseURL;
+    private readonly axiosInstance;
+    private readonly maxRetries;
+    private readonly baseRetryDelay;
+    private readonly cache;
+    private readonly cacheMaxAge;
+    constructor(accessToken: string, enableCache?: boolean);
+    /**
+     * Get file's complete design data
+     * @param fileKey - Figma file ID
+     * @param options - Optional query parameters
+     * @returns Design file data
+     */
+    getFile(fileKey: string, options?: GetFileOptions): Promise<FigmaFile>;
+    /**
+     * Get image resource URLs from file
+     * @param fileKey - Figma file ID
+     * @param nodeIds - List of node IDs to export
+     * @param format - Image format (png, jpg, svg, pdf)
+     * @returns Image URL mapping
+     */
+    getImages(fileKey: string, nodeIds: string[], format?: ImageFormat): Promise<ImageMap>;
+    /**
+     * Download image resource to local file
+     * @param imageUrl - Image URL
+     * @param outputPath - Save path
+     */
+    downloadImage(imageUrl: string, outputPath: string): Promise<void>;
+    /**
+     * Retry request with exponential backoff and Retry-After header support
+     */
+    private retryRequest;
+    /**
+     * Check if error is retryable (network errors, rate limits, server errors)
+     */
+    private isRetryableError;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+    /**
+     * Handle and format errors
+     */
+    private handleError;
+}
+//# sourceMappingURL=FigmaAPIClient.d.ts.map

package/dist/extraction/FigmaAPIClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FigmaAPIClient.d.ts","sourceRoot":"","sources":["../../src/extraction/FigmaAPIClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG3E,qBAAa,cAAc;IASvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAR9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAGhC,WAAW,EAAE,MAAM,EACpC,WAAW,UAAO;IAiBpB;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAqC5E;;;;;;OAMG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,GAAE,WAAmB,GAC1B,OAAO,CAAC,QAAQ,CAAC;IA8CpB;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCxE;;OAEG;YACW,YAAY;IAuC1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;OAEG;IACH,OAAO,CAAC,WAAW;CAqCpB"}