npm package: @saturniahub/icons
Description: Biblioteca de ícones SVG para React - Mais de 1.500 ícones organizados por categoria
Author: Saturnia Tecnologia
Latest version: 4.1.6

# Saturnia Icons v4.1.6

[![npm version](https://badge.fury.io/js/@saturniahub/icons.svg)](https://badge.fury.io/js/@saturniahub/icons)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)

> Biblioteca de ícones SVG para React com mais de 1.500 ícones

## ✨ Características

- 🎨 **Mais de 1.500 ícones**
- 🎯 **Múltiplas variações**
- ⚡ **TypeScript** com tipagem completa
- 📦 **Tree-shaking** otimizado
- 🚀 **Zero dependências** (apenas React)
- 📱 **Responsivo** e acessível
- 🎨 **Customizável** com props padrão do SVG

## 📊 Estatísticas

- **Total de Ícones**: 1840
- **Categorias**: 2
- **Variações**: 3

## 🚀 Instalação

```bash
npm install @saturniahub/icons@4.1.6
# ou
yarn add @saturniahub/icons@4.1.6
# ou
pnpm add @saturniahub/icons@4.1.6
```

## 📖 Uso Básico

```tsx
import { SaturniaIcons } from '@saturniahub/icons';

function App() {
  return (
    <div>
      <SaturniaIcons.PlusLight />
      <SaturniaIcons.PlusLight />
      <SaturniaIcons.ArrowRightLight size={24} color="#000" />
    </div>
  );
}
```

## ⚙️ Compatibilidade com Bundlers

Esta biblioteca é compatível com todos os bundlers modernos:

- ✅ **Vite** - Funciona out-of-the-box
- ✅ **Webpack** - Funciona out-of-the-box  
- ✅ **Create React App** - Funciona out-of-the-box
- ✅ **Next.js** - Funciona out-of-the-box
- ✅ **Parcel** - Funciona out-of-the-box
- ✅ **Rollup** - Funciona out-of-the-box

### 🔧 Solução de Problemas

Se você encontrar problemas de resolução de módulos, verifique se:

1. **Versão do Node.js**: Use Node.js 16+ 
2. **Cache do bundler**: Limpe o cache (`npm run build -- --force`)
3. **Dependências**: Reinstale as dependências (`rm -rf node_modules && npm install`)

### 📝 Configuração Manual (Apenas se necessário)

**Vite:**
```js
// vite.config.js
export default {
  optimizeDeps: {
    include: ['@saturniahub/icons']
  }
};
```

**Webpack:**
```js
// webpack.config.js
module.exports = {
  resolve: {
    alias: {
      '@saturniahub/icons': 'node_modules/@saturniahub/icons/index.esm.js'
    }
  }
};
```

## 📖 Uso Avançado

```tsx
import { SaturniaIcons, type IconName } from '@saturniahub/icons';

function IconButton({ iconName, ...props }: { 
  iconName: IconName; 
  [key: string]: any; 
}) {
  const IconComponent = SaturniaIcons[iconName];
  
  return (
    <button {...props}>
      <IconComponent size={20} />
    </button>
  );
}

// Uso
<IconButton iconName="AddPlusLight" onClick={() => console.log('clicked')} />
```

## 📁 Categorias Disponíveis

- **All**: 1653 ícones
- **Brands**: 187 ícones

## 🎨 Variações Disponíveis

- **Light**: 1653 ícones
- **Colored**: 105 ícones
- **Mono**: 82 ícones

## 🔧 Props Disponíveis

Todos os ícones aceitam as seguintes props:

```tsx
interface IconProps {
  size?: number | string;        // Tamanho do ícone
  color?: string;                // Cor do ícone
  className?: string;            // Classe CSS
  style?: React.CSSProperties;   // Estilos inline
  // ... todas as props padrão do SVG
}
```

## 📦 Build e Deploy

```bash
# Instalar dependências
npm install

# Build para produção
npm run build

# Testes
npm test

# Lint
npm run lint
```

## 🤝 Contribuindo

1. Fork o projeto
2. Crie uma branch para sua feature (`git checkout -b feature/AmazingFeature`)
3. Commit suas mudanças (`git commit -m 'Add some AmazingFeature'`)
4. Push para a branch (`git push origin feature/AmazingFeature`)
5. Abra um Pull Request

## 📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.

### 📋 Atribuições

Esta biblioteca inclui ícones derivados do projeto [Lucide Icons](https://lucide.dev), que são licenciados sob a [ISC License](https://github.com/lucide-icons/lucide/blob/main/LICENSE). Alguns ícones também são derivados do projeto [Feather Icons](https://feathericons.com) (MIT License).

Agradecemos aos contribuidores do Lucide Icons e Feather Icons por disponibilizarem esses ícones como código aberto.

## 🏢 Sobre

Desenvolvido com ❤️ pela [Saturnia Tecnologia](https://saturniatecnologia.com.br)

---
**Nota**: Esta documentação é gerada automaticamente pelo sistema de build da Saturnia.