@momo-kits/native-kits 0.163.1-sp.1-debug → 0.163.1-sp.11-debug

package/ios/Application/StackScreen.swift

@@ -5,7 +5,7 @@
 //  SwiftUI mirror of Compose's `StackScreen`. This is a refactor of `Screen`:
 //  the body is decomposed into the same focused pieces Compose uses — header
 //  layer, scrollable content (`StackScreenContent`), floating button
-//  (`FloatingContent`) and footer (`FooterContent`) — instead of one
+//  (`FloatingContent`) and footer (`NavigationFooter`) — instead of one
 //  monolithic, partially-duplicated view. The public init matches `Screen`
 //  so call sites (e.g. NavigationContainer's ScreenHost) can swap over.
 //
@@ -143,13 +143,8 @@ public struct StackScreen<Content: View>: View {
     // MARK: - Body
 
     public var body: some View {
-        GeometryReader { geometry in
+        GeometryReader { _ in
             let keyboardSize: CGFloat = useAvoidKeyboard ? max(keyboardHeight, 0) : 0
-            let bottomInset = min(geometry.safeAreaInsets.bottom, 21)
-            // Skip this screen's own bottom-inset reservation when hosting a footer
-            // OR a self-contained BottomTab surface (mirrors Compose's
-            // `if (options.footerComponent != null || isBottomTab) 0.dp else navigationBar`).
-            let contentBottomInset = (footer == nil && !isBottomTabRoot) ? bottomInset : 0
 
             ZStack(alignment: .top) {
                 // Background color
@@ -161,16 +156,16 @@ public struct StackScreen<Content: View>: View {
                         VStack(alignment: horizontalAlignment, spacing: 0) {
                             headerAndContent
                         }
-                        .padding(.bottom, contentBottomInset)
 
                         FloatingContent(
                             fabProps: fabProps,
-                            keyboardOffset: 0,
+                            keyboardSize: keyboardSize,
+                            hasFooter: footer != nil,
                             scrollOffset: scrollOffset
                         )
                     }
 
-                    FooterContent(footer: footer, keyboardSize: keyboardSize, bottomInset: bottomInset)
+                    NavigationFooter(footerComponent: footer, keyboardSize: keyboardSize)
                 }
 
                 // Animated search bar overlay (mirrors Compose's SearchAnimated layer).
@@ -444,17 +439,29 @@ private struct SearchAnimatedHeader: View {
 /// Mirrors Compose's `FloatingContent`: no FAB props means nothing renders.
 private struct FloatingContent: View {
     let fabProps: FabProps?
-    let keyboardOffset: CGFloat
+    let keyboardSize: CGFloat
+    /// With a footer the FAB is anchored to the footer's *layout* top, which does not move
+    /// when the band offsets itself over the keyboard — so it rides the same offset.
+    let hasFooter: Bool
     let scrollOffset: CGFloat
 
+    /// Compose keeps the FAB `Spacing.M + AppNavigationBar` above the bottom of the screen
+    /// and lifts it with `imePadding()`; here it sits `Spacing.M` above the safe area and
+    /// nothing lifts it, so the difference is applied as an offset (see NavigationFooter).
+    private var verticalOffset: CGFloat {
+        if hasFooter { return NavigationFooter.verticalOffset(keyboardSize: keyboardSize) }
+        return NavigationFooter.safeAreaBottom - NavigationFooter.navigationBarInset - keyboardSize
+    }
+
     var body: some View {
         if let fabProps = fabProps {
             FloatingButton(
                 props: fabProps,
-                keyboardOffset: keyboardOffset,
+                keyboardOffset: 0,
                 scrollOffset: scrollOffset
             )
             .padding(.horizontal, Spacing.M)
+            .offset(y: verticalOffset)
             .ignoresSafeArea(.keyboard, edges: .bottom)
         }
     }
@@ -483,19 +490,3 @@ private struct HideKeyboardOnTap: ViewModifier {
         }
     }
 }
-
-// MARK: - Footer content
-
-/// Mirrors Compose's `FooterContent`: renders the footer chrome only when a
-/// footer component is supplied. Reuses the existing `Footer` view from Screen.swift.
-private struct FooterContent: View {
-    let footer: (() -> AnyView)?
-    let keyboardSize: CGFloat
-    let bottomInset: CGFloat
-
-    var body: some View {
-        if let footerView = footer?() {
-            Footer(footerView: footerView, keyboardSize: keyboardSize, bottomInset: bottomInset)
-        }
-    }
-}

package/ios/Badge/Badge.swift

@@ -2,6 +2,7 @@ import SwiftUI
 
 public struct Badge: View {
     @Environment(\.appTheme) private var theme
+    @Environment(\.momoFontScale) private var fontScale
     let label: String
     let backgroundColor: Color?
     
@@ -55,7 +56,7 @@ public struct Badge: View {
     public var body: some View {
         MomoText(formatTitle(label), typography: .actionXxsBold, color: Colors.black01)
             .padding(.horizontal, Spacing.XS)
-            .frame(minWidth: scaleSize(16), minHeight: scaleSize(16))
+            .frame(minWidth: fontScale(16), minHeight: fontScale(16))
             .background(badgeColor)
             .cornerRadius(Radius.M)
             .overlay(

package/ios/Badge/BadgeRibbon.swift

@@ -174,6 +174,7 @@ public struct BadgeRibbon: View {
         )
         .frame(width: RibbonConstants.headTailWidth, height: RibbonConstants.headTailHeight)
         .rotationEffect(.degrees(180))
+        .offset(x: 1)
         .clipped()
     }
     
@@ -183,6 +184,7 @@ public struct BadgeRibbon: View {
             placeholder: AnyView(Color.clear)
         )
         .frame(width: RibbonConstants.headTailWidth, height: RibbonConstants.headTailHeight)
+        .offset(x: 1)
         .clipped()
     }
     
@@ -192,6 +194,7 @@ public struct BadgeRibbon: View {
             placeholder: AnyView(Color.clear)
         )
         .frame(width: RibbonConstants.skewTailWidth, height: RibbonConstants.skewTailHeight)
+        .offset(x: -2)
         .clipped()
     }
 }
@@ -201,6 +204,7 @@ public struct BadgeRibbon: View {
 /// rotation) — the label gets the same scale applied a second time so it stays right-reading
 /// while only the ribbon shape flips.
 public struct RoundedBadgeRibbon: View {
+    @Environment(\.momoFontScale) private var fontScale
     let text: String
     let position: RibbonPosition
 
@@ -219,7 +223,7 @@ public struct RoundedBadgeRibbon: View {
     }
 
     private var measuredTextSize: CGSize {
-        let fontSize = scaleSize(TypographyStyle.labelXsMedium.fontSize)
+        let fontSize = fontScale(TypographyStyle.labelXsMedium.fontSize)
         let font = UIFont.systemFont(ofSize: fontSize, weight: .medium)
         return text.size(withAttributes: [.font: font])
     }
@@ -281,7 +285,7 @@ private struct RibbonConstants {
     static let ribbonHeight: CGFloat = 20
     static let roundHeight: CGFloat = 16
     static let skewBodyHeight: CGFloat = 16
-    static let roundRightRadius: CGFloat = 12
+    static let roundRightRadius: CGFloat = 8
     static let roundPaddingEnd: CGFloat = 6
     static let skewTailWidth: CGFloat = 8
     static let skewTailHeight: CGFloat = 16

package/ios/Button/Button.swift

@@ -133,19 +133,19 @@ public struct Button: View {
     var action: () -> Void
     var type: ButtonType
     var size: ButtonSize
-    var iconLeft: AnyView?
-    var iconRight: AnyView?
+    var iconLeft: String
+    var iconRight: String
     var isFull: Bool
     var loading: Bool
     var useTintColor: Bool
 
     public init(
-        title: String = "",
+        title: String = "Button",
         action: @escaping () -> Void,
         type: ButtonType = .primary,
         size: ButtonSize = .large,
-        iconLeft: AnyView? = nil,
-        iconRight: AnyView? = nil,
+        iconLeft: String = "",
+        iconRight: String = "",
         isFull: Bool = true,
         loading: Bool = false,
         useTintColor: Bool = true
@@ -161,38 +161,9 @@ public struct Button: View {
         self.useTintColor = useTintColor
     }
 
-    /// Mirrors Kotlin's `Button(iconLeft: String, iconRight: String, ...)`, which resolves
-    /// icons by design-system source name through the shared `Icon` component rather than
-    /// a caller-supplied view. `iconLeft` is required here (unlike Kotlin's `= ""` default)
-    /// solely to keep this initializer unambiguous alongside the `AnyView`-based one above —
-    /// pass `""` explicitly for an icon-right-only button.
-    public init(
-        title: String = "Button",
-        action: @escaping () -> Void,
-        type: ButtonType = .primary,
-        size: ButtonSize = .large,
-        iconLeft: String,
-        iconRight: String = "",
-        isFull: Bool = true,
-        loading: Bool = false,
-        useTintColor: Bool = true
-    ) {
-        self.init(
-            title: title,
-            action: action,
-            type: type,
-            size: size,
-            iconLeft: iconLeft.isEmpty ? nil : AnyView(Icon(source: iconLeft)),
-            iconRight: iconRight.isEmpty ? nil : AnyView(Icon(source: iconRight)),
-            isFull: isFull,
-            loading: loading,
-            useTintColor: useTintColor
-        )
-    }
-
-    private func shouldLoadingOnLeft(_ left: AnyView?, _ right: AnyView?) -> Bool {
-        let hasLeft = left != nil
-        let hasRight = right != nil
+    private func shouldLoadingOnLeft(_ left: String, _ right: String) -> Bool {
+        let hasLeft = !left.isEmpty
+        let hasRight = !right.isEmpty
 
         switch (hasLeft, hasRight) {
         case (false, false): return true
@@ -217,27 +188,13 @@ public struct Button: View {
             }
         }) {
             HStack(spacing: size.iconSpacing) {
-                if loading && loadingOnLeft {
-                    LottieView(name: "lottie_circle_loader", loopMode: .loop)
-                        .frame(width: size.iconSize, height: size.iconSize)
-                        .colorMultiply(fg)
-
-                } else if let iconLeft = iconLeft {
-                    tintedIcon(iconLeft, color: fg)
-                }
+                renderIcon(icon: iconLeft, forceLoading: loading && loadingOnLeft, textColor: fg)
 
                 MomoText(title, typography: size.typographyStyle, color: fg)
                     .lineLimit(1)
                     .truncationMode(.tail)
 
-                if loading && !loadingOnLeft {
-                    LottieView(name: "lottie_circle_loader", loopMode: .loop)
-                        .frame(width: size.iconSize, height: size.iconSize)
-                        .colorMultiply(fg)
-
-                } else if let iconRight = iconRight {
-                    tintedIcon(iconRight, color: fg)
-                }
+                renderIcon(icon: iconRight, forceLoading: loading && !loadingOnLeft, textColor: fg)
             }
             .frame(maxWidth: isFull ? .infinity : nil)
             .padding(.horizontal, size.padding)
@@ -249,20 +206,24 @@ public struct Button: View {
             border: border,
             borderWidth: borderWidth,
             radius: size.radius,
-            height: size.height
+            height: size.height,
+            isFull: isFull
         ))
         .disabled(!isEnabled)
     }
 
+    /// Mirrors Kotlin `RenderIcon`: the loader replaces the icon slot entirely, and
+    /// `useTintColor == false` leaves the icon at its own colors.
     @ViewBuilder
-    private func tintedIcon(_ icon: AnyView, color: Color) -> some View {
-        if useTintColor {
-            icon
-                .frame(width: size.iconSize, height: size.iconSize)
-                .colorMultiply(color)
-        } else {
-            icon
+    private func renderIcon(icon: String, forceLoading: Bool, textColor: Color) -> some View {
+        let color: Color? = useTintColor ? textColor : nil
+
+        if forceLoading {
+            LottieView(name: "lottie_circle_loader", loopMode: .loop)
                 .frame(width: size.iconSize, height: size.iconSize)
+                .colorMultiply(color ?? Colors.black01)
+        } else if !icon.isEmpty {
+            Icon(source: icon, size: size.iconSize, color: color)
         }
     }
 }
@@ -277,29 +238,42 @@ private struct ButtonPressFeedbackStyle: ButtonStyle {
     let borderWidth: CGFloat
     let radius: CGFloat
     let height: CGFloat
+    let isFull: Bool
 
     func makeBody(configuration: Configuration) -> some View {
         let pressed = configuration.isPressed && isEnabled
 
-        ZStack {
-            RoundedRectangle(cornerRadius: radius)
-                .fill(background)
-                .overlay(
-                    RoundedRectangle(cornerRadius: radius)
-                        .strokeBorder(border ?? .clear, lineWidth: border != nil ? borderWidth : 0)
-                )
-                .padding(.horizontal, pressed ? 2 : 0)
-
-            configuration.label
-                .opacity(pressed ? 0.5 : 1)
+        configuration.label
+            .modifier(HugContentOnLegacyOS(isFull: isFull))
+            .opacity(pressed ? 0.5 : 1)
+            .background(
+                RoundedRectangle(cornerRadius: radius)
+                    .fill(background)
+                    .overlay(
+                        RoundedRectangle(cornerRadius: radius)
+                            .strokeBorder(border ?? .clear, lineWidth: border != nil ? borderWidth : 0)
+                    )
+                    .padding(.horizontal, pressed ? 2 : 0)
+            )
+            .frame(height: height)
+            .clipShape(RoundedRectangle(cornerRadius: radius))
+            .animation(.easeInOut(duration: 0.1), value: pressed)
+    }
+}
+
+/// `ButtonStyleConfiguration.Label` is greedy on iOS 16 and earlier — it accepts
+/// the full proposed width, so the background drawn in `makeBody` stretches past
+/// the content even when `isFull == false`. iOS 17 fixed the label to hug its
+/// content, so only legacy OSes need the `fixedSize` clamp (kept off on 17+ to
+/// preserve tail truncation of long titles).
+private struct HugContentOnLegacyOS: ViewModifier {
+    let isFull: Bool
+
+    func body(content: Content) -> some View {
+        if #available(iOS 17.0, *) {
+            content
+        } else {
+            content.fixedSize(horizontal: !isFull, vertical: false)
         }
-        // Pin the whole button to its intended height explicitly: the bare
-        // RoundedRectangle background has no intrinsic size of its own, so left
-        // unconstrained in a ZStack inside a non-height-constraining container
-        // (e.g. a footer VStack) it can report an oversized ideal height and
-        // stretch the button — and its container — far taller than intended.
-        .frame(height: height)
-        .clipShape(RoundedRectangle(cornerRadius: radius))
-        .animation(.easeInOut(duration: 0.1), value: pressed)
     }
 }

package/ios/Chip/Chip.swift

@@ -3,6 +3,7 @@ import Foundation
 
 public struct Chip: View {
     @Environment(\.appTheme) private var theme
+    @Environment(\.momoFontScale) private var fontScale
     public enum ChipSize { case small, large }
 
     public struct Dimensions {
@@ -54,11 +55,11 @@ public struct Chip: View {
         let dims = (size == .small) ? Self.Small : Self.Large
         // Mirrors Compose's `scaleSize(...)` on every chip dimension so it responds
         // to Dynamic Type scaling the same way the rest of the kit does.
-        let height = scaleSize(dims.height)
-        let horizontal = scaleSize(dims.horizontal)
-        let iconSize = scaleSize(dims.iconSize)
-        let iconSpacing = scaleSize(dims.iconSpacing)
-        let radius = scaleSize(Radius.L)
+        let height = fontScale(dims.height)
+        let horizontal = fontScale(dims.horizontal)
+        let iconSize = fontScale(dims.iconSize)
+        let iconSpacing = fontScale(dims.iconSpacing)
+        let radius = fontScale(Radius.L)
 
         let bg: Color = {
             if selected { return theme.colors.background.selected }

package/ios/Icon/Icon.swift

@@ -26,17 +26,24 @@ let iconSources: [String: IconSource] = loadIconSources()
 // Icons that must never be tinted (mirror Compose `noThemeIcons`)
 let noThemeIcons: [String] = ["ic_round_momo_tiny"]
 
+// Compose defaults `color` to the theme text color while `color = null` means "no tint".
+// Swift can't tell an omitted argument from an explicit `nil`, so the default is this
+// unrepresentable sentinel: omitted -> theme text color, `nil` -> untinted.
+public let iconThemeColor = Color(.sRGB, red: -1, green: -1, blue: -1, opacity: -1)
+
 // Icon ViewModel
 public struct Icon: View {
+    @Environment(\.appTheme) private var theme
+
     var source: String
     var size: CGFloat
     var color: Color?
     var accessibilityLabel: String?
-    
+
     public init(
             source: String,
             size: CGFloat = 24,
-            color: Color? = nil,
+            color: Color? = iconThemeColor,
             accessibilityLabel: String? = nil
         ) {
             self.source = source
@@ -46,9 +53,11 @@ public struct Icon: View {
         }
 
     public var body: some View {
-        if let uri = iconSources[source]?.uri {
+        // Mirror Compose: an https source is used as-is, anything else is a key into icon.json
+        if let uri = source.contains("https") ? source : iconSources[source]?.uri {
+            let requestedColor = color == iconThemeColor ? theme.colors.text.default : color
             // Mirror Compose: certain icons (e.g. branded glyphs) are never tinted
-            let resolvedColor = noThemeIcons.contains(source) ? nil : color
+            let resolvedColor = noThemeIcons.contains(source) ? nil : requestedColor
             ImageView(uri, color: resolvedColor)
                 .frame(width: size, height: size)
                 // Mirrors Compose's auto-generated `contentDescription = "img|$iconUrl"`

package/ios/Input/ErrorView.swift

@@ -9,6 +9,7 @@ import SwiftUI
 
 public struct ErrorView: View {
     @Environment(\.appTheme) private var theme
+    @Environment(\.momoFontScale) private var fontScale
 
     public var errorMessage: String
     public var errorSpacing: Bool
@@ -27,7 +28,7 @@ public struct ErrorView: View {
     public var body: some View {
         if !errorMessage.isEmpty || !hintText.isEmpty {
             HStack(alignment: .top, spacing: 4) {
-                Icon(source: "ic_error", size: scaleSize(16), color: displayColor())
+                Icon(source: "ic_error", size: fontScale(16), color: displayColor())
                 MomoText(
                     displayText(),
                     typography: .descriptionDefaultRegular,

package/ios/Input/Input.swift

@@ -4,6 +4,7 @@ import Combine
 
 public struct Input: View {
     @Environment(\.appTheme) private var theme
+    @Environment(\.momoFontScale) private var fontScale
     @Binding public var text: String
     
     public var placeholder: String
@@ -163,7 +164,7 @@ public struct Input: View {
                             SecureInputField(
                                 text: $text,
                                 keyboardType: keyboardType,
-                                fontSize: scaleSize(14),
+                                fontSize: fontScale(14),
                                 fontWeight: fontWeight == .bold ? .bold : .regular,
                                 textColor: UIColor(getTextColor()),
                                 cursorColor: UIColor(theme.colors.primary),
@@ -189,6 +190,12 @@ public struct Input: View {
                             .onAppear {
                                 if autofocus { isFieldFocused = true }
                             }
+                            // SwiftUI reads a TextField's UIKit input traits only when it
+                            // builds the backing UITextField, so a later `keyboardType`
+                            // change is silently dropped. The secure path can call
+                            // `reloadInputViews()` in `updateUIView`; here the only lever
+                            // is to force a rebuild.
+                            .id(keyboardType.rawValue)
                         }
                     }
                     
@@ -230,7 +237,7 @@ public struct Input: View {
                     }
                 }
                 .padding(.horizontal, Spacing.M)
-                .frame(height: scaleSize(size == .small ? 48 : 56, 1.1))
+                .frame(height: fontScale(size == .small ? 48 : 56))
                 .background(
                     RoundedRectangle(cornerRadius: Radius.S)
                         .fill(theme.colors.background.surface)

package/ios/Input/InputPhoneNumber.swift

@@ -8,6 +8,7 @@
 import SwiftUI
 public struct InputPhoneNumber: View {
     @Environment(\.appTheme) private var theme
+    @Environment(\.momoFontScale) private var fontScale
     @Binding public var text: String
     
     public var placeholder: String
@@ -143,7 +144,7 @@ public struct InputPhoneNumber: View {
                 }
             }
             .padding(.horizontal, Spacing.M)
-            .frame(height: scaleSize(size == .small ? 48 : 56, 1.1))
+            .frame(height: fontScale(size == .small ? 48 : 56))
             .background(
                 RoundedRectangle(cornerRadius: Radius.S)
                     .fill(theme.colors.background.surface)

package/ios/Input/InputSearch.swift

@@ -104,6 +104,7 @@ public struct InputSearchProps {
 
 public struct InputSearch: View {
     @Environment(\.appTheme) private var theme
+    @Environment(\.momoFontScale) private var fontScale
     @Binding var text: String
     var buttonText: String = ""
     var showButtonText: Bool = false
@@ -214,7 +215,7 @@ public struct InputSearch: View {
                             } else {
                                 Text(placeholder)
                                     .foregroundColor(disabled ? theme.colors.text.disable : theme.colors.text.hint)
-                                    .font(.system(size: scaleSize(14), weight: fontWeight))
+                                    .font(.system(size: fontScale(14), weight: fontWeight))
                                     .ignoreBoldTextSetting()
                             }
                         }
@@ -231,7 +232,7 @@ public struct InputSearch: View {
                         }, onCommit: {})
                         .disabled(disabled)
                         .foregroundColor(disabled ? theme.colors.text.disable : theme.colors.text.default)
-                        .font(.system(size: scaleSize(14), weight: fontWeight))
+                        .font(.system(size: fontScale(14), weight: fontWeight))
                         .ignoreBoldTextSetting()
                         .keyboardType(keyboardType)
                         .applyCursorColor(theme.colors.primary)

package/ios/Input/InputTextArea.swift

@@ -37,7 +37,12 @@ struct UITextViewWrapper: UIViewRepresentable {
         }
         uiView.textColor = UIColor(textColor)
         uiView.tintColor = UIColor(cursorColor)
-        uiView.font = UIFont.systemFont(ofSize: scaleSize(16), weight: fontWeight == .bold ? .bold : .regular)
+        // Read through `context.environment` rather than the global `scaleSize`: that is what makes
+        // SwiftUI re-run updateUIView when the font scale changes.
+        uiView.font = UIFont.systemFont(
+            ofSize: context.environment.momoFontScale(16),
+            weight: fontWeight == .bold ? .bold : .regular
+        )
         uiView.isEditable = !disabled
     }
     

package/ios/InputMoney/InputMoney.swift

@@ -50,6 +50,7 @@ public func formatNumberToMoney(_ digits: String, currency: String = "đ") -> St
 
 public struct InputMoney: View {
     @Environment(\.appTheme) private var theme
+    @Environment(\.momoFontScale) private var fontScale
     @Binding public var text: String
 
     public var floatingValue: String
@@ -214,7 +215,7 @@ public struct InputMoney: View {
                     }
                 }
                 .padding(.horizontal, Spacing.M)
-                .frame(height: scaleSize(size == .small ? 48 : 56, 1.1))
+                .frame(height: fontScale(size == .small ? 48 : 56))
                 .background(
                     RoundedRectangle(cornerRadius: Radius.S)
                         .fill(theme.colors.background.surface)
@@ -278,7 +279,7 @@ private struct MoneyTextField: UIViewRepresentable {
         let field = UITextField()
         field.delegate = context.coordinator
         field.keyboardType = keyboardType
-        field.font = UIFont.systemFont(ofSize: scaleSize(20), weight: fontWeight)
+        field.font = UIFont.systemFont(ofSize: context.environment.momoFontScale(20), weight: fontWeight)
         field.textColor = textColor
         field.isEnabled = !isDisabled
         field.tintColor = cursorColor
@@ -295,6 +296,8 @@ private struct MoneyTextField: UIViewRepresentable {
 
     func updateUIView(_ field: UITextField, context: Context) {
         context.coordinator.parent = self
+        // Re-applied here, not just in makeUIView, so a font-scale change reaches an existing field.
+        field.font = UIFont.systemFont(ofSize: context.environment.momoFontScale(20), weight: fontWeight)
         field.isEnabled = !isDisabled
         field.textColor = textColor
         field.tintColor = cursorColor

package/ios/InputOTP/InputOTP.swift

@@ -7,12 +7,13 @@ import SwiftUI
 private struct OTPCaret: View {
     @Environment(\.appTheme) private var theme
     @State private var visible: Bool = true
+    @Environment(\.momoFontScale) private var fontScale
 
     var body: some View {
         HStack(spacing: 0) {
             Rectangle()
                 .fill(theme.colors.primary)
-                .frame(width: 1, height: scaleSize(12))
+                .frame(width: 1, height: fontScale(12))
                 .opacity(visible ? 1 : 0)
                 .animation(
                     .linear(duration: 0.5).repeatForever(autoreverses: true),

package/ios/Layout/GridContext.swift

@@ -0,0 +1,30 @@
+import SwiftUI
+
+/// Grid metrics published by a layout container (`SectionView`) so span-based children
+/// can size themselves. Mirrors `vn.momo.kits.layout.GridContext`.
+public struct GridContext: Equatable {
+    public let numberOfColumns: Int
+    public let gutter: CGFloat
+    public let sizePerSpan: CGFloat
+
+    public init(numberOfColumns: Int = 12, gutter: CGFloat = Spacing.M, sizePerSpan: CGFloat = 0) {
+        self.numberOfColumns = numberOfColumns
+        self.gutter = gutter
+        self.sizePerSpan = sizePerSpan
+    }
+
+    public func sizeForSpan(_ span: Int) -> CGFloat {
+        sizePerSpan * CGFloat(span) + gutter * CGFloat(span - 1)
+    }
+}
+
+private struct GridContextKey: EnvironmentKey {
+    static let defaultValue: GridContext? = nil
+}
+
+public extension EnvironmentValues {
+    var gridContext: GridContext? {
+        get { self[GridContextKey.self] }
+        set { self[GridContextKey.self] = newValue }
+    }
+}

package/ios/Layout/Item.swift

@@ -0,0 +1,42 @@
+import SwiftUI
+
+/// Span-sized cell inside a `SectionView`. Reads the grid published by its container;
+/// without one it just wraps its content. Mirrors `vn.momo.kits.layout.Item`.
+public struct ItemView<Content: View>: View {
+    // MARK: Lifecycle
+
+    public init(
+        widthSpan: Int = 12,
+        heightSpan: Int = 0,
+        @ViewBuilder content: @escaping () -> Content
+    ) {
+        self.widthSpan = widthSpan
+        self.heightSpan = heightSpan
+        self.content = content
+    }
+
+    // MARK: Public
+
+    public var body: some View {
+        // A VStack (not a ZStack) so multiple children flow VERTICALLY instead of stacking
+        // on top of each other — matches the React Item's flex-column content.
+        VStack(alignment: .leading, spacing: 0) { content() }
+            .frame(width: width, height: height, alignment: .topLeading)
+    }
+
+    // MARK: Private
+
+    private let widthSpan: Int
+    private let heightSpan: Int
+    private let content: () -> Content
+
+    @Environment(\.gridContext) private var grid
+
+    private var width: CGFloat? {
+        grid.map { $0.sizeForSpan(widthSpan) }
+    }
+
+    private var height: CGFloat? {
+        heightSpan > 0 ? grid.map { $0.sizeForSpan(heightSpan) } : nil
+    }
+}