heroine

• [email protected]
• [email protected]
• [email protected]
• [email protected]+8

• FEAT: add shouldTransition callback to Heroine for route-based filtering.

• FEAT(heroine): add DuplicateHeroinePolicy to control duplicate tag behavior.

  Previously, having multiple Heroine widgets with the same tag in a single route subtree would always throw in debug mode. This adds a duplicatePolicy parameter to Heroine with three options:

  • forbidden (default): preserves the existing behavior, throwing in debug mode when duplicates are found.
  • first: silently uses the first Heroine encountered for a given tag and ignores subsequent duplicates.
  • last: uses the last Heroine encountered, overwriting previous ones.

  Both first and last call _endFlight on the discarded heroine to prevent it from being left hidden after a previous flight.

Note: This release has breaking changes.

• REFACTOR: greatly simplify the state management of the Heroine widget.

• DOCS: update readme.

• BREAKING REFACTOR: remove simplifications from HeroineShuttleBuilder.

  All convenience methods and standard wrappers have been moved to SimpleShuttleBuilder. If you implemented your own custom HeroineShuttleBuilders before, just extend that class instead. This accurately reflects that not all HeroineShuttleBuilders can be chained. Before, if you tried to chain a HeroineShuttleBuilder.fromHero, you would get unexpected results.

• BREAKING FEAT: keep tickers running during the flight.

  You can set pauseTickersDuringFlight to false in your Heroine to restore the standard Flutter Hero behavior.

• FIX: don't throw in some cases when DragDismissable.custom is disabled.

Note: This release has breaking changes.

• FIX: transition when both Heroines were in the exact same place.

• FEAT: add continuouslyTrackTarget to Heroine.

  With this, a heroine can dynamically update its target position during a flight when things like the current viewInsets change.

• BREAKING FEAT: Heroine will not perform any transition when a route is popped via user gesture.

• DOCS: document continuouslyTrackTarget in README.

• Update a dependency to the latest release.

• FIX: export HeroineVelocity (#199).

• Update a dependency to the latest release.

• Update a dependency to the latest release.

• Update a dependency to the latest release.

• Update a dependency to the latest release.

• Update a dependency to the latest release.

Note: This release has breaking changes.

• FEAT: add TrimmedMotion as a way to take subsets of any motion.
• DOCS: update readme in heroine to reflect new changes.
• BREAKING REFACTOR: use positional parameters for CurvedMotion.

• FIX: export all motor motion types from heroine.
• FIX: heroine transitions flicker with flutter 3.35.

• Update a dependency to the latest release.

• Update a dependency to the latest release.

Note: This release has breaking changes.

• FIX: removed an unnecessary rebuild for the arriving heroine (#121).
• FEAT: add optional z-index to Heroine (#122).
• BREAKING REFACTOR: turned CupertinoMotion constants into constructors so parameters can be adjusted on the fly.

Note: This release has breaking changes.

• BREAKING REFACTOR: remove experimental changes from springster and add to new motor package instead (#117).
• BREAKING FEAT: migrate to motor's Motion system and add comprehensive migration guide.
  • Support all kinds of motions, not just springs.
  • Check out the package documentation for more details on how to use the new APIs.

Note: This release has breaking changes.

• DOCS: improved zoom transition examples.

• BREAKING FEAT: Heroine now accepts any Motion, not just springs.

• BREAKING FEAT: Add HeroineMode, an equivalent to HeroMode for Heroine.

  Heroine does not respect HeroMode anymore, use HeroineMode instead. This allows for better parallel use of Heroine and Hero in the same tree.

• FEAT: support nested heroines if they are not part of the same transition.
• FEAT: update examples to use new motor motion APIs.
• DOCS: added fullscreen gif.
• DOCS: add mention to nested heroines in README.

• REFACTOR: MotionController now uses a single Ticker, which should also improve performance.
• FEAT: support separate motion per dimension.

Note: This release has breaking changes.

• FEAT: use new Motion based APIs from motor internally.
• BREAKING FEAT: add MotionConverter API to simplify the usage of controllers.

Note: This release has breaking changes.

• FIX: null check error when interacting really quickly (#71).
• FIX: DragDismissable.pop calls maybePop to better respect the routes wishes.
• FEAT: DragDismissable now also dismisses when drag velocity exceeds a threshold.
• FEAT: HeroineShuttleBuilder can now be passed a Curve to better customize its animation.
• BREAKING REFACTOR: Removed DragDismissble.pop and the default constructor of DragDismissible now pops the page. Use DragDismissible.custom if you want to pass a custom callback.
• BREAKING REFACTOR: Heroine doesn't accept HeroFlightShuttleBuilder functions directly anymore. Use HeroineShuttleBuilder.fromHero to keep using your existing functions.

• Update a dependency to the latest release.

Note: This release has breaking changes.

• FIX: Heroines now correctly dispose any Tickers they created.
• FEAT: Add FadeThroughShuttleBuilder that fades through a given color. Try to chain it with FlipShuttleBuilder for cool effects.
• FEAT: got rid of sleight visual jank that sometimes occured when a heroine arrived at her destination.
• BREAKING REFACTOR: rename SimpleSpring to Spring.
• BREAKING FEAT: support chaining HeroineShuttleBuilders for more complex animations.

Note: This release has breaking changes.

• DOCS: add Bluesky badge to README files across packages.
• BREAKING REFACTOR: unified SpringSimulationController interface to match AnimationController more closely.

• FIX: fixed example dependencies (#62).

• DOCS: added animation to README.
• FEAT: update README files with example links.
• FEAT: added unified example to monorepo.
• FEAT: add motor dependency and enhance Hero widget documentation.