Remote voices

Zotero/Assets/en.lproj/Localizable.strings

@@ -598,6 +598,10 @@
 "accessibility.speech.forward" = "Skip forward";
 "accessibility.speech.backward" = "Skip backward";
 "accessibility.speech.title" = "Read Aloud";
+"accessibility.speech.unknown_voice" = "Voice";
+"accessibility.speech.speak" = "Speak";
+"accessibility.speech.automatic" = "Automatic";
+"accessibility.speech.no_voices_for_tier" = "No voices found for detected language %@ in this tier. Pick a different tier or choose language manually.";
 "accessibility.show_reader" = "Reading Mode";
 "accessibility.show_reader_accessibility_label" = "Switch to reading mode";
 "accessibility.show_speech" = "Read Aloud";

Zotero/Controllers/API/Requests/CreditsRequest.swift

@@ -0,0 +1,33 @@
+//
+//  CreditsRequest.swift
+//  Zotero
+//
+//  Created by Michal Rentka on 13.02.2026.
+//  Copyright © 2026 Corporation for Digital Scholarship. All rights reserved.
+//
+
+import Foundation
+
+struct CreditsRequest: ApiResponseRequest {
+    typealias Response = CreditsResponse
+
+    var endpoint: ApiEndpoint {
+        return .zotero(path: "tts/credits")
+    }
+
+    var httpMethod: ApiHttpMethod {
+        return .get
+    }
+
+    var encoding: ApiParameterEncoding {
+        return .url
+    }
+
+    var parameters: [String: Any]? {
+        return nil
+    }
+
+    var headers: [String: String]? {
+        return nil
+    }
+}

Zotero/Controllers/API/Requests/ReadAloudAudioRequest.swift

@@ -0,0 +1,58 @@
+//
+//  ReadAloudAudioRequest.swift
+//  Zotero
+//
+//  Created by Michal Rentka on 15.01.2026.
+//  Copyright © 2026 Corporation for Digital Scholarship. All rights reserved.
+//
+
+struct ReadAloudAudioRequest: ApiRequest {
+    let voiceId: String
+    let text: String
+    let language: String
+
+    var endpoint: ApiEndpoint {
+        return .zotero(path: "tts/speak")
+    }
+
+    var httpMethod: ApiHttpMethod {
+        return .get
+    }
+
+    var encoding: ApiParameterEncoding {
+        return .url
+    }
+
+    var parameters: [String: Any]? {
+        return ["text": text, "voice": voiceId, "lang": language]
+    }
+
+    var headers: [String: String]? {
+        return nil
+    }
+}
+
+struct ReadAloudSampleRequest: ApiRequest {
+    let voiceId: String
+    let language: String
+
+    var endpoint: ApiEndpoint {
+        return .zotero(path: "tts/sample")
+    }
+
+    var httpMethod: ApiHttpMethod {
+        return .get
+    }
+
+    var encoding: ApiParameterEncoding {
+        return .url
+    }
+
+    var parameters: [String: Any]? {
+        return ["voice": voiceId, "lang": language]
+    }
+
+    var headers: [String: String]? {
+        return nil
+    }
+}

Zotero/Controllers/API/Requests/VoicesRequest.swift

@@ -0,0 +1,33 @@
+//
+//  VoicesRequest.swift
+//  Zotero
+//
+//  Created by Michal Rentka on 14.01.2026.
+//  Copyright © 2026 Corporation for Digital Scholarship. All rights reserved.
+//
+
+import Foundation
+
+struct VoicesRequest: ApiResponseRequest {
+    typealias Response = [RemoteVoice]
+
+    var endpoint: ApiEndpoint {
+        return .zotero(path: "tts/voices")
+    }
+
+    var httpMethod: ApiHttpMethod {
+        return .get
+    }
+
+    var encoding: ApiParameterEncoding {
+        return .url
+    }
+
+    var parameters: [String: Any]? {
+        return nil
+    }
+
+    var headers: [String: String]? {
+        return nil
+    }
+}

Zotero/Controllers/API/Responses/CreditsResponse.swift

