---

On	Extensions	Functions	Operations
Bool	5	2	0
BuildContext	20	4	0
DateTime	21	0	2
List	17 (+13)	4 (+1)	1
Map	14	2	0
Number	18	2	0
String	15	0	0
Widget	28	1	0
Total Of Each	138	15	3
All Extensions	156

Platform	Android	iOS	Windows	MacOS	Linux	Web
Support	✅	✅	✅	✅	✅	✅

📥 Installation

1. Add to pubspec.yaml:

dependencies:
  s_extensions: <latest_version>

2. Import library into your code.

import 'package:s_extensions/s_extensions.dart';

🔧 Quick Start

In your MaterialApp.builder, add the following code:

MaterialApp(
  builder: (context, child) {
    FlutterSExtensions.update(context); // keep stored view & media fresh
    return child!;
  },
  home: const MyHomePage(),
);

🌟 Features

Bool extensions

final isLoaded = true;
isLoaded.toggle; // false
isLoaded.toInt; // 1
isLoaded.toOnOff; // "on"
isLoaded.toYesNo; // "yes"
isLoaded.toEnabledDisabled; // "enabled"
isLoaded.whenTrue(() => print("loaded")); // "loaded"
isLoaded.whenFalse(() => print("not loaded")); // "not loaded"

BuildContext extensions

context.hideKeyboard(); // hides the keyboard
context.pop(); // pops the current route
context.push(HomeScreen()); // pushes a new route with the given page
context.pushNamed(AppRoutes.homeScreen); // pushes a new route with the given name

context.orientation; // returns the device orientation
context.keyboardHeight; // returns the height of the keyboard
context.theme; // returns the theme of the app
context.textTheme; // returns the text theme of the app
context.colorScheme; // returns the color scheme of the app
context.topPadding; // returns the top padding of the app bar
context.bottomPadding; // returns the bottom padding of the navigation bar
context.devicePixelRatio; // returns the device pixel ratio
context.brightness; // returns the brightness of the app
context.widgetSize; // returns the size of the widget tied to this context
context.widgetPosition; // returns the global position of the widget

context.isDarkMode; // returns true if the device is in dark mode
context.isKeyboardVisible; // returns true if the keyboard is visible
context.isLandscape; // returns true if the device orientation is landscape
context.isPortrait; // returns true if the device orientation is portrait
context.isRTL; // returns true if the device is in right-to-left mode
context.isLTR; // returns true if the device is in left-to-right mode
context.isTablet; // returns if the device is tablet-sized (shortestSide ≥ 600)
context.isScreenSmall; // returns if width < 360px (useful for responsive)
context.isHighContrast; // returns if device accessibility high contrast is enabled

DateTime extensions

DateTime.now().format('yyyy-MM-dd'); // 2023-08-24

DateTime.now().formatYearMonthDay; // 2023-08-24
DateTime.now().formatDayMonthYear; // 24-08-2023
DateTime.now().formatYearMonthDayHrMinSec; // 2023-08-24 12:34:56
DateTime.now().formatYearMonthDayHrMin; // 2023-08-24 12:34
DateTime.now().formatHrMin12; // 12:34 PM
DateTime.now().formatHrMinSec12; // 12:34:56 PM
DateTime.now().formatHrMin24; // 15:34
DateTime.now().formatHrMinSec24; // 15:34:56
DateTime.now().formatDay; // Sunday
DateTime.now().formatMonth; // August

DateTime.now().isPast; // false
DateTime.now().isFuture; // false
DateTime.now().isToday; // true
DateTime.now().isTomorrow; // false
DateTime.now().isYesterday; // false
DateTime.now().isInPreviousMonth; // false
DateTime.now().isInPreviousYear; // false
DateTime.now().isInNextMonth; // false
DateTime.now().isInNextYear; // false

operator +(Duration duration) // Returns a new DateTime with this duration added.
(DateTime.now() + 1.day); // 2023-08-25 12:34:56.000

operator -(Duration duration) // Returns a new DateTime with this duration subtracted.
(DateTime.now() - 1.day); // 2023-08-23 12:34:56.000

(DateTime.now() - 1.day).fromNow; // Duration(days: 1)

List extensions

