Add EventHook parameter to item use scripts

Items can be used on Pokemon outside of battle, and we want the user of the library to be able to check for what changed. This allows for example a heal event to be sent back to the user of the library after using an item.

PkmnLib.Dynamic/BattleFlow/TurnRunner.cs

@@ -174,6 +174,6 @@ public static class TurnRunner
             var side = battle.Sides[itemChoice.TargetSide.Value];
             target = side.Pokemon[itemChoice.TargetPosition.Value];
         }
-        itemChoice.Item.RunItemScript(battle.Library.ScriptResolver, target ?? user);
+        itemChoice.Item.RunItemScript(battle.Library.ScriptResolver, target ?? user, battle.EventHook);
     }
 }

PkmnLib.Dynamic/Models/Pokemon.cs

@@ -340,7 +340,8 @@ public interface IPokemon : IScriptSource, IDeepCloneable
     /// Heals the Pokemon by a specific amount. Unless allow_revive is set to true, this will not
     /// heal if the Pokemon has 0 health. If the amount healed is 0, this will return false.
     /// </summary>
-    bool Heal(uint heal, bool allowRevive = false, EventBatchId batchId = default, bool forceHeal = false);
+    bool Heal(uint heal, bool allowRevive = false, EventBatchId batchId = default, bool forceHeal = false,
+        EventHook? customEventHook = null);
 
     /// <summary>
     /// Restores all PP of the Pokemon.
@@ -1118,7 +1119,8 @@ public class PokemonImpl : ScriptSource, IPokemon
     }
 
     /// <inheritdoc />
-    public bool Heal(uint heal, bool allowRevive, EventBatchId batchId = default, bool forceHeal = false)
+    public bool Heal(uint heal, bool allowRevive, EventBatchId batchId = default, bool forceHeal = false,
+        EventHook? customEventHook = null)
     {
         if (IsFainted && !allowRevive)
             return false;
@@ -1137,7 +1139,8 @@ public class PokemonImpl : ScriptSource, IPokemon
         }
 
         var newHealth = CurrentHealth + heal;
-        BattleData?.Battle.EventHook.Invoke(new HealEvent(this, CurrentHealth, newHealth)
+        customEventHook ??= BattleData?.Battle.EventHook;
+        customEventHook?.Invoke(new HealEvent(this, CurrentHealth, newHealth)
         {
             BatchId = batchId,
         });

PkmnLib.Dynamic/ScriptHandling/ItemScript.cs

@@ -1,3 +1,4 @@
+using PkmnLib.Dynamic.Events;
 using PkmnLib.Dynamic.Models;
 using PkmnLib.Static;
 using PkmnLib.Static.Utils;
@@ -55,15 +56,14 @@ public abstract class ItemScript : IDeepCloneable
     /// <summary>
     /// Handles the use of the item.
     /// </summary>
-    public virtual void OnUse()
+    public virtual void OnUse(EventHook eventHook)
     {
     }
 
     /// <summary>
     /// Handles the use of the item on the given target.
     /// </summary>
-    /// <param name="target"></param>
-    public virtual void OnUseWithTarget(IPokemon target)
+    public virtual void OnUseWithTarget(IPokemon target, EventHook eventHook)
     {
     }
 }

PkmnLib.Dynamic/ScriptHandling/PokeballScript.cs

@@ -1,3 +1,4 @@
+using PkmnLib.Dynamic.Events;
 using PkmnLib.Dynamic.Models;
 using PkmnLib.Static;
 
@@ -19,12 +20,10 @@ public abstract class PokeballScript : ItemScript
     public abstract byte GetCatchRate(IPokemon target);
 
     /// <inheritdoc />
-    public override void OnUseWithTarget(IPokemon target)
+    public override void OnUseWithTarget(IPokemon target, EventHook eventHook)
     {
         var battleData = target.BattleData;
-        if (battleData == null)
-            return;
 
-        battleData.Battle.AttempCapture(battleData.SideIndex, battleData.Position, Item);
+        battleData?.Battle.AttempCapture(battleData.SideIndex, battleData.Position, Item);
     }
 }

PkmnLib.Dynamic/ScriptHandling/ScriptExecution.cs

@@ -1,4 +1,5 @@
 using System.Runtime.CompilerServices;
+using PkmnLib.Dynamic.Events;
 using PkmnLib.Dynamic.Models;
 using PkmnLib.Static;
 
@@ -95,7 +96,8 @@ public static class ScriptExecution
     /// <summary>
     /// Executes a script on an item.
     /// </summary>
-    public static void RunItemScript(this IItem item, ScriptResolver scriptResolver, IPokemon? target)
+    public static void RunItemScript(this IItem item, ScriptResolver scriptResolver, IPokemon? target,
+        EventHook eventHook)
     {
         if (!scriptResolver.TryResolveBattleItemScript(item, out var itemScript))
         {
@@ -110,11 +112,11 @@ public static class ScriptExecution
         {
             if (target == null)
                 throw new ArgumentNullException(nameof(target), "Item script requires a target.");
-            itemScript.OnUseWithTarget(target);
+            itemScript.OnUseWithTarget(target, eventHook);
         }
         else
         {
-            itemScript.OnUse();
+            itemScript.OnUse(eventHook);
         }
     }
 }