loading_kit 0.2.0
loading_kit: ^0.2.0 copied to clipboard
A blocking-async overlay that never flickers. Wrap any Future in one call: delayed reveal, minimum display time, reference counting, cancellation, and themed presets.
0.2.0 #
Everything is now a token. Nothing about the indicator, the card, or the toasts is hardcoded any more.
Added #
LoadingMotioncontrols animation speed:spinPeriod,morphDuration,progressDuration,barSweepPeriod,crossFadeDuration. Ships withstandard,briskandcalmprofiles.LoadingToastStylecontrols toast chrome: padding, radius, icon size and stroke, gaps, enter duration.- Card metrics as tokens:
cardMinWidth,textGap,cancelMinimumSize,cancelPadding. LoadingProgressBartakessweepPeriodandfillDurationdirectly.LoadingControllertakestoastExitDuration,defaultToastDurationandmaxVisibleToasts.
Fixed #
- A
cardMinWidthabovemaxCardWidthproduced non-normalized constraints and threw. The pair is now clamped, since both come from the caller.
Breaking #
LoadingController.toastExitDuration,defaultToastDurationandmaxVisibleToastsmoved from statics to instance fields set on the constructor. Thedurationargument totoastis now nullable and falls back to the controller's own default.
0.1.0 #
Initial release.
Indicators #
- Six indeterminate forms —
arc,dots,bars,orbit,pulse,ripple— all settling into the same check or cross. indicatorBuilderreplaces the built-in indicator with any widget, so Lottie, Rive, or another spinner package can be dropped straight in.LoadingProgressStyle.bardraws determinate progress as a linear bar.
Beyond the full-screen overlay #
-
Loading.toast/toastSuccess/toastErrorfor transient, non-blocking messages that never intercept input. -
LoadingBarrierscopes the overlay to a single subtree while still applying the timing policy. -
Loading.run/runTaskwrap a future behind the overlay in one call. -
Timing policy with a reveal delay and a minimum-visible window, so fast operations paint nothing and slow ones do not blink out.
-
Reference counting across concurrent operations, with a running operation outranking one that has already settled.
-
Determinate progress, cooperative cancellation, and timeouts.
-
Success and error states drawn as one continuous morph of the arc rather than a widget swap.
-
Five presets —
cupertino,material,glass,minimal,neon— plusadaptive, all resolving against the ambient theme in light and dark. -
Route awareness via
LoadingNavigatorObserver. -
Input blocking, focus trapping, live-region announcements,
BlockSemantics, and reduced-motion support. -
LoadingIndicatorusable standalone, with no overlay or controller.