@momo-kits/native-kits 0.300.3 → 0.300.4-debug

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

@@ -0,0 +1,153 @@
+package vn.momo.kits.platform
+
+import android.annotation.SuppressLint
+import android.content.res.Resources
+import android.graphics.BlurMaskFilter
+import android.graphics.PorterDuff
+import android.graphics.PorterDuffColorFilter
+import android.os.Build
+import androidx.compose.foundation.layout.Box
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.rememberUpdatedState
+import androidx.compose.runtime.snapshotFlow
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.graphics.NativePaint
+import androidx.compose.ui.graphics.toArgb
+import androidx.compose.ui.platform.LocalConfiguration
+import androidx.compose.ui.semantics.contentDescription
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.unit.Dp
+import androidx.compose.ui.unit.dp
+import com.airbnb.lottie.LottieProperty
+import com.airbnb.lottie.compose.LottieAnimation
+import com.airbnb.lottie.compose.LottieCompositionSpec
+import com.airbnb.lottie.compose.animateLottieCompositionAsState
+import com.airbnb.lottie.compose.rememberLottieComposition
+import com.airbnb.lottie.compose.rememberLottieDynamicProperties
+import com.airbnb.lottie.compose.rememberLottieDynamicProperty
+import vn.momo.kits.const.AppNavigationBar
+import vn.momo.kits.const.AppStatusBar
+import vn.momo.kits.navigation.Navigator
+import vn.momo.kits.utils.readJson
+import androidx.activity.compose.BackHandler as AndroidBackHandler
+
+actual fun getPlatformName(): String = "Android"
+
+actual fun isPhoneIdiom(): Boolean = false
+
+@Composable
+actual fun getScreenDimensions(): ScreenDimension {
+    val config = LocalConfiguration.current
+    return ScreenDimension(
+        config.screenWidthDp, config.screenHeightDp
+    )
+}
+
+actual fun NativePaint.setMaskFilter(blurRadius: Float) {
+    this.maskFilter = BlurMaskFilter(blurRadius, BlurMaskFilter.Blur.NORMAL)
+}
+
+@SuppressLint("InternalInsetResource")
+@Composable
+actual fun getStatusBarHeight(): Dp {
+    val resourceId = Resources.getSystem().getIdentifier(
+        "status_bar_height",
+        "dimen",
+        "android"
+    )
+    return if(resourceId > 0) Resources.getSystem().getDimensionPixelSize(resourceId).dp else 0.dp
+}
+
+@Composable
+actual fun BackHandler(enabled: Boolean, onBack: () -> Unit) {
+    AndroidBackHandler(enabled = enabled, onBack = onBack)
+}
+
+@Composable
+actual fun ProvideNavigationEventDispatcherOwner(navigator: Navigator, content: @Composable () -> Unit) {
+    content()
+}
+
+@Composable
+actual fun getScreenHeight(): Dp {
+    return getScreenDimensions().height.dp + if (getOSVersion() >= 35) 0.dp else AppStatusBar.current + AppNavigationBar.current
+}
+
+actual fun getOSVersion(): OSVersion = OSVersion.Android(sdk = Build.VERSION.SDK_INT)
+
+@Composable
+actual fun LottieAnimation(
+    path: String,
+    tintColor: Color?,
+    bgColor: Color?,
+    placedAsOverlay: Boolean,
+    iterations: Int,
+    isPlaying: Boolean,
+    onEvent: ((String) -> Unit)?,
+    modifier: Modifier,
+    useCompose: Boolean
+) {
+    if (useCompose) {
+        ComposeLottieAnimation(path, tintColor, bgColor, iterations, isPlaying, onEvent, modifier)
+        return
+    }
+
+    val json = readJson(path)
+
+    if (json.isEmpty()) {
+        Box(modifier)
+        return
+    }
+
+    val composition by rememberLottieComposition(
+        LottieCompositionSpec.JsonString(json)
+    )
+
+    val colorFilter = PorterDuffColorFilter(
+        tintColor?.toArgb() ?: Color.White.toArgb(),
+        PorterDuff.Mode.SRC_ATOP
+    )
+
+    val dynamicProperties = rememberLottieDynamicProperties(
+        rememberLottieDynamicProperty(
+            property = LottieProperty.COLOR_FILTER,
+            value = colorFilter,
+            keyPath = arrayOf("**")
+        )
+    )
+
+    val lottieState = animateLottieCompositionAsState(
+        composition = composition,
+        iterations = iterations,
+        isPlaying = isPlaying,
+        restartOnPlay = false,
+    )
+
+    val currentOnEvent by rememberUpdatedState(onEvent)
+
+    LaunchedEffect(isPlaying) {
+        currentOnEvent?.invoke(if (isPlaying) LottieEvent.Start else LottieEvent.Pause)
+    }
+
+    LaunchedEffect(lottieState) {
+        var armed = false
+        snapshotFlow { lottieState.isAtEnd }.collect { atEnd ->
+            if (!atEnd) armed = true
+            else if (armed) { armed = false; currentOnEvent?.invoke(LottieEvent.Finish) }
+        }
+    }
+
+    LottieAnimation(
+        composition = composition,
+        progress = { lottieState.progress },
+        dynamicProperties = if (tintColor != null) dynamicProperties else null,
+        modifier = modifier
+    )
+}
+
+actual fun NativePaint.setColor(color: Color){
+    this.color = color.toArgb()
+}

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

