@momo-kits/native-kits 0.167.1-duo.18 → 0.167.1-duo.19-debug

package/CLAUDE.md

@@ -56,11 +56,13 @@ Publishing is automated (`publish.sh` + GitLab CI on `[ci build]` / `main`). Do
 
 ## SwiftUI kit (`ios/`)
 
-- **Layout mirrors Compose:** `ios/Navigation/` follows `navigation/` file for file (`NavigationContainer`, `Navigator`, `Navigation` (options + per-screen `Navigation`), `StackScreen` (incl. `NavigationFooter`), `BottomSheet`, `ModalScreen`, `HostBackGestureBridge`, `BottomTab/`, `Component/`, `Tracking/`); `ios/Layout/ScreenLayout.swift` mirrors `layout/`. `ios/Application/` keeps only context (`ApplicationEnvironment`), `Localize*`, `MaxApi` and the deprecated `Screen` / `LegacyHeader` (Compose `application/`). Change a navigation piece on both sides together.
+- **Layout mirrors Compose:** `ios/Navigation/` follows `navigation/` file for file (`NavigationContainer`, `Navigator`, `Navigation` (options + per-screen `Navigation`), `StackScreen` (incl. `NavigationFooter`), `StackTransition`, `SwipeBackHaptic`, `BottomSheet`, `ModalScreen`, `HostBackGestureBridge`, `BottomTab/`, `Component/`, `Tracking/`); `ios/Layout/ScreenLayout.swift` mirrors `layout/`. `ios/Application/` keeps only context (`ApplicationEnvironment`), `Localize*`, `MaxApi` and the deprecated `Screen` / `LegacyHeader` (Compose `application/`). Change a navigation piece on both sides together.
 - **File basenames must be unique across the pod** — Swift fails with "filename used twice" even in different folders (hence `LegacyHeader.swift` next to `Navigation/Component/Header.swift`). New folders under `ios/` must be added to `source_files` in `ios/native-kits.podspec`.
 - Screens update their own chrome at runtime through `@EnvironmentObject var navigation: Navigation` → `setOptions { $0.title = … }` (Compose `LocalNavigation`); bottom tabs keep one `Navigation` per tab. The host back bridge is `HostBackGestureBridge.shared` (`NavigatorManager` is a deprecated alias); a bottom tab off its first tab routes back to the first tab (`Navigator.tabBackHandler`, keyed by the hosting screen).
