@zleap-ai/icons 0.0.28

package/dist/cjs/multi-format-output.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * Multi-Format Output Module
+ *
+ * Generates multiple output formats from icon metadata:
+ * - SVG Sprite file with symbol elements
+ * - JSON metadata file
+ *
+ * Requirements: 11.2, 11.3, 11.5
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toSymbolId = toSymbolId;
+exports.createSpriteSymbol = createSpriteSymbol;
+exports.generateSprite = generateSprite;
+exports.generateSpriteFromManifest = generateSpriteFromManifest;
+exports.createIconJsonEntry = createIconJsonEntry;
+exports.generateJsonMetadata = generateJsonMetadata;
+exports.generateJsonMetadataFromManifest = generateJsonMetadataFromManifest;
+exports.serializeJsonMetadata = serializeJsonMetadata;
+exports.validateSpriteCompleteness = validateSpriteCompleteness;
+exports.validateJsonMetadataCompleteness = validateJsonMetadataCompleteness;
+const svg_transformer_1 = require("./svg-transformer");
+/**
+ * Default sprite generator options
+ */
+const DEFAULT_SPRITE_OPTIONS = {
+    defaultViewBox: '0 0 24 24',
+    includeComments: false,
+};
+/**
+ * Converts an icon name to a valid symbol ID
+ * Uses lowercase kebab-case format
+ *
+ * @param name - Icon name (can be PascalCase, camelCase, etc.)
+ * @returns Lowercase kebab-case ID
+ */
+function toSymbolId(name) {
+    if (!name || name.trim().length === 0) {
+        return 'icon';
+    }
+    // Remove "Icon" prefix if present
+    let cleanName = name;
+    if (cleanName.startsWith('Icon') && cleanName.length > 4) {
+        cleanName = cleanName.slice(4);
+    }
+    // Convert PascalCase/camelCase to kebab-case
+    return cleanName
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+/**
+ * Creates a sprite symbol from icon metadata
+ *
+ * @param icon - Icon metadata with SVG content
+ * @param options - Sprite generator options
+ * @returns SpriteSymbol object or null if no SVG content
+ */
+function createSpriteSymbol(icon, options = DEFAULT_SPRITE_OPTIONS) {
+    if (!icon.svgContent) {
+        return null;
+    }
+    const id = toSymbolId(icon.normalizedName);
+    const viewBox = (0, svg_transformer_1.extractViewBox)(icon.svgContent) || options.defaultViewBox || '0 0 24 24';
+    const content = (0, svg_transformer_1.extractSvgInnerContent)(icon.svgContent);
+    return {
+        id,
+        viewBox,
+        content,
+    };
+}
+/**
+ * Generates an SVG sprite from a list of icons
+ *
+ * @param icons - Array of icon metadata with SVG content
+ * @param options - Sprite generator options
+ * @returns SvgSprite object with full sprite content and symbols
+ *
+ * Requirements: 11.2
+ */
+function generateSprite(icons, options = {}) {
+    const opts = { ...DEFAULT_SPRITE_OPTIONS, ...options };
+    // Create symbols from icons that have SVG content
+    const symbols = [];
+    for (const icon of icons) {
+        const symbol = createSpriteSymbol(icon, opts);
+        if (symbol) {
+            symbols.push(symbol);
+        }
+    }
+    // Sort symbols alphabetically by ID for consistent output
+    symbols.sort((a, b) => a.id.localeCompare(b.id));
+    // Generate sprite content
+    const symbolsContent = symbols
+        .map((s) => `  <symbol id="${s.id}" viewBox="${s.viewBox}">
+    ${s.content}
+  </symbol>`)
+        .join('\n');
+    const content = `<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+${symbolsContent}
+</svg>`;
+    return {
+        content,
+        symbols,
+    };
+}
+/**
+ * Generates an SVG sprite from an IconManifest
+ *
+ * @param manifest - Icon manifest with icons
+ * @param options - Sprite generator options
+ * @returns SvgSprite object
+ *
+ * Requirements: 11.2
+ */
+function generateSpriteFromManifest(manifest, options = {}) {
+    return generateSprite(manifest.icons, options);
+}
+/**
+ * Default JSON metadata options
+ */
+const DEFAULT_JSON_OPTIONS = {
+    svgBasePath: 'svg',
+    componentBasePath: 'src/icons',
+};
+/**
+ * Creates a JSON entry for an icon
+ *
+ * @param icon - Icon metadata
+ * @param options - JSON metadata options
+ * @returns IconJsonEntry object
+ */
+function createIconJsonEntry(icon, options = DEFAULT_JSON_OPTIONS) {
+    // Use originalName for SVG file (preserves Chinese characters)
+    const svgFileName = icon.originalName + '.svg';
+    const componentFileName = icon.normalizedName + '.tsx';
+    return {
+        name: icon.normalizedName,
+        originalName: icon.originalName,
+        svgPath: `${options.svgBasePath}/${svgFileName}`,
+        componentPath: `${options.componentBasePath}/${componentFileName}`,
+        size: {
+            width: icon.width,
+            height: icon.height,
+        },
+        createdAt: icon.createdAt,
+    };
+}
+/**
+ * Generates JSON metadata from a list of icons
+ *
+ * @param icons - Array of icon metadata
+ * @param version - Version string
+ * @param options - JSON metadata options
+ * @returns IconsJsonMetadata object
+ *
+ * Requirements: 11.3, 11.5
+ */
+function generateJsonMetadata(icons, version, options = {}) {
+    const opts = { ...DEFAULT_JSON_OPTIONS, ...options };
+    const iconEntries = icons.map((icon) => createIconJsonEntry(icon, opts));
+    // Sort entries alphabetically by name for consistent output
+    // Removed internal sorting to respect the order passed from generate-outputs.ts (which sorts by date)
+    // iconEntries.sort((a, b) => a.name.localeCompare(b.name))
+    return {
+        version,
+        generatedAt: new Date().toISOString(),
+        totalCount: iconEntries.length,
+        icons: iconEntries,
+    };
+}
+/**
+ * Generates JSON metadata from an IconManifest
+ *
+ * @param manifest - Icon manifest
+ * @param options - JSON metadata options
+ * @returns IconsJsonMetadata object
+ *
+ * Requirements: 11.3, 11.5
+ */
+function generateJsonMetadataFromManifest(manifest, options = {}) {
+    return generateJsonMetadata(manifest.icons, manifest.version, options);
+}
+/**
+ * Serializes JSON metadata to a formatted string
+ *
+ * @param metadata - JSON metadata object
+ * @param pretty - Whether to format with indentation
+ * @returns JSON string
+ */
+function serializeJsonMetadata(metadata, pretty = true) {
+    return JSON.stringify(metadata, null, pretty ? 2 : undefined);
+}
+// ============================================
+// Validation Helpers
+// ============================================
+/**
+ * Validates that a sprite has all expected symbols
+ *
+ * @param sprite - Generated sprite
+ * @param expectedIconNames - Expected icon names
+ * @returns Array of missing icon names
+ */
+function validateSpriteCompleteness(sprite, expectedIconNames) {
+    const symbolIds = new Set(sprite.symbols.map((s) => s.id));
+    const missing = [];
+    for (const name of expectedIconNames) {
+        const expectedId = toSymbolId(name);
+        if (!symbolIds.has(expectedId)) {
+            missing.push(name);
+        }
+    }
+    return missing;
+}
+/**
+ * Validates that JSON metadata has all expected icons
+ *
+ * @param metadata - Generated JSON metadata
+ * @param expectedIconNames - Expected icon names
+ * @returns Array of missing icon names
+ */
+function validateJsonMetadataCompleteness(metadata, expectedIconNames) {
+    const metadataNames = new Set(metadata.icons.map((i) => i.name));
+    const missing = [];
+    for (const name of expectedIconNames) {
+        if (!metadataNames.has(name)) {
+            missing.push(name);
+        }
+    }
+    return missing;
+}
+//# sourceMappingURL=multi-format-output.js.map

package/dist/cjs/multi-format-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-format-output.js","sourceRoot":"","sources":["../../src/multi-format-output.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAuCH,gCAiBC;AASD,gDAkBC;AAWD,wCAmCC;AAWD,gEAKC;AAkED,kDAmBC;AAYD,oDAmBC;AAWD,4EAKC;AASD,sDAKC;AAaD,gEAeC;AASD,4EAcC;AA9UD,uDAA0E;AAgB1E;;GAEG;AACH,MAAM,sBAAsB,GAA2B;IACrD,cAAc,EAAE,WAAW;IAC3B,eAAe,EAAE,KAAK;CACvB,CAAA;AAED;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,MAAM,CAAA;IACf,CAAC;IAED,kCAAkC;IAClC,IAAI,SAAS,GAAG,IAAI,CAAA;IACpB,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAChC,CAAC;IAED,6CAA6C;IAC7C,OAAO,SAAS;SACb,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAA;AAClB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,IAAkB,EAClB,UAAkC,sBAAsB;IAExD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;IAC1C,MAAM,OAAO,GACX,IAAA,gCAAc,EAAC,IAAI,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,cAAc,IAAI,WAAW,CAAA;IAC1E,MAAM,OAAO,GAAG,IAAA,wCAAsB,EAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAEvD,OAAO;QACL,EAAE;QACF,OAAO;QACP,OAAO;KACR,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,cAAc,CAC5B,KAAqB,EACrB,UAA2C,EAAE;IAE7C,MAAM,IAAI,GAAG,EAAE,GAAG,sBAAsB,EAAE,GAAG,OAAO,EAAE,CAAA;IAEtD,kDAAkD;IAClD,MAAM,OAAO,GAAmB,EAAE,CAAA;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;QACtB,CAAC;IACH,CAAC;IAED,0DAA0D;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAEhD,0BAA0B;IAC1B,MAAM,cAAc,GAAG,OAAO;SAC3B,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,OAAO;MACnD,CAAC,CAAC,OAAO;YACH,CACP;SACA,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,MAAM,OAAO,GAAG;EAChB,cAAc;OACT,CAAA;IAEL,OAAO;QACL,OAAO;QACP,OAAO;KACR,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,0BAA0B,CACxC,QAAsB,EACtB,UAA2C,EAAE;IAE7C,OAAO,cAAc,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;AAChD,CAAC;AAmDD;;GAEG;AACH,MAAM,oBAAoB,GAAwB;IAChD,WAAW,EAAE,KAAK;IAClB,iBAAiB,EAAE,WAAW;CAC/B,CAAA;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,IAAkB,EAClB,UAA+B,oBAAoB;IAEnD,+DAA+D;IAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,GAAG,MAAM,CAAA;IAC9C,MAAM,iBAAiB,GAAG,IAAI,CAAC,cAAc,GAAG,MAAM,CAAA;IAEtD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,cAAc;QACzB,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,OAAO,EAAE,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,EAAE;QAChD,aAAa,EAAE,GAAG,OAAO,CAAC,iBAAiB,IAAI,iBAAiB,EAAE;QAClE,IAAI,EAAE;YACJ,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB;QACD,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAClC,KAAqB,EACrB,OAAe,EACf,UAAwC,EAAE;IAE1C,MAAM,IAAI,GAAG,EAAE,GAAG,oBAAoB,EAAE,GAAG,OAAO,EAAE,CAAA;IAEpD,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAExE,4DAA4D;IAC5D,sGAAsG;IACtG,2DAA2D;IAE3D,OAAO;QACL,OAAO;QACP,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,UAAU,EAAE,WAAW,CAAC,MAAM;QAC9B,KAAK,EAAE,WAAW;KACnB,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,gCAAgC,CAC9C,QAAsB,EACtB,UAAwC,EAAE;IAE1C,OAAO,oBAAoB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AACxE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CACnC,QAA2B,EAC3B,SAAkB,IAAI;IAEtB,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AAC/D,CAAC;AAED,+CAA+C;AAC/C,qBAAqB;AACrB,+CAA+C;AAE/C;;;;;;GAMG;AACH,SAAgB,0BAA0B,CACxC,MAAiB,EACjB,iBAA2B;IAE3B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1D,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gCAAgC,CAC9C,QAA2B,EAC3B,iBAA2B;IAE3B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IAChE,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/cjs/svg-exporter.js

@@ -0,0 +1,283 @@
+"use strict";
+/**
+ * SVG Batch Export Module
+ *
+ * Provides functions to batch export SVG files from Figma and save them to disk.
+ * Handles concurrent downloads with rate limiting and error handling.
+ *
+ * Requirements: 2.3, 2.4
+ */
+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.sanitizeFilename = sanitizeFilename;
+exports.batchExportSvg = batchExportSvg;
+exports.exportSingleSvg = exportSingleSvg;
+exports.readSvgDirectory = readSvgDirectory;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+/**
+ * Default export options
+ * 降低并发数以减少限速风险
+ */
+const DEFAULT_EXPORT_OPTIONS = {
+    outputDir: './svg',
+    concurrency: 3, // 降低并发数，减少限速风险
+    simplifyStroke: true,
+    includeId: false,
+};
+/**
+ * Ensures the output directory exists
+ *
+ * @param dir - Directory path to create
+ */
+async function ensureDirectory(dir) {
+    try {
+        await fs.mkdir(dir, { recursive: true });
+    }
+    catch (error) {
+        // Directory might already exist, which is fine
+        if (error.code !== 'EEXIST') {
+            throw error;
+        }
+    }
+}
+/**
+ * Sanitizes a filename to be safe for the filesystem
+ *
+ * @param name - Original name
+ * @returns Sanitized filename
+ */
+function sanitizeFilename(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+/**
+ * Saves SVG content to a file
+ *
+ * @param content - SVG content
+ * @param filePath - Path to save the file
+ */
+async function saveSvgFile(content, filePath) {
+    await fs.writeFile(filePath, content, 'utf-8');
+}
+/**
+ * Processes a batch of icons concurrently
+ *
+ * @param items - Items to process
+ * @param processor - Processing function
+ * @param concurrency - Maximum concurrent operations
+ */
+async function processBatch(items, processor, concurrency) {
+    const results = [];
+    const executing = [];
+    for (const item of items) {
+        const promise = processor(item).then((result) => {
+            results.push(result);
+        });
+        executing.push(promise);
+        if (executing.length >= concurrency) {
+            await Promise.race(executing);
+            // Remove completed promises
+            const completed = executing.filter((p) => p.then(() => false).catch(() => false));
+            executing.length = 0;
+            executing.push(...completed);
+        }
+    }
+    await Promise.all(executing);
+    return results;
+}
+/**
+ * Exports SVG files for a list of icon components from Figma
+ *
+ * @param client - Figma API client
+ * @param fileKey - Figma file key
+ * @param icons - List of icon components to export
+ * @param options - Export options
+ * @returns Batch export result
+ */
+async function batchExportSvg(client, fileKey, icons, options) {
+    const opts = { ...DEFAULT_EXPORT_OPTIONS, ...options };
+    const successful = [];
+    const failed = [];
+    // Ensure output directory exists
+    await ensureDirectory(opts.outputDir);
+    // Get image URLs from Figma API
+    const iconIds = icons.map((icon) => icon.id);
+    let imageUrls;
+    try {
+        imageUrls = await client.getImages(fileKey, iconIds, {
+            format: 'svg',
+            svgSimplifyStroke: opts.simplifyStroke,
+            svgIncludeId: opts.includeId,
+        });
+    }
+    catch (error) {
+        // If we can't get image URLs, all icons fail
+        for (const icon of icons) {
+            failed.push({
+                id: icon.id,
+                name: icon.name,
+                success: false,
+                error: error instanceof Error
+                    ? error.message
+                    : 'Failed to get image URLs from Figma',
+            });
+        }
+        return {
+            successful,
+            failed,
+            totalProcessed: icons.length,
+            outputDir: opts.outputDir,
+        };
+    }
+    // Track progress
+    let completed = 0;
+    const total = icons.length;
+    // Process each icon
+    const processIcon = async (icon) => {
+        const imageUrl = imageUrls[icon.id];
+        if (!imageUrl) {
+            return {
+                id: icon.id,
+                name: icon.name,
+                success: false,
+                error: 'No image URL returned from Figma API',
+            };
+        }
+        try {
+            // Download SVG content
+            const svgContent = await client.downloadSvg(imageUrl);
+            // Generate filename and save
+            const filename = `${sanitizeFilename(icon.name)}.svg`;
+            const filePath = path.join(opts.outputDir, filename);
+            await saveSvgFile(svgContent, filePath);
+            completed++;
+            opts.onProgress?.({
+                total,
+                completed,
+                failed: failed.length,
+                current: icon.name,
+            });
+            return {
+                id: icon.id,
+                name: icon.name,
+                success: true,
+                filePath,
+                svgContent,
+            };
+        }
+        catch (error) {
+            completed++;
+            opts.onProgress?.({
+                total,
+                completed,
+                failed: failed.length + 1,
+                current: icon.name,
+            });
+            return {
+                id: icon.id,
+                name: icon.name,
+                success: false,
+                error: error instanceof Error
+                    ? error.message
+                    : 'Unknown error during export',
+            };
+        }
+    };
+    // Process icons with concurrency limit
+    const results = await Promise.all(icons.map((icon) => processIcon(icon)));
+    // Separate successful and failed results
+    for (const result of results) {
+        if (result.success) {
+            successful.push(result);
+        }
+        else {
+            failed.push(result);
+        }
+    }
+    return {
+        successful,
+        failed,
+        totalProcessed: icons.length,
+        outputDir: opts.outputDir,
+    };
+}
+/**
+ * Exports a single SVG from Figma
+ *
+ * @param client - Figma API client
+ * @param fileKey - Figma file key
+ * @param icon - Icon component to export
+ * @param outputDir - Output directory
+ * @returns Export result
+ */
+async function exportSingleSvg(client, fileKey, icon, outputDir) {
+    const result = await batchExportSvg(client, fileKey, [icon], { outputDir });
+    if (result.successful.length > 0) {
+        return result.successful[0];
+    }
+    return result.failed[0];
+}
+/**
+ * Reads all SVG files from a directory
+ *
+ * @param dir - Directory to read from
+ * @returns Map of filename to SVG content
+ */
+async function readSvgDirectory(dir) {
+    const svgMap = new Map();
+    try {
+        const files = await fs.readdir(dir);
+        for (const file of files) {
+            if (file.endsWith('.svg')) {
+                const filePath = path.join(dir, file);
+                const content = await fs.readFile(filePath, 'utf-8');
+                const name = file.replace('.svg', '');
+                svgMap.set(name, content);
+            }
+        }
+    }
+    catch (error) {
+        // Directory might not exist
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    return svgMap;
+}
+//# sourceMappingURL=svg-exporter.js.map

package/dist/cjs/svg-exporter.js.map

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