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

package/ios/Application/Navigation/HeaderBackProps.swift

@@ -1,66 +0,0 @@
-//
-//  HeaderBackProps.swift
-//  MoMoUIKits
-//
-//  SwiftUI mirror of Compose's `HeaderBackProps` + `PopupNotifyProps`/`PopupAction`.
-//  When `preventBack` is set, `Navigator.onBackSafe` shows a confirm popup
-//  before actually leaving the screen — same behavior as Compose.
-//
-
-import SwiftUI
-
-/// Mirrors Compose's `PopupAction` (a titled button with an optional handler).
-public struct PopupAction {
-    public let title: String
-    public let onPress: (() -> Void)?
-
-    public init(title: String, onPress: (() -> Void)? = nil) {
-        self.title = title
-        self.onPress = onPress
-    }
-}
-
-/// Mirrors Compose's `PopupNotifyProps` as consumed by `headerBackProps.preventBack`.
-public struct PreventBackProps {
-    public var image: String
-    public var title: String
-    public var description: String
-    public var error: String
-    public var primary: PopupAction?
-    public var secondary: PopupAction?
-    public var buttonDirection: PopupButtonDirection
-    public var isShowCloseIcon: Bool
-    public var onIconClose: (() -> Void)?
-
-    public init(
-        image: String = "",
-        title: String = "",
-        description: String = "",
-        error: String = "",
-        primary: PopupAction? = nil,
-        secondary: PopupAction? = nil,
-        buttonDirection: PopupButtonDirection = .row,
-        isShowCloseIcon: Bool = true,
-        onIconClose: (() -> Void)? = nil
-    ) {
-        self.image = image
-        self.title = title
-        self.description = description
-        self.error = error
-        self.primary = primary
-        self.secondary = secondary
-        self.buttonDirection = buttonDirection
-        self.isShowCloseIcon = isShowCloseIcon
-        self.onIconClose = onIconClose
-    }
-}
-
-/// Mirrors Compose's `HeaderBackProps`.
-public struct HeaderBackProps {
-    /// When non-nil, a confirm popup is shown before the back navigation runs.
-    public var preventBack: PreventBackProps?
-
-    public init(preventBack: PreventBackProps? = nil) {
-        self.preventBack = preventBack
-    }
-}

package/ios/Application/Navigation/HeaderTitle.swift

@@ -1,57 +0,0 @@
-//
-//  HeaderTitle.swift
-//  MoMoUIKits
-//
-//  SwiftUI mirror of Compose's `sealed class HeaderTitle` (navigation/component/Header.kt).
-//  The header can show either a plain title (`.default`) or a rich "user" title
-//  with an avatar group, subtitle, inline icons and a status dot (`.user`).
-//  (Compose's `Location`/`Journey` variants are not rendered yet, so they are
-//  omitted here for parity with the implemented `HeaderUser`.)
-//
-
-import SwiftUI
-
-/// Data backing a `.user` header title (mirrors `HeaderTitle.User`).
-public struct HeaderUserData {
-    public var title: String
-    public var subTitle: String?
-    public var image: [String]?
-    public var dotColor: Color?
-    public var tintColor: Color?
-    public var onPress: (() -> Void)?
-    public var icons: [String]
-    public var isLoading: Bool
-
-    public init(
-        title: String,
-        subTitle: String? = nil,
-        image: [String]? = nil,
-        dotColor: Color? = nil,
-        tintColor: Color? = nil,
-        onPress: (() -> Void)? = nil,
-        icons: [String] = [],
-        isLoading: Bool = false
-    ) {
-        self.title = title
-        self.subTitle = subTitle
-        self.image = image
-        self.dotColor = dotColor
-        self.tintColor = tintColor
-        self.onPress = onPress
-        self.icons = icons
-        self.isLoading = isLoading
-    }
-}
-
-/// Mirrors Compose's `HeaderTitle` sealed class.
-public enum HeaderTitle {
-    case `default`(String)
-    case user(HeaderUserData)
-
-    /// Plain title text, when this is a `.default` title (used by the legacy
-    /// string-based `Header`/`NavigationOptions` paths).
-    public var defaultTitle: String? {
-        if case let .default(text) = self { return text }
-        return nil
-    }
-}

