@digia-engage/core 1.0.0-beta.4 → 1.0.0-beta.6

package/DigiaEngageReactNative.podspec

@@ -1,21 +1,37 @@
 Pod::Spec.new do |s|
   s.name             = 'DigiaEngageReactNative'
   s.version          = '0.1.0'
-  s.summary          = 'React Native bridge for the Digia Engage SDK (Android Compose UI).'
+  s.summary          = 'React Native bridge for the Digia Engage SDK (iOS & Android).'
   s.description      = <<-DESC
-    Provides a React Native bridge that surfaces the Digia Engage Android
-    Compose UI SDK inside React Native applications.  iOS support is stubbed
-    and will be added in a future release.
+    Provides a React Native bridge that surfaces the Digia Engage SDK inside
+    React Native applications.  Supports both iOS (SwiftUI) and Android
+    (Jetpack Compose) using the New Architecture (TurboModules / Fabric).
   DESC
 
-  s.homepage         = 'https://github.com/Digia-Technology-Private-Limited/digia_engage'
   s.license          = { :type => 'MIT', :file => '../LICENSE' }
-  s.author           = { 'Digia Technology Private Limited' => '' }
-  s.source           = { :git => 'https://github.com/Digia-Technology-Private-Limited/digia_engage.git', :tag => s.version.to_s }
 
-  s.ios.deployment_target = '13.0'
+  s.authors          = { 'Digia Technology Private Limited' => 'https://digia.tech' }
+  s.homepage         = 'https://github.com/Digia-Technology-Private-Limited/digia_engage'
+  s.source           = {
+    :git => 'https://github.com/Digia-Technology-Private-Limited/digia_engage.git',
+    :tag => "react-native-v#{s.version}"
+  }
+  
+  # DigiaEngage iOS SDK requires iOS 17+ (SwiftUI features used internally).
+  s.ios.deployment_target = '17.0'
 
   s.source_files = 'ios/**/*.{h,m,mm,swift}'
 
+  # Swift version must match the Digia iOS SDK.
+  s.swift_version = '5.9'
+
   s.dependency 'React-Core'
+
+  # ── Digia Engage iOS SDK ──────────────────────────────────────────────────
+  # Available on SPM: https://swiftpackageindex.com/Digia-Technology-Private-Limited/digia_engage_iOS
+  # CocoaPods: host app Podfile must declare the git source (see README).
+  s.dependency 'DigiaEngage'  
+
+  # ── New Architecture (Fabric / TurboModules) support ─────────────────────
+  install_modules_dependencies(s)
 end

package/README.md

@@ -158,10 +158,9 @@ const navRef = useNavigationContainerRef();
 >
 ```
 
-### 3 – Open the Digia UI navigation flow (Android)
+### 3 – Open the Digia UI navigation flow
 
-Launch the full-screen Compose navigation activity managed by the Digia DSL
-configuration:
+Launch the full-screen native SDUI stack:
 
 ```tsx
 import { Digia } from '@digia/engage-react-native';
@@ -170,12 +169,7 @@ function MyScreen() {
   return (
     <Button
       title="Open Digia Experience"
-      onPress={() =>
-        Digia.openNavigation({
-          startPageId: 'onboarding',
-          pageArgs: { userId: '123' },
-        })
-      }
+      onPress={() => Digia.createInitialPage()}
     />
   );
 }
@@ -216,7 +210,7 @@ const styles = StyleSheet.create({ root: { flex: 1 } });
 |---|---|---|
 | `initialize` | `(config: DigiaConfig) => Promise<void>` | Initialise the SDK and mount the Compose overlay host. |
 | `setCurrentScreen` | `(name: string) => void` | Notify the SDK of the current screen. |
-| `openNavigation` | `(options?: DigiaNavigationOptions) => void` | Launch the full-screen Digia UI navigation activity. |
+| `createInitialPage` | `() => void` | Full-screen Digia SDUI (Android: `DigiaUINavigationActivity`; iOS: modal `DigiaNavigationView`). |
 
 ### `DigiaConfig`
 
@@ -226,12 +220,9 @@ const styles = StyleSheet.create({ root: { flex: 1 } });
 | `environment` | `'production' \| 'sandbox'` | `'production'` | Target environment. |
 | `logLevel` | `'none' \| 'error' \| 'verbose'` | `'error'` | Log verbosity. |
 
