Repository Public
1import SwiftUI2import UIKit3import WebKit45/// AURA on iPhone and iPad: the command executor (the iOS subset of the shared catalog) and the glue between a scene's6/// tabs and the shared surfaces — Constellation, Flow, Canvas, Portal, Orbit and Peek. Nothing here duplicates the engine.7extension BrowserModel {8 // MARK: Commands910 var platform: OrbitContext.Platform { UIDevice.current.userInterfaceIdiom == .pad ? .pad : .phone }1112 /// The commands this app can run, in a stable order (palette).13 var supportedCommands: [CommandID] {14 let supported = OrbitCatalog.supported(on: platform)15 return CommandID.allCases.filter(supported.contains)16 }1718 func isEnabled(_ command: CommandID) -> Bool {19 guard OrbitCatalog.supported(on: platform).contains(command) else { return false }20 let tab = selectedTab21 let hasPage = tab?.url != nil22 // A native search page is not a web document: nothing to read, bookmark or capture.23 let hasWebPage = hasPage && tab?.isSearchPage != true24 let recordable = (tab?.url).map(HistoryStore.isRecordable) == true25 switch command {26 case .goBack: return tab?.canGoBack ?? false27 case .goForward: return tab?.canGoForward ?? false28 case .stopLoading: return tab?.isLoading ?? false29 case .reload, .duplicateTab: return hasPage30 case .findInPage, .capturePage: return hasWebPage && tab?.failure == nil31 case .toggleReader: return tab?.readerArticle != nil || (hasWebPage && tab?.failure == nil)32 case .sharePage, .addBookmark: return hasWebPage && recordable33 case .addToReadingList, .toggleFavorite: return hasWebPage && recordable && !isPrivate34 case .showReadingList, .showOtherDevices, .showPortal: return !isPrivate35 case .syncNow: return environment.services.account.isSignedIn && environment.settings.syncEnabled36 case .reopenClosedTab: return !recentlyClosed.isEmpty37 case .closeOtherTabs, .nextTab, .previousTab: return visibleTabs.count > 138 case .closeTab: return tab != nil39 case .addToCanvas: return hasPage40 default: return true41 }42 }4344 func perform(_ command: CommandID) {45 guard isEnabled(command) else { return }46 let tab = selectedTab47 recentCommands.removeAll { $0 == command }48 recentCommands.insert(command, at: 0)49 if recentCommands.count > 8 { recentCommands.removeLast() }50 switch command {51 case .newTab: dismissAura(); newTab(isPrivate: false)52 case .newPrivateWindow: dismissAura(); newTab(isPrivate: true)53 case .openLocation: dismissAura(); isEditingAddress = true54 case .closeTab: if let tab { close(tab) }55 case .closeOtherTabs: if let tab { visibleTabs.filter { $0.id != tab.id }.forEach(close) }56 case .reopenClosedTab: reopenClosedTab()57 case .duplicateTab: if let tab, let url = tab.url { newTab(url: url, after: tab) }58 case .sharePage: if let url = tab?.url { share([url]) }59 case .findInPage: tab?.findInPage()60 case .reload: tab?.reload()61 case .stopLoading: tab?.stopLoading()62 case .goBack: tab?.goBack()63 case .goForward: tab?.goForward()64 case .toggleFocusMode: toggleFocusMode()65 case .toggleReader: toggleReader()66 case .commandPalette:67 palettePrefill = ""68 AuraMotion.perform(.expressive) { showsOrbit = false; showsPalette.toggle() }69 case .commandOrbit: toggleOrbit()70 case .searchTabs:71 palettePrefill = "@"72 AuraMotion.perform(.expressive) { showsOrbit = false; showsPalette = true }73 case .nextTab: selectAdjacentTab(offset: 1)74 case .previousTab: selectAdjacentTab(offset: -1)75 case .addBookmark: bookmarkCurrentPage()76 case .showBookmarks: showLibrary(.bookmarks)77 case .showHistory: showLibrary(.history)78 case .showDownloads: showLibrary(.downloads)79 case .showReadingList: showLibrary(.readingList)80 case .openSettings: dismissAura(); showsSettings = true81 case .showAccount: dismissAura(); showsSettings = true; showsAccount = true82 case .addToReadingList: if let tab, let url = tab.url { addToReadingList(title: tab.displayTitle, url: url.absoluteString) }83 case .toggleFavorite: if let tab, let url = tab.url { toggleFavorite(title: tab.displayTitle, url: url.absoluteString) }84 case .syncNow: Task { [sync = environment.services.sync] in _ = await sync.syncNow() }85 case .showOtherDevices, .showPortal: present(.portal)86 case .showConstellation: tab?.captureThumbnail(); present(.constellation)87 case .showFlow: present(.flow)88 case .showCanvas: _ = canvas; present(.canvas)89 case .addToCanvas: addCurrentPageToCanvas()90 case .capturePage: capturePage()91 default: break92 }93 }9495 private func showLibrary(_ section: LibrarySection) {96 dismissAura()97 library = section98 }99100 // MARK: Presentation101102 func present(_ surface: AuraSurface) {103 AuraMotion.perform(.quick) { showsOrbit = false; showsPalette = false }104 isEditingAddress = false105 library = nil106 showsSettings = false107 showsTabOverview = false108 showsOverviewConstellation = false109 auraSurface = auraSurface == surface ? nil : surface110 }111112 func dismissAura() {113 if showsOrbit || showsPalette { AuraMotion.perform(.quick) { showsOrbit = false; showsPalette = false } }114 if auraSurface != nil { auraSurface = nil }115 }116117 // MARK: Focus Mode and reader118119 func toggleFocusMode() {120 AuraMotion.perform(.expressive) { focusMode.toggle(); showsOrbit = false; showsPalette = false }121 AuraHaptics.play(.selection)122 }123124 func toggleReader() {125 guard let tab = selectedTab else { return }126 Task {127 let shown = await tab.toggleReader()128 if !shown { toast = L("Reader view is not available for this page.") }129 }130 }131132 // MARK: Constellation133134 /// The tab set on screen (regular or private) as the constellation sees it. iOS has no tab groups or workspaces.135 var constellationItems: [ConstellationItem] {136 visibleTabs.map { tab in137 ConstellationItem(id: tab.id, title: tab.displayTitle, url: tab.url?.absoluteString, parentID: tab.openerID,138 isPrivate: tab.isPrivate, lastActive: tab.lastActive)139 }140 }141142 func constellationThumbnail(_ id: UUID) -> UIImage? { tabs.first { $0.id == id }?.thumbnail }143144 func constellationClose(_ ids: Set<UUID>) {145 let victims = tabs.filter { ids.contains($0.id) }146 AuraMotion.perform(.spring) { victims.forEach(close) }147 }148149 // MARK: Flow150151 /// The trail of the tab set on screen: the profile's for regular tabs, the in-memory one for private tabs.152 var flowStore: FlowStore { isPrivate ? privateFlow : environment.flow }153 var flowTrail: FlowTrail { _ = flowRevision; return flowStore.trail }154 var flowCursor: UUID? { _ = flowRevision; return selectedTabID.flatMap { flowStore.trail.cursor[$0] } }155156 /// Returns to a step of the path (in this tab), or opens it in a new tab — which starts a branch from that step.157 func flowOpen(_ node: FlowNode, inNewTab: Bool) {158 guard let url = URL(string: node.url) else { return }159 let store = flowStore160 let tab = inNewTab || selectedTab == nil ? newTab(isPrivate: isPrivate) : selectedTab!161 let tabID = tab.id162 store.update { $0.moveCursor(tabID: tabID, to: node.id) }163 tab.load(url)164 flowDidChange()165 auraSurface = nil166 }167168 func flowForget(journey rootID: UUID) {169 flowStore.update { $0.removeJourney(rootID: rootID) }170 flowDidChange()171 }172173 // MARK: Canvas174175 var canvas: CanvasController {176 if let canvasController { return canvasController }177 let controller = CanvasController(store: environment.canvas)178 controller.onChange = { [weak self, weak controller] in179 // Only boards the user chose to synchronize trigger a sync.180 guard let self else { return }181 if controller?.board.isSynced == true || self.environment.services.mirror.count(SyncCollection.canvas) > 0 { self.environment.services.localChange(syncAfter: 6) }182 }183 canvasController = controller184 return controller185 }186187 func addCurrentPageToCanvas() {188 guard let tab = selectedTab, let url = tab.url else { return }189 let board = canvas190 let text = tab.isSearchPage ? L("SP Search: %@", tab.searchQuery ?? "") : ""191 guard board.add(url.pathExtension.lowercased() == "pdf" ? .pdf : .tab, title: tab.displayTitle, text: text, url: url.absoluteString) != nil else { return }192 board.flush()193 AuraHaptics.play(.success)194 toast = L("Added to canvas “%@”", board.board.name)195 }196197 func addLinkToCanvas(_ url: URL, title: String, text: String = "") {198 let board = canvas199 guard board.add(.link, title: title, text: text, url: url.absoluteString) != nil else { return }200 board.flush()201 AuraHaptics.play(.success)202 toast = L("Added to canvas “%@”", board.board.name)203 }204205 var canvasHost: CanvasHost {206 let services = environment.services207 return CanvasHost(208 currentPage: { [weak self] in209 guard let tab = self?.selectedTab, let url = tab.url else { return nil }210 return (tab.displayTitle, url.absoluteString)211 },212 open: { [weak self] url in self?.auraSurface = nil; self?.newTab(url: url) },213 // A capture is only ever taken from the explicit command of the canvas, and never from a private tab.214 capture: isPrivate ? nil : { [weak self] in await self?.selectedTab?.capturePNG() },215 export: { [weak self] markdown, _ in self?.share([markdown]) },216 canSync: services.account.isSignedIn && environment.settings.syncEnabled,217 dismiss: { [weak self] in self?.auraSurface = nil })218 }219220 /// "Capture Page as Image…": an explicit snapshot of the visible page, handed to the share sheet.221 func capturePage() {222 guard let tab = selectedTab else { return }223 Task {224 if let data = await tab.capturePNG(), let image = UIImage(data: data) { share([image]) }225 else { toast = L("The page could not be captured.") }226 }227 }228229 // MARK: Portal230231 var portalHost: PortalHost {232 let services = environment.services233 return PortalHost(234 isSignedIn: services.account.isSignedIn, syncDescription: services.syncDescription, lastSync: services.sync.lastSync,235 isSyncing: services.sync.phase == .syncing, canSend: !isPrivate && services.account.isSignedIn,236 open: { [weak self] tab, inNewTab in237 guard let self, let url = URL(string: tab.url) else { return }238 self.auraSurface = nil239 self.open(url, inNewTab: inNewTab)240 },241 openAll: { [weak self] tabs in242 guard let self else { return }243 let urls = tabs.compactMap { URL(string: $0.url) }244 self.auraSurface = nil245 for (index, url) in urls.enumerated() { self.newTab(url: url, isPrivate: false, select: index == urls.count - 1) }246 },247 send: { [weak self] device in self?.sendTabs(to: device) },248 accept: { [weak self] item in self?.acceptHandoff(item) },249 decline: { [weak self] item in self?.environment.services.consumeHandoff(item) },250 syncNow: { [weak self] in self?.perform(.syncNow) },251 showAccount: { [weak self] in self?.perform(.showAccount) },252 dismiss: { [weak self] in self?.auraSurface = nil })253 }254255 /// Explicit session transfer: this scene's regular tabs are offered to another device. Private tabs are never sent.256 func sendTabs(to device: PortalDevice?) {257 guard !isPrivate else { return }258 let tabs = regularTabs.compactMap { tab -> RemoteTab? in259 guard let url = tab.url, HistoryStore.isRecordable(url) else { return nil }260 return RemoteTab(title: tab.displayTitle, url: url.absoluteString)261 }262 if environment.services.sendHandoff(tabs, to: device) {263 toast = device.map { L("%d tabs sent to %@. They appear there at its next synchronization.", tabs.count, $0.name) }264 ?? L("%d tabs sent to your other devices.", tabs.count)265 } else {266 toast = L("There is no web page to send.")267 }268 }269270 func acceptHandoff(_ item: HandoffItem) {271 let urls = item.tabs.compactMap { URL(string: $0.url) }272 auraSurface = nil273 for (index, url) in urls.enumerated() { newTab(url: url, isPrivate: false, select: index == urls.count - 1) }274 environment.services.consumeHandoff(item)275 toast = L("%d tabs opened from %@", urls.count, item.fromDeviceName)276 }277278 // MARK: Orbit279280 var orbitContext: OrbitContext {281 let tab = selectedTab282 return OrbitContext(platform: platform, hasPage: tab?.url != nil, isSearchPage: tab?.isSearchPage ?? false, isPrivate: isPrivate,283 isReader: tab?.readerArticle != nil, aiEnabled: false,284 isSignedIn: environment.services.account.isSignedIn, tabCount: visibleTabs.count,285 hasOtherDevices: !environment.services.otherDevices.isEmpty)286 }287288 func toggleOrbit() {289 if showsOrbit { AuraMotion.perform(.quick) { showsOrbit = false }; return }290 isEditingAddress = false291 AuraHaptics.play(.tap)292 AuraMotion.perform(.spring) { showsPalette = false; showsOrbit = true }293 }294295 func orbitRun(_ command: CommandID) {296 AuraMotion.perform(.quick) { showsOrbit = false }297 perform(command)298 }299300 /// "All commands", or typing in Orbit: the palette takes over — the same commands, the full list.301 func orbitHandOver(_ text: String) {302 palettePrefill = text303 AuraMotion.perform(.expressive) { showsOrbit = false; showsPalette = true }304 }305306 // MARK: Peek307308 /// The system context menu of a link, with the AURA preview card as its preview. The preview is a text summary309 /// fetched without cookies or scripts; nothing of it is cached when the tab is private.310 func peekConfiguration(for url: URL, in tab: MobileTab) -> UIContextMenuConfiguration {311 let peek = PeekModel(url: url)312 let sourceIsLocal = tab.url.map { $0.isFileURL || LinkPreviewPolicy.isLocalHost($0.host ?? "") } ?? false313 peek.load(with: environment.services.peek, isPrivate: tab.isPrivate, sourceIsLocal: sourceIsLocal)314 return UIContextMenuConfiguration(identifier: nil, previewProvider: {315 let width = min((MobileEnvironment.keyWindow?.bounds.width ?? 390) - 40, 340)316 let controller = UIHostingController(rootView: PeekCard(model: peek, width: width).background(Aura.Palette.surface)317 .environment(\.auraPolicy, AuraMotion.policy).tint(Aura.Palette.accent))318 controller.sizingOptions = .preferredContentSize319 return controller320 }, actionProvider: { [weak self, weak tab] _ in321 guard let self, let tab else { return nil }322 return self.peekMenu(for: url, peek: peek, tab: tab)323 })324 }325326 private func peekMenu(for url: URL, peek: PeekModel, tab: MobileTab) -> UIMenu {327 let title: () -> String = { [weak peek] in328 if case .loaded(let preview)? = peek?.state, !preview.title.isEmpty { return preview.title }329 return url.host ?? url.absoluteString330 }331 func action(_ text: String, _ symbol: String, _ id: String, _ body: @escaping @MainActor () -> Void) -> UIAction {332 let item = UIAction(title: text, image: UIImage(systemName: symbol)) { _ in body() }333 item.accessibilityIdentifier = "peek-" + id334 return item335 }336 let open: [UIMenuElement] = [337 action(L("Open"), "arrow.up.forward", "open") { [weak tab] in tab?.load(url, userInitiated: false) },338 action(L("Open in New Tab"), "plus.square.on.square", "newtab") { [weak self, weak tab] in self?.newTab(url: url, after: tab) },339 action(L("Open in Background"), "square.stack", "background") { [weak self, weak tab] in340 self?.newTab(url: url, select: false, after: tab)341 self?.toast = L("Opened in a background tab")342 },343 ]344 var keep: [UIMenuElement] = []345 // Nothing is added to the reading list from a private tab.346 if !tab.isPrivate {347 keep.append(action(L("Add to Reading List"), "eyeglasses", "later") { [weak self] in self?.addToReadingList(title: title(), url: url.absoluteString) })348 }349 keep.append(action(L("Add to Canvas"), "plus.rectangle.on.rectangle", "canvas") { [weak self, weak peek] in350 var text = ""351 if case .loaded(let preview)? = peek?.state { text = preview.summary.isEmpty ? preview.excerpt : preview.summary }352 self?.addLinkToCanvas(url, title: title(), text: text)353 })354 let share: [UIMenuElement] = [355 action(L("Copy Link"), "doc.on.doc", "copy") { [weak self] in PlatformActions.copy(url.absoluteString); self?.toast = L("Link copied") },356 action(L("Share…"), "square.and.arrow.up", "share") { [weak self] in self?.share([url]) },357 ]358 return UIMenu(children: [UIMenu(options: .displayInline, children: open), UIMenu(options: .displayInline, children: keep), UIMenu(options: .displayInline, children: share)])359 }360}361