feat: Add lookAt method for PositionComponent

packages/flame/lib/src/collisions/hitboxes/composite_hitbox.dart

@@ -15,6 +15,7 @@ class CompositeHitbox extends PositionComponent
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     Iterable<ShapeHitbox>? super.children,
     super.priority,

packages/flame/lib/src/components/custom_painter_component.dart

@@ -20,6 +20,7 @@ class CustomPainterComponent extends PositionComponent {
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/input/button_component.dart

@@ -30,6 +30,7 @@ class ButtonComponent extends PositionComponent with Tappable {
     Vector2? size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/input/hud_margin_component.dart

@@ -28,6 +28,7 @@ class HudMarginComponent<T extends FlameGame> extends PositionComponent
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/isometric_tile_map_component.dart

@@ -60,6 +60,7 @@ class IsometricTileMapComponent extends PositionComponent {
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/nine_tile_box_component.dart

@@ -21,6 +21,7 @@ class NineTileBoxComponent extends PositionComponent implements SizeProvider {
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/parallax_component.dart

@@ -64,6 +64,7 @@ class ParallaxComponent<T extends FlameGame> extends PositionComponent
     Vector2? size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/particle_system_component.dart

@@ -18,6 +18,7 @@ class ParticleSystemComponent extends PositionComponent {
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.priority,
   });

packages/flame/lib/src/components/position_component.dart

@@ -74,6 +74,7 @@ class PositionComponent extends Component
     Vector2? size,
     Vector2? scale,
     double? angle,
+    this.nativeAngle = 0,
     Anchor? anchor,
     super.children,
     super.priority,
@@ -98,6 +99,10 @@ class PositionComponent extends Component
   final NotifyingVector2 _size;
   Anchor _anchor;
 
+  /// The angle where this component is looking at in its
+  /// default state, i.e. when [angle] is equal to zero.
+  double nativeAngle;
+
   /// The decorator is used to apply visual effects to a component.
   ///
   /// By default, the [PositionComponent] is equipped with a
@@ -332,6 +337,15 @@ class PositionComponent extends Component
   /// The absolute center of the component.
   Vector2 get absoluteCenter => absolutePositionOfAnchor(Anchor.center);
 
+  /// Rotates the component to look at given target.
+  void lookAt(Vector2 target) {
+    angle = math.atan2(
+          target.x - absolutePosition.x,
+          absolutePosition.y - target.y,
+        ) -
+        nativeAngle;
+  }
+
   //#endregion
 
   //#region Mutators

packages/flame/lib/src/components/sprite_animation_component.dart

@@ -30,6 +30,7 @@ class SpriteAnimationComponent extends PositionComponent
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/sprite_animation_group_component.dart

@@ -28,6 +28,7 @@ class SpriteAnimationGroupComponent<T> extends PositionComponent
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/sprite_component.dart

@@ -26,6 +26,7 @@ class SpriteComponent extends PositionComponent
     Vector2? size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/sprite_group_component.dart

@@ -26,6 +26,7 @@ class SpriteGroupComponent<T> extends PositionComponent
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/components/text_component.dart

@@ -15,6 +15,7 @@ class TextComponent<T extends TextRenderer> extends PositionComponent {
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/lib/src/geometry/shape_component.dart

@@ -14,6 +14,7 @@ abstract class ShapeComponent extends PositionComponent with HasPaint {
     super.size,
     super.scale,
     super.angle,
+    super.nativeAngle,
     super.anchor,
     super.children,
     super.priority,

packages/flame/test/components/position_component_test.dart

@@ -717,6 +717,40 @@ void main() {
         expect(child.position, Vector2(3, 2));
         expect(child.absolutePosition, Vector2(15, 21));
       });
+
+      test('lookAt', () {
+        final comp = PositionComponent();
+
+        final targets = [
+          Vector2(0, 1),
+          Vector2.all(2),
+          Vector2(-1, 0),
+          Vector2.all(-50)
+        ];
+        final expectedAngles = [pi, (3 * pi / 4), (-pi / 2), (-pi / 4)];
+
+        for (var i = 0; i < 4; ++i) {
+          comp.lookAt(targets.elementAt(i));
+          expectDouble(comp.angle, expectedAngles.elementAt(i), epsilon: 1e-10);
+        }
+      });
+
+      test('lookAt with native angle', () {
+        final comp = PositionComponent(nativeAngle: pi / 2);
+
+        final targets = [
+          Vector2(0, 1),
+          Vector2.all(2),
+          Vector2(-1, 0),
+          Vector2.all(-50)
+        ];
+        final expectedAngles = [pi / 2, (pi / 4), -pi, (-3 * pi / 4)];
+
+        for (var i = 0; i < 4; ++i) {
+          comp.lookAt(targets.elementAt(i));
+          expectDouble(comp.angle, expectedAngles.elementAt(i), epsilon: 1e-10);
+        }
+      });
     });
 
     group('Rendering', () {