prpm-dbp 0.18.1 → 0.19.0

package/SKILL.md

@@ -30,6 +30,21 @@ Semuanya kata lazim dalam bahan Pendidikan Islam. Setiap satu ada jawapan tegas
 
 Alat untuk menangkap kesemuanya ada di tangan agen itu sepanjang masa. Ia tidak pernah dijalankan ke atas teks Rumi keluarannya sendiri. Kedua-dua pusingan ditemui kerana **pengguna bertanya**, bukan kerana proses menangkapnya.
 
+`gate` menyemak **kedua-dua tulisan dalam panggilan yang sama**. Versi terdahulu menyemak Rumi sahaja, jadi dokumen Jawi penuh melepasinya tanpa satu aduan pun — tepat jenis dokumen yang alat ini paling diperlukan.
+
+Empat perkara yang ditangkap dalam teks Jawi:
+
+| Keadaan | Contoh | Keputusan |
+|---|---|---|
+| ruang tersasar di dalam perkataan | `ݢول وڠن` | **ralat**, cadang `ݢولوڠن` |
+| ejaan tiada dalam DBP | `منجاوهكن` | **ralat**, cadang `منجاءوهکن` |
+| homograf tulen | `سنة` | tidak dapat disahkan, dua bacaan |
+| petikan Arab | `الشِّمال` | tidak dapat disahkan, §11.1 |
+
+Ruang tersasar itu kes paling berbahaya. Separuh perkataan boleh **berjaya secara palsu**: `ݢول` benar-benar memetakan kepada dua perkataan DBP tulen, `gol` dan `gul`. Penukar yang memilih calon paling kerap akan mengeluarkan "gol" dengan yakin, dan separuh perkataan hilang tanpa sesiapa perasan. Sebab itu percantuman dicuba apabila **salah satu** jiran belum selesai, bukan kedua-duanya.
+
+Nama khas Arab tanpa kata sandang `ال` (`أصحاب`, nama tokoh, nama tempat) tidak dapat disahkan kamus Melayu. Isytiharkannya melalui `npx prpm-dbp nama <rumi> <jawi> --jenis arab`; selepas itu ia berhenti menjadi ralat, tetapi tetap **bukan** lulus DBP.
+
 `gate` keluar dengan kod 1 apabila ada ralat, jadi ia boleh dipasang sebagai hook atau langkah CI. Peraturan yang bergantung pada agen ingat sendiri akan gagal, dan gagal secara senyap.
 
 ## Kuatkuasa automatik
@@ -237,83 +252,6 @@ Ejaan yang disimpan begini ditandakan datang daripada pengguna, bukan daripada D
 
 Bagi nama berasal Arab, ejaan Jawinya memang ejaan Arab asal, jadi ia nampak seperti dikekalkan. Bagi nama bukan Arab ia ditransliterasi penuh: `Kuala Lumpur` menjadi `کوالا لومڤور`.
 