package/ios/Application/Navigation/NavigationContainer.swift

@@ -1,213 +0,0 @@
-//
-//  NavigationContainer.swift
-//  MoMoUIKits
-//
-//  SwiftUI mirror of Compose's NavigationContainer.
-//  Wraps NavigationStack, injects Navigator into the environment, and renders
-//  every registered screen inside `Screen(options)` chrome — same auto-wrap
-//  behavior as Compose's StackScreen.
-//
-
-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,
-            composeApi: composeApi
-        )
-        _navigator = StateObject(wrappedValue: nav)
-        _applicationEnvironment = StateObject(
-            wrappedValue: ApplicationEnvironment(
-                applicationContext: applicationContext,
-                composeApi: composeApi,
-                config: config,
-                maxApi: maxApi
-            )
-        )
-        // AI-GENERATED START: default to the app-language-observing shared Localize
-        _localize = StateObject(wrappedValue: localize ?? Localize.shared)
-        // AI-GENERATED END: default to the app-language-observing shared Localize
-        self.composeApi = composeApi
-        self.maxApi = maxApi
-        self.setNavigator = setNavigator
-    }
-
-    public var body: some View {
-        NavigationStack(path: $navigator.path) {
-            screenView(for: navigator.rootRoute)
-                .navigationDestination(for: DynamicScreenRoute.self) { route in
-                    screenView(for: route)
-                }
-        }
-        .environmentObject(navigator)
-        .environmentObject(applicationEnvironment)
-        .environment(\.applicationEnvironment, applicationEnvironment)
-        // AI-GENERATED START: route Localize + font-scale injection through the observing modifiers
-        .momoLocalize(localize)
-        .momoFontScale(context: applicationEnvironment.applicationContext)
-        // AI-GENERATED END: route Localize + font-scale injection through the observing modifiers
-        .fullScreenCover(item: $navigator.presented) { route in
-            screenView(forDialog: route)
-                .environmentObject(navigator)
-                .environmentObject(applicationEnvironment)
-                .environment(\.applicationEnvironment, applicationEnvironment)
-                // AI-GENERATED START: route Localize + font-scale injection through the observing modifiers
-                .momoLocalize(localize)
-                .momoFontScale(context: applicationEnvironment.applicationContext)
-                // AI-GENERATED END: route Localize + font-scale injection through the observing modifiers
-        }
-        .overlay {
-            if let item = navigator.overplay {
-                OverplayHost(item: item)
-                    .environmentObject(navigator)
-                    .environmentObject(applicationEnvironment)
-                    .environment(\.applicationEnvironment, applicationEnvironment)
-                    // AI-GENERATED START: route Localize + font-scale injection through the observing modifiers
-                    .momoLocalize(localize)
-                    .momoFontScale(context: applicationEnvironment.applicationContext)
-                    // AI-GENERATED END: route Localize + font-scale injection through the observing modifiers
-            }
-        }
-        .onAppear {
-            if navigator.composeApi == nil {
-                navigator.composeApi = composeApi
-            }
-            setNavigator?(navigator)
-            // Register with the host swipe-back bridge (mirrors ComposeAppContainer's
-            // ComposeNavigatorManager.push). Idempotent, so a re-appear won't double-count.
-            NavigatorManager.shared.push(navigator)
-            // AI-GENERATED START: demote the MaxApi language pull to a seed of last resort
-            // Only a seed: a Localize with a language source already tracks the host in both
-            // directions, so asking maxApi would just race it. `changeLanguage` normalizes the
-            // raw response and hops to main itself.
-            guard !localize.observesAppLanguage else { return }
-            maxApi?.getLanguage { data in
-                localize.changeLanguage(data?["response"] as? String)
-            }
-            // AI-GENERATED END: demote the MaxApi language pull to a seed of last resort
-        }
-        .onDisappear {
-            NavigatorManager.shared.remove(navigator)
-        }
-    }
-
-    @ViewBuilder
-    private func screenView(for route: DynamicScreenRoute) -> some View {
-        if let screen = navigator.registry.getScreen(id: route.id) {
-            ScreenHost(screen: screen, navigator: navigator)
-                .navigationBarBackButtonHidden(true)
-        } else {
-            EmptyView()
-        }
-    }
-
-    @ViewBuilder
-    private func screenView(forDialog route: DynamicDialogRoute) -> some View {
-        if let screen = navigator.registry.getScreen(id: route.id) {
-            ScreenHost(screen: screen, navigator: navigator)
-        } else {
-            EmptyView()
-        }
-    }
-}
-
-// MARK: - ScreenHost
-
-@available(iOS 16.0, *)
-private struct ScreenHost: View {
-    let screen: DynamicScreen
-    let navigator: Navigator
-
-    var body: some View {
-        let options = screen.options ?? NavigationOptions()
-        StackScreen(
-            backgroundColor: options.backgroundColor,
-            headerTransparent: options.headerTransparent,
-            fullScreenContent: options.fullScreenContent,
-            tintColor: options.tintColor ?? Colors.black17,
-            isBack: !options.hiddenBack,
-            headerType: options.headerType,
-            useAnimated: options.useAnimated,
-            title: options.title,
-            headerTitle: options.headerTitle,
-            titlePosition: options.titlePosition,
-            goBack: options.hiddenBack ? nil : { navigator.onBackSafe() },
-            scrollable: options.scrollable,
-            scrollToTopCallback: options.scrollToTopCallback,
-            useAvoidKeyboard: options.useAvoidKeyboard,
-            keyboardShouldPersistTaps: options.keyboardShouldPersistTaps,
-            footer: options.footer,
-            headerRight: options.resolvedHeaderRight,
-            animatedHeader: options.animatedHeader,
-            layoutOffset: options.layoutOffset,
-            inputSearchProps: options.inputSearchProps,
-            fabProps: options.fabProps,
-            screenName: screen.name,
-            content: { screen.content() }
-        )
-    }
-}
-
-// MARK: - Overplay host
-
-@available(iOS 16.0, *)
-private struct OverplayHost: View {
-    let item: OverplayItem
-    @EnvironmentObject var navigator: Navigator
-
-    var body: some View {
-        // Each component self-animates on appear and drives its own exit through
-        // the Navigator before the item is removed (mirrors Compose's overplay).
-        switch item.type {
-        case .modal:
-            ModalScreen(barrierDismissible: item.barrierDismissible) {
-                item.content()
-            }
-            .id(item.id)
-        case .bottomSheet:
-            BottomSheetView(
-                header: item.header ?? .title(),
-                isSurface: item.isSurface,
-                barrierDismissible: item.barrierDismissible
-            ) {
-                item.content()
-            }
-            .id(item.id)
-        case .snackBar:
-            if let snackBar = item.snackBar {
-                SnackBarView(snackBar: snackBar, bottomInset: safeAreaBottomInset() + Spacing.S)
-                    .id(item.id)
-            }
-        }
-    }
-}
-
-/// Bottom safe-area inset (home indicator), used to lift the snack bar.
-@available(iOS 16.0, *)
-private func safeAreaBottomInset() -> CGFloat {
-    UIApplication.shared.connectedScenes
-        .compactMap { ($0 as? UIWindowScene)?.keyWindow?.safeAreaInsets.bottom }
-        .first ?? 0
-}

