@momo-kits/native-kits 0.163.1-beta.8-debug → 0.163.1-beta.9-debug

package/ios-demo/Sources/MoMoUIKitsDemo/SampleDemos/LocalizeDemo.swift

@@ -0,0 +1,188 @@
+//
+//  LocalizeDemo.swift
+//  MoMoUIKitsDemo
+//
+//  SwiftUI port of the Compose demo `sample/shared/.../screens/LocalizeUsage.kt`,
+//  showcasing the `Localize` i18n port (ios/Application/Localize.swift).
+//  Synced from sample/iosApp/iosApp/Demo/LocalizeDemo.swift.
+//
+
+import MoMoUIKits
+import SwiftUI
+
+// App-specific dictionary. Keys here do NOT exist in the kit defaults, so addTranslations
+// registers them cleanly (addTranslations keeps existing keys on clash, host-default wins).
+private let AppTranslations = LocalizationObject(
+    vi: [
+        "demo_greeting": "Xin chào MoMo!",
+        "demo_cart_title": "Giỏ hàng của bạn",
+    ],
+    en: [
+        "demo_greeting": "Hello MoMo!",
+        "demo_cart_title": "Your cart",
+    ]
+)
+
+struct LocalizeDemo: View {
+    @EnvironmentObject private var localize: Localize
+
+    private var isEnglish: Bool { localize.currentLanguage == Localize.EN }
+
+    var body: some View {
+        ScrollView {
+            VStack(alignment: .leading, spacing: 0) {
+
+                LocalizeSectionBox(title: "Đổi ngôn ngữ (toàn app)") {
+                    MomoText(
+                        "localize.changeLanguage(...) đổi ngôn ngữ cho cả NavigationContainer — mọi màn hình đang đọc translate() sẽ cập nhật theo.",
+                        typography: .descriptionDefaultRegular
+                    )
+                    Switch(
+                        .constant(isEnglish),
+                        onChange: { _ in localize.changeLanguage(isEnglish ? Localize.VI : Localize.EN) },
+                        title: "English"
+                    )
+                    MomoText("currentLanguage = \(localize.currentLanguage)", typography: .labelDefaultMedium)
+                }
+
+                LocalizeSectionBox(title: "translate(key) — từ điển mặc định của kit") {
+                    TranslationRow(key: "confirm", value: localize.translate("confirm"))
+                    TranslationRow(key: "cancel", value: localize.translate("cancel"))
+                    TranslationRow(key: "done", value: localize.translate("done"))
+                    TranslationRow(key: "seeMore", value: localize.translate("seeMore"))
+                    TranslationRow(key: "balance", value: localize.translate("balance"))
+                }
+
+                LocalizeSectionBox(title: "Key thiếu → trả về chính key") {
+                    MomoText(
+                        "translate() với key không có (hoặc giá trị rỗng) sẽ trả lại đúng key để dễ phát hiện thiếu bản dịch.",
+                        typography: .descriptionDefaultRegular
+                    )
+                    TranslationRow(key: "not_a_real_key", value: localize.translate("not_a_real_key"))
+                }
+
+                LocalizeSectionBox(title: "Chèn tham số vào bản dịch") {
+                    MomoText(
+                        "Bản port không tự nội suy {placeholder} — tự replace ở nơi dùng.",
+                        typography: .descriptionDefaultRegular
+                    )
+                    TranslationRow(
+                        key: "voucherRemindHour",
+                        value: localize.translate("voucherRemindHour").replacingOccurrences(of: "{hours}", with: "3")
+                    )
+                }
+
+                LocalizeSectionBox(title: "translateData(vi:en:) — dịch nội tuyến") {
+                    MomoText(
+                        "Cho chuỗi dùng một lần, không cần khai báo key trong từ điển.",
+                        typography: .descriptionDefaultRegular
+                    )
+                    MomoText(localize.translateData(vi: "Thanh toán ngay", en: "Pay now"), typography: .headerDefaultBold)
+                }
+
+                LocalizeSectionBox(title: "translateData(map) — chọn theo ngôn ngữ") {
+                    MomoText(
+                        localize.translateData([
+                            Localize.VI: "Lịch sử giao dịch",
+                            Localize.EN: "Transaction history",
+                        ]),
+                        typography: .headerDefaultBold
+                    )
+                }
+
+                LocalizeSectionBox(title: "addTranslations — từ điển riêng của app") {
+                    MomoText(
+                        "Host đăng ký key riêng (đã add khi màn hình xuất hiện), rồi dùng translate() như key mặc định.",
+                        typography: .descriptionDefaultRegular
+                    )
+                    TranslationRow(key: "demo_greeting", value: localize.translate("demo_greeting"))
+                    TranslationRow(key: "demo_cart_title", value: localize.translate("demo_cart_title"))
+                }
+
+                LocalizeSectionBox(title: "Ví dụ thực tế") {
+                    // errorCode already ends with a separator ("Mã lỗi: " / "Error code: ").
+                    MomoText(localize.translate("errorCode") + "E-4097", typography: .bodyDefaultRegular)
+                    HStack(spacing: Spacing.M) {
+                        Button(
+                            title: localize.translate("cancel"),
+                            action: {},
+                            type: .outline,
+                            size: .medium,
+                            isFull: false
+                        )
+                        Button(
+                            title: localize.translate("confirm"),
+                            action: {},
+                            type: .primary,
+                            size: .medium,
+                            isFull: false
+                        )
+                    }
+                }
+
+                Spacer(minLength: 32)
+            }
+        }
+        // Registers the app-specific dictionary once per appearance; addTranslations'
+        // merge is idempotent, so re-entry (e.g. re-navigating back to this screen) is safe.
+        .onAppear {
+            localize.addTranslations(AppTranslations)
+        }
+    }
+}
+
+// MARK: - LocalizeSectionBox
+
+/// Titled rounded-card section container, mirroring Compose's `BasicColumnBox`
+/// (title label above a `theme.colors.background.surface` card with `Radius.M` corners).
+private struct LocalizeSectionBox<Content: View>: View {
+    @Environment(\.appTheme) private var theme
+    let title: String
+    @ViewBuilder let content: () -> Content
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            if !title.isEmpty {
+                MomoText(title, typography: .headerMBold)
+                    .padding(.top, 8)
+            }
+
+            VStack(alignment: .leading, spacing: 8) {
+                content()
+            }
+            .frame(maxWidth: .infinity, alignment: .leading)
+            .padding(12)
+            .background(theme.colors.background.surface)
+            .clipShape(RoundedRectangle(cornerRadius: Radius.M))
+        }
+        .padding(12)
+    }
+}
+
+// MARK: - TranslationRow
+
+private struct TranslationRow: View {
+    @Environment(\.appTheme) private var theme
+    let key: String
+    let value: String
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 2) {
+            MomoText(key, typography: .labelDefaultMedium, color: theme.colors.text.secondary)
+            MomoText(value, typography: .bodyDefaultRegular)
+        }
+    }
+}
+
+// MARK: - Preview
+
+#Preview {
+    if #available(iOS 16.0, *) {
+        NavigationStack {
+            LocalizeDemo()
+                .environmentObject(Localize())
+        }
+    } else {
+        // Fallback on earlier versions
+    }
+}

