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

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

@@ -0,0 +1,269 @@
+package vn.momo.kits.application
+
+import androidx.compose.runtime.Immutable
+import androidx.compose.runtime.Stable
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.setValue
+import androidx.compose.runtime.staticCompositionLocalOf
+
+/** Translation dictionary keyed by language; both `vi` and `en` are required. */
+@Immutable
+data class LocalizationObject(
+    val vi: Map<String, String> = emptyMap(),
+    val en: Map<String, String> = emptyMap(),
+)
+
+/**
+ * Translation gateway, ported from momo-kits React Native (`Application/Localize.ts`).
+ * Holds the merged dictionary (kit defaults + host overrides) and the active language,
+ * switched at runtime via [changeLanguage]. Language is snapshot-backed, so a switch
+ * recomposes consumers of [translate]/[translateData].
+ */
+@Stable
+class Localize(translations: LocalizationObject = LocalizationObject()) {
+
+    private var assets by mutableStateOf(merge(defaultLanguage, translations))
+
+    private var language by mutableStateOf(VI)
+
+    val currentLanguage: String get() = language
+
+    fun changeLanguage(language: String?) {
+        this.language = if (language == EN) EN else VI
+    }
+
+    fun translate(key: String): String {
+        val dictionary = if (language == EN) assets.en else assets.vi
+        return dictionary[key]?.takeIf { it.isNotEmpty() } ?: key
+    }
+
+    fun translateData(data: Map<String, String>): String =
+        data[language] ?: data.entries.joinToString(prefix = "{", postfix = "}") {
+            "\"${it.key}\":\"${it.value}\""
+        }
+
+    fun translateData(vi: String, en: String): String = if (language == EN) en else vi
+
+    fun addTranslations(translations: LocalizationObject) {
+        assets = merge(translations, assets)
+    }
+
+    companion object {
+        const val VI = "vi"
+        const val EN = "en"
+
+        private fun merge(base: LocalizationObject, override: LocalizationObject) = LocalizationObject(vi = base.vi + override.vi, en = base.en + override.en)
+
+        private val defaultLanguage = LocalizationObject(
+            vi = mapOf(
+                "errorCode" to "Mã lỗi: ",
+                "seeMore" to "Xem thêm",
+                "cancel" to "Huỷ",
+                "done" to "Xong",
+                "confirm" to "Xác nhận",
+                "month" to "tháng",
+                "day" to "ngày",
+                "choose" to "Chọn",
+                "sent" to "Đã gửi",
+                "received" to "Đã tiếp nhận",
+                "processing" to "Đang xử lý",
+                "processed" to "Đã xử lý",
+                "addImg" to "Thêm hình",
+                "chooseBtn" to "Chọn button",
+                "imgEg" to "Hình ảnh tham khảo",
+                "filter" to "Sắp xếp",
+                "shipping" to "Đang giao hàng",
+                "men" to "Nam",
+                "women" to "Nữ",
+                "more" to "Khác",
+                "expDate" to "Ngày hết hạn",
+                "exp" to "HSD",
+                "inActive" to "Chưa kích hoạt",
+                "voucherRemindHour" to "Hết hạn sau {hours} giờ",
+                "voucherRemindMinute" to "Hết hạn sau {minutes} phút",
+                "voucherRemindSecond" to "Hết hạn sau {seconds} giây",
+                "voucherRemindDay" to "Hết hạn sau {days} ngày",
+                "chooseRoundtrip" to "Chọn vé khứ hồi",
+                "depart" to "Ngày đi",
+                "return" to "Ngày về",
+                "departing" to "Đi",
+                "returning" to "Về",
+                "jan" to "Tháng 1",
+                "feb" to "Tháng 2",
+                "mar" to "Tháng 3",
+                "apr" to "Tháng 4",
+                "may" to "Tháng 5",
+                "jun" to "Tháng 6",
+                "jul" to "Tháng 7",
+                "aug" to "Tháng 8",
+                "sep" to "Tháng 9",
+                "oct" to "Tháng 10",
+                "nov" to "Tháng 11",
+                "dec" to "Tháng 12",
+                "mon" to "T2",
+                "tue" to "T3",
+                "wed" to "T4",
+                "thu" to "T5",
+                "fri" to "T6",
+                "sat" to "T7",
+                "sun" to "CN",
+                "showLunar" to "Hiển thị lịch âm",
+                "newYear" to "Tết Dương lịch",
+                "valentine" to "Ngày Lễ Tình nhân",
+                "womenDay" to "Ngày Quốc tế Phụ nữ",
+                "liberationDay" to "Ngày giải phóng Miền Nam thống nhất đất nước",
+                "laborDay" to "Ngày Quốc tế Lao động",
+                "childrenDay" to "Ngày Quốc tế Thiếu nhi",
+                "nationalDay" to "Quốc khánh nước CHXHCN Việt Nam",
+                "womenDayVN" to "Ngày Phụ nữ Việt Nam",
+                "teacherDay" to "Ngày Nhà giáo Việt Nam",
+                "christmasEve" to "Ngày Lễ Giáng Sinh",
+                "christmas" to "Ngày Lễ Giáng Sinh",
+                "lunarNewYear" to "Tết Nguyên Đán",
+                "hungKingDay" to "Giỗ Tổ Hùng Vương",
+                "balance" to "Số dư trong ví",
+                "chooseDate" to "Chọn ngày tháng năm",
+                "year" to "năm",
+                "hour" to "giờ",
+                "minute" to "phút",
+                "from" to "Từ",
+                "to" to "Đến",
+                "connected" to "Đã kết nối",
+                "disconnected" to "Mất kết nối",
+                "hide" to "Ẩn",
+                "viewAllTitle" to "Xem tất cả",
+                "headerTitle" to "Lịch sử thanh toán",
+                "SHORTEN" to "THU GỌN",
+                "viewMoreBank" to "XEM THÊM (\${otherItemCount} ngân hàng)",
+                "transaction_success" to "Thành công",
+                "transaction_fail" to "Thất bại",
+                "transaction_processing" to "Đang xử lý",
+                "viewMore" to "Xem thêm",
+                "shorten" to "Thu gọn",
+                "Payment" to "Thanh toán \${serviceName}",
+                "currencyUnit" to "đ",
+                "Month" to "Tháng",
+                "save" to "Lưu",
+                "favoriteIn" to "Thêm dịch vụ yêu thích",
+                "favoriteOut" to "Xóa dịch vụ yêu thích",
+                "deviceIn" to "Thêm vào thiết bị",
+                "setting" to "Cài đặt",
+                "transaction" to "Lịch sử giao dịch",
+                "share" to "Chia sẽ dịch vụ",
+                "information" to "Thông tin chung",
+                "tutorial" to "Hướng dẫn sử dụng",
+                "question" to "Câu hỏi thường gặp",
+                "support" to "Trung tâm hỗ trợ",
+                "skip" to "Bỏ qua",
+                "enterPhoneNumber" to "Vui lòng nhập số điện thoại",
+                "invalidPhoneNumber" to "Số điện thoại không đúng",
+            ),
+            en = mapOf(
+                "seeMore" to "See more",
+                "cancel" to "Cancel",
+                "done" to "Done",
+                "confirm" to "Confirm",
+                "month" to "month",
+                "day" to "day",
+                "choose" to "Choose",
+                "sent" to "Sent",
+                "received" to "Received",
+                "processing" to "Processing",
+                "processed" to "Done",
+                "addImg" to "Add image",
+                "chooseBtn" to "Choose button",
+                "imgEg" to "Example images",
+                "filter" to "Filter",
+                "shipping" to "Shipping",
+                "men" to "Men",
+                "women" to "Women",
+                "more" to "More",
+                "expDate" to "Expiration date",
+                "exp" to "EXP",
+                "inActive" to "Not Activated",
+                "voucherRemindHour" to "Revoke after {hours} hours",
+                "voucherRemindMinute" to "Revoke after {minutes} minutes",
+                "voucherRemindSecond" to "Revoke after {seconds} seconds",
+                "voucherRemindDay" to "Revoke after {days} days",
+                "chooseRoundtrip" to "Choose roundtrip ticket",
+                "depart" to "Departing",
+                "return" to "Returning",
+                "departing" to "De",
+                "returning" to "Re",
+                "jan" to "January",
+                "feb" to "February",
+                "mar" to "March",
+                "apr" to "April",
+                "may" to "May",
+                "jun" to "June",
+                "jul" to "July",
+                "aug" to "August",
+                "sep" to "September",
+                "oct" to "October",
+                "nov" to "November",
+                "dec" to "December",
+                "mon" to "Mon",
+                "tue" to "Tue",
+                "wed" to "Wed",
+                "thu" to "Thu",
+                "fri" to "Fri",
+                "sat" to "Sat",
+                "sun" to "Sun",
+                "showLunar" to "Show Lunar Calendar",
+                "newYear" to "New Year's Day",
+                "valentine" to "Valentine's Day",
+                "womenDay" to "International Women's Day",
+                "liberationDay" to "Liberation Day",
+                "laborDay" to "Internation Labor's Day",
+                "childrenDay" to "International Labor's Day",
+                "nationalDay" to "National Day",
+                "womenDayVN" to "Vietnamese Women's Day",
+                "teacherDay" to "Teacher's Day",
+                "christmasEve" to "Christmas Eve",
+                "christmas" to "Christmas Day",
+                "lunarNewYear" to "Lunar New Year",
+                "hungKingDay" to "Hung Kings' Festival",
+                "balance" to "Wallet Balance",
+                "chooseDate" to "Choose date",
+                "year" to "year",
+                "hour" to "hour",
+                "minute" to "minute",
+                "from" to "From",
+                "to" to "To",
+                "connected" to "Connected",
+                "disconnected" to "Disconnected",
+                "hide" to "Hide",
+                "viewAllTitle" to "View all",
+                "headerTitle" to "Transaction history",
+                "SHORTEN" to "SHORTEN",
+                "viewMoreBank" to "VIEW MORE (\${otherItemCount} banks)",
+                "transaction_success" to "Success",
+                "transaction_fail" to "Fail",
+                "transaction_processing" to "Processing",
+                "viewMore" to "View more",
+                "shorten" to "Shorten",
+                "Payment" to "\${serviceName} payment",
+                "currencyUnit" to "VND",
+                "Month" to "Month",
+                "save" to "Save",
+                "favoriteIn" to "Add to favorite services",
+                "favoriteOut" to "Remove to favorite services",
+                "deviceIn" to "Add to device",
+                "setting" to "Settings",
+                "transaction" to "Transaction History",
+                "share" to "Share",
+                "information" to "Information",
+                "tutorial" to "Instruction",
+                "question" to "FAQ",
+                "support" to "Support center",
+                "errorCode" to "Error code: ",
+                "skip" to "Skip",
+                "enterPhoneNumber" to "Please enter your phone number",
+                "invalidPhoneNumber" to "Invalid phone number",
+            ),
+        )
+    }
+}
+
+val LocalLocalize = staticCompositionLocalOf { Localize() }

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

