@momo-kits/native-kits 0.167.1-duo.1-debug → 0.167.1-duo.10-debug

package/compose/src/commonMain/kotlin/vn/momo/kits/navigation/component/HeaderLocation.kt

@@ -22,7 +22,6 @@ import vn.momo.kits.components.Text
 import vn.momo.kits.const.Spacing
 import vn.momo.kits.const.Typography
 import vn.momo.kits.modifier.activeOpacityClickable
-import vn.momo.kits.platform.getScreenDimensions
 
 @Composable
 internal fun HeaderLocation(
@@ -32,7 +31,7 @@ internal fun HeaderLocation(
     if (data !is HeaderTitle.Location) return
     if (data.isLoading) return TitleLocationShimmer()
 
-    val maxWidth = getScreenDimensions().width.dp - 172.dp
+    val maxWidth = headerTitleMaxWidth()
     val tint = parseHeaderTint(data.tintColor) ?: tintIconColor
 
     Column(

package/compose/src/commonMain/kotlin/vn/momo/kits/navigation/component/HeaderRight.kt

@@ -6,6 +6,7 @@ import androidx.compose.foundation.background
 import androidx.compose.foundation.border
 import androidx.compose.foundation.layout.Arrangement
 import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.Column
 import androidx.compose.foundation.layout.Row
 import androidx.compose.foundation.layout.height
 import androidx.compose.foundation.layout.offset
@@ -25,7 +26,9 @@ import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.draw.clip
 import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.unit.Dp
 import androidx.compose.ui.unit.dp
+import vn.momo.kits.layout.DuoMetrics
 import vn.momo.kits.application.LocalContext
 import vn.momo.kits.application.MiniAppContext
 import vn.momo.kits.components.BadgeDot
@@ -59,11 +62,29 @@ fun HeaderRight(
     }
 }
 
+private const val HELP_CENTER_APP_ID = "vn.momo.helpcenter"
+
+private fun usesHelpCenter(context: MiniAppContext?): Boolean =
+    context != null && context.appId != HELP_CENTER_APP_ID
+
+private fun showsShortcut(headerRight: HeaderRight.Toolkit, context: MiniAppContext?): Boolean =
+    headerRight.useShortcut && !(headerRight.useMore && context == null)
+
+// Height of the vertical toolkit: the optional shortcut, then the help/home capsule.
+@Composable
+internal fun toolkitColumnHeight(headerRight: HeaderRight.Toolkit): Dp {
+    val context = LocalContext.current
+    val shortcut = if (showsShortcut(headerRight, context)) DuoMetrics.controlSize + Spacing.M else 0.dp
+    val groupCount = if (usesHelpCenter(context)) 2 else 1
+    return shortcut + if (groupCount > 1) DuoMetrics.itemPitch * groupCount else DuoMetrics.controlSize
+}
+
 @Composable
 internal fun Toolkit(
     headerRight: HeaderRight.Toolkit,
     tintColor: Color? = null,
-    headerColor: HeaderColor
+    headerColor: HeaderColor,
+    vertical: Boolean = false,
 ) {
     val api = LocalMaxApi.current
     val context = LocalContext.current
@@ -103,6 +124,26 @@ internal fun Toolkit(
         }
     }
 
+    fun onPressHelpCenter() {
+        if (context == null) return
+        api?.showHelpCenter(
+            mapOf(
+                "appId" to context.appId,
+                "code" to context.appCode,
+                "name" to context.appName,
+                "icon" to context.appIcon,
+                "description" to context.description
+            )
+        ) {}
+    }
+
+    fun onPressClose() {
+        if (headerRight.useCloseIcon) api?.dismiss { } else api?.dismissAll { }
+    }
+
+    val useHelpCenter = usesHelpCenter(context)
+    val closeIcon = if (headerRight.useCloseIcon) "16_navigation_close_circle" else "16_basic_home"
+
     val navButtonConfig = getNavigationButtonConfig(
         headerRight,
         ::onPressShortcut,
@@ -113,12 +154,7 @@ internal fun Toolkit(
         group.items.any { it.showBadge }
     }
 
-    val isShowShortcut by remember(headerRight.useShortcut, headerRight.useMore, context) {
-        derivedStateOf {
-            (headerRight.useShortcut == true) &&
-                    !(headerRight.useMore == true && context == null)
-        }
-    }
+    val isShowShortcut = showsShortcut(headerRight, context)
 
     val icon by remember(navButtonConfig.icon, isFavorite) {
         derivedStateOf {
@@ -127,6 +163,37 @@ internal fun Toolkit(
         }
     }
 
+    if (vertical) {
+        Column(verticalArrangement = Arrangement.spacedBy(Spacing.M)) {
+            if (isShowShortcut) {
+                SideBarButton(
+                    icon = icon,
+                    headerColor = headerColor,
+                    enabled = !isLoading,
+                    showBadge = showBadge,
+                    onClick = navButtonConfig.onPress,
+                )
+            }
+            SideBarGroup(headerColor = headerColor, itemCount = if (useHelpCenter) 2 else 1) {
+                if (useHelpCenter) {
+                    SideBarGroupItem(
+                        icon = "help_center",
+                        headerColor = headerColor,
+                        automationId = "btn_navigation_help_center",
+                        onClick = ::onPressHelpCenter,
+                    )
+                }
+                SideBarGroupItem(
+                    icon = closeIcon,
+                    headerColor = headerColor,
+                    automationId = "btn_navigation_close",
+                    onClick = ::onPressClose,
+                )
+            }
+        }
+        return
+    }
+
     Row(
         verticalAlignment = Alignment.CenterVertically
     ) {
@@ -150,22 +217,12 @@ internal fun Toolkit(
                 .clip(shape = RoundedCornerShape(14.dp))
                 .background(headerColor.backgroundButton)
         ) {
-            if (context != null) {
+            if (useHelpCenter) {
                 Icon(
                     source = "help_center",
                     size = 20.dp,
                     color = headerColor.tintIconColor,
-                    modifier = Modifier.padding(4.dp).activeOpacityClickable {
-                        api?.showHelpCenter(
-                            mapOf(
-                                "appId" to context.appId,
-                                "code" to context.appCode,
-                                "name" to context.appName,
-                                "icon" to context.appIcon,
-                                "description" to context.description
-                            )
-                        ) {}
-                    }
+                    modifier = Modifier.padding(4.dp).activeOpacityClickable(onClick = ::onPressHelpCenter)
                 )
                 Box(
                     modifier = Modifier
@@ -175,12 +232,10 @@ internal fun Toolkit(
                 )
             }
             Icon(
-                source = "16_basic_home",
+                source = closeIcon,
                 size = 20.dp,
                 color = headerColor.tintIconColor,
-                modifier = Modifier.padding(4.dp).activeOpacityClickable {
-                    api?.dismissAll {  }
-                }
+                modifier = Modifier.padding(4.dp).activeOpacityClickable(onClick = ::onPressClose)
             )
         }
     }
@@ -270,7 +325,9 @@ sealed interface HeaderRight {
         val useMore: Boolean = false,
         val useSystemTools: Boolean = true,
         val tools: List<ToolGroup> = emptyList(),
-        val toolCallback: ((String) -> Unit)? = { _ -> }
+        val toolCallback: ((String) -> Unit)? = { _ -> },
+        // Close dismisses only this mini app instead of returning home.
+        val useCloseIcon: Boolean = false,
     ) : HeaderRight
 }
 

package/compose/src/commonMain/kotlin/vn/momo/kits/navigation/component/HeaderUser.kt

@@ -32,7 +32,6 @@ import vn.momo.kits.const.Typography
 import vn.momo.kits.const.getFontFamily
 import vn.momo.kits.modifier.activeOpacityClickable
 import vn.momo.kits.navigation.component.HeaderTitle.User
-import vn.momo.kits.platform.getScreenDimensions
 
 @Composable
 internal fun HeaderUser(
@@ -44,7 +43,7 @@ internal fun HeaderUser(
         return TitleUserShimmer()
     }
 
-    val maxWidth = getScreenDimensions().width.dp - 172.dp
+    val maxWidth = headerTitleMaxWidth()
 
     Row(
         modifier = Modifier

package/compose/src/commonMain/kotlin/vn/momo/kits/navigation/component/SideBar.kt

@@ -0,0 +1,185 @@
+package vn.momo.kits.navigation.component
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.border
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.BoxScope
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.ColumnScope
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.absolutePadding
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.offset
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.layout.width
+import androidx.compose.foundation.shape.CircleShape
+import androidx.compose.foundation.shape.RoundedCornerShape
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
+import androidx.compose.ui.AbsoluteAlignment
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.clip
+import androidx.compose.ui.draw.shadow
+import androidx.compose.ui.graphics.Shape
+import androidx.compose.ui.layout.layout
+import androidx.compose.ui.unit.Dp
+import androidx.compose.ui.unit.constrainHeight
+import androidx.compose.ui.unit.dp
+import vn.momo.kits.components.BadgeDot
+import vn.momo.kits.components.DotSize
+import vn.momo.kits.components.Icon
+import vn.momo.kits.const.Colors
+import vn.momo.kits.const.Radius
+import vn.momo.kits.const.Spacing
+import vn.momo.kits.layout.DuoMetrics
+import vn.momo.kits.layout.SideBarEdge
+import vn.momo.kits.layout.getScreenLayout
+import vn.momo.kits.modifier.activeOpacityClickable
+import vn.momo.kits.modifier.conditional
+import vn.momo.kits.modifier.setAutomationId
+import vn.momo.kits.navigation.LocalNavigator
+import vn.momo.kits.navigation.LocalOptions
+import vn.momo.kits.navigation.bottomtab.LocalDuoBarCompression
+
+private val SIDE_BAR_ICON_SIZE = 24.dp
+
+// iPhone Duo: back and toolkit leave the bar for a column in the side safe area, as the system bars do.
+// bottomInset is what footer / tab bar / home indicator take from the bottom, gap included; the column stays above it.
+@Composable
+internal fun BoxScope.HeaderSideBar(bottomInset: Dp, modifier: Modifier = Modifier) {
+    val options = LocalOptions.current
+    val navigator = LocalNavigator.current
+    val sideBar = getScreenLayout().sideBar ?: return
+    val toolkit = options.headerRight as? HeaderRight.Toolkit
+    if (options.headerType == HeaderType.None || (options.hiddenBack && toolkit == null)) return
+
+    val headerColor = getHeaderColor(options.headerType, headerOpacity(), options.tintColor, Colors.black_17)
+    val isRight = sideBar.edge == SideBarEdge.RIGHT
+    val compression = LocalDuoBarCompression.current
+
+    // full height, so the tab bar compression decision matches this screen's toolkit
+    val fullHeight = DuoMetrics.controlSize + (toolkit?.let { Spacing.M + toolkitColumnHeight(it) } ?: 0.dp)
+    LaunchedEffect(fullHeight, compression.setToolbarHeight) { compression.setToolbarHeight(fullHeight) }
+
+    Column(
+        modifier = modifier
+            .align(if (isRight) AbsoluteAlignment.TopRight else AbsoluteAlignment.TopLeft)
+            .width(sideBar.width)
+            .layout { measurable, constraints ->
+                val placeable = measurable.measure(constraints.copy(minHeight = 0))
+                val maxY = constraints.maxHeight - bottomInset.roundToPx() - placeable.height
+                val y = minOf(sideBar.top.roundToPx(), maxY).coerceAtLeast(0)
+                layout(placeable.width, constraints.constrainHeight(y + placeable.height)) {
+                    placeable.place(0, y)
+                }
+            }
+            .absolutePadding(left = if (isRight) Spacing.M else 0.dp, right = if (isRight) 0.dp else Spacing.M),
+        horizontalAlignment = if (isRight) AbsoluteAlignment.Left else AbsoluteAlignment.Right,
+        verticalArrangement = Arrangement.spacedBy(Spacing.M),
+    ) {
+        if (options.hiddenBack) {
+            // keep the slot so the toolkit does not jump between root and pushed screens
+            Spacer(Modifier.size(DuoMetrics.controlSize))
+        } else {
+            SideBarButton(
+                icon = "arrow-back",
+                headerColor = headerColor,
+                automationId = "btn_navigation_back",
+                onClick = { navigator.onBackSafe { } },
+            )
+        }
+        when {
+            toolkit == null || compression.toolbarHidden -> Unit
+            // HIG "Toolbar compressed": tools fold into one button, distinct from the useMore icon
+            compression.toolbarCompressed -> SideBarButton(
+                icon = "navigation_menu",
+                headerColor = headerColor,
+                showBadge = toolkit.tools.any { group -> group.items.any { it.showBadge } },
+                automationId = "btn_navigation_toolbar",
+                onClick = compression.expandToolbar,
+            )
+            else -> Toolkit(headerRight = toolkit, tintColor = options.tintColor, headerColor = headerColor, vertical = true)
+        }
+    }
+}
+
+@Composable
+internal fun SideBarButton(
+    icon: String,
+    headerColor: HeaderColor,
+    onClick: () -> Unit,
+    enabled: Boolean = true,
+    showBadge: Boolean = false,
+    automationId: String? = null,
+) {
+    Box {
+        Box(
+            modifier = Modifier
+                .size(DuoMetrics.controlSize)
+                .sideBarGlass(headerColor, CircleShape)
+                .activeOpacityClickable(enabled = enabled, onClick = onClick)
+                .conditional(automationId != null) { setAutomationId(automationId.orEmpty()) },
+            contentAlignment = Alignment.Center,
+        ) {
+            Icon(source = icon, size = SIDE_BAR_ICON_SIZE, color = headerColor.tintIconColor)
+        }
+        if (showBadge) {
+            BadgeDot(
+                size = DotSize.Small,
+                modifier = Modifier.align(Alignment.TopEnd).offset(x = -Spacing.XXS, y = Spacing.XXS),
+            )
+        }
+    }
+}
+
+// Capsule grouping related controls, one item per 50pt.
+@Composable
+internal fun SideBarGroup(
+    headerColor: HeaderColor,
+    itemCount: Int,
+    content: @Composable ColumnScope.() -> Unit,
+) {
+    val height = if (itemCount > 1) DuoMetrics.itemPitch * itemCount else DuoMetrics.controlSize
+    Column(
+        modifier = Modifier
+            .width(DuoMetrics.controlSize)
+            .height(height)
+            .sideBarGlass(headerColor, RoundedCornerShape(Radius.XL)),
+        content = content,
+    )
+}
+
+@Composable
+internal fun ColumnScope.SideBarGroupItem(
+    icon: String,
+    headerColor: HeaderColor,
+    automationId: String,
+    onClick: () -> Unit,
+) {
+    Box(
+        modifier = Modifier
+            .weight(1f)
+            .fillMaxWidth()
+            .activeOpacityClickable(onClick = onClick)
+            .setAutomationId(automationId),
+        contentAlignment = Alignment.Center,
+    ) {
+        Icon(source = icon, size = SIDE_BAR_ICON_SIZE, color = headerColor.tintIconColor)
+    }
+}
+
+// Dark glass under light icons (banner headers), light glass otherwise. The light one is opaque:
+// Compose has no backdrop blur and a translucent fill shows its own shadow through (RN uses 85% white).
+private fun Modifier.sideBarGlass(headerColor: HeaderColor, shape: Shape): Modifier =
+    if (headerColor.tintIconColor == Colors.black_01) {
+        clip(shape)
+            .background(Colors.black_20.copy(alpha = 0.5f))
+            .border(0.5.dp, Colors.black_01.copy(alpha = 0.2f), shape)
+    } else {
+        shadow(3.dp, shape)
+            .background(Colors.black_01)
+            .border(0.5.dp, Colors.black_20.copy(alpha = 0.08f), shape)
+    }

package/compose/src/commonMain/kotlin/vn/momo/kits/navigation/component/SnackBar.kt

@@ -83,7 +83,8 @@ internal fun SnackBar(
                     durationMillis = 200,
                 )
             )
-            navigator.hideSnackBar()
+            // hideSnackBar() would call clear() -> this close again while still bound
+            OverplayComponentRegistry.hardClearAfterDismiss()
         }
     }
 

package/compose/src/commonMain/kotlin/vn/momo/kits/platform/Platform.kt

@@ -14,6 +14,9 @@ data class ScreenDimension(
 
 expect fun getPlatformName(): String
 
+// iPhone idiom only; iPad windows and Android never get the iPhone / iPhone Duo layout.
+expect fun isPhoneIdiom(): Boolean
+
 @Composable
 expect fun getScreenDimensions(): ScreenDimension
 

package/compose/src/commonMain/kotlin/vn/momo/kits/platform/ReservedRegions.kt

@@ -0,0 +1,13 @@
+package vn.momo.kits.platform
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.Immutable
+import androidx.compose.ui.unit.Dp
+
+@Immutable
+internal data class ReservedRegion(val x: Dp, val y: Dp, val width: Dp, val height: Dp)
+
+// Regions the system occludes (iOS 27.1+), in the coordinates of the Compose root view: the
+// iPhone Duo camera, and the status bar cluster as it grows for a call or a Live Activity.
+@Composable
+internal expect fun rememberReservedRegions(): List<ReservedRegion>

package/compose/src/commonMain/kotlin/vn/momo/kits/utils/Utils.kt

@@ -95,9 +95,12 @@ fun getAppStatusBarHeight(): Dp {
     }
 }
 
+internal val horizontalSafeAreaInsets: WindowInsets
+    @Composable get() = WindowInsets.systemBars.union(WindowInsets.displayCutout).only(WindowInsetsSides.Horizontal)
+
 // Left/right safe area like SwiftUI (landscape camera/notch); consumed, so nested StackScreens don't pad twice.
 internal fun Modifier.horizontalSafeAreaPadding(): Modifier = composed {
-    windowInsetsPadding(WindowInsets.systemBars.union(WindowInsets.displayCutout).only(WindowInsetsSides.Horizontal))
+    windowInsetsPadding(horizontalSafeAreaInsets)
 }
 
 @Composable

package/compose/src/iosMain/kotlin/vn/momo/kits/platform/Platform.ios.kt

@@ -39,11 +39,15 @@ import platform.Foundation.NSBundle
 import platform.UIKit.UIColor
 import platform.UIKit.UIDevice
 import platform.UIKit.UIScreen
+import platform.UIKit.UIUserInterfaceIdiomPhone
 import vn.momo.kits.navigation.AttachHostBackGesture
 import vn.momo.kits.navigation.Navigator
 
 actual fun getPlatformName(): String = "iOS"
 
+actual fun isPhoneIdiom(): Boolean =
+    UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPhone
+
 @OptIn(ExperimentalForeignApi::class)
 @Composable
 actual fun getScreenDimensions(): ScreenDimension = memScoped {

package/compose/src/iosMain/kotlin/vn/momo/kits/platform/ReservedRegions.ios.kt

@@ -0,0 +1,86 @@
+package vn.momo.kits.platform
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.DisposableEffect
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.uikit.LocalUIViewController
+import androidx.compose.ui.unit.dp
+import kotlinx.cinterop.BetaInteropApi
+import kotlinx.cinterop.ExperimentalForeignApi
+import kotlinx.cinterop.readValue
+import kotlinx.cinterop.useContents
+import platform.CoreGraphics.CGRectZero
+import platform.Foundation.NSSelectorFromString
+import platform.Foundation.NSValue
+import platform.Foundation.valueForKey
+import platform.UIKit.CGRectValue
+import platform.UIKit.UIView
+import platform.UIKit.UIViewAutoresizingFlexibleHeight
+import platform.UIKit.UIViewAutoresizingFlexibleWidth
+import platform.darwin.NSObject
+import platform.darwin.NSObjectProtocol
+import platform.Foundation.NSClassFromString
+
+// The API is newer than the SDK Kotlin/Native binds, so it is reached through the runtime.
+@OptIn(ExperimentalForeignApi::class)
+private val regionsOfKind = NSSelectorFromString("reservedRegionsOfKind:")
+
+@OptIn(ExperimentalForeignApi::class, BetaInteropApi::class)
+private fun UIView.occlusionRegions(target: UIView): List<ReservedRegion> {
+    if (window == null || !respondsToSelector(regionsOfKind)) return emptyList()
+    val kindClass = NSClassFromString("UIViewReservedRegionKind") as? NSObjectProtocol ?: return emptyList()
+    val kind = kindClass.performSelector(NSSelectorFromString("occlusionRegionKind")) ?: return emptyList()
+    val regions = performSelector(regionsOfKind, withObject = kind) as? List<*> ?: return emptyList()
+    return regions.mapNotNull { region ->
+        val frame = ((region as? NSObject)?.valueForKey("frame") as? NSValue)?.CGRectValue ?: return@mapNotNull null
+        convertRect(frame, toView = target).useContents {
+            ReservedRegion(origin.x.dp, origin.y.dp, size.width.dp, size.height.dp)
+        }
+    }
+}
+
+// Invisible full-size probe: reading the regions in layoutSubviews makes UIKit run it again
+// when they change, so nothing polls.
+@OptIn(ExperimentalForeignApi::class)
+private class ReservedRegionsProbe(
+    private val onChange: (List<ReservedRegion>) -> Unit,
+) : UIView(frame = CGRectZero.readValue()) {
+    private var last: List<ReservedRegion>? = null
+
+    init {
+        userInteractionEnabled = false
+        autoresizingMask = UIViewAutoresizingFlexibleWidth or UIViewAutoresizingFlexibleHeight
+    }
+
+    override fun layoutSubviews() {
+        super.layoutSubviews()
+        val regions = superview?.let { occlusionRegions(it) } ?: emptyList()
+        if (regions != last) {
+            last = regions
+            onChange(regions)
+        }
+    }
+
+    override fun didMoveToWindow() {
+        super.didMoveToWindow()
+        setNeedsLayout()
+    }
+}
+
+@OptIn(ExperimentalForeignApi::class)
+@Composable
+internal actual fun rememberReservedRegions(): List<ReservedRegion> {
+    if (!isPhoneIdiom()) return emptyList()
+    val host = LocalUIViewController.current.view
+    var regions by remember { mutableStateOf(emptyList<ReservedRegion>()) }
+    DisposableEffect(host) {
+        val probe = ReservedRegionsProbe { regions = it }
+        probe.setFrame(host.bounds)
+        host.insertSubview(probe, atIndex = 0)
+        onDispose { probe.removeFromSuperview() }
+    }
+    return regions
+}

package/gradle.properties

@@ -18,7 +18,7 @@ kotlin.apple.xcodeCompatibility.nowarn=true
 name="ComposeKits"
 group=vn.momo.kits
 artifact.id=kits
-version=0.167.1-duo.1
+version=0.167.1-beta.4
 
 repo=GitLab
 url=https://gitlab.mservice.com.vn/api/v4/projects/5400/packages/maven

package/ios/Application/ApplicationEnvironment.swift

@@ -41,6 +41,12 @@ public class KitConfig {
     public var trustBanner: TrustBannerData? = nil
     public var headerBar: String? = nil
     public var headerGradient: String? = nil
+
+    public init(trustBanner: TrustBannerData? = nil, headerBar: String? = nil, headerGradient: String? = nil) {
+        self.trustBanner = trustBanner
+        self.headerBar = headerBar
+        self.headerGradient = headerGradient
+    }
 }
 
 public class ApplicationEnvironment: ObservableObject {
@@ -59,6 +65,17 @@ public class ApplicationEnvironment: ObservableObject {
     }
 }
 
+extension ApplicationEnvironment {
+    /// Closes the mini app: through `composeApi` as before, else `maxApi` (Compose `maxApi.dismiss`).
+    func requestDismiss() {
+        if let composeApi {
+            composeApi.requestCallback(funcName: "dismiss", params: nil, onResponse: nil)
+        } else {
+            maxApi?.dismiss(completion: nil)
+        }
+    }
+}
+
 private struct ApplicationEnvironmentKey: EnvironmentKey {
     static let defaultValue = ApplicationEnvironment()
 }

package/ios/Application/ComposeApi.swift

@@ -1,11 +1,12 @@
 import Foundation
 
+@available(*, deprecated, message: "Use KitComposeApi or MaxApi")
 public protocol ComposeApi {
     func request(funcName: String, params: Any, _ completion: ((String) -> Void)?)
     func request(funcName: String, params: Any) -> String
 }
 
-// Default implementation
+@available(*, deprecated, message: "Use KitComposeApi or MaxApi")
 public class ComposeApiImpl: ComposeApi {
     public static let shared = ComposeApiImpl()