@momo-kits/native-kits 0.0.1-beta.5 → 0.0.2-alpha.1-debug

package/README.md

@@ -1,6 +1,185 @@
-## 🛠 Installation
-### Using Cocoapods
-Add it inside your `Podfile`.
-```ruby
-pod 'MoMoUIKits', '../node_modules/@momo-platform/native-kits/ios'
+## ComposeKit (Kotlin Multiplatform)
+
+ComposeKit là bộ UI Kit đa nền tảng phục vụ Mini App/SDK của MoMo. Toàn bộ giao diện, điều hướng, token thiết kế và layer tích hợp với MaxAPI đều được viết bằng Kotlin Multiplatform để tái sử dụng cho Android, iOS (qua Compose Multiplatform) cũng như các host native.
+
+### Mục tiêu & phạm vi
+- Chuẩn hoá visual language của MoMo với kho component Compose đã mang sẵn màu sắc, typography, spacing, radius trong `vn.momo.compose.kit.const`.
+- Cung cấp navigation stack thống nhất (`NavigationContainer`, `Navigator`, bottom tabs, modal/bottom sheet) hỗ trợ dynamic screen registry và MaxAPI dismiss/present.
+- Cho phép host nhận context Mini App (`MiniAppContext`, `KitConfig`, `ApplicationContext`, `AppLanguage`) để tự động render Trust Banner, header assets, tracking.
+- Đồng bộ hoá với native SwiftUI kit (`nativeSDK/ios`) nhằm cover các màn đang viết Swift/Objective‑C.
+
+---
+
+### Cấu trúc thư mục
+- `shared/`: module KMP chính. Chứa toàn bộ source `vn.momo.compose.kit.*`, compose resources (font SF Pro), logic publish Maven và podspec.
+- `composeApp/`: sample Compose Multiplatform Android dùng để thử nhanh component, navigator, trust banner.
+- `iosApp/`: project SwiftUI + CocoaPods để test framework iOS sinh ra từ `shared`.
+- `nativeSDK/ios/`: Swift package + podspec `MoMoUIKits` (phụ thuộc `SDWebImageSwiftUI`, `SkeletonUI`) cho các màn hoàn toàn native.
+- `publish_release.sh`, `.gitlab-ci.yml`: script tự bump patch version, chạy `:compose:publish...` khi commit có `[ci build]`.
+- `build-output/`, `build/`: output tạm thời (không commit).
+
+---
+
+### Thành phần chính trong `shared`
+
+**Design tokens & theming**
+- `const/Colors.kt`, `Radius.kt`, `Spacing.kt`, `Typography.kt` định nghĩa token thống nhất.
+- `const/Theme.kt` cung cấp `Theme`, `ColorScheme`, `AppTheme`, `AppThemeController`. Có sẵn `defaultTheme` & `darkTheme`, hỗ trợ inject assets (vd. header background từ `KitConfig`).
+
+**Layout primitives & modifier**
+- `layout/Card.kt`, `Section.kt`, `Item.kt` chứa khung section theo guideline Super App.
+- `modifier/AutomationId`, `Conditional`, `Shadow`, `Size` giúp thêm accessibility id, điều kiện hoá modifier, shadow blur tuỳ nền.
+
+**UI components**
+- Buttons (`Button.kt`, `IconButton.kt`), typography helper (`Text.kt`, `Title.kt`), badge/tag (`Badge*`, `Tag.kt`), chip & switch (`Chip.kt`, `Switch.kt`), checkbox/radio.
+- Input stack: `Input*` (OTP, PhoneNumber, Money, Search, DropDown, TextArea) với keyboard helpers.
+- Pagination indicator (`PaginationDot/Number/Scroll/WhiteDot.kt`), skeleton loading (`Skeleton.kt`), trust UI (`TrustBanner.kt`).
+- Popup/notify (`PopupNotify`, `PopupPromotion`), floating button, `LazyColumnWithBouncing`, Cupertino overscroll, `DateTimePicker` (Wheel UI + utils).
+- Lottie animation (`components/animation/LottieAnimation`) dựng trên [Compottie](https://github.com/alexzhirkevich/compottie) để chạy animation JSON đồng nhất trên Android/iOS/Desktop.
+
+**Navigation & application layer**
+- `navigation/NavigationContainer`, `Navigation.kt`, `Navigator.kt`, `StackScreen.kt`, `BottomSheet.kt`, bottom tab helpers.
+- `Navigator` hỗ trợ `push`, `replace`, `present`, `reset`, `pop(count)`, `showModal`, `showBottomSheet` với overlay registry (`OverplayComponentRegistry`).
+- `application/NavigationContainer.kt`, `MiniAppContext`, `KitConfig`, `ApplicationContext`, `AppConfig`, `AppLanguage` cung cấp context cho header/trust banner, mapping sang map để gửi qua MaxAPI.
+- `application/Screen.kt`, `Header*`, `Footer`, `FloatingButton` tạo template screen (đang deprecate, khuyến nghị dùng `NavigationContainer + StackScreen`).
+
+**Platform utilities**
+- `platform/Platform.kt` định nghĩa expect/actual cho `getPlatformName`, `BackHandler`, `getScreenHeight`, `NativePaint` mask filter. Android actual đi kèm `getAndroidBuildVersion`.
+- `utils/Icons.kt`, `Resources.kt`, `getAppStatusBarHeight()` giúp truy xuất resource Compose đa nền tảng.
+
+**Native bridge**
+- `shared/shared.podspec` và `nativeSDK/ios/MoMoUIKits.podspec` cho phép embed vào iOS app via CocoaPods (deployment target 15.0, Swift 5). Phần native duy trì các SwiftUI component tương đương Compose (Button, Input, Popup, Trust Banner, Badge...).
+
+---
+
+### Yêu cầu môi trường
+- JDK 17+ và Android SDK (compileSdk xem `libs.versions.toml`); wrapper Gradle `9.5.0`, AGP `9.2.1`.
+- Kotlin Multiplatform plugin + Compose Multiplatform (JetBrains 1.6.1+).
+- Xcode 15, CocoaPods 1.12+ để build `iosApp` hoặc publish Pod.
+- Truy cập mạng nội bộ GitLab Packages nếu cần publish/consume Maven repo `https://gitlab.mservice.com.vn/api/v4/projects/5400/packages/maven`.
+
+---
+
+### Build & kiểm thử nhanh
+
+| Tác vụ | Lệnh |
+| --- | --- |
+| Build thư viện KMP (AAR + klib + framework) | `./gradlew :compose:assembleRelease` |
+| Publish local maven (nếu cần thử) | `./gradlew :compose:publishAllPublicationsToMavenLocal` |
+| Sample Android | `./gradlew :composeApp:assembleDebug` |
+| Sample iOS | mở `iosApp/iosApp.xcworkspace` rồi build trên Xcode |
+
+Output Compose nằm trong `shared/build/outputs` và `shared/build/publications/*`. Debug fonts/resources ở `shared/src/commonMain/composeResources`.
+
+---
+
+### Publish nội bộ (GitLab Packages)
+1. Cập nhật `gradle.properties` nếu thay đổi group/artifact/version. Mặc định:
+   ```
+   name=ComposeKit
+   group=vn.momo.kits
+   artifact.id=kits
+   version=0.1.2
+   url=https://gitlab.mservice.com.vn/api/v4/projects/5400/packages/maven
+   gitlab.user=upload_packages
+   gitlab.password=<token>
+   ```
+2. Chạy `./publish_release.sh`. Script sẽ:
+   - Đọc version hiện tại, query các version đã publish qua GitLab API.
+   - Bump patch (`X.Y.Z+1`) đến khi không trùng.
+   - Ghi lại `gradle.properties`, export `VERSION`, chạy `./gradlew clean` + `:compose:publishAllPublicationsToGitLabPackagesRepository`.
+3. CI (`.gitlab-ci.yml`) tự động thực thi script này khi push với commit message chứa `[ci build]` (trừ khi branch khớp `engine/w*`).
+
+---
+
+### Tích hợp ComposeKit trong dự án KMP/Android
+
+**Thêm dependency**
+```kotlin
+repositories {
+    maven { url = uri("https://gitlab.mservice.com.vn/api/v4/projects/5400/packages/maven") }
+}
+
+commonMain.dependencies {
+    implementation("vn.momo.kits:kits:<version>")
+}
 ```
