feat: more plugin work and intra-scope communication

addons/GodotDI/ISceneInstantiator.cs

@@ -1,3 +1,4 @@
+using System;
 using Godot;
 
 namespace GodotHostTest.GodotDI;
@@ -5,16 +6,18 @@ namespace GodotHostTest.GodotDI;
 public interface ISceneInstantiator
 {
     /// <summary>
-    /// Instantiate a packed scene, just like <see cref="PackedScene.Instantiate"/>, but also looks for a scope between the top level children and triggers the dependency injection mechanism when found.
+    /// Instantiate a packed scene, just like <see cref="PackedScene.Instantiate"/>, but also looks for a scope between the top level children of the instantiated scene and triggers the dependency injection mechanism when found.
     /// </summary>
     /// <param name="packedScene">The packed scene to instantiate.</param>
+    /// <param name="onScopeCreated">An optional callback invoked once the scope has been created, but before instantiating the scene.</param>
     /// <returns>The created node, with its dependencies satisfied.</returns>
-    Node Instantiate(PackedScene packedScene);
+    Node Instantiate(PackedScene packedScene, Delegate? onScopeCreated = null);
 
     /// <summary>
     /// Instantiate a packed scene, just like <see cref="PackedScene.Instantiate{T}"/>, but also looks for a scope between the top level children and triggers the dependency injection mechanism when found.
     /// </summary>
     /// <param name="packedScene">The packed scene to instantiate.</param>
+    /// <param name="onScopeCreated">An optional callback invoked once the scope has been created, but before instantiating the scene.</param>
     /// <returns>The created node, with its dependencies satisfied.</returns>
-    T Instantiate<T>(PackedScene packedScene) where T : Node;
+    T Instantiate<T>(PackedScene packedScene, Delegate? onScopeCreated = null) where T : Node;
 }