@hugeicons/core-free-icons 1.2.0 → 2.0.0

package/README.md

@@ -60,7 +60,7 @@ Loads the entire icon library (use when you need many icons dynamically):
 const { Home01Icon } = await import('@hugeicons/core-free-icons');
 ```
 
-#### 3. Dynamic Import - Individual Icons
+#### 3. Dynamic Import - Individual Icons (NEW ✨)
 Loads only the specific icon you need (99% smaller bundle size):
 
 ```javascript
@@ -69,125 +69,16 @@ const icon = await import('@hugeicons/core-free-icons/Home01Icon');
 const Home01Icon = icon.default;
 ```
 
-#### 4. Dynamic Loader Functions (NEW ✨ Recommended)
-The most efficient way to load icons dynamically with built-in caching:
-
-```javascript
-import { loadIcon, loadIcons } from '@hugeicons/core-free-icons/loader';
-
-// Load single icon
-const homeIcon = await loadIcon('Home01Icon');
-
-// Load multiple icons (parallel loading)
-const icons = await loadIcons(['Calendar01Icon', 'UserIcon', 'SearchIcon']);
-
-// Check if icon exists
-const exists = await iconExists('Home01Icon'); // true
-```
-
-**Loader Benefits:**
-- ✅ **Automatic Caching** - Icons are cached after first load
-- ✅ **TypeScript Support** - Full type definitions included
-- ✅ **On-Demand Loading** - Only loads what you request
-- ✅ **Parallel Loading** - `loadIcons` loads multiple icons simultaneously
-- ✅ **Error Handling** - Clear error messages for missing icons
-- ✅ **Zero Vite Overhead** - No dev server slowdown
-
-**React Example with Loader:**
-```jsx
-import { useState, useEffect } from 'react';
-import { loadIcon } from '@hugeicons/core-free-icons/loader';
-import { HugeiconsIcon } from '@hugeicons/react';
-
-function DynamicIcon({ iconName }) {
-  const [icon, setIcon] = useState(null);
-  const [loading, setLoading] = useState(true);
-
-  useEffect(() => {
-    loadIcon(iconName)
-      .then(setIcon)
-      .catch(console.error)
-      .finally(() => setLoading(false));
-  }, [iconName]);
-
-  if (loading) return <div>Loading...</div>;
-  if (!icon) return <div>Icon not found</div>;
-
-  return <HugeiconsIcon icon={icon} size={24} />;
-}
-```
-
 ### Performance Comparison
 
-| Import Method | Bundle Size | Load Time | Caching | Best For |
-|--------------|-------------|-----------|---------|----------|
-| Static Import | ~2-3KB per icon | 0ms (bundled) | N/A | Production builds |
-| Dynamic Full Bundle | ~5MB | 100-200ms | No | Many dynamic icons |
-| Dynamic Individual | ~0.75KB | 10-20ms | No | Icon pickers, lazy loading |
-| **Loader Functions** ⭐ | **~2KB + 0.75KB per icon** | **8-20ms** | **Yes** | **Dynamic apps, CMS, config-driven UIs** |
+| Import Method | Bundle Size | Load Time | Best For |
+|--------------|-------------|-----------|----------|
+| Static Import | ~2-3KB per icon | 0ms (bundled) | Production builds |
+| Dynamic Full Bundle | ~5MB | 100-200ms | Many dynamic icons |
+| Dynamic Individual | ~0.75KB | 10-20ms | Icon pickers, lazy loading |
 
 For real-world applications, we recommend using our framework-specific packages that provide optimized components and additional features. Check out the Framework Support section below for more details.
 
-## Loader API Reference
-
-The loader provides a complete API for dynamic icon management:
-
-### Available Functions
-
-```typescript
-// Load single icon with caching
-loadIcon(iconName: string): Promise<IconSvgObject>
-
-// Load multiple icons in parallel
-loadIcons(iconNames: string[]): Promise<IconSvgObject[]>
-
-// Check if an icon exists
-iconExists(iconName: string): Promise<boolean>
-
-// Clear icon cache
-clearIconCache(): void
-
-// Get cache size
-getCacheSize(): number
-
-// Style-specific aliases (for multi-package usage)
-loadIconFreeIcons(iconName: string): Promise<IconSvgObject>
-loadIconsFreeIcons(iconNames: string[]): Promise<IconSvgObject[]>
-```
-
-### Complete Usage Example
-
-```javascript
-import { 
-  loadIcon, 
-  loadIcons, 
-  iconExists,
-  clearIconCache,
-  getCacheSize
-} from '@hugeicons/core-free-icons/loader';
-
-// Load single icon
-const home = await loadIcon('Home01Icon');
-console.log('Loaded:', home); // Array of SVG path data
-
-// Load multiple icons
-const [calendar, user, search] = await loadIcons([
-  'Calendar01Icon',
-  'UserIcon', 
-  'Search01Icon'
-]);
-
-// Check existence before loading
-if (await iconExists('Rocket01Icon')) {
-  const rocket = await loadIcon('Rocket01Icon');
-}
-
-// Cache management
-console.log('Cached icons:', getCacheSize()); // 4
-clearIconCache();
-console.log('After clear:', getCacheSize()); // 0
-```
-
 ## Tree-Shaking Support
 
 This package is optimized for tree-shaking with modern bundlers (Webpack, Rollup, Vite, etc.). When you import icons using the standard syntax, bundlers will automatically eliminate unused icons:
@@ -207,14 +98,12 @@ import { UserIcon, HomeIcon } from '@hugeicons/core-free-icons';
 
 ## Features
 
-- ⭐ **Dynamic Loader Functions**: NEW! Load icons on-demand with automatic caching
 - 🎯 **Individual Icon Imports**: Load only what you need with 99% bundle size reduction
 - 🌳 **Tree-shakeable**: Optimized for modern bundlers
-- 📦 **Multiple Import Methods**: Static, dynamic bundle, dynamic individual, or loader
+- 📦 **Multiple Import Methods**: Static, dynamic bundle, or dynamic individual
 - 🔷 **TypeScript Support**: Full type definitions included
 - 📱 **Framework Agnostic**: Works with any JavaScript framework
 - ⚡ **Optimized Performance**: Lazy load icons on demand
-- 💾 **Built-in Caching**: In-memory cache for faster subsequent loads
 - 🎨 **Customizable**: Easy to style with CSS or inline styles
 - ✅ **ESM & CommonJS**: Support for both module systems
 - 🚀 **Zero Dependencies**: No external dependencies