@zleap-ai/icons 0.0.28

package/dist/cjs/figma-client.js

@@ -0,0 +1,260 @@
+"use strict";
+/**
+ * Figma API Client
+ *
+ * Provides methods to interact with the Figma API for fetching files and exporting images.
+ * Implements error handling and retry logic for robust API interactions.
+ *
+ * Requirements: 2.1, 2.5
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FigmaClient = exports.FigmaApiError = exports.FigmaErrorCode = void 0;
+exports.createFigmaClient = createFigmaClient;
+/**
+ * Figma API base URL
+ */
+const FIGMA_API_BASE = 'https://api.figma.com/v1';
+/**
+ * Default retry configuration
+ * 针对 Figma API 限速优化：
+ * - Starter/Pro 用户: Tier 1 限制 10次/分钟
+ * - Organization 用户: Tier 1 限制 15次/分钟
+ * - Enterprise 用户: Tier 1 限制 20次/分钟
+ */
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 5,
+    baseDelayMs: 2000,
+    maxDelayMs: 60000, // 最长等待 60 秒
+};
+/**
+ * Figma API error codes
+ */
+var FigmaErrorCode;
+(function (FigmaErrorCode) {
+    FigmaErrorCode["INVALID_TOKEN"] = "FIGMA_INVALID_TOKEN";
+    FigmaErrorCode["RATE_LIMIT"] = "FIGMA_RATE_LIMIT";
+    FigmaErrorCode["FILE_NOT_FOUND"] = "FIGMA_FILE_NOT_FOUND";
+    FigmaErrorCode["NETWORK_ERROR"] = "FIGMA_NETWORK_ERROR";
+    FigmaErrorCode["UNKNOWN_ERROR"] = "FIGMA_UNKNOWN_ERROR";
+})(FigmaErrorCode || (exports.FigmaErrorCode = FigmaErrorCode = {}));
+/**
+ * Custom error class for Figma API errors
+ */
+class FigmaApiError extends Error {
+    constructor(code, message, recoverable = false, suggestion, details) {
+        super(message);
+        this.code = code;
+        this.recoverable = recoverable;
+        this.suggestion = suggestion;
+        this.details = details;
+        this.name = 'FigmaApiError';
+    }
+    toErrorResponse() {
+        return {
+            code: this.code,
+            message: this.message,
+            recoverable: this.recoverable,
+            suggestion: this.suggestion,
+            details: this.details,
+        };
+    }
+}
+exports.FigmaApiError = FigmaApiError;
+/**
+ * Figma API Client class
+ */
+class FigmaClient {
+    constructor(token, retryConfig = {}) {
+        if (!token) {
+            throw new FigmaApiError(FigmaErrorCode.INVALID_TOKEN, 'Figma API token is required', false, 'Please provide a valid Figma Personal Access Token');
+        }
+        this.token = token;
+        this.retryConfig = { ...DEFAULT_RETRY_CONFIG, ...retryConfig };
+    }
+    /**
+     * Makes an authenticated request to the Figma API with retry logic
+     * Properly handles Retry-After header for rate limiting
+     */
+    async fetchWithRetry(url, options = {}) {
+        let lastError = null;
+        let delay = this.retryConfig.baseDelayMs;
+        for (let attempt = 0; attempt <= this.retryConfig.maxRetries; attempt++) {
+            try {
+                const response = await fetch(url, {
+                    ...options,
+                    headers: {
+                        'X-Figma-Token': this.token,
+                        ...options.headers,
+                    },
+                });
+                if (response.ok) {
+                    return (await response.json());
+                }
+                // Handle rate limiting with Retry-After header
+                if (response.status === 429) {
+                    const retryAfter = response.headers.get('Retry-After');
+                    if (retryAfter) {
+                        // Retry-After is in seconds, convert to ms and add buffer
+                        const waitTime = (parseInt(retryAfter, 10) + 1) * 1000;
+                        console.log(`⏳ 限速中，等待 ${retryAfter} 秒后重试...`);
+                        await this.sleep(waitTime);
+                        // Don't count this as an attempt since we're respecting the server's request
+                        attempt--;
+                        continue;
+                    }
+                }
+                // Handle specific HTTP errors
+                const errorBody = await response.text();
+                const error = this.handleHttpError(response.status, errorBody);
+                // Don't retry non-recoverable errors
+                if (!error.recoverable) {
+                    throw error;
+                }
+                lastError = error;
+            }
+            catch (error) {
+                if (error instanceof FigmaApiError && !error.recoverable) {
+                    throw error;
+                }
+                lastError =
+                    error instanceof Error
+                        ? error
+                        : new FigmaApiError(FigmaErrorCode.UNKNOWN_ERROR, 'Unknown error occurred', true);
+            }
+            // Wait before retrying (exponential backoff)
+            if (attempt < this.retryConfig.maxRetries) {
+                console.log(`⏳ 重试中 (${attempt + 1}/${this.retryConfig.maxRetries})，等待 ${Math.min(delay, this.retryConfig.maxDelayMs) / 1000} 秒...`);
+                await this.sleep(Math.min(delay, this.retryConfig.maxDelayMs));
+                delay *= 2;
+            }
+        }
+        throw (lastError ||
+            new FigmaApiError(FigmaErrorCode.UNKNOWN_ERROR, 'Request failed after retries', false));
+    }
+    /**
+     * Handles HTTP error responses and converts them to FigmaApiError
+     */
+    handleHttpError(status, body) {
+        switch (status) {
+            case 401:
+            case 403:
+                return new FigmaApiError(FigmaErrorCode.INVALID_TOKEN, 'Invalid or expired Figma API token', false, 'Please check your Figma Personal Access Token and ensure it has the required permissions');
+            case 404:
+                return new FigmaApiError(FigmaErrorCode.FILE_NOT_FOUND, 'Figma file not found', false, 'Please verify the file key and ensure you have access to the file', { responseBody: body });
+            case 429:
+                return new FigmaApiError(FigmaErrorCode.RATE_LIMIT, 'Figma API rate limit exceeded', true, 'The request will be retried automatically with exponential backoff');
+            default:
+                return new FigmaApiError(FigmaErrorCode.UNKNOWN_ERROR, `Figma API error: HTTP ${status}`, status >= 500, // Server errors are recoverable
+                status >= 500
+                    ? 'Server error, retrying...'
+                    : 'Please check the request parameters', { status, responseBody: body });
+        }
+    }
+    /**
+     * Sleep utility for retry delays
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Gets a Figma file by its key
+     *
+     * @param fileKey - The Figma file key
+     * @returns The file data including document structure and components
+     */
+    async getFile(fileKey) {
+        if (!fileKey) {
+            throw new FigmaApiError(FigmaErrorCode.FILE_NOT_FOUND, 'File key is required', false, 'Please provide a valid Figma file key');
+        }
+        const url = `${FIGMA_API_BASE}/files/${fileKey}`;
+        return this.fetchWithRetry(url);
+    }
+    /**
+     * Exports images for specified node IDs
+     *
+     * @param fileKey - The Figma file key
+     * @param nodeIds - Array of node IDs to export
+     * @param options - Export options (format, scale, etc.)
+     * @returns Map of node IDs to image URLs
+     */
+    async getImages(fileKey, nodeIds, options = { format: 'svg' }) {
+        if (!fileKey) {
+            throw new FigmaApiError(FigmaErrorCode.FILE_NOT_FOUND, 'File key is required', false, 'Please provide a valid Figma file key');
+        }
+        if (!nodeIds || nodeIds.length === 0) {
+            return {};
+        }
+        const params = new URLSearchParams({
+            ids: nodeIds.join(','),
+            format: options.format,
+        });
+        if (options.scale !== undefined) {
+            params.set('scale', options.scale.toString());
+        }
+        if (options.format === 'svg') {
+            if (options.svgIncludeId !== undefined) {
+                params.set('svg_include_id', options.svgIncludeId.toString());
+            }
+            if (options.svgSimplifyStroke !== undefined) {
+                params.set('svg_simplify_stroke', options.svgSimplifyStroke.toString());
+            }
+        }
+        const url = `${FIGMA_API_BASE}/images/${fileKey}?${params.toString()}`;
+        const response = await this.fetchWithRetry(url);
+        if (response.err) {
+            throw new FigmaApiError(FigmaErrorCode.UNKNOWN_ERROR, `Failed to export images: ${response.err}`, false, 'Please check the node IDs and try again');
+        }
+        return response.images;
+    }
+    /**
+     * Downloads SVG content from a URL
+     *
+     * @param url - The URL to download from
+     * @returns The SVG content as a string
+     */
+    async downloadSvg(url) {
+        let lastError = null;
+        let delay = this.retryConfig.baseDelayMs;
+        for (let attempt = 0; attempt <= this.retryConfig.maxRetries; attempt++) {
+            try {
+                const response = await fetch(url);
+                if (response.ok) {
+                    return await response.text();
+                }
+                if (response.status >= 500) {
+                    lastError = new FigmaApiError(FigmaErrorCode.NETWORK_ERROR, `Failed to download SVG: HTTP ${response.status}`, true);
+                }
+                else {
+                    throw new FigmaApiError(FigmaErrorCode.NETWORK_ERROR, `Failed to download SVG: HTTP ${response.status}`, false);
+                }
+            }
+            catch (error) {
+                if (error instanceof FigmaApiError && !error.recoverable) {
+                    throw error;
+                }
+                lastError =
+                    error instanceof Error
+                        ? error
+                        : new FigmaApiError(FigmaErrorCode.NETWORK_ERROR, 'Network error while downloading SVG', true);
+            }
+            if (attempt < this.retryConfig.maxRetries) {
+                await this.sleep(Math.min(delay, this.retryConfig.maxDelayMs));
+                delay *= 2;
+            }
+        }
+        throw (lastError ||
+            new FigmaApiError(FigmaErrorCode.NETWORK_ERROR, 'Failed to download SVG after retries', false));
+    }
+}
+exports.FigmaClient = FigmaClient;
+/**
+ * Creates a new Figma client instance
+ *
+ * @param token - Figma Personal Access Token
+ * @param retryConfig - Optional retry configuration
+ * @returns A new FigmaClient instance
+ */
+function createFigmaClient(token, retryConfig) {
+    return new FigmaClient(token, retryConfig);
+}
+//# sourceMappingURL=figma-client.js.map

