@momo-kits/native-kits 0.162.2-sp.1 → 0.162.2-sp.10-debug

package/ios/Application/Localize.swift

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

package/ios/Application/MaxApi.swift

@@ -0,0 +1,18 @@
+//
+//  MaxApi.swift
+//  MoMoUIKits
+//
+//  Swift mirror of the host-app bridge exposed on Kotlin as `vn.momo.maxapi.IMaxApi`
+//  (`LocalMaxApi`). `IMaxApi` itself is an external compiled dependency with no
+//  source in this repo, so this protocol intentionally exposes only the methods
+//  this kit's Kotlin source actually calls (`track`, `dismiss`, `getLanguage`) —
+//  not a full guess at IMaxApi's real surface.
+//
+
+import Foundation
+
+public protocol MaxApi {
+    func track(eventName: String, params: [String: Any?])
+    func dismiss(completion: (() -> Void)?)
+    func getLanguage(callback: @escaping ([String: Any?]?) -> Void)
+}

package/ios/Application/Navigation/BottomTab/BottomTab.swift

@@ -56,6 +56,7 @@ public struct BottomTab: View {
         }
         .frame(maxWidth: .infinity, maxHeight: .infinity)
         .ignoresSafeArea(edges: .bottom)
+        .preference(key: IsBottomTabRootKey.self, value: true)
     }
 
     @ViewBuilder
