Extension CS

Flutter için geliştirilmiş kapsamlı extension paketi. Bu paket, Flutter uygulamalarınızda daha hızlı ve temiz kod yazmanızı sağlayan çeşitli extension'lar içerir.

Özellikler

• 🎨 Color Extensions: Renk manipülasyonu ve dönüşümü
• 📅 DateTime Extensions: Tarih formatlaması ve zaman hesaplamaları
• 🧭 Navigator Extensions: Sayfa geçişleri ve navigasyon işlemleri
• 📏 Size Extensions: Responsive tasarım ve boyutlandırma
• 🎭 Theme Extensions: Tema erişimi ve renk yönetimi
• 🔧 Widget Extensions: Widget modifikasyonu ve wrapper'ları
• ⚙️ Responsive Config: Dinamik boyutlandırma konfigürasyonu

Kurulum

dependencies:
  extension_cs: ^0.0.1

flutter pub get

Kullanım

import 'package:extension_cs/extension_cs.dart';

Extension'lar

🎨 Color Extensions

Renk manipülasyonu için gelişmiş özellikler:

Color color = Colors.blue;

// Rengi koyulaştır/açıklaştır
Color darkerBlue = color.darken(0.2);
Color lighterBlue = color.lighten(0.3);

// Opacity ayarları
Color transparentBlue = color.withReducedOpacity(0.5);

// Renk dönüşümleri
String hexColor = color.toHex(); // #FF2196F3
String rgbColor = color.toRgb;   // rgb(33, 150, 243)

// Renk analizi
Color contrastColor = color.contrastColor; // Otomatik siyah/beyaz
Color invertedColor = color.invert;        // Ters renk

// Renk bileşenlerini değiştir
Color newColor = color.withValues(red: 255, alpha: 0.8);

📅 DateTime Extensions

Tarih ve zaman işlemleri için yardımcı metodlar:

DateTime now = DateTime.now();
DateTime pastDate = DateTime(2023, 1, 15);

// Zaman farkını göster
String timeAgo = pastDate.timeAgo(); // "2 saat önce", "3 gün önce" vb.

// Tarih formatlaması
String formatted = now.format('dd/MM/yyyy HH:mm'); // "05/10/2025 14:30"

// Tarih karşılaştırması
bool sameDay = now.isSameDate(pastDate);

// Unix timestamp
int timestamp = now.version; // Milliseconds since epoch

🧭 Navigator Extensions

Sayfa geçişleri ve navigasyon işlemlerini basitleştirin:

// Temel navigasyon
context.push(NewPage());
context.pushNamed('/settings');
context.pop();

// Gelişmiş navigasyon
context.pushReplacement(HomePage());
context.pushAndClearStack(LoginPage());
context.pushNamedAndClearStack('/login');

// Animasyonlu geçişler
context.pushWithFade(ProfilePage());
context.pushWithSlide(SettingsPage(), begin: Offset(1.0, 0.0));

// Modal işlemleri
context.showBottomModal(MyBottomSheet());
context.showAlert(MyDialog());

// Güvenli navigasyon
if (context.canPop()) {
  context.pop();
}
context.maybePop(); // Güvenli geri dönüş

📏 Size Extensions

Responsive tasarım ve dinamik boyutlandırma:

// Ekran bilgileri
double width = context.screenWidth;
double height = context.screenHeight;
Size screenSize = context.screenSize;
bool isTablet = context.isTablet;
bool isPhone = context.isPhone;

// Yüzdelik boyutlar
double halfWidth = context.percentWidth(50);    // Ekranın %50'si
double quarterHeight = context.percentHeight(25); // Yüksekliğin %25'i

// Dinamik boyutlandırma
double dynamicWidth = context.dynamicWidth(100);  // Responsive genişlik
double dynamicHeight = context.dynamicHeight(50); // Responsive yükseklik
double dynamicFont = context.dynamicFontSize(16); // Responsive font

// Cihaz tipine göre font boyutu
double adaptiveFont = context.adaptiveFontSize(14);

// Sınırlı boyutlandırma
double limitedSize = context.dynamicSizeWithLimits(
  24, 
  minSize: 16, 
  maxSize: 32
);

🎭 Theme Extensions

Tema ve renk erişimini kolaylaştırın:

