Assert in debug mode when large content viewer is not placed inside an interaction container (#585)

Follow-up to
[this](#583 (comment))
PR feedback.

Author: meherkasam-square

BlueprintUICommonControls/Sources/AccessibilityLargeContentViewer.swift

@@ -22,15 +22,21 @@ extension Element {
         largeContentImageInsets: UIEdgeInsets = .zero,
         interactionEndedCallback: ((CGPoint) -> Void)? = nil
     ) -> Element {
-        Accessibility.LargeContentViewer(
-            wrapping: self,
-            configuration: .init(
-                display: display,
-                scalesLargeContentImage: scalesLargeContentImage,
-                largeContentImageInsets: largeContentImageInsets,
-                interactionEndedCallback: interactionEndedCallback
+        EnvironmentReader { env in
+            assert(
+                env.isWrappedInLargeContentViewerContainer,
+                "accessibilityShowsLargeContentViewer() must be used in conjunction with accessibilityLargeContentViewerInteractionContainer()."
             )
-        )
+            return Accessibility.LargeContentViewer(
+                wrapping: self,
+                configuration: .init(
+                    display: display,
+                    scalesLargeContentImage: scalesLargeContentImage,
+                    largeContentImageInsets: largeContentImageInsets,
+                    interactionEndedCallback: interactionEndedCallback
+                )
+            )
+        }
     }
 }
 
@@ -191,7 +197,10 @@ extension Element {
     /// Elements that are wrapped in this container will be able to show a large content viewer and allow a user to swipe through them with one finger
     /// and have the HUD update in real time.
     public func accessibilityLargeContentViewerInteractionContainer() -> Element {
-        Accessibility.LargeContentViewerInteractionContainer(wrapping: self)
+        Accessibility.LargeContentViewerInteractionContainer(wrapping: self).adaptedEnvironment(
+            keyPath: \.isWrappedInLargeContentViewerContainer,
+            value: true
+        )
     }
 }
 
@@ -243,3 +252,13 @@ extension Accessibility {
     }
 }
 
+extension Environment {
+    private enum LargeContentViewerContainerKey: EnvironmentKey {
+        static let defaultValue = false
+    }
+
+    var isWrappedInLargeContentViewerContainer: Bool {
+        get { self[LargeContentViewerContainerKey.self] }
+        set { self[LargeContentViewerContainerKey.self] = newValue }
+    }
+}

CHANGELOG.md

@@ -15,6 +15,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- Exposed largeContentViewerInteraction on LargeContentViewer backing view via protocol.
+- Asserted (in debug mode) when large content viewer is not placed inside an interaction container.
+
 ### Deprecated
 
 ### Security