overlay library
Consona Mobile — Overlays, drawers, sheets, modals, toasts, menus, tooltips
Classes
- ConsonaActionSheet
- iOS-style action sheet built on ConsonaDrawer with grouped actions + cancel.
- ConsonaActionSheetItem
- One action row inside ConsonaActionSheet.
- ConsonaCommandItem
- A single actionable command entry in ConsonaCommandPalette.
- ConsonaCommandPalette
-
Spotlight (
⌘K/Ctrl+K) command launcher supporting instant query filtering, grouped categories, keyboard Up/Down/Enter navigation, and ConsonaKbd shortcut pills. - ConsonaContextMenu
- Anchored popup context menu.
- ConsonaContextMenuItem
- ConsonaDrawer
- Partial-height bottom drawer with multi-snap detents and velocity dismiss.
- ConsonaDrawerHandle
- Slim grabber used by bottom drawers.
- ConsonaDrawerHeader
- Convenience header used inside drawers.
- ConsonaModal
- Centered modal dialog with slide open/close motion.
- ConsonaOverlayBackdrop
- Dim/blur barrier that tracks progress but never translates with the panel.
- ConsonaOverlayBody
- Overflow-safe body for drawer / sheet content.
- ConsonaOverlayItem
- ConsonaOverlayState
- ConsonaOverlayText
- Text that never paints overflow stripes inside overlay chrome.
- ConsonaPopover
- Rich interactive popover that opens beside the trigger on every viewport.
- ConsonaSheet
- Full-screen edge sheet — covers the viewport, dismissible by drag or close.
- ConsonaSurfaceReveal
- Fade, scale, and short slide that reverses on dismiss.
- ConsonaToastController
- Controller managing toast queues, styles, and auto-dismiss timers.
- ConsonaToastEntry
- ConsonaToastLayer
- App-level toast host for MaterialApp.builder.
- ConsonaToastScope
- Provides an ambient ConsonaToastController to descendants.
- ConsonaToastStack
- Floating toast host — one shared layout clock for enter + stack shift.
- ConsonaToastStyle
- Resolves colors + default poster for a toast card.
- ConsonaTooltip
- Tactile callout balloon tooltip supporting both desktop mouse hover and mobile long-press.
- OverlayEngine
- Pure Dart overlay state machine and priority manager.
Enums
- ConsonaOverlayEdge
- Edge a sheet/drawer may enter from.
- ConsonaOverlayPriority
- ConsonaSheetDirection
- ConsonaToastVariant
- Built-in toast kinds — map to ConsonaToastStyle presets.
Functions
-
consonaModalSlideTransition(
{required Animation< double> animation, required Widget child, Curve curve = ConsonaCurves.subtleEase, Curve reverseCurve = ConsonaCurves.easeOut}) → Widget - Centered modal — short upward slide only.
-
consonaOverlayMotionDuration(
Duration duration) → Duration - Keeps a reveal long enough to read on open and on close. A zero duration (reduced motion) stays instant.
-
consonaSlideTransition(
{required Animation< double> animation, required ConsonaOverlayEdge edge, required Widget child, Curve curve = ConsonaCurves.subtleEase, Curve reverseCurve = ConsonaCurves.easeOut}) → Widget - Pure slide — no fade, no scale. Full off-screen → settled.
-
showConsonaOverlay<
T> ({required BuildContext context, required Widget builder(BuildContext overlayContext, Animation< double> animation), bool barrierDismissible = true, String barrierLabel = 'Dismiss', Duration? transitionDuration, RouteSettings? settings, ConsonaOverlayPriority priority = ConsonaOverlayPriority.sheet}) → Future<T?> - Production showGeneralDialog wrapper.
Typedefs
- ConsonaDialog = ConsonaModal
- Back-compat name for ConsonaModal. Prefer ConsonaModal for new code.