Kartal

import 'package:kartal/kartal.dart';

// Responsive sizing and theming
Container(
  padding: context.padding.low,
  height: context.sized.dynamicHeight(0.1),
  child: Text(
    'Hello',
    style: context.general.textTheme.titleMedium,
  ),
)

// Form validation
final isValid = 'user@mail.com'.ext.isValidEmail; // true

// Conditional visibility
const Text('Premium Feature').ext.toVisible(value: isPremiumUser)

// Safe future building
fetchUserData().ext.toBuild(
  onSuccess: (data) => Text(data?.name ?? ''),
  loadingWidget: const CircularProgressIndicator(),
  notFoundWidget: const Text('No data'),
  onError: const Text('Something went wrong'),
)

final theme = context.general.appTheme;
final isOpen = context.general.isKeyBoardOpen;
context.general.unfocus(); // dismiss keyboard

SizedBox(
  height: context.sized.dynamicHeight(0.1),
  width: context.sized.dynamicWidth(0.5),
)

Padding(
  padding: context.padding.horizontalNormal,
  child: Text('Hello'),
)

Container(
  decoration: BoxDecoration(
    borderRadius: context.border.normalBorderRadius,
  ),
)

if (context.device.isSmallScreen) {
  // compact layout
}

final columns = context.device.responsive(small: 1, medium: 2, large: 4);

final padding = context.device.responsive<EdgeInsets>(
  small: const EdgeInsets.all(8),
  large: const EdgeInsets.all(32),
);

final layout = switch (context.device.breakpoint) {
  DeviceBreakpoint.small => const PhoneLayout(),
  DeviceBreakpoint.medium => const TabletLayout(),
  DeviceBreakpoint.expanded => const SplitLayout(),
  DeviceBreakpoint.large => const DesktopLayout(),
};

context.route.pop();
context.route.navigateName('/details', data: item);
context.route.navigateToPage(const DetailsPage());

// Show loader
context.popupManager.showLoader();

// Hide loader
context.popupManager.hideLoader();

// With custom widget and ID
context.popupManager.showLoader(
  id: 'upload',
  widgetBuilder: (context) => const MyCustomLoader(),
);
context.popupManager.hideLoader(id: 'upload');

context.overlay.showSnack('Saved');

final confirmed = await context.overlay.showConfirm(
  title: 'Delete this item?',
  message: 'This cannot be undone.',
  confirmLabel: 'Delete',
  isDestructive: true,
);
if (confirmed) await delete();

await context.overlay.showSheet(const FilterSheet());

'test@email.com'.ext.isValidEmail      // true
'Abc123!@'.ext.isValidPassword         // true
'hello world'.ext.toTitleCase()        // "Hello World"
'hello world'.ext.toCapitalized()      // "Hello world"
'ÇÖĞ'.ext.withoutSpecialCharacters    // "COG"
'ÇÖĞ test'.ext.searchable             // "cog test"

'4242 4242 4242 4242'.ext.isValidCreditCard;         // true
'4242424242424241'.ext.isValidCreditCard;            // false
'TR33 0006 1005 1978 6457 8413 26'.ext.isValidIban;  // true
'+90 532 123 45 67'.ext.isValidPhone;                // true
'0(032) 123-45-67'.ext.isValidPhone;                 // false, area code

'4242424242424242'.ext.mask();                  // '4242********4242'
'veli@kartal.dev'.ext.maskEmail;                // 've**@kartal.dev'
'Cok Guzel Bir Baslik'.ext.toSlug();            // 'cok-guzel-bir-baslik'
'Kartal makes Flutter nicer'.ext.truncate(12);  // 'Kartal ma...'
'Veli Bacik'.ext.initials();                    // 'VB'
'<p>Tom &amp; Jerry</p>'.ext.removeHtmlTags;     // 'Tom & Jerry'

'FF5733'.ext.color          // Color(0xffFF5733)
'FF5733'.ext.toColor        // Color from color code
'avatar'.ext.randomImage    // picsum.photos URL

'user@mail.com'.ext.launchEmail
'+905551234567'.ext.launchPhone
'https://pub.dev'.ext.launchWebsite
'Istanbul'.ext.launchMaps()
'Hello!'.ext.share()

final name = ''.ext.appName;
final id = await ''.ext.deviceId;
final header = 'my-token'.ext.bearer; // {'Authorization': 'Bearer my-token'}

final map = await '{"name":"kartal"}'.ext.safeJsonDecodeCompute<Map<String, dynamic>>();
final intVal = '42'.ext.toPrimitiveFromGeneric<int>(); // 42

const Text('Hello').ext.toVisible(value: isLoggedIn)
const Text('Disabled').ext.toDisabled(opacity: 0.5)
myWidget.ext.sliver  // wrap in SliverToBoxAdapter

const Text('Tap me')
    .ext.paddingAll(12)
    .ext.card(elevation: 2)
    .ext.onTap(onPressed);