@@ -0,0 +1,65 @@
+package vn.momo.kits.application
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.CompositionLocalProvider
+// AI-GENERATED START: own the typed language request
+import androidx.compose.runtime.DisposableEffect
+// AI-GENERATED END: own the typed language request
+import androidx.compose.runtime.remember
+import vn.momo.kits.const.AppTheme
+import vn.momo.kits.const.Theme
+import vn.momo.kits.navigation.LocalMaxApi
+import vn.momo.kits.platform.ProvideOsFontScale
+// AI-GENERATED START: consume typed NativeMaxApi results
+import vn.momo.maxapi.IMaxApi
+import vn.momo.maxapi.runtime.ApiResult
+// AI-GENERATED END: consume typed NativeMaxApi results
+
+
+@Composable
+fun WidgetContainer(
+    theme: Theme? = null,
+    miniAppContext: MiniAppContext? = null,
+    maxApi: IMaxApi? = null,
+    localize: Localize? = null,
+    content: @Composable () -> Unit,
+) {
+    val parentContext = LocalContext.current
+    val mergedContext = remember(parentContext, miniAppContext) {
+        MiniAppContext.merge(parentContext, miniAppContext)
+    }
+    val resolvedTheme = theme ?: AppTheme.current
+    val resolvedLocalize = localize ?: LocalLocalize.current
+    val resolvedMaxApi = maxApi ?: LocalMaxApi.current
+
+    // AI-GENERATED START: cancel language delivery when its composition owner changes
+    DisposableEffect(resolvedMaxApi, localize) {
+        val api = resolvedMaxApi
+        val target = localize
+        var active = true
+        val handle = runCatching {
+            api?.getLanguage { result ->
+                if (active && target != null && result is ApiResult.Success &&
+                    result.value.trim().lowercase().startsWith(Localize.EN)) {
+                    target.changeLanguage(Localize.EN)
+                }
+            }
+        }.getOrNull()
+        onDispose {
+            active = false
+            handle?.cancel()
+        }
+    }
+    // AI-GENERATED END: cancel language delivery when its composition owner changes
+
+    ProvideOsFontScale {
+        CompositionLocalProvider(
+            AppTheme provides resolvedTheme,
+            LocalContext provides mergedContext,
+            LocalLocalize provides resolvedLocalize,
+            LocalMaxApi provides resolvedMaxApi,
+        ) {
+            content()
+        }
+    }
+}

