Data Models & State Types
Modul Search menggunakan beberapa model data untuk merepresentasikan item hasil pencarian, penampung kecocokan indeks mentah (hits), dan utilitas penyalinan (copy) maupun pengurutan data.
Model Struktur Data
SearchHit (Struct)
Struct ringan yang merepresentasikan satu baris hasil kecocokan indeks FTS mentah sebelum diuraikan konten teksnya:
struct SearchHit: Sendable, Identifiable, Hashable {
let archive: String
let tableName: String
let rowId: Int
let page: Int
let part: Int
var id: String { "\(archive)_\(tableName)_\(rowId)" }
}
archive: ID berkas arsip (misalnya"1").tableName: Nama tabel kitab (misalnya"b1442").rowId: ID baris halaman di dalam tabel kitab (32-bit bawah daripackedRowId).page&part: Metadata posisi halaman dan juz.
SearchResultItem (Struct)
Struct data utama hasil pencarian yang dikonsumsi oleh lapisan presentasi (UI). Mengadopsi arsitektur resolusi lazy snippet untuk menghemat memori saat ribuan hasil pencarian ditemukan:
struct SearchResultItem: Codable, CopyableResult, Hashable, Sendable, Identifiable {
let archive: String
let tableName: String
let bookId: Int
let bookTitle: String
let page: Int
let part: Int
private nonisolated(unsafe) let rawAttributedText: NSAttributedString?
var attributedText: NSAttributedString {
rawAttributedText ?? NSAttributedString(string: "")
}
var hasResolvedSnippet: Bool {
rawAttributedText != nil
}
var id: String { "\(archive)_\(tableName)_\(bookId)" }
var uniqueId: String { id }
}
Lazy Snippet & Deep Immutability
Properti rawAttributedText bersifat immutable (let) dan bernilai nil secara bawaan ketika hasil pencarian dipancarkan dari mesin FTS. Teks berformat NSAttributedString baru diurai dan disorot warnanya secara on-demand melalui SearchHitResolver ketika sel antarmuka pengguna memasuki viewport layar. Hal ini menjamin deep immutability pada SearchResultItem sehingga bebas dari potensi data race saat dibagikan lintas aktor/thread.
SearchSortKey (Enum)
Enum yang merepresentasikan kunci parameter saat melakukan pengurutan hasil pencarian.
bookTitle: Urut berdasarkan abjad nama kitab.page: Urut berdasarkan nomor halaman.part: Urut berdasarkan nomor juz/bagian.
Utilitas (Protocol & Helper)
CopyableResult (Protocol)
Protocol yang menetapkan standar pemformatan string ketika pengguna menyalin (copy) hasil pencarian ke dalam clipboard. Protocol ini secara otomatis merangkai teks kutipan beserta judul kitab, juz, dan nomor halaman dalam format angka Arab.
Terdapat ekstensi pembantu (helper) khusus di macOS:
extension ReusableFunc {
static func copyResults(
_ items: [some CopyableResult],
tableView: NSTableView
)
}
SearchResultsSorter (Struct)
Modul utilitas dengan metode statis sort(_:by:ascending:) untuk menyortir array SearchResultItem secara dinamis menyesuaikan kriteria yang diteruskan melalui SearchSortKey.