package/ios/Application/Navigation/NavigationOptions.swift

@@ -1,109 +0,0 @@
-//
-//  NavigationOptions.swift
-//  MoMoUIKits
-//
-//  SwiftUI mirror of Compose's NavigationOptions.
-//  Each option lines up with a parameter on the existing `Screen` view,
-//  so NavigationContainer can auto-wrap a registered screen body in `Screen(options)`.
-//
-
-import SwiftUI
-
-public struct NavigationOptions {
-    public var screenName: String?
-    public var title: String
-    /// Rich header title (mirrors Compose's `headerTitle`). When set to `.user`
-    /// the header renders an avatar group instead of `title`; `.default` keeps
-    /// the plain `title` text.
-    public var headerTitle: HeaderTitle?
-    public var titlePosition: TitlePosition
-    public var headerType: HeaderType
-    /// Mirrors Compose's `HeaderType.Extended/Default(useAnimated = ...)`: when true
-    /// and `inputSearchProps` is set, the search bar animates into the header on scroll.
-    public var useAnimated: Bool
-    public var headerTransparent: Bool
-    public var fullScreenContent: Bool
-    public var hiddenBack: Bool
-    public var backgroundColor: Color?
-    public var tintColor: Color?
-    public var scrollable: Bool
-    /// Mirrors Compose's `ScrollData.scrollToTopCallback`: invoked when the
-    /// screen is asked to scroll to top (e.g. on a status-bar tap).
-    public var scrollToTopCallback: (() -> Void)?
-    public var useAvoidKeyboard: Bool
-    /// Mirrors Compose's `KeyboardOptions.keyboardShouldPersistTaps`: when true,
-    /// tapping anywhere on the screen dismisses the keyboard.
-    public var keyboardShouldPersistTaps: Bool
-    /// Mirrors Compose's `HeaderBackProps`: drives the prevent-back confirm popup.
-    public var headerBackProps: HeaderBackProps?
-    /// Typed toolkit data for the default header right control (mirrors
-    /// Compose's `HeaderRight.Toolkit`). Use `headerRight` for `.custom` and nil
-    /// for `.none`.
-    public var headerRightData: HeaderRightData?
-    public var headerRight: (() -> any View)?
-    public var footer: (() -> AnyView)?
-    public var animatedHeader: AnimatedHeader?
-    public var layoutOffset: CGFloat
-    public var inputSearchProps: InputSearchProps?
-    public var fabProps: FabProps?
-    public var onBackHandler: (() -> Void)?
-
-    public init(
-        screenName: String? = nil,
-        title: String = "Stack",
-        headerTitle: HeaderTitle? = nil,
-        titlePosition: TitlePosition = .left,
-        headerType: HeaderType = .default,
-        useAnimated: Bool = false,
-        headerTransparent: Bool = false,
-        fullScreenContent: Bool = false,
-        hiddenBack: Bool = false,
-        backgroundColor: Color? = nil,
-        tintColor: Color? = Colors.black17,
-        scrollable: Bool = true,
-        scrollToTopCallback: (() -> Void)? = nil,
-        useAvoidKeyboard: Bool = true,
-        keyboardShouldPersistTaps: Bool = false,
-        headerBackProps: HeaderBackProps? = nil,
-        headerRightData: HeaderRightData? = nil,
-        headerRight: (() -> any View)? = { HeaderRight() },
-        footer: (() -> AnyView)? = nil,
-        animatedHeader: AnimatedHeader? = nil,
-        layoutOffset: CGFloat = 56,
-        inputSearchProps: InputSearchProps? = nil,
-        fabProps: FabProps? = nil,
-        onBackHandler: (() -> Void)? = nil
-    ) {
-        self.screenName = screenName
-        self.title = title
-        self.headerTitle = headerTitle
-        self.titlePosition = titlePosition
-        self.headerType = headerType
-        self.useAnimated = useAnimated
-        self.headerTransparent = headerTransparent
-        self.fullScreenContent = fullScreenContent
-        self.hiddenBack = hiddenBack
-        self.backgroundColor = backgroundColor
-        self.tintColor = tintColor
-        self.scrollable = scrollable
-        self.scrollToTopCallback = scrollToTopCallback
-        self.useAvoidKeyboard = useAvoidKeyboard
-        self.keyboardShouldPersistTaps = keyboardShouldPersistTaps
-        self.headerBackProps = headerBackProps
-        self.headerRightData = headerRightData
-        self.headerRight = headerRight
-        self.footer = footer
-        self.animatedHeader = animatedHeader
-        self.layoutOffset = layoutOffset
-        self.inputSearchProps = inputSearchProps
-        self.fabProps = fabProps
-        self.onBackHandler = onBackHandler
-    }
-}
-
-extension NavigationOptions {
-    var resolvedHeaderRight: (() -> any View)? {
-        guard let headerRightData else { return headerRight }
-        return { HeaderRight(headerRight: headerRightData, tintColor: tintColor) }
-    }
-}

