ViewModel
NarratorViewModel adalah sumber kebenaran (single source of truth) dari fitur pencarian dan pembacaan profil perawi.
ViewModel ini dideklarasikan dengan makro @Observable untuk sinkronisasi state di SwiftUI (iOS) dan mengekspos properti/callback standar untuk bindings di AppKit (macOS).
State Management
Beberapa state penting yang dikelola oleh ViewModel:
tabaqaGroups: Daftar grup Tabaqah perawi (Hierarki).currentRowi: Perawi yang saat ini sedang dipilih untuk dilihat detailnya.displayMode: Mode tampilan saat ini (Murid, Guru, Jarh Ta'dil, Ringkasan).rowiContentText: String berformat (AttributedString) yang siap dirender diTextView.sidebarTarjamahList: Daftar biografi dari kitab-kitab khusus untuk perawi yang sedang dipilih.searchTarjamahList: Daftar biografi hasil dari pencarian teks penuh (FTS) secara global.
Alur Pencarian FTS (Full-Text Search Pipeline)
ViewModel ini mendukung pencarian teks penuh (FTS) lintas arsip (lintas kitab) yang berjumlah ribuan secara asinkron.
- Pencarian: Metode
startSearch(query:)akan dipanggil. - Streaming: Memanggil
TarjamahGlobalManager.shared.searchTarjamah. Selama hasil didapat secara batch, callbackonBatchResultakan menambahkan hasil pencarian kesearchTarjamahList. - Animasi UI: Di macOS,
onSearchBatchAppendedakan dieksekusi agar UINSTableViewbisa menyisipkan baris baru dengan efek fade tanpa freeze.
Pause & Resume
Pencarian global mendukung fitur Pause & Resume. NarratorViewModel menggunakan instance PauseController untuk memberhentikan sejenak alur asinkron pencarian database jika pengguna ingin berhenti melihat hasil sementara, dan melanjutkannya kembali.
Callback AppKit (macOS)
Karena macOS Maktabah menggunakan arsitektur AppKit/MVC yang diikat dengan ViewModel, ViewModel mengekspos banyak closure yang dipanggil di Main Actor:
onRowiContentUpdated: ((AttributedString) -> Void)?onSearchBatchAppended: ((Int, Int) -> Void)?onSearchComplete: (@MainActor () -> Void)?onSidebarTarjamahLoaded: (([TarjamahResult]) -> Void)?onCurrentRowiChanged: ((Rowi?) -> Void)?