macOS Implementation (AppKit)
Fitur Quran pada macOS menggunakan arsitektur AppKit dengan struktur NSSplitViewController yang terdiri dari tiga panel (three-pane layout).
QuranSplitVC (Class)
Bertindak sebagai kontainer utama yang menyatukan panel sidebar, panel teks Al-Qur'an, dan panel kitab tafsir:
- Menangani aksi pemilihan buku dari
QuranTafseerVCmelalui closure terisolasi@MainActor(Task { ... }), mewarisi konteks UI secara langsung saat mengoordinasikan pemuatan data tafsir dan menyajikan pesan peringatan (alert dialog) tanpa hop thread manual. - Menghubungkan navigasi dari
QuranNashVCkembali ke sidebar (sinkronisasi UI saat halaman berpindah).
QuranSidebarVC (Class)
Menampilkan hierarki Surah dan Ayat menggunakan NSOutlineView.
- Fitur: Pencarian nama surah dan pemetaan posisi ayat dengan kompleksitas $O(1)$ untuk pengguliran instan.
- Delegasi: Menggunakan
QuranDelegateuntuk mengirim data ayat yang dipilih keQuranNashVC.
QuranTafseerVC (Class)
Menampilkan daftar kitab tafsir yang tersedia dalam NSTableView.
- Mengambil daftar kitab dari
QuranDataManager.tafseerBooksyang telah difilter berdasarkan kategori tafsir.
QuranNashVC (Class)
Panel utama yang menyajikan teks ayat mushaf beserta penjelasan tafsirnya:
- Menampilkan teks Arab dengan format tipografi yang dapat disesuaikan.
- Mendukung tombol navigasi halaman berikutnya dan sebelumnya (paging).