[1, 2, 3].sum; // 6
[1, 2, 3].average; // 2.0
[1, 2, 3].random; // 2
[1, 2, 2, 3].mostFrequent; // [2]
[1, 2, 3].maximum; // [3]
[1, 2, 3].minimum; // [1]
[1, 2].safeGet(2); // at index 2: null
[1, 2, 3].toJson; // '[1, 2, 3]'
[1, 2, 3].toCsv; // '1,2,3'
[1, 2, 2, 3].toSet; // {1, 2, 3}
[1, 2, 3].toStringList; // ['1', '2', '3']
[1, 2, 3].groupBy((e) => e.isDivisibleBy(2)); // {0: [2], 1: [1, 3]}
[1, 2, 3].containsAll([1, 2]); // true
[1, 2, 3].containsAny([1, 5]); // true
[1, 2, 3].difference([1, 2]); // [3]
[1, 2, 3].symmetricDifference([1, 2, 4]); // [3, 4]

[1, 2, null, 3].removeNulls(); // [1, 2, 3]

operator +(element) // Adds new [element] or [elements] to this list.

[Widgets].toStack(); // Stack(children: [Widgets])
[Widgets].toColumn(); // Column(children: [Widgets])
[Widgets].toRow(); // Row(children: [Widgets])
[1, 2, 3].wrapWith((e) => Text(e.toString())); // [Text('1'), Text('2'), Text('3')]

Map extensions

final map1 = <int, dynamic>{'name': 'John', 'age': 30};
final map2 = <String, int>{'a': 1, 'b': 2};
final map3 = <int, int>{1: 1, 2: 2, 3: 3};

map1.toJson; // String: '{"name": "John", "age": 30}'

map1.mergeWith(map2); // New Map: {'name': 'John', 'age': 30, 'a': 1, 'b': 2}
map1.filterKeys((key) => key == 'name'); // {'name': 'John'}
map1.filterValues((value) => value is int); // {'age': 30}
map2.excludeKeys(['a']); // {'b': 2}
map2.excludeValues([2]); // {'a': 1}
map1.pickKeys(['name']); // {'name': 'John'}
map1.pickValues([30]); // {'age': 30}
map3.mapKeys((key) => key.toString()); // <String, int>{'1': 1, '2': 2, '3': 3}
map2.mapValues((value) => value * 2); // {'a': 2, 'b': 4}
map1.toQueryString; // '?name=John&age=30'
map2.invert; // <int, String>{1: 'a', 2: 'b'}

map1.safeUpdate('name', 'Hussein'); // {'name': 'Hussein', 'age': 30}
map2.ensureKey('c', 0); // {'a': 1, 'b': 2, 'c': 0}

map1.containsAllKeys(['name', 'age']); // true
map1.containsAnyKeys(['name']); // true

Number extensions

8.half; // 4.0
8.quarter; // 2.0
8.square; // 64.0
8.sqRoot; // 2.8284271247461903

300.misec; // Duration(microseconds: 300)
300.msec; // Duration(milliseconds: 300)
300.sec; // Duration(seconds: 300)
300.min; // Duration(minutes: 300)
300.hr; // Duration(hours: 300)
300.day; // Duration(days: 300)

0.5.screenWidth; // half of the screen width
0.5.screenHeight; // half of the screen height

123.456.fixed00; // 123.46
123.456.fixed0; // 123.5
123.456.format('0.00'); // 123.46

16.verticalSpace; // SizedBox(height: 16.0)
16.horizontalSpace; // SizedBox(width: 16.0)

20.isDivisibleBy(5); // true
30.isBetween(20, 40); // true
50.isEven; // true

String extensions

