pop_overlay 5.0.0

A feature-rich package for displaying customizable pop-ups from any given widget. Featuring animated, draggable overlays, with optional background blur effects...

5.0.0

• s_modoverlay interleaving architecture hardening (modal + pop overlay coexistence):

  • Stabilized shared interleaving behavior between s_modal and pop_overlay so both systems can coexist in a single overlay stack with deterministic ordering.
  • Consolidated root-overlay resolution paths to avoid duplicated host-resolution logic and reduce divergence risk.
  • Improved host lifecycle safety to avoid duplicate interleaved host installation and unintended layer remounts during overlay reordering.
  • Improved layer identity stability in interleaved rendering paths so active overlays (notably snackbars) are not remounted when unrelated layers are added/removed.

• Stack-level synchronization fixes:

  • Fixed pop_overlay stack-level mutations (setStackLevel, bringToFront, sendToBack) so interleaved layers are re-registered with updated effective levels immediately.
  • Preserved ordering consistency between activation order and stack level across interleaved updates.

• s_modal lifecycle and dismissal robustness improvements:

  • Improved dialog/sheet/snackbar coordination during dismiss flows to reduce race conditions across mixed overlay scenarios.
  • Hardened snackbar-controller lifecycle behavior during interleaved modal transitions.
  • Applied additional cleanup/guard logic around dismiss paths to keep active-state transitions deterministic.

• Lifecycle observability and event filtering API additions:

  • Added public lifecycle event types and payloads: ModalLifecycleEventType, ModalLifecycleEvent.
  • Added optional Modal.appBuilder(...) lifecycle hooks: onModalCreated, onModalDismissed.
  • Added lifecycle filtering in appBuilder: lifecycleModalTypes and shouldNotify.
  • Added lifecycle listener management APIs: Modal.addLifecycleListener(...), Modal.removeLifecycleListener(...), and Modal.clearLifecycleListeners().

• Custom modal integration hardening:

  • Promoted ModalType.custom to a first-class flow in interleaving/show/dismiss paths.
  • Added/solidified custom modal state checks and cleanup behavior (Modal.isCustomActive) to keep mixed-layer dismiss transitions deterministic.

• Interleaved barrier and host management improvements:

  • Added single barrier-owner resolution via OverlayInterleaveManager.topBarrierOwnerLayerId(...) to avoid compounded backdrop opacity and barrier flicker when multiple layers coexist.
  • Added OverlayInterleaveManager.teardownHost(...) for reliable hard-reset cleanup in teardown/test scenarios.

• Dismiss API coverage expansion:

  • Added/solidified targeted dismissal helpers for complex mixed-layer flows: Modal.dismissCurrentModal(...), Modal.dismissSnackbarAtPosition(...), Modal.dismissByIds(...), and Modal.dismissByType(...).

• Testing and reliability:

  • Fixed the hanging snackbar/modal interaction regression in test/modal_background_interaction_test.dart by using deterministic pump timing around async dismissal flows.
  • Improved timing stability in modal background interaction tests where long-running animation controllers can make pumpAndSettle() non-terminating.
  • Preserved and validated overlay ordering and interleaving behavior through the existing stack-ordering test coverage.
  • Added regression coverage for lifecycle callback/listener filtering/removal and barrier-owner policy behavior across interleaved layers.

• Developer-experience cleanup:

  • Commented out verbose s_modoverlay runtime debug logs ([Modal], [OverlayInterleave], [PopOverlay], [snackbar_debug], and escape-key diagnostics) to keep console/test output clean by default.

4.3.0

• s_packages dependency upgraded to ^3.6.0
  • Popup tap-region coordination upgrade:
    • Added a shared PopOverlayTapRegionScope so popup content can expose a common TapRegion group to nested overlays.
    • Updated pop_overlay frame templates to wrap popup surfaces in the shared tap-region scope when one is available, keeping child interactions from being misclassified as outside taps.
    • Extended s_context_menu and s_dropdown with optional tap-region group support so both widgets can live safely inside popups without premature dismissal.
    • Added regression coverage for the new tap-region inheritance flow, including dropdown and context-menu overlays.

4.2.3

• s_packages dependency upgraded to ^3.4.0
  • internal SInkButton widgets now show the click cursor on web/desktop hover, giving clearer visual feedback that the widget is interactive.
    • Disabled SInkButton widgets keep the basic cursor so non-interactive states remain visually distinct.

4.2.2

• quick pubspec.yaml update

4.2.1

