feat: Add onDispose to game.dart called from game_widget.dart

packages/flame/lib/src/game/game.dart

@@ -213,6 +213,10 @@ abstract mixin class Game {
   /// do cleanups to avoid memory leaks.
   void onRemove() {}
 
+  /// Called when the game has been removed from the Flutter widget tree when
+  /// it was disposed by Flutter.
+  void onDispose() {}
+
   /// Called after the game has left the widget tree.
   /// This can be overridden to add logic that requires the game
   /// not be on the flutter widget tree anymore.

packages/flame/lib/src/game/game_widget/game_widget.dart

@@ -254,8 +254,11 @@ class GameWidgetState<T extends Game> extends State<GameWidget<T>> {
     _loaderFuture = null;
   }
 
-  void disposeCurrentGame() {
+  void disposeCurrentGame({bool isDispose = false}) {
     currentGame.removeGameStateListener(_onGameStateChange);
+    if (isDispose) {
+      currentGame.onDispose();
+    }
   }
 
   @override
@@ -281,7 +284,7 @@ class GameWidgetState<T extends Game> extends State<GameWidget<T>> {
   @override
   void dispose() {
     super.dispose();
-    disposeCurrentGame();
+    disposeCurrentGame(isDispose: true);
     // If we received a focus node from the user, they are responsible
     // for disposing it
     if (widget.focusNode == null) {

packages/flame/test/game/game_widget/game_widget_lifecycle_test.dart

@@ -30,6 +30,12 @@ class _MyGame extends FlameGame {
     super.onRemove();
     events.add('onRemove');
   }
+
+  @override
+  void onDispose() {
+    super.onDispose();
+    events.add('onDispose');
+  }
 }
 
 class _TitlePage extends StatelessWidget {
@@ -185,6 +191,11 @@ void main() {
         true,
         reason: 'onRemove was not called',
       );
+      expect(
+        events.contains('onDispose'),
+        true,
+        reason: 'onDispose was not called',
+      );
     });
 
     testWidgets('on resize, parents are kept', (tester) async {
@@ -229,6 +240,7 @@ void main() {
           'onLoad',
           'onMount',
           'onRemove',
+          'onDispose',
           'onGameResize',
           'onMount',
         ],