+
+**Khởi tạo navigation container**
+```kotlin
+val miniAppContext = MiniAppContext(appId = "...", appCode = "...", appIcon = "...", toolkitConfig = ...)
+
+NavigationContainer(
+    initialScreen = { StackScreenExample() },
+    options = NavigationOptions(headerTitle = HeaderTitle.Default("Home")),
+    applicationContext = miniAppContext,
+    config = KitConfig(trustBanner = defaultBanner),
+    maxApi = maxApi, // IMaxApi implementation từ host
+    setNavigator = { navigator = it }
+)
+```
+
+Bên trong screen, truy cập `LocalNavigator.current` để:
+```kotlin
+val navigator = LocalNavigator.current
+navigator.push { DetailScreen() }
+navigator.showBottomSheet(content = { BottomSheetContent() })
+```
+
+Tuỳ biến theme bằng `AppThemeController`:
+```kotlin
+val themeController = AppThemeController.current
+themeController(defaultTheme.copy(colors = defaultTheme.colors.copy(primary = Colors.pink_04)))
+```
+
+`ApplicationContext.current`, `AppConfig.current`, `AppLanguage.current` giúp component (ví dụ `TrustBanner`) tự lấy dữ liệu trust banner và tracking `service_component_clicked`.
+
+---
+
+### Tích hợp iOS / Native SDK
+- `shared/shared.podspec` sinh framework Compose (static) mang tên theo `artifact.id` (`kits`). Add vào Podfile:
+  ```ruby
+  pod 'kits', :path => '../shared'
+  ```
+- Với màn SwiftUI thuần native, dùng `nativeSDK/ios`:
+  ```ruby
+  pod 'MoMoUIKits', :path => 'nativeSDK/ios'
+  ```
+  Bộ này mirror hầu hết component Compose (Button, Input, Popup, TrustBanner...). `ApplicationEnvironment` chấp nhận `MiniAppContext`, `KitConfig` tương tự Kotlin.
+
+---
+
+### Lưu ý khác
+- `Screen` composable cũ được đánh dấu `@Deprecated`; sử dụng `NavigationContainer + StackScreen` để hưởng lợi dynamic route và animation.
+- `DesignSystemWhiteList` trong `application/ApplicationContainer.kt` hỗ trợ fallback cho host cũ; đừng kích hoạt nếu không cần.
+- Khi thêm tài nguyên mới, đặt trong `shared/src/commonMain/composeResources` để Compose Multiplatform plugin sinh accessor tự động.
+- Repo không bundle SDK bên thứ ba ngoại trừ `vn.momo.corex.maxapi`, Compose/Coil/Ktor **và Compottie** cho animation.
+
+---
+
+### Animation Lottie đa nền tảng với Compottie
+
+```kotlin
+import io.github.alexzhirkevich.compottie.LottieCompositionSpec
+import vn.momo.kits.components.animation.LottieAnimation
+
+@Composable
+fun SuccessState() {
+    LottieAnimation(
+        spec = LottieCompositionSpec.Url(
+            "https://assets10.lottiefiles.com/packages/lf20_jcikwtux.json"
+        )
+    )
+}
+```
+
+- `shared/build.gradle.kts` đã bật `coreLibraryDesugaringEnabled` để tương thích `compottie-dot`/`compottie-network` với `minSdk = 24`.
+- Nếu animation dùng asset/font nội bộ, kết hợp `compottie-resources` (`rememberResourcesAssetsManager`, `rememberResourcesFontManager`) để trỏ về `composeResources`.
+### NativeMaxApi 0.3.1
+
+Compose dùng typed `vn.momo.maxapi.IMaxApi` do host truyền vào `NavigationContainer`.
+Toolkit dùng overload `showToolkit(ToolkitOptions, callback)` để giữ nhóm tool tùy chỉnh,
+nhãn đa ngôn ngữ, icon, badge và `useSystemTools`. Callback trả `actionKey`; request đang chờ
+được hủy khi composition bị gỡ. Kits không đóng client do host sở hữu.
+
+Chạy `./gradlew :compose:testAndroidHostTest` để kiểm tra hủy request và callback đến muộn.

