• All adaptive components now properly use theme colors when no explicit color provided
• iOS: Uses CupertinoTheme.of(context).primaryColor
• Android: Uses Theme.of(context).colorScheme.primary
• Material button styles now respect elevatedButtonTheme, textButtonTheme, etc.

• iOS 26+ native buttons now properly size to content width
• Removed forced full-width constraint in Swift implementation
• Buttons work correctly with mainAxisAlignment: MainAxisAlignment.spaceBetween

• Text now automatically switches to white in dark mode, black in light mode
• Applied to all scaffold implementations (iOS 26+ and legacy)

• Suffix widget now uses suffixIcon internally to prevent extra vertical space
• Added isDense: true to reduce padding

• Back button now shows even when title is not provided

• Scaffold now always used on Android to ensure Material context

• iOS 26+: Native UIVisualEffectView with system blur styles (systemMaterial, systemThick, systemThin, etc.)
• iOS <26 & Android: Flutter-based BackdropFilter with gaussian blur
• Supports custom blur styles and border radius
• Perfect for overlays, card backgrounds, and glassmorphic effects

• When unselectedItemColor is null, now uses theme's default color instead of forcing a color
• iOS 26+: Uses .alwaysTemplate rendering mode when no custom color provided
• CupertinoTabBar: Removed forced CupertinoColors.inactiveGray fallback

• Back button now stays on the left when title is missing
• Actions now properly align to the right when title is missing
• Improved flexible space handling for all layout combinations

• iOS 26+: Icon colors via renderingMode (.alwaysOriginal for unselected, .alwaysTemplate for selected)
• iOS <26 & Android: Native color properties
• Customizable tab bar item colors for better UI flexibility

• Default true: Smooth rectangle corners
• Set to false: Perfect circular/capsule shape for icon buttons

• show() - Standard dialog (returns void)
• inputShow() - Text input dialog (returns String?)
• Cancel button now correctly returns null for input dialogs

• Labels now properly update when state changes

• Pickers now respond to theme changes dynamically

• ToolbarSpacerType.fixed - 12pt fixed space using UIBarButtonItem.fixedSpace() for spacing within groups
• ToolbarSpacerType.flexible - Flexible space using UIBarButtonItem.flexibleSpace() for left/right group separation
• ToolbarSpacerType.none - No spacer (default)
• Follows iOS 26+ Liquid Glass design guidelines per Apple HIG
• Example: AdaptiveAppBarAction(iosSymbol: 'arrow.uturn.forward', onPressed: () {}, spacerAfter: ToolbarSpacerType.flexible)

• Platform-specific localizations: CupertinoLocalizations for iOS, MaterialLocalizations for Android
• Supports 70+ languages automatically based on system locale

• Resolves RenderConstraintsTransformBox overflow issue with CupertinoSlidingSegmentedControl

• Tab bar now ignores scroll events when content is overscrolling (pixels outside minScrollExtent/maxScrollExtent)
• Prevents unwanted tab bar animation during iOS elastic scroll bounce

• Two constructors: default and insetGrouped
• Works with CupertinoFormRow and adaptive components

• iOS: Custom design with rounded corners, smooth shadows, animated chevron, gradient separator, modern child items with tap feedback
• Android: Material ExpansionTile with InkWell effects
• Full customization support (colors, padding, callbacks, alignment)

• iosSymbol for iOS 26+ only, icon for iOS <26 and Android
• Migration: Replace androidIcon: with icon:

• iOS: Uses CupertinoTextField with tertiarySystemBackground color and rounded corners
• Android: Uses Material TextField with outlined border
• Supports all standard text field parameters: placeholder, keyboard type, obscure text, max length, etc.
• Supports prefix and suffix icons on both platforms
• Automatic platform-specific styling and behavior

• iOS: Uses custom FormField wrapper with CupertinoTextField for proper validation
• Android: Uses Material TextFormField
• Full form validation support with validator, onSaved, and autovalidateMode
• Displays error messages with red border on iOS, standard Material error styling on Android
• Supports prefix and suffix icons with proper validation state handling

• Icons now display correctly on both iOS and Android
• iOS icons wrapped in proper padding for consistent spacing
• Added GestureDetector to prevent focus when tapping icons

• Child widgets in IOS26Button.child now wrapped with IgnorePointer
• Icon buttons now respond to taps anywhere on the icon, not just the edges
• Resolves issue where AdaptiveButton.icon had limited tap area