-- The pod's minimum is **iOS 15**, but the navigation shell (`NavigationContainer`, `Navigator`, `HostBackGestureBridge`, `BottomTab`, overplay views) is **iOS 16+** (`@available(iOS 16.0, *)`) because it is built on `NavigationStack`. Keep components outside that shell iOS 15-compatible.
-- `present` opens one `fullScreenCover` that hosts its own `NavigationStack` (`Navigator.presentedPath`): pushes and pops act on the presented flow while it is up, and each overplay (modal / bottom sheet / snackbar) renders in the context it was shown over (`OverplayItem.presentedId`).
+- Everything, navigation shell included, supports the pod's minimum **iOS 15** — no `@available` gates on public types. iOS 16+ APIs only behind `#available` with an iOS 15 path (`Layout`: `BottomSheet` `CapHeight`, `GridFlow` → `_VariadicView` flow row).
+- **Usage is `NavigationContainer` + `Navigator` + `Navigation` only**; the kit owns the stack, transitions, overplays and back gesture. There is no `NavigationStack`: `StackTransition.swift` holds `StackHost` (representable) + `StackController`, the NavHost counterpart. Each entry gets its own `UIHostingController`, kept while on the stack and removed from the window while covered (state kept, onDisappear / onAppear like UINavigationController). Motion is a SwiftUI `offset` per card driven by one `coverage` value on a display link (a UIKit transform would move the safe area); it is Compose `StackTransition` 1:1 (RN `forStackTransitionWithOverlay`: linear 300ms slide, 0.3 parallax, `pink09` scrim to 0.6, 8pt edge shadow to 0.3). Card roots get the container environment via `.environment(\.self, …)` with the kit environment re-applied on top, so host environment objects reach screens.
+- One back stack, root first (`Navigator.entries`, Compose's back stack): `present` appends a dialog entry that rises (FastOutSlowIn 300ms) and later pushes stack on top of it; `dismiss` drops the topmost dialog and everything above it (slides down whole); `popToRoot` returns to the active flow's root. Overplays (modal / bottom sheet / snackbar) render inside the screen they were shown over (`OverplayItem.screenId`, Compose `currentRootId`), so a later push slides over them.
+- Host back gesture: `HostBackGestureBridge.started` / `progressed` / `completed` / `cancelled` scrub the pop (`Navigator.backStarted` …) only for a plain pop; tab back, `onBackHandler`, `preventBack`, an open overplay or a presented top wait for the release and go through `onBackSafe`. `SwipeBackHaptic` ticks at 50pt (`MaxApi.triggerEventVibration`, default = system light impact).
 - Icons are compiled in: `ios/Icon/Icons.swift` is generated from Compose `utils/Icons.kt` by `node scripts/gen-ios-icons.mjs` — don't hand-edit it. A host `icon.json` in the main bundle only adds keys the kit lacks.
 - Bundled assets (colors, Lottie JSON) live in `ios/Resources` and ship in the `MoMoUIKitsResources` bundle; load them through `MoMoUIKitsResources.bundle`, never `Bundle.main`.
 

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.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,204 @@
+// 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)
+    alias(libs.plugins.android.library)
+    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 {
+    androidTarget {
+        compilerOptions {
+            jvmTarget.set(JvmTarget.JVM_17)
+        }
+        publishLibraryVariants("release")
+    }
+
+    val fwName = gitlabArtifactId
+    val iosTargets = listOf(iosArm64(), iosSimulatorArm64())
+    iosTargets.forEach {
+        it.binaries.framework {
+            baseName = fwName
+            binaryOption("bundleId", "$gitlabGroup.$fwName")
+            isStatic = true
+        }
+    }
+
+    cocoapods {
+        version = "0.167.1-duo.19-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)
+        }
+    }
+}
+
+android {
+    namespace = "vn.momo.kits.kits"
+    compileSdk = 35
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+    defaultConfig {
+        minSdk = 24
+    }
+}
+
+dependencies {
+}
+
+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(),
+//             sourcesJar = true,
+//             androidVariantsToPublish = listOf("release")
+//         )
+//     )
+// 
+//     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/"
+//             }
+//         }
+//     }
+// }
+
+// Xcode 27 rejects pods below iOS 15 (lottie-ios 4.4.3 declares 13.0), and the synthetic Podfile has no post_install hook.
+val syntheticPodsProject = layout.buildDirectory.file("cocoapods/synthetic/ios/Pods/Pods.xcodeproj/project.pbxproj")
+tasks.matching { it.name.startsWith("podInstallSynthetic") }.configureEach {
+    doLast {
+        val pbxproj = syntheticPodsProject.get().asFile
+        if (!pbxproj.exists()) return@doLast
+        val target = Regex("IPHONEOS_DEPLOYMENT_TARGET = ([0-9.]+);")
+        pbxproj.writeText(pbxproj.readText().replace(target) { match ->
+            val major = match.groupValues[1].substringBefore('.').toIntOrNull() ?: 0
+            if (major < 15) "IPHONEOS_DEPLOYMENT_TARGET = 15.0;" else match.value
+        })
+    }
+}

package/compose/build.gradle.kts.backup

@@ -0,0 +1,204 @@
+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)
+    alias(libs.plugins.android.library)
+    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 {
+    androidTarget {
+        compilerOptions {
+            jvmTarget.set(JvmTarget.JVM_17)
+        }
+        publishLibraryVariants("release")
+    }
+
+    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)
+        }
+    }
+}
+
+android {
+    namespace = "$gitlabGroup.$gitlabArtifactId"
+    compileSdk = libs.versions.android.compileSdk.get().toInt()
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+    defaultConfig {
+        minSdk = libs.versions.android.minSdk.get().toInt()
+    }
+}
+
+dependencies {
+}
+
+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(),
+            sourcesJar = true,
+            androidVariantsToPublish = listOf("release")
+        )
+    )
+
+    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/"
+            }
+        }
+    }
+}
+
+// Xcode 27 rejects pods below iOS 15 (lottie-ios 4.4.3 declares 13.0), and the synthetic Podfile has no post_install hook.
+val syntheticPodsProject = layout.buildDirectory.file("cocoapods/synthetic/ios/Pods/Pods.xcodeproj/project.pbxproj")
+tasks.matching { it.name.startsWith("podInstallSynthetic") }.configureEach {
+    doLast {
+        val pbxproj = syntheticPodsProject.get().asFile
+        if (!pbxproj.exists()) return@doLast
+        val target = Regex("IPHONEOS_DEPLOYMENT_TARGET = ([0-9.]+);")
+        pbxproj.writeText(pbxproj.readText().replace(target) { match ->
+            val major = match.groupValues[1].substringBefore('.').toIntOrNull() ?: 0
+            if (major < 15) "IPHONEOS_DEPLOYMENT_TARGET = 15.0;" else match.value
+        })
+    }
+}

package/compose/compose.podspec

@@ -0,0 +1,47 @@
+Pod::Spec.new do |spec|
+    spec.name                     = 'compose'
+    spec.version                  = '0.167.1-duo.15-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()