-### `DigiaNavigationOptions`
+### `CreateInitialPageOptions`
 
-| Prop | Type | Description |
-|---|---|---|
-| `startPageId` | `string?` | DSL page ID to start from. |
-| `pageArgs` | `Record<string, string>?` | Key/value args forwarded to the start page. |
+Empty interface — reserved for future optional arguments.
 
 ### `<DigiaHostView>`
 
@@ -251,14 +242,14 @@ react-native/
 │   ├── index.ts                  ← Public API exports
 │   ├── types.ts                  ← TypeScript interfaces
 │   ├── Digia.ts                  ← High-level JS SDK wrapper
-│   ├── NativeDigiaModule.ts      ← Low-level native module binding
+│   ├── NativeDigiaEngage.ts      ← Low-level native module binding
 │   └── DigiaHostView.tsx         ← <DigiaHostView> React component
 │
 ├── android/
 │   ├── build.gradle              ← Android library build config
 │   └── src/main/java/com/digia/engage/rn/
 │       ├── DigiaPackage.kt       ← ReactPackage (registers module + view)
-│       ├── DigiaModule.kt        ← NativeModule (initialize, setCurrentScreen, openNavigation)
+│       ├── DigiaModule.kt        ← NativeModule (initialize, setCurrentScreen, createInitialPage)
 │       ├── DigiaViewManager.kt   ← ViewManager for <DigiaHostView>
 │       └── DigiaHostComposeView.kt ← AbstractComposeView hosting DigiaHost { }
 │

package/android/.project

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<projectDescription>
+	<name>digia-engage_core</name>
+	<comment>Project digia-engage_core created by Buildship.</comment>
+	<projects>
+	</projects>
+	<buildSpec>
+		<buildCommand>
+			<name>org.eclipse.buildship.core.gradleprojectbuilder</name>
+			<arguments>
+			</arguments>
+		</buildCommand>
+	</buildSpec>
+	<natures>
+		<nature>org.eclipse.buildship.core.gradleprojectnature</nature>
+	</natures>
+	<filteredResources>
+		<filter>
+			<id>1775559486270</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
+</projectDescription>

package/android/build.gradle

