Add comprehensive Flutter extension methods

Introduces new extension methods for Widget, BuildContext, Color, EdgeInsets, String, and List<Widget> to simplify common Flutter patterns. Enhancements include navigation, theming, layout, styling, effects, gestures, and platform/media query utilities. Example usage and tests for all new extensions are provided.

Author: YoungMayor

CHANGELOG.md

@@ -11,6 +11,79 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 This is the first release of **mayr_flutter_extensions** as a standalone Flutter-specific extension package, separated from the original `mayr_extensions` package.
 
+### Added - New Extensions
+
+#### 🎨 Widget Extensions - Positioning & Sizing
+- `positioned({top, bottom, left, right})` - Wraps widget in Positioned with custom positioning for Stack layouts
+- `aspectRatio(double ratio)` - Maintains aspect ratio (e.g., 16:9 for videos)
+- `fractionallySizedBox({widthFactor, heightFactor})` - Sizes widget as fraction of parent
+
+#### 🎨 Widget Extensions - Styling
+- `decorated(BoxDecoration decoration)` - Wraps widget in DecoratedBox with custom decoration
+- `card({elevation, shape})` - Wraps widget in Material Card
+- `clipOval()` - Clips widget to oval shape
+
+#### 🎨 Widget Extensions - Layout
+- `scrollable({direction})` - Wraps widget in SingleChildScrollView (vertical or horizontal)
+- `safeArea({top, bottom})` - Wraps widget in SafeArea with optional sides
+- `fittedBox({fit})` - Wraps widget in FittedBox with BoxFit options
+
+#### 🎨 Widget Extensions - Effects & Gestures
+- `hero(String tag)` - Wraps widget in Hero for page transition animations
+- `rotated(int quarterTurns)` - Wraps widget in RotatedBox (rotates by 90° increments)
+- `transform(Matrix4 transform)` - Wraps widget in Transform with matrix transformations
+- `gestureDetector({onTap, onDoubleTap})` - Wraps widget in GestureDetector for gesture handling
+- `dismissible(Key key, {direction})` - Wraps widget in Dismissible for swipe-to-dismiss functionality
+
+#### 🧭 BuildContext Extensions - Navigation
+- `push(Widget page)` - Navigate to new page with MaterialPageRoute
+- `pop([result])` - Go back with optional result
+- `pushReplacement(Widget page)` - Replace current route with new page
+- `pushNamed(String route, {arguments})` - Navigate by named route with arguments
+
+#### 🧭 BuildContext Extensions - Theme Access
+- `theme` - Get current ThemeData
+- `primaryColor` - Quick access to theme primary color
+- `colorScheme` - Access current ColorScheme
+- `textTheme` - Access TextTheme styles
+- `isDarkMode` - Check if dark mode is active (based on theme brightness)
+
+#### 🧭 BuildContext Extensions - MediaQuery Shortcuts
+- `screenWidth` / `screenHeight` - Convenient aliases for screen dimensions
+- `padding` - Get safe area insets (notch, status bar, etc.)
+- `viewInsets` - Get system UI insets (keyboard, navigation bar, etc.)
+- `devicePixelRatio` - Get device pixel density
+
+#### 🧭 BuildContext Extensions - Platform Detection
+- `isIOS` - Check if running on iOS platform
+- `isAndroid` - Check if running on Android platform
+- `isWeb` - Check if running on web platform (uses `kIsWeb` constant)
+
+#### 🧭 BuildContext Extensions - Dialogs
+- `showCustomDialog(Widget dialog)` - Show Material dialog with less boilerplate
+- `showSheet(Widget content)` - Show modal bottom sheet with less boilerplate
+
+#### 🔧 String Extensions
+- `toText({style})` - Convert String to Text widget
+- `toSelectableText({style})` - Convert String to SelectableText widget
+
+#### 🔧 List<Widget> Extensions
+- `toColumn({mainAxisAlignment, mainAxisSize, crossAxisAlignment})` - Convert widget list to Column
+- `toRow({mainAxisAlignment, mainAxisSize, crossAxisAlignment})` - Convert widget list to Row
+- `toStack({alignment, fit})` - Convert widget list to Stack
+- `toWrap({alignment, runAlignment, spacing, runSpacing})` - Convert widget list to Wrap
+
+#### 🎨 Color Extensions
+- `withOpacity(double opacity)` - Create color with specified opacity
+- `darken([double amount])` - Make color darker using HSL color space (default 10%)
+- `lighten([double amount])` - Make color lighter using HSL color space (default 10%)
+
+#### 📐 EdgeInsets Extensions
+- `horizontal` - Get total horizontal padding (left + right)
+- `vertical` - Get total vertical padding (top + bottom)
+- `all` - Get uniform padding value (if all sides are equal)
+- `copyWith({left, top, right, bottom})` - Create modified copy of EdgeInsets
+
 ### Package Philosophy
 
 This package is part of the **MayR Extensions** family:
@@ -80,7 +153,7 @@ If you were using the original `mayr_extensions` package:
    ```dart
    // For general Dart extensions
    import 'package:mayr_dart_extensions/mayr_dart_extensions.dart';
-   
+
    // For Flutter-specific extensions
    import 'package:mayr_flutter_extensions/mayr_flutter_extensions.dart';
    ```

example/example.dart

@@ -126,6 +126,198 @@ class ExampleScreen extends StatelessWidget {
             ).clipRounded(16),
 
             const SizedBox(height: 20),
