@zleap-ai/icons 0.0.28

package/dist/esm/version-manager.js

@@ -0,0 +1,167 @@
+/**
+ * Version Manager Module
+ *
+ * Provides semantic version suggestions based on icon changes.
+ * Follows SemVer conventions:
+ * - major: breaking changes (icon removals)
+ * - minor: new features (icon additions)
+ * - patch: bug fixes (icon modifications only)
+ *
+ * Requirements: 13.1, 13.2, 13.3, 13.4
+ */
+/**
+ * Suggests a semantic version bump type based on icon changes
+ *
+ * Rules (per Requirements 13.1-13.4):
+ * - If icons are removed → major (breaking change)
+ * - If icons are added (with or without modifications) → minor (new feature)
+ * - If only icons are modified → patch (bug fix)
+ * - If no changes → patch (default)
+ *
+ * @param diff - The icon diff containing added, modified, and removed icons
+ * @returns VersionSuggestion with bump type and reason
+ *
+ * Requirements: 13.1, 13.2, 13.3, 13.4
+ */
+export function suggestVersionBump(diff) {
+    const hasRemovals = diff.removed.length > 0;
+    const hasAdditions = diff.added.length > 0;
+    const hasModifications = diff.modified.length > 0;
+    // Rule 1: Removals are breaking changes → major
+    // Requirements: 13.3
+    if (hasRemovals) {
+        const removedCount = diff.removed.length;
+        const reason = removedCount === 1
+            ? `1 icon removed (breaking change)`
+            : `${removedCount} icons removed (breaking change)`;
+        return {
+            bumpType: 'major',
+            reason,
+        };
+    }
+    // Rule 2: Additions are new features → minor
+    // Requirements: 13.2
+    if (hasAdditions) {
+        const addedCount = diff.added.length;
+        const modifiedCount = diff.modified.length;
+        let reason = addedCount === 1 ? `1 icon added` : `${addedCount} icons added`;
+        if (modifiedCount > 0) {
+            reason +=
+                modifiedCount === 1
+                    ? `, 1 icon modified`
+                    : `, ${modifiedCount} icons modified`;
+        }
+        return {
+            bumpType: 'minor',
+            reason,
+        };
+    }
+    // Rule 3: Only modifications → patch
+    // Requirements: 13.4
+    if (hasModifications) {
+        const modifiedCount = diff.modified.length;
+        const reason = modifiedCount === 1
+            ? `1 icon modified`
+            : `${modifiedCount} icons modified`;
+        return {
+            bumpType: 'patch',
+            reason,
+        };
+    }
+    // No changes → default to patch
+    return {
+        bumpType: 'patch',
+        reason: 'No changes detected',
+    };
+}
+/**
+ * Increments a semantic version string based on bump type
+ *
+ * @param currentVersion - Current version string (e.g., "1.2.3")
+ * @param bumpType - Type of version bump
+ * @returns New version string
+ *
+ * Requirements: 13.1
+ */
+export function incrementVersion(currentVersion, bumpType) {
+    const parts = parseVersion(currentVersion);
+    switch (bumpType) {
+        case 'major':
+            return `${parts.major + 1}.0.0`;
+        case 'minor':
+            return `${parts.major}.${parts.minor + 1}.0`;
+        case 'patch':
+            return `${parts.major}.${parts.minor}.${parts.patch + 1}`;
+    }
+}
+/**
+ * Parses a semantic version string into components
+ *
+ * @param version - Version string (e.g., "1.2.3")
+ * @returns Parsed version components
+ * @throws Error if version format is invalid
+ */
+export function parseVersion(version) {
+    // Remove 'v' prefix if present
+    const cleanVersion = version.startsWith('v') ? version.slice(1) : version;
+    const match = cleanVersion.match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!match) {
+        throw new Error(`Invalid version format: ${version}`);
+    }
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+        patch: parseInt(match[3], 10),
+    };
+}
+/**
+ * Validates a semantic version string
+ *
+ * @param version - Version string to validate
+ * @returns True if valid semantic version
+ */
+export function isValidVersion(version) {
+    try {
+        parseVersion(version);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Compares two semantic versions
+ *
+ * @param a - First version
+ * @param b - Second version
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ */
+export function compareVersions(a, b) {
+    const parsedA = parseVersion(a);
+    const parsedB = parseVersion(b);
+    if (parsedA.major !== parsedB.major) {
+        return parsedA.major < parsedB.major ? -1 : 1;
+    }
+    if (parsedA.minor !== parsedB.minor) {
+        return parsedA.minor < parsedB.minor ? -1 : 1;
+    }
+    if (parsedA.patch !== parsedB.patch) {
+        return parsedA.patch < parsedB.patch ? -1 : 1;
+    }
+    return 0;
+}
+/**
+ * Suggests a new version based on current version and icon diff
+ *
+ * Convenience function that combines suggestVersionBump and incrementVersion.
+ *
+ * @param currentVersion - Current version string
+ * @param diff - Icon diff
+ * @returns Object with suggested version and reason
+ */
+export function suggestNewVersion(currentVersion, diff) {
+    const suggestion = suggestVersionBump(diff);
+    const version = incrementVersion(currentVersion, suggestion.bumpType);
+    return { version, suggestion };
+}
+//# sourceMappingURL=version-manager.js.map

package/dist/esm/version-manager.js.map

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

package/dist/types/changelog-generator.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Changelog Generator Module
+ *
+ * Generates changelog entries by comparing icon manifests and
+ * producing Markdown-formatted version history.
+ *
+ * Requirements: 10.1, 10.2, 10.3, 10.4, 10.5
+ */
+import type { IconManifest, IconMetadata, IconDiff, ChangelogEntry } from './types';
+/**
+ * Computes the diff between two icon manifests
+ *
+ * Identifies icons that were added, modified, or removed between versions.
+ * Modification is detected by comparing SVG content when available,
+ * or by comparing dimensions if SVG content is not present.
+ *
+ * @param currentManifest - The new/current manifest
+ * @param previousManifest - The old/previous manifest
+ * @returns IconDiff containing added, modified, and removed icons
+ *
+ * Requirements: 10.3
+ */
+export declare function computeIconDiff(currentManifest: IconManifest, previousManifest: IconManifest): IconDiff;
+/**
+ * Determines if an icon has changed between versions
+ *
+ * @param current - Current version of the icon
+ * @param previous - Previous version of the icon
+ * @returns True if the icon has changed
+ */
+export declare function hasIconChanged(current: IconMetadata, previous: IconMetadata): boolean;
+/**
+ * Checks if a diff has any changes
+ *
+ * @param diff - The icon diff to check
+ * @returns True if there are any changes
+ */
+export declare function hasChanges(diff: IconDiff): boolean;
+/**
+ * Options for changelog generation
+ */
+export interface ChangelogOptions {
+    /** Version number for the release */
+    version: string;
+    /** Update message from the designer */
+    message: string;
+    /** Optional date override (defaults to current date) */
+    date?: string;
+}
+/**
+ * Formats a date to ISO format (YYYY-MM-DD)
+ *
+ * @param date - Date to format (defaults to current date)
+ * @returns ISO formatted date string
+ */
+export declare function formatDate(date?: Date | string): string;
+/**
+ * Creates a ChangelogEntry from a diff and options
+ *
+ * @param diff - The icon diff
+ * @param options - Changelog generation options
+ * @returns ChangelogEntry object
+ *
+ * Requirements: 10.2, 10.4, 10.5
+ */
+export declare function createChangelogEntry(diff: IconDiff, options: ChangelogOptions): ChangelogEntry;
+/**
+ * Generates a Markdown-formatted changelog entry
+ *
+ * @param entry - The changelog entry to format
+ * @returns Markdown string
+ *
+ * Requirements: 10.1, 10.2, 10.4, 10.5
+ */
+export declare function generateChangelogMarkdown(entry: ChangelogEntry): string;
+/**
+ * Generates a complete changelog entry from two manifests
+ *
+ * This is a convenience function that combines diff computation
+ * and markdown generation.
+ *
+ * @param currentManifest - The new/current manifest
+ * @param previousManifest - The old/previous manifest
+ * @param options - Changelog generation options
+ * @returns Markdown-formatted changelog entry
+ *
+ * Requirements: 10.1, 10.2, 10.3, 10.4, 10.5
+ */
+export declare function generateChangelog(currentManifest: IconManifest, previousManifest: IconManifest, options: ChangelogOptions): string;
+/**
+ * Prepends a new changelog entry to an existing changelog file content
+ *
+ * @param existingContent - Existing CHANGELOG.md content
+ * @param newEntry - New changelog entry markdown
+ * @returns Updated changelog content
+ */
+export declare function prependToChangelog(existingContent: string, newEntry: string): string;
+/**
+ * Creates an initial CHANGELOG.md content with header
+ *
+ * @param projectName - Name of the project
+ * @returns Initial changelog content
+ */
+export declare function createInitialChangelog(projectName?: string): string;
+/**
+ * Parses a changelog entry from markdown
+ *
+ * @param markdown - Markdown content of a single entry
+ * @returns Parsed ChangelogEntry or null if parsing fails
+ */
+export declare function parseChangelogEntry(markdown: string): ChangelogEntry | null;
+//# sourceMappingURL=changelog-generator.d.ts.map

package/dist/types/changelog-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog-generator.d.ts","sourceRoot":"","sources":["../../src/changelog-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EAEf,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,eAAe,EAAE,YAAY,EAC7B,gBAAgB,EAAE,YAAY,GAC7B,QAAQ,CAqCV;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAYT;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAIlD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IACf,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAWvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,gBAAgB,GACxB,cAAc,CAahB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA+CvE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,YAAY,EAC7B,gBAAgB,EAAE,YAAY,EAC9B,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,CAcR;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,GAAE,MAAuB,GACnC,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA6B3E"}

package/dist/types/component-generator.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Component Generator Module
+ *
+ * Handles React component generation from optimized SVG content.
+ * Requirements: 4.1, 4.2, 4.3, 4.5, 4.6
+ */
+import type { IconMetadata, ComponentTemplate } from './types';
+/**
+ * Converts a string to PascalCase format
+ *
+ * Handles various input formats:
+ * - kebab-case: "arrow-right" -> "ArrowRight"
+ * - snake_case: "arrow_right" -> "ArrowRight"
+ * - space separated: "arrow right" -> "ArrowRight"
+ * - mixed: "arrow-right_up" -> "ArrowRightUp"
+ * - already PascalCase: "ArrowRight" -> "ArrowRight"
+ * - camelCase: "arrowRight" -> "ArrowRight"
+ *
+ * @param str - Input string in any format
+ * @returns PascalCase formatted string
+ *
+ * Requirements: 4.3
+ */
+export declare function toPascalCase(str: string): string;
+/**
+ * Generates a valid React component name from an icon name
+ *
+ * @param iconName - Original icon name
+ * @param prefix - Prefix to add (default: "Icon")
+ * @returns Valid React component name
+ *
+ * Requirements: 4.3
+ */
+export declare function generateComponentName(iconName: string, prefix?: string): string;
+/**
+ * Generates a React component template from icon metadata and JSX content
+ *
+ * @param icon - Icon metadata
+ * @param jsxContent - JSX-compatible SVG content
+ * @returns ComponentTemplate with component code and type definitions
+ *
+ * Requirements: 4.1, 4.2, 4.6
+ */
+export declare function generateComponent(icon: IconMetadata, jsxContent: string, rawSvgContent?: string): ComponentTemplate;
+/**
+ * Generates multiple component templates from a list of icons
+ *
+ * @param icons - Array of icon metadata with JSX content
+ * @returns Array of ComponentTemplate objects
+ *
+ * Requirements: 4.1, 4.2, 4.6
+ */
+export declare function generateComponents(icons: Array<{
+    metadata: IconMetadata;
+    jsxContent: string;
+}>): ComponentTemplate[];
+/**
+ * Result of generating an index file
+ */
+export interface IndexFileResult {
+    /** The generated index.ts content */
+    content: string;
+    /** List of all exported component names */
+    componentNames: string[];
+    /** The allIcons object export */
+    allIconsExport: string;
+    /** The IconName type definition */
+    iconNameType: string;
+}
+/**
+ * Generates the index.ts file content that exports all icon components
+ *
+ * @param components - Array of ComponentTemplate objects
+ * @returns IndexFileResult with the generated content
+ *
+ * Requirements: 4.5
+ */
+export declare function generateIndexFile(components: ComponentTemplate[]): IndexFileResult;
+/**
+ * Generates a minimal index file for a subset of icons
+ *
+ * @param componentNames - Array of component names to export
+ * @returns The generated index.ts content
+ *
+ * Requirements: 4.5
+ */
+export declare function generateMinimalIndexFile(componentNames: string[]): string;
+//# sourceMappingURL=component-generator.d.ts.map

package/dist/types/component-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-generator.d.ts","sourceRoot":"","sources":["../../src/component-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAG9D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAwBhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAe,GACtB,MAAM,CAMR;AAuHD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,iBAAiB,CA2KnB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GAC3D,iBAAiB,EAAE,CAIrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,2CAA2C;IAC3C,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,iBAAiB,EAAE,GAC9B,eAAe,CA4DjB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,CAwBzE"}

package/dist/types/figma-client.d.ts

@@ -0,0 +1,107 @@
+/**
+ * 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
+ */
+import type { FigmaFileResponse, ErrorResponse } from './types';
+/**
+ * Figma API error codes
+ */
+export declare enum FigmaErrorCode {
+    INVALID_TOKEN = "FIGMA_INVALID_TOKEN",
+    RATE_LIMIT = "FIGMA_RATE_LIMIT",
+    FILE_NOT_FOUND = "FIGMA_FILE_NOT_FOUND",
+    NETWORK_ERROR = "FIGMA_NETWORK_ERROR",
+    UNKNOWN_ERROR = "FIGMA_UNKNOWN_ERROR"
+}
+/**
+ * Custom error class for Figma API errors
+ */
+export declare class FigmaApiError extends Error {
+    code: FigmaErrorCode;
+    recoverable: boolean;
+    suggestion?: string | undefined;
+    details?: unknown | undefined;
+    constructor(code: FigmaErrorCode, message: string, recoverable?: boolean, suggestion?: string | undefined, details?: unknown | undefined);
+    toErrorResponse(): ErrorResponse;
+}
+/**
+ * Retry configuration options
+ */
+export interface RetryConfig {
+    maxRetries: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+}
+/**
+ * Image export options for Figma API
+ */
+export interface ImageExportOptions {
+    format: 'svg' | 'png' | 'jpg' | 'pdf';
+    scale?: number;
+    svgIncludeId?: boolean;
+    svgSimplifyStroke?: boolean;
+}
+/**
+ * Response from Figma images API
+ */
+export interface FigmaImagesResponse {
+    err: string | null;
+    images: Record<string, string>;
+}
+/**
+ * Figma API Client class
+ */
+export declare class FigmaClient {
+    private token;
+    private retryConfig;
+    constructor(token: string, retryConfig?: Partial<RetryConfig>);
+    /**
+     * Makes an authenticated request to the Figma API with retry logic
+     * Properly handles Retry-After header for rate limiting
+     */
+    private fetchWithRetry;
+    /**
+     * Handles HTTP error responses and converts them to FigmaApiError
+     */
+    private handleHttpError;
+    /**
+     * Sleep utility for retry delays
+     */
+    private sleep;
+    /**
+     * Gets a Figma file by its key
+     *
+     * @param fileKey - The Figma file key
+     * @returns The file data including document structure and components
+     */
+    getFile(fileKey: string): Promise<FigmaFileResponse>;
+    /**
+     * 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
+     */
+    getImages(fileKey: string, nodeIds: string[], options?: ImageExportOptions): Promise<Record<string, string>>;
+    /**
+     * Downloads SVG content from a URL
+     *
+     * @param url - The URL to download from
+     * @returns The SVG content as a string
+     */
+    downloadSvg(url: string): Promise<string>;
+}
+/**
+ * Creates a new Figma client instance
+ *
+ * @param token - Figma Personal Access Token
+ * @param retryConfig - Optional retry configuration
+ * @returns A new FigmaClient instance
+ */
+export declare function createFigmaClient(token: string, retryConfig?: Partial<RetryConfig>): FigmaClient;
+//# sourceMappingURL=figma-client.d.ts.map

package/dist/types/figma-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma-client.d.ts","sourceRoot":"","sources":["../../src/figma-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAGjB,aAAa,EACd,MAAM,SAAS,CAAA;AAoBhB;;GAEG;AACH,oBAAY,cAAc;IACxB,aAAa,wBAAwB;IACrC,UAAU,qBAAqB;IAC/B,cAAc,yBAAyB;IACvC,aAAa,wBAAwB;IACrC,aAAa,wBAAwB;CACtC;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAE7B,IAAI,EAAE,cAAc;IAEpB,WAAW,EAAE,OAAO;IACpB,UAAU,CAAC,EAAE,MAAM;IACnB,OAAO,CAAC,EAAE,OAAO;gBAJjB,IAAI,EAAE,cAAc,EAC3B,OAAO,EAAE,MAAM,EACR,WAAW,GAAE,OAAe,EAC5B,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,OAAO,CAAC,EAAE,OAAO,YAAA;IAM1B,eAAe,IAAI,aAAa;CASjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,WAAW,CAAa;gBAEpB,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,OAAO,CAAC,WAAW,CAAM;IAajE;;;OAGG;YACW,cAAc;IAkF5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAyCvB;;OAEG;IACH,OAAO,CAAC,KAAK;IAIb;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAc1D;;;;;;;OAOG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE,kBAAsC,GAC9C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA+ClC;;;;;OAKG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAuDhD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GACjC,WAAW,CAEb"}

package/dist/types/icon-filter.d.ts

@@ -0,0 +1,126 @@
+/**
+ * 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
+ */
+import type { FigmaComponent, FigmaNode, FigmaFileResponse } from './types';
+/**
+ * Default icon naming pattern - matches lowercase names with hyphens
+ * Examples: "arrow-right", "check-circle", "user-profile"
+ */
+export declare const DEFAULT_ICON_NAME_PATTERN: RegExp;
+/**
+ * Icon filter configuration
+ */
+export interface IconFilterConfig {
+    /** Pattern to match icon names */
+    namePattern: RegExp;
+    /** Prefix that icon names should start with (optional) */
+    namePrefix?: string;
+    /** Suffix that icon names should end with (optional) */
+    nameSuffix?: string;
+    /** Minimum icon size in pixels */
+    minSize?: number;
+    /** Maximum icon size in pixels */
+    maxSize?: number;
+}
+/**
+ * Default filter configuration
+ */
+export declare const DEFAULT_FILTER_CONFIG: IconFilterConfig;
+/**
+ * Filtered icon component with additional metadata
+ */
+export interface FilteredIconComponent {
+    /** Component ID */
+    id: string;
+    /** Component name */
+    name: string;
+    /** Component width */
+    width: number;
+    /** Component height */
+    height: number;
+    /** Original Figma component data */
+    original: FigmaComponent;
+}
+/**
+ * Result of filtering operation
+ */
+export interface FilterResult {
+    /** Successfully filtered icon components */
+    icons: FilteredIconComponent[];
+    /** Components that were skipped (not matching criteria) */
+    skipped: Array<{
+        id: string;
+        name: string;
+        reason: string;
+    }>;
+    /** Total components processed */
+    totalProcessed: number;
+}
+/**
+ * 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
+ */
+export declare function matchesIconNamingConvention(name: string, config?: IconFilterConfig): boolean;
+/**
+ * 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
+ */
+export declare function hasValidIconDimensions(width: number, height: number, config?: IconFilterConfig): boolean;
+/**
+ * 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
+ */
+export declare function isComponentType(node: FigmaNode | FigmaComponent | {
+    type?: string;
+}): boolean;
+/**
+ * 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
+ */
+export declare function filterIconComponent(component: FigmaComponent, config?: IconFilterConfig): {
+    isIcon: boolean;
+    reason?: string;
+};
+/**
+ * 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
+ */
+export declare function filterIconComponents(fileResponse: FigmaFileResponse, config?: IconFilterConfig): FilterResult;
+/**
+ * Extracts component IDs from filtered icons
+ *
+ * @param icons - Array of filtered icon components
+ * @returns Array of component IDs
+ */
+export declare function extractComponentIds(icons: FilteredIconComponent[]): string[];
+/**
+ * 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
+ */
+export declare function filterIconsFromNodes(nodes: FigmaNode[], config?: IconFilterConfig): FilteredIconComponent[];
+//# sourceMappingURL=icon-filter.d.ts.map

package/dist/types/icon-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-filter.d.ts","sourceRoot":"","sources":["../../src/icon-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE3E;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QAAsB,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,gBAInC,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,oCAAoC;IACpC,QAAQ,EAAE,cAAc,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,KAAK,EAAE,qBAAqB,EAAE,CAAA;IAC9B,2DAA2D;IAC3D,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAA;QACV,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,MAAM,CAAA;KACf,CAAC,CAAA;IACF,iCAAiC;IACjC,cAAc,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,gBAAwC,GAC/C,OAAO,CAqBT;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,gBAAwC,GAC/C,OAAO,CAsBT;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,cAAc,EACzB,MAAM,GAAE,gBAAwC,GAC/C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CA2BtC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,iBAAiB,EAC/B,MAAM,GAAE,gBAAwC,GAC/C,YAAY,CA+Cd;AAmED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,EAAE,GAAG,MAAM,EAAE,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,GAAE,gBAAwC,GAC/C,qBAAqB,EAAE,CAyCzB"}

package/dist/types/icon-search.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Icon search/filter functionality
+ */
+export interface IconInfo {
+    name: string;
+    originalName: string;
+    svgPath?: string;
+    componentPath?: string;
+    size?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * 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
+ */
+export declare function filterIcons(icons: IconInfo[], query: string): IconInfo[];
+/**
+ * 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
+ */
+export declare function iconMatchesQuery(icon: IconInfo, query: string): boolean;
+//# sourceMappingURL=icon-search.d.ts.map

package/dist/types/icon-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-search.d.ts","sourceRoot":"","sources":["../../src/icon-search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAcxE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAYvE"}