feat(you): build out the You tab's tip card (#618)

* feat(you): build out the You tab's tip card

The tab shipped as a card and two settings rows. This fills in the rest of the
page (node 9276:4634): the copyable public link, Share and Download, and a card
that expands in place — everything below it slides out, the tab bar goes with it,
and the card grows about its own centre into the middle of the screen. Expansion
lives on the page rather than the app-root bill overlay, so the card never leaves
the tab; `Session.presentOwnTipcard` and its test go with the overlay route.

Download exports the code as a real file. Both formats draw the same figure at
1024pt on the app's background: the SVG comes from the shared Kotlin renderer in
`SharedCoreKit` (`KikCode.svg`), the PNG from the `CodeView` the app already
draws, so exporting one and then the other gives you the same code twice. The
file goes to the share sheet, which is where iOS keeps "Save to Files".

Settings picked up the loose ends: Beta Features absorbed the developer-only
Beta Flags screen (one screen, two sections, gated on the version easter egg)
rather than keeping a second entry point that opened an empty list.

* fix(you): present the export share sheet after the picker closes

The download sheet handed the file to `ShareSheet` from its own tap
handler, while the picker was still on screen. `ShareSheet` presents on
the top-most view controller, which at that moment is the picker being
dismissed — so the share sheet had a fair chance of never appearing.

Holds the tapped format and exports on the sheet's `onDismiss` instead,
when there is a settled controller to present on.

* fix(settings): always offer the Beta Features row

The row was hidden when no flag was visible, on the reasoning that it
would open an empty screen. The screen has an empty state for exactly
that case, so the row stays put and `hasVisibleOptions` now only decides
which of the two the screen draws.

* test(you): add Maestro flows for the tip card export and Beta Features

Drives what the unit tests can't reach: the download picker's hand-off to
the system share sheet, which is a UIKit presentation the export path
gets wrong easily, and the Beta Features row's presence in Advanced.

Run one with:
  maestro --device <udid> test .maestro/you-tab-download.yaml

* test(settings): add a Maestro flow for the Beta Features empty state