package/compose/src/commonMain/kotlin/vn/momo/kits/components/Avatar.kt

@@ -0,0 +1,157 @@
+package vn.momo.kits.components
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.border
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.offset
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.shape.RoundedCornerShape
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.remember
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.clip
+import androidx.compose.ui.semantics.contentDescription
+import androidx.compose.ui.semantics.semantics
+import androidx.compose.ui.unit.dp
+import androidx.compose.ui.zIndex
+import vn.momo.kits.application.IsShowBaseLineDebug
+import vn.momo.kits.const.AppTheme
+import vn.momo.kits.const.Colors
+import vn.momo.kits.const.Spacing
+import vn.momo.kits.const.Typography
+import vn.momo.kits.modifier.conditional
+import vn.momo.kits.modifier.setAutomationId
+
+private const val LOGO_MOMO_URL =
+    "https://static.momocdn.net/app/img/kits/logo_momo_circle.png"
+private const val ICON_SUPPORT_DEFAULT_URL =
+    "https://static.momocdn.net/app/img/kits/_indicator.png"
+
+enum class AvatarSize(val sizeDp: Int, val iconSizeDp: Int) {
+    SIZE_24(24, 16),
+    SIZE_32(32, 16),
+    SIZE_40(40, 24),
+    SIZE_48(48, 32),
+    SIZE_56(56, 32),
+    SIZE_72(72, 40),
+}
+
+@Composable
+fun Avatar(
+    modifier: Modifier = Modifier,
+    size: AvatarSize = AvatarSize.SIZE_32,
+    rounded: Boolean = true,
+    name: String? = null,
+    image: String? = null,
+    showIconMomo: Boolean = false,
+    showIconSupport: Boolean = false,
+    iconSupport: String = ICON_SUPPORT_DEFAULT_URL,
+    accessibilityLabel: String? = null,
+) {
+    val theme = AppTheme.current
+
+    val cornerRadius = remember(rounded, size) {
+        if (rounded) (size.sizeDp / 2).dp else Spacing.XS
+    }
+    val shape = remember(cornerRadius) { RoundedCornerShape(cornerRadius) }
+
+    val badgeSizeDp = remember(size) { (size.iconSizeDp / 2).dp }
+    val badgeShape = remember(size) {
+        RoundedCornerShape((size.iconSizeDp / 4).dp)
+    }
+
+    val shouldShowIconTop = showIconMomo && rounded
+    val shouldShowIconBottom = showIconSupport && rounded
+
+    val initials = remember(name) {
+        name?.let { avatarInitials(it) }
+    }
+
+    val automationId = remember(accessibilityLabel, name) {
+        accessibilityLabel ?: "Avatar${if (name != null) "/$name" else ""}"
+    }
+
+    Box(
+        modifier = modifier
+            .size(size.sizeDp.dp)
+            .conditional(IsShowBaseLineDebug) { border(1.dp, Colors.blue_03) }
+            .setAutomationId(automationId)
+            .semantics { contentDescription = automationId },
+    ) {
+        // Inner box with clip — holds avatar content
+        Box(
+            modifier = Modifier
+                .fillMaxSize()
+                .clip(shape)
+                .background(color = Colors.pink_09)
+                .border(width = 1.dp, color = theme.colors.border.default, shape = shape),
+            contentAlignment = Alignment.Center,
+        ) {
+            when {
+                image != null -> {
+                    Image(
+                        source = image,
+                        modifier = Modifier
+                            .fillMaxSize()
+                            .clip(shape)
+                            .semantics { contentDescription = "$automationId|img" },
+                    )
+                }
+
+                name != null -> {
+                    Text(
+                        text = initials ?: "",
+                        style = Typography.descriptionXsRegular,
+                        color = Colors.pink_03,
+                        modifier = Modifier
+                            .semantics { contentDescription = "$automationId|text" },
+                    )
+                }
+
+                else -> {
+                    Icon(
+                        source = "basic_person",
+                        size = size.iconSizeDp.dp,
+                        color = Colors.pink_03,
+                        modifier = Modifier
+                            .semantics { contentDescription = "$automationId|icon" },
+                    )
+                }
+            }
+        }
+
+        // Badge icons — outside clip so they are not cut by border
+        if (shouldShowIconTop) {
+            Image(
+                source = LOGO_MOMO_URL,
+                modifier = Modifier
+                    .zIndex(1f)
+                    .align(Alignment.TopEnd)
+                    .offset(x = 1.dp, y = (-1).dp)
+                    .size(badgeSizeDp)
+                    .clip(badgeShape)
+                    .semantics { contentDescription = "$automationId|top-icon" },
+            )
+        }
+
+        if (shouldShowIconBottom) {
+            Image(
+                source = iconSupport,
+                modifier = Modifier
+                    .zIndex(1f)
+                    .align(Alignment.BottomEnd)
+                    .offset(x = 1.dp, y = 1.dp)
+                    .size(badgeSizeDp)
+                    .clip(badgeShape)
+                    .semantics { contentDescription = "$automationId|bottom-icon" },
+            )
+        }
+    }
+}
+
+private fun avatarInitials(name: String): String {
+    val words = name.trim().split(" ").filter { it.isNotEmpty() }
+    return words.takeLast(2).joinToString("") { it.first().uppercaseChar().toString() }
+}