@@ -96,7 +97,8 @@ public struct BottomTab: View {
 /// Bottom safe-area inset (home indicator).
 @available(iOS 16.0, *)
 private func safeAreaBottomInset() -> CGFloat {
-    UIApplication.shared.connectedScenes
+    let bottomInset = UIApplication.shared.connectedScenes
         .compactMap { ($0 as? UIWindowScene)?.keyWindow?.safeAreaInsets.bottom }
         .first ?? 0
+    return min(bottomInset, 21)
 }

package/ios/Application/Navigation/NavigationContainer.swift

@@ -13,21 +13,42 @@ import SwiftUI
 @available(iOS 16.0, *)
 public struct NavigationContainer<Initial: View>: View {
     @StateObject private var navigator: Navigator
+    @StateObject private var applicationEnvironment: ApplicationEnvironment
+    @StateObject private var localize: Localize
 
     private let setNavigator: ((Navigator) -> Void)?
+    private let composeApi: KitComposeApi?
+    private let maxApi: MaxApi?
 
     public init(
         initialScreenName: String = "",
         @ViewBuilder initialScreen: @escaping () -> Initial,
         options: NavigationOptions? = nil,
+        applicationContext: MiniAppContext? = nil,
+        composeApi: KitComposeApi? = nil,
+        config: KitConfig? = nil,
+        maxApi: MaxApi? = nil,
+        localize: Localize? = nil,
         setNavigator: ((Navigator) -> Void)? = nil
     ) {
         let nav = Navigator(
             initialScreenName: initialScreenName.isEmpty ? (options?.screenName ?? "") : initialScreenName,
             initialContent: { AnyView(initialScreen()) },
-            options: options
+            options: options,
+            composeApi: composeApi
         )
         _navigator = StateObject(wrappedValue: nav)
+        _applicationEnvironment = StateObject(
+            wrappedValue: ApplicationEnvironment(
+                applicationContext: applicationContext,
+                composeApi: composeApi,
+                config: config,
+                maxApi: maxApi
+            )
+        )
+        _localize = StateObject(wrappedValue: localize ?? Localize())
+        self.composeApi = composeApi
+        self.maxApi = maxApi
         self.setNavigator = setNavigator
     }
 
@@ -39,22 +60,43 @@ public struct NavigationContainer<Initial: View>: View {
                 }
         }
         .environmentObject(navigator)
+        .environmentObject(applicationEnvironment)
+        .environment(\.applicationEnvironment, applicationEnvironment)
+        .environmentObject(localize)
         .fullScreenCover(item: $navigator.presented) { route in
             screenView(forDialog: route)
                 .environmentObject(navigator)
+                .environmentObject(applicationEnvironment)
+                .environment(\.applicationEnvironment, applicationEnvironment)
+                .environmentObject(localize)
         }
         .overlay {
             if let item = navigator.overplay {
                 OverplayHost(item: item)
                     .environmentObject(navigator)
+                    .environmentObject(applicationEnvironment)
+                    .environment(\.applicationEnvironment, applicationEnvironment)
+                    .environmentObject(localize)
+            }
+        }
+        .onAppear {
+            if navigator.composeApi == nil {
+                navigator.composeApi = composeApi
+            }
+            setNavigator?(navigator)
+            // Mirrors Compose's LaunchedEffect(maxApi, resolvedLocalize): host-reported
+            // language wins over the default "vi" only when it resolves to English.
+            maxApi?.getLanguage { data in
+                if parseLanguage(data) == Localize.EN {
+                    localize.changeLanguage(Localize.EN)
+                }
             }
         }
-        .onAppear { setNavigator?(navigator) }
     }
 
     @ViewBuilder
     private func screenView(for route: DynamicScreenRoute) -> some View {
-        if let screen = DynamicScreenRegistry.shared.getScreen(id: route.id) {
+        if let screen = navigator.registry.getScreen(id: route.id) {
             ScreenHost(screen: screen, navigator: navigator)
                 .navigationBarBackButtonHidden(true)
         } else {
@@ -64,7 +106,7 @@ public struct NavigationContainer<Initial: View>: View {
 
     @ViewBuilder
     private func screenView(forDialog route: DynamicDialogRoute) -> some View {
-        if let screen = DynamicScreenRegistry.shared.getScreen(id: route.id) {
+        if let screen = navigator.registry.getScreen(id: route.id) {
             ScreenHost(screen: screen, navigator: navigator)
         } else {
             EmptyView()
@@ -103,6 +145,7 @@ private struct ScreenHost: View {
             layoutOffset: options.layoutOffset,
             inputSearchProps: options.inputSearchProps,
             fabProps: options.fabProps,
+            screenName: screen.name,
             content: { screen.content() }
         )
     }
@@ -149,3 +192,9 @@ private func safeAreaBottomInset() -> CGFloat {
         .compactMap { ($0 as? UIWindowScene)?.keyWindow?.safeAreaInsets.bottom }
         .first ?? 0
 }
+
+private func parseLanguage(_ raw: [String: Any?]?) -> String? {
+    guard let response = (raw?["response"] as? String)?.trimmingCharacters(in: .whitespaces).lowercased(),
+          !response.isEmpty else { return nil }
+    return response.hasPrefix(Localize.EN) ? Localize.EN : Localize.VI
+}

package/ios/Application/Navigation/Navigator.swift

@@ -30,12 +30,10 @@ public struct DynamicScreen {
 }
 
 public final class DynamicScreenRegistry {
-    public static let shared = DynamicScreenRegistry()
-
     private var screens: [Int: DynamicScreen] = [:]
     private var idCounter: Int = 1
 
-    private init() {}
+    public init() {}
 
     @discardableResult
     public func register(
@@ -95,6 +93,11 @@ public final class Navigator: ObservableObject {
     @Published public var presented: DynamicDialogRoute?
     @Published public var overplay: OverplayItem?
 
+    /// Owned per-Navigator (mirrors Compose's `remember { DynamicScreenRegistry() }` +
+    /// disposal): screens registered by this navigator are released via ARC when the
+    /// navigator itself deallocates, instead of accumulating in a process-wide singleton.
+    public let registry = DynamicScreenRegistry()
+
     /// Animated-close handler registered by the active overplay component
     /// (mirrors Compose's `OverplayComponentRegistry.bindClose`). When set, a
     /// dismiss request runs the component's exit animation before the item is
@@ -102,13 +105,16 @@ public final class Navigator: ObservableObject {
     private var overplayDismissHandler: (() -> Void)?
 
     public private(set) var rootRoute: DynamicScreenRoute
+    public var composeApi: KitComposeApi?
 
     public init(
         initialScreenName: String = "",
         initialContent: @escaping () -> AnyView,
-        options: NavigationOptions? = nil
+        options: NavigationOptions? = nil,
+        composeApi: KitComposeApi? = nil
     ) {
-        self.rootRoute = DynamicScreenRegistry.shared.register(
+        self.composeApi = composeApi
+        self.rootRoute = registry.register(
             screenName: initialScreenName,
             content: initialContent,
             options: options
@@ -118,7 +124,7 @@ public final class Navigator: ObservableObject {
     // MARK: Stack
 
     public func push<V: View>(@ViewBuilder _ content: @escaping () -> V, options: NavigationOptions? = nil) {
-        let route = DynamicScreenRegistry.shared.register(
+        let route = registry.register(
             screenName: options?.screenName ?? "",
             content: { AnyView(content()) },
             options: options
@@ -131,7 +137,7 @@ public final class Navigator: ObservableObject {
         @ViewBuilder _ content: @escaping () -> V,
         options: NavigationOptions? = nil
     ) {
-        let route = DynamicScreenRegistry.shared.register(
+        let route = registry.register(
             screenName: screenName,
             content: { AnyView(content()) },
             options: options
@@ -142,7 +148,7 @@ public final class Navigator: ObservableObject {
     public func replace<V: View>(@ViewBuilder _ content: @escaping () -> V, options: NavigationOptions? = nil) {
         guard !path.isEmpty else { return }
         let removed = path.removeLast()
-        DynamicScreenRegistry.shared.unregister(id: removed.id)
+        registry.unregister(id: removed.id)
         push(content, options: options)
     }
 
@@ -153,15 +159,15 @@ public final class Navigator: ObservableObject {
     ) {
         guard !path.isEmpty else { return }
         let removed = path.removeLast()
-        DynamicScreenRegistry.shared.unregister(id: removed.id)
+        registry.unregister(id: removed.id)
         push(screenName: screenName, content, options: options)
     }
 
     public func reset<V: View>(@ViewBuilder _ content: @escaping () -> V, options: NavigationOptions? = nil) {
-        for route in path { DynamicScreenRegistry.shared.unregister(id: route.id) }
-        DynamicScreenRegistry.shared.unregister(id: rootRoute.id)
+        for route in path { registry.unregister(id: route.id) }
+        registry.unregister(id: rootRoute.id)
         path.removeAll()
-        let route = DynamicScreenRegistry.shared.register(
+        let route = registry.register(
             screenName: options?.screenName ?? "",
             content: { AnyView(content()) },
             options: options
@@ -174,10 +180,10 @@ public final class Navigator: ObservableObject {
         @ViewBuilder _ content: @escaping () -> V,
         options: NavigationOptions? = nil
     ) {
-        for route in path { DynamicScreenRegistry.shared.unregister(id: route.id) }
-        DynamicScreenRegistry.shared.unregister(id: rootRoute.id)
+        for route in path { registry.unregister(id: route.id) }
+        registry.unregister(id: rootRoute.id)
         path.removeAll()
-        let route = DynamicScreenRegistry.shared.register(
+        let route = registry.register(
             screenName: screenName,
             content: { AnyView(content()) },
             options: options
@@ -188,16 +194,16 @@ public final class Navigator: ObservableObject {
     public func pop(_ count: Int = 1, callback: (() -> Void)? = nil) {
         var remaining = count
         while remaining > 0 {
-            if overplay != nil {
+            if overplay?.type == .snackBar {
+                // Mirrors Kotlin: a snackbar doesn't block back-navigation, so popping
+                // while one is showing pops the screen underneath and clears the
+                // snackbar immediately, without playing its dismiss animation.
+                overplayDismissHandler = nil
+                overplay = nil
+                if !popScreen() { break }
+            } else if overplay != nil {
                 hideOverplay()
-            } else if presented != nil {
-                let dismissedId = presented?.id
-                presented = nil
-                if let id = dismissedId { DynamicScreenRegistry.shared.unregister(id: id) }
-            } else if !path.isEmpty {
-                let removed = path.removeLast()
-                DynamicScreenRegistry.shared.unregister(id: removed.id)
-            } else {
+            } else if !popScreen() {
                 break
             }
             remaining -= 1
@@ -205,13 +211,32 @@ public final class Navigator: ObservableObject {
         callback?()
     }
 
+    /// Pops the topmost presented screen or stack entry. Returns `false` (and requests
+    /// a host dismiss) when there is nothing left to pop.
+    @discardableResult
+    private func popScreen() -> Bool {
+        if presented != nil {
+            let dismissedId = presented?.id
+            presented = nil
+            if let id = dismissedId { registry.unregister(id: id) }
+            return true
+        } else if !path.isEmpty {
+            let removed = path.removeLast()
+            registry.unregister(id: removed.id)
+            return true
+        } else {
+            composeApi?.requestCallback(funcName: "dismiss", params: nil, onResponse: nil)
+            return false
+        }
+    }
+
     public func popToRoot() {
-        for route in path { DynamicScreenRegistry.shared.unregister(id: route.id) }
+        for route in path { registry.unregister(id: route.id) }
         path.removeAll()
     }
 
     public func onBackSafe(callback: (() -> Void)? = nil) {
-        let latest = DynamicScreenRegistry.shared.latest()
+        let latest = registry.latest()
         if let onBack = latest?.options?.onBackHandler {
             onBack()
             return
@@ -252,7 +277,7 @@ public final class Navigator: ObservableObject {
     // MARK: Modal-style screen (vertical slide)
 
     public func present<V: View>(@ViewBuilder _ content: @escaping () -> V, options: NavigationOptions? = nil) {
-        let route = DynamicScreenRegistry.shared.register(
+        let route = registry.register(
             screenName: options?.screenName ?? "",
             content: { AnyView(content()) },
             options: options
@@ -265,7 +290,7 @@ public final class Navigator: ObservableObject {
         @ViewBuilder _ content: @escaping () -> V,
         options: NavigationOptions? = nil
     ) {
-        let route = DynamicScreenRegistry.shared.register(
+        let route = registry.register(
             screenName: screenName,
             content: { AnyView(content()) },
             options: options
@@ -275,7 +300,7 @@ public final class Navigator: ObservableObject {
 
     public func dismiss() {
         if let id = presented?.id {
-            DynamicScreenRegistry.shared.unregister(id: id)
+            registry.unregister(id: id)
         }
         presented = nil
     }