* feat(you): add Change Display Name to My Account (#621)

Node 9277:121893 opens My Account with a Change Display Name row. It lands
straight on the profile-setup name step, which now takes what a saved name
leads to: setup carries on to the tip card, a lone edit returns to the
settings list. The step reads its text from an environment-held state that
setup owns at its sheet root so the photo step can read the name back; a lone
edit has no following step, so it owns that state itself, seeded with the name
already on the profile.

Mirrors the Android row (code-android-app#1299).

* refactor(bill): draw codes from the shared geometry

CodeView carried its own copy of the ring layout, the bit packing, and the
badge, all of which already exist in shared-core and now come back as
CGPaths through SharedCoreKit. Deleting the copy is what keeps a code on
screen, an exported PNG, an exported SVG, and Android drawing one figure
rather than four that happen to agree today.

Author: bmc08gt

.gitignore

@@ -50,4 +50,6 @@ Package.resolved
 /.build-benchmark
 
 # Claude
-.claude/worktrees
+.claude/worktrees
+# Maestro flow screenshots
+.maestro/screenshots/

.maestro/you-tab-beta-empty-state.yaml

@@ -0,0 +1,37 @@
+# Revokes developer access through the version easter egg (ten taps) and checks
+# the Beta Features row still opens — onto its empty state. Restores access at
+# the end, so the flow leaves the device as it found it.
+appId: com.flipcash.app.ios
+---
+- launchApp
+- tapOn: "You"
+- scrollUntilVisible:
+    element:
+      text: "Version .*"
+    centerElement: true
+- repeat:
+    times: 10
+    commands:
+      - tapOn: "Version .*"
+
+- tapOn: "Advanced"
+- assertVisible: "Beta Features"
+- tapOn: "Beta Features"
+- assertVisible: "No Beta Features"
+- assertVisible: "There are no beta features available right now."
+- takeScreenshot: .maestro/screenshots/beta-features-empty
+
+# --- put the access back ---
+- launchApp
+- tapOn: "You"
+- scrollUntilVisible:
+    element:
+      text: "Version .*"
+    centerElement: true
+- repeat:
+    times: 10
+    commands:
+      - tapOn: "Version .*"
+- tapOn: "Advanced"
+- tapOn: "Beta Features"
+- assertVisible: "Vibrate on scan"

.maestro/you-tab-beta-features.yaml

@@ -0,0 +1,15 @@
+# The Beta Features row is always offered, whether or not any flag is on: the
+# screen behind it draws its own empty state.
+appId: com.flipcash.app.ios
+---
+- launchApp
+- tapOn: "You"
+# The settings rows sit below the fold, under the tab bar.
+- scrollUntilVisible:
+    element:
+      text: "Advanced"
+    centerElement: true
+- tapOn: "Advanced"
+- assertVisible: "Beta Features"
+- tapOn: "Beta Features"
+- takeScreenshot: .maestro/screenshots/beta-features

.maestro/you-tab-download.yaml

@@ -0,0 +1,31 @@
+# Drives the You tab's export path end to end, once per format: card page ->
+# Download -> pick a format -> the system share sheet holding the written file.
+appId: com.flipcash.app.ios
+---
+- launchApp
+- tapOn: "You"
+- assertVisible: "Full Screen"
+
+# --- SVG ---
+- tapOn:
+    id: "you-download-button"
+- assertVisible: "Download As"
+- assertVisible: "PNG"
+- assertVisible: "SVG"
+- assertVisible: "Stays sharp at any size"
+- tapOn:
+    id: "you-download-svg"
+# The share sheet titles and sizes itself from the exported file.
+- assertVisible: "Copy"
+- takeScreenshot: .maestro/screenshots/share-sheet-svg
+
+# --- PNG ---
+# Relaunching is the cheapest way to get the system sheet off screen.
+- launchApp
+- tapOn: "You"
+- tapOn:
+    id: "you-download-button"
+- tapOn:
+    id: "you-download-png"
+- assertVisible: "Copy"
+- takeScreenshot: .maestro/screenshots/share-sheet-png

Code.xcodeproj/project.pbxproj

@@ -24,6 +24,7 @@
 		9A017D692EAC1DE200216925 /* Kingfisher in Frameworks */ = {isa = PBXBuildFile; productRef = 9A017D682EAC1DE200216925 /* Kingfisher */; };
 		9A444EE72E8C414D002B1E39 /* BigDecimal in Frameworks */ = {isa = PBXBuildFile; productRef = 9A444EE62E8C414D002B1E39 /* BigDecimal */; };
 		9A780F972EDF817D009BC4D9 /* CodeScanner in Frameworks */ = {isa = PBXBuildFile; productRef = 9A780F962EDF817D009BC4D9 /* CodeScanner */; };
+		9AE5C0122FA10003004C0DE0 /* SharedCoreKit in Frameworks */ = {isa = PBXBuildFile; productRef = 9AE5C0112FA10002004C0DE0 /* SharedCoreKit */; };
 		9ABDD1952D9D7B61006B6CDA /* FlipcashCore in Frameworks */ = {isa = PBXBuildFile; productRef = 9ABDD1942D9D7B61006B6CDA /* FlipcashCore */; };
 		9AC011182DA4320F0030298E /* FlipcashUI in Frameworks */ = {isa = PBXBuildFile; productRef = 9AC011172DA4320F0030298E /* FlipcashUI */; };
 		9AC0156C2DA576FA0030298E /* opencv2.framework in Frameworks */ = {isa = PBXBuildFile; fileRef = 9AD5E64B25F2BF3E007388AE /* opencv2.framework */; };
@@ -175,6 +176,7 @@
 				9AC0156C2DA576FA0030298E /* opencv2.framework in Frameworks */,
 				9ABDD1952D9D7B61006B6CDA /* FlipcashCore in Frameworks */,
 				9ADEF1D92DD627C6001B260A /* Mixpanel in Frameworks */,
+				9AE5C0122FA10003004C0DE0 /* SharedCoreKit in Frameworks */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -378,6 +380,7 @@
 				9A780F962EDF817D009BC4D9 /* CodeScanner */,
 				4CB225752F77260D0075874E /* FirebaseInstallations */,
 				4CB225772F7726500075874E /* FirebaseMessaging */,
+				9AE5C0112FA10002004C0DE0 /* SharedCoreKit */,
 			);
 			productName = Flipcash;
 			productReference = 9A516F7A2D9B12E900AF478B /* Flipcash.app */;
@@ -506,6 +509,7 @@
 				10A6C0E8F8974C1887219D41 /* XCRemoteSwiftPackageReference "tweetnacl-swiftwrap" */,
 				9A444EE52E8C414D002B1E39 /* XCRemoteSwiftPackageReference "BigDecimal" */,
 				9A780F952EDF817D009BC4D9 /* XCLocalSwiftPackageReference "CodeScanner" */,
+				9AE5C0102FA10001004C0DE0 /* XCRemoteSwiftPackageReference "flipcash-shared-core-spm" */,
 			);
 			productRefGroup = 9AED1101258BE1310088D902 /* Products */;
 			projectDirPath = "";