package/dist/cjs/figma-client.js.map

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

package/dist/cjs/icon-filter.js

@@ -0,0 +1,278 @@
+"use strict";
+/**
+ * Icon Component Filtering Module
+ *
+ * Provides functions to filter and identify icon components from Figma file data.
+ * Filters components based on type and naming conventions.
+ *
+ * Requirements: 2.2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_FILTER_CONFIG = exports.DEFAULT_ICON_NAME_PATTERN = void 0;
+exports.matchesIconNamingConvention = matchesIconNamingConvention;
+exports.hasValidIconDimensions = hasValidIconDimensions;
+exports.isComponentType = isComponentType;
+exports.filterIconComponent = filterIconComponent;
+exports.filterIconComponents = filterIconComponents;
+exports.extractComponentIds = extractComponentIds;
+exports.filterIconsFromNodes = filterIconsFromNodes;
+/**
+ * Default icon naming pattern - matches lowercase names with hyphens
+ * Examples: "arrow-right", "check-circle", "user-profile"
+ */
+exports.DEFAULT_ICON_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
+/**
+ * Default filter configuration
+ */
+exports.DEFAULT_FILTER_CONFIG = {
+    namePattern: exports.DEFAULT_ICON_NAME_PATTERN,
+    minSize: 8,
+    maxSize: 128,
+};
+/**
+ * Checks if a component matches the icon naming convention
+ *
+ * @param name - Component name to check
+ * @param config - Filter configuration
+ * @returns True if the name matches the icon naming convention
+ */
+function matchesIconNamingConvention(name, config = exports.DEFAULT_FILTER_CONFIG) {
+    if (!name || typeof name !== 'string') {
+        return false;
+    }
+    // Check name pattern
+    if (!config.namePattern.test(name)) {
+        return false;
+    }
+    // Check prefix if specified
+    if (config.namePrefix && !name.startsWith(config.namePrefix)) {
+        return false;
+    }
+    // Check suffix if specified
+    if (config.nameSuffix && !name.endsWith(config.nameSuffix)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Checks if a component has valid icon dimensions
+ *
+ * @param width - Component width
+ * @param height - Component height
+ * @param config - Filter configuration
+ * @returns True if dimensions are within valid range
+ */
+function hasValidIconDimensions(width, height, config = exports.DEFAULT_FILTER_CONFIG) {
+    if (typeof width !== 'number' || typeof height !== 'number') {
+        return false;
+    }
+    if (width <= 0 || height <= 0) {
+        return false;
+    }
+    if (config.minSize !== undefined) {
+        if (width < config.minSize || height < config.minSize) {
+            return false;
+        }
+    }
+    if (config.maxSize !== undefined) {
+        if (width > config.maxSize || height > config.maxSize) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Checks if a Figma node is a COMPONENT or FRAME type (SVGs are imported as frames)
+ *
+ * @param node - Figma node or component to check
+ * @returns True if the node is a COMPONENT or FRAME type
+ */
+function isComponentType(node) {
+    return node && (node.type === 'COMPONENT' || node.type === 'FRAME');
+}
+/**
+ * Filters a single component to determine if it's a valid icon
+ *
+ * @param component - Figma component to check
+ * @param config - Filter configuration
+ * @returns Object with isIcon flag and reason if not an icon
+ */
+function filterIconComponent(component, config = exports.DEFAULT_FILTER_CONFIG) {
+    // Check if it's a component type
+    if (!isComponentType(component)) {
+        return { isIcon: false, reason: 'Not a COMPONENT type' };
+    }
+    // Check naming convention
+    if (!matchesIconNamingConvention(component.name, config)) {
+        return {
+            isIcon: false,
+            reason: `Name "${component.name}" does not match icon naming convention`,
+        };
+    }
+    // Check dimensions
+    const { width, height } = component.absoluteBoundingBox || {
+        width: 0,
+        height: 0,
+    };
+    if (!hasValidIconDimensions(width, height, config)) {
+        return {
+            isIcon: false,
+            reason: `Dimensions ${width}x${height} are outside valid range`,
+        };
+    }
+    return { isIcon: true };
+}
+/**
+ * Filters icon components from a Figma file response
+ * Searches both the components map and the document tree for FRAME nodes (imported SVGs)
+ *
+ * @param fileResponse - Figma file API response
+ * @param config - Filter configuration
+ * @returns Filter result with icons and skipped components
+ */
+function filterIconComponents(fileResponse, config = exports.DEFAULT_FILTER_CONFIG) {
+    const icons = [];
+    const skipped = [];
+    const processedIds = new Set();
+    // First, process components from the components map
+    const components = fileResponse.components || {};
+    const componentEntries = Object.entries(components);
+    for (const [id, component] of componentEntries) {
+        processedIds.add(id);
+        const result = filterIconComponent(component, config);
+        if (result.isIcon) {
+            const { width, height } = component.absoluteBoundingBox;
+            icons.push({
+                id,
+                name: component.name,
+                width,
+                height,
+                original: component,
+            });
+        }
+        else {
+            skipped.push({
+                id,
+                name: component.name,
+                reason: result.reason || 'Unknown reason',
+            });
+        }
+    }
+    // Then, traverse the document tree to find FRAME nodes (imported SVGs)
+    if (fileResponse.document) {
+        traverseForFrames(fileResponse.document, config, icons, skipped, processedIds);
+    }
+    return {
+        icons,
+        skipped,
+        totalProcessed: processedIds.size,
+    };
+}
+/**
+ * Recursively traverses the document tree to find FRAME nodes that could be icons
+ */
+function traverseForFrames(node, config, icons, skipped, processedIds) {
+    // Skip if already processed
+    if (processedIds.has(node.id)) {
+        return;
+    }
+    // Check if this is a FRAME that could be an icon
+    if (node.type === 'FRAME' && node.absoluteBoundingBox) {
+        processedIds.add(node.id);
+        const { width, height } = node.absoluteBoundingBox;
+        // Check if dimensions are valid for an icon
+        if (hasValidIconDimensions(width, height, config)) {
+            // Check aspect ratio - icons should be roughly square
+            const aspectRatio = width / height;
+            if (aspectRatio >= 0.5 && aspectRatio <= 2) {
+                // Create a component-like object
+                const component = {
+                    id: node.id,
+                    name: node.name,
+                    type: 'FRAME',
+                    absoluteBoundingBox: { width, height },
+                };
+                // Use a more lenient name check for frames
+                const nameIsValid = config.namePattern.test(node.name) ||
+                    /^[a-zA-Z][a-zA-Z0-9-_\s]*$/.test(node.name);
+                if (nameIsValid) {
+                    icons.push({
+                        id: node.id,
+                        name: node.name,
+                        width,
+                        height,
+                        original: component,
+                    });
+                }
+                else {
+                    skipped.push({
+                        id: node.id,
+                        name: node.name,
+                        reason: `Name "${node.name}" does not match icon naming convention`,
+                    });
+                }
+            }
+        }
+    }
+    // Recursively process children
+    if (node.children && Array.isArray(node.children)) {
+        for (const child of node.children) {
+            traverseForFrames(child, config, icons, skipped, processedIds);
+        }
+    }
+}
+/**
+ * Extracts component IDs from filtered icons
+ *
+ * @param icons - Array of filtered icon components
+ * @returns Array of component IDs
+ */
+function extractComponentIds(icons) {
+    return icons.map((icon) => icon.id);
+}
+/**
+ * Filters components from a mixed list of Figma nodes
+ * Recursively searches through the node tree to find COMPONENT nodes
+ *
+ * @param nodes - Array of Figma nodes
+ * @param config - Filter configuration
+ * @returns Array of filtered icon components
+ */
+function filterIconsFromNodes(nodes, config = exports.DEFAULT_FILTER_CONFIG) {
+    const icons = [];
+    function traverse(node) {
+        if (node.type === 'COMPONENT') {
+            // Create a FigmaComponent-like object for filtering
+            const component = {
+                id: node.id,
+                name: node.name,
+                type: 'COMPONENT',
+                absoluteBoundingBox: {
+                    width: 24, // Default size if not available
+                    height: 24,
+                },
+            };
+            const result = filterIconComponent(component, config);
+            if (result.isIcon) {
+                icons.push({
+                    id: node.id,
+                    name: node.name,
+                    width: component.absoluteBoundingBox.width,
+                    height: component.absoluteBoundingBox.height,
+                    original: component,
+                });
+            }
+        }
+        // Recursively process children
+        if (node.children && Array.isArray(node.children)) {
+            for (const child of node.children) {
+                traverse(child);
+            }
+        }
+    }
+    for (const node of nodes) {
+        traverse(node);
+    }
+    return icons;
+}
+//# sourceMappingURL=icon-filter.js.map

package/dist/cjs/icon-filter.js.map

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

package/dist/cjs/icon-search.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Icon search/filter functionality
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterIcons = filterIcons;
+exports.iconMatchesQuery = iconMatchesQuery;
+/**
+ * Filter icons by search query
+ * Returns only icons whose names contain the search query (case-insensitive)
+ *
+ * @param icons - Array of icon objects
+ * @param query - Search query string
+ * @returns Filtered icons matching the query
+ */
+function filterIcons(icons, query) {
+    if (!query || query.trim() === '') {
+        return icons;
+    }
+    const normalizedQuery = query.toLowerCase().trim();
+    return icons.filter((icon) => {
+        const name = (icon.name || '').toLowerCase();
+        const originalName = (icon.originalName || '').toLowerCase();
+        return (name.includes(normalizedQuery) || originalName.includes(normalizedQuery));
+    });
+}
+/**
+ * Check if an icon matches a search query
+ *
+ * @param icon - Icon object to check
+ * @param query - Search query string
+ * @returns True if icon matches the query
+ */
+function iconMatchesQuery(icon, query) {
+    if (!query || query.trim() === '') {
+        return true;
+    }
+    const normalizedQuery = query.toLowerCase().trim();
+    const name = (icon.name || '').toLowerCase();
+    const originalName = (icon.originalName || '').toLowerCase();
+    return (name.includes(normalizedQuery) || originalName.includes(normalizedQuery));
+}
+//# sourceMappingURL=icon-search.js.map

package/dist/cjs/icon-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-search.js","sourceRoot":"","sources":["../../src/icon-search.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAqBH,kCAcC;AASD,4CAYC;AA3CD;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,KAAiB,EAAE,KAAa;IAC1D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAA;IAElD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;QAC5C,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;QAC5D,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,CACzE,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,IAAc,EAAE,KAAa;IAC5D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,eAAe,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAA;IAClD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IAC5C,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IAE5D,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,CACzE,CAAA;AACH,CAAC"}