package/ios-demo/Sources/MoMoUIKitsDemo/SampleDemos/NavigationDemo.swift

@@ -0,0 +1,229 @@
+//
+//  NavigationDemo.swift
+//  Example
+//
+//  Usage demo for the navigation flow. Mirrors Compose's `NavigationUsage`:
+//  exercises push / present / replace / reset, the modal & bottom-sheet
+//  overplays, the snack bar, the user header title and the bottom-tab layout.
+//
+
+import MoMoUIKits
+import SwiftUI
+
+struct NavigationDemo: View {
+    var body: some View {
+        if #available(iOS 16.0, *) {
+            NavigationDemoContent()
+        } else {
+            Text("Navigation demo requires iOS 16+").padding()
+        }
+    }
+}
+
+@available(iOS 16.0, *)
+private struct NavigationDemoContent: View {
+    @EnvironmentObject private var navigator: Navigator
+    @State private var textValue1 = ""
+
+    var body: some View {
+        ScrollView {
+            VStack(spacing: 12) {
+                row("Push Screen") {
+                    navigator.push(
+                        { DemoLeafScreen(title: "Pushed Screen", color: Colors.blue09) },
+                        options: NavigationOptions(title: "Pushed Screen")
+                    )
+                }
+
+                row("Present Screen") {
+                    navigator.present(
+                        { PresentedScreen() },
+                        options: NavigationOptions(title: "Presented Screen")
+                    )
+                }
+
+                row("Replace Screen") {
+                    navigator.replace(
+                        { DemoLeafScreen(title: "Replaced Screen", color: Colors.pink09) },
+                        options: NavigationOptions(title: "Replaced Screen")
+                    )
+                }
+
+                row("Reset Screen") {
+                    // Clears the whole stack and installs a new root (no back).
+                    navigator.reset(
+                        { ResetTargetScreen() },
+                        options: NavigationOptions(title: "Reset Screen", hiddenBack: true)
+                    )
+                }
+
+                row("Show Modal") {
+                    navigator.showModal({
+                        VStack(spacing: 16) {
+                            MomoText("This is a modal", typography: .headerDefaultBold)
+                            MoMoUIKits.Button(title: "Close", action: { navigator.hideOverplay() }, type: .primary, size: .medium)
+                        }
+                        .padding(24)
+                        .frame(width: 300)
+                        .background(Colors.black01)
+                        .clipShape(RoundedRectangle(cornerRadius: Radius.L))
+                    }, barrierDismissible: true, onDismiss: { print("Modal dismissed") })
+                }
+
+                row("Show Bottom Sheet") {
+                    navigator.showBottomSheet({
+                        VStack(spacing: 12) {
+                            Input(text: $textValue1, placeholder: "Test Bottom Sheet")
+                            ForEach(0..<4, id: \.self) { i in
+                                MomoText("Bottom sheet row \(i + 1)")
+                                    .frame(maxWidth: .infinity, alignment: .leading)
+                            }
+                            MoMoUIKits.Button(title: "Close", action: { navigator.hideOverplay() }, type: .primary, size: .large)
+                        }
+                        .padding(Spacing.L)
+                    }, isSurface: true, barrierDismissible: true, header: .title("Bottom Sheet"), onDismiss: { print("Bottom Sheet dismissed") })
+                }
+
+                row("Show Snack Bar") {
+                    navigator.showSnackBar(.custom(duration: 2.0) {
+                        HStack {
+                            MomoText("Snack bar !!!", color: Colors.black01)
+                            Spacer()
+                        }
+                        .padding(.horizontal, 20)
+                        .frame(height: 56)
+                        .frame(maxWidth: .infinity)
+                        .background(Colors.black17)
+                        .clipShape(RoundedRectangle(cornerRadius: Radius.M))
+                        .padding(.horizontal, Spacing.M)
+                    })
+                }
+
+                Divider().padding(.vertical, 4)
+
+                row("Prevent Back") {
+                    // Tapping the header back button shows a confirm popup before
+                    // leaving (mirrors Compose's headerBackProps.preventBack).
+                    navigator.push(
+                        { DemoLeafScreen(title: "Tap the header back button", color: Colors.pink09) },
+                        options: NavigationOptions(
+                            title: "Prevent Back",
+                            headerBackProps: HeaderBackProps(
+                                preventBack: PreventBackProps(
+                                    title: "Leave this screen?",
+                                    description: "Your changes won't be saved.",
+                                    primary: PopupAction(title: "Leave", onPress: { print("left") }),
+                                    secondary: PopupAction(title: "Stay")
+                                )
+                            )
+                        )
+                    )
+                }
+
+                row("Header User Title") {
+                    navigator.push(
+                        { HeaderUserDemoContent() },
+                        options: NavigationOptions(
+                            headerTitle: .user(
+                                HeaderUserData(
+                                    title: "Nguyen Van A",
+                                    subTitle: "0900 000 000",
+                                    image: ["https://images.unsplash.com/photo-1599566150163-29194dcaad36"],
+                                    dotColor: Colors.primary,
+                                    icons: ["https://static.momocdn.net/app/img/kits/verified.png"]
+                                )
+                            )
+                        )
+                    )
+                }
+
+                row("Header Animated") {
+                    navigator.push(
+                        { AnimatedHeaderDemoContent() },
+                        options: NavigationOptions(title: "Animated Header")
+                    )
+                }
+
+                row("Bottom Tabs") {
+                    navigator.push(
+                        { BottomTabDemoContent() },
+                        // Parent screen has no chrome; each tab renders its own
+                        // header (mirrors Compose setting parent headerType = None).
+                        options: NavigationOptions(headerType: .none, scrollable: false)
+                    )
+                }
+            }
+            .padding(16)
+        }
+    }
+
+    @ViewBuilder
+    private func row(_ title: String, action: @escaping () -> Void) -> some View {
+        MoMoUIKits.Button(title: title, action: action, size: .large)
+    }
+}
+
+// MARK: - Leaf / presented screens
+
+@available(iOS 16.0, *)
+private struct DemoLeafScreen: View {
+    @EnvironmentObject private var navigator: Navigator
+    let title: String
+    let color: Color
+
+    var body: some View {
+        VStack(spacing: 16) {
+            MomoText(title, typography: .headerDefaultBold)
+            MoMoUIKits.Button(title: "Go back", action: { navigator.pop() }, type: .primary, size: .large)
+        }
+        .frame(maxWidth: .infinity)
+        .padding(24)
+        .background(color)
+        .clipShape(RoundedRectangle(cornerRadius: Radius.L))
+        .padding(16)
+    }
+}
+
+@available(iOS 16.0, *)
+private struct ResetTargetScreen: View {
+    @EnvironmentObject private var navigator: Navigator
+
+    var body: some View {
+        VStack(spacing: 16) {
+            MomoText("Stack was reset — this is the new root.", typography: .headerDefaultBold)
+            // `reset` again to re-root back into the navigation demo.
+            MoMoUIKits.Button(
+                title: "Back to Navigation demo",
+                action: {
+                    navigator.reset(
+                        { NavigationDemoContent() },
+                        options: NavigationOptions(title: "Navigation")
+                    )
+                },
+                type: .primary,
+                size: .large
+            )
+        }
+        .frame(maxWidth: .infinity)
+        .padding(24)
+    }
+}
+
+@available(iOS 16.0, *)
+private struct PresentedScreen: View {
+    @EnvironmentObject private var navigator: Navigator
+
+    var body: some View {
+        VStack(spacing: 16) {
+            MomoText("Presented modally (slides up)", typography: .headerDefaultBold)
+            MoMoUIKits.Button(title: "Dismiss", action: { navigator.dismiss() }, type: .primary, size: .large)
+        }
+        .padding(24)
+    }
+}
+
+#if DEBUG
+struct NavigationDemo_Previews: PreviewProvider {
+    static var previews: some View { NavigationDemo() }
+}
+#endif

