Support Safari re-entry for FR/LG

[ThibaultLassiaz]

We recently introduced a Safari Zone auto-catching strategy for FireRed/LeafGreen, which optimizes catching Pokémon based on the remaining Safari Ball count.

Currently, to avoid missing rare finds, like the shiny Chansey you've been hunting for months, the bot automatically stops when the Safari Ball count drops below a hardcoded threshold of 15.

With recent improvements to path calculation, such as supporting surfable areas, it should now be more feasible to implement re-entry logic.

Goal

The goal of this issue is to enhance the Safari auto-catching system by adding an automatic re-entry into the Safari Zone when the ball count falls below the threshold, instead of stopping the bot.

This improvement will enable continuous shiny hunting in the Safari Zone, as long as sufficient funds are available for re-entry.

---

Implementation Plan

1. Detect Low Ball Count:

   • After ending a Safari battle, check if the ball count is equal to or below the threshold.
   • If true, open the menu and exit the Safari Zone.

2. Re-Entry Logic:

   • If the player has enough Pokédollars, re-enter the Safari Zone.
   • If funds are insufficient, stop the bot.

3. Path Calculation:

   • Use the path calculation function (e.g., examples from the level grind mode) to navigate back to the location where the bot was hunting.
   • If path calculation fails or the original location is unreachable, raise an error.

4. Resume Hunting:

   • If the bot was fishing, restart fishing.
   • Otherwise, resume spinning.

---

Optional Feature: Repel Trick

For specific Safari hunts that require the Repel Trick, apply a Repel if it is not already active before resuming hunting mode.

[ThibaultLassiaz]

Done in #593