package/build.gradle.kts

@@ -0,0 +1,11 @@
+plugins {
+    // this is necessary to avoid the plugins to be loaded multiple times
+    // in each subproject's classloader
+    alias(libs.plugins.android.application) apply false
+    alias(libs.plugins.android.kotlin.multiplatform.library) apply false
+    alias(libs.plugins.compose) apply false
+    alias(libs.plugins.kotlin.compose.compiler) apply false
+    alias(libs.plugins.jetbrains.kotlin.multiplatform) apply false
+    alias(libs.plugins.jetbrains.kotlin.serialization) apply false
+    alias(libs.plugins.vanniktech.mavenPublish) apply false
+}

package/compose/build.gradle.kts

@@ -0,0 +1,189 @@
+// import com.vanniktech.maven.publish.JavadocJar
+// import com.vanniktech.maven.publish.KotlinMultiplatform
+import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+
+plugins {
+    alias(libs.plugins.jetbrains.kotlin.multiplatform)
+    // AI-GENERATED START: use the AGP 9 Kotlin Multiplatform Android library target
+    alias(libs.plugins.android.kotlin.multiplatform.library)
+    // AI-GENERATED END: use the AGP 9 Kotlin Multiplatform Android library target
+    alias(libs.plugins.compose)
+    alias(libs.plugins.kotlin.compose.compiler)
+//         alias(libs.plugins.vanniktech.mavenPublish)
+    id(libs.plugins.jetbrains.kotlin.cocoapods.get().pluginId)
+    kotlin("plugin.serialization")
+}
+
+val gitlabName: String = findProperty("name") as String? ?: ""
+val gitlabRepo: String = findProperty("repo") as String? ?: ""
+val gitlabUrl: String = findProperty("url") as String? ?: ""
+val gitlabGroup: String = findProperty("group") as String? ?: ""
+val gitlabArtifactId: String = findProperty("artifact.id") as String? ?: ""
+val gitlabVersion: String = findProperty("version") as String? ?: ""
+val gitlabUser: String = findProperty("gitlab.user") as String? ?: ""
+val gitlabKey: String = findProperty("gitlab.password") as String? ?: ""
+
+kotlin {
+    // AI-GENERATED START: configure the AGP 9 Android target and host tests
+    android {
+        namespace = "vn.momo.kits.kits"
+        compileSdk = 35
+        minSdk = 24
+        androidResources.enable = true
+        withHostTest {}
+        compilerOptions {
+            jvmTarget.set(JvmTarget.JVM_17)
+        }
+    }
+    // AI-GENERATED END: configure the AGP 9 Android target and host tests
+
+    val fwName = gitlabArtifactId
+    val iosTargets = listOf(iosArm64(), iosSimulatorArm64())
+    iosTargets.forEach {
+        it.binaries.framework {
+            baseName = fwName
+            binaryOption("bundleId", "$gitlabGroup.$fwName")
+            isStatic = true
+        }
+    }
+
+    cocoapods {
+        version = "0.0.2-alpha.1-debug"
+        summary = "IOS Shared module"
+        homepage = "https://momo.vn"
+        ios.deploymentTarget = "15.0"
+
+        framework {
+            baseName = fwName
+            isStatic = true
+        }
+
+        pod("lottie-ios") {
+            moduleName = "Lottie"
+            version = "4.4.3"
+            extraOpts += listOf("-compiler-option", "-fmodules")
+        }
+    }
+
+    sourceSets {
+        all {
+            languageSettings.optIn("vn.momo.kits.modifier.InternalApi")
+        }
+        commonMain.dependencies {
+            implementation(compose.runtime)
+            implementation(compose.material)
+            implementation(compose.material3)
+            implementation(compose.components.resources)
+            implementation(libs.compose.ui.backhandler)
+            implementation(libs.ktor.client.core)
+            implementation(libs.jetbrains.coroutines.core)
+            implementation(libs.navigation.multiplatform)
+            implementation(libs.coil.multiplatform.compose)
+            implementation(libs.coil.multiplatform.core)
+            implementation(libs.coil.multiplatform.network.ktor)
+            implementation(libs.jetbrains.serialization.json)
+            implementation(libs.kotlinx.datetime)
+            api(libs.native.max.api)
+            implementation(libs.compottie)
+            implementation(libs.gif.image)
+        }
+        androidMain.dependencies {
+            implementation(libs.ktor.client.okhttp)
+            implementation(libs.airbnb.lottie)
+        }
+        iosMain.dependencies {
+            implementation(libs.ktor.client.darwin)
+        }
+        // AI-GENERATED START: verify toolkit request ownership
+        commonTest.dependencies {
+            implementation(kotlin("test"))
+        }
+        // AI-GENERATED END: verify toolkit request ownership
+    }
+}
+
+repositories {
+    google {
+        mavenContent {
+            includeGroupAndSubgroups("androidx")
+            includeGroupAndSubgroups("com.android")
+            includeGroupAndSubgroups("com.google")
+        }
+    }
+    mavenCentral()
+    maven { url = uri("https://maven.pkg.jetbrains.space/public/p/compose/dev") }
+    maven {
+        url = uri("https://gitlab.mservice.com.vn/api/v4/projects/5400/packages/maven")
+        credentials {username = "download_packages"; password = "gldt-bjDqLpU_sPcHDuXau2ws" }
+    }
+    maven {
+        url = uri("https://artifacts.mservice.com.vn/repository/maven-momo-app/")
+        credentials {
+            username = "viewer"
+            password = "viewer"
+        }
+        isAllowInsecureProtocol = true
+    }
+}
+
+compose {
+    resources {
+        publicResClass = true
+        packageOfResClass = "vn.momo.uikits.resources"
+        generateResClass = always
+    }
+}
+
+// publishing {
+//     repositories {
+//         maven {
+//             name = "${gitlabRepo}Packages"
+//             credentials {
+//                 username = gitlabUser
+//                 password = gitlabKey
+//             }
+//             url = uri("$gitlabUrl")
+//         }
+//     }
+// }
+
+// mavenPublishing {
+//     configure(
+//         KotlinMultiplatform(
+//             javadocJar = JavadocJar.Empty(),
+//             // AI-GENERATED START: the AGP KMP target publishes a single Android variant
+//             sourcesJar = true,
+//             // AI-GENERATED END: the AGP KMP target publishes a single Android variant
+//         )
+//     )
+// 
+//     repositories {
+//         maven {
+//             name = "${gitlabRepo}Packages"
+//             credentials { username = gitlabUser; password = gitlabKey }
+//             url = uri("$gitlabUrl")
+//         }
+//     }
+// 
+//     coordinates(gitlabGroup.toString(), gitlabArtifactId, gitlabVersion.toString())
+// 
+//     pom {
+//         name = "$gitlabName Klib"
+//         description = "$gitlabName"
+//         url = "https://gitlab.mservice.com.vn"
+//         licenses {
+//             license {
+//                 name = "The Apache License, Version 2.0"
+//                 url = "https://www.apache.org/licenses/LICENSE-2.0.txt"
+//                 distribution = "https://www.apache.org/licenses/LICENSE-2.0.txt"
+//             }
+//         }
+//         developers {
+//             developer {
+//                 id = "kotlin-hands-on"
+//                 name = "Kotlin Developer Advocate"
+//                 url = "https://github.com/kotlin-hands-on/"
+//             }
+//         }
+//     }
+// }

