Show cards in a system sheet on iOS 27+

.github/workflows/swift.yml

@@ -39,4 +39,4 @@ jobs:
       - name: Build Example
         run: |
           cd Example
-          set -o pipefail && xcodebuild build -scheme 'Example' -destination 'platform=iOS Simulator,name=iPhone 16' | xcbeautify
+          set -o pipefail && xcodebuild build -scheme 'Example' -destination 'generic/platform=iOS Simulator' | xcbeautify

Example/AppDelegate.swift

@@ -52,3 +52,11 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
 
 }
 
+
+/// Required on iOS 27, which no longer launches apps without scene support.
+/// The window and its root view controller come from `Main.storyboard`.
+class SceneDelegate: UIResponder, UIWindowSceneDelegate {
+
+  var window: UIWindow?
+
+}

Example/Example.xcodeproj/project.pbxproj

@@ -361,7 +361,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				MTL_ENABLE_DEBUG_INFO = YES;
 				ONLY_ACTIVE_ARCH = YES;
 				SDKROOT = iphoneos;
@@ -416,7 +416,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 13.0;
+				IPHONEOS_DEPLOYMENT_TARGET = 16.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				SDKROOT = iphoneos;
 				SWIFT_COMPILATION_MODE = wholemodule;

Example/ExampleCardViewController.swift

@@ -28,6 +28,12 @@ class ExampleCardViewController: TGCardViewController {
 
     navigationButtonsAreSpringLoaded = true
 
+    // Pass `-classicCards` as a launch argument to compare with the classic
+    // presentation, where the cards aren't in a system sheet.
+    if ProcessInfo.processInfo.arguments.contains("-classicCards") {
+      presentationStyle = .classic
+    }
+
     #if targetEnvironment(macCatalyst)
     mode = .sidebar
     #endif

Example/Supporting Files/Info.plist

@@ -22,6 +22,25 @@
 	<string>Find yourself on the map</string>
 	<key>NSPrincipalClass</key>
 	<string></string>
+	<key>UIApplicationSceneManifest</key>
+	<dict>
+		<key>UIApplicationSupportsMultipleScenes</key>
+		<false/>
+		<key>UISceneConfigurations</key>
+		<dict>
+			<key>UIWindowSceneSessionRoleApplication</key>
+			<array>
+				<dict>
+					<key>UISceneConfigurationName</key>
+					<string>Default Configuration</string>
+					<key>UISceneDelegateClassName</key>
+					<string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
+					<key>UISceneStoryboardFile</key>
+					<string>Main</string>
+				</dict>
+			</array>
+		</dict>
+	</dict>
 	<key>UILaunchStoryboardName</key>
 	<string>LaunchScreen</string>
 	<key>UIMainStoryboardFile</key>

Example/cards/ExampleCityCard.swift

@@ -8,6 +8,7 @@
 
 import Foundation
 import MapKit
+import UIKit
 
 import TGCardViewController
 
@@ -42,6 +43,32 @@ class ExampleCityCard : TGPlainCard {
   init(city: City) {
     self.city = city
     super.init(title: .default(city.title, nil, nil), mapManager: city.manager)
+    updateBarActions()
+  }
+
+  private var isFavorite = false
+
+  /// Only shown next to a vertical bar, e.g., on the iPhone Duo. A real card
+  /// would show them itself when `showsVerticalBarActions` is `false`.
+  private func updateBarActions() {
+    verticalBarActions = [
+      UIAction(
+        title: isFavorite ? "Remove Favourite" : "Add Favourite",
+        image: UIImage(systemName: isFavorite ? "star.fill" : "star")
+      ) { [weak self] _ in
+        self?.isFavorite.toggle()
+        self?.updateBarActions()
+      },
+      UIAction(
+        title: "Share",
+        image: UIImage(systemName: "square.and.arrow.up")
+      ) { [weak self] action in
+        guard let self else { return }
+        let activity = UIActivityViewController(activityItems: [city.title], applicationActivities: nil)
+        activity.popoverPresentationController?.sourceItem = action.sender as? UIPopoverPresentationControllerSourceItem
+        controller?.present(activity, animated: true)
+      },
+    ]
   }
 
 }

Package.swift

@@ -1,4 +1,4 @@
-// swift-tools-version:5.3
+// swift-tools-version:5.7
 // The swift-tools-version declares the minimum version of Swift required to build this package.
 
 import PackageDescription
@@ -7,7 +7,7 @@ let package = Package(
   name: "TGCardViewController",
   defaultLocalization: "en",
   platforms: [
-    .iOS(.v13)
+    .iOS(.v16)
   ],
   products: [
     .library(

README.md

@@ -72,6 +72,35 @@ Provides a card-based view controller for mapping applications where the card's
       }
     ```
 
+### System sheets on iOS 27+
+
+By default (`presentationStyle = .automatic`), on iOS 27 and later the cards are shown in a system sheet (`UISheetPresentationController`). The sheet adapts to the size classes by itself, like Maps':
+
+| | Presentation |
+|---|---|
+| Compact width, e.g., iPhone in portrait | Sheet at the bottom, full width |
+| Otherwise, e.g., iPad or iPhone in landscape | Sheet on the leading edge, 400pt wide |
+| Mac Catalyst, visionOS, `mode = .sidebar` | Classic |
+| The card controller is itself presented, but not full screen | Classic |
+| iOS 26 and earlier, or built with Xcode 26 and earlier | Classic |
+
+Set `presentationStyle` to `.classic` to opt out. Check `usesSystemSheet` for what's currently in use.
+
+Cards, map managers, headers, map buttons and paging work the same in both. Differences with a system sheet:
+
+- The map isn't dimmed and stays interactive when the card is extended.
+- The sheet provides the grab handle, the material, the corners and the dragging.
+- When a header is showing, the extended card stops below it.
+- Sheets presented by cards (e.g., with detents) stack on top of the card's sheet.
+
+Because the sheet is the card controller's `presentedViewController`:
+
+- `present(_:animated:completion:)` and `dismiss(animated:completion:)` on the card controller present on top of the sheet, and dismiss what's on top of it, but never the sheet itself.
+- Use `presentedOverlayViewController` to check what's presented on top of the cards, instead of `presentedViewController`.
+- Use `cardOverlayView` instead of `view` for views that you constrain to views inside a card, e.g., tooltips.
+
+On devices with a vertical bar, such as the iPhone Duo's outer display (iOS 27.1+), the system puts a sheet's bar items into that bar. The card controller does the same for cards, like Mail does: the top card's close button moves to the top of the bar, followed by buttons for the previous and next page of a `TGPageCard`, and the card's `verticalBarActions` go to the bottom of the bar as icon-only buttons. They stay in the bar at every height of the sheet, and the cards stay clear of it. Cards can observe `showsVerticalBarActions` to leave those actions out of their own content while they're in the bar.
+
 ## Specs
 
 ### 1. Basic functionality of cards