-## Sebelum menghantar apa-apa
-
-Jalankan `npx prpm-dbp gate <fail> --luar-talian` ke atas **keseluruhan teks**. Bukan sebahagian. Bukan perkataan yang anda rasa berisiko.
-
-Ejaan yang salah ialah tepat ejaan yang anda **tidak** syak. Kalau anda syak, anda sudah menyemaknya.
-
-Ini termasuk ejaan yang anda tulis dalam **kod, ujian dan dokumentasi**, bukan hanya dalam teks untuk pengguna. Semasa membina pakej ini sendiri, satu nilai Jawi ditulis ke dalam ujian daripada ingatan tanpa disemak. Nilainya kebetulan betul. Kebetulan bukan proses.
-
-**Apa yang berlaku apabila langkah ini dilangkau:**
-
-Satu agen menggunakan skill ini sepanjang sesi penuh untuk menukar Jawi ke Rumi, kemudian menghantar 549 kad RPH Pendidikan Islam ke pangkalan data produksi dengan **273 ejaan yang salah**.
-
-```
-pusingan 1   sunnah x206, hadith x16, fardhu x2        -> masuk produksi
-pusingan 2   tayammum, dhuha, qadha, redha, iddah x90  -> masuk produksi
-```
-
-Semuanya kata lazim dalam bahan Pendidikan Islam. Setiap satu ada jawapan tegas dalam PRPM: `sunnah` ialah rujukan silang ke `sunah`, `hadith` sepatutnya `hadis`, `fardhu` sepatutnya `fardu`, `tayammum` sepatutnya `tayamum`, `dhuha` sepatutnya `duha`, `qadha` sepatutnya `qada`.
-
-Alat untuk menangkap kesemuanya ada di tangan agen itu sepanjang masa. Ia tidak pernah dijalankan ke atas teks Rumi keluarannya sendiri. Kedua-dua pusingan ditemui kerana **pengguna bertanya**, bukan kerana proses menangkapnya.
-
-`gate` keluar dengan kod 1 apabila ada ralat, jadi ia boleh dipasang sebagai hook atau langkah CI. Peraturan yang bergantung pada agen ingat sendiri akan gagal, dan gagal secara senyap.
-
-## Kuatkuasa automatik
-
-```bash
-npx prpm-dbp install --hook
-```
-
-Memasang hook PostToolUse yang menjalankan `gate --luar-talian` ke atas setiap fail `.md`, `.txt` atau `.json` yang ditulis atau disunting. Ia **melaporkan** ralat kepada agen tanpa menyekat tulisan: menyekat atas kamus yang tidak lengkap akan menghalang kerja yang sah, manakala melaporkan sudah memadai kerana agen membaca output hook.
-
-Untuk menampal sendiri: `npx prpm-dbp hook-json`.
-
-Panaskan cache **sekali** semasa pemasangan, bukan semasa gate berjalan:
-
-```bash
-npx prpm-dbp warm kosa-kata-projek.txt
-```
-
-Gate atas cache panas mengambil 0.19 saat bagi 406 perkataan. Itu cukup pantas untuk setiap penyuntingan. Gate yang perlahan akan dimatikan orang.
-
-## Tiga keadaan gate, bukan dua
-
-| Medan | Maksud | Kesan |
-|---|---|---|
-| `lulusDbp` | ada dalam PRPM, ejaan padan | — |
-| `ralat` | ada dalam PRPM dengan ejaan lain, entri rujukan silang `®`, atau tiada dalam PRPM mahupun dataset | **exit 1** |
-| `tidakDapatDisahkan` | tiada dalam cache, nama khas, akronim, atau tiada entri PRPM tetapi wujud dalam dataset | dilapor; exit 1 jika melebihi `--ambang` |
-
-`tidakDapatDisahkan` **tidak pernah lulus senyap**. Gate yang lulus atas cache sejuk memberi jaminan palsu, dan itu lebih bahaya daripada tiada gate. Gunakan `--ambang 10` supaya cache sejuk menggagalkan gate.
-
-PRPM tiada entri untuk kata tugas paling asas: `dan`, `di`, `ke`, `yang`, `atau`. Menandakannya sebagai ralat menjadikan gate mustahil dipakai. Pembezanya bersumber, bukan senarai putih: kata tugas itu **semua** wujud dalam dataset, manakala `hadith`, `fardhu`, `tayammum`, `dhuha`, `qadha`, `redha` dan `iddah` **tiada satu pun**.
-
-## Prosedur wajib
-
-Ikut ini setiap kali, jangan langkau langkah.
-
-**Menulis Jawi daripada Rumi:**
-
-1. `npx prpm-dbp jawi <fail> --luar-talian --homograf --json`
-2. Baca `belumDisahkan` dan `namaKhas`. Jangan reka ejaan untuknya. Sahkan dengan `lookup`, atau tanya pengguna, atau tandakan dalam hasil akhir.
-3. Baca `mencurigakan`. Setiap satu bermakna PRPM sendiri mungkin tersilap. Semak di pautan yang diberi sebelum menggunakannya.
-4. Baca `homograf`. Beritahu pengguna perkataan mana yang akan taksa apabila dibaca.
-5. Laporkan `semuanyaDbp`. Jika `false`, nyatakan bahagian mana bukan daripada sumber rasmi.
-
-**Merumikan daripada Jawi:**
-
-1. `npx prpm-dbp rumi <fail> --pilih --konteks --json`
-2. Untuk **setiap** item dalam `kabur`: baca ayat yang mengandunginya, baca makna setiap calon, tentukan yang mana sesuai.
-3. Jika `dipilih` salah bagi ayat itu, **gantikan** dalam hasil akhir. Kekerapan kalah kepada konteks.
-4. Nyatakan kepada pengguna berapa banyak kekaburan wujud dan mana yang anda ubah.
-5. `tidakDikenali` bermakna perkataan itu tiada dalam cache. Jalankan `warm` di luar talian, bukan tinggalkan bertanda.
-
-**Berhenti dan tanya pengguna apabila:** ejaan `mencurigakan` mengubah makna, nama khas tiada rujukan bertulis, atau dua calon sama-sama munasabah dalam ayat itu.
-
-Semua perintah menyokong `--json`, jadi langkah di atas boleh dibuat secara berulang tanpa menghurai teks.
-
 ## Peraturan Pedoman DBP
 
 Satu fail sahaja dalam pakej ini **menjana** ejaan dan bukan mencarinya: `src/pedoman.js`. Ia dibenarkan kerana setiap peraturan di dalamnya datang daripada *Pedoman Umum Ejaan Jawi Bahasa Melayu* terbitan DBP, dan dirujuk pada seksyennya.