@@ -0,0 +1,6 @@
+package vn.momo.kits.platform
+
+import androidx.compose.runtime.Composable
+
+@Composable
+internal actual fun rememberReservedRegions(): ReservedRegions = ReservedRegions()

package/compose/src/commonMain/kotlin/vn/momo/kits/application/Context.kt

@@ -0,0 +1,110 @@
+package vn.momo.kits.application
+
+import androidx.compose.runtime.Immutable
+import androidx.compose.runtime.staticCompositionLocalOf
+import vn.momo.kits.components.TrustBannerData
+
+@Immutable
+data class FeatureFlags(
+    val showBaseLineDebug: Boolean? = false,
+)
+
+@Immutable
+data class DesignSystemConfig(
+    val trustBanner: TrustBannerData? = null,
+    val headerBar: String? = null,
+    val headerGradient: String? = null,
+)
+
+@Immutable
+data class MiniAppContext(
+    val appIcon: String = "",
+    val appName: Any? = null,
+    val appId: String = "",
+    val appCode: String = "",
+    val description: Any? = null,
+    val support: Map<String, Any?> = emptyMap(),
+    val toolkitConfig: Map<String, Any?> = emptyMap(),
+    val providerId: String = "",
+    val permissions: List<Map<String, Any>>? = emptyList(),
+    val features: FeatureFlags? = null,
+    val scaleSizeMaxRate: Float? = null,
+    val userScaleRate: Float? = null,
+    val useOSScaleRate: Boolean? = null,
+) {
+    companion object {
+
+        fun toMap(context: MiniAppContext?): Map<String, Any?> = mapOf(
+            "icon"          to (context?.appIcon ?: ""),
+            "name"          to context?.appName,
+            "appId"         to (context?.appId ?: ""),
+            "code"          to (context?.appCode ?: ""),
+            "description"   to (context?.description ?: ""),
+            "support"       to (context?.support ?: emptyMap()),
+            "toolkitConfig" to (context?.toolkitConfig ?: emptyMap()),
+            "providerId"    to (context?.providerId ?: ""),
+            "permissions"   to (context?.permissions ?: emptyList()),
+        )
+
+        fun merge(parent: MiniAppContext?, child: MiniAppContext?): MiniAppContext? {
+            if (parent == null && child == null) return null
+            if (parent == null) return child
+            if (child == null) return parent
+
+            return MiniAppContext(
+                appIcon = parent.appIcon.ifBlank { child.appIcon },
+                appName = parent.appName ?: child.appName,
+                appId = parent.appId.ifBlank { child.appId },
+                appCode = parent.appCode.ifBlank { child.appCode },
+                description = parent.description ?: child.description,
+                support = mergeMaps(parent.support, child.support),
+                toolkitConfig = mergeMaps(parent.toolkitConfig, child.toolkitConfig),
+                providerId = parent.providerId.ifBlank { child.providerId },
+                permissions = if (!parent.permissions.isNullOrEmpty()) parent.permissions else child.permissions,
+                features = mergeFeatureFlags(parent.features, child.features),
+                scaleSizeMaxRate = parent.scaleSizeMaxRate ?: child.scaleSizeMaxRate,
+                userScaleRate = parent.userScaleRate ?: child.userScaleRate,
+                useOSScaleRate = parent.useOSScaleRate ?: child.useOSScaleRate,
+            )
+        }
+
+        private fun mergeMaps(parent: Map<String, Any?>, child: Map<String, Any?>): Map<String, Any?> {
+            return child + parent
+        }
+
+        private fun mergeFeatureFlags(parent: FeatureFlags?, child: FeatureFlags?): FeatureFlags? {
+            if (parent == null && child == null) return null
+            if (parent == null) return child
+            if (child == null) return parent
+
+            return FeatureFlags(
+                showBaseLineDebug = parent.showBaseLineDebug ?: child.showBaseLineDebug
+            )
+        }
+    }
+}
+
+@Immutable
+data class ComponentInformation(
+    val componentName: String? = null,
+    val componentId: String? = null,
+    val params: Map<String,Any?>? = null,
+    val action: String? = null
+)
+
+var IsShowBaseLineDebug = false
+
+val LocalContext = staticCompositionLocalOf<MiniAppContext?> {
+    null
+}
+
+val LocalComponentInformation = staticCompositionLocalOf<ComponentInformation?> {
+    null
+}
+
+val LocalDesignSystemConfig = staticCompositionLocalOf<DesignSystemConfig?> {
+    null
+}
+
+@Deprecated("Max font scale is fixed at MAX_FONT_SCALE (1.5); this CompositionLocal is no longer read.")
+val ScaleSizeMaxRate = staticCompositionLocalOf<Float?> { null }

