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

package/ios/Application/HeaderRight.swift

@@ -101,98 +101,69 @@ struct ToolkitHeaderRight: View {
     var tintColor: Color?
     @State private var isFavorite: Bool = false
     @State private var isLoading: Bool = false
-    @Environment(\.applicationEnvironment) private var environment
-
-    private func apiValue(_ value: Any?) -> Any {
-        value ?? NSNull()
-    }
-
-    private var contextMap: [String: Any] {
-        let context = environment.applicationContext
-        return [
-            "appId": apiValue(context?.appId),
-            "code": apiValue(context?.appCode),
-            "name": apiValue(context?.appName),
-            "icon": apiValue(context?.appIcon),
-            "description": apiValue(context?.description),
-            "support": apiValue(context?.support),
-            "toolkitConfig": apiValue(context?.toolkitConfig),
-            "providerId": apiValue(context?.providerId),
-            "permissions": apiValue(context?.permissions)
-        ]
-    }
-
-    private var shouldShowShortcut: Bool {
-        headerRight?.useShortcut == true && !(headerRight?.useMore == true && environment.applicationContext == nil)
-    }
-
-    private func parseResponse(_ response: String) -> Any? {
-        guard let jsonData = response.data(using: .utf8),
-              let json = try? JSONSerialization.jsonObject(with: jsonData) as? [String: Any] else {
-            return nil
-        }
-        return json["response"]
-    }
+    @EnvironmentObject private var environment: ApplicationEnvironment
     
     // MARK: - Actions
-    private func loadFavoriteState() {
-        environment.composeApi?.request(
-            funcName: "isFavoriteApp",
-            params: ["code": apiValue(environment.applicationContext?.appCode)]
-        ) { response in
-            if let isFavorite = parseResponse(response) as? Bool {
-                self.isFavorite = isFavorite
-            }
-        }
-    }
-
     private func onPressShortcut() {
         environment.composeApi?.request(
             funcName: "onToolAction",
-            params: [
-                "item": ["key": "onFavorite"],
-                "context": contextMap
-            ]
-        ) { response in
-            if let result = parseResponse(response) as? [String: Any],
-               result["success"] as? Bool == true {
-                isFavorite.toggle()
-            }
+            params: ["item": ["key": "onFavorite"]]
+        ) { _ in
+            isFavorite.toggle()
         }
     }
     
     private func onPressHelpCenter() {
+        let context = environment.applicationContext
+        let paramMap: [String: Any] = [
+            "appId": context?.appId,
+            "code": context?.appCode,
+            "name": context?.appName,
+            "icon": context?.appIcon,
+            "description": context?.description
+        ]
         environment.composeApi?.request(
             funcName: "showHelpCenter",
-            params: [
-                "appId": apiValue(environment.applicationContext?.appId),
-                "code": apiValue(environment.applicationContext?.appCode),
-                "name": apiValue(environment.applicationContext?.appName),
-                "icon": apiValue(environment.applicationContext?.appIcon),
-                "description": apiValue(environment.applicationContext?.description)
-            ]
+            params: paramMap
         ) { _ in }
     }
     
     private func onPressClose() {
         environment.composeApi?.request(
             funcName: "dismissAll",
-            params: nil
+            params: ""
         ) { _ in }
     }
     
     private func onPressMore() {
+        let context = environment.applicationContext
         let params: [String: Any] = [
-            "useSystemTools": headerRight?.useSystemTools ?? true,
+            "useSystemTools": headerRight?.useSystemTools,
             "tools": headerRight?.tools.map { $0.toMap() } ?? [],
-            "context": contextMap
+            "context": [
+                "appId": context?.appId,
+                "code": context?.appCode,
+                "name": context?.appName,
+                "icon": context?.appIcon,
+                "description": context?.description,
+                "support": context?.support,
+                "toolkitConfig": context?.toolkitConfig,
+                "providerId": context?.providerId,
+                "permissions": context?.permissions
+            ]
         ]
         environment.composeApi?.request(
             funcName: "showTools",
             params: params
         ) { response in
-            if let toolResponse = parseResponse(response) as? String {
-                headerRight?.toolCallback?(toolResponse)
+            do {
+                if let jsonData = response.data(using: .utf8),
+                   let json = try JSONSerialization.jsonObject(with: jsonData) as? [String: Any],
+                   let toolResponse = json["response"] as? String {
+                    headerRight?.toolCallback?(toolResponse)
+                }
+            } catch {
+                print("Error parsing response:", error)
             }
         }
     }
@@ -224,7 +195,7 @@ struct ToolkitHeaderRight: View {
         } ?? false
         
         HStack(alignment: .center, spacing: 0) {
-            if shouldShowShortcut {
+            if headerRight?.useShortcut == true {
                 NavigationButton(
                     disabled: isLoading,
                     icon: navButtonConfig.icon,
@@ -235,17 +206,15 @@ struct ToolkitHeaderRight: View {
             }
             
             HStack(alignment: .center, spacing: 0) {
-                if environment.applicationContext != nil {
-                    Icon(source: "help_center", size: 20, color: tintColor ?? Colors.black17)
-                        .padding(4)
-                        .onTapGesture {
-                            onPressHelpCenter()
-                        }
-                    
-                    Rectangle()
-                        .fill(tintColor ?? Colors.black20)
-                        .frame(width: 0.5, height: 12)
-                }
+                Icon(source: "help_center", size: 20, color: tintColor ?? Colors.black17)
+                    .padding(4)
+                    .onTapGesture {
+                        onPressHelpCenter()
+                    }
+                
+                Rectangle()
+                    .fill(tintColor ?? Colors.black20)
+                    .frame(width: 0.5, height: 12)
                 
                 Icon(source: "16_basic_home", size: 20, color: tintColor ?? Colors.black17)
                     .padding(4)
@@ -262,9 +231,6 @@ struct ToolkitHeaderRight: View {
             )
             .padding(.leading, Spacing.S)
         }
-        .onAppear {
-            loadFavoriteState()
-        }
     }
 }
 

package/ios/Application/LanguageSource.swift

@@ -0,0 +1,93 @@
+// File: ios/Application/LanguageSource.swift
+// Created At: 2026-07-29 10:00:00 +07:00
+// Created By: AI
+// AI Agent: Claude Code
+// Model: claude-opus-5[1m]
+
+// AI-GENERATED START: observe the host app's active language so Localize can follow it
+import Foundation
+
+/// Read-only view of the host app's active language, plus change delivery.
+/// Values handed to `onChange` are already normalized to `Localize.VI` / `Localize.EN`.
+public protocol LanguageSource: AnyObject {
+    var currentLanguage: String { get }
+    /// `onChange` may be invoked on any thread; `Localize` dedupes and hops to main.
+    func startObserving(_ onChange: @escaping (String) -> Void)
+    func stopObserving()
+}
+
+/// Reads the language the MoMo host app persists in `UserDefaults`. All three host writers
+/// (the `RNResource` RN bridge, `JSONLocalization`, and the KMP `LocalizationProvider`) write the
+/// same key on `UserDefaults.standard` in-process, so KVO on it sees every one of them.
+public final class UserDefaultsLanguageSource: NSObject, LanguageSource {
+    public static let defaultKey = "language"
+
+    private let defaults: UserDefaults
+    private let key: String
+    private var onChange: ((String) -> Void)?
+    private var isObserving = false
+    private var kvoContext = 0
+
+    /// - Note: `key` must not contain `.` — `forKeyPath:` would read it as a key path.
+    public init(
+        defaults: UserDefaults = .standard,
+        key: String = UserDefaultsLanguageSource.defaultKey
+    ) {
+        self.defaults = defaults
+        self.key = key
+        super.init()
+    }
+
+    public var currentLanguage: String {
+        Localize.normalize(defaults.string(forKey: key))
+    }
+
+    public func startObserving(_ onChange: @escaping (String) -> Void) {
+        guard !isObserving else { return }
+        isObserving = true
+        self.onChange = onChange
+        defaults.addObserver(self, forKeyPath: key, options: [.new], context: &kvoContext)
+        // Safety net for writes KVO can miss (e.g. `removeObject`). Double delivery is free:
+        // `Localize` dedupes before touching `@Published`.
+        NotificationCenter.default.addObserver(
+            self,
+            selector: #selector(emit),
+            name: UserDefaults.didChangeNotification,
+            object: defaults
+        )
+    }
+
+    public func stopObserving() {
+        guard isObserving else { return }
+        isObserving = false
+        defaults.removeObserver(self, forKeyPath: key, context: &kvoContext)
+        NotificationCenter.default.removeObserver(
+            self,
+            name: UserDefaults.didChangeNotification,
+            object: defaults
+        )
+        onChange = nil
+    }
+
+    deinit {
+        stopObserving()
+    }
+
+    public override func observeValue(
+        forKeyPath keyPath: String?,
+        of object: Any?,
+        change: [NSKeyValueChangeKey: Any]?,
+        context: UnsafeMutableRawPointer?
+    ) {
+        guard context == &kvoContext else {
+            super.observeValue(forKeyPath: keyPath, of: object, change: change, context: context)
+            return
+        }
+        emit()
+    }
+
+    @objc private func emit() {
+        onChange?(currentLanguage)
+    }
+}
+// AI-GENERATED END: observe the host app's active language so Localize can follow it

package/ios/Application/Localize.swift

@@ -28,16 +28,69 @@ public final class Localize: ObservableObject {
     public static let VI = "vi"
     public static let EN = "en"
 
+    // AI-GENERATED START: follow the host app language and publish dictionary changes
+    /// App-wide instance bound to the host language; the environment default uses it too,
+    /// so every screen agrees on one language.
+    public static let shared = Localize()
+    // AI-GENERATED END: follow the host app language and publish dictionary changes
+
     private var assets: LocalizationObject
     @Published public private(set) var currentLanguage: String = Localize.VI
 
-    public init(_ translations: LocalizationObject = LocalizationObject()) {
+    // AI-GENERATED START: follow the host app language and publish dictionary changes
+    /// Bumped by `addTranslations` — `assets` is not published, so without this the dictionary
+    /// can change without any consumer re-rendering.
+    @Published public private(set) var revision: Int = 0
+
+    private let languageSource: LanguageSource?
+
+    /// `NavigationContainer` uses this to skip its legacy one-shot `MaxApi` pull.
+    var observesAppLanguage: Bool { languageSource != nil }
+
+    /// Pass `languageSource: nil` to opt out and keep the old "starts at vi" behavior.
+    public init(
+        _ translations: LocalizationObject = LocalizationObject(),
+        languageSource: LanguageSource? = UserDefaultsLanguageSource()
+    ) {
         self.assets = Localize.merge(base: Localize.defaultLanguage, override: translations)
+        self.languageSource = languageSource
+        guard let languageSource else { return }
+        // Seed synchronously so the first frame is already correct (no vi -> en flash).
+        currentLanguage = languageSource.currentLanguage
+        languageSource.startObserving { [weak self] language in self?.apply(language) }
+    }
+
+    deinit {
+        languageSource?.stopObserving()
+    }
+
+    /// Host values are sometimes legacy JSON-quoted (`"\"vi\""`); anything that is not `en` is `vi`.
+    public static func normalize(_ raw: String?) -> String {
+        let cleaned = (raw ?? "")
+            .replacingOccurrences(of: "\"", with: "")
+            .trimmingCharacters(in: .whitespacesAndNewlines)
+            .lowercased()
+        return cleaned == Localize.EN ? Localize.EN : Localize.VI
+    }
+
+    private func apply(_ language: String) {
+        // KVO and didChangeNotification both fire for one write; publish once, on main.
+        onMain {
+            guard self.currentLanguage != language else { return }
+            self.currentLanguage = language
+        }
+    }
+
+    /// Synchronous when already on main — an async hop would defer the switch by a frame.
+    private func onMain(_ work: @escaping () -> Void) {
+        if Thread.isMainThread { work() } else { DispatchQueue.main.async(execute: work) }
     }
 
+    /// A local override: the next host language change supersedes it.
     public func changeLanguage(_ language: String?) {
-        currentLanguage = (language == Localize.EN) ? Localize.EN : Localize.VI
+        apply(Localize.normalize(language))
     }
+    // AI-GENERATED END: follow the host app language and publish dictionary changes
 
     public func translate(_ key: String) -> String {
         let dictionary = currentLanguage == Localize.EN ? assets.en : assets.vi
@@ -58,6 +111,9 @@ public final class Localize: ObservableObject {
     /// Existing keys win (mirrors Compose: `merge(translations, assets)`).
     public func addTranslations(_ translations: LocalizationObject) {
         assets = Localize.merge(base: translations, override: assets)
+        // AI-GENERATED START: publish dictionary changes so consumers re-render
+        onMain { self.revision &+= 1 }
+        // AI-GENERATED END: publish dictionary changes so consumers re-render
     }
 
     private static func merge(base: LocalizationObject, override: LocalizationObject) -> LocalizationObject {
@@ -283,14 +339,22 @@ public final class Localize: ObservableObject {
 private struct LocalizeBox: Equatable {
     let localize: Localize
     let language: String
+    // AI-GENERATED START: invalidate consumers when the dictionary changes, not just the language
+    let revision: Int
+    // AI-GENERATED END: invalidate consumers when the dictionary changes, not just the language
 
     init(_ localize: Localize) {
         self.localize = localize
         self.language = localize.currentLanguage
+        // AI-GENERATED START: invalidate consumers when the dictionary changes, not just the language
+        self.revision = localize.revision
+        // AI-GENERATED END: invalidate consumers when the dictionary changes, not just the language
     }
 
     static func == (lhs: LocalizeBox, rhs: LocalizeBox) -> Bool {
-        lhs.localize === rhs.localize && lhs.language == rhs.language
+        // AI-GENERATED START: invalidate consumers when the dictionary changes, not just the language
+        lhs.localize === rhs.localize && lhs.language == rhs.language && lhs.revision == rhs.revision
+        // AI-GENERATED END: invalidate consumers when the dictionary changes, not just the language
     }
 }
 
@@ -298,7 +362,12 @@ private struct LocalizeKey: EnvironmentKey {
     /// A default-constructed `Localize` already carries the full kit dictionary, so a
     /// consumer that never injects one renders untranslated-but-correct text instead of
     /// trapping the way `@EnvironmentObject` does.
-    static let defaultValue = LocalizeBox(Localize())
+    // AI-GENERATED START: default to the app-language-observing shared instance
+    /// `defaultValue` is a `static let`, so this box is never rebuilt: without a provider the
+    /// language is right on first render but does not live-update. Wrap the root in
+    /// `.momoLocalize()` (or use `NavigationContainer`) to get updates.
+    static let defaultValue = LocalizeBox(Localize.shared)
+    // AI-GENERATED END: default to the app-language-observing shared instance
 }
 
 public extension EnvironmentValues {

package/ios/Application/LocalizeModifier.swift

@@ -0,0 +1,30 @@
+// File: ios/Application/LocalizeModifier.swift
+// Created At: 2026-07-29 10:00:00 +07:00
+// Created By: AI
+// AI Agent: Claude Code
+// Model: claude-opus-5[1m]
+
+// AI-GENERATED START: inject a language-observing Localize into any SwiftUI subtree
+import SwiftUI
+
+public extension View {
+    /// Injects an app-language-observing `Localize` and re-renders this subtree on change.
+    /// Use at every `UIHostingController` root that is not inside a `NavigationContainer`.
+    func momoLocalize(_ localize: Localize = .shared) -> some View {
+        modifier(MomoLocalizeModifier(localize: localize))
+    }
+}
+
+/// `@ObservedObject` is load-bearing: `@Environment(\.localize)` only invalidates when the boxed
+/// value changes, which requires *this* body to re-run on every publish. A plain helper that just
+/// set `\.localize` would inject a snapshot that never updates.
+private struct MomoLocalizeModifier: ViewModifier {
+    @ObservedObject var localize: Localize
+
+    func body(content: Content) -> some View {
+        content
+            .environmentObject(localize)
+            .environment(\.localize, localize)
+    }
+}
+// AI-GENERATED END: inject a language-observing Localize into any SwiftUI subtree

package/ios/Application/Navigation/NavigationContainer.swift

@@ -46,7 +46,9 @@ public struct NavigationContainer<Initial: View>: View {
                 maxApi: maxApi
             )
         )
-        _localize = StateObject(wrappedValue: localize ?? Localize())
+        // AI-GENERATED START: default to the app-language-observing shared Localize
+        _localize = StateObject(wrappedValue: localize ?? Localize.shared)
+        // AI-GENERATED END: default to the app-language-observing shared Localize
         self.composeApi = composeApi
         self.maxApi = maxApi
         self.setNavigator = setNavigator
@@ -62,15 +64,19 @@ public struct NavigationContainer<Initial: View>: View {
         .environmentObject(navigator)
         .environmentObject(applicationEnvironment)
         .environment(\.applicationEnvironment, applicationEnvironment)
-        .environmentObject(localize)
-        .environment(\.localize, localize)
+        // AI-GENERATED START: route Localize + font-scale injection through the observing modifiers
+        .momoLocalize(localize)
+        .momoFontScale(context: applicationEnvironment.applicationContext)
+        // AI-GENERATED END: route Localize + font-scale injection through the observing modifiers
         .fullScreenCover(item: $navigator.presented) { route in
             screenView(forDialog: route)
                 .environmentObject(navigator)
                 .environmentObject(applicationEnvironment)
                 .environment(\.applicationEnvironment, applicationEnvironment)
-                .environmentObject(localize)
-                .environment(\.localize, localize)
+                // AI-GENERATED START: route Localize + font-scale injection through the observing modifiers
+                .momoLocalize(localize)
+                .momoFontScale(context: applicationEnvironment.applicationContext)
+                // AI-GENERATED END: route Localize + font-scale injection through the observing modifiers
         }
         .overlay {
             if let item = navigator.overplay {
@@ -78,8 +84,10 @@ public struct NavigationContainer<Initial: View>: View {
                     .environmentObject(navigator)
                     .environmentObject(applicationEnvironment)
                     .environment(\.applicationEnvironment, applicationEnvironment)
-                    .environmentObject(localize)
-                    .environment(\.localize, localize)
+                    // AI-GENERATED START: route Localize + font-scale injection through the observing modifiers
+                    .momoLocalize(localize)
+                    .momoFontScale(context: applicationEnvironment.applicationContext)
+                    // AI-GENERATED END: route Localize + font-scale injection through the observing modifiers
             }
         }
         .onAppear {
@@ -87,13 +95,21 @@ public struct NavigationContainer<Initial: View>: View {
                 navigator.composeApi = composeApi
             }
             setNavigator?(navigator)
-            // Mirrors Compose's LaunchedEffect(maxApi, resolvedLocalize): host-reported
-            // language wins over the default "vi" only when it resolves to English.
+            // Register with the host swipe-back bridge (mirrors ComposeAppContainer's
+            // ComposeNavigatorManager.push). Idempotent, so a re-appear won't double-count.
+            NavigatorManager.shared.push(navigator)
+            // AI-GENERATED START: demote the MaxApi language pull to a seed of last resort
+            // Only a seed: a Localize with a language source already tracks the host in both
+            // directions, so asking maxApi would just race it. `changeLanguage` normalizes the
+            // raw response and hops to main itself.
+            guard !localize.observesAppLanguage else { return }
             maxApi?.getLanguage { data in
-                if parseLanguage(data) == Localize.EN {
-                    localize.changeLanguage(Localize.EN)
-                }
+                localize.changeLanguage(data?["response"] as? String)
             }
+            // AI-GENERATED END: demote the MaxApi language pull to a seed of last resort
+        }
+        .onDisappear {
+            NavigatorManager.shared.remove(navigator)
         }
     }
 
@@ -195,9 +211,3 @@ private func safeAreaBottomInset() -> CGFloat {
         .compactMap { ($0 as? UIWindowScene)?.keyWindow?.safeAreaInsets.bottom }
         .first ?? 0
 }
-
-private func parseLanguage(_ raw: [String: Any?]?) -> String? {
-    guard let response = (raw?["response"] as? String)?.trimmingCharacters(in: .whitespaces).lowercased(),
-          !response.isEmpty else { return nil }
-    return response.hasPrefix(Localize.EN) ? Localize.EN : Localize.VI
-}