@craft-native/ios 0.0.475 → 0.0.476

package/README.md

@@ -342,6 +342,11 @@ needs a solid bar.
 The `backgroundColor` navigation option is shared with the Android native host;
 omitting it or passing `null` returns to the app's dynamic light/dark colour.
 
+Set `titleColor` to a screen's text colour when its branded palette needs a
+different navigation title contrast. Both native hosts apply it to inline and
+large titles. Passing `null` restores the host's normal title colour; it does
+not change the bar material, button colours, or another screen's appearance.
+
 The optional Liquid Glass tab-bar styling is compiler-gated for Xcode 26/Swift 6.2 and later. Older SDKs compile the same tab bar with the material fallback, so generated projects remain buildable on Xcode 16.
 
 The iOS host overlays `craft.config.json` on its defaults. Missing or `null` capability flags stay disabled; explicitly set a flag to `true` to enable it. Both the Swift host and Zig bridge reject malformed values and fall back to all capabilities disabled.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craft-native/ios",
-  "version": "0.0.475",
+  "version": "0.0.476",
   "homepage": "https://github.com/craft-native/craft/tree/main/packages/ios#readme",
   "repository": {
     "type": "git",

package/templates/CraftNativeScreen.swift

@@ -7856,6 +7856,8 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
     /// the home indicator too, where its content never reaches: a black
     /// full-screen timer is black edge to edge. nil is the app's.
     private var screenBackgroundColor: UIColor?
+    /// Title contrast belongs to this screen, independently of the bar material.
+    private var navigationTitleColor: UIColor?
 
     override var preferredStatusBarStyle: UIStatusBarStyle {
         statusBarStyleOverride ?? .default
@@ -7926,6 +7928,9 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         if let solid = options["navigationBarSolid"] as? Bool {
             navigationBarSolid = solid
         }
+        if options.keys.contains("titleColor") {
+            navigationTitleColor = color(options["titleColor"])
+        }
         if let hidden = options["hidden"] as? Bool {
             navigationBarHidden = hidden
             if navigationController?.topViewController === self {
@@ -7941,7 +7946,7 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
             let buttons = (options["rightButtons"] as? [[String: Any]]) ?? []
             navigationItem.rightBarButtonItems = buttons.compactMap(navigationButton).reversed()
         }
-        if options.keys.contains("backgroundColor") || options.keys.contains("navigationBarSolid") {
+        if options.keys.contains("backgroundColor") || options.keys.contains("navigationBarSolid") || options.keys.contains("titleColor") {
             applyNavigationBarAppearance()
             trackContentScrollView()
         }
@@ -7952,25 +7957,44 @@ final class CraftNativeScreenController: UIViewController, UIScrollViewDelegate,
         }
     }
 
-    /// Applies the screen's optional opaque bar without changing the default
-    /// UIKit material when the screen did not opt in.
+    /// Per-item appearances preserve each UIKit bar state and never recolour a
+    /// sibling controller's title or opt a material bar into an opaque fill.
     private func applyNavigationBarAppearance() {
-        guard navigationBarSolid else {
+        guard navigationBarSolid || navigationTitleColor != nil else {
             navigationItem.standardAppearance = nil
             navigationItem.scrollEdgeAppearance = nil
             navigationItem.compactAppearance = nil
             navigationItem.compactScrollEdgeAppearance = nil
             return
         }
-        let appearance = UINavigationBarAppearance()
-        appearance.configureWithOpaqueBackground()
-        appearance.backgroundColor = screenBackgroundColor ?? config.resolvedBackgroundColor
-        appearance.shadowColor = .clear
-        CraftChromeFonts.apply(to: appearance)
-        navigationItem.standardAppearance = appearance
-        navigationItem.scrollEdgeAppearance = appearance
-        navigationItem.compactAppearance = appearance
-        navigationItem.compactScrollEdgeAppearance = appearance
+        let bar = navigationController?.navigationBar
+        let standard = bar?.standardAppearance ?? UINavigationBarAppearance()
+        // UIKit's unspecified scroll-edge appearance uses a transparent
+        // background. Copy its standard text/button attributes before applying
+        // that background so adding title contrast preserves the same states.
+        let scrollEdge = bar?.scrollEdgeAppearance ?? {
+            let appearance = UINavigationBarAppearance(barAppearance: standard)
+            appearance.configureWithTransparentBackground()
+            return appearance
+        }()
+        func styled(_ base: UINavigationBarAppearance) -> UINavigationBarAppearance {
+            let appearance = UINavigationBarAppearance(barAppearance: base)
+            if navigationBarSolid {
+                appearance.configureWithOpaqueBackground()
+                appearance.backgroundColor = screenBackgroundColor ?? config.resolvedBackgroundColor
+                appearance.shadowColor = .clear
+            }
+            CraftChromeFonts.apply(to: appearance)
+            if let navigationTitleColor {
+                appearance.titleTextAttributes[.foregroundColor] = navigationTitleColor
+                appearance.largeTitleTextAttributes[.foregroundColor] = navigationTitleColor
+            }
+            return appearance
+        }
+        navigationItem.standardAppearance = styled(standard)
+        navigationItem.scrollEdgeAppearance = styled(scrollEdge)
+        navigationItem.compactAppearance = styled(bar?.compactAppearance ?? standard)
+        navigationItem.compactScrollEdgeAppearance = styled(bar?.compactScrollEdgeAppearance ?? scrollEdge)
     }
 
     private func applyStatusBar(_ props: [String: Any]) {