@@ -0,0 +1,14 @@
+//
+//  CreditsResponse.swift
+//  Zotero
+//
+//  Created by Michal Rentka on 13.02.2026.
+//  Copyright © 2026 Corporation for Digital Scholarship. All rights reserved.
+//
+
+import Foundation
+
+struct CreditsResponse: Decodable {
+    let standardCreditsRemaining: Int
+    let premiumCreditsRemaining: Int
+}

Zotero/Controllers/Database/Requests/ReadSpeechLanguageDbRequest.swift

@@ -17,6 +17,9 @@ struct ReadSpeechLanguageDbRequest: DbResponseRequest {
     var needsWrite: Bool { return false }
 
     func process(in database: Realm) throws -> String? {
-        return database.objects(RItem.self).filter(.key(key, in: libraryId)).first?.speechLanguage
+        if let language = database.objects(RItem.self).filter(.key(key, in: libraryId)).first?.speechLanguage, !language.isEmpty {
+            return language
+        }
+        return nil
     }
 }

Zotero/Controllers/LanguageDetector.swift

@@ -0,0 +1,74 @@
+//
+//  LanguageDetector.swift
+//  Zotero
+//
+//  Created by Michal Rentka on 19.02.2026.
+//  Copyright © 2026 Corporation for Digital Scholarship. All rights reserved.
+//
+
+import AVFAudio
+import NaturalLanguage
+
+/// Detects language with regional variation from text.
+/// NLLanguageRecognizer only detects base language (e.g., "en"), not regional variations (e.g., "en-US").
+/// This utility adds variation detection using device locale fallback and prominent variation defaults.
+enum LanguageDetector {
+    /// Default/prominent variations for languages that have multiple regional variants.
+    /// These are commonly used variations that serve as reasonable defaults.
+    private static let prominentVariations: [String: String] = [
+        "en": "en-US",
+        "es": "es-ES",
+        "pt": "pt-BR",
+        "zh": "zh-CN",
+        "fr": "fr-FR",
+        "de": "de-DE",
+        "ar": "ar-SA",
+        "nl": "nl-NL"
+    ]
+
+    /// Detects language with variation from the given text.
+    /// - Parameter text: The text to analyze
+    /// - Returns: A locale string with variation (e.g., "en-US")
+    static func detectLanguage(from text: String) -> String {
+        let recognizer = NLLanguageRecognizer()
+        recognizer.processString(text)
+        let baseLanguage = recognizer.dominantLanguage?.rawValue ?? "en"
+        return resolveVariation(for: baseLanguage)
+    }
+
+    /// Resolves a base language to a specific variation.
+    /// Uses device locale if it matches the base language, otherwise falls back to prominent variations,
+    /// then to the first available system voice locale for that language.
+    /// - Parameter baseLanguage: The base language code (e.g., "en")
+    /// - Returns: A locale string with variation (e.g., "en-US")
+    static func resolveVariation(for baseLanguage: String) -> String {
+        // Get all available variations for this language from system voices
+        let systemLocales = AVSpeechSynthesisVoice.speechVoices().map { $0.language }
+        let availableVariations = systemLocales.filter { $0.hasPrefix(baseLanguage) }
+
+        // If no variations available, fall back to en-US
+        guard !availableVariations.isEmpty else {
+            return "en-US"
+        }
+
+        // If only one variation exists, return it directly
+        if availableVariations.count == 1 {
+            return availableVariations[0]
+        }
+
+        // Check if device locale matches the base language - if so, use device's variation
+        let deviceLocale = Locale.current.identifier.replacingOccurrences(of: "_", with: "-")
+        let deviceBaseLanguage = String(deviceLocale.prefix(2))
+        if deviceBaseLanguage == baseLanguage, availableVariations.contains(deviceLocale) {
+            return deviceLocale
+        }
+
+        // Use prominent variation if available
+        if let prominentVariation = prominentVariations[baseLanguage], availableVariations.contains(prominentVariation) {
+            return prominentVariation
+        }
+
+        // Fall back to first available variation
+        return availableVariations[0]
+    }
+}