🔄 Circle Text Library

> Biblioteca JavaScript/TypeScript síncrona para validação, extração e processamento de texto, e análise de sentimento desenvolvida para o Circle App.

✨ Principais Funcionalidades

- 🛡️ Sistema de Validação Configurável: Validação robusta de usernames, hashtags, URLs, senhas e mais
- 🔍 Extração de Entidades: Extração inteligente de menções, hashtags, URLs e keywords
- 💭 Análise de Sentimento: Análise contextual em português com suporte a emojis
- 📅 Formatação de Datas: Conversão de datas para texto humanizado com múltiplas opções
- ✍️ Rich Text: Formatação enriquecida com identificação automática de entidades
- 🔢 Conversão Numérica: Formatação de números e textos para exibição
- 🌍 Gerenciamento de Timezone: Conversão entre fusos horários com 14 zonas suportadas

📦 Instalação

``bash npm install circle-text-library`

`🚀 Uso Rápido`

`typescript import { TextLibrary } from "circle-text-library"

const textLib = new TextLibrary({ validationRules: { username: { minLength: { enabled: true, value: 3, description: "Mínimo 3 caracteres" }, maxLength: { enabled: true, value: 20, description: "Máximo 20 caracteres" } } } })

// Validação const validation = textLib.validator.username("john_doe") // { isValid: true, errors: [] }

// Extração textLib.extractor.setText("Olá @user veja #tech em https://example.com") const entities = textLib.extractor.entities({ mentions: true, hashtags: true }) // { mentions: ["@user"], hashtags: ["#tech"] }

// Análise de Sentimento const sentiment = textLib.sentiment.analyze("Estou muito feliz!") // { sentiment: "positive", intensity: 0.85 }

// Formatação de Datas const formatter = textLib.date formatter.setStyle("full") const relative = formatter.toRelativeTime(new Date(Date.now() - 300000)) // "5 minutos atrás"``

---

📚 Documentação Completa

Ver Índice Completo da Documentação →

$3

- Guia de Configuração - Setup completo e configuração da biblioteca
- Exemplos Práticos - Casos de uso reais e workflows completos

$3

🛡️ Validação e Segurança

- Sistema de Validação - Validação de usernames, passwords, URLs e mais

🔍 Extração e Análise

- Sistema de Extração - Extração de entidades e keywords
- Análise de Sentimento - Análise contextual com suporte a emojis

✨ Formatação e Conversão

- Formatador de Datas - Conversão de datas para texto humanizado
- Conversor Numérico - Formatação de números e manipulação de texto
- Rich Text - Formatação enriquecida com entidades
- Gerenciamento de Timezone - Conversão entre fusos horários

$3

- Referência Completa da API - Documentação de todas as classes e métodos

---

🌟 Características Principais

$3

- Processamento síncrono e otimizado
- Cache inteligente para análises repetidas

$3

- Validação rigorosa de senhas com detecção de padrões inseguros
- Bloqueio de senhas comuns
- Proteção contra caracteres maliciosos

$3

- Regras de validação completamente configuráveis
- Mensagens de erro personalizáveis
- Suporte a português brasileiro e inglês americano

$3

- Análise de sentimento otimizada para português brasileiro
- Suporte a gírias e expressões coloquiais
- Detecção de ironia e sarcasmo
- Processamento de acentuação

---

💻 Compatibilidade

- Node.js: 14.x ou superior
- TypeScript: 4.5 ou superior
- Browsers: Modernos com suporte a ES2020

📄 Licença