Repository Public License
1//2// ORIX Audio3// File: Core/Sources/ORIXAudioCore/Speech/Transcript.swift4// Description: Transcript model (timed segments, optional words and manual speaker labels) and text search.5//6// Author: Simon-Pierre Boucher7// Contact: contact@spboucher.ai8//9import Foundation1011public struct TranscriptWord: Codable, Sendable, Hashable {12 public var text: String13 public var start: Double14 public var end: Double15 public var confidence: Double?16 public init(text: String, start: Double, end: Double, confidence: Double? = nil) { self.text = text; self.start = start; self.end = end; self.confidence = confidence }17}1819public struct TranscriptSegment: Codable, Sendable, Hashable, Identifiable {20 public var id = UUID()21 public var start: Double22 public var end: Double23 public var text: String24 /// Set by the user only ("Speaker 1"…). ORIX Audio does not identify voices.25 public var speaker: String?26 public var words: [TranscriptWord] = []27 public var isEdited = false28 public init(start: Double, end: Double, text: String, speaker: String? = nil, words: [TranscriptWord] = []) {29 self.start = start; self.end = end; self.text = text; self.speaker = speaker; self.words = words30 }31}3233public struct Transcript: Codable, Sendable, Equatable {34 public var localeIdentifier: String35 /// Which recogniser produced it, e.g. "SpeechTranscriber (on-device)".36 public var engine: String37 public var createdAt: Date38 public var segments: [TranscriptSegment]3940 public init(localeIdentifier: String, engine: String, createdAt: Date = .now, segments: [TranscriptSegment]) {41 self.localeIdentifier = localeIdentifier; self.engine = engine; self.createdAt = createdAt; self.segments = segments42 }4344 public var plainText: String { segments.map(\.text).joined(separator: " ") }45 public var wordCount: Int { segments.reduce(0) { $0 + $1.text.split(whereSeparator: \.isWhitespace).count } }46 public var duration: Double { segments.last?.end ?? 0 }4748 public func segmentIndex(at time: Double) -> Int? {49 segments.lastIndex { $0.start <= time + 0.01 }.flatMap { time <= segments[$0].end + 0.5 || $0 == segments.count - 1 ? $0 : $0 }50 }5152 /// Case- and diacritic-insensitive search; returns matching segment indices.53 public func search(_ query: String) -> [Int] {54 let q = query.trimmingCharacters(in: .whitespacesAndNewlines)55 guard !q.isEmpty else { return [] }56 return segments.indices.filter { segments[$0].text.range(of: q, options: [.caseInsensitive, .diacriticInsensitive]) != nil }57 }5859 /// Groups recogniser output into readable segments: breaks at sentence punctuation, long pauses, or when a segment grows past `maxDuration`.60 public static func segment(words: [TranscriptWord], maxDuration: Double = 12, pause: Double = 0.9) -> [TranscriptSegment] {61 var out: [TranscriptSegment] = []62 var current: [TranscriptWord] = []63 func flush() {64 guard let first = current.first, let last = current.last else { return }65 let text = current.map(\.text).joined(separator: " ").replacingOccurrences(of: " ", with: " ").trimmingCharacters(in: .whitespaces)66 if !text.isEmpty { out.append(TranscriptSegment(start: first.start, end: last.end, text: text, words: current)) }67 current = []68 }69 for w in words {70 if let last = current.last, let first = current.first, w.start - last.end > pause || w.end - first.start > maxDuration { flush() }71 current.append(w)72 if let c = w.text.trimmingCharacters(in: .whitespaces).last, ".!?…".contains(c), current.count >= 3 { flush() }73 }74 flush()75 return out76 }77}78