Fastest and only macOS Dictation app with on-device STT and custom trained AI enhancement model. Windows, iOS testflight! Android, Linux waitlist open! A local Wispr Flow alternative. Follow https://x.com/fluidvoiceapp for more
import AppKit
@main
private enum UpdatePromptTests {
@MainActor
static func main() {
let app = NSApplication.shared
app.setActivationPolicy(.accessory)
DispatchQueue.global().asyncAfter(deadline: .now() + 15) {
print("FAIL: prompt blocked the main actor")
exit(2)
}
DispatchQueue.main.async {
Task { @MainActor in
await self.run()
exit(0)
}
}
app.run()
}
@MainActor
private static func run() async {
let originalApp = NSWorkspace.shared.frontmostApplication
defer { originalApp?.activate(options: []) }
let presenter = UpdatePromptPresenter()
var installed = 0
var postponed = 0
let actions = [
FloatingPromptAction(title: "Install Now") { installed += 1 },
FloatingPromptAction(title: "Later") { postponed += 1 },
]
let frontmostPID = originalApp?.processIdentifier
let keyWindow = NSApp.keyWindow
let firstResponder = keyWindow?.firstResponder
presenter.presentFloatingPrompt(title: "Update Available", message: "FluidVoice v1.6.10 is now available. The app will restart automatically after installation.", actions: actions)
assert(NSWorkspace.shared.frontmostApplication?.processIdentifier == frontmostPID)
assert(NSApp.keyWindow === keyWindow && keyWindow?.firstResponder === firstResponder)
assert(NSApp.modalWindow == nil)
let offer = self.visiblePanel("Update Available")
assert(offer.styleMask.contains(.nonactivatingPanel))
assert(!offer.isKeyWindow && offer.level == .floating)
assert(installed == 0 && postponed == 0)
let primary = self.button("Install Now", in: offer)
let later = self.button("Later", in: offer)
assert(primary.acceptsFirstMouse(for: nil))
self.checkLayout(offer)
// A queued dictation/hotkey job must run before the unanswered prompt is dismissed.
var callbackRan = false
let callback = Task { @MainActor in callbackRan = true }
await callback.value
try? await Task.sleep(nanoseconds: 20_000_000)
assert(callbackRan && offer.isVisible)
assert(installed == 0 && postponed == 0)
presenter.presentFloatingPrompt(title: "Update Available", message: "FluidVoice v1.6.10 is now available. The app will restart automatically after installation.", actions: actions)
presenter.presentFloatingPrompt(title: "Update Check Failed", message: "The download failed. Please try again later.", actions: [FloatingPromptAction(title: "OK") {}])
assert(NSApp.windows.filter { $0.title == "Update Available" && $0.isVisible }.count == 1)
assert(self.visiblePanel("Update Available") === offer)
later.performClick(nil)
assert(postponed == 1 && installed == 0 && !offer.isVisible)
primary.performClick(nil) // A stale button must not answer the next prompt or start installation.
assert(installed == 0)
let failure = self.visiblePanel("Update Check Failed")
failure.cancelOperation(nil)
assert(!failure.isVisible)
// Keep our own text destination key too, while FluidVoice is already active.
let destination = NSWindow(contentRect: NSRect(x: 40, y: 40, width: 360, height: 120), styleMask: [.titled], backing: .buffered, defer: false)
destination.isReleasedWhenClosed = false
destination.title = "Dictation destination"
let field = NSTextField(frame: NSRect(x: 20, y: 40, width: 320, height: 24))
destination.contentView?.addSubview(field)
NSApp.activate(ignoringOtherApps: true)
destination.makeKeyAndOrderFront(nil)
destination.makeFirstResponder(field)
try? await Task.sleep(nanoseconds: 100_000_000)
guard let editor = destination.firstResponder as? NSTextView else { fatalError("No text destination") }
editor.insertText("Current dictation", replacementRange: editor.selectedRange())
presenter.presentFloatingPrompt(title: "Update Available", message: "Your dictation can continue.", actions: actions)
assert(NSApp.keyWindow === destination && destination.firstResponder === editor)
editor.insertText(" completes", replacementRange: editor.selectedRange())
assert(editor.string == "Current dictation completes")
let secondOffer = self.visiblePanel("Update Available")
secondOffer.makeKey()
assert(secondOffer.performKeyEquivalent(with: self.returnKey(for: secondOffer)))
assert(installed == 1 && postponed == 1 && !secondOffer.isVisible)
destination.close()
// Repeated checks stay bounded and every retained prompt still gets its action.
var answered: [Int] = []
for index in 0..<8 {
presenter.presentFloatingPrompt(title: "Queue \(index)", message: "Check \(index)", actions: [FloatingPromptAction(title: "OK") { answered.append(index) }])
}
for index in 0..<4 {
self.visiblePanel("Queue \(index)").cancelOperation(nil)
}
assert(answered == [0, 1, 2, 3])
assert(!NSApp.windows.contains { $0.isVisible && $0.title.hasPrefix("Queue ") })
presenter.presentFloatingPrompt(title: "Empty", message: "No actions", actions: [])
assert(!NSApp.windows.contains { $0.isVisible && $0.title == "Empty" })
presenter.presentFloatingPrompt(title: "Recovered", message: "Ready for the next update", actions: [FloatingPromptAction(title: "OK") {}])
self.visiblePanel("Recovered").cancelOperation(nil)
// Installation/dismissal clears every waiting notice and invalidates retained buttons.
presenter.presentFloatingPrompt(title: "Update Available", message: "Dismissed offer", actions: actions)
let dismissedOffer = self.visiblePanel("Update Available")
let staleInstall = self.button("Install Now", in: dismissedOffer)
presenter.presentFloatingPrompt(title: "Queued failure", message: "Discarded notice", actions: [FloatingPromptAction(title: "OK") { postponed += 1 }])
presenter.dismissAll()
presenter.dismissAll()
assert(!dismissedOffer.isVisible)
assert(!NSApp.windows.contains { $0.isVisible && $0.title == "Queued failure" })
staleInstall.performClick(nil)
assert(installed == 1 && postponed == 1)
presenter.presentFloatingPrompt(title: "Update Available", message: "Fresh offer", actions: actions)
staleInstall.performClick(nil)
assert(installed == 1 && self.visiblePanel("Update Available").isVisible)
self.visiblePanel("Update Available").cancelOperation(nil)
assert(postponed == 2)
self.checkNewerOffers(presenter)
self.checkFocusedOfferRefresh(presenter)
self.checkAutomaticOfferRemoval(presenter)
print("PASS: main actor responsive; focus preserved; text completes; actions, direct cancellation, duplicate/newer offers, stale buttons, queue order, dismiss-all and recovery checks")
}
@MainActor
private static func checkAutomaticOfferRemoval(_ presenter: UpdatePromptPresenter) {
var answered: [String] = []
let frontmostPID = NSWorkspace.shared.frontmostApplication?.processIdentifier
let keyWindow = NSApp.keyWindow
let firstResponder = keyWindow?.firstResponder
presenter.presentFloatingPrompt(
title: "Update Available",
message: "Automatic version",
actions: [FloatingPromptAction(title: "Install Now") { answered.append("automatic") }],
isAutomaticUpdateOffer: true
)
let automatic = self.visiblePanel("Update Available")
let oldInstall = self.button("Install Now", in: automatic)
presenter.presentFloatingPrompt(title: "Update Check Failed", message: "Explicit error", actions: [FloatingPromptAction(title: "OK") { answered.append("error") }])
presenter.dismissAutomaticUpdateOffers()
assert(!automatic.isVisible && self.visiblePanel("Update Check Failed").isVisible)
oldInstall.performClick(nil)
assert(answered.isEmpty)
assert(NSWorkspace.shared.frontmostApplication?.processIdentifier == frontmostPID)
assert(NSApp.keyWindow === keyWindow && keyWindow?.firstResponder === firstResponder)
presenter.presentFloatingPrompt(title: "Update Available", message: "Queued automatic", actions: [FloatingPromptAction(title: "Install Now") { answered.append("queued automatic") }], isAutomaticUpdateOffer: true)
presenter.dismissAutomaticUpdateOffers()
self.visiblePanel("Update Check Failed").cancelOperation(nil)
assert(answered == ["error"])
assert(!NSApp.windows.contains { $0.isVisible && $0.title == "Update Available" })
// An explicit request promotes identical automatic content to a manual offer.
presenter.presentFloatingPrompt(title: "Update Available", message: "Same version", actions: [FloatingPromptAction(title: "Install Now") { answered.append("old automatic") }], isAutomaticUpdateOffer: true)
let promotedFrom = self.visiblePanel("Update Available")
let staleAutomaticInstall = self.button("Install Now", in: promotedFrom)
presenter.presentFloatingPrompt(title: "Update Available", message: "Same version", actions: [FloatingPromptAction(title: "Install Now") { answered.append("manual") }])
let manual = self.visiblePanel("Update Available")
assert(manual !== promotedFrom && !promotedFrom.isVisible)
presenter.presentFloatingPrompt(title: "Update Available", message: "Same version", actions: [FloatingPromptAction(title: "Install Now") { answered.append("downgraded automatic") }], isAutomaticUpdateOffer: true)
presenter.dismissAutomaticUpdateOffers()
assert(self.visiblePanel("Update Available") === manual)
staleAutomaticInstall.performClick(nil)
assert(answered == ["error"])
self.button("Install Now", in: manual).performClick(nil)
assert(answered == ["error", "manual"])
assert(NSWorkspace.shared.frontmostApplication?.processIdentifier == frontmostPID)
assert(NSApp.keyWindow === keyWindow && keyWindow?.firstResponder === firstResponder)
}
@MainActor
private static func checkFocusedOfferRefresh(_ presenter: UpdatePromptPresenter) {
var answered: [String] = []
presenter.presentFloatingPrompt(title: "Update Available", message: "Focused version 1", actions: [
FloatingPromptAction(title: "Install Now") { answered.append("old install") },
FloatingPromptAction(title: "Later") { answered.append("old later") },
])
let oldOffer = self.visiblePanel("Update Available")
let oldInstall = self.button("Install Now", in: oldOffer)
oldOffer.makeKey()
assert(oldOffer.isKeyWindow)
let frontmostPID = NSWorkspace.shared.frontmostApplication?.processIdentifier
presenter.presentFloatingPrompt(title: "Update Available", message: "Focused version 2", actions: [
FloatingPromptAction(title: "Install Now") { answered.append("fresh install") },
FloatingPromptAction(title: "Later") { answered.append("fresh later") },
])
let refreshedOffer = self.visiblePanel("Update Available")
assert(refreshedOffer !== oldOffer && !oldOffer.isVisible)
assert(refreshedOffer.isKeyWindow, "Refreshing a deliberately focused offer must preserve keyboard focus")
assert(NSWorkspace.shared.frontmostApplication?.processIdentifier == frontmostPID)
oldInstall.performClick(nil)
assert(answered.isEmpty && refreshedOffer.isVisible)
assert(refreshedOffer.performKeyEquivalent(with: self.returnKey(for: refreshedOffer)))
assert(answered == ["fresh install"] && !refreshedOffer.isVisible)
}
@MainActor
private static func checkNewerOffers(_ presenter: UpdatePromptPresenter) {
let frontmostPID = NSWorkspace.shared.frontmostApplication?.processIdentifier
let keyWindow = NSApp.keyWindow
let firstResponder = keyWindow?.firstResponder
var answered: [String] = []
presenter.presentFloatingPrompt(title: "Update Available", message: "Version 1", actions: [
FloatingPromptAction(title: "Install Now") { answered.append("old install") },
FloatingPromptAction(title: "Later") { answered.append("old later") },
])
let oldOffer = self.visiblePanel("Update Available")
let oldInstall = self.button("Install Now", in: oldOffer)
let oldLater = self.button("Later", in: oldOffer)
presenter.presentFloatingPrompt(title: "First notice", message: "Keep queue position", actions: [FloatingPromptAction(title: "OK") { answered.append("first notice") }])
presenter.presentFloatingPrompt(title: "Update Available", message: "Version 2", actions: [
FloatingPromptAction(title: "Install Now") { answered.append("new install") },
FloatingPromptAction(title: "Later") { answered.append("new later") },
])
let newerOffer = self.visiblePanel("Update Available")
assert(newerOffer !== oldOffer && !oldOffer.isVisible)
assert(self.hasMessage("Version 2", in: newerOffer))
assert(NSWorkspace.shared.frontmostApplication?.processIdentifier == frontmostPID)
assert(NSApp.keyWindow === keyWindow && keyWindow?.firstResponder === firstResponder)
oldInstall.performClick(nil)
oldLater.performClick(nil)
assert(answered.isEmpty && newerOffer.isVisible)
self.button("Later", in: newerOffer).performClick(nil)
assert(answered == ["new later"])
// Replace a queued offer in its original position, preserving surrounding notices.
presenter.presentFloatingPrompt(title: "Update Available", message: "Queued version 1", actions: [FloatingPromptAction(title: "Install Now") { answered.append("old queued install") }])
presenter.presentFloatingPrompt(title: "Last notice", message: "Keep final queue position", actions: [FloatingPromptAction(title: "OK") { answered.append("last notice") }])
presenter.presentFloatingPrompt(title: "Update Available", message: "Queued version 2", actions: [FloatingPromptAction(title: "Install Now") { answered.append("new queued install") }])
assert(self.visiblePanel("First notice").isVisible)
assert(NSWorkspace.shared.frontmostApplication?.processIdentifier == frontmostPID)
assert(NSApp.keyWindow === keyWindow && keyWindow?.firstResponder === firstResponder)
self.visiblePanel("First notice").cancelOperation(nil)
let queuedOffer = self.visiblePanel("Update Available")
assert(self.hasMessage("Queued version 2", in: queuedOffer))
assert(!NSApp.windows.contains { $0.isVisible && $0.title == "Last notice" })
oldInstall.performClick(nil)
oldLater.performClick(nil)
assert(answered == ["new later", "first notice"] && queuedOffer.isVisible)
self.button("Install Now", in: queuedOffer).performClick(nil)
self.visiblePanel("Last notice").cancelOperation(nil)
assert(answered == ["new later", "first notice", "new queued install", "last notice"])
assert(!NSApp.windows.contains { $0.isVisible && $0.title == "Update Available" })
}
@MainActor
private static func hasMessage(_ message: String, in panel: NSWindow) -> Bool {
panel.contentView?.subviews.compactMap { $0 as? NSTextField }.contains { $0.stringValue == message } == true
}
@MainActor
private static func visiblePanel(_ title: String) -> NSWindow {
guard let panel = NSApp.windows.first(where: { $0.title == title && $0.isVisible }) else { fatalError("Missing prompt: \(title)") }
return panel
}
@MainActor
private static func button(_ title: String, in panel: NSWindow) -> NSButton {
guard let button = panel.contentView?.subviews.compactMap({ $0 as? NSButton }).first(where: { $0.title == title }) else { fatalError("Missing button: \(title)") }
return button
}
@MainActor
private static func checkLayout(_ panel: NSWindow) {
guard let content = panel.contentView else { fatalError("Missing content") }
for view in content.subviews {
assert(content.bounds.contains(view.frame))
if let label = view as? NSTextField { assert(label.frame.height >= ceil(label.fittingSize.height)) }
if let button = view as? NSButton { assert(button.frame.width >= ceil(button.fittingSize.width)) }
}
}
@MainActor
private static func returnKey(for panel: NSWindow) -> NSEvent {
guard let event = NSEvent.keyEvent(with: .keyDown, location: .zero, modifierFlags: [], timestamp: 0, windowNumber: panel.windowNumber, context: nil, characters: "\r", charactersIgnoringModifiers: "\r", isARepeat: false, keyCode: 36) else {
fatalError("Cannot create return-key event")
}
return event
}
}