opticore 2.3.0

OptiCore is a lightweight micro-framework for Flutter that simplifies and optimizes your app development

📌 Changelog

All notable changes to this project are documented here. Each release includes details about new features, improvements, bug fixes, and any breaking changes, helping users and developers track the evolution of OptiCore.

🔄 Versioning Strategy

We follow Semantic Versioning (SemVer) to indicate the nature of changes:

• 🚀 MAJOR: Breaking changes that may affect compatibility.
• 🌟 MINOR: New features or improvements that are backward compatible.
• 🛠 PATCH: Bug fixes and minor improvements that are backward compatible.

Each section lists the changes in chronological order, with the most recent release at the top. Where applicable, links to relevant discussions or issues are provided.

🎯 [2.3.0] - Stability & Network Enhancements

• 🆕 New Features:

  • Added ReactiveSelector<T, S> widget for type-safe property selection (replaces Reactive.select with proper generics)
  • Added ReactiveBuilder<T> widget for lightweight ValueListenable rebuilds with buildWhen support
  • Added BlocPartBuilder for building specific parts of BLoC state
  • Added CancelToken support in NetworkHelper.request() for request cancellation
  • Added addInterceptor() / removeInterceptor() to NetworkHelper for custom Dio interceptors
  • Added per-request connectTimeout and receiveTimeout in NetworkHelper.request()
  • Added timeout parameter to SafeCall.execute()
  • Added NoInternetException type for type-safe no-internet detection
  • Added SSL certificate pinning support via NetworkHelper.loadPinningCertificate()
  • Added builder parameter to AppConfig for custom root-level widget wrappers
  • Added ToastConfig for global toast color customization
  • Added full WASM/web platform support via conditional imports and platform stubs

• 🐛 Bug Fixes:

  • Fixed NetworkHelper creating new Dio instance per repository (now singleton)
  • Fixed memory leak in TextInputHelper — listener removal callback now returned
  • Fixed magic string "487" for no-internet detection — replaced with NoInternetException type check
  • Fixed force-unwrap crash in MaintenanceScreen.refreshCallBack
  • Fixed ConnectionHelper subscription never cancelled and stale cache
  • Fixed BaseScreen.showLoading() using 300s uncancellable timeout (now 30s cancellable Timer)
  • Fixed BaseScreen.closeKeyboard() and CoreSetup force-unwrap on primaryFocus
  • Fixed BaseScreen._handleNullBuilder() returning dynamic instead of Widget
  • Fixed NoInternetScreen setting static flag inside build() (moved to initState())
  • Fixed LazyIndexedStack force-unwraps on nullable controllers and pageBuilder
  • Fixed ApiResponse only extracting data["message"] — now tries error, detail, error_message
  • Fixed ApiResponse treating 403 as generic error — now handled as unauthorizedError like 401
  • Fixed unsafe _previousValue as T cast in Reactive widget
  • Fixed AsyncReactiveNotifier.execute() race condition with concurrent calls (operation ID guard)
  • Fixed ContentBuilder not caching BLoC when disposeBloc: false
  • Fixed StateBuilder buildWhen not working (rewritten with BlocBuilder)
  • Fixed EventTransformers debounce missing isClosed guard
  • Fixed DioConnectivityRequest missing retry guard and completion checks
  • Fixed ExpandableText hardcoded LTR direction
  • Fixed HideOnScroll accessing scrollController.position without hasClients guard

🛠 [2.2.1] - CoreSetup Builder & Toast Customization

• 🆕 New Features:
  • Added builder parameter (TransitionBuilder?) to AppConfig for injecting custom root-level widget wrappers (e.g., providers, overlays) on top of the internal BotToast and MediaQuery setup in CoreSetup
  • Added ToastConfig for global toast color customization — override successColor, errorColor, infoColor, warningColor, iconColor, and textColor at runtime via ToastConfig.instantiate()
  • ToastHelper now reads all colors from ToastConfig, falling back to the original CoreColors defaults when not configured

🎯 [2.2.0] - Reactive State Management

• 🆕 New Features:
  • Added ReactiveNotifier<T> - A lightweight reactive value holder similar to ValueNotifier with extra convenience methods (update, silent, refresh)
  • Added AsyncReactiveNotifier<T> - For async operations with built-in loading/error/data states
  • Added Reactive<T> widget - A single unified widget for reactive UI rebuilds with optional features:
    • buildWhen - Control when to rebuild
    • listener - Side effects without rebuilding
    • autoDispose - Automatically dispose notifier when widget is removed
    • Reactive.multi - Listen to multiple notifiers
    • Reactive.select - Rebuild only when selected property changes
    • Reactive.async - Handle async states with loading/error/data builders
  • Added ReactiveProvider<T> - Share notifiers across the widget tree using InheritedWidget
  • Added context.reactive<T>() extension for easy notifier access

🎯 [2.1.8] - BLoC Lifecycle Control

• 🆕 New Features:
  • Added disposeBloc parameter to BaseScreen for controlling BLoC disposal behavior
  • Added customAppBarWidget parameter to MaintenanceConfig for custom app bar support
  • MaintenanceScreen now conditionally allows back navigation when custom app bar is configured

