icons 0.5.1

Icons for Rust fullstack applications — Leptos and Dioxus.
Documentation
# Icon Performance Test Results

## Summary
Our caching implementation shows **dramatic performance improvements** for SVG icon rendering after the first parse.

## Test Results

### Basic Icon Parsing Performance
- **Parse every render**: `1.5663 µs`
- **Parse + cache (first call)**: `1.5557 µs` 
- **Cached subsequent calls**: `1.4346 ns`

**Performance Gain**: **~1,091x faster** for subsequent renders!

### Complex Icon Performance  
- **Parse every render**: `2.8407 µs`
- **Cached access**: `862.01 ps`

**Performance Gain**: **~3,297x faster** for complex icons!

### Real-World Test Results
From our integration tests:

1. **1000 iterations test**:
   - Without cache: `5.025ms`  
   - With cache: `17.084µs`
   - **294x faster**

2. **Cache behavior test**:
   - First call: `39.875µs`
   - Subsequent calls: `42ns`
   - **949x faster**

3. **Realistic icon test (100 renders)**:
   - Without cache: `205µs`
   - With cache: `3.417µs` 
   - **60x faster**

## Key Insights

### Memory Impact
- **Minimal**: Each icon type caches its parsed elements once
- **Thread-safe**: `OnceLock` handles concurrent access
- **Zero overhead**: After first parse, just pointer access

### Performance Characteristics
- **First render**: Same speed as before (parsing required)
- **All subsequent renders**: Orders of magnitude faster
- **Scalability**: Benefits increase with icon complexity

### Real-World Benefits
For a typical web application rendering the same icons multiple times:
- **Initial page load**: No performance degradation
- **Component re-renders**: Massive speedup (60-3000x faster)
- **Navigation/routing**: Icons render almost instantly
- **Interactive updates**: UI feels much more responsive

## Conclusion

The `OnceLock` caching strategy provides exceptional performance benefits:
- **Parse once, render many** - Perfect for real-world usage patterns
-**Thread-safe** - Production-ready concurrent access
-**Zero API changes** - Transparent optimization
-**Scalable** - Benefits increase with icon complexity and usage frequency

This optimization transforms icon rendering from a parsing bottleneck into near-zero-cost operations after the first render.