'hello'.capitalize; // Hello
'hello'.reverse; // olleh
"Hello World!".words; // ["Hello", "World!"]
'congratolations'.truncate(4); // 'cong...'
'Hello World!'.removeWhiteSpace; // 'HelloWorld!'
'Hello123 World!'.removeNumbers; // 'Hello World!'
'{"name": "John", "age": 30}'.parseJson` // {'name': 'John', 'age': 30} as Map

"23.4".toDouble; // 23.4
"23.4".toInt; // 23
"2023-08-24".toDate; // 2023-08-24 00:00:00.000

'hello@example.com'.isEmail; // true
'+1234567890'.isPhoneNumber; // true
'https://www.example.com'.isUrl; // true
'racecar'.isPalindrome; // true

Widget extensions

[
  // margin extensions
  Text('Hello World!').marginAll(16.0),
  Text('Hello World!').marginSymmetric(vertical: 16.0, horizontal: 16.0),
  Text('Hello World!').marginOnly(left: 16.0, top: 16.0, right: 16.0, bottom: 16.0),

  // padding extensions
  Text('Hello World!').paddingAll(16.0),
  Text('Hello World!').paddingSymmetric(vertical: 16.0, horizontal: 16.0),
  Text('Hello World!').paddingOnly(left: 16.0, top: 16.0, right: 16.0, bottom: 16.0),

  // expanded and flexible extensions
  [
    Text('Hello World!').expanded(),
    Text('Hello World!').expanded(),
  ].toColumn(spacer: 16),
  Text('Hello World!').flexible(),

  // customizations
  16.verticalSpace.center(),
  Text('Hello World!').directionality(direction: TextDirection.ltr),
  Image.asset('path').align(alignment: Alignment.center),

  [
    Text('Hello World!')
      .center()
      .paddingAll(12)
      .decoration(
        color: Colors.white,
        borderRadius: BorderRadius.circular(16.0),
      ),
  ].toStack(),

  // shape extensions & gestures
  Text('Hello World!')
    .constrained(width: 100.0, height: 70.0)
    .rounded(radius: 16.0),
  Text('Hello World!')
    .height(70.0)
    .roundedTop(radius: 16.0),
  Text('Hello World!')
    .width(100.0)
    .roundedBottom(radius: 16.0)
    .gestures(
      onTap: () => print('tap'),
    ),

  // animation extensions
  Text('Hello World!').fade(),
  Text('Hello World!').scale(beginScale: 0.9),
  Text('Hello World!').slideUp(),
  Text('Hello World!').slideDown(),
  Text('Hello World!').slideLeft(),
  Text('Hello World!').slideRight(),
  Text('Hello World!').rotate(beginAngle: 0.05),

  // scroll and refresh extensions
  [
    Widgets...
  ].toColumn()
    .scrollable()
    .refreshable(onRefresh: () async {
      await Future.delayed(2.seconds),
    }),
].toColumn(separator: 16);

🔧 Static Context Manager

FlutterSExtensions is a tiny singleton managing a FlutterView and a cached MediaQueryData. It powers property access like 0.9.screenWidth and 0.9.screenHeight without explicitly passing BuildContext.

Initialization patterns:

• Explicit (recommended): call FlutterSExtensions.update(context) in MaterialApp.builder.
• Lazy: first use attempts WidgetsBinding.instance.platformDispatcher.views.first. This works after runApp; it throws if no view is available (e.g., too early in tests).

Key API:

• FlutterSExtensions.init([context]) — initialize explicitly; optional BuildContext.
• FlutterSExtensions.update(context) — refresh stored FlutterView and MediaQueryData on rebuilds/hot reload.
• FlutterSExtensions.isInitialized — check readiness.
• FlutterSExtensions.mediaQuery() — get the current MediaQueryData (attempts lazy init; may throw).
• FlutterSExtensions.reset() — clear cached references (useful for tests).

Hot reload and metrics:

• Implements WidgetsBindingObserver.didChangeMetrics to refresh cached MediaQueryData on orientation or size changes.

🔧 Error Handling

• mediaQuery() may throw StateError if Flutter is not fully initialized or no FlutterView is available.
• Ensure your app has started (runApp) and prefer using FlutterSExtensions.update(context) for determinism.

🔧 Testing

• Call WidgetsFlutterBinding.ensureInitialized() in tests.
• Use FlutterSExtensions.reset() to clear cached state between tests.

✅ Notes & Best Practices

• Prefer FlutterSExtensions.update(context) at the app root to avoid edge cases.
• Values for screenWidth and screenHeight are typically between 0 and 1 for proportional sizing.
• Duration conversions truncate fractional values via toInt().

📜 License

Licensed under the Apache License, Version 2.0. See LICENSE for details.

🕒 Changelog

See CHANGELOG.md for release notes.

🔍 Analytics