🛠 [2.1.7] - Status Bar Navigation Fix

• 🐛 Bug Fixes:

  • Fixed status bar icon color not updating when navigating back to previous screen
  • Implemented RouteAware mixin in BaseScreen to properly track navigation lifecycle
  • Added global RouteObserver to RouteHelper for navigation event monitoring
  • Status bar icons now correctly switch between dark/light when popping back from another screen
  • Added sized: true to AnnotatedRegion for better status bar overlay coverage

• ⚡ Performance Improvements:

  • Optimized _refreshStatusBar() calls to only fire on actual navigation events (push/pop)
  • Removed redundant status bar updates from initState, didChangeDependencies, and didUpdateWidget
  • Reduced unnecessary rebuilds and system UI overlay updates

• 🏗 Infrastructure:

  • Enhanced CoreSetup to include RouteObserver in navigator observers
  • Improved navigation lifecycle handling across all screens using BaseScreen

🚀 [2.1.6] - Event Transformers & UI Enhancements

• 🎯 New Features:

  • Added Event Transformers for BLoC pattern with debounce and sequential processing
  • Introduced debounce() transformer with customizable duration for delayed event processing
  • Added predefined transformers: fastDebounce(), standardDebounce(), slowDebounce(), verySlowDebounce()
  • Implemented sequential() transformer for one-by-one event processing

• 🎨 UI Improvements:

  • Enhanced CoreButton with additional tap gesture support
  • Added barrierColor property to CoreSheet for better customization

• 🐛 Bug Fixes:

  • Fixed status bar icon color issues across different themes
  • Resolved type compatibility issues in theme extensions (AppBarThemeData, InputDecorationThemeData)

🆕 [2.1.5] - Scroll Overlay & Usability Improvements

• 🧩 New Widget:

  • ScrollStatusBarOverlay: Wraps a scrollable and paints an overlay behind the status bar to improve visual experience in scrollable UIs.

• 🎨 UI Enhancements:

  • Added PlaceholderAlignment support to withUnderline inside WidgetSpan for more control over inline widget alignment.
  • Introduced zero itemPadding default to FlexibleGridView for tighter and more compact grid spacing.

• 🔐 Extensions:

  • Enhanced safeInt extension for better default handling and fallback precision.

• 📦 Dependency Updates:

  • Updated internal dependencies for performance, compatibility, and future-proofing.

✨ [2.1.4] - UI & String Extension Enhancements

• 📝 ExpandableText:

  • Added underline support for enhanced text styling.

• 🌐 String Extension:

  • Introduced .arabicNumbers getter to convert English digits into Arabic numerals.

🔧 [2.1.3] - Validation Toolkit & Dependency Updates

• 📦 Dependency Updates:

  • Upgraded internal packages to ensure stability and compatibility

• ✅ Validation Improvements:

  • Integrated auto_validate package
  • Centralized and enhanced validation capabilities across the micro-framework

🛠 [2.1.2] - API Enhancements

• 🧰 Improved Map Extensions:
  • Made key parameter optional in safeList<T>() for more flexible API usage
  • Enhanced return behavior to provide empty list when key is not provided

🛠 [2.1.1] - Static Analysis Improvements

• 📊 Enhanced pub score with improved static analysis compliance
• 📝 Documentation refinements for better DartDoc generation
• 🔍 Type safety enhancements across all components
• 🧹 Code cleanup with removal of unused imports and dependencies

🌟 [2.1.0] - Core Improvements & New Components

🆕 New Features

• 🧩 Added StateBuilder widget for selective UI updates based on specific component states
• 🏗️ Added ComponentDataState in RenderState for better state management
• 🧰 New Extensions:
  • DoubleFormatter for smart number formatting (formatSmart)
  • IterableExtension with firstWhereOrNull method for safer collection operations
• 🎛️ Enhanced CoreButton with new properties (dimmedBackgroundColor, dimmedTextColor)

🔄 Improvements

• 🖼️ SvgWidget Enhancements:
  • Auto-detection of SVG type
  • More flexible property requirements (path, bytes, or file)
• 🌐 API & Network improvements:
  • Better error handling
  • Fixed issues with status code parsing
  • Improved connection timeout handling with proper loading states
  • Fixed updateHeaders issues in BaseRepo
• 📱 UI Components:
  • Enhanced click behavior in ExpandableText
  • Added enableScroll property to CoreSheet
  • Set itemPadding default to zero in FlexibleListView
• 📊 Code Quality:
  • Improved BaseBloc implementation
  • Updated dependencies to latest versions

🛑 Breaking Changes

• 🔄 Renamed builder to itemBuilder in FlexibleGridView for API consistency

📝 [2.0.1] - Documentation Update

• 📖 Enhanced README.md: Improved clarity, structure, and formatting for better readability.

🔹 [2.0.0] - Initial Stable Release

• 🎉 First official stable release of OptiCore.

For a complete history of updates during the beta phase, refer to Beta History.

---

Stay updated with the latest enhancements and fixes! 🚀