Set max target limit to 50 (#2320)

## Description

<!-- What changed? Why? (the code + comments should speak for itself on
the "how") -->

<!-- Fun screenshots or a cool video or something are super helpful as
well. If this touches platform-specific behavior, this is where test
evidence should be collected. -->

<!-- Any issues this pull request closes or pull requests this
supersedes should be linked with `Closes #issuenumber`. -->

closes #2318
closes #2319 

For the 2027 game, teams might want to detect more than 10 results.
Therefore, we're increasing the limit.

We also ran into an issue with our sim, where a user can create too many
objects and cause an overflow. We implement that same limit of 50
targets here.

## Meta

Merge checklist:
- [x] Pull Request title is [short, imperative
summary](https://cbea.ms/git-commit/) of proposed changes
- [x] The description documents the _what_ and _why_
- [ ] If this PR changes behavior or adds a feature, user documentation
is updated
- [ ] If this PR touches photon-serde, all messages have been
regenerated and hashes have not changed unexpectedly
- [ ] If this PR touches configuration, this is backwards compatible
with settings back to v2025.3.2
- [ ] If this PR touches pipeline settings or anything related to data
exchange, the frontend typing is updated
- [ ] If this PR addresses a bug, a regression test for it is added

photon-lib/src/test/native/cpp/VisionSystemSimTest.cpp

@@ -117,6 +117,29 @@ TEST_F(VisionSystemSimTest, TestVisibilityCupidShuffle) {
   ASSERT_TRUE(camera.GetLatestResult().HasTargets());
 }
 
+TEST_F(VisionSystemSimTest, TestBunchaTargets) {
+  photon::VisionSystemSim visionSysSim{"Test"};
+  photon::PhotonCamera camera{"camera"};
+  photon::PhotonCameraSim cameraSim{&camera};
+  visionSysSim.AddCamera(&cameraSim, frc::Transform3d{});
+  cameraSim.prop.SetCalibration(640, 480, frc::Rotation2d{80_deg});
+
+  std::vector<photon::VisionTargetSim> targets;
+  for (int i = 0; i < 100; i++) {
+    targets.emplace_back(
+        frc::Pose3d{
+            frc::Translation3d{15.98_m + i * 0.1_m, 0_m, 1_m},
+            frc::Rotation3d{0_rad, 0_rad, units::radian_t{std::numbers::pi}}},
+        photon::TargetModel{0.5_m, 0.5_m}, i);
+  }
+  visionSysSim.AddVisionTargets(targets);
+
+  frc::Pose2d robotPose{frc::Translation2d{5_m, 0_m}, frc::Rotation2d{5_deg}};
+  visionSysSim.Update(robotPose);
+
+  ASSERT_EQ(camera.GetLatestResult().targets.size(), 50u);
+}
+
 TEST_F(VisionSystemSimTest, TestNotVisibleVert1) {
   frc::Pose3d targetPose{
       frc::Translation3d{15.98_m, 0_m, 1_m},