package/compose/build.gradle.kts.backup

@@ -0,0 +1,189 @@
+import com.vanniktech.maven.publish.JavadocJar
+import com.vanniktech.maven.publish.KotlinMultiplatform
+import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+
+plugins {
+    alias(libs.plugins.jetbrains.kotlin.multiplatform)
+    // AI-GENERATED START: use the AGP 9 Kotlin Multiplatform Android library target
+    alias(libs.plugins.android.kotlin.multiplatform.library)
+    // AI-GENERATED END: use the AGP 9 Kotlin Multiplatform Android library target
+    alias(libs.plugins.compose)
+    alias(libs.plugins.kotlin.compose.compiler)
+    alias(libs.plugins.vanniktech.mavenPublish)
+    id(libs.plugins.jetbrains.kotlin.cocoapods.get().pluginId)
+    kotlin("plugin.serialization")
+}
+
+val gitlabName: String = findProperty("name") as String? ?: ""
+val gitlabRepo: String = findProperty("repo") as String? ?: ""
+val gitlabUrl: String = findProperty("url") as String? ?: ""
+val gitlabGroup: String = findProperty("group") as String? ?: ""
+val gitlabArtifactId: String = findProperty("artifact.id") as String? ?: ""
+val gitlabVersion: String = findProperty("version") as String? ?: ""
+val gitlabUser: String = findProperty("gitlab.user") as String? ?: ""
+val gitlabKey: String = findProperty("gitlab.password") as String? ?: ""
+
+kotlin {
+    // AI-GENERATED START: configure the AGP 9 Android target and host tests
+    android {
+        namespace = "$gitlabGroup.$gitlabArtifactId"
+        compileSdk = libs.versions.android.compileSdk.get().toInt()
+        minSdk = libs.versions.android.minSdk.get().toInt()
+        androidResources.enable = true
+        withHostTest {}
+        compilerOptions {
+            jvmTarget.set(JvmTarget.JVM_17)
+        }
+    }
+    // AI-GENERATED END: configure the AGP 9 Android target and host tests
+
+    val fwName = gitlabArtifactId
+    val iosTargets = listOf(iosArm64(), iosSimulatorArm64())
+    iosTargets.forEach {
+        it.binaries.framework {
+            baseName = fwName
+            binaryOption("bundleId", "$gitlabGroup.$fwName")
+            isStatic = true
+        }
+    }
+
+    cocoapods {
+        version = gitlabVersion
+        summary = "IOS Shared module"
+        homepage = "https://momo.vn"
+        ios.deploymentTarget = "15.0"
+
+        framework {
+            baseName = fwName
+            isStatic = true
+        }
+
+        pod("lottie-ios") {
+            moduleName = "Lottie"
+            version = "4.4.3"
+            extraOpts += listOf("-compiler-option", "-fmodules")
+        }
+    }
+
+    sourceSets {
+        all {
+            languageSettings.optIn("vn.momo.kits.modifier.InternalApi")
+        }
+        commonMain.dependencies {
+            implementation(compose.runtime)
+            implementation(compose.material)
+            implementation(compose.material3)
+            implementation(compose.components.resources)
+            implementation(libs.compose.ui.backhandler)
+            implementation(libs.ktor.client.core)
+            implementation(libs.jetbrains.coroutines.core)
+            implementation(libs.navigation.multiplatform)
+            implementation(libs.coil.multiplatform.compose)
+            implementation(libs.coil.multiplatform.core)
+            implementation(libs.coil.multiplatform.network.ktor)
+            implementation(libs.jetbrains.serialization.json)
+            implementation(libs.kotlinx.datetime)
+            api(libs.native.max.api)
+            implementation(libs.compottie)
+            implementation(libs.gif.image)
+        }
+        androidMain.dependencies {
+            implementation(libs.ktor.client.okhttp)
+            implementation(libs.airbnb.lottie)
+        }
+        iosMain.dependencies {
+            implementation(libs.ktor.client.darwin)
+        }
+        // AI-GENERATED START: verify toolkit request ownership
+        commonTest.dependencies {
+            implementation(kotlin("test"))
+        }
+        // AI-GENERATED END: verify toolkit request ownership
+    }
+}
+
+repositories {
+    google {
+        mavenContent {
+            includeGroupAndSubgroups("androidx")
+            includeGroupAndSubgroups("com.android")
+            includeGroupAndSubgroups("com.google")
+        }
+    }
+    mavenCentral()
+    maven { url = uri("https://maven.pkg.jetbrains.space/public/p/compose/dev") }
+    maven {
+        url = uri("https://gitlab.mservice.com.vn/api/v4/projects/5400/packages/maven")
+        credentials {username = "download_packages"; password = "gldt-bjDqLpU_sPcHDuXau2ws" }
+    }
+    maven {
+        url = uri("https://artifacts.mservice.com.vn/repository/maven-momo-app/")
+        credentials {
+            username = "viewer"
+            password = "viewer"
+        }
+        isAllowInsecureProtocol = true
+    }
+}
+
+compose {
+    resources {
+        publicResClass = true
+        packageOfResClass = "vn.momo.uikits.resources"
+        generateResClass = always
+    }
+}
+
+publishing {
+    repositories {
+        maven {
+            name = "${gitlabRepo}Packages"
+            credentials {
+                username = gitlabUser
+                password = gitlabKey
+            }
+            url = uri("$gitlabUrl")
+        }
+    }
+}
+
+mavenPublishing {
+    configure(
+        KotlinMultiplatform(
+            javadocJar = JavadocJar.Empty(),
+            // AI-GENERATED START: the AGP KMP target publishes a single Android variant
+            sourcesJar = true,
+            // AI-GENERATED END: the AGP KMP target publishes a single Android variant
+        )
+    )
+
+    repositories {
+        maven {
+            name = "${gitlabRepo}Packages"
+            credentials { username = gitlabUser; password = gitlabKey }
+            url = uri("$gitlabUrl")
+        }
+    }
+
+    coordinates(gitlabGroup.toString(), gitlabArtifactId, gitlabVersion.toString())
+
+    pom {
+        name = "$gitlabName Klib"
+        description = "$gitlabName"
+        url = "https://gitlab.mservice.com.vn"
+        licenses {
+            license {
+                name = "The Apache License, Version 2.0"
+                url = "https://www.apache.org/licenses/LICENSE-2.0.txt"
+                distribution = "https://www.apache.org/licenses/LICENSE-2.0.txt"
+            }
+        }
+        developers {
+            developer {
+                id = "kotlin-hands-on"
+                name = "Kotlin Developer Advocate"
+                url = "https://github.com/kotlin-hands-on/"
+            }
+        }
+    }
+}