@@ -71,7 +71,7 @@ android {
 
 dependencies {
     // Digia Engage Android library 
-    implementation 'tech.digia:engage:1.0.0-beta.03'
+    implementation 'tech.digia:engage:1.0.0-beta.04'
 
     // ── React Native ─────────────────────────────────────────────────────────
     // React Native is provided by the host app; mark as compileOnly so it is

package/android/settings.gradle

@@ -17,9 +17,7 @@ dependencyResolutionManagement {
     repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
     repositories {
         google()
-        mavenCentral()
-        mavenLocal()
-        maven { url 'https://jitpack.io' }
+        mavenCentral()  
     }
 }
 

package/android/src/main/java/com/digia/engage/rn/DigiaModule.kt

@@ -222,7 +222,7 @@ internal class RNEventBridgePlugin(
                         is DigiaExperienceEvent.Dismissed -> putString("type", "dismissed")
                     }
                 }
-        emit("digiaOverlayEvent", params)
+        emit("digiaEngageEvent", params)
     }
 
     override fun teardown() {

package/android/src/main/java/com/digia/engage/rn/DigiaSlotViewManager.kt

@@ -1,15 +1,8 @@
-/**
- * DigiaSlotViewManager
- *
- * React Native ViewManager that exposes [DigiaSlotView] (from the Digia Android SDK) as the native
- * view behind the JS `<DigiaSlotView>` component.
- *
- * Supported JS props:
- * - `placementKey` (String) — matches the placement key set in the Digia dashboard.
- */
 package com.digia.engage.rn
 
 import android.content.Context
+import android.view.View
+import android.view.ViewTreeObserver
 import android.widget.FrameLayout
 import androidx.lifecycle.LifecycleOwner
 import androidx.lifecycle.ViewModelStoreOwner
@@ -18,43 +11,165 @@ import androidx.lifecycle.setViewTreeViewModelStoreOwner
 import androidx.savedstate.SavedStateRegistryOwner
 import androidx.savedstate.setViewTreeSavedStateRegistryOwner
 import com.digia.engage.DigiaSlotView
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.WritableMap
 import com.facebook.react.uimanager.SimpleViewManager
 import com.facebook.react.uimanager.ThemedReactContext
+import com.facebook.react.uimanager.UIManagerHelper
 import com.facebook.react.uimanager.annotations.ReactProp
+import com.facebook.react.uimanager.events.Event
+import java.util.concurrent.atomic.AtomicInteger
 
-internal class DigiaSlotViewManager : SimpleViewManager<DigiaSlotView>() {
+// ── ContentSizeChangeEvent ────────────────────────────────────────────────────
 
-    override fun getName(): String = VIEW_NAME
+private class ContentSizeChangeEvent(
+    surfaceId: Int,
+    viewTag: Int,
+    private val heightDp: Double,
+) : Event<ContentSizeChangeEvent>(surfaceId, viewTag) {
+    override fun getEventName(): String = "onContentSizeChange"
+    override fun getEventData(): WritableMap =
+        Arguments.createMap().apply { putDouble("height", heightDp) }
+}
 
-    override fun createViewInstance(context: ThemedReactContext): DigiaSlotView {
-        val activityContext: Context = context.currentActivity ?: context
+// ── DigiaSlotContainerView ────────────────────────────────────────────────────
 
-        val view = DigiaSlotView(activityContext)
+// Plain FrameLayout wrapper: Fabric can measure it before window attachment.
+// The inner DigiaSlotView (ComposeView) is created lazily in onAttachedToWindow.
+internal class DigiaSlotContainerView(context: Context) : FrameLayout(context) {
 
-        // Wire Architecture Component owners so the Compose runtime works correctly.
-        val activity = context.currentActivity
-        if (activity is LifecycleOwner) {
-            view.setViewTreeLifecycleOwner(activity)
-        }
-        if (activity is ViewModelStoreOwner) {
-            view.setViewTreeViewModelStoreOwner(activity)
+    var rnContext: ThemedReactContext? = null
+
+    private var _slotView: DigiaSlotView? = null
+    private val lastReportedHeightPx = AtomicInteger(-1)
+
+    var placementKey: String = ""
+        set(value) {
+            field = value
+            val slot = _slotView ?: return
+            slot.placementKey = value
+            lastReportedHeightPx.set(-1)
+            // Defer measure so the slot has a non-zero width. Do NOT call requestLayout() here —
+            // it sets PFLAG_FORCE_LAYOUT on the container and RN bypasses a full traversal,
+            // causing subsequent Compose requestLayout() calls to be swallowed.
+            post { measureAndDispatch() }
+            postDelayed({
+                lastReportedHeightPx.set(-1)
+                measureAndDispatch()
+            }, DELAYED_MEASURE_MS)
         }
-        if (activity is SavedStateRegistryOwner) {
-            view.setViewTreeSavedStateRegistryOwner(activity)
+
+    private val globalLayoutListener = ViewTreeObserver.OnGlobalLayoutListener {
+        measureAndDispatch()
+    }
+
+    // preDrawListener catches Compose content changes that globalLayoutListener misses in RN's
+    // layout model: Compose's invalidate() propagates to ViewRootImpl even when requestLayout()
+    // is blocked by PFLAG_FORCE_LAYOUT.
+    private val preDrawListener = ViewTreeObserver.OnPreDrawListener {
+        measureAndDispatch()
+        true
+    }
+
+    override fun onAttachedToWindow() {
+        super.onAttachedToWindow()
+        if (_slotView == null) createSlotView()
+        viewTreeObserver.addOnGlobalLayoutListener(globalLayoutListener)
+        viewTreeObserver.addOnPreDrawListener(preDrawListener)
+        post { measureAndDispatch() }
+        // Retry: catches campaigns that arrive slightly after mount.
+        postDelayed({
+            if (lastReportedHeightPx.get() <= 0) {
+                lastReportedHeightPx.set(-1)
+                measureAndDispatch()
+            }
+        }, DELAYED_MEASURE_MS)
+    }
+
+    override fun onDetachedFromWindow() {
+        viewTreeObserver.removeOnGlobalLayoutListener(globalLayoutListener)
+        viewTreeObserver.removeOnPreDrawListener(preDrawListener)
+        super.onDetachedFromWindow()
+        lastReportedHeightPx.set(-1)
+    }
+
+    // Defer measureAndDispatch to avoid re-measuring during Compose's composition phase,
+    // which crashes with "pending composition has not been applied".
+    override fun requestLayout() {
+        super.requestLayout()
+        post { measureAndDispatch() }
+    }
+
+    private fun createSlotView() {
+        val themedCtx = context as? ThemedReactContext
+        val activityCtx: Context = themedCtx?.currentActivity ?: context
+
+        val slot = DigiaSlotView(activityCtx)
+
+        val activity = themedCtx?.currentActivity
+        if (activity is LifecycleOwner) slot.setViewTreeLifecycleOwner(activity)
+        if (activity is ViewModelStoreOwner) slot.setViewTreeViewModelStoreOwner(activity)
+        if (activity is SavedStateRegistryOwner) slot.setViewTreeSavedStateRegistryOwner(activity)
+
+        slot.placementKey = placementKey
+        slot.layoutParams = LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT)
+        slot.addOnLayoutChangeListener { _: View, l: Int, _: Int, r: Int, _: Int,
+                                         _: Int, _: Int, _: Int, _: Int ->
+            if (r - l > 0) measureAndDispatch()
         }
 
-        // React Native controls sizing; fill whatever space the JS stylesheet allocates.
-        view.layoutParams =
-                FrameLayout.LayoutParams(
-                        FrameLayout.LayoutParams.MATCH_PARENT,
-                        FrameLayout.LayoutParams.MATCH_PARENT,
-                )
+        addView(slot)
+        _slotView = slot
+    }
+
+    fun measureAndDispatch() {
+        val slot = _slotView ?: return
+        val ctx = rnContext ?: return
+        val viewWidth = width
+        if (viewWidth <= 0) return
+
+        val widthSpec = MeasureSpec.makeMeasureSpec(viewWidth, MeasureSpec.EXACTLY)
+        val heightSpec = MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED)
+        slot.measure(widthSpec, heightSpec)
+        val intrinsicHeightPx = slot.measuredHeight
+
+        if (intrinsicHeightPx == lastReportedHeightPx.get()) return
+        lastReportedHeightPx.set(intrinsicHeightPx)
+
+        val density = resources.displayMetrics.density
+        val heightDp = intrinsicHeightPx / density
+
+        val dispatcher = UIManagerHelper.getEventDispatcherForReactTag(ctx, id) ?: return
+        val surfaceId = UIManagerHelper.getSurfaceId(this)
+        dispatcher.dispatchEvent(ContentSizeChangeEvent(surfaceId, id, heightDp.toDouble()))
+    }
+
+    companion object {
+        private const val DELAYED_MEASURE_MS = 300L
+    }
+}
+
+// ── DigiaSlotViewManager ──────────────────────────────────────────────────────
+
+internal class DigiaSlotViewManager : SimpleViewManager<DigiaSlotContainerView>() {
+
+    override fun getName(): String = VIEW_NAME
+
+    override fun getExportedCustomDirectEventTypeConstants(): Map<String, Any> =
+        mapOf("onContentSizeChange" to mapOf("registrationName" to "onContentSizeChange"))
 
-        return view
+    override fun createViewInstance(context: ThemedReactContext): DigiaSlotContainerView {
+        val container = DigiaSlotContainerView(context)
+        container.rnContext = context
+        container.layoutParams = FrameLayout.LayoutParams(
+            FrameLayout.LayoutParams.MATCH_PARENT,
+            FrameLayout.LayoutParams.MATCH_PARENT,
+        )
+        return container
     }
 
     @ReactProp(name = "placementKey")
-    fun setPlacementKey(view: DigiaSlotView, placementKey: String?) {
+    fun setPlacementKey(view: DigiaSlotContainerView, placementKey: String?) {
         view.placementKey = placementKey.orEmpty()
     }
 

package/ios/DigiaEngageModule.m

@@ -1,71 +1,52 @@
 /**
- * DigiaEngageModule (iOS stub)
+ * DigiaEngageModule.m
  *
- * iOS support is not yet implemented.  This stub registers the module so that
- * the JS layer does not crash when imported on iOS.  All methods are no-ops.
+ * ObjC bridge file that exports Swift implementations to the React Native
+ * runtime (both Old Architecture bridge and New Architecture TurboModules).
+ *
+ * All real logic lives in the Swift files alongside this one:
+ *   DigiaModule.swift           — NativeModule (RCTEventEmitter subclass)
+ *   RNEventBridgePlugin.swift   — DigiaCEPPlugin bridge
+ *   DigiaHostViewManager.swift  — ViewManager for <DigiaHostView>
+ *   DigiaSlotViewManager.swift  — ViewManager for <DigiaSlotView>
  */
+
 #import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
 #import <React/RCTViewManager.h>
 
-// ── NativeModule stub ─────────────────────────────────────────────────────────
-
-@interface DigiaEngageModule : NSObject <RCTBridgeModule>
-@end
+// ── NativeModule ──────────────────────────────────────────────────────────────
 
-@implementation DigiaEngageModule
+// RCT_EXTERN_MODULE wires the Swift class DigiaModule (which inherits
+// RCTEventEmitter) to the React Native bridge under the name "DigiaEngageModule".
 
-RCT_EXPORT_MODULE(DigiaEngageModule)
+@interface RCT_EXTERN_MODULE(DigiaEngageModule, RCTEventEmitter)
 
-RCT_EXPORT_METHOD(initialize:(NSString *)apiKey
+RCT_EXTERN_METHOD(initialize:(NSString *)apiKey
                   environment:(NSString *)environment
                   logLevel:(NSString *)logLevel
                   resolve:(RCTPromiseResolveBlock)resolve
                   reject:(RCTPromiseRejectBlock)reject)
-{
-    // iOS not yet implemented – resolve immediately so JS doesn't hang.
-    resolve(nil);
-}
 
-RCT_EXPORT_METHOD(setCurrentScreen:(NSString *)name)
-{
-    // no-op
-}
+RCT_EXTERN_METHOD(registerBridge)
 
-RCT_EXPORT_METHOD(openNavigation:(nullable NSString *)startPageId
-                  pageArgs:(NSDictionary *)pageArgs)
-{
-    // no-op
-}
+RCT_EXTERN_METHOD(setCurrentScreen:(NSString *)name)
 
-RCT_EXPORT_METHOD(triggerCampaign:(NSString *)campaignId
+RCT_EXTERN_METHOD(triggerCampaign:(NSString *)id
                   content:(NSDictionary *)content
                   cepContext:(NSDictionary *)cepContext)
-{
-    // no-op — iOS Digia SDK not yet available
-}
 
-RCT_EXPORT_METHOD(invalidateCampaign:(NSString *)campaignId)
-{
-    // no-op
-}
+RCT_EXTERN_METHOD(invalidateCampaign:(NSString *)campaignId)
 
 @end
 
 
-// ── ViewManager stub ──────────────────────────────────────────────────────────
+// ── ViewManagers ──────────────────────────────────────────────────────────────
 
-@interface DigiaHostViewManager : RCTViewManager
+@interface RCT_EXTERN_MODULE(DigiaHostView, RCTViewManager)
 @end
 
-@implementation DigiaHostViewManager
-
-RCT_EXPORT_MODULE(DigiaHostView)
-
-- (UIView *)view {
-    // Return a transparent placeholder view
-    UIView *v = [[UIView alloc] init];
-    v.userInteractionEnabled = NO;
-    return v;
-}
-
+@interface RCT_EXTERN_MODULE(DigiaSlotView, RCTViewManager)
+RCT_EXPORT_VIEW_PROPERTY(placementKey, NSString)
+RCT_EXPORT_VIEW_PROPERTY(onContentSizeChange, RCTDirectEventBlock)
 @end

package/ios/DigiaHostViewManager.swift

@@ -0,0 +1,128 @@
+/**
+ * DigiaHostViewManager
+ *
+ * React Native ViewManager that exposes a UIView wrapping DigiaHost (from the
+ * Digia iOS SDK) as the native view behind the JS <DigiaHostView> component.
+ *
+ * DigiaHost is a SwiftUI view, so we bridge it into UIKit using a
+ * UIHostingController embedded as a child view controller.  The host view
+ * manages dialog and bottom-sheet overlays driven by Digia CEP plugins.
+ *
+ * Place <DigiaHostView> once at the root of your RN component tree.
+ */
+import SwiftUI
+import React
+import DigiaEngage
+
+@objc(DigiaHostView)
+final class DigiaHostViewManager: RCTViewManager {
+
+    override static func requiresMainQueueSetup() -> Bool { true }
+
+    override func view() -> UIView! {
+        return DigiaHostUIView()
+    }
+}
+
+// MARK: - DigiaHostUIView
+
+/// Lightweight UIView container that embeds a UIHostingController<DigiaHost>
+/// as a child so SwiftUI's DigiaHost composable renders overlays above all
+/// React Native content.
+final class DigiaHostUIView: UIView {
+
+    private var hostingController: UIHostingController<DigiaHostWrapperView>?
+
+    override func didMoveToWindow() {
+        super.didMoveToWindow()
+        guard window != nil else {
+            // View removed from hierarchy — tear down the hosting controller.
+            hostingController?.willMove(toParent: nil)
+            hostingController?.view.removeFromSuperview()
+            hostingController?.removeFromParent()
+            hostingController = nil
+            return
+        }
+        guard hostingController == nil else { return }
+        mountHostingController()
+    }
+
+    private func mountHostingController() {
+        guard let parentVC = parentViewController() else { return}
+
+        let swiftUIView = DigiaHostWrapperView()
+        let hc = UIHostingController(rootView: swiftUIView)
+        hc.view.translatesAutoresizingMaskIntoConstraints = false
+        hc.view.backgroundColor = .clear
+
+        parentVC.addChild(hc)
+        // Mount onto parentVC.view (full-screen) rather than self, because
+        // DigiaHostView is intentionally sized 0×0 in React Native (it takes no
+        // screen space). A zero-size UIHostingController frame prevents SwiftUI
+        // from rendering its body, which means @ObservedObject subscriptions and
+        // .onChange(of:) modifiers are never established — so activePayload
+        // changes are silently dropped and no overlay is ever shown.
+        // Anchoring to parentVC.view guarantees a non-zero frame so SwiftUI's
+        // rendering loop runs and reacts to SDK state changes.
+        parentVC.view.addSubview(hc.view)
+        hc.didMove(toParent: parentVC)
+
+        NSLayoutConstraint.activate([
+            hc.view.leadingAnchor.constraint(equalTo: parentVC.view.leadingAnchor),
+            hc.view.trailingAnchor.constraint(equalTo: parentVC.view.trailingAnchor),
+            hc.view.topAnchor.constraint(equalTo: parentVC.view.topAnchor),
+            hc.view.bottomAnchor.constraint(equalTo: parentVC.view.bottomAnchor),
+        ])
+
+        hostingController = hc
+    }
+
+    // Pass touches through to RN when no overlay is active.
+    // When an overlay renders in-host (bottom sheet / dialog inside DigiaHost's ZStack),
+    // SwiftUI's hit test returns the overlay view and we forward that — making the
+    // overlay fully interactive. When nothing is rendered (EmptyView), SwiftUI returns
+    // nil and we return nil, so UIKit falls through to RN content below.
+    override func hitTest(_ point: CGPoint, with event: UIEvent?) -> UIView? {
+        return hostingController?.view.hitTest(point, with: event)
+    }
+
+    /// Prefer React Native’s `UIView.reactViewController`, then walk `next` from each view’s `.next`.
+    private func parentViewController() -> UIViewController? {
+        let reactSel = NSSelectorFromString("reactViewController")
+        var view: UIView? = self
+        while let v = view {
+            if v.responds(to: reactSel), let raw = v.perform(reactSel)?.takeUnretainedValue() {
+                if let vc = raw as? UIViewController { return vc }
+            }
+            view = v.superview
+        }
+        view = self
+        while let v = view {
+            var r: UIResponder? = v.next
+            while let responder = r {
+                if let vc = responder as? UIViewController { return vc }
+                r = responder.next
+            }
+            view = v.superview
+        }
+        return nil
+    }
+}
+
+// MARK: - SwiftUI wrapper
+
+/// A SwiftUI view that acts as the DigiaHost root.  An EmptyView is used as
+/// content because React Native's own navigation already manages the app's
+/// view hierarchy — DigiaHost only needs to be mounted to activate the overlay
+/// layer.
+struct DigiaHostWrapperView: View {
+    var body: some View {
+        DigiaHost {
+            EmptyView()
+        }
+        // No frame constraint here — the view fills its parent (absoluteFill
+        // from JS). A non-zero frame is required so UIKit calls viewDidAppear
+        // on the UIHostingController, which in turn triggers SwiftUI onAppear
+        // and establishes the onChange(activePayload) subscription.
+    }
+}