+
+            /// New Widget Extensions - Sizing
+            const Text(
+              'Sizing Extensions',
+              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+            ),
+            const SizedBox(height: 10),
+
+            Container(
+              color: Colors.orange,
+              child: const Text('AspectRatio 16:9'),
+            ).aspectRatio(16 / 9),
+
+            const SizedBox(height: 10),
+
+            Container(
+              color: Colors.teal,
+              child: const Text('50% width'),
+            ).fractionallySizedBox(widthFactor: 0.5),
+
+            const SizedBox(height: 20),
+
+            /// New Widget Extensions - Styling
+            const Text(
+              'Styling Extensions',
+              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+            ),
+            const SizedBox(height: 10),
+
+            const Text('Decorated Box')
+                .decorated(
+                  const BoxDecoration(
+                    color: Colors.lightBlue,
+                    borderRadius: BorderRadius.all(Radius.circular(8)),
+                  ),
+                )
+                .paddingAll(16),
+
+            const SizedBox(height: 10),
+
+            const Text('Card Widget').card(elevation: 8.0).paddingAll(8),
+
+            const SizedBox(height: 10),
+
+            Container(height: 100, width: 100, color: Colors.green).clipOval(),
+
+            const SizedBox(height: 20),
+
+            /// New Widget Extensions - Layout
+            const Text(
+              'Layout Extensions',
+              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+            ),
+            const SizedBox(height: 10),
+
+            Container(
+              height: 150,
+              color: Colors.grey[300],
+              child:
+                  Column(
+                    children: List.generate(
+                      20,
+                      (i) => Text('Scrollable Item $i'),
+                    ),
+                  ).scrollable(),
+            ),
+
+            const SizedBox(height: 10),
+
+            const Text('Safe Area Widget').safeArea(),
+
+            const SizedBox(height: 10),
+
+            Container(
+              height: 100,
+              width: 100,
+              color: Colors.pink,
+              child: const Text('FittedBox').fittedBox(fit: BoxFit.contain),
+            ),
+
+            const SizedBox(height: 20),
+
+            /// New Widget Extensions - Effects
+            const Text(
+              'Effects Extensions',
+              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+            ),
+            const SizedBox(height: 10),
+
+            const Text('Hero Tag').hero('demo-hero'),
+
+            const SizedBox(height: 10),
+
+            const Text('Rotated 1x').rotated(1),
+
+            const SizedBox(height: 20),
+
+            /// String Extensions
+            const Text(
+              'String Extensions',
+              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+            ),
+            const SizedBox(height: 10),
+
+            'String to Text Widget'.toText(
+              style: const TextStyle(fontSize: 16, color: Colors.blue),
+            ),
+
+            const SizedBox(height: 10),
+
+            'Selectable Text Example'.toSelectableText(),
+
+            const SizedBox(height: 20),
+
+            /// List<Widget> Extensions
+            const Text(
+              'List<Widget> Extensions',
+              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+            ),
+            const SizedBox(height: 10),
+
+            [
+              Container(color: Colors.red, height: 50, width: 50),
+              Container(color: Colors.green, height: 50, width: 50),
+              Container(color: Colors.blue, height: 50, width: 50),
+            ].toRow(mainAxisAlignment: MainAxisAlignment.spaceEvenly),
+
+            const SizedBox(height: 10),
+
+            [
+              const Chip(label: Text('Chip 1')),
+              const Chip(label: Text('Chip 2')),
+              const Chip(label: Text('Chip 3')),
+            ].toWrap(spacing: 8),
+
+            const SizedBox(height: 20),
+
+            /// Color Extensions
+            const Text(
+              'Color Extensions',
+              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+            ),
+            const SizedBox(height: 10),
+
+            Row(
+              mainAxisAlignment: MainAxisAlignment.spaceEvenly,
+              children: [
+                Container(
+                  height: 50,
+                  width: 50,
+                  color: Colors.blue,
+                  child: const Center(child: Text('Original')),
+                ),
+                Container(
+                  height: 50,
+                  width: 50,
+                  color: Colors.blue.darken(0.2),
+                  child: const Center(child: Text('Dark')),
+                ),
+                Container(
+                  height: 50,
+                  width: 50,
+                  color: Colors.blue.lighten(0.2),
+                  child: const Center(child: Text('Light')),
+                ),
+              ],
+            ),
+
+            const SizedBox(height: 20),
+
+            /// Theme and Navigation Demo
+            const Text(
+              'Theme & Navigation Extensions',
+              style: TextStyle(fontSize: 20, fontWeight: FontWeight.bold),
+            ),
+            const SizedBox(height: 10),
+
+            Text('Primary Color: ${context.primaryColor}'),
+            Text('Is Dark Mode: ${context.isDarkMode}'),
+            Text('Screen Width: ${context.screenWidth}'),
+            Text('Device Pixel Ratio: ${context.devicePixelRatio}'),
+
+            const SizedBox(height: 10),
+
+            ElevatedButton(
+              onPressed: () {
+                context.showSnackBar('Navigation extensions available!');
+              },
+              child: const Text('Test Navigation Extension'),
+            ),
+
+            const SizedBox(height: 20),
           ],
         ),
       ),

lib/src/extensions.dart

@@ -1,10 +1,15 @@
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 
 import './extensions/utils/inkwell_manager.dart';
 
 part './extensions/build_context.dart';
+part './extensions/color.dart';
+part './extensions/edge_insets.dart';
 part './extensions/image_widget.dart';
 part './extensions/stateless_widget.dart';
+part './extensions/string.dart';
 part './extensions/text_style.dart';
 part './extensions/text_widget.dart';
 part './extensions/widget.dart';
+part './extensions/widget_list.dart';