• Separate color control for icon buttons
• textColor remains for label buttons, iconColor for icon buttons
• Consistent API across all button constructors

• NEW: Added badge counter support to AdaptiveNavigationDestination
• Added badgeCount parameter to AdaptiveNavigationDestination class
• iOS 26+: Uses native UITabBarItem.badgeValue for native badge display
• iOS <26 and Android: Uses AdaptiveBadge widget for cross-platform badge display
• Supports dynamic badge updates and proper badge clearing
• Badge counts > 99 display as "99+" following iOS conventions
• Added comprehensive demo page showcasing badge navigation functionality

• iOS: Uses CupertinoDatePicker in a modal bottom sheet with Cancel/Done buttons
• Android: Uses Material DatePickerDialog
• Supports date, dateTime, and time modes
• Configurable date range with firstDate and lastDate parameters
• Returns Future<DateTime?> with selected date or null if cancelled

• iOS: Uses CupertinoDatePicker in time mode in a modal bottom sheet
• Android: Uses Material TimePickerDialog
• Supports both 12-hour and 24-hour formats
• Returns Future<TimeOfDay?> with selected time or null if cancelled

• iOS: Uses CupertinoListTile-like styling with bottom border separator
• Android: Uses Material ListTile
• Supports leading, title, subtitle, and trailing widgets
• Includes onTap and onLongPress callbacks
• Supports selected state and disabled state
• Customizable backgroundColor and padding

• Added AdaptiveAlertDialogInput class for input configuration
• iOS 26+: Native UITextField with native keyboard types
• iOS <26: CupertinoTextField with scrollable content
• Android: Material TextField
• Returns Future<String?> with user input
• Supports placeholder, initial value, keyboard type, obscure text, and max length

• iOS: Uses CupertinoContextMenu.builder with native animations
• Android: Uses PopupMenuButton with Material Design styling
• Supports icons, destructive actions, and disabled states
• Long press to show, tap to select action

• iOS 26+: Accepts SF Symbol strings (e.g., "checkmark.circle.fill")
• iOS <26 and Android: Accepts IconData
• Automatically handles platform-specific icon rendering

• Centralized bottom navigation configuration with bottomNavigationBar parameter in AdaptiveScaffold
• Replaces individual destinations, selectedIndex, onDestinationSelected parameters
• If bottomNavigationBar is null, no bottom navigation will be shown

• items parameter: Navigation items (renamed from destinations)
• selectedIndex parameter: Currently selected item index
• onTap parameter: Callback when item is tapped (renamed from onDestinationSelected)
• useNativeBottomBar parameter: Control iOS 26+ native bottom bar (default: true)
• cupertinoTabBar parameter: Provide custom CupertinoTabBar for iOS
• bottomNavigationBar parameter: Provide custom NavigationBar or BottomNavigationBar for Android

• iOS 26+ with useNativeBottomBar: true: Native UITabBar with Liquid Glass effect is shown, custom cupertinoTabBar is ignored
• iOS 26+ with useNativeBottomBar: false: Custom cupertinoTabBar is used if provided, otherwise auto-generated from items
• iOS <26: Custom cupertinoTabBar is used if provided, otherwise auto-generated from items (useNativeBottomBar is ignored)

• SF Symbol strings (e.g., "house.fill") are now properly converted to IconData for CupertinoTabBar
• Android NavigationBar handles both IconData and SF Symbol strings with appropriate fallbacks

• Removed: Direct destinations, selectedIndex, onDestinationSelected parameters
• Added: Single bottomNavigationBar parameter of type AdaptiveBottomNavigationBar?
• Migration: Wrap existing parameters in AdaptiveBottomNavigationBar()

// Before
AdaptiveScaffold(
  destinations: [...],
  selectedIndex: 0,
  onDestinationSelected: (index) {},
)

// After
AdaptiveScaffold(
  bottomNavigationBar: AdaptiveBottomNavigationBar(
    items: [...],
    selectedIndex: 0,
    onTap: (index) {},
  ),
)

• Centralized app bar configuration with appBar parameter in AdaptiveScaffold
• Replaces individual title, actions, leading, useNativeToolbar parameters
• If appBar is null, no app bar or toolbar will be shown

• cupertinoNavigationBar parameter: Provide custom CupertinoNavigationBar for iOS
• appBar parameter: Provide custom AppBar for Android
• Custom navigation bars take priority over auto-generated ones