@@ -1759,6 +1763,14 @@
 				kind = branch;
 			};
 		};
+		9AE5C0102FA10001004C0DE0 /* XCRemoteSwiftPackageReference "flipcash-shared-core-spm" */ = {
+			isa = XCRemoteSwiftPackageReference;
+			repositoryURL = "https://github.com/code-payments/flipcash-shared-core-spm";
+			requirement = {
+				kind = upToNextMinorVersion;
+				minimumVersion = 0.3.1;
+			};
+		};
 		9ACE172927E6287C00ACA047 /* XCRemoteSwiftPackageReference "mixpanel-swift" */ = {
 			isa = XCRemoteSwiftPackageReference;
 			repositoryURL = "https://github.com/mixpanel/mixpanel-swift";
@@ -1816,6 +1828,11 @@
 			package = 9A9499D62CFB829300DC219B /* XCRemoteSwiftPackageReference "SQLite" */;
 			productName = SQLite;
 		};
+		9AE5C0112FA10002004C0DE0 /* SharedCoreKit */ = {
+			isa = XCSwiftPackageProductDependency;
+			package = 9AE5C0102FA10001004C0DE0 /* XCRemoteSwiftPackageReference "flipcash-shared-core-spm" */;
+			productName = SharedCoreKit;
+		};
 		9ADEF1D62DD627C0001B260A /* Bugsnag */ = {
 			isa = XCSwiftPackageProductDependency;
 			package = 9A476D482978884700C5B5CE /* XCRemoteSwiftPackageReference "bugsnag-cocoa" */;

Code.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -54,6 +54,13 @@ class BetaFlags {
         hasEnabled(.newUI)
     }
 
+    /// Whether the Beta Features screen has anything to show — the public
+    /// flags everyone gets, plus the developer-only section once the version
+    /// easter egg unlocks access. False means the screen draws its empty state.
+    var hasVisibleOptions: Bool {
+        accessGranted || Option.allCases.contains { $0.availability == .publicBeta }
+    }
+
     /// Enables or disables a beta flag and persists the change to disk.
     func set(_ option: Option, enabled: Bool) {
         if enabled {

Flipcash/Core/Controllers/BetaFlags.swift

@@ -50,10 +50,13 @@ extension AppRouter {
 
         // Settings flow
         case settingsMyAccount
+        /// The display name on its own, edited from My Account. The full
+        /// profile-setup flow starts on the same screen but carries on to the
+        /// tip card; this one returns to the settings list.
+        case changeDisplayName
         case settingsAdvancedFeatures
         case settingsAdvancedBetaFeatures
         case settingsAppSettings
-        case settingsBetaFlags
         case settingsAccountSelection
         case settingsApplicationLogs
         case blockedUsers
@@ -86,8 +89,8 @@ extension AppRouter {
                  .transactionHistory, .activity, .give, .buyCurrency, .convertCurrency,
                  .withdrawCurrency, .usdcDepositEducation, .usdcDepositAddress:
                 return .balance
-            case .settingsMyAccount, .settingsAdvancedFeatures, .settingsAdvancedBetaFeatures,
-                 .settingsAppSettings, .settingsBetaFlags, .settingsAccountSelection,
+            case .settingsMyAccount, .changeDisplayName, .settingsAdvancedFeatures,
+                 .settingsAdvancedBetaFeatures, .settingsAppSettings, .settingsAccountSelection,
                  .settingsApplicationLogs, .blockedUsers, .accessKey, .withdraw:
                 return .settings
             case .profileName, .profilePhoto, .tipcard,
@@ -117,10 +120,10 @@ extension AppRouter {
             case .usdcDepositEducation:         "usdcDepositEducation"
             case .usdcDepositAddress:           "usdcDepositAddress"
             case .settingsMyAccount:            "settingsMyAccount"
+            case .changeDisplayName:            "changeDisplayName"
             case .settingsAdvancedFeatures:     "settingsAdvancedFeatures"
             case .settingsAdvancedBetaFeatures: "settingsAdvancedBetaFeatures"
             case .settingsAppSettings:          "settingsAppSettings"
-            case .settingsBetaFlags:            "settingsBetaFlags"
             case .settingsAccountSelection:     "settingsAccountSelection"
             case .settingsApplicationLogs:      "settingsApplicationLogs"
             case .blockedUsers:                 "blockedUsers"
@@ -157,8 +160,8 @@ extension AppRouter {
             case .activity,
                  .discoverCurrencies, .currencyCreationSummary, .currencyCreationWizard,
                  .usdcDepositEducation, .usdcDepositAddress,
-                 .settingsMyAccount, .settingsAdvancedFeatures, .settingsAdvancedBetaFeatures,
-                 .settingsAppSettings, .settingsBetaFlags, .settingsAccountSelection,
+                 .settingsMyAccount, .changeDisplayName, .settingsAdvancedFeatures,
+                 .settingsAdvancedBetaFeatures, .settingsAppSettings, .settingsAccountSelection,
                  .settingsApplicationLogs, .blockedUsers, .accessKey, .withdraw,
                  .profileName, .profilePhoto, .tipcard:
                 return nil

Flipcash/Core/Navigation/AppRouter+Destination.swift

@@ -70,6 +70,9 @@ struct DestinationView: View {
         case .settingsMyAccount:
             SettingsMyAccountScreen()
 
+        case .changeDisplayName:
+            ChangeDisplayNameScreen(currentName: sessionContainer.session.profile?.displayName ?? "")
+
         case .settingsAdvancedFeatures:
             SettingsAdvancedFeaturesScreen()
 
@@ -79,9 +82,6 @@ struct DestinationView: View {
         case .settingsAppSettings:
             SettingsAppSettingsScreen()
 
-        case .settingsBetaFlags:
-            BetaFlagsScreen()
-
         case .settingsAccountSelection:
             // The action closure dismisses the settings sheet and switches accounts.
             // Captured at the modifier site so the AppRouter stays pure-navigation.

Flipcash/Core/Navigation/AppRouter+DestinationView.swift

@@ -57,14 +57,16 @@ struct HomeTabView: View {
     }
 
     /// Hide the tab bar whenever the active tab has pushed a screen (e.g. Wallet →
-    /// Currency Info → Give) so that screen owns the full height, and while a
+    /// Currency Info → Give) so that screen owns the full height, while a
     /// bill/tipcard is up (the app-root overlay owns the screen then, as the v1
-    /// bill replaced the bottom bar). Sheets already cover the bar, so only
-    /// in-tab pushes need handling here.
+    /// bill replaced the bottom bar), and while the You tab's card is expanded.
+    /// Sheets already cover the bar, so only in-tab pushes need handling here.
     @State private var cardExpansion = WalletCardExpansion()
+    @State private var tipCardPresentation = TipCardPresentation()
 
     private var isTabBarHidden: Bool {
         if cardExpansion.isExpanded { return true }
+        if tipCardPresentation.isExpanded { return true }
         if sessionContainer.session.isShowingBill { return true }
         guard let stack = selection.pushStack else { return false }
         return !router[stack].isEmpty
@@ -96,7 +98,11 @@ struct HomeTabView: View {
                 selection = tab
                 router.requestedTabStack = nil
             }
-            .onChange(of: selection) { _, tab in router.activeTabStack = tab.pushStack }
+            .onChange(of: selection) { _, tab in
+                router.activeTabStack = tab.pushStack
+                // Leaving the tab puts the card back (and the brightness with it).
+                tipCardPresentation.collapse()
+            }
             .onDisappear { router.activeTabStack = nil }
     }
 
@@ -182,6 +188,7 @@ struct HomeTabView: View {
             ChatTab()
         case .tipCard:
             TipCardTab(onSetUp: { selection = .chat })
+                .environment(tipCardPresentation)
         }
     }
 }