prpm-dbp 0.8.0 → 0.9.0

package/SKILL.md

@@ -28,7 +28,7 @@ npx prpm-dbp lookup murid sekolah
 # semak setiap perkataan Rumi dalam fail wujud dalam PRPM
 npx prpm-dbp audit nota.txt
 
-# semak ejaan Jawi lawan teks Rumi sejajar (token ke-N lawan token ke-N)
+# semak ejaan Jawi lawan teks Rumi sejajar
 npx prpm-dbp audit-jawi rph-jawi.txt rph-rumi.txt
 
 # panaskan cache dari senarai perkataan, bayar sekali guna selamanya
@@ -205,6 +205,10 @@ nama khas      15   |  belum disahkan 10
 
 Inilah sebab transliterator pola suku kata (§7 hingga §9) **tidak dilaksanakan**. Ia tidak akan menyentuh satu pun perkataan di atas. Lebih buruk lagi, istilah tajwid itu kata serapan Arab, dan §11.1 menetapkan ejaan Jawinya ialah ejaan Arab asal — peraturan pola Melayu akan menghasilkan ejaan fonetik yang salah untuk setiap satu, iaitu tepat di tempat ia paling merosakkan.
 
+**`audit-jawi` menggunakan enjin penukaran yang sama dengan `jawi`.** Teks Rumi ditukar dahulu, kemudian dibandingkan. Ini penting kerana §14.1 dan §17.1 mengubah bilangan token: `Murid ke sekolah` ialah tiga perkataan Rumi tetapi dua perkataan Jawi. Perbandingan kedudukan yang naif akan melaporkan output alat ini sendiri sebagai salah.
+
+Dengan cara ini hanya ada **satu takrif "Jawi yang betul"** dalam pakej, bukan dua yang boleh menyimpang.
+
 ## Rantai kepercayaan
 
 Setiap ejaan Jawi yang dikeluarkan membawa asal-usulnya. Jangan runtuhkan lapisan ini.
@@ -244,7 +248,7 @@ Bila menulis teks BM atau Jawi yang akan dihantar kepada orang:
 |---|---|---|
 | `lulus` / `padan` | ada dalam PRPM, ejaan sepadan | tiada |
 | `belumDisahkan` | tiada entri dalam PRPM | semak ejaan, atau isytihar sebagai nama khas |
-| `salahEjaan` | Jawi ditulis tidak sama dengan PRPM | ganti dengan medan `sepatutnya` |
+| `salahEjaan` | Jawi ditulis tidak sama dengan hasil penukaran | ganti dengan medan `sepatutnya` |
 | `tiadaRujukan` | PRPM tiada ejaan Jawi untuk kata itu | kekalkan, tanda kepada pengguna |
 | `gagalSemak` | rangkaian gagal | cuba semula, jangan anggap salah |
 

package/bin/cli.js

@@ -4,7 +4,7 @@ import process from 'node:process'
 
 import { pasangSkill } from '../src/install.js'
 import { banding, cariKamus } from '../src/kamus.js'
-import { keJawi, keRumi } from '../src/tukar.js'
+import { keJawi, keRumi, semakJawi } from '../src/tukar.js'
 import { huraiTsv, muatDataset, simpanDataset } from '../src/dataset.js'
 import { NAMA_PATH, muatNama, tambahNama } from '../src/nama.js'
 import {
@@ -49,6 +49,7 @@ function huraiArgs(argv) {
     else if (a === '--link') pilihan.link = true
     else if (a === '--cepat') pilihan.cepat = true
     else if (a === '--pedoman') pilihan.pedoman = true
+    else if (a === '--jenis') pilihan.jenis = argv[++i]
     else if (a === '--had') pilihan.had = Number(argv[++i])
     else if (a === '--delay') pilihan.delay = Number(argv[++i])
     else if (a === '--buang') pilihan.buang = argv[++i]
@@ -102,11 +103,11 @@ async function main() {
     case 'audit-jawi': {
       const [failJawi, failRumi] = baki
       if (!failJawi || !failRumi) throw new Error('perlu dua fail: <jawi> <rumi>')
-      const laporan = await auditJawi(
+      const laporan = await semakJawi(
         await readFile(failJawi, 'utf8'),
         await readFile(failRumi, 'utf8'),
         cache,
-        opts,
+        { ...opts, cubaDasar: !pilihan.cepat, janaImbuhan: pilihan.pedoman },
       )
       await saveCache(cache)
       keluar(laporan)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm-dbp",
-  "version": "0.8.0",
+  "version": "0.9.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/tukar.js

@@ -407,3 +407,42 @@ export function keRumi(teksJawi, cache, { penanda = ['«', '»'], dataset = null
     lengkap: tidakDikenali.length === 0,
   }
 }
+
+/**
+ * Semak teks Jawi terhadap teks Rumi sejajar, menggunakan enjin penukaran
+ * yang SAMA dengan `keJawi`.
+ *
+ * Versi lama membandingkan token ke-N lawan token ke-N. Itu pecah sebaik
+ * sahaja Pedoman §14.1 (kata sendi bercantum) dan §17.1 (kata ulang) mula
+ * digunakan, kerana kedua-duanya mengubah bilangan token: `Murid ke sekolah`
+ * ialah tiga perkataan Rumi tetapi dua perkataan Jawi. Akibatnya alat ini
+ * melaporkan outputnya sendiri sebagai salah.
+ *
+ * Sekarang teks Rumi ditukar dahulu, kemudian dibandingkan token demi token
+ * terhadap hasil itu. Dengan cara ini hanya ada satu takrif "Jawi yang betul"
+ * dalam pakej.
+ */
+export async function semakJawi(jawiTeks, rumiTeks, cache, opts = {}) {
+  const jangkaan = await keJawi(rumiTeks, cache, opts)
+  const tokJangka = [...jangkaan.teks.matchAll(new RegExp(`[${JAWI_JULAT}\u0660-\u0669]+`, 'g'))].map((m) => m[0])
+  const tokAda = [...jawiTeks.matchAll(new RegExp(`[${JAWI_JULAT}\u0660-\u0669]+`, 'g'))].map((m) => m[0])
+
+  const salahEjaan = []
+  let padan = 0
+  for (const [i, jangka] of tokJangka.entries()) {
+    const ditulis = tokAda[i] ?? null
+    if (ditulis && normalisasiJawi(ditulis) === normalisasiJawi(jangka)) padan++
+    else salahEjaan.push({ kedudukan: i, ditulis, sepatutnya: jangka })
+  }
+
+  return {
+    tokenJawi: tokAda.length,
+    tokenDijangka: tokJangka.length,
+    kiraanTakSama: tokAda.length !== tokJangka.length,
+    padan,
+    salahEjaan,
+    belumDisahkan: jangkaan.belumDisahkan,
+    namaKhas: jangkaan.namaKhas,
+    akronim: jangkaan.akronim,
+  }
+}