// Tema erişimi
ThemeData theme = context.theme;
ColorScheme colors = context.colorScheme;
TextTheme textTheme = context.textTheme;

// Renk kısayolları
Color primary = context.primaryColor;
Color accent = context.accentColor;
Color background = context.backgroundColor;
Color error = context.errorColor;

// Tema bileşenleri
AppBarThemeData appBarTheme = context.appBarTheme;
ButtonThemeData buttonTheme = context.buttonTheme;
IconThemeData iconTheme = context.iconTheme;

🔧 Widget Extensions

Widget'ları kolayca modifiye edin:

Widget myWidget = Text('Merhaba');

// Layout modifikasyonları
Widget centeredWidget = myWidget.center;
Widget paddedWidget = myWidget.withPadding(EdgeInsets.all(16));
Widget marginWidget = myWidget.withMargin(EdgeInsets.all(8));
Widget sizedWidget = myWidget.withSize(width: 200, height: 100);

// Flex layout
Widget expandedWidget = myWidget.expanded(flex: 2);
Widget flexibleWidget = myWidget.flexible();

// Etkileşim
Widget tappableWidget = myWidget.onTap(() => print('Tapped!'));

// Görünürlük
Widget conditionalWidget = myWidget.visible(shouldShow);

// Dekorasyon
Widget decoratedWidget = myWidget.withDecoration(
  BoxDecoration(
    color: Colors.blue,
    borderRadius: BorderRadius.circular(8),
  ),
);

// Opacity
Widget transparentWidget = myWidget.withOpacity(0.5);

// Card wrapper
Widget cardWidget = myWidget.asCard(elevation: 4);

// Positioning (Stack içinde kullanın)
Widget positionedWidget = myWidget.positioned(
  top: 20,
  left: 10,
  width: 100,
  height: 50,
);

⚙️ Responsive Config

Dinamik boyutlandırma için referans değerleri ayarlayın:

// Varsayılan cihazlar
ResponsiveConfig.setIPhone12Pro();  // 390x844
ResponsiveConfig.setIPhone14Pro();  // 393x852
ResponsiveConfig.setGalaxyS21();    // 384x854
ResponsiveConfig.setIPadAir();      // 820x1180

// Özel referans boyutu
ResponsiveConfig.setCustomReference(
  width: 375, 
  height: 812
);

// Manuel konfigürasyon
ResponsiveConfig().setReferenceDimensions(
  width: 390,
  height: 844,
);

Örnek Kullanım

import 'package:flutter/material.dart';
import 'package:extension_cs/extension_cs.dart';

class ExamplePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      backgroundColor: context.backgroundColor,
      appBar: AppBar(
        title: Text('Extension CS Demo'),
        backgroundColor: Colors.blue.lighten(0.2),
      ),
      body: Column(
        children: [
          // Responsive Container
          Container(
            width: context.percentWidth(90),
            height: context.dynamicHeight(100),
            decoration: BoxDecoration(
              color: Colors.blue.withReducedOpacity(0.3),
              borderRadius: BorderRadius.circular(
                context.dynamicWidth(12),
              ),
            ),
          ).withPadding(EdgeInsets.all(
            context.dynamicWidth(16),
          )),
          
          // Responsive Text
          Text(
            'Responsive Text',
            style: context.textTheme.headlineMedium?.copyWith(
              fontSize: context.adaptiveFontSize(24),
              color: context.primaryColor,
            ),
          ).center.onTap(() {
            context.push(NextPage());
          }),
          
          // Time Display
          Text(
            DateTime.now().format('dd/MM/yyyy HH:mm'),
            style: TextStyle(
              fontSize: context.dynamicFontSize(16),
              color: Colors.grey.darken(0.3),
            ),
          ),
        ],
      ).withPadding(EdgeInsets.all(
        context.dynamicWidth(20),
      )),
    );
  }
}

Katkıda Bulunma

Katkılarınızı bekliyoruz! Lütfen önce bir issue açın ve değişikliklerinizi tartışın.

1. Fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Commit yapın (git commit -m 'Add some amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request açın

Lisans

Bu proje MIT lisansı altında yayınlanmıştır. Detaylar için LICENSE dosyasına bakın.

Yazar

Çağdaş Sarıgil - GitHub

---

⭐ Bu paketi beğendiyseniz yıldız vermeyi unutmayın!