Files
hapi/ios/Hapi/Features/Pairing/PairingFlowView.swift
T
weishu e1093466c9 feat(ios): support macOS through Mac Catalyst
Build the app and notification extension for Mac Catalyst with the Mac
idiom, so Macs get a 1:1 native window instead of the scaled iPad app.
The Mac build keeps the run.hapi.app bundle ID and adds Mac entitlements
(sandbox, network, microphone, user-selected files, Mac APNs).

- Always use the split on Mac with a sidebar list style, denser rows,
  14pt reading text, a hidden duplicate titlebar title, a minimum window
  size and page-sized sheets; open web links in the default browser and
  hide the unavailable live QR scanner.
- Add menu bar / hardware-keyboard commands: New Session, Settings,
  Toggle Sidebar, a Session menu (settings, files, rename, export, stop,
  previous/next session) and a guide link.
- Composer: Return sends on Mac (Shift/Option-Return for a newline, IME
  untouched, first suggestion picked); dropped files and pasted images or
  copied files become attachments on all platforms.
- CI builds Mac Catalyst and runs the navigation, split and transcript
  geometry tests there; README documents the Mac build.
2026-11-03 11:15:11 +08:00

150 lines
6.1 KiB
Swift

import HapiClient
import SwiftUI
/// Entry to pairing: a short self-hosted explanation plus the two ways in —
/// scan the hub's QR code, or type hub URL + access token. Used as the app
/// root while unpaired (`context: .initial`) and as the add-hub sheet from
/// the home screen (`context: .addHub`).
struct PairingFlowView: View {
enum Context {
/// Root screen while nothing is paired.
case initial
/// Presented as a sheet to pair an additional hub.
case addHub
}
var context: Context = .initial
@Environment(AppModel.self) private var model
@Environment(\.dismiss) private var dismiss
@State private var showScanner = false
private static var introText: LocalizedStringKey {
#if targetEnvironment(macCatalyst)
"HAPI is self-hosted: your agent sessions run on your own machine, served by a hub you operate. Start the hub, then enter its URL and access token, or paste the pairing link it prints."
#else
"HAPI is self-hosted: your agent sessions run on your own machine, served by a hub you operate. Start the hub on your computer, then pair this app with the QR code it prints — or enter the hub URL and access token by hand."
#endif
}
@State private var showManualEntry = false
private static let docsURL = URL(string: "https://hapi.run/docs/guide/quick-start")
var body: some View {
NavigationStack {
ScrollView {
VStack(spacing: 24) {
if context == .initial, let failedHub = model.authFailureNotice {
authFailureBanner(failedHub: failedHub)
}
VStack(spacing: 12) {
Image(systemName: "antenna.radiowaves.left.and.right")
.font(.system(size: 56))
.foregroundStyle(.tint)
.padding(.top, context == .initial ? 48 : 24)
Text(context == .initial
? String(localized: "Pair with your hub")
: String(localized: "Add another hub"))
.font(.title.bold())
Text(Self.introText)
.font(.subheadline)
.foregroundStyle(.secondary)
.multilineTextAlignment(.center)
if let docsURL = Self.docsURL {
Link("Setup guide", destination: docsURL)
.font(.subheadline)
}
}
.padding(.horizontal, 24)
VStack(spacing: 12) {
#if targetEnvironment(macCatalyst)
// Macs have no live QR scanner; manual entry (which
// also accepts a pasted pairing link) is the primary path.
Button {
showManualEntry = true
} label: {
Label("Enter Manually", systemImage: "keyboard")
.frame(maxWidth: .infinity)
}
.buttonStyle(.borderedProminent)
.controlSize(.large)
#else
Button {
showScanner = true
} label: {
Label("Scan QR Code", systemImage: "qrcode.viewfinder")
.frame(maxWidth: .infinity)
}
.buttonStyle(.borderedProminent)
.controlSize(.large)
Button {
showManualEntry = true
} label: {
Label("Enter Manually", systemImage: "keyboard")
.frame(maxWidth: .infinity)
}
.buttonStyle(.bordered)
.controlSize(.large)
#endif
}
.padding(.horizontal, 24)
PrivacyPolicyLink()
.font(.subheadline)
.padding(.bottom, 24)
}
.frame(maxWidth: 480)
.frame(maxWidth: .infinity)
}
.navigationTitle(context == .addHub ? String(localized: "Add Hub") : "")
.navigationBarTitleDisplayMode(.inline)
.toolbar {
if context == .addHub {
ToolbarItem(placement: .cancellationAction) {
Button("Cancel") {
dismiss()
}
}
}
}
.sheet(isPresented: $showScanner) {
QRScannerView()
.macSheetSizing()
}
.sheet(isPresented: $showManualEntry) {
ManualEntryView()
.macSheetSizing()
}
}
}
private func authFailureBanner(failedHub: String) -> some View {
HStack(alignment: .top, spacing: 12) {
Image(systemName: "exclamationmark.triangle.fill")
.foregroundStyle(.orange)
VStack(alignment: .leading, spacing: 4) {
Text("Signed out of \(HubDisplay.host(failedHub))")
.font(.subheadline.bold())
Text("The hub rejected the stored credentials — the access token was probably rotated. Pair again to reconnect.")
.font(.footnote)
.foregroundStyle(.secondary)
}
Spacer(minLength: 0)
Button {
model.authFailureNotice = nil
} label: {
Image(systemName: "xmark")
.font(.footnote.bold())
.foregroundStyle(.secondary)
}
}
.padding(12)
.background(.orange.opacity(0.12), in: RoundedRectangle(cornerRadius: 12))
.padding(.horizontal, 16)
.padding(.top, 8)
}
}