package/compose/compose.podspec

@@ -0,0 +1,47 @@
+Pod::Spec.new do |spec|
+    spec.name                     = 'compose'
+    spec.version                  = '0.167.1-beta.4-debug'
+    spec.homepage                 = 'https://momo.vn'
+    spec.source                   = { :http=> ''}
+    spec.authors                  = ''
+    spec.license                  = ''
+    spec.summary                  = 'IOS Shared module'
+    spec.vendored_frameworks      = 'build/cocoapods/framework/kits.framework'
+    spec.libraries                = 'c++'
+    spec.ios.deployment_target    = '15.0'
+    spec.dependency 'lottie-ios', '4.4.3'
+    if !Dir.exist?('build/cocoapods/framework/kits.framework') || Dir.empty?('build/cocoapods/framework/kits.framework')
+        raise "
+        Kotlin framework 'kits' doesn't exist yet, so a proper Xcode project can't be generated.
+        'pod install' should be executed after running ':generateDummyFramework' Gradle task:
+            ./gradlew :compose:generateDummyFramework
+        Alternatively, proper pod installation is performed during Gradle sync in the IDE (if Podfile location is set)"
+    end
+    spec.xcconfig = {
+        'ENABLE_USER_SCRIPT_SANDBOXING' => 'NO',
+    }
+    spec.pod_target_xcconfig = {
+        'KOTLIN_PROJECT_PATH' => ':compose',
+        'PRODUCT_MODULE_NAME' => 'kits',
+    }
+    spec.script_phases = [
+        {
+            :name => 'Build compose',
+            :execution_position => :before_compile,
+            :shell_path => '/bin/sh',
+            :script => <<-SCRIPT
+                if [ "YES" = "$OVERRIDE_KOTLIN_BUILD_IDE_SUPPORTED" ]; then
+                    echo "Skipping Gradle build task invocation due to OVERRIDE_KOTLIN_BUILD_IDE_SUPPORTED environment variable set to \"YES\""
+                    exit 0
+                fi
+                set -ev
+                REPO_ROOT="$PODS_TARGET_SRCROOT"
+                "$REPO_ROOT/../gradlew" -p "$REPO_ROOT" $KOTLIN_PROJECT_PATH:syncFramework \
+                    -Pkotlin.native.cocoapods.platform=$PLATFORM_NAME \
+                    -Pkotlin.native.cocoapods.archs="$ARCHS" \
+                    -Pkotlin.native.cocoapods.configuration="$CONFIGURATION"
+            SCRIPT
+        }
+    ]
+    spec.resources = ['build/compose/cocoapods/compose-resources']
+end