@@ -425,83 +363,6 @@ Dua puluh dua kes kabur yang tinggal itu sah: `قلقله` boleh dibaca `qalqala
 
 **Sifar perkataan hilang atau rosak.**
 
-## Sebelum menghantar apa-apa
-
-Jalankan `npx prpm-dbp gate <fail> --luar-talian` ke atas **keseluruhan teks**. Bukan sebahagian. Bukan perkataan yang anda rasa berisiko.
-
-Ejaan yang salah ialah tepat ejaan yang anda **tidak** syak. Kalau anda syak, anda sudah menyemaknya.
-
-Ini termasuk ejaan yang anda tulis dalam **kod, ujian dan dokumentasi**, bukan hanya dalam teks untuk pengguna. Semasa membina pakej ini sendiri, satu nilai Jawi ditulis ke dalam ujian daripada ingatan tanpa disemak. Nilainya kebetulan betul. Kebetulan bukan proses.
-
-**Apa yang berlaku apabila langkah ini dilangkau:**
-
-Satu agen menggunakan skill ini sepanjang sesi penuh untuk menukar Jawi ke Rumi, kemudian menghantar 549 kad RPH Pendidikan Islam ke pangkalan data produksi dengan **273 ejaan yang salah**.
-
-```
-pusingan 1   sunnah x206, hadith x16, fardhu x2        -> masuk produksi
-pusingan 2   tayammum, dhuha, qadha, redha, iddah x90  -> masuk produksi
-```
-
-Semuanya kata lazim dalam bahan Pendidikan Islam. Setiap satu ada jawapan tegas dalam PRPM: `sunnah` ialah rujukan silang ke `sunah`, `hadith` sepatutnya `hadis`, `fardhu` sepatutnya `fardu`, `tayammum` sepatutnya `tayamum`, `dhuha` sepatutnya `duha`, `qadha` sepatutnya `qada`.
-
-Alat untuk menangkap kesemuanya ada di tangan agen itu sepanjang masa. Ia tidak pernah dijalankan ke atas teks Rumi keluarannya sendiri. Kedua-dua pusingan ditemui kerana **pengguna bertanya**, bukan kerana proses menangkapnya.
-
-`gate` keluar dengan kod 1 apabila ada ralat, jadi ia boleh dipasang sebagai hook atau langkah CI. Peraturan yang bergantung pada agen ingat sendiri akan gagal, dan gagal secara senyap.
-
-## Kuatkuasa automatik
-
-```bash
-npx prpm-dbp install --hook
-```
-
-Memasang hook PostToolUse yang menjalankan `gate --luar-talian` ke atas setiap fail `.md`, `.txt` atau `.json` yang ditulis atau disunting. Ia **melaporkan** ralat kepada agen tanpa menyekat tulisan: menyekat atas kamus yang tidak lengkap akan menghalang kerja yang sah, manakala melaporkan sudah memadai kerana agen membaca output hook.
-
-Untuk menampal sendiri: `npx prpm-dbp hook-json`.
-
-Panaskan cache **sekali** semasa pemasangan, bukan semasa gate berjalan:
-
-```bash
-npx prpm-dbp warm kosa-kata-projek.txt
-```
-
-Gate atas cache panas mengambil 0.19 saat bagi 406 perkataan. Itu cukup pantas untuk setiap penyuntingan. Gate yang perlahan akan dimatikan orang.
-
-## Tiga keadaan gate, bukan dua
-
-| Medan | Maksud | Kesan |
-|---|---|---|
-| `lulusDbp` | ada dalam PRPM, ejaan padan | — |
-| `ralat` | ada dalam PRPM dengan ejaan lain, entri rujukan silang `®`, atau tiada dalam PRPM mahupun dataset | **exit 1** |
-| `tidakDapatDisahkan` | tiada dalam cache, nama khas, akronim, atau tiada entri PRPM tetapi wujud dalam dataset | dilapor; exit 1 jika melebihi `--ambang` |
-
-`tidakDapatDisahkan` **tidak pernah lulus senyap**. Gate yang lulus atas cache sejuk memberi jaminan palsu, dan itu lebih bahaya daripada tiada gate. Gunakan `--ambang 10` supaya cache sejuk menggagalkan gate.
-
-PRPM tiada entri untuk kata tugas paling asas: `dan`, `di`, `ke`, `yang`, `atau`. Menandakannya sebagai ralat menjadikan gate mustahil dipakai. Pembezanya bersumber, bukan senarai putih: kata tugas itu **semua** wujud dalam dataset, manakala `hadith`, `fardhu`, `tayammum`, `dhuha`, `qadha`, `redha` dan `iddah` **tiada satu pun**.
-
-## Prosedur wajib
-
-Ikut ini setiap kali, jangan langkau langkah.
-
-**Menulis Jawi daripada Rumi:**
-
-1. `npx prpm-dbp jawi <fail> --luar-talian --homograf --json`
-2. Baca `belumDisahkan` dan `namaKhas`. Jangan reka ejaan untuknya. Sahkan dengan `lookup`, atau tanya pengguna, atau tandakan dalam hasil akhir.
-3. Baca `mencurigakan`. Setiap satu bermakna PRPM sendiri mungkin tersilap. Semak di pautan yang diberi sebelum menggunakannya.
-4. Baca `homograf`. Beritahu pengguna perkataan mana yang akan taksa apabila dibaca.
-5. Laporkan `semuanyaDbp`. Jika `false`, nyatakan bahagian mana bukan daripada sumber rasmi.
-
-**Merumikan daripada Jawi:**
-
-1. `npx prpm-dbp rumi <fail> --pilih --konteks --json`
-2. Untuk **setiap** item dalam `kabur`: baca ayat yang mengandunginya, baca makna setiap calon, tentukan yang mana sesuai.
-3. Jika `dipilih` salah bagi ayat itu, **gantikan** dalam hasil akhir. Kekerapan kalah kepada konteks.
-4. Nyatakan kepada pengguna berapa banyak kekaburan wujud dan mana yang anda ubah.
-5. `tidakDikenali` bermakna perkataan itu tiada dalam cache. Jalankan `warm` di luar talian, bukan tinggalkan bertanda.
-
-**Berhenti dan tanya pengguna apabila:** ejaan `mencurigakan` mengubah makna, nama khas tiada rujukan bertulis, atau dua calon sama-sama munasabah dalam ayat itu.
-
-Semua perintah menyokong `--json`, jadi langkah di atas boleh dibuat secara berulang tanpa menghurai teks.
-
 ## Peraturan yang sengaja TIDAK dilaksanakan
 
 | Seksyen | Sebab |

package/bin/cli.js

@@ -318,6 +318,18 @@ async function main() {
       for (const fail of baki) {
         const laporan = await gate(await readFile(fail, 'utf8'), cache, {
           ...opts,
+          // Dataset MESTI dimuatkan. Tanpanya peta songsang menyusut daripada
+          // 64k ejaan kepada saiz cache sahaja, dan kata tugas paling asas
+          // seperti دان dilaporkan sebagai ejaan Jawi yang salah.
+          dataset: await muatDataset(),
+          // Nama khas Arab (nama surah, tokoh, tempat) tidak boleh disahkan
+          // kamus Melayu. Yang sudah diisytihar melalui `nama` diambil kira
+          // supaya pengisytiharan itu benar-benar bermakna.
+          namaJawi: new Set(
+            Object.values(await muatNama())
+              .map((n) => n?.jawi)
+              .filter(Boolean),
+          ),
           luarTalian: pilihan.luarTalian !== false,
           abai,
         })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm-dbp",
-  "version": "0.18.1",
+  "version": "0.19.0",
   "description": "Semak ejaan Bahasa Melayu dan Jawi terhadap PRPM Dewan Bahasa dan Pustaka. CLI dan skill untuk AI agent.",
   "keywords": [
     "bahasa-melayu",

package/src/gate.js

@@ -14,13 +14,189 @@
  * TIGA keadaan, bukan dua. `tidakDapatDisahkan` TIDAK PERNAH lulus senyap:
  * gate yang lulus atas cache sejuk memberi jaminan palsu, dan itu lebih
  * bahaya daripada tiada gate.
+ *
+ * Versi pertama menyemak Rumi SAHAJA. Regexnya `[A-Za-zÀ-ÿ]` bermakna
+ * dokumen Jawi penuh melepasi hook tanpa satu aduan pun — tepat jenis
+ * dokumen yang skill ini paling diperlukan. Sebaris teks pelajaran dengan
+ * `ݢول وڠن` (golongan dengan ruang tersasar di tengahnya) dan `منجاوهكن`
+ * (menjauhkan tanpa hamzah) lulus sepenuhnya. Gate kini menyemak
+ * kedua-dua tulisan.
  */
 
 import { lookup } from './prpm.js'
 import { mungkinAkronim, mungkinNamaKhas } from './nama.js'
 import { cariDataset } from './dataset.js'
+import { normalisasiJawi } from './kamus.js'
+import { jarakHuruf, petaSongsang } from './tukar.js'
+import { pisahUlangJawi } from './pedoman.js'
+import { rangkaKonsonan } from './semak.js'
 
 const TOKEN_RUMI = /([A-Za-zÀ-ÿ][A-Za-zÀ-ÿ'-]*)/g
+const TOKEN_JAWI = /([؀-ۿݐ-ݿﭐ-﷿ﹰ-]+)/g
+
+// Baris tanda vokal Arab. Jawi Melayu tidak menggunakannya; petikan al-Quran
+// dan hadis dalam dokumen Melayu menggunakannya. Kehadirannya bermakna
+// potongan itu bahasa Arab, yang Pedoman §11.1 kata kekalkan seadanya.
+const HARAKAT = /[ً-ْٰٓ-ٕ]/
+
+/**
+ * Semak token Jawi terhadap peta songsang DBP.
+ *
+ * Yang paling penting di sini ialah pengesanan RUANG TERSASAR. Sebuah
+ * perkataan yang terbelah dua boleh gagal dengan LANTANG pada satu separuh
+ * dan BERJAYA SECARA PALSU pada separuh yang lain: `ݢولوڠن` (golongan)
+ * yang terbelah menjadi `ݢول` + `وڠن` meninggalkan `ݢول`, yang benar-benar
+ * memetakan kepada dua perkataan DBP tulen, gol dan gul. Penukar yang
+ * memilih calon paling kerap akan mengeluarkan "gol" dengan penuh yakin,
+ * dan separuh perkataan hilang tanpa sesiapa perasan.
+ *
+ * Sebab itu percantuman dicuba apabila SALAH SATU jiran tidak dapat
+ * diselesaikan. Menuntut kedua-duanya gagal akan terlepas kes ini justeru
+ * kerana separuh pertama "berjaya".
+ */
+export function gateJawi(teks, cache, opts = {}) {
+  const { dataset = null, abai = new Set(), namaJawi = new Set() } = opts
+  const peta = petaSongsang(cache, dataset)
+
+  // Indeks rangka konsonan, dibina sekali. Ejaan yang tersalah biasanya
+  // berbeza hanya pada vokal atau hamzah — منجاوهكن lawan منجاءوهکن — jadi
+  // rangkanya kekal sama dan ejaan DBP yang betul boleh dinamakan terus.
+  // Melaporkan "tiada dalam DBP" sahaja menyerahkan kerja mencari kepada
+  // pembaca; melaporkan ejaan sebenar menutup jurang itu.
+  const rangka = new Map()
+  for (const [kunci, slot] of peta) {
+    if (!slot.layak.length) continue
+    const r = rangkaKonsonan(kunci)
+    if (!r) continue
+    if (!rangka.has(r)) rangka.set(r, [])
+    rangka.get(r).push({ jawi: kunci, rumi: slot.layak[0] })
+  }
+  const cadang = (t) => {
+    const senarai = rangka.get(rangkaKonsonan(t)) ?? []
+    if (!senarai.length) return null
+    const terbaik = senarai
+      .map((c) => ({ ...c, jarak: jarakHuruf(normalisasiJawi(t), c.jawi) }))
+      .sort((a, b) => a.jarak - b.jarak)[0]
+    // Jarak besar bermakna ia perkataan lain sepenuhnya yang kebetulan
+    // berkongsi rangka, bukan salah eja. Cadangan begitu mengelirukan.
+    return terbaik.jarak <= 3 ? terbaik : null
+  }
+
+  const lulusDbp = []
+  const ralat = []
+  const tidakDapatDisahkan = []
+  const dilihat = new Set()
+
+  const bahagian = teks.split(TOKEN_JAWI)
+  const token = []
+  for (const [i, cebis] of bahagian.entries()) {
+    if (i % 2 === 1) token.push({ teks: cebis, i })
+  }
+
+  // Pemisah antara dua token mesti ruang tulen sebelum percantuman dicuba.
+  // Tanda baca, petikan atau baris baru antara mereka bermakna ia memang
+  // dua perkataan berasingan, bukan satu yang terbelah.
+  const ruangSahaja = (a, b) => /^[ \t ‌​]*$/.test(bahagian.slice(a + 1, b).join(''))
+
+  // §17.1: kata ulang penuh ialah kata dasar + angka dua Arab. `اوسها٢`
+  // ialah usaha-usaha, dan kata dasarnya yang ada dalam kamus, bukan bentuk
+  // berangka itu. Tanpa langkah ini setiap kata ulang dalam dokumen jadi
+  // ralat palsu.
+  const cari = (t) => {
+    const langsung = peta.get(normalisasiJawi(t))
+    if (langsung) return langsung
+    const dasar = pisahUlangJawi(t)
+    return dasar ? (peta.get(normalisasiJawi(dasar)) ?? null) : null
+  }
+  const selesai = (t) => {
+    const m = cari(t)
+    return m ? m.layak.length === 1 : false
+  }
+
+  for (const [n, tok] of token.entries()) {
+    const t = tok.teks
+    if (abai.has(t) || abai.has(normalisasiJawi(t))) continue
+
+    // Petikan Arab tidak selalu bertanda baris. Kata sandang `ال` ialah
+    // penanda paling boleh dipercayai yang tinggal: ia membuka hampir setiap
+    // frasa Arab yang dipetik (اليمين, المقربون, الشمال) dan pada dasarnya
+    // tidak pernah membuka kata Melayu Jawi. Nama khas Arab tanpa kata
+    // sandang (أصحاب) tetap perlu diisytihar melalui simpanan `nama`;
+    // kamus Melayu memang tidak boleh mengesahkannya, dan berpura-pura
+    // boleh adalah jaminan palsu.
+    if (HARAKAT.test(t) || (/^ال/.test(t) && !cari(t))) {
+      // Pedoman §11.1: petikan Arab kekalkan ejaan asal. Ia bukan lulus DBP
+      // kerana kamus Melayu tidak boleh mengesahkannya; ia keadaan ketiga.
+      if (!dilihat.has(t)) { dilihat.add(t); tidakDapatDisahkan.push({ kata: t, sebab: 'teks Arab, dikekalkan (Pedoman §11.1)' }) }
+      continue
+    }
+
+    const m = cari(t)
+
+    // Cuba cantum dengan jiran SEBELUM melaporkan apa-apa, kerana ruang
+    // tersasar mencemarkan kedua-dua separuh sekali gus.
+    const seterusnya = token[n + 1]
+    if (seterusnya && ruangSahaja(tok.i, seterusnya.i)) {
+      const belumSelesai = !selesai(t) || !selesai(seterusnya.teks)
+      if (belumSelesai) {
+        const gabung = cari(t + seterusnya.teks)
+        if (gabung?.layak.length) {
+          const kunci = t + ' ' + seterusnya.teks
+          if (!dilihat.has(kunci)) {
+            dilihat.add(kunci)
+            ralat.push({
+              kata: kunci,
+              sebab: 'ruang tersasar di dalam perkataan',
+              sepatutnya: t + seterusnya.teks,
+              bacaan: gabung.layak[0],
+            })
+          }
+          dilihat.add(t)
+          dilihat.add(seterusnya.teks)
+          continue
+        }
+      }
+    }
+
+    if (dilihat.has(t)) continue
+    dilihat.add(t)
+
+    if (!m) {
+      // Nama khas yang SUDAH diisytihar pengguna bukan ralat. Ia tetap bukan
+      // lulus DBP — kamus Melayu tidak mengesahkannya — jadi ia keadaan
+      // ketiga, dan pembaca nampak apa yang tidak disemak.
+      if (namaJawi.has(t) || namaJawi.has(normalisasiJawi(t))) {
+        tidakDapatDisahkan.push({ kata: t, sebab: 'nama khas diisytihar pengguna' })
+        continue
+      }
+      const c = cadang(t)
+      ralat.push({
+        kata: t,
+        sebab: 'ejaan Jawi tiada dalam DBP mahupun dataset',
+        ...(c ? { sepatutnya: c.jawi, bacaan: c.rumi } : {}),
+      })
+      continue
+    }
+    if (m.layak.length === 1) {
+      lulusDbp.push(t)
+      continue
+    }
+    if (m.layak.length > 1) {
+      // Homograf tulen. Ejaannya SAH; hanya bacaannya perlu konteks. Ini
+      // bukan ralat, dan menandakannya begitu akan menggagalkan setiap
+      // dokumen yang mengandungi سنة.
+      tidakDapatDisahkan.push({ kata: t, sebab: `homograf, ${m.layak.length} bacaan DBP`, calon: m.layak })
+      continue
+    }
+    if (m.entah.length) {
+      tidakDapatDisahkan.push({ kata: t, sebab: 'hanya dalam dataset, bukan DBP', calon: m.entah })
+      continue
+    }
+    ralat.push({ kata: t, sebab: 'hanya padan bentuk rujukan silang DBP', calon: m.tolak })
+  }
+
+  return { lulusDbp, ralat, tidakDapatDisahkan }
+}
 
 /**
  * Semak teks Rumi. Setiap perkataan jatuh ke dalam SATU daripada tiga baldi.
@@ -114,6 +290,13 @@ export async function gate(teks, cache, opts = {}) {
     lulusDbp.push(kata)
   }
 
+  // Jawi disemak dalam panggilan yang SAMA. Kalau ia perintah berasingan,
+  // ia jadi langkah yang boleh dilupakan, dan itu punca kegagalan asal.
+  const j = gateJawi(teks, cache, opts)
+  lulusDbp.push(...j.lulusDbp)
+  ralat.push(...j.ralat.map((r) => ({ ...r, tulisan: 'jawi' })))
+  tidakDapatDisahkan.push(...j.tidakDapatDisahkan.map((r) => ({ ...r, tulisan: 'jawi' })))
+
   const jumlah = lulusDbp.length + ralat.length + tidakDapatDisahkan.length
   const peratusTidakSah = jumlah ? Math.round((tidakDapatDisahkan.length / jumlah) * 100) : 0
 

package/src/tukar.js

@@ -170,7 +170,7 @@ export async function cariDasar(kata, cache, opts = {}) {
  * dan ia mengalahkan سورة (surah) yang sebenarnya betul. Susunan huruf itulah
  * maklumat yang membezakannya.
  */
-function jarakHuruf(a, b) {
+export function jarakHuruf(a, b) {
   const m = a.length
   const n = b.length
   if (!m) return n