package/ios-demo/Sources/MoMoUIKitsDemo/SampleDemos/PaginationDemo.swift

@@ -0,0 +1,72 @@
+//
+//  PaginationDemo.swift
+//  Example
+//
+//  Combined demo for the four pagination variants.
+//  Mirrors shared PaginationUsage.kt: a configurable Data Length plus
+//  Prev/Next controls drive PaginationScroll, PaginationNumber,
+//  PaginationDot and PaginationWhiteDot.
+//
+
+import MoMoUIKits
+import SwiftUI
+
+struct PaginationDemo: View {
+    @State private var dataLengthText: String = "3"
+    @State private var activeIndex: Int = 0
+
+    private var dataLength: Int {
+        let n = Int(dataLengthText) ?? 1
+        return max(n, 1)
+    }
+
+    var body: some View {
+        ScrollView {
+            VStack(alignment: .center, spacing: Spacing.L) {
+                PaginationScroll {
+                    ForEach(0..<10, id: \.self) { i in
+                        MomoText("\(i)", typography: .bodyDefaultRegular)
+                            .frame(width: 120, height: 60)
+                            .background(Colors.blue08)
+                            .overlay(
+                                Rectangle().stroke(Colors.black06, lineWidth: 1)
+                            )
+                    }
+                }
+
+                PaginationNumber(activeIndex: activeIndex, dataLength: dataLength)
+
+                PaginationDot(activeIndex: activeIndex, dataLength: dataLength)
+
+                PaginationWhiteDot(activeIndex: activeIndex, dataLength: dataLength)
+                    .padding(Spacing.S)
+                    .background(Colors.black17) // dark backdrop so white dots are visible
+
+                MomoText("Data Length", typography: .labelSMedium, color: Colors.textSecondary)
+                TextField("Data Length", text: $dataLengthText)
+                    .keyboardType(.numberPad)
+                    .textFieldStyle(.roundedBorder)
+                    .onChange(of: dataLengthText) { _ in activeIndex = 0 }
+                    .frame(maxWidth: 200)
+
+                HStack {
+                    Button("Prev") {
+                        if activeIndex != 0 { activeIndex -= 1 }
+                    }
+                    .frame(maxWidth: .infinity)
+
+                    Button("Next") {
+                        if activeIndex != dataLength - 1 { activeIndex += 1 }
+                    }
+                    .frame(maxWidth: .infinity)
+                }
+            }
+            .padding(Spacing.L)
+        }
+        .background(Colors.background)
+    }
+}
+
+#Preview {
+    PaginationDemo()
+}

