prpm-dbp 0.11.0 → 0.12.0

package/SKILL.md

@@ -176,6 +176,7 @@ Ia mati secara lalai kerana ketepatannya diukur, bukan diandaikan. Diuji terhada
 | `di-` | 2,435 | 92% |
 | `se-` | 1,605 | 90% |
 | `ke-` | 976 | 88% |
+| `-kan` | 3,046 | 92% |
 
 Sebahagian kegagalan itu artifak ukuran (`tamu` bukan `ta`+`mu`), jadi ketepatan sebenar lebih tinggi. Walaupun begitu, 98% tidak cukup untuk menjana ejaan secara senyap dalam alat yang seluruh tujuannya menghalang Jawi yang nampak betul tetapi salah.
 
@@ -187,7 +188,9 @@ $ npx prpm-dbp jawi nota.txt --pedoman
 dijana ikut Pedoman, BELUM disahkan DBP (1): Abadinya=اباديڽ [Pedoman DBP §15.1]
 ```
 
-Peraturan yang dilaksanakan: §13.5-13.7 (awalan `di-`, `se-`, `ke-`), §13.10 (tiga cara akhiran `-an`), §13.11 (tiga cara akhiran `-i`), §15.1 (kata ganti singkat `ku`, `mu`, `nya`).
+Peraturan yang dilaksanakan: §13.5-13.7 (awalan `di-`, `se-`, `ke-`), §13.9 (akhiran `-kan`), §13.10 (tiga cara akhiran `-an`), §13.11 (tiga cara akhiran `-i`), §15.1 (kata ganti singkat `ku`, `mu`, `nya`).
+
+**Awas terhadap nota panduan tidak rasmi.** Nota sekolah sering menyatakan "huruf alif ditambah semula apabila menerima imbuhan" sebagai peraturan menyeluruh. Diuji terhadap data sebenar, itu tidak benar: `suka` سوک menjadi `sukakan` سوککن dan `lukanya` لوکڽ, kedua-duanya tanpa alif. Penambahan alif berlaku bagi `-an` dan `-i` sahaja, menurut Catatan §13.10(ii) dan §13.11(i).
 
 **Kodpoint setiap imbuhan disahkan empirik daripada dataset, bukan dibaca daripada peraturan.** Hamzah dalam akhiran ialah `ء` U+0621 berdiri sendiri, manakala dalam awalan ia `أ` U+0623 di atas alif. Peraturan bertulis tidak membezakan dua itu.
 
@@ -257,6 +260,21 @@ Urutan yang disyorkan:
 
 Dengan cara ini pengguna tidak pernah menunggu PRPM, dan PRPM tidak pernah menerima trafik daripada aplikasi anda.
 
+## Pengesahan bebas kodpoint
+
+Keputusan lipatan kodpoint disahkan terhadap sumber kedua yang bebas: *Kaedah Pembelajaran Jawi: Peringkat Asas* (Haji Azman bin Haji Ahmad, Perpustakaan Negara Malaysia, 2015), Siri Ke-2 "Huruf Gubalan Melayu".
+
+| Huruf | Kodpoint | Keputusan pakej |
+|---|---|---|
+| `ڤ` p | U+06A4 | bukan `پ` U+067E |
+| `ڽ` ny | U+06BD | `پ` huruf berlainan, tidak pernah dilipat |
+| `ݢ` g | U+0762 | varian `ڬ` U+06AC dilipat |
+| `ک` kaf Jawi | U+06A9 | `ك` Arab U+0643 dilipat |
+
+Siri yang sama membezakan kaf Arab daripada kaf Jawi secara eksplisit, iaitu perbezaan yang menyebabkan PRPM dan KamusDBP kelihatan bercanggah.
+
+Buku itu berhak cipta terpelihara (PNM). Ia dirujuk di sini sebagai pengesahan, bukan disalin.
+
 ## Rantai kepercayaan
 
 Setiap ejaan Jawi yang dikeluarkan membawa asal-usulnya. Jangan runtuhkan lapisan ini.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prpm-dbp",
-  "version": "0.11.0",
+  "version": "0.12.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/kamus.js

@@ -184,6 +184,13 @@ export async function cariKamus(kata, { timeout = 25000 } = {}) {
  * Lipatan ini sengaja konservatif. Ta marbutah (ة) tidak dilipat ke ha (ه)
  * kerana dalam sesetengah perkataan ia benar-benar membezakan makna.
  */
+// Disahkan secara bebas terhadap "Kaedah Pembelajaran Jawi: Peringkat Asas"
+// (Haji Azman bin Haji Ahmad, Perpustakaan Negara Malaysia, 2015), Siri Ke-2
+// "Huruf Gubalan Melayu", yang menyenaraikan enam huruf ciptaan Melayu:
+//   چ U+0686 c   ڠ U+06A0 ng   ڤ U+06A4 p
+//   ݢ U+0762 g   ۏ U+06CF v    ڽ U+06BD ny
+// Siri yang sama membezakan kaf Arab ك daripada kaf Jawi ک secara eksplisit.
+// Kesemuanya sepadan dengan keputusan lipatan di bawah.
 const LIPATAN = new Map([
   ['ك', 'ک'], // ك Arabic Kaf   -> ک Keheh
   ['ڪ', 'ک'], // ڪ Swash Kaf    -> ک Keheh

package/src/pedoman.js

@@ -185,6 +185,21 @@ export function imbuhAkhiranI(jawiDasar, rumiDasar) {
   return { jawi: jawiDasar + YA, rujukan: 'Pedoman DBP §13.11(iii)' }
 }
 
+/**
+ * §13.9 — Akhiran -kan ditulis kaf-nun, dilekatkan terus tanpa perubahan
+ * pada kata dasar.
+ *
+ * Nota panduan sekolah sering menyatakan "huruf alif ditambah semula apabila
+ * menerima imbuhan". Itu terlalu menyeluruh: diuji terhadap data sebenar,
+ * suka سوک menjadi sukakan سوککن dan lukanya لوکڽ, tanpa alif. Penambahan
+ * alif berlaku bagi -an dan -i sahaja, menurut Catatan §13.10(ii) dan
+ * §13.11(i).
+ */
+export function imbuhAkhiranKan(jawiDasar) {
+  if (!jawiDasar) return null
+  return { jawi: jawiDasar + 'کن', rujukan: 'Pedoman DBP §13.9' }
+}
+
 /**
  * §15.1 — Kata ganti singkat ditulis serangkai dengan kata di depannya.
  *   ku  -> kaf-wau      mu -> mim-wau      nya -> nya

package/src/tukar.js

@@ -14,6 +14,7 @@ import { cariDataset, muatDataset } from './dataset.js'
 import { cariNama, mungkinAkronim, mungkinNamaKhas } from './nama.js'
 import {
   imbuhAkhiranAn,
+  imbuhAkhiranKan,
   imbuhAkhiranI,
   imbuhAwalan,
   imbuhGanti,
@@ -113,6 +114,11 @@ async function janaIkutPedoman(kata, cache, opts, gunaDataset) {
     if (hasil) return hasil
   }
 
+  if (kata.endsWith('kan') && kata.length > 5) {
+    const hasil = imbuhAkhiranKan(await ejaan(kata.slice(0, -3)))
+    if (hasil) return hasil
+  }
+
   if (kata.endsWith('an') && kata.length > 4) {
     const dasar = kata.slice(0, -2)
     const hasil = imbuhAkhiranAn(await ejaan(dasar), dasar)