♻️ Reset AppcuesFrameView on overridden render context

Sources/AppcuesKit/Presentation/ExperienceRendering/ExperienceRenderer.swift

@@ -57,6 +57,11 @@ internal class ExperienceRenderer: ExperienceRendering, StateMachineOwning {
     func start(owner: StateMachineOwning, forContext context: RenderContext) {
         guard let container = appcues?.container else { return }
 
+        // If there's already a frame for the context, reset it back to its unregistered state.
+        if let existingFrameView = stateMachines[ownerFor: context] as? AppcuesFrameView {
+            existingFrameView.reset()
+        }
+
         owner.stateMachine = ExperienceStateMachine(container: container)
         stateMachines[ownerFor: context] = owner
         if let pendingExperiences = potentiallyRenderableExperiences[context] {

Sources/AppcuesKit/Presentation/UI/AppcuesFrameView.swift

@@ -24,6 +24,7 @@ public class AppcuesFrameView: UIView, StateMachineOwning {
     }
 
     private weak var parentViewController: UIViewController?
+    private weak var experienceViewController: UIViewController?
 
     // when the view content is empty, we use this zero height constraint
     private lazy var emptyHeightConstraint: NSLayoutConstraint = {
@@ -94,6 +95,7 @@ public class AppcuesFrameView: UIView, StateMachineOwning {
         configureConstraints(isEmpty: false)
 
         viewController.embedChildViewController(experienceController, inSuperview: self, margins: margins)
+        experienceViewController = experienceController
 
         switch transition {
         case .none:
@@ -134,4 +136,12 @@ public class AppcuesFrameView: UIView, StateMachineOwning {
             )
         }
     }
+
+    /// Set the Frame back to an unregistered state.
+    internal func reset() {
+        if let experienceViewController = experienceViewController {
+            unembed(experienceViewController, transition: .none, completion: nil)
+        }
+        _stateMachine = nil
+    }
 }