fetchData().ext.toBuild(
  onSuccess: (data) => Text(data.toString()),
  loadingWidget: const CircularProgressIndicator(),
  notFoundWidget: const Text('Not found'),
  onError: const Text('Error'),
)

// Returns null on timeout instead of throwing
final result = await fetchData().ext.timeoutOrNull(
  timeOutDuration: const Duration(seconds: 5),
);

final data = await kartalRetry(
  () => api.fetch(),
  attempts: 3,
  delay: const Duration(milliseconds: 200),
  exponentialBackoff: true,
  retryIf: (error) => error is! ArgumentError,
);

List<String>? names;
names.ext.isNullOrEmpty        // true (null-safe)
[1, null, 3].ext.makeSafe()    // [1, 3]
['a', 'b'].ext.indexOrNull((e) => e == 'b')  // 1

[1, 2, 3, 4, 5].ext.chunked(2);            // [[1, 2], [3, 4], [5]]
people.ext.groupBy((p) => p.city);          // {'Istanbul': [...], ...}
people.ext.sortedBy((p) => p.age);          // does not mutate
orders.ext.sumBy((o) => o.total);
final (adults, minors) = people.ext.partition((p) => p.age >= 18);

[null, 1, null, 3].exts.makeSafe()  // [1, 3]
[1, 2, 3, null].exts.makeSafeCustom((v) => v != null && v > 1)  // [2, 3]

final file = File('photo.jpg');
file.ext.isImageFile  // true
file.ext.fileType     // FileType.IMAGE

Image.network('https://picsum.photos/200').ext.upRotation

final key = GlobalKey();
// after build:
final widgetHeight = key.ext.height;
final position = key.ext.offset;
key.ext.scrollToWidget();

final color = 42.ext.randomColorValue;       // Random 0-255
final status = 200.ext.httpStatus;           // HttpResult.success
final statusColor = 404.ext.httpStatusColor; // Colors.orange

1234567.ext.compact();          // '1.2M'
1536000.ext.readableFileSize;   // '1.5 MB'
1234.5.ext.currency(symbol: r'$');  // '$1,234.50'
0.85.ext.fraction();            // '85%'

1234567.89.ext.currency(
  symbol: '\u20BA',
  symbolOnLeft: false,
  thousandSeparator: '.',
  decimalSeparator: ',',
);  // '1.234.567,89 \u20BA'

const Duration(minutes: 3, seconds: 7).ext.formatted;  // '03:07'
const Duration(hours: 1, minutes: 2).ext.formatted;    // '01:02:00'

await 300.ext.ms.ext.delay();

const Color(0xFF3F51B5).ext.toHex();         // '#3f51b5'
Colors.indigo.ext.lighten(0.2);
Colors.indigo.ext.contrastText();            // white or black
Colors.indigo.ext.toMaterialColor();         // full 50..900 swatch
KartalColor.tryParse('#FF0000');             // Color? -- null when invalid
KartalColor.random(seed: 42);                // deterministic

bool? apiResult = true;
apiResult.ext.isSuccess  // true
apiResult.ext.isFail     // false

bool? nullResult;
nullResult.ext.isSuccess // false
nullResult.ext.isFail    // true

final postDate = DateTime(2024, 1, 15);
postDate.ext.differenceTime()  // "1 years ago"

// Custom localization
postDate.ext.differenceTime(
  localizationLabel: DateLocalizationLabel(
    yearLabel: 'yil once',
    monthLabel: 'ay once',
    dayLabel: 'gun once',
  ),
)

postDate.ext.differenceTime(
  localizationLabel: const DateLocalizationLabel.tr(),
);  // '1 yil once'

final map = {'name': 'Kartal', 'version': 4};
final json = await map.ext.safeJsonEncodeCompute(); // runs in isolate

final posts = await BundleDecoder('assets/posts.json')
    .crackBundle<Post, List<Post>>(model: Post());

await MapsUtility.openAppleMapsWithQuery('Istanbul Kartal');
await MapsUtility.openGoogleMapsWithQuery('Istanbul Kartal');
await MapsUtility.openGoogleWebMapsWithQuery('Istanbul Kartal');

final preview = await CustomLinkPreview.getLinkPreviewData('https://example.com');
print(preview?.title);
print(preview?.description);
print(preview?.image);

CustomLogger.showError<MyClass>(errorObject);

final _debouncer = Debouncer(const Duration(milliseconds: 300));

void onChanged(String query) => _debouncer.call(() => search(query));

@override
void dispose() {
  _debouncer.dispose();
  super.dispose();
}

final deviceId = await DeviceUtility.instance.getUniqueDeviceId();
final isIpad = await DeviceUtility.instance.isIpad();

void main() {
  KartalConfig.instance.configure(
    breakpoints: const KartalBreakpoints(
      small: 480,
      medium: 768,
      large: 1200,
    ),
    dateLabel: const DateLocalizationLabel.tr(),
  );

  runApp(const MyApp());
}