EasyColor 🎨

Modern, optimize edilmiş ve fonksiyonel Node.js terminal renklendirme kütüphanesi. Artık TrueColor, Gradient ve Tema desteğiyle! 🚀

✨ Özellikler

• 🎨 TrueColor (16 Milyon Renk) - RGB ve HEX desteği
• 🌈 Gradient (Renk Geçişi) - İki renk arası pürüzsüz geçişler
• 📝 Tagged Templates - `easycolor.template` ile kolay kullanım
• 🎭 Tema Sistemi - Kendi renk paletinizi oluşturun
• 💻 İnteraktif CLI - Kullanıcı dostu terminal arayüzü
• 🛡️ TypeScript Desteği - Tam tip güvenliği (.d.ts)
• 🧹 Strip Utility - ANSI kodlarını temizleme aracı
• 🚀 Yüksek performans - Optimize edilmiş algoritmalar
• 🎯 Fonksiyonel programlama yaklaşımı
• 🔗 Zincir API ile çoklu stil uygulama

📦 Kurulum

npm install @onurege3467/easycolor --global

Projenizde kullanmak için:

npm install @onurege3467/easycolor --save

🚀 Komut Satırı Kullanımı

İnteraktif Mod (YENİ!)

Hiçbir parametre vermeden çalıştırırsanız interaktif mod açılır:

easycolor

Standart Komutlar

# Metin renklendirme (Standart)
easycolor text red "Kırmızı metin"

# TrueColor (HEX ve RGB)
easycolor hex "#FF5733" "Turuncu metin"
easycolor rgb "100,50,255" "Mor metin"

# Gradient (Renk Geçişi)
easycolor gradient "red,blue" "Kırmızıdan maviye geçiş"

# Dosya Okuma
easycolor cat dosya.txt gradient "blue,green"

# Gökkuşağı efekti
easycolor rainbow "Gökkuşağı metin"

💻 Programatik Kullanım

1. Tagged Templates (Önerilen) 🌟

En kolay kullanım şekli!

const easycolor = require('@onurege3467/easycolor');

console.log(easycolor.template`
  Merhaba {red Dünya}!
  Bu {bgBlue.white çoklu stil} örneğidir.
  Hex renkler: {hex("#FF5733") Turuncu}
  RGB renkler: {rgb(100,200,50) Yeşilimsi}
`);

2. TrueColor & Gradients 🎨

// HEX Renkler
console.log(easycolor.hex('#FF5733', 'Bu bir HEX rengidir'));
console.log(easycolor.bgHex('#0000FF', 'Mavi Arka Plan'));

// RGB Renkler
console.log(easycolor.rgb(255, 100, 50, 'RGB Rengi'));

// Gradient (Renk Geçişi)
console.log(easycolor.gradient('Başlangıçtan sona renk geçişi', 'red', 'blue'));

3. Tema Sistemi 🎭

Kendi semantik renklerinizi tanımlayın:

easycolor.setTheme({
  info: ['blue', 'bold'],
  error: ['red', 'underline'],
  success: ['green', 'italic'],
  custom: ['hex("#FFA500")', 'bgHex("#333")'] // Özel HEX kombinasyonu
});

// Kullanım
console.log(easycolor.theme('info', 'Bilgi Mesajı'));
console.log(easycolor.theme('error', 'Hata Oluştu!'));

4. Yardımcı Araçlar

// Strip (ANSI Temizleme)
const renkli = easycolor.red('Metin');
const temiz = easycolor.strip(renkli); // "Metin"

// İç içe stiller (Nested)
console.log(easycolor.red(`Dış Kırmızı ${easycolor.blue('İç Mavi')} Dış Kırmızı`));

5. Temel Renklendirme

// Basit renklendirme
console.log(easycolor.red('Kırmızı metin'));
console.log(easycolor.green('Yeşil metin'));

// Zincir API
console.log(
  easycolor.chain('Mavi ve kalın metin')
    .blue()
    .bold()
    .toString()
  );

🎨 Desteklenen Renkler ve Stiller

Metin Renkleri

• Standart: black, red, green, yellow, blue, magenta, cyan, white
• Parlak: brightBlack, brightRed... vb.
• TrueColor: hex(), rgb()

Arka Plan Renkleri

• Standart: bgBlack, bgRed... vb.
• TrueColor: bgHex(), bgRgb()

Metin Stilleri

• bold, dim, italic, underline, blink, inverse, hidden, strikethrough

🆕 Sürüm Geçmişi

v3.0.0 (The TrueColor Update)

• 🌟 TrueColor Desteği: 16 milyon renk (RGB/HEX)
• 🌈 Gradient: Renk geçişleri
• 📝 Template Literals: Kolay yazım sözdizimi
• 🎭 Tema Motoru: Özelleştirilebilir temalar
• 💻 İnteraktif CLI: Yeni nesil terminal arayüzü
• 🛡️ TypeScript: Tam .d.ts tanımları

v2.0.0

• 🚀 Performans optimizasyonları
• 🏗️ Class tabanlı yapı

v1.0.0

• Temel renk fonksiyonları