@hugeicons/migrate-core 0.1.0 → 0.1.2

package/dist/data/mappings.js

@@ -3,14 +3,16 @@
  * Contains exact and alias mappings from source libraries to Hugeicons
  *
  * Uses auto-generated hugeicons-map.json for accurate mappings
+ * Also loads library-specific mappings from the mappings/ directory
  */
-import { readFileSync } from 'node:fs';
+import { readFileSync, existsSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 // Load the JSON file
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const mapPath = join(__dirname, 'hugeicons-map.json');
+const mappingsDir = join(__dirname, 'mappings');
 let ICON_MAP;
 try {
     const content = readFileSync(mapPath, 'utf-8');
@@ -25,131 +27,206 @@ catch {
         icons: {},
         aliasMap: {},
         lucideMap: {},
+        fontawesomeMap: {},
     };
 }
 // ============================================================================
+// Load Library-Specific Mapping Files (generated by generate-library-maps.py)
+// ============================================================================
+/**
+ * Load a library mapping file from the mappings/ directory
+ * Returns an empty object if the file doesn't exist
+ */
+function loadLibraryMapping(libraryName) {
+    const filePath = join(mappingsDir, `${libraryName}.json`);
+    try {
+        if (existsSync(filePath)) {
+            const content = readFileSync(filePath, 'utf-8');
+            return JSON.parse(content);
+        }
+    }
+    catch {
+        // Ignore errors, return empty mapping
+    }
+    return {};
+}
+// Generated library mappings (source icon -> hugeicon)
+// These are the primary mappings, generated by AI and validated
+const GENERATED_MAPPINGS = {
+    fontawesome: loadLibraryMapping('fontawesome'),
+    lucide: loadLibraryMapping('lucide'),
+    heroicons: loadLibraryMapping('heroicons'),
+    material: loadLibraryMapping('material'),
+    feather: loadLibraryMapping('feather'),
+    tabler: loadLibraryMapping('tabler'),
+    phosphor: loadLibraryMapping('phosphor'),
+};
+/**
+ * Get the count of generated mappings for a library
+ */
+export function getGeneratedMappingCount(library) {
+    const mappings = GENERATED_MAPPINGS[library];
+    return mappings ? Object.keys(mappings).length : 0;
+}
+/**
+ * Get mapping from generated library file
+ * This is checked FIRST before manual mappings
+ */
+function getGeneratedMapping(library, iconName) {
+    const mappings = GENERATED_MAPPINGS[library];
+    return mappings?.[iconName];
+}
+// ============================================================================
 // FontAwesome Mappings (manual - these icons have different naming conventions)
 // ============================================================================
 const FONTAWESOME_MAPPINGS = {
-    // Solid icons (fa- prefix style)
+    // NOTE: These mappings are validated against real Hugeicons at runtime
+    // The getFontAwesomeMapping function will fuzzy-match if these don't exist
+    // Arrows & Navigation
     'faArrowDown': 'ArrowDown01Icon',
     'faArrowLeft': 'ArrowLeft01Icon',
     'faArrowRight': 'ArrowRight01Icon',
     'faArrowUp': 'ArrowUp01Icon',
-    'faBell': 'Notification01Icon',
-    'faBolt': 'FlashOnIcon',
-    'faBookmark': 'Bookmark01Icon',
-    'faCalendar': 'Calendar01Icon',
-    'faCalendarAlt': 'Calendar01Icon',
-    'faCamera': 'Camera01Icon',
-    'faCheck': 'Tick01Icon',
-    'faCheckCircle': 'CheckmarkCircle01Icon',
     'faChevronDown': 'ArrowDown01Icon',
     'faChevronLeft': 'ArrowLeft01Icon',
     'faChevronRight': 'ArrowRight01Icon',
     'faChevronUp': 'ArrowUp01Icon',
-    'faCircle': 'CircleIcon',
-    'faClock': 'Clock01Icon',
-    'faCloud': 'Cloud01Icon',
-    'faCog': 'Settings01Icon',
-    'faCogs': 'Settings01Icon',
+    // Actions
+    'faCheck': 'Tick01Icon',
+    'faCheckCircle': 'CheckmarkCircle01Icon',
+    'faCircleCheck': 'CheckmarkCircle01Icon',
+    'faTimes': 'Cancel01Icon',
+    'faXmark': 'Cancel01Icon',
+    'faClose': 'Cancel01Icon',
+    'faRemove': 'Cancel01Icon',
+    'faTimesCircle': 'CancelCircleIcon',
+    'faCircleXmark': 'CancelCircleIcon',
+    'faPlus': 'Add01Icon',
+    'faPlusCircle': 'AddCircleIcon',
+    'faCirclePlus': 'AddCircleIcon',
+    'faMinus': 'MinusSignIcon',
+    'faMinusCircle': 'MinusSignCircleIcon',
+    'faCircleMinus': 'MinusSignCircleIcon',
+    // User & Auth (using correct names)
+    'faUser': 'UserIcon', // UserIcon exists, not User01Icon
+    'faUserPlus': 'UserAdd01Icon', // UserAdd01Icon is the actual name
+    'faUsers': 'UserGroupIcon',
+    'faUserCircle': 'UserCircleIcon',
+    'faCircleUser': 'UserCircleIcon',
+    'faSignIn': 'Login01Icon',
+    'faSignInAlt': 'Login01Icon',
+    'faRightToBracket': 'Login01Icon',
+    'faArrowRightToBracket': 'Login01Icon',
+    'faSignOut': 'Logout01Icon',
+    'faSignOutAlt': 'Logout01Icon',
+    'faRightFromBracket': 'Logout01Icon',
+    'faArrowRightFromBracket': 'Logout01Icon',
+    // Communication
+    'faEnvelope': 'Mail01Icon',
     'faComment': 'Comment01Icon',
     'faComments': 'Comment01Icon',
+    'faPhone': 'Call01Icon',
+    // Media
+    'faImage': 'Image01Icon',
+    'faCamera': 'Camera01Icon',
+    'faVideo': 'Video01Icon',
+    'faPlay': 'PlayIcon',
+    'faPause': 'PauseIcon',
+    'faStop': 'StopIcon',
+    'faVolumeUp': 'VolumeHighIcon',
+    'faVolumeMute': 'VolumeMute01Icon', // VolumeMute01Icon is the actual name
+    // Files & Folders
+    'faFile': 'File01Icon',
+    'faFileAlt': 'File01Icon',
+    'faFolder': 'Folder01Icon',
+    'faFolderOpen': 'FolderOpenIcon',
     'faCopy': 'Copy01Icon',
-    'faCreditCard': 'CreditCardIcon',
+    'faClipboard': 'ClipboardIcon',
     'faDownload': 'Download01Icon',
+    'faUpload': 'Upload01Icon',
+    'faSave': 'FloppyDiskIcon',
+    'faFloppyDisk': 'FloppyDiskIcon',
+    // UI & Interface
+    'faBars': 'Menu01Icon',
+    'faNavicon': 'Menu01Icon',
+    'faCog': 'Settings01Icon',
+    'faCogs': 'Settings01Icon',
+    'faGear': 'Settings01Icon',
+    'faGears': 'Settings01Icon',
+    'faFilter': 'FilterIcon',
+    'faSearch': 'Search01Icon',
+    'faMagnifyingGlass': 'Search01Icon',
     'faEdit': 'Edit01Icon',
-    'faEnvelope': 'Mail01Icon',
+    'faPen': 'Edit01Icon',
+    'faPenToSquare': 'Edit01Icon',
+    'faTrash': 'Delete01Icon',
+    'faTrashAlt': 'Delete01Icon',
+    'faTrashCan': 'Delete01Icon',
+    'faRefresh': 'RefreshIcon',
+    'faRotate': 'RefreshIcon',
+    'faRotateRight': 'RefreshIcon',
+    // Status & Alerts
+    'faBell': 'Notification01Icon',
     'faExclamation': 'AlertCircleIcon',
     'faExclamationCircle': 'AlertCircleIcon',
-    'faExclamationTriangle': 'AlertTriangleIcon',
-    'faExternalLink': 'LinkSquare01Icon',
-    'faExternalLinkAlt': 'LinkSquare01Icon',
-    'faEye': 'View01Icon',
-    'faEyeSlash': 'ViewOffIcon',
-    'faFile': 'File01Icon',
-    'faFileAlt': 'FileAttachmentIcon',
-    'faFilter': 'Filter01Icon',
-    'faFolder': 'Folder01Icon',
-    'faFolderOpen': 'FolderOpenIcon',
-    'faGlobe': 'GlobeIcon',
-    'faHeart': 'Favourite01Icon',
-    'faHome': 'Home01Icon',
-    'faImage': 'Image01Icon',
+    'faExclamationTriangle': 'Alert01Icon',
     'faInfo': 'InformationCircleIcon',
     'faInfoCircle': 'InformationCircleIcon',
-    'faLink': 'Link01Icon',
-    'faList': 'ListIcon',
-    'faLock': 'SquareLock01Icon',
-    'faMapMarker': 'Location01Icon',
-    'faMapMarkerAlt': 'Location01Icon',
-    'faMinus': 'MinusSign01Icon',
-    'faMoon': 'Moon01Icon',
-    'faPause': 'PauseIcon',
-    'faPen': 'Edit01Icon',
-    'faPhone': 'Call01Icon',
-    'faPlay': 'Play01Icon',
-    'faPlus': 'Add01Icon',
-    'faPrint': 'Printer01Icon',
+    'faCircleInfo': 'InformationCircleIcon',
     'faQuestion': 'HelpCircleIcon',
     'faQuestionCircle': 'HelpCircleIcon',
-    'faRefresh': 'Refresh01Icon',
-    'faSearch': 'Search01Icon',
-    'faShare': 'Share01Icon',
-    'faShield': 'ShieldIcon',
-    'faShoppingBag': 'ShoppingBag01Icon',
-    'faShoppingCart': 'ShoppingCart01Icon',
-    'faSignIn': 'Login01Icon',
-    'faSignInAlt': 'Login01Icon',
-    'faSignOut': 'Logout01Icon',
-    'faSignOutAlt': 'Logout01Icon',
-    'faStar': 'Star01Icon',
-    'faStop': 'Stop01Icon',
-    'faSun': 'Sun01Icon',
+    'faCircleQuestion': 'HelpCircleIcon',
+    // Objects
+    'faHome': 'Home01Icon',
+    'faHouse': 'Home01Icon',
+    'faCalendar': 'Calendar01Icon',
+    'faCalendarAlt': 'Calendar01Icon',
+    'faClock': 'Clock01Icon',
+    'faHeart': 'FavouriteIcon',
+    'faStar': 'StarIcon',
+    'faBookmark': 'Bookmark01Icon',
     'faTag': 'Tag01Icon',
     'faTags': 'Tag01Icon',
-    'faTimes': 'Cancel01Icon',
-    'faTimesCircle': 'CancelCircleIcon',
-    'faTrash': 'Delete01Icon',
-    'faTrashAlt': 'Delete02Icon',
+    'faLink': 'Link01Icon',
+    'faExternalLink': 'LinkSquare01Icon',
+    'faExternalLinkAlt': 'LinkSquare01Icon',
+    'faGlobe': 'GlobeIcon',
+    'faMapMarker': 'Location01Icon',
+    'faMapMarkerAlt': 'Location01Icon',
+    'faLock': 'SquareLock01Icon',
     'faUnlock': 'SquareUnlock01Icon',
-    'faUpload': 'Upload01Icon',
-    'faUser': 'User01Icon',
-    'faUserPlus': 'UserAdd01Icon',
-    'faUsers': 'UserGroup01Icon',
-    'faVideo': 'Video01Icon',
-    'faVolumeUp': 'Volume01Icon',
-    'faVolumeMute': 'VolumeMute01Icon',
+    'faKey': 'Key01Icon',
+    'faShield': 'SecurityIcon',
+    'faEye': 'ViewIcon',
+    'faEyeSlash': 'ViewOffIcon',
+    'faSun': 'Sun01Icon',
+    'faMoon': 'Moon01Icon',
+    'faCloud': 'Cloud01Icon',
+    'faBolt': 'FlashIcon',
     'faWifi': 'Wifi01Icon',
-    'faXmark': 'Cancel01Icon',
-    'faGear': 'Settings01Icon',
-    'faGears': 'Settings01Icon',
-    'faBars': 'Menu01Icon',
-    'faNavicon': 'Menu01Icon',
-    'faRemove': 'Cancel01Icon',
-    'faCircleInfo': 'InformationCircleIcon',
-    'faCircleQuestion': 'HelpCircleIcon',
-    'faCircleCheck': 'CheckmarkCircle01Icon',
-    'faCircleXmark': 'CancelCircleIcon',
-    'faCirclePlus': 'AddCircleIcon',
-    'faCircleMinus': 'MinusSignCircleIcon',
-    'faRightFromBracket': 'Logout01Icon',
-    'faRightToBracket': 'Login01Icon',
-    'faArrowRightFromBracket': 'Logout01Icon',
-    'faArrowRightToBracket': 'Login01Icon',
-    'faMagnifyingGlass': 'Search01Icon',
-    'faHouse': 'Home01Icon',
-    'faFloppyDisk': 'Save01Icon',
-    'faPenToSquare': 'Edit01Icon',
-    'faTrashCan': 'Delete01Icon',
-    'faRotate': 'Refresh01Icon',
-    'faRotateRight': 'Refresh01Icon',
-    'faRotateLeft': 'Undo01Icon',
+    'faPrint': 'Printer01Icon',
+    'faCreditCard': 'CreditCardIcon',
+    'faShoppingCart': 'ShoppingCart01Icon',
+    'faShoppingBag': 'ShoppingBag01Icon',
+    'faShare': 'Share01Icon',
+    // Brands (using correct names)
+    'faGithub': 'GithubIcon',
+    'faTwitter': 'TwitterIcon',
+    'faFacebook': 'FacebookIcon',
+    'faLinkedin': 'Linkedin01Icon',
+    'faInstagram': 'InstagramIcon',
+    'faYoutube': 'YoutubeIcon',
+    'faGoogle': 'GoogleIcon',
+    'faApple': 'AppleIcon',
+    'faMicrosoft': 'WindowsNewIcon',
+    'faReact': 'ReactIcon',
+    'faCoffee': 'Coffee01Icon',
 };
 // ============================================================================
 // Heroicons Mappings
 // ============================================================================
 const HEROICONS_MAPPINGS = {
+    // NOTE: These mappings use verified icon names from Hugeicons
     'AcademicCapIcon': 'GraduationCapIcon',
     'ArrowDownIcon': 'ArrowDown01Icon',
     'ArrowLeftIcon': 'ArrowLeft01Icon',
@@ -159,7 +236,7 @@ const HEROICONS_MAPPINGS = {
     'BookmarkIcon': 'Bookmark01Icon',
     'CalendarIcon': 'Calendar01Icon',
     'CameraIcon': 'Camera01Icon',
-    'ChartBarIcon': 'BarChart01Icon',
+    'ChartBarIcon': 'ChartIcon',
     'ChatBubbleLeftIcon': 'Message01Icon',
     'CheckIcon': 'Tick01Icon',
     'CheckCircleIcon': 'CheckmarkCircle01Icon',
@@ -176,12 +253,12 @@ const HEROICONS_MAPPINGS = {
     'DocumentIcon': 'File01Icon',
     'EnvelopeIcon': 'Mail01Icon',
     'ExclamationCircleIcon': 'AlertCircleIcon',
-    'ExclamationTriangleIcon': 'AlertTriangleIcon',
-    'EyeIcon': 'View01Icon',
+    'ExclamationTriangleIcon': 'Alert01Icon',
+    'EyeIcon': 'ViewIcon', // ViewIcon exists
     'EyeSlashIcon': 'ViewOffIcon',
     'FolderIcon': 'Folder01Icon',
     'GlobeAltIcon': 'GlobeIcon',
-    'HeartIcon': 'Favourite01Icon',
+    'HeartIcon': 'FavouriteIcon', // FavouriteIcon exists
     'HomeIcon': 'Home01Icon',
     'InformationCircleIcon': 'InformationCircleIcon',
     'LinkIcon': 'Link01Icon',
@@ -189,21 +266,21 @@ const HEROICONS_MAPPINGS = {
     'LockOpenIcon': 'SquareUnlock01Icon',
     'MagnifyingGlassIcon': 'Search01Icon',
     'MapPinIcon': 'Location01Icon',
-    'MinusIcon': 'MinusSign01Icon',
+    'MinusIcon': 'MinusSignIcon', // MinusSignIcon exists
     'MoonIcon': 'Moon01Icon',
     'PencilIcon': 'Pencil01Icon',
     'PhoneIcon': 'Call01Icon',
     'PhotoIcon': 'Image01Icon',
-    'PlayIcon': 'Play01Icon',
+    'PlayIcon': 'PlayIcon', // PlayIcon exists
     'PlusIcon': 'Add01Icon',
     'QuestionMarkCircleIcon': 'HelpCircleIcon',
     'ShoppingBagIcon': 'ShoppingBag01Icon',
     'ShoppingCartIcon': 'ShoppingCart01Icon',
-    'StarIcon': 'Star01Icon',
+    'StarIcon': 'StarIcon', // StarIcon exists
     'SunIcon': 'Sun01Icon',
     'TrashIcon': 'Delete01Icon',
-    'UserIcon': 'User01Icon',
-    'UserGroupIcon': 'UserGroup01Icon',
+    'UserIcon': 'UserIcon', // UserIcon exists, not User01Icon
+    'UserGroupIcon': 'UserGroupIcon', // UserGroupIcon exists
     'UserPlusIcon': 'UserAdd01Icon',
     'XMarkIcon': 'Cancel01Icon',
     'XCircleIcon': 'CancelCircleIcon',
@@ -217,18 +294,63 @@ const HEROICONS_MAPPINGS = {
  * Library-specific mappings that override or supplement the JSON map
  */
 const LIBRARY_MAPPINGS = {
+    // FontAwesome packages
     '@fortawesome/fontawesome-svg-core': {
         exact: FONTAWESOME_MAPPINGS,
         aliases: {},
     },
+    '@fortawesome/react-fontawesome': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    // FontAwesome Free packages
     '@fortawesome/free-solid-svg-icons': {
         exact: FONTAWESOME_MAPPINGS,
         aliases: {},
     },
-    '@fortawesome/react-fontawesome': {
+    '@fortawesome/free-regular-svg-icons': {
         exact: FONTAWESOME_MAPPINGS,
         aliases: {},
     },
+    '@fortawesome/free-brands-svg-icons': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    // FontAwesome Pro packages
+    '@fortawesome/pro-solid-svg-icons': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    '@fortawesome/pro-regular-svg-icons': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    '@fortawesome/pro-light-svg-icons': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    '@fortawesome/pro-thin-svg-icons': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    '@fortawesome/pro-duotone-svg-icons': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    // FontAwesome Sharp packages
+    '@fortawesome/sharp-solid-svg-icons': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    '@fortawesome/sharp-regular-svg-icons': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    '@fortawesome/sharp-light-svg-icons': {
+        exact: FONTAWESOME_MAPPINGS,
+        aliases: {},
+    },
+    // Heroicons
     '@heroicons/react': {
         exact: HEROICONS_MAPPINGS,
         aliases: {},
@@ -239,6 +361,328 @@ const LIBRARY_MAPPINGS = {
     },
 };
 // ============================================================================
+// FontAwesome Helper Functions
+// ============================================================================
+/**
+ * Normalize FontAwesome icon name for lookup
+ * Handles various FA naming conventions:
+ * - faArrowRight -> ArrowRight
+ * - fa-arrow-right -> ArrowRight
+ * - arrow-right -> ArrowRight
+ */
+export function normalizeFAIconName(name) {
+    // Remove 'fa' prefix (with or without dash)
+    let normalized = name.replace(/^fa-?/i, '');
+    // Convert kebab-case to PascalCase
+    normalized = normalized.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+    // Ensure first letter is uppercase
+    normalized = normalized.charAt(0).toUpperCase() + normalized.slice(1);
+    return normalized;
+}
+/**
+ * Check if a library is a FontAwesome package
+ */
+export function isFontAwesomeLibrary(library) {
+    return library.includes('@fortawesome');
+}
+/**
+ * Calculate Dice coefficient similarity between two strings
+ */
+function diceCoefficient(str1, str2) {
+    if (str1 === str2)
+        return 1;
+    if (str1.length < 2 || str2.length < 2)
+        return 0;
+    const s1 = str1.toLowerCase();
+    const s2 = str2.toLowerCase();
+    const bigrams1 = new Map();
+    for (let i = 0; i < s1.length - 1; i++) {
+        const bigram = s1.substring(i, i + 2);
+        bigrams1.set(bigram, (bigrams1.get(bigram) || 0) + 1);
+    }
+    let intersectionSize = 0;
+    for (let i = 0; i < s2.length - 1; i++) {
+        const bigram = s2.substring(i, i + 2);
+        const count = bigrams1.get(bigram) || 0;
+        if (count > 0) {
+            bigrams1.set(bigram, count - 1);
+            intersectionSize++;
+        }
+    }
+    return (2.0 * intersectionSize) / (s1.length + s2.length - 2);
+}
+/**
+ * Find best fuzzy match for an icon name from available icons
+ */
+function findBestFuzzyMatch(targetName, threshold = 0.5) {
+    const availableIcons = Object.keys(ICON_MAP.icons);
+    if (availableIcons.length === 0)
+        return undefined;
+    // Normalize target for comparison
+    const normalizedTarget = targetName
+        .replace(/^fa-?/i, '')
+        .replace(/Icon$/i, '')
+        .replace(/\d+$/, '')
+        .toLowerCase();
+    let bestMatch = null;
+    for (const icon of availableIcons) {
+        const normalizedIcon = icon
+            .replace(/Icon$/i, '')
+            .replace(/\d+$/, '')
+            .toLowerCase();
+        const score = diceCoefficient(normalizedTarget, normalizedIcon);
+        if (score >= threshold && (!bestMatch || score > bestMatch.score)) {
+            bestMatch = { icon, score };
+        }
+    }
+    return bestMatch?.icon;
+}
+/**
+ * Validate that an icon exists in the library
+ */
+function validateIconExists(iconName) {
+    // Check if it's a valid icon in our library
+    if (ICON_MAP.icons[iconName]) {
+        return iconName;
+    }
+    // Check alias map
+    if (ICON_MAP.aliasMap[iconName]) {
+        return ICON_MAP.aliasMap[iconName];
+    }
+    return undefined;
+}
+/**
+ * Get FontAwesome mapping for an icon name
+ * Priority: Generated mappings -> ICON_MAP -> Manual mappings -> Fuzzy match
+ */
+export function getFontAwesomeMapping(iconName) {
+    // Helper to validate and return mapping
+    const validateMapping = (mapping) => {
+        if (!mapping)
+            return undefined;
+        const validated = validateIconExists(mapping);
+        if (validated)
+            return validated;
+        // Try fuzzy match if the mapped icon doesn't exist
+        return findBestFuzzyMatch(mapping);
+    };
+    // 1. Check GENERATED mappings first (highest priority)
+    const generated = getGeneratedMapping('fontawesome', iconName);
+    if (generated) {
+        const result = validateMapping(generated);
+        if (result)
+            return result;
+    }
+    // Try with 'fa' prefix in generated mappings
+    if (!iconName.startsWith('fa')) {
+        const withPrefix = `fa${iconName.charAt(0).toUpperCase()}${iconName.slice(1)}`;
+        const generatedWithPrefix = getGeneratedMapping('fontawesome', withPrefix);
+        if (generatedWithPrefix) {
+            const result = validateMapping(generatedWithPrefix);
+            if (result)
+                return result;
+        }
+    }
+    // 2. Check ICON_MAP (from hugeicons-map.json)
+    if (ICON_MAP.fontawesomeMap?.[iconName]) {
+        const result = validateMapping(ICON_MAP.fontawesomeMap[iconName]);
+        if (result)
+            return result;
+    }
+    // Try with 'fa' prefix if not present
+    if (!iconName.startsWith('fa')) {
+        const withPrefix = `fa${iconName.charAt(0).toUpperCase()}${iconName.slice(1)}`;
+        if (ICON_MAP.fontawesomeMap?.[withPrefix]) {
+            const result = validateMapping(ICON_MAP.fontawesomeMap[withPrefix]);
+            if (result)
+                return result;
+        }
+    }
+    // Try normalized name
+    const normalized = normalizeFAIconName(iconName);
+    if (ICON_MAP.fontawesomeMap?.[normalized]) {
+        const result = validateMapping(ICON_MAP.fontawesomeMap[normalized]);
+        if (result)
+            return result;
+    }
+    // 3. Fall back to MANUAL mappings with validation
+    if (FONTAWESOME_MAPPINGS[iconName]) {
+        const result = validateMapping(FONTAWESOME_MAPPINGS[iconName]);
+        if (result)
+            return result;
+    }
+    // Try with 'fa' prefix in manual mappings
+    if (!iconName.startsWith('fa')) {
+        const withPrefix = `fa${iconName.charAt(0).toUpperCase()}${iconName.slice(1)}`;
+        if (FONTAWESOME_MAPPINGS[withPrefix]) {
+            const result = validateMapping(FONTAWESOME_MAPPINGS[withPrefix]);
+            if (result)
+                return result;
+        }
+    }
+    // 4. Last resort: fuzzy matching on the icon name itself
+    const fuzzyMatch = findBestFuzzyMatch(iconName);
+    if (fuzzyMatch)
+        return fuzzyMatch;
+    return undefined;
+}
+/**
+ * Get Lucide mapping for an icon name
+ * Priority: Generated mappings -> ICON_MAP -> Fuzzy match
+ */
+export function getLucideMapping(iconName) {
+    const validateMapping = (mapping) => {
+        if (!mapping)
+            return undefined;
+        const validated = validateIconExists(mapping);
+        if (validated)
+            return validated;
+        return findBestFuzzyMatch(mapping);
+    };
+    // 1. Check GENERATED mappings first
+    const generated = getGeneratedMapping('lucide', iconName);
+    if (generated) {
+        const result = validateMapping(generated);
+        if (result)
+            return result;
+    }
+    // Try without Icon suffix
+    const withoutIcon = iconName.replace(/Icon$/, '');
+    if (withoutIcon !== iconName) {
+        const generatedWithoutIcon = getGeneratedMapping('lucide', withoutIcon);
+        if (generatedWithoutIcon) {
+            const result = validateMapping(generatedWithoutIcon);
+            if (result)
+                return result;
+        }
+    }
+    // 2. Check ICON_MAP
+    if (ICON_MAP.lucideMap?.[iconName]) {
+        const result = validateMapping(ICON_MAP.lucideMap[iconName]);
+        if (result)
+            return result;
+    }
+    if (ICON_MAP.lucideMap?.[withoutIcon]) {
+        const result = validateMapping(ICON_MAP.lucideMap[withoutIcon]);
+        if (result)
+            return result;
+    }
+    // 3. Fuzzy match
+    return findBestFuzzyMatch(iconName);
+}
+/**
+ * Get Heroicons mapping for an icon name
+ */
+export function getHeroiconsMapping(iconName) {
+    const validateMapping = (mapping) => {
+        if (!mapping)
+            return undefined;
+        const validated = validateIconExists(mapping);
+        if (validated)
+            return validated;
+        return findBestFuzzyMatch(mapping);
+    };
+    // 1. Check GENERATED mappings first
+    const generated = getGeneratedMapping('heroicons', iconName);
+    if (generated) {
+        const result = validateMapping(generated);
+        if (result)
+            return result;
+    }
+    // 2. Check manual HEROICONS_MAPPINGS
+    if (HEROICONS_MAPPINGS[iconName]) {
+        const result = validateMapping(HEROICONS_MAPPINGS[iconName]);
+        if (result)
+            return result;
+    }
+    // 3. Fuzzy match
+    return findBestFuzzyMatch(iconName);
+}
+/**
+ * Get Material Icons mapping for an icon name
+ */
+export function getMaterialMapping(iconName) {
+    const validateMapping = (mapping) => {
+        if (!mapping)
+            return undefined;
+        const validated = validateIconExists(mapping);
+        if (validated)
+            return validated;
+        return findBestFuzzyMatch(mapping);
+    };
+    // Check GENERATED mappings
+    const generated = getGeneratedMapping('material', iconName);
+    if (generated) {
+        const result = validateMapping(generated);
+        if (result)
+            return result;
+    }
+    return findBestFuzzyMatch(iconName);
+}
+/**
+ * Get Feather Icons mapping for an icon name
+ */
+export function getFeatherMapping(iconName) {
+    const validateMapping = (mapping) => {
+        if (!mapping)
+            return undefined;
+        const validated = validateIconExists(mapping);
+        if (validated)
+            return validated;
+        return findBestFuzzyMatch(mapping);
+    };
+    // Check GENERATED mappings
+    const generated = getGeneratedMapping('feather', iconName);
+    if (generated) {
+        const result = validateMapping(generated);
+        if (result)
+            return result;
+    }
+    return findBestFuzzyMatch(iconName);
+}
+/**
+ * Get Tabler Icons mapping for an icon name
+ */
+export function getTablerMapping(iconName) {
+    const validateMapping = (mapping) => {
+        if (!mapping)
+            return undefined;
+        const validated = validateIconExists(mapping);
+        if (validated)
+            return validated;
+        return findBestFuzzyMatch(mapping);
+    };
+    // Check GENERATED mappings
+    const generated = getGeneratedMapping('tabler', iconName);
+    if (generated) {
+        const result = validateMapping(generated);
+        if (result)
+            return result;
+    }
+    return findBestFuzzyMatch(iconName);
+}
+/**
+ * Get Phosphor Icons mapping for an icon name
+ */
+export function getPhosphorMapping(iconName) {
+    const validateMapping = (mapping) => {
+        if (!mapping)
+            return undefined;
+        const validated = validateIconExists(mapping);
+        if (validated)
+            return validated;
+        return findBestFuzzyMatch(mapping);
+    };
+    // Check GENERATED mappings
+    const generated = getGeneratedMapping('phosphor', iconName);
+    if (generated) {
+        const result = validateMapping(generated);
+        if (result)
+            return result;
+    }
+    return findBestFuzzyMatch(iconName);
+}
+// ============================================================================
 // Public API
 // ============================================================================
 /**
@@ -271,6 +715,7 @@ export function getLucideAliasIfExists(iconName) {
 /**
  * Get exact mapping for a library and icon
  * For Lucide icons, prefers keeping the original name if it exists as an alias
+ * For FontAwesome icons, handles various naming conventions
  */
 export function getExactMapping(library, iconName) {
     // Check library-specific mappings first
@@ -278,6 +723,19 @@ export function getExactMapping(library, iconName) {
     if (libraryMappings?.exact[iconName]) {
         return libraryMappings.exact[iconName];
     }
+    // For FontAwesome libraries
+    if (isFontAwesomeLibrary(library)) {
+        const faMapping = getFontAwesomeMapping(iconName);
+        if (faMapping) {
+            return faMapping;
+        }
+        // Try normalized name in aliasMap as fallback
+        const normalized = normalizeFAIconName(iconName);
+        const aliasMatch = ICON_MAP.aliasMap[normalized] || ICON_MAP.aliasMap[`${normalized}Icon`];
+        if (aliasMatch) {
+            return aliasMatch;
+        }
+    }
     // For lucide-react and similar
     if (library === 'lucide-react' || library === 'lucide') {
         // Check if this Lucide name is a direct alias (e.g., "Home" -> "HomeIcon")
@@ -294,6 +752,36 @@ export function getExactMapping(library, iconName) {
         const withIcon = iconName.endsWith('Icon') ? iconName : `${iconName}Icon`;
         return ICON_MAP.lucideMap[withoutIcon] || ICON_MAP.lucideMap[withIcon];
     }
+    // Heroicons
+    if (library === '@heroicons/react' || library.startsWith('@heroicons/react/')) {
+        const mapping = getHeroiconsMapping(iconName);
+        if (mapping)
+            return mapping;
+    }
+    // Material Icons
+    if (library === '@mui/icons-material') {
+        const mapping = getMaterialMapping(iconName);
+        if (mapping)
+            return mapping;
+    }
+    // Feather Icons
+    if (library === 'react-feather' || library === 'feather-icons-react') {
+        const mapping = getFeatherMapping(iconName);
+        if (mapping)
+            return mapping;
+    }
+    // Tabler Icons
+    if (library === '@tabler/icons-react' || library === 'tabler-icons-react') {
+        const mapping = getTablerMapping(iconName);
+        if (mapping)
+            return mapping;
+    }
+    // Phosphor Icons
+    if (library === '@phosphor-icons/react' || library === 'phosphor-react') {
+        const mapping = getPhosphorMapping(iconName);
+        if (mapping)
+            return mapping;
+    }
     // Fallback: try aliasMap for any library
     return ICON_MAP.aliasMap[iconName];
 }
@@ -396,7 +884,23 @@ export function getMapStats() {
         totalIcons: ICON_MAP.totalIcons,
         totalAliases: ICON_MAP.totalAliases,
         lucideMappings: Object.keys(ICON_MAP.lucideMap).length,
+        fontawesomeMappings: Object.keys(ICON_MAP.fontawesomeMap || {}).length,
         generated: ICON_MAP.generated,
+        generatedMappings: {
+            fontawesome: getGeneratedMappingCount('fontawesome'),
+            lucide: getGeneratedMappingCount('lucide'),
+            heroicons: getGeneratedMappingCount('heroicons'),
+            material: getGeneratedMappingCount('material'),
+            feather: getGeneratedMappingCount('feather'),
+            tabler: getGeneratedMappingCount('tabler'),
+            phosphor: getGeneratedMappingCount('phosphor'),
+        },
     };
 }
+/**
+ * Get the FontAwesome mapping dictionary
+ */
+export function getFontAwesomeMap() {
+    return ICON_MAP.fontawesomeMap || {};
+}
 //# sourceMappingURL=mappings.js.map