package/ios/Application/Navigation/NavigatorManager.swift

@@ -1,22 +0,0 @@
-import Foundation
-
-@available(iOS 16.0, *)
-public final class NavigatorManager {
-    public static let shared = NavigatorManager()
-    private init() {}
-
-    private var navigators: [Navigator] = []
-
-    public func push(_ navigator: Navigator) {
-        guard !navigators.contains(where: { $0 === navigator }) else { return }
-        navigators.append(navigator)
-    }
-
-    public func remove(_ navigator: Navigator) {
-        navigators.removeAll { $0 === navigator }
-    }
-
-    public func checkCanPop() -> Bool { !navigators.isEmpty }
-
-    public func pop() { navigators.last?.onBackSafe() }
-}

package/ios/Application/Navigation/component/Header.swift

@@ -1,178 +0,0 @@
-//
-//  Header.swift
-//  MoMoUIKits
-//
-//  SwiftUI mirror of Compose's `Header` (navigation/component/Header.kt).
-//  Renders the 52pt header bar: a circular back button (colors resolved via
-//  `getHeaderColor`), the title area (`HeaderContent` → plain title, user title
-//  or inline search), the header-right toolkit, and a scroll-triggered bottom
-//  shadow. The header band background itself is painted by `HeaderBackground`.
-//
-//  Named `NavigationHeader` to coexist with the legacy `Header` in
-//  `Components.swift` (kept as-is, used as a package elsewhere; to be marked
-//  deprecated later). Used by the new `StackScreen` navigation path.
-//
-
-import SwiftUI
-
-public struct NavigationHeader: View {
-    var headerType: HeaderType = .default
-    var titlePosition: TitlePosition
-    var title: String
-    /// Optional rich title (mirrors Compose's `HeaderTitle`); `.user` renders an
-    /// avatar group, `.default`/nil renders plain `title`.
-    var headerTitle: HeaderTitle?
-    var headerRight: (() -> any View)? = { NavigationHeaderRight() }
-    var goBack: (() -> Void)?
-    var opacity: CGFloat = 1
-    var animatedHeader: AnimatedHeader?
-    var scrollState: CGFloat = 0
-    var inputSearchProps: InputSearchProps?
-    var tintColor: Color?
-    /// Title opacity; used by the animated search header to fade the title out on scroll.
-    var titleOpacity: CGFloat = 1
-
-    public init(
-        headerType: HeaderType = .default,
-        titlePosition: TitlePosition,
-        title: String,
-        headerTitle: HeaderTitle? = nil,
-        headerRight: (() -> any View)? = { HeaderRight() },
-        goBack: (() -> Void)? = nil,
-        opacity: CGFloat = 1,
-        animatedHeader: AnimatedHeader? = nil,
-        scrollState: CGFloat = 0,
-        inputSearchProps: InputSearchProps? = nil,
-        tintColor: Color? = nil,
-        titleOpacity: CGFloat = 1
-    ) {
-        self.headerType = headerType
-        self.titlePosition = titlePosition
-        self.title = title
-        self.headerTitle = headerTitle
-        self.headerRight = headerRight
-        self.goBack = goBack
-        self.opacity = opacity
-        self.animatedHeader = animatedHeader
-        self.scrollState = scrollState
-        self.inputSearchProps = inputSearchProps
-        self.tintColor = tintColor
-        self.titleOpacity = titleOpacity
-    }
-
-    private var isAnimated: Bool { animatedHeader != nil }
-    private var isSurface: Bool { animatedHeader?.isSurface ?? true }
-
-    private var headerColor: HeaderColor {
-        getHeaderColor(isAnimated: isAnimated, isSurface: isSurface, opacity: opacity, tintColor: tintColor)
-    }
-
-    /// Centered title needs a full-width overlay to stay screen-centered, not
-    /// boxed between the back button and the header-right (mirrors Compose).
-    private var centerTitle: Bool {
-        guard inputSearchProps == nil else { return false }
-        let isDefault = headerTitle == nil || headerTitle?.defaultTitle != nil
-        return titlePosition == .center && isDefault
-    }
-
-    public var body: some View {
-        if headerType != .none {
-            ZStack {
-                HStack(spacing: 0) {
-                    if let goBack {
-                        BackButton(color: headerColor, onBack: goBack)
-                        Spacer().frame(width: Spacing.S)
-                    }
-
-                    if centerTitle {
-                        Spacer()
-                    } else {
-                        titleArea(centered: false)
-                            .frame(maxWidth: .infinity, alignment: .leading)
-                    }
-
-                    if let headerRight {
-                        AnyView(headerRight())
-                            .background(
-                                GeometryReader { geo in
-                                    Color.clear.preference(key: HeaderRightWidthKey.self, value: geo.size.width)
-                                }
-                            )
-                    }
-                }
-                .padding(.horizontal, Spacing.M)
-
-                if centerTitle {
-                    titleArea(centered: true)
-                        .padding(.horizontal, Spacing.M)
-                }
-            }
-            .frame(height: HEADER_HEIGHT)
-            .overlay(alignment: .bottom) { VerticalShadow(opacity: opacity) }
-        }
-    }
-
-    /// Mirrors Compose's `HeaderContent`: plain title, user title, or — when a
-    /// header search is active — the inline search field.
-    @ViewBuilder
-    private func titleArea(centered: Bool) -> some View {
-        if let inputSearchProps {
-            InputSearch(props: inputSearchProps)
-        } else if case let .user(userData)? = headerTitle {
-            if #available(iOS 16.0, *) {
-                HeaderUserView(userData)
-            }
-        } else {
-            MomoText(
-                headerTitle?.defaultTitle ?? title,
-                typography: .actionSBold,
-                color: headerColor.tintIconColor,
-                textAlign: centered ? .center : .leading,
-                maxLines: 1
-            )
-                .opacity(titleOpacity)
-                .truncationMode(.tail)
-                .frame(maxWidth: centered ? .infinity : nil, alignment: centered ? .center : .leading)
-        }
-    }
-}
-
-// MARK: - Back button
-
-/// Mirrors Compose's `BackButton`: a 28pt circular control with the back arrow.
-private struct BackButton: View {
-    let color: HeaderColor
-    let onBack: () -> Void
-
-    var body: some View {
-        SwiftUI.Button(action: onBack) {
-            Circle()
-                .fill(color.backgroundButton)
-                .overlay(Circle().stroke(color.borderColor, lineWidth: 0.2))
-                .frame(width: 28, height: 28)
-                .overlay(Icon(source: "arrow-back", size: 20, color: color.tintIconColor))
-        }
-        .buttonStyle(.plain)
-    }
-}
-
-// MARK: - Vertical shadow
-
-/// Mirrors Compose's `VerticalShadow`: a 6pt drop shadow under the header that
-/// only appears once the header is fully opaque (scrolled).
-private struct VerticalShadow: View {
-    let opacity: CGFloat
-
-    var body: some View {
-        if opacity >= 1 {
-            LinearGradient(
-                gradient: Gradient(colors: [Color.black.opacity(0.05), .clear]),
-                startPoint: .top,
-                endPoint: .bottom
-            )
-            .frame(height: 6)
-            .frame(maxWidth: .infinity)
-            .offset(y: 6)
-        }
-    }
-}