package/compose/src/commonMain/kotlin/vn/momo/kits/application/DesignSystemKits.kt

@@ -0,0 +1,62 @@
+package vn.momo.kits.application
+
+import androidx.compose.runtime.Immutable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.setValue
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.Job
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.MutableStateFlow
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.asStateFlow
+import kotlinx.coroutines.launch
+
+@Immutable
+data class DesignSystemKitsConfigs(
+    val userScaleRate: Float = 1f,
+    val useOSScaleRate: Boolean = true,
+    val isWhiteList: Boolean = false,
+    val designSystemConfig: DesignSystemConfig? = null,
+)
+
+// The kit is sandboxed from the host's storage/config, so the host implements this and hands it to init().
+interface DesignSystemKitsSource {
+    // Sync read: seeds the kit before the first frame, so there is no default-then-real flicker.
+    fun getConfigs(): DesignSystemKitsConfigs
+
+    val configsFlow: Flow<DesignSystemKitsConfigs>
+}
+
+// App-wide design-system inputs (font scale, whitelist, remote config). scaleSize(), defaultTheme and
+// NavigationContainer fall back to these when no MiniAppContext / LocalDesignSystemConfig is provided.
+object DesignSystemKits {
+    private val scope = CoroutineScope(SupervisorJob() + Dispatchers.Main)
+    private var observeJob: Job? = null
+
+    // Snapshot state so Compose readers recompose (including non-composable getters like defaultTheme);
+    // the StateFlow is for non-Compose observers, e.g. the host's SwiftUI bridge, where Compose's
+    // global snapshot apply loop may never have started.
+    private var currentConfigs by mutableStateOf(DesignSystemKitsConfigs())
+    private val mutableConfigsFlow = MutableStateFlow(currentConfigs)
+    val configsFlow: StateFlow<DesignSystemKitsConfigs> = mutableConfigsFlow.asStateFlow()
+
+    // Idempotent: a repeated call (e.g. Activity re-creation) replaces the previous observer.
+    fun init(source: DesignSystemKitsSource) {
+        observeJob?.cancel()
+        setConfigs(source.getConfigs())
+        observeJob = scope.launch {
+            source.configsFlow.collect { setConfigs(it) }
+        }
+    }
+
+    // While init() is observing a source, its next emission overrides a value set here.
+    fun setConfigs(configs: DesignSystemKitsConfigs) {
+        currentConfigs = configs
+        mutableConfigsFlow.value = configs
+    }
+
+    fun getConfigs(): DesignSystemKitsConfigs = currentConfigs
+}