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 Foundation
// Display-only fixture; the test executable does not load the private provider or settings.
enum PrivateAIModelRegistry {
struct Model { let displayName: String }
static func canonicalModelID(for value: String) -> String? {
value == "legacy-mini" ? "mini-internal" : nil
}
static func model(id: String) -> Model? {
id == "mini-internal" ? Model(displayName: "Fluid-1 Mini") : nil
}
}
@main
struct HistoryPresentationTests {
static func main() async throws {
let pinID = UUID()
let otherID = UUID()
let pinRequest = HistoryPinRevealRequest(entryID: pinID)
precondition(pinRequest.target(selectedID: pinID, visibleIDs: [otherID, pinID]) == pinID)
precondition(pinRequest.target(selectedID: otherID, visibleIDs: [pinID, otherID]) == nil, "Pin must not navigate to an unrelated selection")
precondition(pinRequest.target(selectedID: pinID, visibleIDs: [otherID]) == nil, "Unpinned, filtered, or deleted rows must not be revealed")
precondition(pinRequest.target(selectedID: nil, visibleIDs: [pinID]) == nil)
precondition(pinRequest != HistoryPinRevealRequest(entryID: pinID), "Rapid toggles need distinct requests to cancel stale scroll work")
print("PASS: selected pin reveal, unrelated/hidden/deleted/nil non-effects and rapid request identity")
let directory = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString)
try FileManager.default.createDirectory(at: directory, withIntermediateDirectories: true)
defer { try? FileManager.default.removeItem(at: directory) }
let savedFile = directory.appendingPathComponent("saved.wav")
try Data([0]).write(to: savedFile)
let exists: @Sendable (String) -> Bool = { name in
precondition(!Thread.isMainThread, "Availability checks must not run on the main thread")
return FileManager.default.fileExists(atPath: directory.appendingPathComponent(name).path)
}
let initial = await HistoryAudioAvailability.scan(fileNames: ["saved.wav", "missing.wav", "saved.wav"], exists: exists)
precondition(initial == ["saved.wav"], "Missing restored files must not appear available")
try FileManager.default.removeItem(at: savedFile)
let deleted = await HistoryAudioAvailability.scan(fileNames: ["saved.wav"], exists: exists)
precondition(deleted.isEmpty, "Refresh must remove externally deleted files")
let emptyAudio = await HistoryAudioAvailability.scan(fileNames: []) { _ in
preconditionFailure("No metadata must mean no file queries")
}
precondition(emptyAudio.isEmpty)
let cancelled = Task {
await HistoryAudioAvailability.scan(fileNames: ["saved.wav"], exists: exists)
}
cancelled.cancel()
_ = await cancelled.value
print("PASS: background audio availability, missing/deleted files, empty metadata and cancellation completion")
let audio = DictationAudioMetadata(
fileName: "saved.wav",
durationMilliseconds: 10_300,
byteCount: 331_000,
sampleRate: 16_000,
channels: 1,
model: nil
)
let enhanced = TranscriptionHistoryEntry(
rawText: " raw words ",
processedText: " final words ",
appName: "Notes",
windowTitle: "",
wasAIProcessed: true,
processingModel: "historical-model",
transcriptionDurationMilliseconds: 57,
aiProcessingDurationMilliseconds: 104,
aiTokensPerSecond: 746,
audio: audio
)
precondition(HistorySelectionRevealPolicy.needsFilterReset(
requestedID: enhanced.id, selectedID: enhanced.id, allEntries: [enhanced], visibleEntries: []
), "An empty Starred or text-filter result must still reveal an existing external selection")
precondition(!HistorySelectionRevealPolicy.needsFilterReset(
requestedID: enhanced.id, selectedID: enhanced.id, allEntries: [enhanced], visibleEntries: [enhanced]
), "Already visible selections must preserve active filters")
precondition(!HistorySelectionRevealPolicy.needsFilterReset(
requestedID: enhanced.id, selectedID: nil, allEntries: [enhanced], visibleEntries: []
), "An empty selection must preserve filters")
let missingID = UUID()
precondition(!HistorySelectionRevealPolicy.needsFilterReset(
requestedID: missingID, selectedID: missingID, allEntries: [enhanced], visibleEntries: []
), "Missing or deleted selections must preserve filters")
precondition(!HistorySelectionRevealPolicy.needsFilterReset(
requestedID: nil, selectedID: enhanced.id, allEntries: [enhanced], visibleEntries: []
), "Local deletion fallback, unstar and restore selection must not clear Starred without a search request")
precondition(!HistorySelectionRevealPolicy.needsFilterReset(
requestedID: missingID, selectedID: enhanced.id, allEntries: [enhanced], visibleEntries: []
), "An older search request cannot override a newer local selection")
let viewSource = try String(contentsOfFile: "Sources/Fluid/UI/TranscriptionHistoryView.swift", encoding: .utf8)
let parent = viewSource.components(separatedBy: "private var entryListView:").first ?? ""
precondition(parent.contains(".onChange(of: self.historyStore.searchSelectionRequest)"), "External selection must be observed outside the conditionally absent list")
precondition(!parent.contains(".onChange(of: self.historyStore.selectedEntryID)"), "Local selection must not become an external reveal event")
precondition(parent.contains("self.revealExternalSelection()"), "Parent must use the tested policy")
precondition(parent.contains("self.audioAvailabilityRevision = UUID()\n self.revealExternalSelection()"), "Initial appearance must reveal the already-selected row")
precondition(!parent.contains("filteredEntries.map(\\.id), initial: true"), "Initial filter fallback must not erase an external selection before appearance")
let contentSource = try String(contentsOfFile: "Sources/Fluid/ContentView.swift", encoding: .utf8)
precondition(contentSource.contains("TranscriptionHistoryStore.shared.selectEntryFromSearch(id: id)"), "Sidebar navigation must produce the explicit request before opening History")
print("PASS: hidden/empty external reveal, visible/nil/deleted/local/stale non-effects and explicit parent/appearance wiring")
let before = enhanced
precondition(enhanced.clipboardText == "final words")
precondition(enhanced == before, "Reading copy text must not mutate an entry")
let raw = TranscriptionHistoryEntry(
rawText: " raw words ",
processedText: " ",
appName: "Notes",
windowTitle: "",
wasAIProcessed: false
)
precondition(raw.clipboardText == "raw words")
let empty = TranscriptionHistoryEntry(
rawText: " ",
processedText: " ",
appName: "Notes",
windowTitle: "",
wasAIProcessed: false
)
precondition(empty.clipboardText == nil)
let decoded = try JSONDecoder().decode(TranscriptionHistoryEntry.self, from: JSONEncoder().encode(enhanced))
precondition(decoded == enhanced, "Presentation must preserve persisted fields")
precondition(decoded.processingModel == "historical-model")
precondition(TranscriptionHistoryEntry.formattedTokensPerSecond(746, compact: true) == "746 tok/s")
precondition(TranscriptionHistoryEntry.formattedDuration(milliseconds: 104) == "104 ms")
let cases = [
("Hello world", "Hello world"),
("Hello world", "Hello, world!"),
("red blue", "green blue"),
("", "new words"),
("old words", ""),
("one two\nthree", "One two\n\nthree."),
("hello hello world", "hello world"),
("வணக்கம் 👋🏽 café", "வணக்கம் 👋🏽 Café!"),
]
for (original, final) in cases {
guard let diff = HistoryTextDiff.compare(original: original, final: final) else {
preconditionFailure("Expected a bounded comparison")
}
precondition(diff.original.map(\.text).joined() == original)
precondition(diff.final.map(\.text).joined() == final)
precondition(diff.hasChanges == (original != final))
}
guard let replacement = HistoryTextDiff.compare(original: "red blue", final: "green blue") else {
preconditionFailure("Expected a replacement comparison")
}
precondition(replacement.original.filter(\.changed).map(\.text).joined() == "red")
precondition(replacement.final.filter(\.changed).map(\.text).joined() == "green")
precondition(HistoryTextDiff.compare(original: String(repeating: "a ", count: 2000), final: "") == nil)
precondition(HistoryTextDiff.compare(original: String(repeating: "x", count: 24_001), final: "") == nil)
precondition(ModelDisplayName.forID("mini-internal") == "Fluid 1 Mini")
precondition(ModelDisplayName.forID("legacy-mini") == "Fluid 1 Mini")
precondition(ModelDisplayName.forID(" mini-internal ") == "Fluid 1 Mini")
precondition(ModelDisplayName.forID("external/model-v2") == "external/model-v2")
precondition(ModelDisplayName.forID("") == "")
precondition(decoded.processingModel == "historical-model", "Display lookup cannot rewrite stored model IDs")
print("PASS: final/raw/empty copy, immutable entry, audio and timing round-trip, metric labels")
print("PASS: unchanged/replaced/added/deleted text, punctuation, whitespace, Unicode, repeated words and bounded diff")
print("PASS: display names, aliases, unknown-provider fallback and original stored model ID")
}
}