chore: adiciona .gitignore e commit.command

This commit is contained in:
João Henrique
2026-08-18 08:25:29 -04:00
parent 68958fde00
commit 8fca456ceb
215 changed files with 65752 additions and 0 deletions
+54
View File
@@ -0,0 +1,54 @@
import ComposableArchitecture
import Inject
import SwiftUI
import Sparkle
struct AboutView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
@State var viewModel = CheckForUpdatesViewModel.shared
@State private var showingChangelog = false
var body: some View {
Form {
Section {
HStack {
Label("Version", systemImage: "info.circle")
Spacer()
Text(Bundle.main.object(forInfoDictionaryKey: "CFBundleShortVersionString") as? String ?? "Unknown")
Button("Check for Updates") {
viewModel.checkForUpdates()
}
.buttonStyle(.bordered)
.disabled(!viewModel.canCheckForUpdates)
}
HStack {
Label("Changelog", systemImage: "doc.text")
Spacer()
Button("Show Changelog") {
showingChangelog.toggle()
}
.buttonStyle(.bordered)
.sheet(isPresented: $showingChangelog, onDismiss: {
showingChangelog = false
}) {
ChangelogView()
}
}
HStack {
Label("Hex is open source", systemImage: "apple.terminal.on.rectangle")
Spacer()
Link("Visit our GitHub", destination: URL(string: "https://github.com/kitlangton/Hex/")!)
}
HStack {
Label("Support the developer", systemImage: "heart")
Spacer()
Link("Become a Sponsor", destination: URL(string: "https://github.com/sponsors/kitlangton")!)
}
}
}
.formStyle(.grouped)
.enableInjection()
}
}
+36
View File
@@ -0,0 +1,36 @@
import SwiftUI
import Inject
import MarkdownUI
struct ChangelogView: View {
@ObserveInjection var inject
@Environment(\.dismiss) var dismiss
var body: some View {
ScrollView {
VStack(alignment: .leading, spacing: 10) {
Text("Changelog")
.font(.title)
.padding(.bottom, 10)
if let changelogPath = Bundle.main.path(forResource: "changelog", ofType: "md"),
let changelogContent = try? String(
contentsOfFile: changelogPath, encoding: .utf8)
{
Markdown(changelogContent)
} else {
Text("Changelog could not be loaded.")
.foregroundColor(.red)
}
}
.padding()
}
.frame(minWidth: 600, minHeight: 500)
.toolbar {
ToolbarItem(placement: .cancellationAction) {
Button("Close") { dismiss() }
}
}
.enableInjection()
}
}
@@ -0,0 +1,110 @@
import ComposableArchitecture
import HexCore
import Inject
import SwiftUI
struct GeneralSectionView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
var body: some View {
Section {
Label {
Toggle("Open on Login",
isOn: Binding(
get: { store.hexSettings.openOnLogin },
set: { store.send(.toggleOpenOnLogin($0)) }
))
} icon: {
Image(systemName: "arrow.right.circle")
}
Label {
Toggle(
"Show Dock Icon",
isOn: Binding(
get: { store.hexSettings.showDockIcon },
set: { store.send(.toggleShowDockIcon($0)) }
)
)
} icon: {
Image(systemName: "dock.rectangle")
}
Label {
Toggle(
"Use clipboard to insert",
isOn: Binding(
get: { store.hexSettings.useClipboardPaste },
set: { store.send(.setUseClipboardPaste($0)) }
)
)
Text("Use clipboard to insert text. Fast but may not restore all clipboard content.\nTurn off to use simulated keypresses. Slower, but doesn't need to restore clipboard")
} icon: {
Image(systemName: "doc.on.doc.fill")
}
Label {
Toggle(
"Copy to clipboard",
isOn: Binding(
get: { store.hexSettings.copyToClipboard },
set: { store.send(.setCopyToClipboard($0)) }
)
)
Text("Copy transcription text to clipboard in addition to pasting it")
} icon: {
Image(systemName: "doc.on.clipboard")
}
Label {
Toggle(
"Prevent System Sleep while Recording",
isOn: Binding(
get: { store.hexSettings.preventSystemSleep },
set: { store.send(.togglePreventSystemSleep($0)) }
)
)
} icon: {
Image(systemName: "zzz")
}
Label {
Toggle(
"Super Fast Mode",
isOn: Binding(
get: { store.hexSettings.superFastModeEnabled },
set: { store.send(.toggleSuperFastMode($0)) }
)
)
Text("Keep the microphone warm and prepend a short in-memory buffer for near-instant capture. macOS will keep showing the microphone indicator while this mode is armed.")
} icon: {
Image(systemName: "bolt.circle")
}
Label {
HStack(alignment: .center) {
Text("Audio Behavior while Recording")
Spacer()
Picker("", selection: Binding(
get: { store.hexSettings.recordingAudioBehavior },
set: { store.send(.setRecordingAudioBehavior($0)) }
)) {
Label("Pause Media", systemImage: "pause")
.tag(RecordingAudioBehavior.pauseMedia)
Label("Mute Volume", systemImage: "speaker.slash")
.tag(RecordingAudioBehavior.mute)
Label("Do Nothing", systemImage: "hand.raised.slash")
.tag(RecordingAudioBehavior.doNothing)
}
.pickerStyle(.menu)
}
} icon: {
Image(systemName: "speaker.wave.2")
}
} header: {
Text("General")
}
.enableInjection()
}
}
@@ -0,0 +1,124 @@
import ComposableArchitecture
import Inject
import SwiftUI
import HexCore
struct HistorySectionView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
var body: some View {
Section {
Label {
Toggle("Save Transcription History", isOn: Binding(
get: { store.hexSettings.saveTranscriptionHistory },
set: { store.send(.toggleSaveTranscriptionHistory($0)) }
))
Text("Save transcriptions and audio recordings for later access")
.settingsCaption()
} icon: {
Image(systemName: "clock.arrow.circlepath")
}
if store.hexSettings.saveTranscriptionHistory {
Label {
HStack {
Text("Maximum History Entries")
Spacer()
Picker("", selection: Binding(
get: { store.hexSettings.maxHistoryEntries ?? 0 },
set: { newValue in
store.send(.setMaxHistoryEntries(newValue == 0 ? nil : newValue))
}
)) {
Text("Unlimited").tag(0)
Text("50").tag(50)
Text("100").tag(100)
Text("200").tag(200)
Text("500").tag(500)
Text("1000").tag(1000)
}
.pickerStyle(.menu)
.frame(width: 120)
}
} icon: {
Image(systemName: "number.square")
}
if store.hexSettings.maxHistoryEntries != nil {
Text("Oldest entries will be automatically deleted when limit is reached")
.settingsCaption()
.padding(.leading, 28)
}
PasteLastTranscriptHotkeyRow(store: store)
}
} header: {
Text("History")
} footer: {
if !store.hexSettings.saveTranscriptionHistory {
Text("When disabled, transcriptions will not be saved and audio files will be deleted immediately after transcription.")
.font(.footnote)
.foregroundColor(.secondary)
}
}
.enableInjection()
}
}
private struct PasteLastTranscriptHotkeyRow: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
var body: some View {
let pasteHotkey = store.hexSettings.pasteLastTranscriptHotkey
VStack(alignment: .leading, spacing: 12) {
Label {
VStack(alignment: .leading, spacing: 2) {
Text("Paste Last Transcript")
.font(.subheadline.weight(.semibold))
Text("Assign a shortcut (modifier + key) to instantly paste your last transcription.")
.settingsCaption()
}
} icon: {
Image(systemName: "doc.on.clipboard")
}
let key = store.isSettingPasteLastTranscriptHotkey ? nil : pasteHotkey?.key
let modifiers = store.isSettingPasteLastTranscriptHotkey ? store.currentPasteLastModifiers : (pasteHotkey?.modifiers ?? .init(modifiers: []))
HStack {
Spacer()
ZStack {
HotKeyView(modifiers: modifiers, key: key, isActive: store.isSettingPasteLastTranscriptHotkey)
if !store.isSettingPasteLastTranscriptHotkey, pasteHotkey == nil {
Text("Not set")
.settingsCaption()
}
}
.contentShape(Rectangle())
.onTapGesture {
store.send(.startSettingPasteLastTranscriptHotkey)
}
Spacer()
}
if store.isSettingPasteLastTranscriptHotkey {
Text("Use at least one modifier (⌘, ⌥, ⇧, ⌃) plus a key.")
.settingsCaption()
} else if pasteHotkey != nil {
Button {
store.send(.clearPasteLastTranscriptHotkey)
} label: {
Label("Clear shortcut", systemImage: "xmark.circle")
}
.buttonStyle(.borderless)
.font(.caption)
.foregroundStyle(.secondary)
}
}
.enableInjection()
}
}
+125
View File
@@ -0,0 +1,125 @@
import ComposableArchitecture
import HexCore
import Inject
import SwiftUI
struct HotKeySectionView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
var body: some View {
Section("Hot Key") {
let hotKey = store.hexSettings.hotkey
let key = store.isSettingHotKey ? nil : hotKey.key
let modifiers = store.isSettingHotKey ? store.currentModifiers : hotKey.modifiers
VStack(spacing: 12) {
// Hot key view
HStack {
Spacer()
HotKeyView(modifiers: modifiers, key: key, isActive: store.isSettingHotKey)
.animation(.spring(), value: key)
.animation(.spring(), value: modifiers)
Spacer()
}
.contentShape(Rectangle())
.onTapGesture {
store.send(.startSettingHotKey)
}
if !store.isSettingHotKey,
hotKey.key == nil,
!hotKey.modifiers.isEmpty {
ModifierSideControls(
modifiers: hotKey.modifiers,
onSelect: { kind, side in
store.send(.setModifierSide(kind, side))
}
)
.transition(.opacity)
}
}
Label {
Toggle(
"Enable double-tap lock",
isOn: Binding(
get: { store.hexSettings.doubleTapLockEnabled },
set: { store.send(.setDoubleTapLockEnabled($0)) }
)
)
} icon: {
Image(systemName: "hand.tap")
}
// Double-tap only mode applies to key+modifier combinations.
if hotKey.key != nil {
Label {
Toggle(
"Use double-tap only",
isOn: Binding(
get: { store.hexSettings.useDoubleTapOnly },
set: { store.send(.setUseDoubleTapOnly($0)) }
)
)
.disabled(!store.hexSettings.doubleTapLockEnabled)
} icon: {
Image(systemName: "hand.tap.fill")
}
}
// Minimum key time (for modifier-only shortcuts)
if store.hexSettings.hotkey.key == nil {
Label {
Slider(
value: Binding(
get: { store.hexSettings.minimumKeyTime },
set: { store.send(.setMinimumKeyTime($0)) }
),
in: 0.0 ... 2.0,
step: 0.1
) {
Text("Ignore below \(store.hexSettings.minimumKeyTime, specifier: "%.1f")s")
}
} icon: {
Image(systemName: "clock")
}
}
}
.enableInjection()
}
}
private struct ModifierSideControls: View {
@ObserveInjection var inject
var modifiers: Modifiers
var onSelect: (Modifier.Kind, Modifier.Side) -> Void
var body: some View {
VStack(alignment: .leading, spacing: 8) {
ForEach(modifiers.kinds, id: \.self) { kind in
if kind.supportsSideSelection {
let binding = Binding<Modifier.Side>(
get: { modifiers.side(for: kind) ?? .either },
set: { onSelect(kind, $0) }
)
VStack(alignment: .leading, spacing: 4) {
Text("\(kind.symbol) \(kind.displayName)")
.settingsCaption()
Picker("Modifier side", selection: binding) {
ForEach(Modifier.Side.allCases, id: \.self) { side in
Text(side.displayName)
.tag(side)
.disabled(!kind.supportsSideSelection && side != .either)
}
}
.pickerStyle(.segmented)
}
}
}
}
.enableInjection()
}
}
+94
View File
@@ -0,0 +1,94 @@
//
// HotKeyView.swift
// Hex
//
// Created by Kit Langton on 1/30/25.
//
import HexCore
import Inject
import Sauce
import SwiftUI
// This view shows the actual "keys" in a more modern, subtle style.
struct HotKeyView: View {
@ObserveInjection var inject
var modifiers: Modifiers
var key: Key?
var isActive: Bool
var body: some View {
HStack(spacing: 6) {
if modifiers.isHyperkey {
// Show Black Four Pointed Star for hyperkey
KeyView(text: "✦")
.transition(.blurReplace)
} else {
ForEach(modifiers.sorted) { modifier in
KeyView(text: modifier.stringValue)
.transition(.blurReplace)
}
}
if let key {
KeyView(text: key.toString)
}
if modifiers.isEmpty && key == nil {
Text("")
.font(.system(size: 12, weight: .regular, design: .monospaced))
.frame(width: 48, height: 48)
}
}
.padding(8)
.frame(maxWidth: .infinity)
.background {
if isActive && key == nil && modifiers.isEmpty {
Text("Enter a key combination")
.foregroundColor(.secondary)
.transition(.blurReplace)
}
}
.background(
RoundedRectangle(cornerRadius: 6)
.fill(Color.blue.opacity(isActive ? 0.1 : 0))
.stroke(Color.blue.opacity(isActive ? 0.2 : 0), lineWidth: 1)
)
.animation(.bouncy(duration: 0.3), value: key)
.animation(.bouncy(duration: 0.3), value: modifiers)
.animation(.bouncy(duration: 0.3), value: isActive)
.enableInjection()
}
}
struct KeyView: View {
@ObserveInjection var inject
var text: String
var body: some View {
Text(text)
.font(.title.weight(.bold))
.foregroundColor(.white)
.frame(width: 48, height: 48)
.background(
RoundedRectangle(cornerRadius: 8)
.fill(
Color(white: 0.2)
.shadow(.inner(color: .white.opacity(0.3), radius: 1, y: 1))
.shadow(.inner(color: .white.opacity(0.1), radius: 5, y: 8))
.shadow(.inner(color: .black.opacity(0.3), radius: 1, y: -3))
)
)
.shadow(radius: 4, y: 2)
.enableInjection()
}
}
#Preview {
HotKeyView(
modifiers: .init(modifiers: [.command, .shift]),
key: .a,
isActive: true
)
}
@@ -0,0 +1,30 @@
import SwiftUI
import Inject
#if canImport(ComposableArchitecture)
import ComposableArchitecture
#endif
struct LanguageSectionView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
var body: some View {
Label {
Picker(
"Output Language",
selection: Binding(
get: { store.hexSettings.outputLanguage },
set: { store.send(.setOutputLanguage($0)) }
)
) {
ForEach(store.languages, id: \.id) { language in
Text(language.name).tag(language.code as String?)
}
}
.pickerStyle(.menu)
} icon: {
Image(systemName: "globe")
}
.enableInjection()
}
}
@@ -0,0 +1,87 @@
import ComposableArchitecture
import Inject
import SwiftUI
struct MicrophoneSelectionSectionView: View {
private static let systemDefaultTag = "__system_default__"
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
private var selectedDeviceTag: Binding<String> {
Binding(
get: { store.hexSettings.selectedMicrophoneID ?? Self.systemDefaultTag },
set: { newValue in
store.send(.setSelectedMicrophoneID(newValue == Self.systemDefaultTag ? nil : newValue))
}
)
}
private var missingSelectedDeviceID: String? {
guard let selectedID = store.hexSettings.selectedMicrophoneID,
!store.availableInputDevices.contains(where: { $0.id == selectedID })
else {
return nil
}
return selectedID
}
private var pickerIdentity: String {
[
store.defaultInputDeviceName ?? "",
store.hexSettings.selectedMicrophoneID ?? Self.systemDefaultTag,
store.availableInputDevices.map { "\($0.id):\($0.name)" }.joined(separator: "|")
].joined(separator: "||")
}
var body: some View {
Section {
// Input device picker
HStack {
Label {
let systemLabel: String = {
if let name = store.defaultInputDeviceName, !name.isEmpty {
return "System Default (\(name))"
}
return "System Default"
}()
Picker("Input Device", selection: selectedDeviceTag) {
Text(systemLabel).tag(Self.systemDefaultTag)
ForEach(store.availableInputDevices) { device in
Text(device.name).tag(device.id)
}
if let missingSelectedDeviceID {
Text("Unavailable Device").tag(missingSelectedDeviceID)
}
}
.pickerStyle(.menu)
.id(pickerIdentity)
} icon: {
Image(systemName: "mic.circle")
}
Button(action: {
store.send(.loadAvailableInputDevices)
}) {
Image(systemName: "arrow.clockwise")
}
.buttonStyle(.borderless)
.help("Refresh available input devices")
}
// Show fallback note for selected device not connected
if missingSelectedDeviceID != nil {
Text("Selected device not connected. System default will be used.")
.settingsCaption()
}
} header: {
Text("Microphone Selection")
} footer: {
Text("Override the system default microphone with a specific input device. This setting will persist across sessions.")
.font(.footnote)
.foregroundColor(.secondary)
}
.enableInjection()
}
}
@@ -0,0 +1,525 @@
// MARK: – ModelDownloadFeature.swift
// A full‐featured TCA reducer for managing on‑device ML models.
// Dependencies: ComposableArchitecture, IdentifiedCollections, Dependencies
import AppKit
import ComposableArchitecture
import Dependencies
import HexCore
import IdentifiedCollections
// ──────────────────────────────────────────────────────────────────────────
// MARK: – Data Models
// ──────────────────────────────────────────────────────────────────────────
public struct ModelInfo: Equatable, Identifiable {
public let name: String
public var isDownloaded: Bool
public var id: String { name }
public init(name: String, isDownloaded: Bool) {
self.name = name
self.isDownloaded = isDownloaded
}
}
public struct CuratedModelInfo: Equatable, Identifiable, Codable {
public let displayName: String
public let internalName: String
public let size: String
public let accuracyStars: Int
public let speedStars: Int
public let storageSize: String
public var isDownloaded: Bool
public var id: String { internalName }
public var badge: String? {
switch parakeetModel {
case .englishV2:
return "BEST FOR ENGLISH"
case .multilingualV3:
return "BEST FOR MULTILINGUAL"
case nil:
return nil
}
}
var parakeetModel: ParakeetModel? {
ParakeetModel(rawValue: internalName)
}
var isParakeet: Bool {
parakeetModel != nil
}
public init(
displayName: String,
internalName: String,
size: String,
accuracyStars: Int,
speedStars: Int,
storageSize: String,
isDownloaded: Bool
) {
self.displayName = displayName
self.internalName = internalName
self.size = size
self.accuracyStars = accuracyStars
self.speedStars = speedStars
self.storageSize = storageSize
self.isDownloaded = isDownloaded
}
// Codable (isDownloaded is set at runtime)
private enum CodingKeys: String, CodingKey { case displayName, internalName, size, accuracyStars, speedStars, storageSize }
public init(from decoder: Decoder) throws {
let c = try decoder.container(keyedBy: CodingKeys.self)
displayName = try c.decode(String.self, forKey: .displayName)
internalName = try c.decode(String.self, forKey: .internalName)
size = try c.decode(String.self, forKey: .size)
accuracyStars = try c.decode(Int.self, forKey: .accuracyStars)
speedStars = try c.decode(Int.self, forKey: .speedStars)
storageSize = try c.decode(String.self, forKey: .storageSize)
isDownloaded = false
}
}
// Convenience helper for loading the bundled models.json once.
private enum CuratedModelLoader {
private static let bundledModels: [CuratedModelInfo] = {
guard let url = Bundle.main.url(forResource: "models", withExtension: "json") ??
Bundle.main.url(forResource: "models", withExtension: "json", subdirectory: "Data")
else {
assertionFailure("models.json not found in bundle")
return []
}
do { return try JSONDecoder().decode([CuratedModelInfo].self, from: Data(contentsOf: url)) }
catch { assertionFailure("Failed to decode models.json - \(error)"); return [] }
}()
static func load() -> [CuratedModelInfo] {
bundledModels
}
}
// ──────────────────────────────────────────────────────────────────────────
// MARK: – Domain
// ──────────────────────────────────────────────────────────────────────────
@Reducer
public struct ModelDownloadFeature {
@ObservableState
public struct State: Equatable {
// Shared user settings
@Shared(.hexSettings) var hexSettings: HexSettings
@Shared(.modelBootstrapState) var modelBootstrapState: ModelBootstrapState
// Remote data
public var availableModels: IdentifiedArrayOf<ModelInfo> = []
public var curatedModels = IdentifiedArrayOf(uniqueElements: CuratedModelLoader.load())
public var recommendedModel: String = ""
// UI state
public var isLoadingModels = false
public var isDownloading = false
public var downloadProgress: Double = 0
public var downloadError: String?
public var downloadingModelName: String?
// Track which model generated a progress update to handle switching models
public var activeDownloadID: UUID?
// Convenience computed vars
var selectedModel: String { hexSettings.selectedModel }
/// The downloaded model matching the current selection, pattern-aware so
/// legacy or glob-style selections (e.g. "distil*large-v3") still resolve.
private var downloadedModelMatchingSelection: ModelInfo? {
guard !selectedModel.isEmpty else { return nil }
return availableModels.first { model in
model.isDownloaded && ModelPatternMatcher.namesMatch(model.name, selectedModel)
}
}
var selectedModelNameForDisplay: String? {
guard !selectedModel.isEmpty else { return nil }
if let downloaded = downloadedModelMatchingSelection {
return downloaded.name
}
if modelBootstrapState.isModelReady,
let identifier = modelBootstrapState.modelIdentifier,
ModelPatternMatcher.namesMatch(identifier, selectedModel)
{
return selectedModel
}
return hexSettings.hasCompletedModelBootstrap ? selectedModel : nil
}
var selectedModelIsDownloaded: Bool {
downloadedModelMatchingSelection != nil
}
var anyModelDownloaded: Bool {
availableModels.contains(where: { $0.isDownloaded })
}
}
// MARK: Actions
public enum Action: BindableAction {
case binding(BindingAction<State>)
// Requests
case fetchModels
case selectModel(String)
case downloadModel(String)
// Effects
case modelsLoaded(recommended: String, available: [ModelInfo])
case modelsLoadFailed
case downloadProgress(id: UUID, progress: Double)
case downloadCompleted(id: UUID, result: Result<String, Error>)
case cancelDownload
case deleteModel(String)
case modelDeleted(String)
case modelDeletionFailed(Error)
case openModelLocation(String)
}
// MARK: Dependencies
@Dependency(\.transcription) var transcription
public init() {}
// MARK: Reducer
public var body: some ReducerOf<Self> {
BindingReducer()
Reduce(reduce)
}
// MARK: - Helpers (pattern matching)
private func resolvePattern(_ pattern: String, from available: [ModelInfo]) -> String? {
ModelPatternMatcher.resolvePattern(pattern, from: available.map { ($0.name, $0.isDownloaded) })
}
private func curatedDisplayName(for model: String, curated: IdentifiedArrayOf<CuratedModelInfo>) -> String {
if let match = curated.first(where: { ModelPatternMatcher.matches($0.internalName, model) }) {
return match.displayName
}
return model
.replacingOccurrences(of: "-", with: " ")
.replacingOccurrences(of: "_", with: " ")
.capitalized
}
private func updateBootstrapState(_ state: inout State) {
let model = state.hexSettings.selectedModel
guard !model.isEmpty else {
state.$modelBootstrapState.withLock { bootstrap in
bootstrap.modelIdentifier = ""
bootstrap.modelDisplayName = ""
bootstrap.isModelReady = false
bootstrap.progress = 0
bootstrap.lastError = nil
}
return
}
let displayName = curatedDisplayName(for: model, curated: state.curatedModels)
let isDownloaded = state.selectedModelIsDownloaded
state.$modelBootstrapState.withLock { bootstrap in
bootstrap.modelIdentifier = model
bootstrap.modelDisplayName = displayName
bootstrap.isModelReady = isDownloaded
if isDownloaded {
bootstrap.lastError = nil
bootstrap.progress = 1
}
}
}
private func reduce(state: inout State, action: Action) -> Effect<Action> {
switch action {
// MARK: – UI bindings
case .binding:
return .none
case let .selectModel(model):
// If the curated item is a glob (e.g., "distil*large-v3"),
// resolve it to a concrete available model so both tabs stay in sync
let resolved = resolvePattern(model, from: Array(state.availableModels)) ?? model
state.$hexSettings.withLock { $0.selectedModel = resolved }
updateBootstrapState(&state)
return .none
// MARK: – Fetch Models
case .fetchModels:
guard !state.isLoadingModels else { return .none }
state.isLoadingModels = true
return .run { send in
do {
async let recommendedSupportTask = transcription.getRecommendedModels()
async let availableNamesTask = transcription.getAvailableModels()
let recommendedSupport = try await recommendedSupportTask
let names = try await availableNamesTask
let recommended = recommendedSupport.default
let infos = try await withThrowingTaskGroup(of: ModelInfo.self) { group -> [ModelInfo] in
for name in names {
group.addTask {
ModelInfo(
name: name,
isDownloaded: await transcription.isModelDownloaded(name)
)
}
}
return try await group.reduce(into: []) { $0.append($1) }
}
await send(.modelsLoaded(recommended: recommended, available: infos))
} catch {
await send(.modelsLoadFailed)
}
}
case .modelsLoadFailed:
state.isLoadingModels = false
return .none
case let .modelsLoaded(recommended, available):
state.isLoadingModels = false
// Ensure our curated Parakeet options are visible even if WhisperKit doesn't list them
var availablePlus = available
for model in ParakeetModel.allCases.reversed() {
if !availablePlus.contains(where: { $0.name == model.identifier }) {
availablePlus.insert(ModelInfo(name: model.identifier, isDownloaded: false), at: 0)
}
}
if availablePlus.contains(where: { $0.name == state.preferredParakeetIdentifier }) {
state.recommendedModel = state.preferredParakeetIdentifier
} else {
state.recommendedModel = recommended
}
state.availableModels = IdentifiedArrayOf(uniqueElements: availablePlus)
// If the selected model is a pattern, resolve it now to the first available match
if state.hexSettings.selectedModel.contains("*") || state.hexSettings.selectedModel.contains("?") {
if let resolved = resolvePattern(state.hexSettings.selectedModel, from: available) {
state.$hexSettings.withLock { $0.selectedModel = resolved }
}
}
// Merge curated + download status with pattern support
var curated = CuratedModelLoader.load()
for idx in curated.indices {
let internalName = curated[idx].internalName
if let match = available.first(where: { ModelPatternMatcher.matches(internalName, $0.name) }) {
curated[idx].isDownloaded = match.isDownloaded
} else {
curated[idx].isDownloaded = false
}
}
state.curatedModels = IdentifiedArrayOf(uniqueElements: curated)
// If the selection isn't installed but another model is, switch to the
// installed one so transcription keeps working. Never clear the user's
// selection outright: availability scans can produce false negatives
// (e.g. after a dependency changes its cache layout), and wiping the
// setting turns a transient glitch into a permanent silent failure.
if !state.selectedModelIsDownloaded,
let installedModel = state.curatedModels.first(where: \.isDownloaded)
{
let fallback = resolvePattern(installedModel.internalName, from: Array(state.availableModels)) ?? installedModel.internalName
if fallback != state.selectedModel {
state.$hexSettings.withLock { $0.selectedModel = fallback }
}
}
updateBootstrapState(&state)
if !state.anyModelDownloaded && !state.hexSettings.hasCompletedModelBootstrap {
let preferred = state.recommendedModel.isEmpty ? state.hexSettings.selectedModel : state.recommendedModel
if !preferred.isEmpty {
state.$hexSettings.withLock { $0.selectedModel = preferred }
updateBootstrapState(&state)
}
}
return .none
// MARK: – Download
case let .downloadModel(requestedModel):
guard !requestedModel.isEmpty, !state.isDownloading else { return .none }
// Resolve glob/legacy selections to a concrete model name up front so
// the completion handler updates the matching rows and writes a
// concrete name back into settings.
let model = resolvePattern(requestedModel, from: Array(state.availableModels)) ?? requestedModel
state.downloadError = nil
state.isDownloading = true
state.downloadProgress = 0
state.downloadingModelName = model
state.activeDownloadID = UUID()
let downloadID = state.activeDownloadID!
if !state.anyModelDownloaded {
let displayName = curatedDisplayName(for: model, curated: state.curatedModels)
state.$modelBootstrapState.withLock {
$0.modelIdentifier = model
$0.modelDisplayName = displayName
$0.isModelReady = false
$0.progress = 0
$0.lastError = nil
}
}
return .run { send in
do {
try await transcription.downloadModel(model) { progress in
let fractionCompleted = progress.fractionCompleted
Task {
await send(.downloadProgress(id: downloadID, progress: fractionCompleted))
}
}
await send(.downloadCompleted(id: downloadID, result: .success(model)))
} catch is CancellationError {
} catch {
await send(.downloadCompleted(id: downloadID, result: .failure(error)))
}
}
.cancellable(id: downloadID)
case let .downloadProgress(id, progress):
guard state.activeDownloadID == id else { return .none }
guard state.downloadProgress != progress else { return .none }
state.downloadProgress = progress
if !state.modelBootstrapState.isModelReady {
state.$modelBootstrapState.withLock { $0.progress = progress }
}
return .none
case let .downloadCompleted(id, result):
guard state.activeDownloadID == id else { return .none }
state.isDownloading = false
state.downloadingModelName = nil
state.activeDownloadID = nil
state.downloadProgress = 0
var failureMessage: String?
switch result {
case let .success(name):
state.availableModels[id: name]?.isDownloaded = true
if let idx = state.curatedModels.firstIndex(where: { $0.internalName == name }) {
state.curatedModels[idx].isDownloaded = true
}
state.$hexSettings.withLock { settings in
settings.selectedModel = name
settings.hasCompletedModelBootstrap = true
}
state.downloadError = nil
case let .failure(err):
let ns = err as NSError
var message = ns.localizedDescription
if let url = ns.userInfo[NSURLErrorFailingURLErrorKey] as? URL,
let host = url.host
{
message += " (\(host))"
} else if let str = ns.userInfo[NSURLErrorFailingURLStringErrorKey] as? String,
let u = URL(string: str), let host = u.host
{
message += " (\(host))"
}
state.downloadError = message
failureMessage = message
}
state.$modelBootstrapState.withLock { bootstrap in
if let failureMessage {
bootstrap.isModelReady = false
bootstrap.lastError = failureMessage
bootstrap.progress = 0
} else {
bootstrap.isModelReady = true
bootstrap.lastError = nil
bootstrap.progress = 1
}
}
updateBootstrapState(&state)
return .none
case .cancelDownload:
guard let id = state.activeDownloadID else { return .none }
state.isDownloading = false
state.downloadingModelName = nil
state.activeDownloadID = nil
state.downloadProgress = 0
state.$modelBootstrapState.withLock { $0.progress = 0 }
updateBootstrapState(&state)
return .cancel(id: id)
case let .deleteModel(model):
guard !model.isEmpty else { return .none }
let resolved = resolvePattern(model, from: Array(state.availableModels)) ?? model
if ModelPatternMatcher.namesMatch(model, state.selectedModel) {
state.$modelBootstrapState.withLock { $0.isModelReady = false }
}
return .run { send in
do {
try await transcription.deleteModel(resolved)
await send(.modelDeleted(resolved))
} catch {
await send(.modelDeletionFailed(error))
}
}
case let .modelDeleted(model):
state.availableModels[id: model]?.isDownloaded = false
for index in state.curatedModels.indices
where ModelPatternMatcher.matches(state.curatedModels[index].internalName, model) {
state.curatedModels[index].isDownloaded = false
}
if ModelPatternMatcher.namesMatch(state.selectedModel, model) {
let fallback = state.availableModels.first { $0.isDownloaded }?.name ?? ""
state.$hexSettings.withLock { $0.selectedModel = fallback }
updateBootstrapState(&state)
}
return .send(.fetchModels)
case let .modelDeletionFailed(error):
state.downloadError = error.localizedDescription
updateBootstrapState(&state)
return .none
case let .openModelLocation(model):
return openModelLocationEffect(for: model)
}
}
// MARK: Helpers
private func openModelLocationEffect(for model: String) -> Effect<Action> {
// Parakeet caches live under FluidAudio's directory, not the WhisperKit
// models folder. Route "Show in Finder" to the matching root so users
// don't end up staring at an empty WhisperKit folder thinking the
// Parakeet download silently failed.
let usesParakeetRoot = ParakeetModel(rawValue: model) != nil
return .run { _ in
let base = try usesParakeetRoot
? URL.hexParakeetModelsDirectory
: URL.hexModelsDirectory
NSWorkspace.shared.selectFile(nil, inFileViewerRootedAtPath: base.path)
}
}
}
extension ModelDownloadFeature.State {
var preferredParakeetIdentifier: String {
(prefersEnglishParakeet ? ParakeetModel.englishV2 : ParakeetModel.multilingualV3).identifier
}
private var prefersEnglishParakeet: Bool {
guard let language = hexSettings.outputLanguage?.lowercased(), !language.isEmpty else {
return true
}
return language.hasPrefix("en")
}
}
@@ -0,0 +1,606 @@
import ComposableArchitecture
import HexCore
import Inject
import SwiftUI
private func modelNamesMatch(_ lhs: String, _ rhs: String) -> Bool {
ModelPatternMatcher.namesMatch(lhs, rhs)
}
public struct ModelDownloadView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<ModelDownloadFeature>
@State private var isModelLibraryPresented = false
var shouldFlash: Bool = false
public init(store: StoreOf<ModelDownloadFeature>, shouldFlash: Bool = false) {
self.store = store
self.shouldFlash = shouldFlash
}
public var body: some View {
VStack(alignment: .leading, spacing: 12) {
if !store.modelBootstrapState.isModelReady,
let message = store.modelBootstrapState.lastError,
!message.isEmpty
{
AutoDownloadBannerView(
title: "Download failed",
subtitle: message,
progress: nil,
style: .error
)
}
if selectedModelName == nil, downloadingModel == nil {
NoModelChooser(
models: parakeetModels,
suggestedModel: suggestedParakeetIdentifier,
isLoading: store.isLoadingModels,
isFlashing: shouldFlash,
onDownload: { store.send(.downloadModel($0.internalName)) },
onBrowse: { isModelLibraryPresented = true },
onRetry: { store.send(.fetchModels) }
)
} else {
CurrentModelSummary(
model: selectedModel,
selectedModelName: selectedModelName,
isInstalled: store.selectedModelIsDownloaded,
isDownloadingAnything: store.isDownloading,
downloadingModel: downloadingModel,
downloadProgress: store.downloadProgress,
onBrowse: { isModelLibraryPresented = true },
onDownload: {
if let name = selectedModelName {
store.send(.downloadModel(name))
}
},
onCancelDownload: { store.send(.cancelDownload) }
)
}
if let err = store.downloadError,
err != store.modelBootstrapState.lastError
{
Text("Model Error: \(err)")
.foregroundColor(.red)
.font(.caption)
}
}
.frame(maxWidth: .infinity, alignment: .leading)
.sheet(isPresented: $isModelLibraryPresented) {
ModelLibrarySheet(store: store)
}
.task {
if store.availableModels.isEmpty {
store.send(.fetchModels)
}
}
.enableInjection()
}
private var selectedModel: CuratedModelInfo? {
guard let selectedModelName else { return nil }
return store.curatedModels.first { model in
modelNamesMatch(model.internalName, selectedModelName)
}
}
private var selectedModelName: String? {
store.selectedModelNameForDisplay
}
private var downloadingModel: CuratedModelInfo? {
guard let downloadingModelName = store.downloadingModelName else { return nil }
return store.curatedModels.first { model in
modelNamesMatch(model.internalName, downloadingModelName)
}
}
private var parakeetModels: [CuratedModelInfo] {
let models = store.curatedModels.filter(\.isParakeet)
return models.filter { modelNamesMatch($0.internalName, suggestedParakeetIdentifier) } +
models.filter { !modelNamesMatch($0.internalName, suggestedParakeetIdentifier) }
}
private var suggestedParakeetIdentifier: String {
store.preferredParakeetIdentifier
}
}
private struct NoModelChooser: View {
let models: [CuratedModelInfo]
let suggestedModel: String
let isLoading: Bool
let isFlashing: Bool
let onDownload: (CuratedModelInfo) -> Void
let onBrowse: () -> Void
let onRetry: () -> Void
var body: some View {
VStack(alignment: .leading, spacing: 12) {
HStack(spacing: 12) {
Image(systemName: "arrow.down.circle.fill")
.font(.title3)
.foregroundStyle(Color.accentColor)
.frame(width: 28)
VStack(alignment: .leading, spacing: 3) {
Text("Choose a transcription model")
.font(.body.weight(.medium))
Text("Download a local model to start transcribing.")
.font(.caption)
.foregroundStyle(.secondary)
}
Spacer()
Button("View All Models…", action: onBrowse)
.controlSize(.small)
}
if models.isEmpty {
if isLoading {
Text("Loading model choices…")
.font(.caption)
.foregroundStyle(.secondary)
} else {
HStack {
Text("Model choices couldn’t be loaded.")
.font(.caption)
.foregroundStyle(.secondary)
Button("Retry", action: onRetry)
.controlSize(.small)
}
}
} else {
HStack(spacing: 10) {
ForEach(models) { model in
NoModelCard(
model: model,
isRecommended: matches(model),
isFlashing: isFlashing && matches(model),
onDownload: { onDownload(model) }
)
}
}
}
}
.padding(10)
.background(Color(NSColor.controlBackgroundColor), in: RoundedRectangle(cornerRadius: 8))
.overlay(
RoundedRectangle(cornerRadius: 8)
.stroke(borderColor, lineWidth: isFlashing ? 3 : 1)
.animation(.easeInOut(duration: 0.5).repeatCount(3, autoreverses: true), value: isFlashing)
)
}
private var borderColor: Color {
if isFlashing { return Color.accentColor }
return Color.primary.opacity(0.08)
}
private func matches(_ model: CuratedModelInfo) -> Bool {
modelNamesMatch(model.internalName, suggestedModel)
}
}
private struct NoModelCard: View {
let model: CuratedModelInfo
let isRecommended: Bool
let isFlashing: Bool
let onDownload: () -> Void
var body: some View {
Button(action: onDownload) {
VStack(alignment: .leading, spacing: 8) {
HStack(alignment: .top, spacing: 8) {
Text(model.displayName)
.font(.body.weight(.medium))
.foregroundStyle(.primary)
Spacer(minLength: 8)
if isRecommended {
Text("Suggested")
.font(.caption2.weight(.medium))
.foregroundStyle(Color.accentColor)
.padding(.horizontal, 6)
.padding(.vertical, 2)
.background(Color.accentColor.opacity(0.12), in: Capsule())
}
}
HStack(spacing: 6) {
Text(model.size)
Text("·")
Text(model.storageSize)
Spacer()
Image(systemName: "arrow.down.circle")
}
.font(.caption)
.foregroundStyle(.secondary)
}
.padding(12)
.frame(maxWidth: .infinity, alignment: .leading)
.background(Color(NSColor.windowBackgroundColor).opacity(0.45), in: RoundedRectangle(cornerRadius: 8))
.overlay(
RoundedRectangle(cornerRadius: 8)
.stroke(borderColor, lineWidth: isFlashing ? 3 : 1)
.animation(.easeInOut(duration: 0.5).repeatCount(3, autoreverses: true), value: isFlashing)
)
.contentShape(.rect)
}
.buttonStyle(.plain)
}
private var borderColor: Color {
if isFlashing { return Color.accentColor }
if isRecommended { return Color.accentColor.opacity(0.45) }
return Color.primary.opacity(0.08)
}
}
private struct CurrentModelSummary: View {
let model: CuratedModelInfo?
let selectedModelName: String?
let isInstalled: Bool
let isDownloadingAnything: Bool
let downloadingModel: CuratedModelInfo?
let downloadProgress: Double
let onBrowse: () -> Void
let onDownload: () -> Void
let onCancelDownload: () -> Void
var body: some View {
HStack(spacing: 12) {
Image(systemName: iconName)
.font(.title3)
.foregroundStyle(needsDownload ? Color.orange : Color.accentColor)
.frame(width: 28)
VStack(alignment: .leading, spacing: 5) {
Text(title)
.font(.body.weight(.medium))
Text(subtitle)
.font(.caption)
.foregroundStyle(needsDownload ? Color.orange : Color.secondary)
if let activeDownloadStatus {
Text(activeDownloadStatus)
.font(.caption)
.foregroundStyle(.secondary)
}
if isDownloadingAnything {
ProgressView(value: downloadProgress)
.progressViewStyle(.linear)
}
}
Spacer()
if isDownloadingAnything {
VStack(alignment: .trailing, spacing: 4) {
Text("\(Int(downloadProgress * 100))%")
.font(.caption)
.foregroundStyle(.secondary)
.monospacedDigit()
Button("Cancel", role: .destructive, action: onCancelDownload)
.controlSize(.small)
}
} else {
HStack(spacing: 8) {
if needsDownload {
Button("Download", action: onDownload)
.buttonStyle(.borderedProminent)
.controlSize(.small)
}
Button("Browse Models…", action: onBrowse)
.controlSize(.small)
}
}
}
.padding(10)
.background(Color(NSColor.controlBackgroundColor), in: RoundedRectangle(cornerRadius: 8))
}
/// The selection references a model that isn't on disk (e.g. the scan came
/// back empty after an update). Offer a direct download instead of
/// pretending it's installed.
private var needsDownload: Bool {
selectedModelName != nil && !isInstalled && !isDownloadingAnything
}
private var title: String {
if let model { return model.displayName }
if let selectedModelName {
return selectedModelName
.replacingOccurrences(of: "-", with: " ")
.replacingOccurrences(of: "_", with: " ")
.capitalized
}
if let downloadingModel { return "Downloading \(downloadingModel.displayName)…" }
return "Choose a transcription model"
}
private var subtitle: String {
if needsDownload { return "Not downloaded — transcription won't work until you download it." }
if let model { return "\(model.size) · \(model.storageSize)" }
if selectedModelName != nil { return "Installed local model" }
if let downloadingModel { return "\(downloadingModel.storageSize) will be stored locally on this Mac." }
return "Download a local model to start transcribing."
}
private var activeDownloadStatus: String? {
guard selectedModelName != nil, let downloadingModel else { return nil }
return "Downloading \(downloadingModel.displayName)…"
}
private var iconName: String {
if needsDownload { return "exclamationmark.triangle.fill" }
if selectedModelName == nil { return "arrow.down.circle.fill" }
return "waveform"
}
}
private struct ModelLibrarySheet: View {
@Bindable var store: StoreOf<ModelDownloadFeature>
@Environment(\.dismiss) private var dismiss
@State private var pendingDelete: CuratedModelInfo?
var body: some View {
VStack(alignment: .leading, spacing: 14) {
HStack(alignment: .top) {
VStack(alignment: .leading, spacing: 4) {
Text("Model Library")
.font(.title2.weight(.semibold))
Text("Select an installed model to use it, or download another model for local transcription.")
.font(.caption)
.foregroundStyle(.secondary)
}
Spacer()
Button("Done") { dismiss() }
.keyboardShortcut(.defaultAction)
}
ScrollView {
VStack(alignment: .leading, spacing: 14) {
if let recommendedLibraryModel {
modelSection(title: "Recommended", models: [recommendedLibraryModel], showsBadges: false)
}
if !otherLibraryModels.isEmpty {
modelSection(title: "Other Models", models: otherLibraryModels, showsBadges: true)
}
}
}
Label("Models run locally on your Mac. Downloads are stored on this device.", systemImage: "lock.shield")
.font(.caption)
.foregroundStyle(.secondary)
}
.padding(18)
.frame(minWidth: 680, minHeight: 420)
.confirmationDialog(
"Remove \(pendingDelete?.displayName ?? "model")?",
isPresented: Binding(
get: { pendingDelete != nil },
set: { if !$0 { pendingDelete = nil } }
),
titleVisibility: .visible
) {
if let pendingDelete {
Button("Remove Download", role: .destructive) {
store.send(.deleteModel(pendingDelete.internalName))
self.pendingDelete = nil
}
}
Button("Cancel", role: .cancel) { pendingDelete = nil }
} message: {
if let pendingDelete {
Text("This frees \(pendingDelete.storageSize) on this Mac. You can download it again anytime.")
}
}
}
private func select(_ model: CuratedModelInfo) {
guard model.isDownloaded, !store.isDownloading else { return }
store.send(.selectModel(model.internalName))
}
@ViewBuilder
private func modelSection(title: String, models: [CuratedModelInfo], showsBadges: Bool) -> some View {
VStack(alignment: .leading, spacing: 6) {
Text(title)
.font(.caption.weight(.semibold))
.foregroundStyle(.secondary)
.padding(.horizontal, 2)
VStack(spacing: 0) {
ForEach(models) { model in
ModelLibraryRow(
model: model,
isSelected: model.isDownloaded && isSelected(model),
isDownloading: isDownloading(model),
// Only the active row receives live progress so the other
// rows don't re-render on every tick.
downloadProgress: isDownloading(model) ? store.downloadProgress : 0,
isDisabled: store.isDownloading && !isDownloading(model),
showsBadge: showsBadges && !model.isDownloaded,
onSelect: { select(model) },
onDownload: { store.send(.downloadModel(model.internalName)) },
onCancelDownload: { store.send(.cancelDownload) },
onShowInFinder: { store.send(.openModelLocation(model.internalName)) },
onDelete: { pendingDelete = model }
)
if model.id != models.last?.id {
Divider().padding(.leading, 54)
}
}
}
.background(Color(NSColor.controlBackgroundColor), in: RoundedRectangle(cornerRadius: 10))
}
}
private var recommendedLibraryModel: CuratedModelInfo? {
store.curatedModels.first { modelNamesMatch($0.internalName, suggestedParakeetIdentifier) } ?? store.curatedModels.first(where: \.isParakeet)
}
private var otherLibraryModels: [CuratedModelInfo] {
guard let recommendedLibraryModel else { return Array(store.curatedModels) }
return store.curatedModels.filter { $0.id != recommendedLibraryModel.id }
}
private func isSelected(_ model: CuratedModelInfo) -> Bool {
let selected = store.hexSettings.selectedModel
return modelNamesMatch(model.internalName, selected)
}
private func isDownloading(_ model: CuratedModelInfo) -> Bool {
store.isDownloading && store.downloadingModelName == model.internalName
}
private var suggestedParakeetIdentifier: String {
store.preferredParakeetIdentifier
}
}
private struct ModelLibraryRow: View {
let model: CuratedModelInfo
let isSelected: Bool
let isDownloading: Bool
let downloadProgress: Double
let isDisabled: Bool
let showsBadge: Bool
let onSelect: () -> Void
let onDownload: () -> Void
let onCancelDownload: () -> Void
let onShowInFinder: () -> Void
let onDelete: () -> Void
var body: some View {
HStack(spacing: 0) {
Button(action: onSelect) {
HStack(spacing: 12) {
Image(systemName: leadingIcon)
.foregroundStyle(leadingColor)
.font(.body)
.frame(width: 24)
VStack(alignment: .leading, spacing: 4) {
HStack(spacing: 7) {
Text(model.displayName)
.font(.body.weight(.medium))
if showsBadge, let badge = model.badge {
Text(badge)
.font(.caption2.weight(.medium))
.foregroundStyle(Color.accentColor)
.padding(.horizontal, 6)
.padding(.vertical, 2)
.background(Color.accentColor.opacity(0.12), in: Capsule())
}
}
HStack(spacing: 12) {
Text(model.size)
.font(.caption)
.foregroundStyle(.secondary)
HStack(spacing: 5) {
Text("Accuracy").font(.caption2).foregroundStyle(.secondary)
StarRatingView(model.accuracyStars)
}
HStack(spacing: 5) {
Text("Speed").font(.caption2).foregroundStyle(.secondary)
StarRatingView(model.speedStars)
}
}
}
Spacer()
VStack(alignment: .trailing, spacing: 3) {
Text(model.storageSize)
.font(.caption)
.foregroundStyle(.secondary)
if let statusText {
Text(statusText)
.font(.caption2)
.foregroundStyle(isSelected ? Color.accentColor : Color.secondary)
}
}
}
.padding(.horizontal, 12)
.padding(.vertical, 10)
.contentShape(.rect)
}
.buttonStyle(.plain)
trailingControls
.padding(.trailing, 12)
}
.disabled(isDisabled)
.opacity(isDisabled ? 0.55 : 1)
.background(isSelected ? Color.accentColor.opacity(0.06) : Color.clear)
.contextMenu {
if isDownloading {
Button("Cancel Download", role: .destructive, action: onCancelDownload)
Button("Show in Finder", action: onShowInFinder)
}
if model.isDownloaded {
managementMenuItems
}
}
}
/// Shared by the trailing ⋯ menu and the right-click context menu.
@ViewBuilder
private var managementMenuItems: some View {
Button("Show in Finder", action: onShowInFinder)
Divider()
Button("Remove Download…", role: .destructive, action: onDelete)
}
@ViewBuilder
private var trailingControls: some View {
if isDownloading {
HStack(spacing: 8) {
ProgressView(value: downloadProgress)
.progressViewStyle(.circular)
.controlSize(.small)
Text("\(Int(downloadProgress * 100))%")
.font(.caption)
.foregroundStyle(.secondary)
.monospacedDigit()
Button("Cancel", role: .destructive, action: onCancelDownload)
.controlSize(.small)
}
} else if model.isDownloaded {
Menu {
managementMenuItems
} label: {
Image(systemName: "ellipsis.circle")
.font(.body)
.foregroundStyle(.secondary)
}
.menuStyle(.borderlessButton)
.menuIndicator(.hidden)
.fixedSize()
.help("Show in Finder or remove this download")
} else {
Button("Download", action: onDownload)
.controlSize(.small)
.help("Download \(model.storageSize) and switch to this model")
}
}
private var statusText: String? {
if isDownloading { return "Downloading…" }
if isSelected { return "In Use" }
if model.isDownloaded { return "Installed" }
return nil
}
private var leadingIcon: String {
if isDownloading { return "arrow.down.circle.fill" }
if isSelected { return "checkmark.circle.fill" }
if model.isDownloaded { return "circle" }
return "arrow.down.circle"
}
private var leadingColor: Color {
if isDownloading || isSelected { return .accentColor }
return .secondary
}
}
@@ -0,0 +1,25 @@
import Inject
import SwiftUI
struct StarRatingView: View {
@ObserveInjection var inject
let filled: Int
let max: Int
init(_ filled: Int, max: Int = 5) {
self.filled = filled
self.max = max
}
var body: some View {
HStack(spacing: 3) {
ForEach(0 ..< max, id: \.self) { i in
Image(systemName: i < filled ? "circle.fill" : "circle")
.font(.system(size: 7))
.foregroundColor(i < filled ? .blue : .gray.opacity(0.5))
}
}
.enableInjection()
}
}
+19
View File
@@ -0,0 +1,19 @@
import ComposableArchitecture
import Inject
import SwiftUI
struct ModelSectionView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
let shouldFlash: Bool
var body: some View {
Section("Transcription Model") {
ModelDownloadView(
store: store.scope(state: \.modelDownload, action: \.modelDownload),
shouldFlash: shouldFlash
)
}
.enableInjection()
}
}
@@ -0,0 +1,116 @@
import ComposableArchitecture
import HexCore
import Inject
import SwiftUI
struct PermissionsSectionView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
let microphonePermission: PermissionStatus
let accessibilityPermission: PermissionStatus
let inputMonitoringPermission: PermissionStatus
var body: some View {
Section {
HStack(spacing: 12) {
// Microphone
permissionCard(
title: "Microphone",
icon: "mic.fill",
status: microphonePermission,
action: { store.send(.requestMicrophone) }
)
// Accessibility + Keyboard
permissionCard(
title: "Accessibility",
icon: "accessibility",
status: combinedAccessibilityStatus,
action: {
store.send(.requestAccessibility)
store.send(.requestInputMonitoring)
}
)
}
if store.hotkeyPermissionState.inputMonitoring != .granted {
VStack(alignment: .leading, spacing: 6) {
Label {
Text("Input Monitoring is required so Hex can listen for your hotkey.")
.font(.callout)
.foregroundStyle(.primary)
} icon: {
Image(systemName: "exclamationmark.triangle.fill")
.foregroundStyle(.yellow)
}
Button {
store.send(.requestInputMonitoring)
} label: {
Text("Open Input Monitoring Settings")
}
.buttonStyle(.borderedProminent)
.controlSize(.small)
}
.padding(12)
.background(Color(nsColor: .controlBackgroundColor))
.clipShape(RoundedRectangle(cornerRadius: 10))
}
} header: {
Text("Permissions")
}
.enableInjection()
}
@ViewBuilder
private func permissionCard(
title: String,
icon: String,
status: PermissionStatus,
action: @escaping () -> Void
) -> some View {
HStack(spacing: 8) {
Image(systemName: icon)
.font(.body)
.foregroundStyle(.secondary)
.frame(width: 16)
Text(title)
.font(.body.weight(.medium))
.lineLimit(1)
.truncationMode(.tail)
.layoutPriority(1)
Spacer()
switch status {
case .granted:
Image(systemName: "checkmark.circle.fill")
.foregroundStyle(.green)
.font(.body)
case .denied, .notDetermined:
Button("Grant") {
action()
}
.buttonStyle(.bordered)
.controlSize(.small)
}
}
.padding(.horizontal, 12)
.padding(.vertical, 8)
.frame(maxWidth: .infinity)
.background(Color(nsColor: .controlBackgroundColor))
.clipShape(RoundedRectangle(cornerRadius: 8))
}
private var combinedAccessibilityStatus: PermissionStatus {
if accessibilityPermission == .granted && inputMonitoringPermission == .granted {
return .granted
}
if accessibilityPermission == .denied || inputMonitoringPermission == .denied {
return .denied
}
return .notDetermined
}
}
+580
View File
@@ -0,0 +1,580 @@
import AVFoundation
import AppKit
import ComposableArchitecture
import CoreAudio
import Dependencies
import HexCore
import IdentifiedCollections
import Sauce
import ServiceManagement
import SwiftUI
private let settingsLogger = HexLog.settings
private typealias SettingsAudioPropertyListenerBlock = @convention(block) (UInt32, UnsafePointer<AudioObjectPropertyAddress>) -> Void
private enum HotKeyCaptureTarget {
case recording
case pasteLastTranscript
}
extension SharedReaderKey
where Self == InMemoryKey<Bool>.Default
{
static var isSettingHotKey: Self {
Self[.inMemory("isSettingHotKey"), default: false]
}
static var isSettingPasteLastTranscriptHotkey: Self {
Self[.inMemory("isSettingPasteLastTranscriptHotkey"), default: false]
}
static var isRemappingScratchpadFocused: Self {
Self[.inMemory("isRemappingScratchpadFocused"), default: false]
}
}
// MARK: - Settings Feature
@Reducer
struct SettingsFeature {
@ObservableState
struct State {
@Shared(.hexSettings) var hexSettings: HexSettings
@Shared(.isSettingHotKey) var isSettingHotKey: Bool = false
@Shared(.isSettingPasteLastTranscriptHotkey) var isSettingPasteLastTranscriptHotkey: Bool = false
@Shared(.isRemappingScratchpadFocused) var isRemappingScratchpadFocused: Bool = false
@Shared(.transcriptionHistory) var transcriptionHistory: TranscriptionHistory
@Shared(.hotkeyPermissionState) var hotkeyPermissionState: HotkeyPermissionState
var languages: IdentifiedArrayOf<Language> = []
var currentModifiers: Modifiers = .init(modifiers: [])
var currentPasteLastModifiers: Modifiers = .init(modifiers: [])
var remappingScratchpadText: String = ""
// Available microphones
var availableInputDevices: [AudioInputDevice] = []
var defaultInputDeviceName: String?
// Model Management
var modelDownload = ModelDownloadFeature.State()
var shouldFlashModelSection = false
}
enum Action: BindableAction {
case binding(BindingAction<State>)
// Existing
case task
case startSettingHotKey
case startSettingPasteLastTranscriptHotkey
case clearPasteLastTranscriptHotkey
case keyEvent(KeyEvent)
case toggleOpenOnLogin(Bool)
case toggleShowDockIcon(Bool)
case togglePreventSystemSleep(Bool)
case setRecordingAudioBehavior(RecordingAudioBehavior)
case toggleSuperFastMode(Bool)
case setUseClipboardPaste(Bool)
case setCopyToClipboard(Bool)
case setDoubleTapLockEnabled(Bool)
case setUseDoubleTapOnly(Bool)
case setMinimumKeyTime(Double)
case setOutputLanguage(String?)
case setSelectedMicrophoneID(String?)
case setSoundEffectsEnabled(Bool)
case setSoundEffectsVolume(Double)
// Permission delegation (forwarded to AppFeature)
case requestMicrophone
case requestAccessibility
case requestInputMonitoring
// Microphone selection
case loadAvailableInputDevices
case availableInputDevicesLoaded([AudioInputDevice], String?)
// Model Management
case modelDownload(ModelDownloadFeature.Action)
// History Management
case toggleSaveTranscriptionHistory(Bool)
case setMaxHistoryEntries(Int?)
// Modifier configuration
case setModifierSide(Modifier.Kind, Modifier.Side)
// Word remappings
case setWordRemovalsEnabled(Bool)
case addWordRemoval
case updateWordRemoval(WordRemoval)
case removeWordRemoval(UUID)
case addWordRemapping
case updateWordRemapping(WordRemapping)
case removeWordRemapping(UUID)
case setRemappingScratchpadFocused(Bool)
case setLowercaseTranscripts(Bool)
case setRemovePunctuation(Bool)
}
@Dependency(\.keyEventMonitor) var keyEventMonitor
@Dependency(\.transcription) var transcription
@Dependency(\.recording) var recording
@Dependency(\.soundEffects) var soundEffects
@Dependency(\.transcriptPersistence) var transcriptPersistence
private func deleteAudioEffect(for transcripts: [Transcript]) -> Effect<Action> {
.run { [transcriptPersistence] _ in
for transcript in transcripts {
try? await transcriptPersistence.deleteAudio(transcript)
}
}
}
private func beginCapture(_ target: HotKeyCaptureTarget, state: inout State) {
switch target {
case .recording:
state.$isSettingHotKey.withLock { $0 = true }
state.currentModifiers = .init(modifiers: [])
case .pasteLastTranscript:
state.$isSettingPasteLastTranscriptHotkey.withLock { $0 = true }
state.currentPasteLastModifiers = .init(modifiers: [])
}
}
private func endCapture(_ target: HotKeyCaptureTarget, state: inout State) {
switch target {
case .recording:
state.$isSettingHotKey.withLock { $0 = false }
state.currentModifiers = .init(modifiers: [])
case .pasteLastTranscript:
state.$isSettingPasteLastTranscriptHotkey.withLock { $0 = false }
state.currentPasteLastModifiers = .init(modifiers: [])
}
}
private func captureModifiers(for target: HotKeyCaptureTarget, state: State) -> Modifiers {
switch target {
case .recording:
state.currentModifiers
case .pasteLastTranscript:
state.currentPasteLastModifiers
}
}
private func updateCaptureModifiers(_ modifiers: Modifiers, for target: HotKeyCaptureTarget, state: inout State) {
switch target {
case .recording:
state.currentModifiers = modifiers
case .pasteLastTranscript:
state.currentPasteLastModifiers = modifiers
}
}
private func applyCapturedHotKey(key: Key?, modifiers: Modifiers, for target: HotKeyCaptureTarget, state: inout State) {
switch target {
case .recording:
state.$hexSettings.withLock {
$0.hotkey.key = key
$0.hotkey.modifiers = modifiers.erasingSides()
}
case .pasteLastTranscript:
guard let key else { return }
state.$hexSettings.withLock {
$0.pasteLastTranscriptHotkey = HotKey(key: key, modifiers: modifiers.erasingSides())
}
}
}
private func handleCapture(_ keyEvent: KeyEvent, for target: HotKeyCaptureTarget, state: inout State) -> Effect<Action> {
if keyEvent.key == .escape {
endCapture(target, state: &state)
return .none
}
let updatedModifiers = keyEvent.modifiers.union(captureModifiers(for: target, state: state))
updateCaptureModifiers(updatedModifiers, for: target, state: &state)
if target == .pasteLastTranscript, keyEvent.key != nil, updatedModifiers.isEmpty {
return .none
}
if let key = keyEvent.key {
applyCapturedHotKey(key: key, modifiers: updatedModifiers, for: target, state: &state)
endCapture(target, state: &state)
return .none
}
if target == .recording, keyEvent.modifiers.isEmpty {
applyCapturedHotKey(key: nil, modifiers: updatedModifiers, for: target, state: &state)
endCapture(target, state: &state)
}
return .none
}
var body: some ReducerOf<Self> {
BindingReducer()
Scope(state: \.modelDownload, action: \.modelDownload) {
ModelDownloadFeature()
}
Reduce { state, action in
switch action {
case .binding:
let didNormalizeDoubleTapOnly = !state.hexSettings.doubleTapLockEnabled && state.hexSettings.useDoubleTapOnly
if didNormalizeDoubleTapOnly {
state.$hexSettings.withLock {
$0.useDoubleTapOnly = false
}
}
return .none
case .task:
if let url = Bundle.main.url(forResource: "languages", withExtension: "json"),
let data = try? Data(contentsOf: url),
let languages = try? JSONDecoder().decode([Language].self, from: data)
{
state.languages = IdentifiedArray(uniqueElements: languages)
} else {
settingsLogger.error("Failed to load languages JSON from bundle")
}
// Listen for key events and load microphones (existing + new)
return .run { send in
func audioPropertyAddress(
_ selector: AudioObjectPropertySelector,
scope: AudioObjectPropertyScope = kAudioObjectPropertyScopeGlobal,
element: AudioObjectPropertyElement = kAudioObjectPropertyElementMain
) -> AudioObjectPropertyAddress {
AudioObjectPropertyAddress(
mSelector: selector,
mScope: scope,
mElement: element
)
}
await send(.modelDownload(.fetchModels))
await send(.loadAvailableInputDevices)
// Listen for device connection/disconnection notifications
// Using a simpler debounced approach with a single task
var deviceUpdateTask: Task<Void, Never>?
var audioHardwareObservers: [(AudioObjectPropertySelector, SettingsAudioPropertyListenerBlock)] = []
// Helper function to debounce device updates
func debounceDeviceUpdate() {
deviceUpdateTask?.cancel()
deviceUpdateTask = Task {
try? await Task.sleep(nanoseconds: 500_000_000) // 500ms
if !Task.isCancelled {
await send(.loadAvailableInputDevices)
}
}
}
func installAudioHardwareObserver(_ selector: AudioObjectPropertySelector) {
let listener: SettingsAudioPropertyListenerBlock = { _, _ in
debounceDeviceUpdate()
}
var address = audioPropertyAddress(selector)
let status = AudioObjectAddPropertyListenerBlock(
AudioObjectID(kAudioObjectSystemObject),
&address,
DispatchQueue.main,
listener
)
if status == noErr {
audioHardwareObservers.append((selector, listener))
} else {
settingsLogger.error("Failed to observe audio hardware selector \(selector): \(status)")
}
}
let deviceConnectionObserver = NotificationCenter.default.addObserver(
forName: NSNotification.Name(rawValue: "AVCaptureDeviceWasConnected"),
object: nil,
queue: .main
) { _ in
debounceDeviceUpdate()
}
let deviceDisconnectionObserver = NotificationCenter.default.addObserver(
forName: NSNotification.Name(rawValue: "AVCaptureDeviceWasDisconnected"),
object: nil,
queue: .main
) { _ in
debounceDeviceUpdate()
}
let appDidBecomeActiveObserver = NotificationCenter.default.addObserver(
forName: NSApplication.didBecomeActiveNotification,
object: nil,
queue: .main
) { _ in
debounceDeviceUpdate()
}
let wakeObserver = NSWorkspace.shared.notificationCenter.addObserver(
forName: NSWorkspace.didWakeNotification,
object: nil,
queue: .main
) { _ in
debounceDeviceUpdate()
}
installAudioHardwareObserver(kAudioHardwarePropertyDefaultInputDevice)
installAudioHardwareObserver(kAudioHardwarePropertyDevices)
// Be sure to clean up resources when the task is finished
defer {
deviceUpdateTask?.cancel()
NotificationCenter.default.removeObserver(deviceConnectionObserver)
NotificationCenter.default.removeObserver(deviceDisconnectionObserver)
NotificationCenter.default.removeObserver(appDidBecomeActiveObserver)
NSWorkspace.shared.notificationCenter.removeObserver(wakeObserver)
for (selector, listener) in audioHardwareObservers {
var address = audioPropertyAddress(selector)
let status = AudioObjectRemovePropertyListenerBlock(
AudioObjectID(kAudioObjectSystemObject),
&address,
DispatchQueue.main,
listener
)
if status != noErr {
settingsLogger.error("Failed to remove audio hardware observer for selector \(selector): \(status)")
}
}
}
for try await keyEvent in await keyEventMonitor.listenForKeyPress() {
await send(.keyEvent(keyEvent))
}
}
case .startSettingHotKey:
beginCapture(.recording, state: &state)
return .none
case .addWordRemoval:
state.$hexSettings.withLock {
$0.wordRemovals.append(.init(pattern: ""))
}
return .none
case let .updateWordRemoval(removal):
state.$hexSettings.withLock {
guard let index = $0.wordRemovals.firstIndex(where: { $0.id == removal.id }) else { return }
$0.wordRemovals[index] = removal
}
return .none
case let .removeWordRemoval(id):
state.$hexSettings.withLock {
$0.wordRemovals.removeAll { $0.id == id }
}
return .none
case .addWordRemapping:
state.$hexSettings.withLock {
$0.wordRemappings.append(.init(match: "", replacement: ""))
}
return .none
case let .updateWordRemapping(remapping):
state.$hexSettings.withLock {
guard let index = $0.wordRemappings.firstIndex(where: { $0.id == remapping.id }) else { return }
$0.wordRemappings[index] = remapping
}
return .none
case let .removeWordRemapping(id):
state.$hexSettings.withLock {
$0.wordRemappings.removeAll { $0.id == id }
}
return .none
case let .setRemappingScratchpadFocused(isFocused):
state.$isRemappingScratchpadFocused.withLock { $0 = isFocused }
return .none
case let .setLowercaseTranscripts(enabled):
state.$hexSettings.withLock { $0.lowercaseTranscripts = enabled }
return .none
case let .setRemovePunctuation(enabled):
state.$hexSettings.withLock { $0.removePunctuation = enabled }
return .none
case .startSettingPasteLastTranscriptHotkey:
beginCapture(.pasteLastTranscript, state: &state)
return .none
case .clearPasteLastTranscriptHotkey:
state.$hexSettings.withLock { $0.pasteLastTranscriptHotkey = nil }
return .none
case let .keyEvent(keyEvent):
if state.isSettingPasteLastTranscriptHotkey {
return handleCapture(keyEvent, for: .pasteLastTranscript, state: &state)
}
guard state.isSettingHotKey else { return .none }
return handleCapture(keyEvent, for: .recording, state: &state)
case let .toggleOpenOnLogin(enabled):
state.$hexSettings.withLock { $0.openOnLogin = enabled }
return .run { _ in
if enabled {
try? SMAppService.mainApp.register()
} else {
try? SMAppService.mainApp.unregister()
}
}
case let .toggleShowDockIcon(enabled):
state.$hexSettings.withLock { $0.showDockIcon = enabled }
return .run { _ in
await MainActor.run {
NotificationCenter.default.post(name: .updateAppMode, object: nil)
}
}
case let .togglePreventSystemSleep(enabled):
state.$hexSettings.withLock { $0.preventSystemSleep = enabled }
return .none
case let .setUseClipboardPaste(enabled):
state.$hexSettings.withLock { $0.useClipboardPaste = enabled }
return .none
case let .setCopyToClipboard(enabled):
state.$hexSettings.withLock { $0.copyToClipboard = enabled }
return .none
case let .setRecordingAudioBehavior(behavior):
state.$hexSettings.withLock { $0.recordingAudioBehavior = behavior }
return .none
case let .toggleSuperFastMode(enabled):
state.$hexSettings.withLock { $0.superFastModeEnabled = enabled }
return .run { _ in
await recording.warmUpRecorder()
}
case let .setDoubleTapLockEnabled(enabled):
state.$hexSettings.withLock {
$0.doubleTapLockEnabled = enabled
if !enabled {
$0.useDoubleTapOnly = false
}
}
return .none
case let .setUseDoubleTapOnly(enabled):
state.$hexSettings.withLock {
$0.useDoubleTapOnly = enabled && $0.doubleTapLockEnabled
}
return .none
case let .setMinimumKeyTime(value):
state.$hexSettings.withLock { $0.minimumKeyTime = value }
return .none
case let .setOutputLanguage(language):
state.$hexSettings.withLock { $0.outputLanguage = language }
return .none
case let .setSelectedMicrophoneID(deviceID):
state.$hexSettings.withLock { $0.selectedMicrophoneID = deviceID }
return .run { _ in
await recording.warmUpRecorder()
}
case let .setSoundEffectsEnabled(enabled):
state.$hexSettings.withLock { $0.soundEffectsEnabled = enabled }
return .run { _ in
await soundEffects.setEnabled(enabled)
}
case let .setSoundEffectsVolume(volume):
state.$hexSettings.withLock { $0.soundEffectsVolume = volume }
return .none
// Permission requests
case .requestMicrophone:
settingsLogger.info("User requested microphone permission from settings")
return .none
case .requestAccessibility:
settingsLogger.info("User requested accessibility permission from settings")
return .none
case .requestInputMonitoring:
settingsLogger.info("User requested input monitoring permission from settings")
return .none
// Model Management
case .modelDownload:
return .none
// Microphone device selection
case .loadAvailableInputDevices:
return .run { send in
let devices = await recording.getAvailableInputDevices()
let defaultName = await recording.getDefaultInputDeviceName()
await send(.availableInputDevicesLoaded(devices, defaultName))
}
case let .availableInputDevicesLoaded(devices, defaultName):
if let selectedMicrophoneID = state.hexSettings.selectedMicrophoneID,
let device = devices.first(where: { $0.legacyID == selectedMicrophoneID }) {
state.availableInputDevices = devices
state.defaultInputDeviceName = defaultName
return .send(.setSelectedMicrophoneID(device.id))
}
state.availableInputDevices = devices
state.defaultInputDeviceName = defaultName
return .none
case let .toggleSaveTranscriptionHistory(enabled):
state.$hexSettings.withLock { $0.saveTranscriptionHistory = enabled }
// If disabling history, delete all existing entries
if !enabled {
let transcripts = state.transcriptionHistory.history
// Clear the history
state.$transcriptionHistory.withLock { history in
history.history.removeAll()
}
return deleteAudioEffect(for: transcripts)
}
return .none
case let .setMaxHistoryEntries(maxHistoryEntries):
state.$hexSettings.withLock { $0.maxHistoryEntries = maxHistoryEntries }
return .none
case let .setModifierSide(kind, side):
guard state.hexSettings.hotkey.key == nil else { return .none }
state.$hexSettings.withLock {
$0.hotkey.modifiers = $0.hotkey.modifiers.setting(kind: kind, to: side)
}
return .none
case let .setWordRemovalsEnabled(enabled):
state.$hexSettings.withLock { $0.wordRemovalsEnabled = enabled }
return .none
}
}
}
}
+57
View File
@@ -0,0 +1,57 @@
import ComposableArchitecture
import HexCore
import Inject
import SwiftUI
struct SettingsView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
let microphonePermission: PermissionStatus
let accessibilityPermission: PermissionStatus
let inputMonitoringPermission: PermissionStatus
var body: some View {
Form {
if microphonePermission != .granted
|| accessibilityPermission != .granted
|| inputMonitoringPermission != .granted {
PermissionsSectionView(
store: store,
microphonePermission: microphonePermission,
accessibilityPermission: accessibilityPermission,
inputMonitoringPermission: inputMonitoringPermission
)
}
ModelSectionView(store: store, shouldFlash: store.shouldFlashModelSection)
// Only show language picker for WhisperKit models (not Parakeet)
if ParakeetModel(rawValue: store.hexSettings.selectedModel) == nil {
LanguageSectionView(store: store)
}
HotKeySectionView(store: store)
if microphonePermission == .granted {
MicrophoneSelectionSectionView(store: store)
}
SoundSectionView(store: store)
GeneralSectionView(store: store)
HistorySectionView(store: store)
}
.formStyle(.grouped)
.task {
await store.send(.task).finish()
}
.enableInjection()
}
}
// MARK: - Shared Styles
extension Text {
/// Applies caption font with secondary color, commonly used for helper/description text in settings.
func settingsCaption() -> some View {
self.font(.caption).foregroundStyle(.secondary)
}
}
+61
View File
@@ -0,0 +1,61 @@
import ComposableArchitecture
import HexCore
import Inject
import SwiftUI
struct SoundSectionView: View {
@ObserveInjection var inject
@Bindable var store: StoreOf<SettingsFeature>
var body: some View {
let sliderBinding = Binding<Double>(
get: { volumePercentage(for: store.hexSettings.soundEffectsVolume) },
set: { store.send(.setSoundEffectsVolume(actualVolume(fromPercentage: $0))) }
)
return Section {
Label {
Toggle(
"Sound Effects",
isOn: Binding(
get: { store.hexSettings.soundEffectsEnabled },
set: { store.send(.setSoundEffectsEnabled($0)) }
)
)
} icon: {
Image(systemName: "speaker.wave.2.fill")
}
VStack(alignment: .leading, spacing: 8) {
HStack {
Text("Volume")
Spacer()
Text(formattedVolume(for: store.hexSettings.soundEffectsVolume))
.foregroundStyle(.secondary)
.monospacedDigit()
}
Slider(value: sliderBinding, in: 0...1)
.disabled(!store.hexSettings.soundEffectsEnabled)
}
} header: {
Text("Sound")
}
.enableInjection()
}
}
private func formattedVolume(for actualVolume: Double) -> String {
let percent = volumePercentage(for: actualVolume)
return "\(Int(round(percent * 100)))%"
}
private func volumePercentage(for actualVolume: Double) -> Double {
guard HexSettings.baseSoundEffectsVolume > 0 else { return 0 }
let ratio = actualVolume / HexSettings.baseSoundEffectsVolume
return max(0, min(1, ratio))
}
private func actualVolume(fromPercentage percentage: Double) -> Double {
let clampedPercentage = max(0, min(1, percentage))
return clampedPercentage * HexSettings.baseSoundEffectsVolume
}