• s_packages dependency upgraded to ^3.3.1
  • pop_overlay interaction and layout refinements:
    • Added optional TapRegion integration to PopOverlayContent (tapRegionGroupId, onTapRegionOutside, onTapRegionInside, tapRegionBehavior, tapRegionConsumeOutsideTaps) so overlay content can participate in grouped inside/outside tap handling.
    • Updated the overlay activator to inherit the surrounding app theme, scroll behavior, and text direction instead of spinning up a nested MaterialApp, improving integration inside host applications.
    • Improved dismissal safety by ensuring delayed removals only dispose the exact overlay instance that started exiting, preventing stale dismiss timers from removing a newer overlay that reused the same ID.
    • Improved framed popup sizing with responsive width/height resolution, maximum viewport constraints, and better handling of fractional dimensions for web and constrained layouts.
    • Improved drag lifecycle tracking so drag state is reset consistently on drag start/end/cancel for both popup bodies and draggable headers.
    • Fixed auto-dismiss behavior to trigger onDismissed correctly when overlays are made invisible on dismiss.

4.2.0

• s_packages dependency upgraded to ^3.3.0
  • pop_overlay stack layering upgrade
    • Added stackLevel to PopOverlayContent with default PopOverlayStackLevels.overlay.
    • Added stack APIs: getStackLevel, setStackLevel, bringToFront, sendToBack, and activeIdsByStackOrder.
    • Added stack constants helpers: PopOverlayStackLevels and PopOverlayStackLevelBands.
    • Replaced hard-coded priority-only ordering with stable effective-level sorting while preserving legacy priority bonuses for known critical overlays.
    • Improved reactivation/update flow for invisible overlays when offsetToPopFrom or stackLevel changes, including proper replacement cleanup.

4.1.0

• s_packages dependency upgraded to ^3.1.0

4.0.0

• s_packages dependency upgraded to ^3.0.0

3.3.0

• s_packages dependency upgraded
• Improved overlay bootstrap resolution to prefer the nearest overlay context before falling back to the root overlay.
• Fixed popup positioning for framed/scaled layouts (notably web) by keeping overlays in the same coordinate space as the caller.

3.2.1

• s_packages package dependency upgraded

3.2.0

• s_packages dependency upgraded to ^1.3.0
• PopOverlay.dismissAllPops added with optional includeInvisible and except parameters
• PopOverlay.replacePop for atomically replacing an overlay with a new one
• Added query helpers: isVisibleById, getVisiblePops, getInvisiblePops, visibleCount, invisibleCount
• Added shouldDismissOnEscapeKey flag on PopOverlayContent to opt out of Escape key dismissal per overlay
• Added onMadeVisible callback on PopOverlayContent (counterpart to onMadeInvisible)
• Added onDragStart and onDragEnd callbacks on PopOverlayContent
• Added dragBounds on PopOverlayContent to constrain dragging within a Rect
• FrameDesign additions:
  • subtitle property for secondary text below the title
  • titleBarColor and bottomBarColor for per-popup color customization
  • headerTrailingWidgets for extra action widgets in the header

3.1.2

• pop_overlay animation improvements:
  • Added smooth fade-in animations to all popup types; fixes flash issue in FrameDesign popups by smoothly animating appearance during auto dynamic dimension calculation time
  • Extended animation durations for smoother transitions: blur background (400ms → 600ms), barrier fade (0.4-0.5s → 0.8-1.0s), and animated size (300ms → 500ms)
  • Added borderRadius support to example demos for better visual consistency
  • Optimized popup entrance animations with Curves.fastEaseInToSlowEaseOut for more natural motion

3.1.1

• s_packages upgraded: Replaced pop_overlay's use of MediaQuery.of(context).size with Size(100.w, 100.h) for better responsive sizing using the sizer package throughout the overlay system Improved cross-platform compatibility and responsive behavior

3.1.0

• s_packages upgraded: PopOverlay.addPop(...) upgraded to allow pops to pop from a given offsetToPopFrom offset param, to a popPositionOffset param, with a given or default popPositionAnimationCurve and popPositionAnimationDuration.

3.0.2

• fixed pub.dev's Documentation analysis issue

3.0.1

• dependent on s_packages version ^1.1.2

3.0.0

• package no longer holds the source code for it, but exports/exposes the s_packages package instead, which will hold this package's latest source code.
• The only future changes to this package will be made via s_packages package dependency upgrades, in order to bring the new fixes or changes to this package

2.0.0

• Breaking change: PopOverlay now self-installs its activator into the root overlay.
  • removed static public method PopOverlay.activator.
• Added internal bootstrapper to ensure activation when PopOverlay.addPop(...) is called.

1.0.4

• updated dependencies

1.0.3

• updated pubspec.yaml - to specify all supported platforms

1.0.2

• README updated

1.0.1

• README and demo.gif updated

1.0.0

• Initial release of pop_overlay package
• Flexible pop-up overlay system with automatic stacking
• Support for multiple overlays with customizable animations
• Background blur effects and tap-to-dismiss functionality
• Priority-based display ordering
• Draggable pop-up support with position tracking
• Framed Design system for consistent UI styling
• Escape key listener for keyboard dismissal
• Performance optimizations for smooth animations
• Full customization of overlay appearance and behavior