package/compose/src/androidMain/kotlin/vn/momo/kits/const/HostFont.android.kt

@@ -0,0 +1,19 @@
+package vn.momo.kits.const
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.remember
+import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.text.font.Font
+import androidx.compose.ui.text.font.FontFamily
+
+@Composable
+internal actual fun hostFontFamily(fileName: String): FontFamily? {
+    val assets = LocalContext.current.applicationContext.assets
+    return remember(fileName) {
+        val path = "fonts/$fileName"
+        // AssetManager.open ném IOException nếu thiếu file; Font(path, assetManager) thì lỗi
+        // muộn lúc render nên phải kiểm tra tồn tại trước.
+        val exists = runCatching { assets.open(path).close() }.isSuccess
+        if (exists) FontFamily(Font(path = path, assetManager = assets)) else null
+    }
+}

package/compose/src/androidMain/kotlin/vn/momo/kits/navigation/ScrollToTop.android.kt

@@ -0,0 +1,6 @@
+package vn.momo.kits.navigation
+
+import androidx.compose.runtime.Composable
+
+@Composable
+internal actual fun RegisterScrollToTop(callback: (() -> Unit)?) = Unit

package/compose/src/androidMain/kotlin/vn/momo/kits/platform/BackGesture.android.kt

@@ -0,0 +1,12 @@
+package vn.momo.kits.platform
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.State
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+
+// No passive observer at androidx.activity 1.10.x; a second callback would steal the gesture.
+@Composable
+actual fun rememberBackGestureProgress(): State<Float?> = remember { mutableStateOf(null) }
+
+actual fun reportFloatingArrowBack(shouldUse: Boolean) = Unit

package/compose/src/androidMain/kotlin/vn/momo/kits/platform/OsFontScale.android.kt

@@ -0,0 +1,7 @@
+package vn.momo.kits.platform
+
+import androidx.compose.runtime.Composable
+
+// Android's LocalDensity.fontScale already tracks Configuration.fontScale live.
+@Composable
+actual fun ProvideOsFontScale(content: @Composable () -> Unit) = content()