feat: Make Component.key public (#2988)

Since the user might want to use the `ComponentKey` after it has been
assigned it should be made public.

It also updates `Consumer.key` to `Consumer.widgetKey` in flame_riverpod
to avoid a name clash. (Slightly breaking)


### Migration instructions

If you are using `consumer.key` from flame_riverpod you have to now use
`consumer.widgetKey` instead.

## Related Issues

Closes #2985

packages/flame/lib/src/components/core/component.dart

@@ -69,9 +69,8 @@ class Component {
   Component({
     Iterable<Component>? children,
     int? priority,
-    ComponentKey? key,
-  })  : _priority = priority ?? 0,
-        _key = key {
+    this.key,
+  }) : _priority = priority ?? 0 {
     if (children != null) {
       addAll(children);
     }
@@ -897,10 +896,10 @@ class Component {
     _parent!.onChildrenChanged(this, ChildrenChangeType.added);
     _clearMountingBit();
 
-    if (_key != null) {
+    if (key != null) {
       final currentGame = findGame();
       if (currentGame is FlameGame) {
-        currentGame.registerKey(_key!, this);
+        currentGame.registerKey(key!, this);
       }
     }
   }
@@ -958,10 +957,10 @@ class Component {
   }
 
   void _unregisterKey() {
-    if (_key != null) {
+    if (key != null) {
       final game = findGame();
       if (game is FlameGame) {
-        game.unregisterKey(_key!);
+        game.unregisterKey(key!);
       }
     }
   }
@@ -989,7 +988,7 @@ class Component {
   /// A key that can be used to identify this component in the tree.
   ///
   /// It can be used to retrieve this component from anywhere in the tree.
-  final ComponentKey? _key;
+  final ComponentKey? key;
 
   /// The color that the debug output should be rendered with.
   Color debugColor = const Color(0xFFFF00FF);

packages/flame_riverpod/lib/src/consumer.dart

@@ -14,7 +14,7 @@ class ComponentRef implements WidgetRef {
   BuildContext get context => game!.buildContext!;
 
   RiverpodAwareGameWidgetState? get _container {
-    return game?.key?.currentState;
+    return game?.widgetKey?.currentState;
   }
 
   @override
@@ -127,7 +127,7 @@ mixin RiverpodComponentMixin on Component {
   void rebuildGameWidget() {
     assert(ref.game!.isMounted == true);
     if (ref.game!.isMounted) {
-      ref.game!.key!.currentState!.forceBuild();
+      ref.game!.widgetKey!.currentState!.forceBuild();
     }
   }
 }
@@ -137,7 +137,7 @@ mixin RiverpodGameMixin<W extends World> on FlameGame<W> {
   /// was provided to.
   ///
   /// Used to facilitate [Component] access to the [ProviderContainer].
-  GlobalKey<RiverpodAwareGameWidgetState>? key;
+  GlobalKey<RiverpodAwareGameWidgetState>? widgetKey;
 
   final List<void Function()> _onBuildCallbacks = [];
 

packages/flame_riverpod/lib/src/widget.dart

@@ -65,7 +65,7 @@ class RiverpodAwareGameWidgetState<T extends Game> extends GameWidgetState<T>
   @override
   void initState() {
     super.initState();
-    game.key = (widget as RiverpodAwareGameWidget<T>).key;
+    game.widgetKey = (widget as RiverpodAwareGameWidget<T>).key;
 
     WidgetsBinding.instance.addPersistentFrameCallback((_) {
       _isForceBuilding = false;
@@ -80,7 +80,7 @@ class RiverpodAwareGameWidgetState<T extends Game> extends GameWidgetState<T>
   @override
   void didUpdateWidget(covariant GameWidget<T> oldWidget) {
     super.didUpdateWidget(oldWidget);
-    game.key = (widget as RiverpodAwareGameWidget<T>).key;
+    game.widgetKey = (widget as RiverpodAwareGameWidget<T>).key;
   }
 
   @override