package/compose/src/commonMain/kotlin/vn/momo/kits/components/Badge.kt

@@ -0,0 +1,81 @@
+package vn.momo.kits.components
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.border
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.widthIn
+import androidx.compose.foundation.shape.RoundedCornerShape
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.text.style.TextOverflow
+import androidx.compose.ui.unit.dp
+import vn.momo.kits.application.IsShowBaseLineDebug
+import vn.momo.kits.const.*
+import vn.momo.kits.modifier.conditional
+
+private val badgePrimaryColors = listOf(
+    Color(0xFFF0F0F0),
+    Color(0xFFEB2F96),
+    Color(0xFF962AF0),
+    Color(0xFF4E4BFF),
+    Color(0xFF007AFF),
+    Color(0xFF13C2C2),
+    Color(0xFF34C759),
+    Color(0xFFA0D911),
+    Color(0xFFFFCC00),
+    Color(0xFFFA8C16),
+    Color(0xFFFA541C),
+    Color(0xFFF5222D)
+)
+
+private val badgeNumberRegex = "^\\d+$".toRegex()
+
+@Composable
+fun Badge(label: String = "Label", backgroundColor: Color? = null, modifier: Modifier = Modifier) {
+    fun isNumber(label: String): Boolean = badgeNumberRegex.matches(label)
+
+    fun formatTitle(label: String): String {
+        // Digits too long for Int are well over 99; toInt() would throw.
+        if (isNumber(label) && (label.toIntOrNull() ?: Int.MAX_VALUE) > 99) {
+            return "99+"
+        }
+        return label
+    }
+
+    var badgeColor =
+        if (isNumber(label)) {
+            AppTheme.current.colors.error.primary
+        } else {
+            AppTheme.current.colors.warning.primary
+        }
+
+    if (backgroundColor != null && badgePrimaryColors.contains(backgroundColor)) {
+        badgeColor = backgroundColor
+    }
+    val scaleSize = scaleSize(16f)
+
+    Box(
+        modifier = modifier
+            .height(scaleSize.dp)
+            .widthIn(min = scaleSize.dp)
+            .background(color = badgeColor, shape = RoundedCornerShape(Radius.M))
+            .border(width = 1.dp, shape = RoundedCornerShape(Radius.M), color = Colors.black_01)
+            .conditional(IsShowBaseLineDebug) {
+                border(1.dp, Colors.blue_03)
+            }
+            .padding(horizontal = Spacing.XS),
+        contentAlignment = Alignment.Center
+    ) {
+        Text(
+            text = formatTitle(label),
+            color = Colors.black_01,
+            style = Typography.actionXxsBold,
+            maxLines = 1,
+            overflow = TextOverflow.Ellipsis
+        )
+    }
+}

package/compose/src/commonMain/kotlin/vn/momo/kits/components/BadgeDot.kt

@@ -0,0 +1,32 @@
+package vn.momo.kits.components
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.border
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.size
+import androidx.compose.foundation.shape.RoundedCornerShape
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.unit.dp
+import vn.momo.kits.application.IsShowBaseLineDebug
+import vn.momo.kits.const.Colors
+import vn.momo.kits.const.Radius
+import vn.momo.kits.modifier.conditional
+
+enum class DotSize(val size: Int) {
+    Small(10),
+    Large(16)
+}
+
+@Composable
+fun BadgeDot(size: DotSize = DotSize.Large, modifier: Modifier = Modifier) {
+    Box(
+        modifier = modifier
+            .size(size.size.dp)
+            .border(width = 1.dp, color = Colors.black_01, shape = RoundedCornerShape(Radius.S))
+            .background(color = Colors.red_03, shape = RoundedCornerShape(Radius.S))
+            .conditional(IsShowBaseLineDebug) {
+                border(1.dp, Colors.blue_03)
+            }
+    )
+}