@momo-kits/native-kits 0.162.44 → 0.162.45-debug

package/ios/Template/TrustBanner/TrustBanner.swift

@@ -12,14 +12,14 @@ import SDWebImageSwiftUI
 let jsonUrl = "https://static.momocdn.net/app/json/component-kits/design_system.json"
 
 public struct TrustBannerData: Decodable {
-    let content: [String: String]
-    let subContent: [String: String]
-    let pciImage: String
-    let sslImage: String
-    let urlConfig: String
-    let icons: [String]
-    let momoImage: String
-    
+    public let content: [String: String]
+    public let subContent: [String: String]
+    public let pciImage: String?
+    public let momoImage: String?
+    public let sslImage: String?
+    public let icons: [String]?
+    public let urlConfig: String
+
     enum CodingKeys: String, CodingKey {
         case content
         case subContent
@@ -29,6 +29,38 @@ public struct TrustBannerData: Decodable {
         case momoImage
         case urlConfig = "url_config"
     }
+
+    public init(
+        content: [String: String] = ["vi": "", "en": ""],
+        subContent: [String: String] = ["vi": "", "en": ""],
+        pciImage: String? = nil,
+        momoImage: String? = nil,
+        sslImage: String? = nil,
+        icons: [String]? = nil,
+        urlConfig: String = ""
+    ) {
+        self.content = content
+        self.subContent = subContent
+        self.pciImage = pciImage
+        self.momoImage = momoImage
+        self.sslImage = sslImage
+        self.icons = icons
+        self.urlConfig = urlConfig
+    }
+
+    // Missing keys fall back to the init defaults, like the Compose data class.
+    public init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        self.init(
+            content: try container.decodeIfPresent([String: String].self, forKey: .content) ?? ["vi": "", "en": ""],
+            subContent: try container.decodeIfPresent([String: String].self, forKey: .subContent) ?? ["vi": "", "en": ""],
+            pciImage: try container.decodeIfPresent(String.self, forKey: .pciImage),
+            momoImage: try container.decodeIfPresent(String.self, forKey: .momoImage),
+            sslImage: try container.decodeIfPresent(String.self, forKey: .sslImage),
+            icons: try container.decodeIfPresent([String].self, forKey: .icons),
+            urlConfig: try container.decodeIfPresent(String.self, forKey: .urlConfig) ?? ""
+        )
+    }
 }
 
 let defaultBanner = TrustBannerData(
@@ -38,16 +70,16 @@ let defaultBanner = TrustBannerData(
         "vi": "Tìm hiểu thêm",
         "en": "Learn more"
     ],
-    pciImage: "https://static.momocdn.net/app/img/kits/trustBanner/pci.png",
+    pciImage: "https://static.momocdn.net/app/img/kits/trustBanner/pci_dss.png",
+    momoImage: "https://static.momocdn.net/app/img/kits/trustBanner/ic_secu.png",
     sslImage: "https://static.momocdn.net/app/img/kits/trustBanner/ssl.png",
-    urlConfig: "login_and_security",
     icons: [
         "https://static.momocdn.net/app/img/kits/trustBanner/ic_viettinbank.png",
         "https://static.momocdn.net/app/img/kits/trustBanner/ic_agribank.png",
         "https://static.momocdn.net/app/img/kits/trustBanner/ic_vietcombank.png",
         "https://static.momocdn.net/app/img/kits/trustBanner/ic_bidv.png"
     ],
-    momoImage: "https://static.momocdn.net/app/img/kits/trustBanner/ic_secu.png"
+    urlConfig: "login_and_security"
 )
 
 public struct TrustBanner: View {
@@ -55,66 +87,86 @@ public struct TrustBanner: View {
     @Environment(\.localize) private var localize
 
     var onPress: ((String)->Void)?
+    private let serviceName: String
+    private let screenName: String
+    private let trackEvent: ((String, [String: String]) -> Void)?
 
-    public init(onPress: ((String)->Void)?) {
+    public init(
+        onPress: ((String)->Void)?,
+        serviceName: String = "",
+        screenName: String = "",
+        trackEvent: ((String, [String: String]) -> Void)? = nil
+    ) {
         self.onPress = onPress
+        self.serviceName = serviceName
+        self.screenName = screenName
+        self.trackEvent = trackEvent
+    }
+
+    private var banner: TrustBannerData {
+        applicationEnvironment.config?.trustBanner ?? defaultBanner
     }
 
     func onPressSecurity() {
-        if (onPress != nil) {
-            onPress!(applicationEnvironment.config?.trustBanner?.urlConfig ?? defaultBanner.urlConfig)
-        }
+        trackEvent?("service_component_clicked", [
+            "service_name": serviceName,
+            "screen_name": screenName,
+            "component_name": "logo_trust",
+            "url_config": banner.urlConfig
+        ])
+        onPress?(banner.urlConfig)
     }
-    
-    
+
     public var body: some View {
-        HStack(alignment: .center, spacing: 8) {
-            WebImage(url: URL(string: applicationEnvironment.config?.trustBanner?.momoImage ?? defaultBanner.momoImage))
-                .resizable()
-                .scaledToFit()
-                .frame(width: 64, height: 64)
-            VStack(alignment: .leading){
-                Text(applicationEnvironment.config?.trustBanner?.content[localize.currentLanguage]
-                     ?? localize.translateData(defaultBanner.content))
-                    .foregroundColor(Color(hex: "484848"))
-                    .lineLimit(2)
-                    .font(.system(size: 13, weight: Font.Weight.regular))
-                    .ignoreBoldTextSetting()
-                    .lineSpacing(3)
-                    .padding(.bottom, 8)
-                HStack {
+        HStack(alignment: .top, spacing: 10) {
+            if let momoImage = banner.momoImage {
+                WebImage(url: URL(string: momoImage))
+                    .resizable()
+                    .scaledToFit()
+                    .frame(width: 64, height: 64)
+            }
+            VStack(alignment: .leading, spacing: 0) {
+                MomoText(
+                    localize.translateData(banner.content),
+                    typography: .descriptionDefaultRegular,
+                    color: Color(hex: "484848"),
+                    maxLines: 2
+                )
+                .padding(.bottom, 8)
+                HStack(alignment: .top, spacing: 0) {
                     HStack(spacing: 0) {
-                        Text(applicationEnvironment.config?.trustBanner?.subContent[localize.currentLanguage]
-                             ?? localize.translateData(defaultBanner.subContent))
-                            .foregroundColor(Colors.pink03)
-                            .font(.system(size: 13, weight: .bold))
-                            .ignoreBoldTextSetting()
-                            .padding(.trailing, 4)
-                        
+                        MomoText(
+                            localize.translateData(banner.subContent),
+                            typography: .actionXsBold,
+                            color: Colors.pink03,
+                            maxLines: 2
+                        )
                         Icon(source: "arrow_chevron_right_small", color: Colors.pink03)
-                    }.onTapGesture {
-                        onPressSecurity()
                     }
-                    
-                    Spacer()
-                    HStack{
-                        WebImage(url:  URL(string: applicationEnvironment.config?.trustBanner?.pciImage ?? defaultBanner.pciImage))
-                            .resizable()
-                            .scaledToFit()
-                            .frame(width: 24, height: 20)
-                        WebImage(url:  URL(string: applicationEnvironment.config?.trustBanner?.sslImage ?? defaultBanner.sslImage))
-                            .resizable()
-                            .scaledToFit()
-                            .frame(width: 52, height: 20)
+
+                    Spacer(minLength: 0)
+                    HStack(spacing: 0) {
+                        if let pciImage = banner.pciImage {
+                            WebImage(url: URL(string: pciImage))
+                                .resizable()
+                                .scaledToFit()
+                                .frame(width: 27, height: 20)
+                                .padding(.trailing, 4)
+                        }
+                        if let sslImage = banner.sslImage {
+                            WebImage(url: URL(string: sslImage))
+                                .resizable()
+                                .scaledToFit()
+                                .frame(width: 52, height: 20)
+                        }
                     }
                 }
-                
             }
-            
         }
         .padding(.all, 12)
         .background(Color(hex: "F2F8FF"))
         .cornerRadius(12)
+        .contentShape(Rectangle())
         .onTapGesture {
             onPressSecurity()
         }

package/ios/Title/Title.swift

@@ -28,7 +28,6 @@ public enum TitleButtonSize {
 
 public struct Title: View {
     @Environment(\.appTheme) private var theme
-    @Environment(\.momoFontScale) private var fontScale
 
     private let title: String
     private let type: TitleType
@@ -116,15 +115,9 @@ public struct Title: View {
         }
     }
 
-    private var titleFontWeight: Font.Weight {
-        switch type {
-        case .card: return .regular
-        case .section: return .bold
-        }
-    }
-
     private var titleMaxLines: Int {
-        (showTrailingAction || badgeLabel != nil) ? 1 : 2
+        if textOnly { return Int.max }
+        return (showTrailingAction || badgeLabel != nil) ? 1 : 2
     }
 
     private var iconVerticalAlignment: VerticalAlignment {
@@ -151,14 +144,10 @@ public struct Title: View {
         }
     }
 
+    // Every Title variant is bold in the theme font; `headerDefaultBold` only supplies the weight.
     private var titleText: some View {
-        SwiftUI.Text(title)
-            .font(.system(size: fontScale(titleFontSize), weight: titleFontWeight))
-            .ignoreBoldTextSetting()
-            .foregroundColor(theme.colors.text.default)
-            .lineSpacing(fontScale(titleLineHeight) - fontScale(titleFontSize))
-            .lineLimit(titleMaxLines)
-            .truncationMode(.tail)
+        MomoText(title, typography: .headerDefaultBold, maxLines: titleMaxLines)
+            .fontSize(titleFontSize, lineHeight: titleLineHeight)
     }
 
     private var fullLayout: some View {
@@ -237,7 +226,7 @@ public struct Title: View {
             }
         }
         .frame(maxWidth: .infinity, alignment: .leading)
-        .padding(8)
+        .padding(.top, type == .section ? Spacing.S : 0)
     }
 }
 

package/ios/Tooltip/Tooltip.swift

@@ -3,7 +3,7 @@ import SwiftUI
 // MARK: - Types
 
 /// Tooltip placement relative to the anchor element.
-public enum TooltipPlacement {
+public enum TooltipPlacement: Sendable {
     case top
     case bottom
     case left
@@ -78,24 +78,37 @@ struct TooltipArrowShape: Shape {
     func path(in rect: CGRect) -> Path {
         let w = rect.width
         let h = rect.height
-        var path = Path()
+        let points: [CGPoint]
         switch placement {
         case .top:
-            path.move(to: CGPoint(x: 0, y: 0))
-            path.addLine(to: CGPoint(x: w, y: 0))
-            path.addLine(to: CGPoint(x: w / 2, y: h))
+            points = [CGPoint(x: 0, y: 0), CGPoint(x: w, y: 0), CGPoint(x: w / 2, y: h)]
         case .bottom:
-            path.move(to: CGPoint(x: 0, y: h))
-            path.addLine(to: CGPoint(x: w, y: h))
-            path.addLine(to: CGPoint(x: w / 2, y: 0))
+            points = [CGPoint(x: 0, y: h), CGPoint(x: w, y: h), CGPoint(x: w / 2, y: 0)]
         case .left:
-            path.move(to: CGPoint(x: 0, y: 0))
-            path.addLine(to: CGPoint(x: 0, y: h))
-            path.addLine(to: CGPoint(x: w, y: h / 2))
+            points = [CGPoint(x: 0, y: 0), CGPoint(x: 0, y: h), CGPoint(x: w, y: h / 2)]
         case .right:
-            path.move(to: CGPoint(x: w, y: 0))
-            path.addLine(to: CGPoint(x: w, y: h))
-            path.addLine(to: CGPoint(x: 0, y: h / 2))
+            points = [CGPoint(x: w, y: 0), CGPoint(x: w, y: h), CGPoint(x: 0, y: h / 2)]
+        }
+        // rounded like Compose's cornerPathEffect: each corner is cut `radius` along both edges
+        let radius = TooltipConst.arrowCornerRadius
+        func toward(_ from: CGPoint, _ to: CGPoint) -> CGPoint {
+            let dx = to.x - from.x
+            let dy = to.y - from.y
+            let length = (dx * dx + dy * dy).squareRoot()
+            guard length > 0 else { return from }
+            let distance = min(radius, length / 2)
+            return CGPoint(x: from.x + dx / length * distance, y: from.y + dy / length * distance)
+        }
+        var path = Path()
+        for index in 0..<points.count {
+            let corner = points[index]
+            let start = toward(corner, points[(index + points.count - 1) % points.count])
+            if index == 0 {
+                path.move(to: start)
+            } else {
+                path.addLine(to: start)
+            }
+            path.addQuadCurve(to: toward(corner, points[(index + 1) % points.count]), control: corner)
         }
         path.closeSubpath()
         return path
@@ -209,6 +222,8 @@ private struct TooltipPositionModifier: ViewModifier {
                 }
             )
             .offset(x: originX, y: originY)
+            // the first pass has no size yet and would flash at the wrong spot
+            .opacity(popupSize == .zero ? 0 : 1)
     }
 
     private var originX: CGFloat {

package/ios/Typography/FontScale.swift

@@ -30,9 +30,9 @@ public struct FontScale: Equatable {
     public func callAsFunction(_ size: CGFloat) -> CGFloat {
         guard useOSScaleRate else { return size * userScaleRate }
 
-        // Device width is read live rather than snapshotted, matching Compose's
-        // getScreenDimensions() read inside scaleSize(), so a rotation or split-view resize counts.
-        let deviceScale = UIScreen.main.bounds.width / Self.defaultScreenSize
+        // Short side, not width: landscape must not inflate every font (and so every popup's height).
+        let bounds = UIScreen.main.bounds.size
+        let deviceScale = min(bounds.width, bounds.height) / Self.defaultScreenSize
 
         var deviceScaled = size
         var osScaled = size

package/ios/Typography/Text.swift

@@ -99,28 +99,63 @@ public extension TypographyStyle {
     }
 }
 
-private func momoFontName(family: String, weight: Font.Weight) -> String? {
-    // Ngoai whitelist thi tra nil de momoFont() roi ve .system(...), dung nhu truoc DS-791.
-    guard KitDesignSystem.shared.isWhiteList else { return nil }
+private enum MomoFontFace {
+    case system
+    case named(String)
+}
+
+/// Port of Compose `getFontFamily`; SF Pro Text is the iOS system font, so the legacy family is `.system`.
+private func momoFontFace(family: String, weight: Font.Weight) -> MomoFontFace? {
+    let isNewFamily = family == "MomoTrustSans" || family == headerFontFamily
+    // Outside the whitelist the new DS families drop to the legacy font, as before DS-791.
+    if family == "SFProText" || (isNewFamily && !KitDesignSystem.shared.isWhiteList) { return .system }
+    // single-file families (Compose maps every weight to the same .otf)
+    if family == headerFontFamily || family == "MoMoSignature" { return .named(family) }
     guard family == "MomoTrustSans" else { return nil }
     switch weight {
-    case .ultraLight, .thin: return "MomoTrustSans-ExtraLight"
-    case .light: return "MomoTrustSans-Light"
-    case .regular: return "MomoTrustSans-Regular"
-    case .medium: return "MomoTrustSans-Medium"
-    case .semibold: return "MomoTrustSans-SemiBold"
-    case .bold: return "MomoTrustSans-Bold"
-    case .heavy, .black: return "MomoTrustSans-ExtraBold"
-    default: return "MomoTrustSans-Regular"
+    case .ultraLight, .thin: return .named("MomoTrustSans-ExtraLight")
+    case .light: return .named("MomoTrustSans-Light")
+    case .regular: return .named("MomoTrustSans-Regular")
+    case .medium: return .named("MomoTrustSans-Medium")
+    case .semibold: return .named("MomoTrustSans-SemiBold")
+    case .bold: return .named("MomoTrustSans-Bold")
+    case .heavy, .black: return .named("MomoTrustSans-ExtraBold")
+    default: return .named("MomoTrustSans-Regular")
     }
 }
 
-private func momoFont(size: CGFloat, weight: Font.Weight, family: String) -> Font {
-    guard let name = momoFontName(family: family, weight: weight),
-          UIFont(name: name, size: size) != nil else {
+/// Header title family (Compose `HEADER_FONT_FAMILY`), whitelist only like the default font.
+let headerFontFamily = "MoMoTrustDisplay"
+
+private func momoFont(size: CGFloat, weight: Font.Weight, family: String, fallbackFamily: String? = nil) -> Font {
+    switch momoFontFace(family: family, weight: weight) {
+    case .system:
+        return .system(size: size, weight: weight)
+    case .named(let name) where UIFont(name: name, size: size) != nil:
+        return .custom(name, fixedSize: size)
+    default:
+        // Compose falls back to the default font file when a family is missing
+        if let fallbackFamily, fallbackFamily != family {
+            return momoFont(size: size, weight: weight, family: fallbackFamily)
+        }
         return .system(size: size, weight: weight)
     }
-    return .custom(name, fixedSize: size)
+}
+
+// lineHeight is identical across weights of a family, so the regular face is enough.
+private func momoLineHeight(size: CGFloat, family: String, fallbackFamily: String? = nil) -> CGFloat {
+    switch momoFontFace(family: family, weight: .regular) {
+    case .system:
+        break
+    case .named(let name):
+        if let font = UIFont(name: name, size: size) { return font.lineHeight }
+        fallthrough
+    case nil:
+        if let fallbackFamily, fallbackFamily != family {
+            return momoLineHeight(size: size, family: fallbackFamily)
+        }
+    }
+    return UIFont.systemFont(ofSize: size).lineHeight
 }
 
 public struct MomoText: View {
@@ -139,7 +174,12 @@ public struct MomoText: View {
     private let letterSpacing: CGFloat?
     private let softWrap: Bool
     private let accessibilityId: String?
+    private let fontFamily: String?
     private var highlightText: [String] = []
+    private var sizeOverride: (fontSize: CGFloat, lineHeight: CGFloat)?
+
+    private var fontSize: CGFloat { sizeOverride?.fontSize ?? typography.fontSize }
+    private var lineHeight: CGFloat { sizeOverride?.lineHeight ?? typography.lineHeight }
 
     public init(
         _ content: String,
@@ -153,7 +193,8 @@ public struct MomoText: View {
         underline: Bool = false,
         letterSpacing: CGFloat? = nil,
         softWrap: Bool = true,
-        accessibilityId: String? = nil
+        accessibilityId: String? = nil,
+        fontFamily: String? = nil
     ) {
         self.content = content
         self.typography = typography
@@ -175,6 +216,7 @@ public struct MomoText: View {
         self.letterSpacing = letterSpacing
         self.softWrap = softWrap
         self.accessibilityId = accessibilityId
+        self.fontFamily = fontFamily
     }
 
     init(_ content: String, typography: TypographyStyle, highlightText: [String]) {
@@ -182,11 +224,27 @@ public struct MomoText: View {
         self.highlightText = highlightText
     }
 
+    /// Compose's `style.copy(fontSize, lineHeight)`; the weight still comes from `typography`.
+    func fontSize(_ fontSize: CGFloat, lineHeight: CGFloat) -> MomoText {
+        var text = self
+        text.sizeOverride = (fontSize, lineHeight)
+        return text
+    }
+
+    private var font: Font {
+        momoFont(
+            size: fontScale(fontSize),
+            weight: typography.fontWeight,
+            family: fontFamily ?? theme.font,
+            fallbackFamily: theme.font
+        )
+    }
+
     // Whole-word matches of `highlightText` render semibold; the longest keyword wins (RN parity).
     private var baseText: SwiftUI.Text {
         let keywords = highlightText.filter { !$0.isEmpty }.sorted { $0.count > $1.count }
         guard !keywords.isEmpty else { return SwiftUI.Text(content) }
-        let highlightFont = momoFont(size: fontScale(typography.fontSize), weight: TypographyStyle.headerXsSemibold.fontWeight, family: theme.font)
+        let highlightFont = momoFont(size: fontScale(fontSize), weight: TypographyStyle.headerXsSemibold.fontWeight, family: fontFamily ?? theme.font, fallbackFamily: theme.font)
         func isWordChar(_ character: Character?) -> Bool {
             guard let character else { return false }
             return character.isLetter || character.isNumber || character == "_"
@@ -222,8 +280,12 @@ public struct MomoText: View {
         // *Strikethrough styles) or the explicit `strikethrough` flag.
         let isStrikethrough = strikethrough || typography.isStrikethrough
 
+        // lineSpacing is added on top of the font's natural line height, not on top of fontSize.
+        let lineSpacing = max(0, fontScale(lineHeight)
+            - momoLineHeight(size: fontScale(fontSize), family: fontFamily ?? theme.font, fallbackFamily: theme.font))
+
         var text = baseText
-            .font(momoFont(size: fontScale(typography.fontSize), weight: typography.fontWeight, family: theme.font))
+            .font(font)
             .foregroundColor(textColor)
             .strikethrough(isStrikethrough, color: textColor)
             .underline(underline, color: textColor)
@@ -234,7 +296,7 @@ public struct MomoText: View {
 
         return text
             .multilineTextAlignment(textAlign)
-            .lineSpacing(fontScale(typography.lineHeight) - fontScale(typography.fontSize))
+            .lineSpacing(lineSpacing)
             .modifier(LineLimitModifier(range: lineLimitRange))
             .truncationMode(truncationMode)
             .fixedSize(horizontal: !softWrap, vertical: false)

package/ios/Uploader/Uploader.swift

@@ -80,7 +80,9 @@ public struct Uploader: View {
 
             ScrollView(.horizontal, showsIndicators: false) {
                 HStack(alignment: .top, spacing: Spacing.S) {
-                    ForEach(Array(images.enumerated()), id: \.element.id) { index, image in
+                    // Positional like Compose: `UploadImage.id` is a fresh UUID per init, so hosts that
+                    // rebuild the array each render would otherwise re-create (and reload) every thumbnail.
+                    ForEach(Array(images.enumerated()), id: \.offset) { index, image in
                         UploaderImageItem(
                             image: image,
                             width: width,

package/ios/native-kits.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'MoMoUIKits'
-  s.version          = '0.167.1-beta.4'
+  s.version          = '0.167.1-duo.15'
   s.summary          = 'MoMoUIKits for iOS'
   s.homepage         = 'https://momo.vn'
   s.license          = { :type => 'MIT' }
@@ -37,6 +37,7 @@ Pod::Spec.new do |s|
     "Layout/**/*.{swift,m,h}",
     "Loader/**/*.{swift,m,h}",
     "Lottie/**/*.{swift,m,h}",
+    "Navigation/**/*.{swift,m,h}",
     "OTPKeyboard/**/*.{swift,m,h}",
     "Pagination/**/*.{swift,m,h}",
     "Popup/**/*.{swift,m,h}",

package/ios-demo/MoMoUIKitsDemo.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'MoMoUIKitsDemo'
-  s.version          = '0.167.1-beta.4'
+  s.version          = '0.167.1-duo.15'
   s.summary          = 'Demo browser for MoMoUIKits SwiftUI components'
   s.homepage         = 'https://momo.vn'
   s.license          = { :type => 'MIT' }

package/ios-demo/README.md

@@ -0,0 +1,120 @@
+# MoMoUIKitsDemo
+
+SwiftUI demo browser for `MoMoUIKits`.
+
+The package can optionally host a Compose UIKits screen by receiving a
+`UIViewController` factory from the host app. It does not import the KMP
+`shared` module directly.
+
+SwiftUI mode reuses the full demo screen set from
+`sample/iosApp/iosApp/Demo`, including the sample `HomeView` registry and demo
+screens for all currently available components.
+
+## CocoaPods
+
+In the host app `Podfile`, include both local pods:
+
+```ruby
+pod 'MoMoUIKits', :path => '../momo-native-kits/ios/native-kits.podspec'
+pod 'MoMoUIKitsDemo', :path => '../momo-native-kits/ios-demo'
+```
+
+Adjust the relative paths to match the host app checkout.
+
+## Host App Usage
+
+```swift
+import MoMoUIKitsDemo
+import shared
+
+class UIKitsViewController: BaseComposeAppViewController {
+  override func getViewController() -> UIViewController? {
+    let params = self.application.data as? [String: Any]
+
+    return MoMoUIKitsDemoViewControllerFactory.make(
+      context: MoMoUIKitsDemoContext(
+        appId: params?["appId"] as? String ?? "",
+        appCode: params?["code"] as? String ?? "",
+        appName: params?["name"] as? String,
+        appIcon: params?["icon"] as? String ?? ""
+      ),
+      composeViewController: {
+        UIKitsScreenComposeViewControllerKt.UIKitsScreenComposeViewController(
+          params: params
+        )
+      }
+    )
+  }
+
+  override func viewDidDisappear(_ animated: Bool) {
+    super.viewDidDisappear(animated)
+    composeViewController = nil
+  }
+}
+```
+
+If the host does not pass `composeViewController`, the demo opens directly in
+SwiftUI mode.
+
+## Included SwiftUI Demos
+
+The pod includes the sample demo screens for:
+
+- Animated Header
+- Avatar
+- Badge
+- Baseline View
+- Bottom Tab
+- Button
+- Carousel
+- Checkbox
+- Chip
+- Collapse
+- DateTimePicker
+- Divider
+- Header User
+- Icon Button
+- Image
+- Information
+- Input
+- Input DropDown
+- Input Money
+- Input OTP
+- Input Phone Number
+- Input Search
+- Input TextArea
+- Loader
+- Navigation
+- Pagination
+- Popup Display
+- Popup Notify
+- Popup Promotion
+- Progress Info
+- Radio
+- Rating
+- Skeleton
+- Slider
+- SnackBar
+- Stepper
+- Steps
+- Suggest Action
+- Swipe
+- Switch
+- TabView
+- Tag
+- Theme
+- Title
+- Tooltip
+- Typography
+- Uploader
+
+## Validation Notes
+
+Validated locally with:
+
+```sh
+pod ipc spec ios/MoMoUIKits.podspec
+pod ipc spec ios-demo/MoMoUIKitsDemo.podspec
+pod lib lint ios/MoMoUIKits.podspec --allow-warnings --skip-import-validation
+pod lib lint ios-demo/MoMoUIKitsDemo.podspec --allow-warnings --skip-import-validation --include-podspecs=ios/MoMoUIKits.podspec
+```