@zleap-ai/icons 0.0.28

package/dist/esm/svg-exporter.js

@@ -0,0 +1,244 @@
+/**
+ * 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
+ */
+import * as fs from 'fs/promises';
+import * as path from '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
+ */
+export 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
+ */
+export 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
+ */
+export 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
+ */
+export 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/esm/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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"}

package/dist/esm/svg-transformer.js

@@ -0,0 +1,314 @@
+/**
+ * SVG Transformer Module
+ *
+ * Handles SVG optimization using SVGO and conversion to JSX format.
+ * Requirements: 3.1, 3.2, 3.3, 3.4, 3.5, 3.6
+ */
+import { optimize } from 'svgo';
+/**
+ * 自定义 SVGO 插件：清理 Figma 导出的 SVG 问题元素
+ * - 移除超大背景路径（设计稿背景泄漏）
+ * - 移除 clipPath 内的填充路径
+ * - 移除不需要的白色/透明填充背景
+ */
+const cleanFigmaExport = {
+    name: 'cleanFigmaExport',
+    fn: () => {
+        return {
+            element: {
+                enter: (node, parentNode) => {
+                    // 移除超大尺寸的背景路径（如 d="M0 0h1440v1024H0z"）
+                    if (node.name === 'path' && node.attributes.d) {
+                        const d = node.attributes.d;
+                        // 检测矩形路径，尺寸超过 500 的视为设计稿背景
+                        const rectMatch = d.match(/M[0\s-]*[0\s-]*[hH](\d+)[vV](\d+)/);
+                        if (rectMatch) {
+                            const width = parseInt(rectMatch[1], 10);
+                            const height = parseInt(rectMatch[2], 10);
+                            if (width > 500 || height > 500) {
+                                // 从父节点移除此元素
+                                if (parentNode.type === 'element' && parentNode.children) {
+                                    const index = parentNode.children.indexOf(node);
+                                    if (index > -1) {
+                                        parentNode.children.splice(index, 1);
+                                    }
+                                }
+                                return;
+                            }
+                        }
+                    }
+                    // 移除 clipPath 定义中的纯白色填充路径
+                    if (node.name === 'clipPath') {
+                        if (node.children) {
+                            node.children = node.children.filter((child) => {
+                                if (child.type === 'element' && child.name === 'path') {
+                                    const fill = child.attributes?.fill;
+                                    // 保留非白色填充的元素
+                                    return fill !== 'white' && fill !== '#fff' && fill !== '#ffffff';
+                                }
+                                return true;
+                            });
+                        }
+                    }
+                    // 移除带有 transform="translate(负值)" 的大背景
+                    if (node.name === 'path' && node.attributes.transform) {
+                        const transform = node.attributes.transform;
+                        if (transform.includes('translate(-') && node.attributes.d) {
+                            const d = node.attributes.d;
+                            // 如果是大矩形路径，移除
+                            if (d.match(/[hH]\d{3,}[vV]\d{3,}/)) {
+                                if (parentNode.type === 'element' && parentNode.children) {
+                                    const index = parentNode.children.indexOf(node);
+                                    if (index > -1) {
+                                        parentNode.children.splice(index, 1);
+                                    }
+                                }
+                            }
+                        }
+                    }
+                },
+            },
+        };
+    },
+};
+/**
+ * Default SVGO configuration for icon optimization
+ * - Removes dimensions (width/height)
+ * - Preserves original colors (不替换为 currentColor)
+ * - Removes unnecessary metadata
+ * - Cleans up Figma export artifacts
+ */
+export const defaultSvgoConfig = {
+    plugins: [
+        {
+            name: 'preset-default',
+            params: {
+                overrides: {
+                    // 禁用颜色转换，保留原始颜色
+                    convertColors: false,
+                    // 禁用移除 viewBox
+                    removeViewBox: false,
+                    // 禁用移除未使用的 defs（保留渐变定义）
+                    removeUselessDefs: false,
+                    // 禁用移除未知属性（保留 stop-color 等属性）
+                    removeUnknownsAndDefaults: false,
+                    // 禁用合并路径（可能影响渐变引用）
+                    mergePaths: false,
+                    // 禁用路径转换（保留原始路径数据）
+                    convertPathData: {
+                        floatPrecision: 3,
+                    },
+                },
+            },
+        },
+        'removeDimensions',
+        'removeXMLNS',
+        // 添加自定义清理插件
+        cleanFigmaExport,
+    ],
+};
+/**
+ * Default transformation options
+ */
+export const defaultTransformOptions = {
+    replaceColors: true,
+    removeSize: true,
+    removeFill: true,
+    addViewBox: true,
+};
+/**
+ * Optimizes SVG content using SVGO
+ *
+ * @param svgContent - Raw SVG string
+ * @param config - Optional SVGO configuration override
+ * @returns Optimized SVG string
+ *
+ * Requirements: 3.1, 3.2, 3.3, 3.4
+ */
+export function optimizeSvg(svgContent, config = defaultSvgoConfig) {
+    const result = optimize(svgContent, config);
+    return result.data;
+}
+/**
+ * Map of SVG attribute names to their JSX equivalents
+ */
+const svgToJsxAttributeMap = {
+    class: 'className',
+    'stroke-width': 'strokeWidth',
+    'stroke-linecap': 'strokeLinecap',
+    'stroke-linejoin': 'strokeLinejoin',
+    'stroke-dasharray': 'strokeDasharray',
+    'stroke-dashoffset': 'strokeDashoffset',
+    'stroke-miterlimit': 'strokeMiterlimit',
+    'stroke-opacity': 'strokeOpacity',
+    'fill-rule': 'fillRule',
+    'fill-opacity': 'fillOpacity',
+    'clip-rule': 'clipRule',
+    'clip-path': 'clipPath',
+    'font-family': 'fontFamily',
+    'font-size': 'fontSize',
+    'font-style': 'fontStyle',
+    'font-weight': 'fontWeight',
+    'text-anchor': 'textAnchor',
+    'text-decoration': 'textDecoration',
+    'dominant-baseline': 'dominantBaseline',
+    'alignment-baseline': 'alignmentBaseline',
+    'baseline-shift': 'baselineShift',
+    'stop-color': 'stopColor',
+    'stop-opacity': 'stopOpacity',
+    'color-interpolation': 'colorInterpolation',
+    'color-interpolation-filters': 'colorInterpolationFilters',
+    'flood-color': 'floodColor',
+    'flood-opacity': 'floodOpacity',
+    'lighting-color': 'lightingColor',
+    'marker-start': 'markerStart',
+    'marker-mid': 'markerMid',
+    'marker-end': 'markerEnd',
+    'paint-order': 'paintOrder',
+    'shape-rendering': 'shapeRendering',
+    'vector-effect': 'vectorEffect',
+    'pointer-events': 'pointerEvents',
+    'xlink:href': 'xlinkHref',
+    'xml:space': 'xmlSpace',
+    'xmlns:xlink': 'xmlnsXlink',
+};
+/**
+ * Converts a kebab-case attribute name to camelCase
+ *
+ * @param attr - Attribute name in kebab-case
+ * @returns Attribute name in camelCase
+ */
+export function kebabToCamelCase(attr) {
+    // Check if it's a known SVG attribute that needs special handling
+    if (svgToJsxAttributeMap[attr]) {
+        return svgToJsxAttributeMap[attr];
+    }
+    // Convert kebab-case to camelCase
+    return attr.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+/**
+ * Converts SVG content to JSX-compatible format
+ *
+ * Transforms attribute names from kebab-case to camelCase
+ * as required by React/JSX.
+ *
+ * @param svgContent - SVG string with standard attribute names
+ * @returns SVG string with JSX-compatible attribute names
+ *
+ * Requirements: 3.5
+ */
+export function convertToJsx(svgContent) {
+    // Match all attributes in the SVG
+    // Pattern: attribute-name="value" or attribute-name='value'
+    return svgContent.replace(/\s([a-z][a-z0-9]*(?:-[a-z0-9]+)+)=/gi, (_, attrName) => {
+        const jsxAttrName = kebabToCamelCase(attrName.toLowerCase());
+        return ` ${jsxAttrName}=`;
+    });
+}
+/**
+ * Transforms SVG content: optimizes and converts to JSX format
+ *
+ * @param svgContent - Raw SVG string
+ * @param options - Transformation options
+ * @param svgoConfig - Optional SVGO configuration override
+ * @returns TransformResult with original/optimized sizes and content
+ *
+ * Requirements: 3.1, 3.2, 3.3, 3.4, 3.5, 3.6
+ */
+export function transformSvg(svgContent, _options = defaultTransformOptions, svgoConfig = defaultSvgoConfig) {
+    const originalSize = svgContent.length;
+    // Optimize SVG with SVGO
+    // Note: _options is reserved for future use when custom transform options are needed
+    const optimizedSvg = optimizeSvg(svgContent, svgoConfig);
+    // Convert to JSX format
+    const jsxContent = convertToJsx(optimizedSvg);
+    return {
+        originalSize,
+        optimizedSize: optimizedSvg.length,
+        svgContent: optimizedSvg,
+        jsxContent,
+    };
+}
+/**
+ * Extracts the inner content of an SVG element (everything between <svg> tags)
+ *
+ * @param svgContent - Full SVG string
+ * @returns Inner content of the SVG
+ */
+export function extractSvgInnerContent(svgContent) {
+    // Match content between <svg ...> and </svg>
+    const match = svgContent.match(/<svg[^>]*>([\s\S]*)<\/svg>/i);
+    return match ? match[1].trim() : '';
+}
+/**
+ * Extracts the viewBox attribute from an SVG string
+ *
+ * @param svgContent - SVG string
+ * @returns viewBox value or null if not found
+ */
+export function extractViewBox(svgContent) {
+    const match = svgContent.match(/viewBox=["']([^"']+)["']/i);
+    return match ? match[1] : null;
+}
+/**
+ * Extracts the fill attribute from the root SVG element
+ *
+ * @param svgContent - SVG string
+ * @returns fill value or null if not found
+ */
+export function extractSvgRootFill(svgContent) {
+    const match = svgContent.match(/<svg[^>]*\sfill=["']([^"']+)["']/i);
+    return match ? match[1] : null;
+}
+/**
+ * Checks if SVG content contains width/height attributes
+ *
+ * @param svgContent - SVG string
+ * @returns true if width or height attributes are present
+ */
+export function hasFixedDimensions(svgContent) {
+    const widthMatch = svgContent.match(/<svg[^>]*\swidth=["'][^"']+["']/i);
+    const heightMatch = svgContent.match(/<svg[^>]*\sheight=["'][^"']+["']/i);
+    return !!(widthMatch || heightMatch);
+}
+/**
+ * Checks if SVG content uses currentColor for fill
+ *
+ * @param svgContent - SVG string
+ * @returns true if fill="currentColor" is present on the svg element
+ */
+export function usesCurrentColor(svgContent) {
+    // Check if the SVG element has fill="currentColor"
+    const svgTagMatch = svgContent.match(/<svg[^>]*>/i);
+    if (!svgTagMatch)
+        return false;
+    return /fill=["']currentColor["']/i.test(svgTagMatch[0]);
+}
+/**
+ * Checks if all attribute names in SVG are in JSX camelCase format
+ *
+ * @param svgContent - SVG string
+ * @returns true if all attributes are in camelCase
+ */
+export function hasJsxAttributes(svgContent) {
+    // List of common kebab-case SVG attributes that should be converted
+    const kebabAttributes = [
+        'stroke-width',
+        'stroke-linecap',
+        'stroke-linejoin',
+        'fill-rule',
+        'clip-rule',
+        'clip-path',
+        'font-family',
+        'font-size',
+    ];
+    for (const attr of kebabAttributes) {
+        // Check if the kebab-case version exists (it shouldn't after conversion)
+        const regex = new RegExp(`\\s${attr}=`, 'i');
+        if (regex.test(svgContent)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=svg-transformer.js.map

package/dist/esm/svg-transformer.js.map

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

package/dist/esm/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

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