[go_router] Add routing functions to GoRouteData

[StevenSorial]

second step of fixing #106790. First PR

This PR adds the routing methods .location, .go(context), .push(context), .pushReplacement(context), and replace(context) to GoRouteData. They will be overridden by the mixin generated by go_router_builder

Pre-Review Checklist

• I read the Contributor Guide and followed the process outlined there for submitting PRs.
• I read the Tree Hygiene page, which explains my responsibilities.
• I read and followed the relevant style guides and ran the auto-formatter.
• I signed the CLA.
• The title of the PR starts with the name of the package surrounded by square brackets, e.g. [shared_preferences]
• I linked to at least one issue that this PR fixes in the description above.
• I updated pubspec.yaml with an appropriate new version according to the pub versioning philosophy, or I have commented below to indicate which version change exemption this PR falls under¹.
• I updated CHANGELOG.md to add a description of the change, following repository CHANGELOG style, or I have commented below to indicate which CHANGELOG exemption this PR falls under¹.
• I updated/added any relevant documentation (doc comments with ///).
• I added new tests to check the change I am making, or I have commented below to indicate which test exemption this PR falls under¹.
• All existing and new tests are passing.

If you need help, consider asking for advice on the #hackers-new channel on Discord.

Footnotes

1. Regular contributors who have demonstrated familiarity with the repository guidelines only need to comment if the PR is not auto-exempted by repo tooling. ↩ ↩² ↩³

[StevenSorial]

@hannah-hyj

[chunhtai]

LGTM

[chunhtai]

Suggested change

	'It should throw beacuase there is not code generated',
	'It should throw beacuase there is no code generated',

[StevenSorial]

@chunhtai @hannah-hyj Thanks for the approval. There are two things that I would appreciate some help with in this PR:

• Currently if the user installed go_router >= 15.2.0, but go_router_builder < 3.0.0, the exception would be thrown on navigation. Is there a way to describe this dependency?
• I don't like how the test I wrote looks 😅 Is there a way to improve it?

[AndrewDongminYoo]

Hi there,

I ran into a compilation error after upgrading to go_router_builder 3.0.0 together with go_router 15.1.3. The generated mixin looks like this:

mixin _$SplashRoute on GoRouteData {
  static SplashRoute _fromState(GoRouterState state) => const SplashRoute();

  @override
  String get location => GoRouteData.$location('/');

  @override
  void go(BuildContext context) => context.go(location);

  @override
  Future<T?> push<T>(BuildContext context) => context.push<T>(location);
  // …and so on
}

However, in go_router 15.1.3, GoRouteData does not declare location, go(), push(), etc., so the @override annotations cause errors:

Error: The method ‘location’ isn’t defined for the class ‘GoRouteData’.

It looks like the builder is already generating mixins for methods that are only available in an unreleased version of go_router. Could we either:

1. Remove the @override annotations for methods not yet in GoRouteData, or
2. Guard generation so that only methods present in the published go_router API are included?

Happy to provide a minimal repro if it helps. Thanks for looking into this!