• When useNativeToolbar: true: Native iOS 26 toolbar is shown, custom cupertinoNavigationBar is ignored
• When useNativeToolbar: false or not set: Custom cupertinoNavigationBar is used if provided

• Removed: Direct title, actions, leading, useNativeToolbar parameters
• Added: Single appBar parameter of type AdaptiveAppBar?
• Migration: Wrap existing parameters in AdaptiveAppBar()

// Before
AdaptiveScaffold(
  title: 'My App',
  actions: [...],
  useNativeToolbar: true,
)

// After
AdaptiveScaffold(
  appBar: AdaptiveAppBar(
    title: 'My App',
    actions: [...],
    useNativeToolbar: true,
  ),
)

• iOS <26: GestureDetector with CupertinoActionSheet fallback
• Android: Material PopupMenuButton with custom child
• Added demo examples: Custom Button, Card Style, and Chip Style

• iOS: Banner-style notification at the top with slide/fade animations
  • Tap to dismiss
  • Icon indicators for different types
  • Action button support with blur effect
  • Automatic dismissal
• Android: Material SnackBar at the bottom
  • Standard Material Design appearance
  • Action button support
• Supports 4 types: info, success, warning, error
• Customizable duration and action callbacks

• Native toolbar can still be enabled via useNativeToolbar: true parameter in AdaptiveScaffold
• Default behavior now uses CupertinoNavigationBar for better compatibility
• iOS 26+ users will get custom animated back button when useNativeToolbar: false
• Resolves touch callback issues and navigation conflicts with router-based navigation

• Appears automatically when page can pop
• Prevents native back button conflicts during transitions
• Smooth fade-out animation on tap

• iOS: Custom iOS-style card with Cupertino design (border, subtle shadow, rounded corners)
• Android: Material Design Card with elevation support
• Support for custom colors, border radius, padding, margin, and clip behavior

• iOS: Custom iOS-style radio with circular design
• Android: Material Design Radio
• Support for custom colors, toggleable mode, and disabled state

• iOS: Custom iOS-style badge with rounded design
• Android: Material Design Badge
• Support for count/label display, custom colors, show zero option, and large size

• iOS: Custom iOS-style tooltip with animation and theme support
• Android: Material Design Tooltip
• Long press/tap to show, auto-hide after duration

• iOS: Custom iOS-style checkbox with Cupertino design
• Android: Material Design Checkbox
• Support for tristate, custom colors, and dark/light mode

• App-level UITabBarController integration replacing Flutter's navigation
• Native search tab transformation with UISearchController
• Liquid Glass effects and native animations
• Method channel for Flutter ↔ Native communication
• Search query callbacks and tab selection handling
• ⚠️ WARNING: This feature is highly experimental and unstable:
  • Replaces Flutter's root view controller
  • Breaks widget lifecycle and state management
  • Hot reload may not work properly
  • Navigation stack becomes invalid
  • Only recommended for prototyping and demos
• See demo page for detailed technical explanation of architectural conflicts

• AdaptiveApp() - Constructor for normal navigation
• AdaptiveApp.router() - Constructor for router-based navigation (GoRouter, etc.)
• Direct theme parameters: themeMode, materialLightTheme, materialDarkTheme, cupertinoLightTheme, cupertinoDarkTheme
• Platform-specific callbacks: material() and cupertino() for advanced configuration
• Automatic platform detection (iOS uses CupertinoApp, Android uses MaterialApp)
• Full support for all MaterialApp and CupertinoApp properties

• AdaptiveScaffold - Platform-adaptive scaffold with native iOS 26 toolbar and tab bar
• AdaptiveButton - Adaptive buttons with iOS 26 Liquid Glass design
• AdaptiveSegmentedControl - Native segmented controls for all platforms
• AdaptiveSwitch - Platform-adaptive switches
• AdaptiveSlider - Platform-adaptive sliders
• AdaptiveAlertDialog - Native alert dialogs
• AdaptivePopupMenuButton - Platform-adaptive popup menus

• Native UIToolbar with Liquid Glass blur effects
• Native UITabBar with minimize behavior
• Native UISegmentedControl
• Native SF Symbol support
• Haptic feedback
• Automatic light/dark mode adaptation

• iOS 26+ with native Liquid Glass designs
• iOS <26 (iOS 18 and below) with traditional Cupertino widgets
• Android with Material Design 3