beamer 2.0.0-dev.0 changelog

2.0.0-dev.0 #

DISCLAIMER #

This is in no way a big fancy release, just a push of all the important and breaking changes that have been sitting in master for too long, hoping for a major release that didn't come yet. Now we can continue towards v2...

BREAKING: bump lower SDK constraint to 2.14
BREAKING: BeamPage.key is now required (#443)
BREAKING: BeamGuard function now have 1 additional parameter which is a persistent deep link set by the platform or developer (#567)
Fixed: rebuild of nested Beamer upon deep link (MarkRunWu, #557)
Fixed: BeamParameters 1-off in history (themartorana, #562)

Examples #

Added bottom_navigation_riverpod (vduseev, #601)
Added bottom_rail_navigation_multiple_beamers (Protoss78, #539)
Fixed logout behavior in authentication_bloc (fallouh, #590)

1.5.6 #

Fixed: copying of route state when relative beaming is used (Panz99, #624, #623)

1.5.5 #

Increase SDK upper bound to <4.0.0

1.5.4 #

Fixed: Usage of Object.hash

1.5.3 #

Fixed: Warning for usage of deprecated hashValues

1.5.2 #

Fixed: Rebuilding of nested Beamers upon deep-links (#554, #555, #46ebf6b)

1.5.1 #

Fixed: Lagging BeamGuard check when using BeamerLocationBuilder (#532)

1.5.0 #

Added: onUpdate method to BeamLocation which is called after initState and on every update. (#507, #88c8537). See this example that demonstrates its possible usage.
Added: isEqualTo extension method to RouteInformation (intentionally not overriding the equality operator)
Fixed: Possible wrong URL after global rebuild with multiple child Beamers (#523)
Fixed: Consistency of calls to BeamLocation.updateState (#484)
Fixed: Resetting popConfiguration after popToNamed parameter has been used in a beamToNamed call (#521)

Documentation #

Added explanation of some specific parameters at Nested Navigation section in README (#514)

Examples #

Improved books_blos example with usage of new BeamLocation.onUpdate

Ecosystem #

Added a beam_location brick
Various improvements on website (devj3ns)

1.4.1+1 #

Fixed: formatting of beamer.dart file

1.4.1 #

Fixed: Initial guarding browser URL (#501, b2a9f0b)
Fixed: Deeper routes matching with asterisk (cgaisl, #494, #502)
Fixed: Nested navigation crash with guards (svsk417, #490)
Fixed: Breaking out of popToNamed loop (Goddchen, #500)

Documentation #

Added website app; a starting point for extensive, self-explanatory Beamer documentation at beamer.dev
Fixed typos and added doc comment for accessing root Beamer (gazialankus)

1.4.0+1 #

Documentation #

Various README improvements and tweaks

1.4.0 #

Added: Relative beaming, i.e. being able to call beamToNamed('path') instead of beamToNamed('/my/path') if we're already at /my. Important note: This will affect all beaming that is not using the leading /, i.e. it will treat it as relative and append it to current path.
Added: New BeamPageTypes; slideRightTransition, slideLeftTransition and slideTopTransition (Shiba-Kar, #477)
Improved: Interactions between nested and sibling Beamers by having children automatically take priority and more carefully handle locally not found cases
Fixed: Unnecessary update of ChangeNotifier custom state (jmysliv, #475)
Fixed:: Target BeamLocation initialization during beamBack
Fixed: Insufficiently detailed automatic BeamPage.key in some RoutesLocationBuilder.routes usage of *

Examples #

Added a new example: multiple_beamers
Improved and simplified bottom_navigation_multiple_beamers example
Fixed updating Beamer in authentication_riverpod example

1.3.0 #

Added: strictPathPatterns to BeamLocation which will do only exact matches of URI and path pattern (5810c9c)
Added: updateListenable to BeamerDelegate which will trigger update when it notifies (f0ccfd7)
Added: Support for replacing the browser history entry when using beamToReplacement* or specifying replaceRouteInformation: true
Added: Support for setting opaque property on BeamPage (ggirotto, #446)
Added: initializeFromParent property to BeamerDelegate to overcome the limitation of updateFromParent and give finer control over parent interaction (340b474)
Fixed: Browser back/forward buttons behavior, i.e. browser history
Fixed: Initialization of target BeamLocation when beaming back (#463)
Updated: Return values for beamBack and popBeamLocation context extensions (marcguilera, #461, 1045ab3)
Updated: The entire guarding flow (thanks mat100payette for important feedback and contribution)

Examples #

Fixed some edge cases in advanced_books example (jpangburn, #451)
Updated authentication_bloc example guard usage (df194e8)

1.2.0 #

Fixed: Using the initialPath instead of parent's path on nested BeamerDelegate during initialization from parent when the updateFromParent is set to false (samdogg7)

Documentation #

Added a section about Page Keys to README (Goddchen)
Added a sentence about browser's back button to README
Fixed and improved grammar in doc comments (ggirotto)

Examples #

Fixed analyzer warnings (Goddchen)
Updated authentication_bloc example to bloc v8 (Lorenzohidalgo)

1.1.0 #

Most of this release is matuella's directly and indirectly contributions. Many thanks!

Add: a link to Medium article for "Migrating" section in README
Add: lint rules prefer_single_quotes, always_use_package_imports, omit_local_variable_types, prefer_final_locals and comment_references.
Fix: disposing histories on beamBack (#417)
Fix: updating history when setting state manually (#420)
Deprecate: unused BeamerDelegate.preferUpdate
Improve: tests setup (Thanks cedvdb)

1.0.0 #

BREAKING: "top-level state", the one in BeamerDelegate is now RouteInformation instead of BeamState
- BeamerDelegate.state doesn't exist anymore and is replaced with BeamerDelegate.configuration which is RouteInformation and not BeamState
- locationBuilder now works with RouteInformation and BeamConfiguration instead of BeamState
- super() constructor on BeamLocation now takes optional RouteInformation instead of BeamState
- in order to continue using custom BeamLocations with BeamState state, generic type has to be specified; class MyBeamLocation extends BeamLocation<BeamState>
BREAKING: pathBlueprints is renamed to pathPatterns
- BeamLocation.pathPatterns is List<Pattern>
- BeamState.pathBlueprintSegments renamed to BeamState.pathPatternSegments
- BeamGuard.pathBlueprints renamed to BeamGuard.pathPatterns
BREAKING: SimpleLocationBuilder is renamed to RoutesLocationBuilder
- also the SimpleBeamLocation is renamed to RoutesBeamLocation
- routes values now additionally receive data
BREAKING: beamStateHistory and beamLocationHistory have been replaced with beamingHistory that is a List<BeamLocation> and each BeamLocation has history that is List<HistoryElement> where HistoryElement holds RouteInformation and BeamParameters.
- clearBeamStateHistory and clearBeamLocationHistory have been removed.
BREAKING: BeamerDelegate.listener has been renamed to BeamerDelegate.routeListener.
BREAKING: The property pageRouteBuilder in BeamPage is replaced with a new property routeBuilder which works with any RouteBuilder not just PageRouteBuilder.
BREAKING: BeamGuard beamTo receives the origin and target BeamLocations alongside BuildContext.
- replaceCurrent was removed in favor of beamToReplacement.
BREAKING: BeamGuard beamToNamed is now a function that receives the origin and target BeamLocations and returns a String.
- replaceCurrent was removed in favor of beamToNamedReplacement.
Add: guard_riverpod example
Add: firebase_core example
Add: firebase_auth example
Add: change_notifier_custom_state example
Add: BeamerBackButtonDispatcher.alwaysBeamBack to make Android back button always go to previous route, even if it can pop.
Add: BeamPage.routePop that can be used for onPopPage instead of default pathsegmentPop
Add: BeamerDelegate.buildListener, which is called after the pages are built.
Add: fullScreenDialog property to BeamPage
Add: flutter_lints
Add: a presentation resource about beamer
Fix: clearing history range when using popToNamed
Fix: passing BeamPage.title to CupertinoPageRoutes

0.14.1 #

Add: updateParent (default true) to BeamerDelegate
Fix: ignoring query on initial path

0.14.0 #

BREAKING: routes in SimpleLocationBuilder now also bring the state
Add: support for RegExp in pathBlueprints (in both BeamGuards and BeamLocations)
Add: updating nested Beamers on parent navigation
Add: onBack to BeamerbackButtonDispatcher
Add: navigator getter to BeamerDelegate
Add: beamStateHistory and BeamLocationHistory to context extension methods
Add: data parameter to beamBack
Change: BeamPage.pageRouteBuilder return type to be a superclass
Fix: removing last BeamState from history on default pop
Fix: BeamGuard behavior on query parameters
Fix: ignoring trailing / in URIs
Fix: keeping data as long as possible when beaming
Improved Android back button behavior
Improved bottom navigation examples
Improved README

0.13.3 #

Add: authentication_riverpod example
Add: "Tips and Common Issues" to README
Fix: Drawer pop
Fix: beamBackOnPop:true while beaming
Make beamStateHistory and beamLocationHistory public

0.13.2 #

Add: BeamerDelegate.notFoundRedirectNamed
Add: public static BeamPage.defaultOnPopPage
Fix: top-level guard updating URL
Improved guards example
Improved README Quick Start

0.13.1 #

Fix: correctly updating delegate after applying guards

0.13.0 #

BREAKING: renamed BeamerRouterDelegate to BeamerDelegate
BREAKING: renamed BeamerRouteInformationParser to BeamerParser
BREAKING: renamed pagesBuilder to buildPages
BREAKING: renamed Beamer.of(context).currentLocation to Beamer.of(context).currentBeamLocation
Add: BeamPage.popToNamed and BeamPage.onPopPage for fine control of popping
Add: BeamPage.title for setting the browser tab title
Add: SimpleLocationBuilder can now mix BeamPages and Widgets
Add: BeamerParser.onParse for intercepting the parsed state on app load
Add: encoding the data into browser history
Add: blocking capability to BeamGuards
Add: slide and scale transitions to BeamPageType
Add: optional transitionDelegate for beaming
Fix: cascade guarding
Fix: delegate listener not being called always
All examples improved and migrated to null-safety
Improved documentation

0.12.4 #

Add Beamer.setPathUrlStrategy() for removing # from URL
Add persistent auth state on browser refresh in authentication_bloc example
Fix detection of NotFound when using SimpleLocationBuilder
Fix updating route on guard actions
Fix not pushing BeamState in history if it's on top
Fix taking currentLocation on setting initial path

0.12.3 #

Add authentication_bloc example
Fix SimpleBeamLocation ignoring query
Fix updating delegate state on location state change

0.12.2 #

Add listener attribute to BeamerRouterDelegate
Add root attribute to BeamerRouterDelegate and {bool root = false} attribute to Beamer.of
Add canHandle(Uri uri) method to BeamLocation
Fix Updating parent on nested navigation
Fix README typos

0.12.1 #

Fix updating browser history

0.12.0 #

BREAKING: There's no RootRouterDelegate any more. Just rename it to BeamerRouterDelegate. If you were using its homeBuilder, use SimpleLocationBuilder and then routes: {'/': (context) => HomeScreen()}
BREAKING: Behavior of beamBack() was changed to go to previous BeamState, not BeamLocation. If this is not what you want, use popBeamLocation() that has the same behavior as old beamback()
Fix: Important bug while using multiple sibling Beamers

0.11.4 #

Fix currentLocation without listener after guard beam

0.11.3 #

Add beamBackTransitionDelegate to BeamerRouterDelegate
Add transition_delegates.dart with some useful transition delegates
Tweak deep_location example to show this more clearly

0.11.2 #

Fix lost navigationNotifier on rebuilds with nested Beamers

0.11.1 #

Fix possibly null _currentLocation

0.11.0+1 #

add missing ToC titles

0.11.0 #

migrated to null safety
BREAKING: Beamer now takes routerDelegate, not beamLocations directly
BREAKING: BeamerRouterDelegate.beamLocations is now locationBuilder
BREAKING: pagesBuilder now also brings state
Add beamToNamed to BeamGuard
Add various LocationBuilders
Add transitionDelegate to BeamLocation and BeamerRouterDelegate
Add type and pageRouteBuilder to BeamPage, for transition control
Add initialPath to BeamerRouterDelegate
Add popTo/popToNamed options for beaming
Add onPopPage to BeamLocation

0.10.5 #

Remove NavigationNotifier.currentLocation (not needed)

0.10.4 #

Add BeamGuard.beamToNamed

0.10.3 #

Fix Unexpected null value exception; issue 144

0.10.2 #

Fix non-existent state if not set explicitly
(slight) Change to a signature of BeamLocation.createState, but hopefully no one has used it yet to be affected :)

0.10.1 #

Fix creation of a custom BeamState
Add tests and doc comments for BeamState

0.10.0 #

BREAKING Removed most attributes from BeamLocation and put them into BeamLocation.state
BREAKING Changed BeamLocation constructor to take only state.
Add RootRouterDelegate for nested navigation
Add BeamState for more declarative experience

See migration details

0.9.3 #

Add replaceCurrent attribute (default false) to beaming function
Fix old information at Guards section in README

0.9.2 #

Fix removing last path segment from possibly unmodifiable List

0.9.1 #

Fix removing the last empty path segment when it's the only one

0.9.0+1 #

Fix formatting

0.9.0 #

Add removing duplicates in beamHistory + BeamerRouterDelegate.removeDuplicateHistory
Add implicit updates of current location + BeamerRouterDelegate.preferUpdate
Add more Beamer extensions to BuildContext
Remove the need for back_button_interceptor package (not that it's not good, but we realized it can be implemented more naturally)

0.8.2 #

Add optional notFoundRedirect to BeamerRouterDelegate
Fix parsing URIs in the form /path/ the same as /path

0.8.1+1 #

Fix README ToC links and typos

0.8.1 #

Remove dart:io

0.8.0 #

BREAKING: BeamLocation.pages is now BeamLocation.pagesBuilder
BREAKING: BeamerRouterDelegate now takes beamLocations and BeamerRouteInformationParser nothing
NEW FEATURE: beamToNamed
NEW FEATURE: canBeamBack and beamBackLocation helpers
NEW FEATURE: BeamGuard.onCheckFailed
NEW FEATURE: stacked parameter for beaming
Add: back_button_interceptor package automatic beamBack on Android back button
Add more details to README: Key Concepts
Add invite to Discord community for beamer help/discussion/chat

0.7.0 #

BREAKING: BeamerRouterDelegate.notFoundPage is now BeamPage instead of Widget
BREAKING: BeamGuard.showPage is now BeamPage instead of Widget
NEW FEATURE: beamBack now goes back through beamHistory
NEW FEATURE: beamTo can take an optional beamBackOnPop boolean
NEW FEATURE: BeamLocation.builder can be used to provide something to the entire location
NEW EXAMPLE: location_builder
NEW EXAMPLE: animated_rail
tweaks and improvements to the documentation

0.6.4+1 #

Add logo image

0.6.4 #

Fix static analysis (Pana 0.14.10, Flutter 1.22.6, Dart 2.10.5) problem by not using maybeOf

0.6.3 #

Add name attribute to BeamPage
Fix BeamerRouterDelegate not notifying listeners on setNewRoutePath

0.6.2 #

Add navigatorObservers attribute to BeamerRouterDelegate

0.6.1 #

Add guardNonMatching attribute to BeamGuard

0.6.0+1 #

Fix some mistakes in README

0.6.0 #

NEW FEATURE: Guards
NEW FEATURE: Beamer as a Widget (see Bottom Navigation example)
Add examples/ for every gif in README
Add state to Beamer

0.5.0 #

BREAKING: *App.router constructor needs to be used
BREAKING: String pathBlueprint is now List<String> pathBlueprints
BREAKING: BeamLocation.withParameters constructor is removed and all parameters are handled with 1 constructor. See example if you need super.
BREAKING: BeamPage's page renamed to child
NEW FEATURE: BeamLocation can support multiple and arbitrary long path blueprints
NEW FEATURE: notFoundPage
Add more complex books example
Add more doc comments
Remove the need for routerDelegate to take locations

0.4.1+1 #

Add some more badges

0.4.1 #

Update example not to access state (books) from BeamLocation

0.4.0 #

BREAKING: BeamLocation.pages must be List<BeamPage> instead of List<Page>
Add keepPathParametersOnPop to BeamPage
Fix _currentPages to BeamLocation parsing when page stack is beyond URI path parameter
Update README
Cleanup

0.3.0 #

Add Beamer.of(context) for convenience
Add recreation of "official" books example
Update README
Cleanup

0.2.0 #

BREAKING: Beamer must be placed in a Widget tree
BREAKING: beaming is now only possible with extension methods on BuildContext
BREAKING: BeamPage.identifier replaced with BeamPage.key
Remove BeamLocation.popLocation
Add "backwards parse" of URI
Format pedantically
Update README with new practices and deep location example

0.1.2 #

Add dartdoc and tests

0.1.1 #

Remove widgets from export barrel

0.1.0+1 #

Add more to pub description

0.1.0 #

Initial release

beamer 2.0.0-dev.0 beamer: ^2.0.0-dev.0 copied to clipboard

Metadata

2.0.0-dev.0 #

DISCLAIMER #

Examples #

1.5.6 #

1.5.5 #

1.5.4 #

1.5.3 #

1.5.2 #

1.5.1 #

1.5.0 #

Documentation #

Examples #

Ecosystem #

1.4.1+1 #

1.4.1 #

Documentation #

1.4.0+1 #

Documentation #

1.4.0 #

Examples #

1.3.0 #

Examples #

1.2.0 #

Documentation #

Examples #

1.1.0 #

1.0.0 #

0.14.1 #

0.14.0 #

0.13.3 #

0.13.2 #

0.13.1 #

0.13.0 #

0.12.4 #

0.12.3 #

0.12.2 #

0.12.1 #

0.12.0 #

0.11.4 #

0.11.3 #

0.11.2 #

0.11.1 #

0.11.0+1 #

0.11.0 #

0.10.5 #

0.10.4 #

0.10.3 #

0.10.2 #

0.10.1 #

0.10.0 #

0.9.3 #

0.9.2 #

0.9.1 #

0.9.0+1 #

0.9.0 #

0.8.2 #

0.8.1+1 #

0.8.1 #

0.8.0 #

0.7.0 #

0.6.4+1 #

0.6.4 #

0.6.3 #

0.6.2 #

0.6.1 #

0.6.0+1 #

0.6.0 #

0.5.0 #

0.4.1+1 #

0.4.1 #

0.4.0 #

0.3.0 #

0.2.0 #

0.1.2 #

0.1.1 #

0.1.0+1 #

0.1.0 #

← Metadata

beamer 2.0.0-dev.0
beamer: ^2.0.0-dev.0 copied to clipboard