Search macOS Implementation (AppKit)
Modul Search di lingkungan macOS menggunakan infrastruktur antarmuka AppKit terpadu dalam SplitVC. Komponen visual memisahkan pemilihan cakupan pustaka (Search Scope), kontrol parameter masukan, dan penayangan daftar hasil yang diperbarui secara asinkron dari SearchViewModel.
Sumber kode: Source/Features/Search/macOS/
1. Arsitektur Komponen Visual
Antarmuka pencarian macOS dikoordinasikan di dalam SplitVC dengan pemisahan panel cakupan, panel kontrol hasil, dan area pembaca:
A. Hierarki Komponen Pencarian
flowchart TD
SVC["SplitVC (NSSplitViewController)"]
SSB["SearchSidebarVC (Scope Selector)"]
SOV["NSOutlineView (Hierarki Pustaka)"]
SVC --> SSB
SSB --> SOV
SOV ~~~ OSVC
OSVC["OptionSearchVC (Search Controller)"]
SVM["SearchViewModel (FTS Concurrent Worker)"]
SVC --> OSVC
OSVC <-->|"Combine Bindings"| SVM
OSVC ~~~ ITVC
ITVC["IbarotTextVC (Content Area)"]
ITV["IbarotTextView (Highlighted Arabic Text)"]
SVC --> ITVC
ITVC --> ITV
OSVC -.->|"itemDelegate (didSelectResult)"| ITVC
classDef ui fill:#e040fb26,stroke:#c026d3,stroke-width:2px;
classDef vm fill:#3b82f626,stroke:#2563eb,stroke-width:2px;
classDef store fill:#22c55e26,stroke:#16a34a,stroke-width:2px;
classDef db fill:#f9731626,stroke:#ea580c,stroke-width:2px;
classDef event fill:#be185d26,stroke:#9d174d,stroke-width:2px,color:#9d174d;
class SVC,SSB,SOV,OSVC,ITVC,ITV ui;
class SVM vm;
B. Taksonomi Kontrol & Parameter OptionSearchVC
mindmap
root((OptionSearchVC))
Masukan Kueri
DSFSearchField["Kolom input pencarian"]
RecentSearches["Riwayat pencarian tersimpan"]
Parameter Operator
phrasal["Pencarian Frasa Eksak"]
orNear["Operator OR & Kalimat Berdekatan"]
Kendali Eksekusi
startPause["Tombol Mulai / Jeda"]
cancelBtn["Pembatalan Kueri Aktif"]
progress["NSProgressIndicator"]
Penyajian Hasil
resultsTable["NSTableView"]
highlightCell["SearchCellView (Cuplikan Kuning)"]
contextMenu["Salin Teks Arab & Referensi"]
2. Alur Interaksi: Dari Aksi Klik Hasil Pencarian ke TextView
Ketika pengguna mengklik salah satu baris cuplikan hasil pencarian pada tabel OptionSearchVC:
sequenceDiagram
autonumber
actor User as Pengguna
participant Tbl as NSTableView
participant Opt as OptionSearchVC
participant Rdr as IbarotTextVC
User->>+Tbl: Klik baris hasil pencarian
Tbl->>+Opt: didSelectItem(row) / tableViewSelectionDidChange()
Opt->>+Rdr: itemDelegate?.didSelectResult(result)
Rdr->>Rdr: displayBook(book, targetPage: result.page)
deactivate Rdr
deactivate Opt
deactivate Tbl
sequenceDiagram
autonumber
participant Rdr as IbarotTextVC
participant VM as ReaderViewModel
participant DB as BookConnection
participant TV as IbarotTextView
Rdr->>+VM: loadContent(contentId: result.page, query: result.keyword)
VM->>+DB: getContent(contentId)
DB-->>-VM: sourceText mentah
VM->>VM: ArabicTextRenderer.render() & hitung sorotan kueri
VM-->>-Rdr: onContentReady(attributedText)
Rdr->>+TV: textStorage.setAttributedString(attributedText)
Rdr->>TV: layoutManager.ensureLayout()
Rdr->>TV: scrollRangeToVisible(matchedWordRange)
deactivate TV
3. Bedah Komponen Antarmuka Utama
1. OptionSearchVC (Class) - Search Controller
- Berperan sebagai kontroler pusat pencarian yang dapat ditempatkan di panel bawah
SplitVCatau di dalamOptionSearchPopover. - Pemantauan Combine Asinkron: Mengamati sinyal
searchDidReceiveResultdansearchProgressDidUpdatedariSearchViewModeluntuk memperbarui baris tabel secara bertahap tanpa memblokir antarmuka utama. - Kendali Eksekusi: Tombol jeda/lanjutkan (Pause/Resume) dan pembatalan (Cancel) pencarian FTS multithread.
- Menu Konteks Hasil: Menyediakan context menu klik kanan "Salin" (Copy) yang mematuhi protocol
CopyableResultuntuk menyusun kutipan teks Arab beserta referensi juz dan halaman.
2. SearchSidebarVC (Class) - Penyaring Cakupan / Scope
- Menampilkan hierarki kategori dan kitab menggunakan
NSOutlineViewyang ditenagai olehLibraryViewManager. - Pengguna dapat memilih satu kitab, sekumpulan kategori, atau seluruh perpustakaan sebagai batasan cakupan (scope) kueri pencarian FTS.
3. SearchCellView (Class) - Render Cuplikan & Highlight
- Subclass
NSTableCellViewyang dirancang untuk me-render teks hasil dengan tipografi Arab RTL. - Menggunakan
NSAttributedStringuntuk memberikan latar belakang sorotan kuning pada setiap kata kunci yang cocok dengan kueri pengguna.
4. OptionSearchPopover (Class)
- Abstraksi pembungkus berbasis
NSPopoveryang memungkinkan fungsionalitas pencarianOptionSearchVCdipanggil secara instan dari bilah menu atau tombol toolbar jendela.