package/ios-demo/Sources/MoMoUIKitsDemo/SampleDemos/PopupDisplayDemo.swift

@@ -0,0 +1,175 @@
+//
+//  PopupDisplayDemo.swift
+//  Example
+//
+//  Usage demo for PopupDisplay component.
+//  Mirrors Compose's PopupNotifyUsage: a configurable form whose action
+//  button presents the popup through `navigator.showModal`.
+//
+
+import MoMoUIKits
+import SwiftUI
+
+// MARK: - PopupDisplayDemo
+
+struct PopupDisplayDemo: View {
+    var body: some View {
+        if #available(iOS 16.0, *) {
+            PopupDisplayDemoContent()
+        } else {
+            Text("PopupDisplay demo requires iOS 16+")
+                .padding()
+        }
+    }
+}
+
+// MARK: - PopupDisplayDemoContent
+
+@available(iOS 16.0, *)
+private struct PopupDisplayDemoContent: View {
+    @EnvironmentObject private var navigator: Navigator
+
+    @State private var image = "https://static.momocdn.net/app/img/popup_permission/img_permission_popup_camera.png"
+    @State private var title = "Title"
+    @State private var description = "Check lại một nhịp auto chuyển sang dạng CTA."
+    @State private var errorCode = "9004"
+    @State private var buttonDirection: PopupButtonDirection = .auto
+    @State private var primaryTitle = "Primary"
+    @State private var secondaryTitle = "Secondary"
+    @State private var showCloseIcon = false
+
+    var body: some View {
+        ScrollView {
+            VStack(alignment: .leading, spacing: 12) {
+                // MARK: - Image URL
+
+                HStack(alignment: .center, spacing: 8) {
+                    Input(
+                        text: $image,
+                        placeholder: "Image URL",
+                        floatingValue: "Image URL"
+                    )
+                    Checkbox(
+                        Binding(
+                            get: { image.isEmpty },
+                            set: { checked in
+                                image = checked ? "" : "https://static.momocdn.net/app/img/popup_permission/img_permission_popup_camera.png"
+                            }
+                        ),
+                        title: "undefined"
+                    )
+                }
+
+                // MARK: - Title
+
+                Input(
+                    text: $title,
+                    placeholder: "Title",
+                    floatingValue: "Title"
+                )
+
+                // MARK: - Description
+
+                Input(
+                    text: $description,
+                    placeholder: "Description",
+                    floatingValue: "Description"
+                )
+
+                // MARK: - Error code
+
+                HStack(alignment: .center, spacing: 8) {
+                    Input(
+                        text: $errorCode,
+                        placeholder: "Error",
+                        floatingValue: "Error"
+                    )
+                    Checkbox(
+                        Binding(
+                            get: { errorCode.isEmpty },
+                            set: { checked in
+                                errorCode = checked ? "" : "9004"
+                            }
+                        ),
+                        title: "undefined"
+                    )
+                }
+
+                // MARK: - Button direction
+
+                VStack(alignment: .leading, spacing: 6) {
+                    Text("Button Direction")
+                        .font(.caption)
+                        .foregroundColor(.secondary)
+                    Picker("Button Direction", selection: $buttonDirection) {
+                        Text("Auto").tag(PopupButtonDirection.auto)
+                        Text("Row").tag(PopupButtonDirection.row)
+                        Text("Column").tag(PopupButtonDirection.column)
+                    }
+                    .pickerStyle(.segmented)
+                }
+
+                // MARK: - Button titles
+
+                Input(
+                    text: $primaryTitle,
+                    placeholder: "Primary Button Title",
+                    floatingValue: "Primary Button Title"
+                )
+                Input(
+                    text: $secondaryTitle,
+                    placeholder: "Secondary Button Title",
+                    floatingValue: "Secondary Button Title"
+                )
+
+                // MARK: - Show close icon
+
+                Checkbox($showCloseIcon, title: "Show Close Button")
+                    .padding(.vertical, 4)
+
+                // MARK: - Action
+
+                Button(
+                    title: "Show popup",
+                    action: showPopup,
+                    type: .primary,
+                    size: .large
+                )
+                .padding(.top, 8)
+            }
+            .padding(16)
+        }
+    }
+
+    // MARK: - Helpers
+
+    private func showPopup() {
+        navigator.showModal {
+            PopupDisplay(
+                isPresented: .constant(true),
+                title: title,
+                description: description,
+                url: image,
+                buttonDirection: buttonDirection,
+                buttonType: .button,
+                actionButtonTitle: primaryTitle,
+                closeButtonTitle: secondaryTitle,
+                onPressAction: { navigator.hideOverplay() },
+                onPressCloseButton: { navigator.hideOverplay() },
+                onClose: { navigator.hideOverplay() },
+                errorCode: errorCode,
+                isShowCloseIcon: showCloseIcon
+            )
+        }
+    }
+}
+
+// MARK: - Preview
+
+#if DEBUG
+struct PopupDisplayDemo_Previews: PreviewProvider {
+    static var previews: some View {
+        PopupDisplayDemo()
+    }
+}
+#endif