marathi-transliterate 1.1.1 → 1.3.0

package/README.md

@@ -14,6 +14,8 @@ Most existing Sanskrit/IAST transliteration libraries convert `sakhar` to **स
 
 In everyday reality, people in Maharashtra type phonetically:
 - `sakhar` → **साखर**
+- `jaad` → **जाड**
+- `daba` → **डबा**
 - `kanda` → **कांदा**
 - `batata` → **बटाटा**
 - `mith` → **मीठ**
@@ -53,6 +55,9 @@ import { transliterate, transliterateWord } from 'marathi-transliterate';
 
 // Single word transliteration
 transliterateWord('sakhar');  // → 'साखर'
+transliterateWord('jaad');    // → 'जाड'
+transliterateWord('Daba');    // → 'डबा'
+transliterateWord('D');       // → 'ड' (vs 'd' → 'द')
 transliterateWord('kanda');   // → 'कांदा'
 transliterateWord('batata');  // → 'बटाटा'
 transliterateWord('namaskar'); // → 'नमस्कार'
@@ -146,6 +151,29 @@ Converts full text, sentences, or paragraphs into Marathi while preserving numbe
 ### `getSuggestions(word: string): string[]`
 Returns candidate phonetic variations for a given word.
 
+### `extendDictionary(customWords: Record<string, string>): void`
+Extends or overrides the global transliteration dictionary with your own custom vocabulary at runtime.
+
+```javascript
+import { extendDictionary, transliterateWord } from "marathi-transliterate";
+
+extendDictionary({
+  "sangamner": "संगमनेर",
+  "myitem": "माझामाल"
+});
+
+transliterateWord("sangamner"); // → "संगमनेर"
+```
+
+### `normalizeMarathi(text: string): string`
+Normalizes Marathi characters (interchangeable ळ/ल, श/ष, ि/ी, ु/ू, and anusvara) for tolerant comparisons and search filtering.
+
+```javascript
+import { normalizeMarathi } from "marathi-transliterate";
+
+normalizeMarathi("भुसाळ") === normalizeMarathi("भुसाल"); // → true
+```
+
 ### `attachDevanagari(element, options): Handler`
 Attaches keyboard listeners to an `<input>` or `<textarea>` element.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "marathi-transliterate",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "Zero-dependency, offline-first Marathi / Devanagari phonetic transliteration library. Converts English typing to Marathi (e.g. sakhar -> साखर) seamlessly in plain JS, Node.js, and frontend frameworks.",
   "type": "module",
   "main": "src/index.js",

package/src/dictionary.js

@@ -380,5 +380,384 @@ export const MARATHI_DICTIONARY = {
   'te': 'ते',
   'ha': 'हा',
   'hi': 'ही'
+,
+
+  // --- Extended Surnames, Names & Kirana Vocabulary ---
+  'badama': 'बदाम',
+  'pistachio': 'पिस्ता',
+  'raisins': 'मनुका',
+  'akrod': 'अक्रोड',
+  'dal': 'डाळ',
+  'daal': 'डाळ',
+  'bhel': 'भेळ',
+  'keli': 'केळी',
+  'kele': 'केळी',
+  'haladi': 'हळद',
+  'shevaya': 'शेवया',
+  'naral': 'नारळ',
+  'nariyal': 'नारळ',
+  'khul': 'खूळ',
+  'khula': 'खुळा',
+  'khuli': 'खुळी',
+  'goli': 'गोळी',
+  'golya': 'गोळ्या',
+  'dole': 'डोळे',
+  'dola': 'डोळा',
+  'khel': 'खेळ',
+  'vel': 'वेळ',
+  'chul': 'चूल',
+  'pola': 'पोळा',
+  'shengdana': 'शेंगदाणा',
+  'shengdaane': 'शेंगदाणे',
+  'dana': 'दाणा',
+  'peanut': 'शेंगदाणे',
+  'groundnut': 'शेंगदाणे',
+  'cumin': 'जिरे',
+  'chilli': 'मिरची',
+  'matar': 'मटार',
+  'khule': 'खुळे',
+  'khulee': 'खुळे',
+  'khulay': 'खुळे',
+  'mule': 'मुळे',
+  'muley': 'मुळे',
+  'moole': 'मुळे',
+  'kamble': 'कांबळे',
+  'kambale': 'कांबळे',
+  'kamle': 'कांबळे',
+  'dhole': 'ढोळे',
+  'dholay': 'ढोळे',
+  'gole': 'गोळे',
+  'golay': 'गोळे',
+  'shelke': 'शेळके',
+  'shelake': 'शेळके',
+  'walunj': 'वाळुंज',
+  'walunje': 'वाळुंजे',
+  'valunj': 'वाळुंज',
+  'valunje': 'वाळुंजे',
+  'ingale': 'इंगळे',
+  'ingle': 'इंगळे',
+  'ingole': 'इंगोले',
+  'salve': 'साळवे',
+  'saalve': 'साळवे',
+  'salunke': 'साळुंखे',
+  'jawale': 'जावळे',
+  'zavale': 'जावळे',
+  'bawale': 'बावळे',
+  'bavale': 'बावळे',
+  'phalke': 'फाळके',
+  'falke': 'फाळके',
+  'chalke': 'चाळके',
+  'pimple': 'पिंपळे',
+  'pimpal': 'पिंपळे',
+  'tambole': 'तांबोळे',
+  'mahale': 'महाळे',
+  'bhale': 'भाळे',
+  'bhalerao': 'भालेराव',
+  'borule': 'बोरुळे',
+  'gholap': 'घोळप',
+  'pol': 'पोळ',
+  'bal': 'बाळ',
+  'baal': 'बाळ',
+  'dalvi': 'दळवी',
+  'dalavi': 'दळवी',
+  'palve': 'पाळवे',
+  'palande': 'पाळंदे',
+  'zole': 'झोळे',
+  'jole': 'जोळे',
+  'wable': 'वाबळे',
+  'wabale': 'वाबळे',
+  'bhole': 'भोळे',
+  'ghule': 'घुळे',
+  'dhule': 'धुळे',
+  'khole': 'खोळे',
+  'thole': 'ठोळे',
+  'chitale': 'चितळे',
+  'chitapale': 'चितपळे',
+  'daphal': 'डफळ',
+  'raul': 'राऊळ',
+  'rawool': 'राऊळ',
+  'ravul': 'राऊळ',
+  'kolhe': 'कोल्हे',
+  'kolhewadi': 'कोल्हेवाडी',
+  'sawale': 'सावळे',
+  'kawale': 'कावळे',
+  'gavale': 'गवळे',
+  'gawale': 'गवळे',
+  'navale': 'नवळे',
+  'nawale': 'नवळे',
+  'dewale': 'देवळे',
+  'yewale': 'येवळे',
+  'yeole': 'येवले',
+  'dahale': 'डहाळे',
+  'bhabale': 'भाबळे',
+  'tapale': 'तापळे',
+  'kulat': 'कुळट',
+  'landge': 'लांडगे',
+  'kaale': 'काळे',
+  'maali': 'माळी',
+  'bhosle': 'भोसले',
+  'shirke': 'शिर्के',
+  'shewale': 'शेवाळे',
+  'shiwale': 'शिवाळे',
+  'bhilare': 'भिळारे',
+  'padwal': 'पडवळ',
+  'bhadwalkar': 'भाडवळकर',
+  'bendale': 'बेंदळे',
+  'ghodke': 'घोडके',
+  'khadke': 'खडके',
+  'phadke': 'फडके',
+  'kakade': 'काकडे',
+  'pawale': 'पावळे',
+  'sonawale': 'सोनावळे',
+  'sonawane': 'सोनवणे',
+  'borhade': 'बोऱ्हाडे',
+  'katore': 'कटोरे',
+  'shete': 'शेटे',
+  'bhusal': 'भुसाळ',
+  'bhusaal': 'भुसाळ',
+  'bhusale': 'भुसाळे',
+  'bhuswal': 'भुसावळ',
+  'bhusawal': 'भुसावळ',
+  'ghusal': 'घुसाळ',
+  'kusal': 'कुसळ',
+  'sable': 'साबळे',
+  'sabale': 'साबळे',
+  'taral': 'तराळ',
+  'taraal': 'ताराळ',
+  'pusal': 'पुसळ',
+  'chitole': 'चितोळे',
+  'shitole': 'शितोळे',
+  'bapule': 'बापुळे',
+  'kharpude': 'खरपुडे',
+  'wadkar': 'वाडकर',
+  'kote': 'कोते',
+  'balu': 'बाळू',
+  'baalu': 'बाळू',
+  'bala': 'बाळा',
+  'balasaheb': 'बाळासाहेब',
+  'balaji': 'बाळाजी',
+  'baliram': 'बळीराम',
+  'kalyani': 'कल्याणी',
+  'sheela': 'शीला',
+  'sheetal': 'शीतल',
+  'snehal': 'स्नेहल',
+  'pranjal': 'प्रांजल',
+  'atul': 'अतुल',
+  'komal': 'कोमल',
+  'mangal': 'मंगल',
+  'ujwala': 'उज्ज्वला',
+  'ujjwala': 'उज्ज्वला',
+  'payal': 'पायल',
+  'kajal': 'काजल',
+  'sejal': 'सेजल',
+  'nilesh': 'निलेश',
+  'shailesh': 'शैलेश',
+  'kamlesh': 'कमलेश',
+
+  // --- Grocery & Household with ड / ढ / ट / ठ / द / ध ---
+  "jaad": "जाड",
+  "jad": "जाड",
+  "jada": "जाडा",
+  "jaada": "जाडा",
+  "jadi": "जाडी",
+  "jaadi": "जाडी",
+  "barik": "बारीक",
+  "bareek": "बारीक",
+  "baareek": "बारीक",
+  "jadpoha": "जाड पोहे",
+  "jaadpoha": "जाड पोहे",
+  "jaadpohe": "जाड पोहे",
+  "jadrava": "जाड रवा",
+  "jaadrava": "जाड रवा",
+  "barikpoha": "बारीक पोहे",
+  "barikpohe": "बारीक पोहे",
+  "barikrava": "बारीक रवा",
+  "daba": "डबा",
+  "dabba": "डबा",
+  "dabi": "डबी",
+  "dabbi": "डबी",
+  "papad": "पापड",
+  "paapad": "पापड",
+  "kadak": "कडक",
+  "laddu": "लाडू",
+  "ladoo": "लाडू",
+  "laadu": "लाडू",
+  "peda": "पेढा",
+  "pedha": "पेढा",
+  "pendha": "पेंढा",
+  "bhendi": "भेंडी",
+  "bhindi": "भेंडी",
+  "bhende": "भेंडे",
+  "thik": "ठीक",
+  "theek": "ठीक",
+  "dhag": "ढग",
+  "dhol": "ढोल",
+  "dholak": "ढोलक",
+  "dholki": "ढोलकी",
+  "khadda": "खड्डा",
+  "khada": "खड्डा",
+  "tambda": "तांबडा",
+  "tambadi": "तांबडी",
+  "pandhra": "पांढरा",
+  "pandhari": "पांढरी",
+  "korda": "कोरडा",
+  "kordi": "कोरडी",
+  "thanda": "थंड",
+  "thand": "थंड",
+  "god": "गोड",
+  "godd": "गोड",
+  "dodka": "दोडका",
+  "dodke": "दोडके",
+  "karela": "कारले",
+  "karle": "कारले",
+  "bhopla": "भोपळा",
+  "ghevda": "घेवडा",
+  "ghevada": "घेवडा",
+  "danda": "दांडा",
+  "dandi": "दांडी",
+  "dada": "दादा",
+  "dadi": "दादी",
+  "undi": "उंडी",
+  "and": "अंडे",
+  "ande": "अंडे",
+  "anda": "अंडे",
+  "eggs": "अंडी",
+  "egg": "अंडे",
+  "powder": "पावडर",
+  "pavdar": "पावडर",
+  "detergent": "डिटर्जंट",
+  "doctor": "डॉक्टर",
+  "order": "ऑर्डर",
+  "board": "बोर्ड",
+  "card": "कार्ड",
+  "credit": "क्रेडिट",
+  "debit": "डेबिट",
+  "disco": "डिस्को",
+  "diesel": "डिझेल",
+  "petrol": "पेट्रोल",
+  "speed": "स्पीड",
+  "driver": "ड्रायव्हर",
+  "drive": "ड्राइव्ह",
+
+  // --- Enhanced Marathi Daily Essentials & Corner Cases ---
+  "ratri": "रात्री",
+  "raatri": "रात्री",
+  "vikri": "विक्री",
+  "kharedi": "खरेदी",
+  "supari": "सुपारी",
+  "chutney": "चटणी",
+  "chatani": "चटणी",
+  "limbu": "लिंबू",
+  "nimbu": "लिंबू",
+  "bhakri": "भाकरी",
+  "poli": "पोळी",
+  "chikki": "चिक्की",
+  "farsan": "फरसाण",
+  "chivda": "चिवडा",
+  "bhadang": "भडंग",
+  "shev": "शेव",
+  "bakarwadi": "बाकरवडी",
+  "shrikhand": "श्रीखंड",
+  "amrakhand": "आम्रखंड",
+  "basundi": "बासुंदी",
+  "kurdaya": "कुरडया",
+  "papadya": "पापड्या",
+  "khari": "खारी",
+  "toast": "टोस्ट",
+  "pav": "पाव",
+  "bread": "ब्रेड",
+  "butter": "बटर",
+  "loni": "लोणी",
+  "sauce": "सॉस",
+  "jam": "जॅम",
+  "noodle": "नुडल्स",
+  "noodles": "नुडल्स",
+  "pasta": "पास्ता",
+  "macaroni": "मॅकरोनी",
+  "cornflakes": "कॉर्नफ्लेक्स",
+  "oats": "ओट्स",
+  "sendha": "सेंधा",
+  "sendhav": "सेंधव",
+  "rocksalt": "सेंधव मीठ",
+  "sabudana": "साबुदाणा",
+  "bhagar": "भगर",
+  "rajgira": "राजगिरा",
+  "singhada": "शिंगाडा",
+  "makhana": "मखाना",
+  "dryfruit": "ड्रायफ्रूट",
+  "dryfruits": "ड्रायफ्रूट्स",
+  "custard": "कस्टर्ड",
+  "bakingpowder": "बेकिंग पावडर",
+  "bakingsoda": "बेकिंग सोडा",
+  "soda": "सोडा",
+  "eno": "इनो",
+  "matchbox": "काडीपेटी",
+  "diya": "दिवा",
+  "vaat": "वात",
+  "kapus": "कापूस",
+  "gangajal": "गंगाजल",
+  "gulabjal": "गुलाबजल",
+  "kumkum": "कुंकू",
+  "haladikunku": "हळदीकुंकू",
+  "rangoli": "रांगोळी",
+  "shampoo": "शॅम्पू",
+  "conditioner": "कंडिशनर",
+  "harpic": "हार्पिक",
+  "lizol": "लायझोल",
+  "phenyl": "फिनाईल",
+  "closeup": "क्लोजअप",
+  "pepsodent": "पेप्सोडेंट",
+  "sensodyne": "सेन्सॉडीन",
+  "brush": "ब्रश",
+  "dettol": "डेटॉल",
+  "savlon": "सॅव्हलॉन",
+  "rin": "रिन",
+  "tide": "टाईड",
+  "aerial": "एरियल",
+  "wheel": "व्हील",
+  "ghadi": "घडी",
+  "nirma": "निरमा",
+  "vim": "विम",
+  "exo": "एक्सो",
+  "prill": "प्रिल",
+  "scrubber": "स्क्रबर",
+  "sponge": "स्पंज",
+  "jhadu": "झाडू",
+  "pocha": "पोछा",
+  "bucket": "बादली",
+  "badli": "बादली",
+  "mug": "मग",
+  "duster": "डस्टर",
+  "tissue": "टिश्यू",
+  "foil": "फॉइल",
+  "plastic": "प्लास्टिक",
+  "pishvi": "पिशवी",
+  "kilo": "किलो",
+  "gram": "ग्रॅम",
+  "liter": "लिटर",
+  "militre": "मिली",
+  "darzon": "डझन",
+  "dozen": "डझन",
+  "dazan": "डझन",
+  "nag": "नग",
+  "box": "बॉक्स",
+  "carton": "खोके",
+  "goni": "गोणी",
+  "pote": "पोते",
+  "truck": "ट्रक",
+  "tractor": "ट्रॅक्टर",
+  "tempo": "टॅम्पो",
+
+  "pani": "पाणी",
+  "paani": "पाणी",
+  "water": "पाणी",
+  "paan": "पान",
+  "chaan": "छान",
+  "chan": "छान",
+  "man": "मन",
+  "aan": "आण",
+  "bana": "बाण",
+  "dane": "दाणे",
+  "dana": "दाणा",
 };
 

package/src/index.js

@@ -4,18 +4,48 @@
  * for Marathi (Devanagari) script with live smart suggestions.
  */
 
-import { MARATHI_DICTIONARY } from './dictionary.js';
-import { phoneticTransliterateWord } from './phonetics.js';
-import { getCachedWord, setCachedWord, fetchOnlineMarathi } from './cache.js';
-import { attachDevanagari } from './dom.js';
+import { MARATHI_DICTIONARY } from "./dictionary.js";
+import { phoneticTransliterateWord } from "./phonetics.js";
+import { getCachedWord, setCachedWord, fetchOnlineMarathi } from "./cache.js";
+import { attachDevanagari } from "./dom.js";
 
 export { MARATHI_DICTIONARY, fetchOnlineMarathi, attachDevanagari };
 
+/**
+ * Extends or overrides the global transliteration dictionary at runtime.
+ * @param {Record<string, string>} customWords - Map of English -> Marathi words
+ */
+export function extendDictionary(customWords) {
+  if (customWords && typeof customWords === "object") {
+    Object.assign(MARATHI_DICTIONARY, customWords);
+  }
+}
+
+/**
+ * Normalizes Marathi characters (interchangeable ळ/ल, श/ष, ि/ी, ु/ू, and anusvar)
+ * for tolerant comparisons and search filtering.
+ * @param {string} str
+ * @returns {string}
+ */
+export function normalizeMarathi(str) {
+  if (!str) return "";
+  return String(str)
+    .toLowerCase()
+    .replace(/ळ/g, "ल")
+    .replace(/ष/g, "श")
+    .replace(/ी/g, "ि")
+    .replace(/ू/g, "ु")
+    .replace(/[ँं]/g, "")
+    .trim();
+}
+
 /**
  * Transliterates a single English word into Marathi (Devanagari).
- * @param {string} word - Romanized word e.g. sakhar, kanda, atata * @returns {string} - Marathi Devanagari script e.g. साखर, कांदा, बटाटा */
+ * @param {string} word - Romanized word e.g. sakhar, kanda, batata
+ * @returns {string} - Marathi Devanagari script e.g. साखर, कांदा, बटाटा
+ */
 export function transliterateWord(word) {
-  if (!word) return '';
+  if (!word) return "";
   const clean = word.toLowerCase().trim();
 
   // 1. Check curated high-accuracy dictionary first
@@ -33,7 +63,7 @@ export function transliterateWord(word) {
   const phonetic = phoneticTransliterateWord(word);
 
   // Background fetch to enrich cache if online (non-blocking)
-  if (typeof fetch !== 'undefined') {
+  if (typeof fetch !== "undefined") {
     fetchOnlineMarathi(clean).catch(() => {});
   }
 
@@ -47,7 +77,7 @@ export function transliterateWord(word) {
  * @returns {string} - Transliterated text
  */
 export function transliterate(text) {
-  if (!text) return '';
+  if (!text) return "";
 
   return text.replace(/[a-zA-Z]+/g, match => {
     return transliterateWord(match);
@@ -61,6 +91,9 @@ export const toDevanagari = transliterate;
 
 /**
  * Returns ranked candidate spelling suggestions for a word.
+ * Guarantees that any word containing "l" automatically provides both "ळ" (LLA)
+ * and "ल" (LA) variants in candidate suggestions (e.g. bhusal -> भुसाळ, भुसळ, भुसल).
+ *
  * @param {string} word
  * @param {Object} [options]
  * @param {number} [options.maxSuggestions=5]
@@ -95,7 +128,88 @@ export function getSuggestions(word, options = {}) {
   const phonetic = phoneticTransliterateWord(word);
   if (phonetic) add(phonetic);
 
-  // 4. Prefix matches from dictionary (if clean.length >= 3)
+  // 4. Smart Marathi phonetic variants expansion (ळ/ल, ड/द, ढ/ध, ट/त, ठ/थ, ण/न, ष/श, झ/ज, ई/इ, ऊ/उ)
+  const initialCandidates = [...suggestions];
+  for (const s of initialCandidates) {
+    // 4a. ळ (LLA) and ल (LA) - e.g. "keli" -> "केळी", "bhusal" -> "भुसाळ"
+    if (s.includes("ल")) {
+      if (clean.endsWith("al") && s.endsWith("ल") && !s.endsWith("ाल")) {
+        add(s.slice(0, -1) + "ाळ");
+      }
+      add(s.replace(/ल/g, "ळ"));
+    } else if (s.includes("ळ")) {
+      add(s.replace(/ळ/g, "ल"));
+    }
+
+    // 4b. ड (DDA) and द (DA) - e.g. "Jaad" -> "जाड", "Daba" -> "डबा", "kadak" -> "कडक"
+    if (s.includes("द")) {
+      if (clean.endsWith("ad") && s.endsWith("द") && !s.endsWith("ाद")) {
+        add(s.slice(0, -1) + "ाड");
+      }
+      add(s.replace(/द/g, "ड"));
+    } else if (s.includes("ड")) {
+      add(s.replace(/ड/g, "द"));
+    }
+
+    // 4c. ढ (DDHA) and ध (DHA) - e.g. "dhag" -> "ढग", "dhol" -> "ढोल"
+    if (s.includes("ध")) {
+      add(s.replace(/ध/g, "ढ"));
+    } else if (s.includes("ढ")) {
+      add(s.replace(/ढ/g, "ध"));
+    }
+
+    // 4d. ट (TTA) and त (TA) - e.g. "batata" -> "बटाटा", "tomato" -> "टोमॅटो"
+    if (s.includes("त")) {
+      add(s.replace(/त/g, "ट"));
+    } else if (s.includes("ट")) {
+      add(s.replace(/त/g, "त"));
+    }
+
+    // 4e. ठ (TTHA) and थ (THA) - e.g. "thik" -> "ठीक", "path" -> "पाठ"
+    if (s.includes("थ")) {
+      add(s.replace(/थ/g, "ठ"));
+    } else if (s.includes("ठ")) {
+      add(s.replace(/ठ/g, "थ"));
+    }
+
+    // 4f. ण (NNA) and न (NA) - e.g. "pani" -> "पाणी", "bana" -> "बाण", "dane" -> "दाणे"
+    if (s.includes("न")) {
+      add(s.replace(/न/g, "ण"));
+    } else if (s.includes("ण")) {
+      add(s.replace(/ण/g, "न"));
+    }
+
+    // 4g. ष (SSA) and श (SHA) - e.g. "vishesh" -> "विशेष"
+    if (s.includes("श")) {
+      add(s.replace(/श/g, "ष"));
+    } else if (s.includes("ष")) {
+      add(s.replace(/ष/g, "श"));
+    }
+
+    // 4h. झ (JHA) and ज (JA) - e.g. "jhadu" -> "झाडू"
+    if (s.includes("ज") && (clean.includes("jh") || clean.includes("zh") || clean.includes("z"))) {
+      add(s.replace(/ज/g, "झ"));
+    }
+
+    // 4i. Authentic Marathi final dirgha vowel rules (मराठी शुद्धलेखन: अंत्य इकार/उकार दीर्घ)
+    if (s.endsWith("ि")) {
+      add(s.slice(0, -1) + "ी");
+    } else if (s.endsWith("ी")) {
+      add(s.slice(0, -1) + "ि");
+    }
+    if (s.endsWith("ु")) {
+      add(s.slice(0, -1) + "ू");
+    } else if (s.endsWith("ू")) {
+      add(s.slice(0, -1) + "ु");
+    }
+
+    // 4j. Word-ending "a" kana variants (e.g. rama -> रामा & राम)
+    if (clean.endsWith("a") && s.endsWith("ा")) {
+      add(s.slice(0, -1));
+    }
+  }
+
+  // 5. Prefix matches from dictionary (if clean.length >= 3)
   if (clean.length >= 3 && suggestions.length < max) {
     for (const [key, val] of Object.entries(MARATHI_DICTIONARY)) {
       if (key.startsWith(clean) && key !== clean) {
@@ -105,7 +219,7 @@ export function getSuggestions(word, options = {}) {
     }
   }
 
-  // 5. Add raw English word at the end so user can easily keep original
+  // 6. Add raw English word at the end so user can easily keep original
   if (includeOriginal && !suggestions.includes(word)) {
     suggestions.push(word);
   }
@@ -120,6 +234,8 @@ export default {
   toDevanagari,
   getSuggestions,
   attachDevanagari,
+  extendDictionary,
+  normalizeMarathi,
   MARATHI_DICTIONARY,
   fetchOnlineMarathi
 };

package/src/phonetics.js

@@ -5,108 +5,118 @@
 
 const CONSONANTS = [
   // Multi-character special combinations
-  { en: 'dny', mr: 'ज्ञ' },
-  { en: 'jn', mr: 'ज्ञ' },
-  { en: 'gy', mr: 'ज्ञ' },
-  { en: 'ksh', mr: 'क्ष' },
-  { en: 'shr', mr: 'श्र' },
-  { en: 'chh', mr: 'छ' },
-  { en: 'ch', mr: 'च' },
-  { en: 'kh', mr: 'ख' },
-  { en: 'gh', mr: 'घ' },
-  { en: 'jh', mr: 'झ' },
-  { en: 'zh', mr: 'झ' },
-  { en: 'th', mr: 'थ' },
-  { en: 'dh', mr: 'ध' },
-  { en: 'ph', mr: 'फ' },
-  { en: 'bh', mr: 'भ' },
-  { en: 'shh', mr: 'ष' },
-  { en: 'sh', mr: 'श' },
-  { en: 'ng', mr: 'ङ' },
-
-  // Single consonants
-  { en: 'k', mr: 'क' },
-  { en: 'g', mr: 'ग' },
-  { en: 'j', mr: 'ज' },
-  { en: 't', mr: 'त' },
-  { en: 'd', mr: 'द' },
-  { en: 'n', mr: 'न' },
-  { en: 'p', mr: 'प' },
-  { en: 'f', mr: 'फ' },
-  { en: 'b', mr: 'ब' },
-  { en: 'm', mr: 'म' },
-  { en: 'y', mr: 'य' },
-  { en: 'r', mr: 'र' },
-  { en: 'l', mr: 'ल' },
-  { en: 'L', mr: 'ळ' },
-  { en: 'v', mr: 'व' },
-  { en: 'w', mr: 'व' },
-  { en: 's', mr: 'स' },
-  { en: 'h', mr: 'ह' },
-  { en: 'x', mr: 'क्ष' },
-  { en: 'z', mr: 'झ' },
-  { en: 'T', mr: 'ट' },
-  { en: 'D', mr: 'ड' },
-  { en: 'N', mr: 'ण' }
+  { en: "dny", mr: "ज्ञ" },
+  { en: "jn", mr: "ज्ञ" },
+  { en: "gy", mr: "ज्ञ" },
+  { en: "ksh", mr: "क्ष" },
+  { en: "shr", mr: "श्र" },
+  { en: "chh", mr: "छ" },
+  { en: "ch", mr: "च" },
+  { en: "kh", mr: "ख" },
+  { en: "gh", mr: "घ" },
+  { en: "jh", mr: "झ" },
+  { en: "zh", mr: "झ" },
+  { en: "Dh", mr: "ढ", caseSensitive: true },
+  { en: "DH", mr: "ढ", caseSensitive: true },
+  { en: "dh", mr: "ध" },
+  { en: "Th", mr: "ठ", caseSensitive: true },
+  { en: "TH", mr: "ठ", caseSensitive: true },
+  { en: "th", mr: "थ" },
+  { en: "ph", mr: "फ" },
+  { en: "bh", mr: "भ" },
+  { en: "shh", mr: "ष" },
+  { en: "Sh", mr: "ष", caseSensitive: true },
+  { en: "SH", mr: "ष", caseSensitive: true },
+  { en: "sh", mr: "श" },
+  { en: "ck", mr: "क" },
+  { en: "ng", mr: "ङ" },
+  { en: "c", mr: "क" },
+
+  // Single consonants - case-sensitive retroflex & special Marathi sounds FIRST
+  { en: "T", mr: "ट", caseSensitive: true },
+  { en: "D", mr: "ड", caseSensitive: true },
+  { en: "N", mr: "ण", caseSensitive: true },
+  { en: "L", mr: "ळ", caseSensitive: true },
+
+  // Single consonants - standard
+  { en: "k", mr: "क" },
+  { en: "g", mr: "ग" },
+  { en: "j", mr: "ज" },
+  { en: "t", mr: "त" },
+  { en: "d", mr: "द" },
+  { en: "n", mr: "न" },
+  { en: "p", mr: "प" },
+  { en: "f", mr: "फ" },
+  { en: "b", mr: "ब" },
+  { en: "m", mr: "म" },
+  { en: "y", mr: "य" },
+  { en: "r", mr: "र" },
+  { en: "l", mr: "ल" },
+  { en: "v", mr: "व" },
+  { en: "w", mr: "व" },
+  { en: "s", mr: "स" },
+  { en: "h", mr: "ह" },
+  { en: "x", mr: "क्ष" },
+  { en: "z", mr: "झ" }
 ];
 
 const INDEPENDENT_VOWELS = [
-  { en: 'aa', mr: 'आ' },
-  { en: 'A', mr: 'आ' },
-  { en: 'a', mr: 'अ' },
-  { en: 'ee', mr: 'ई' },
-  { en: 'ii', mr: 'ई' },
-  { en: 'i', mr: 'इ' },
-  { en: 'oo', mr: 'ऊ' },
-  { en: 'uu', mr: 'ऊ' },
-  { en: 'u', mr: 'उ' },
-  { en: 'ai', mr: 'ऐ' },
-  { en: 'ay', mr: 'ऐ' },
-  { en: 'au', mr: 'औ' },
-  { en: 'ou', mr: 'औ' },
-  { en: 'ow', mr: 'औ' },
-  { en: 'e', mr: 'ए' },
-  { en: 'o', mr: 'ओ' },
-  { en: 'am', mr: 'अं' },
-  { en: 'an', mr: 'अं' },
-  { en: 'ri', mr: 'ऋ' },
-  { en: 'ru', mr: 'ऋ' }
+  { en: "aa", mr: "आ" },
+  { en: "A", mr: "आ" },
+  { en: "a", mr: "अ" },
+  { en: "ee", mr: "ई" },
+  { en: "ii", mr: "ई" },
+  { en: "i", mr: "इ" },
+  { en: "oo", mr: "ऊ" },
+  { en: "uu", mr: "ऊ" },
+  { en: "u", mr: "उ" },
+  { en: "ai", mr: "ऐ" },
+  { en: "ay", mr: "ऐ" },
+  { en: "au", mr: "औ" },
+  { en: "ou", mr: "औ" },
+  { en: "ow", mr: "औ" },
+  { en: "e", mr: "ए" },
+  { en: "o", mr: "ओ" },
+  { en: "am", mr: "अं" },
+  { en: "an", mr: "अं" },
+  { en: "ri", mr: "ऋ" },
+  { en: "ru", mr: "ऋ" },
+  { en: "R", mr: "ऋ", caseSensitive: true }
 ];
 
 const MATRAS = [
-  { en: 'aa', mr: 'ा' },
-  { en: 'A', mr: 'ा' },
-  { en: 'a', mr: '' }, // Inherent vowel: cancels halant, no visible matra
-  { en: 'ee', mr: 'ी' },
-  { en: 'ii', mr: 'ी' },
-  { en: 'i', mr: 'ि' },
-  { en: 'oo', mr: 'ू' },
-  { en: 'uu', mr: 'ू' },
-  { en: 'u', mr: 'ु' },
-  { en: 'ai', mr: 'ै' },
-  { en: 'ay', mr: 'ै' },
-  { en: 'au', mr: 'ौ' },
-  { en: 'ou', mr: 'ौ' },
-  { en: 'ow', mr: 'ौ' },
-  { en: 'e', mr: 'े' },
-  { en: 'o', mr: 'ो' },
-  { en: 'am', mr: 'ं' },
-  { en: 'an', mr: 'ं' },
-  { en: 'ri', mr: 'ृ' },
-  { en: 'ru', mr: 'ृ' }
+  { en: "aa", mr: "ा" },
+  { en: "A", mr: "ा" },
+  { en: "a", mr: "" }, // Inherent vowel: cancels halant; at word end becomes kana
+  { en: "ee", mr: "ी" },
+  { en: "ii", mr: "ी" },
+  { en: "i", mr: "ि" },
+  { en: "oo", mr: "ू" },
+  { en: "uu", mr: "ू" },
+  { en: "u", mr: "ु" },
+  { en: "ai", mr: "ै" },
+  { en: "ay", mr: "ै" },
+  { en: "au", mr: "ौ" },
+  { en: "ou", mr: "ौ" },
+  { en: "ow", mr: "ौ" },
+  { en: "e", mr: "े" },
+  { en: "o", mr: "ो" },
+  { en: "am", mr: "ं" },
+  { en: "an", mr: "ं" },
+  { en: "R", mr: "ृ", caseSensitive: true }
 ];
 
 /**
  * Phonetically transliterates a single Roman word to Devanagari.
- * @param {string} text - Single English word (e.g. "shantanu", "ramesh")
+ * @param {string} text - Single English word (e.g. "shantanu", "ramesh", "Jaad", "Daba")
  * @returns {string} - Devanagari representation
  */
 export function phoneticTransliterateWord(text) {
-  if (!text) return '';
+  if (!text) return "";
   const clean = text.trim();
-  if (!clean) return '';
+  if (!clean) return "";
 
-  let res = '';
+  let res = "";
   let i = 0;
   const n = clean.length;
 
@@ -122,7 +132,9 @@ export function phoneticTransliterateWord(text) {
     let matchedVowel = false;
     if (i === 0 || !/[a-zA-Z]/.test(clean[i - 1])) {
       for (const v of INDEPENDENT_VOWELS) {
-        if (clean.substring(i, i + v.en.length).toLowerCase() === v.en.toLowerCase()) {
+        const sub = clean.substring(i, i + v.en.length);
+        const isMatch = v.caseSensitive ? sub === v.en : sub.toLowerCase() === v.en.toLowerCase();
+        if (isMatch) {
           res += v.mr;
           i += v.en.length;
           matchedVowel = true;
@@ -136,8 +148,7 @@ export function phoneticTransliterateWord(text) {
     let matchedConsonant = false;
     for (const c of CONSONANTS) {
       const sub = clean.substring(i, i + c.en.length);
-      const isCaseSensitive = c.en === 'L' || c.en === 'T' || c.en === 'D' || c.en === 'N';
-      const isMatch = isCaseSensitive ? sub === c.en : sub.toLowerCase() === c.en.toLowerCase();
+      const isMatch = c.caseSensitive ? sub === c.en : sub.toLowerCase() === c.en.toLowerCase();
 
       if (isMatch) {
         res += c.mr;
@@ -148,11 +159,17 @@ export function phoneticTransliterateWord(text) {
         let matchedMatra = false;
         for (const m of MATRAS) {
           const nextSub = clean.substring(i, i + m.en.length);
-          const mCaseSensitive = m.en === 'A';
+          const mCaseSensitive = m.caseSensitive || m.en === "A";
           const mMatch = mCaseSensitive ? nextSub === m.en : nextSub.toLowerCase() === m.en.toLowerCase();
 
           if (mMatch) {
-            res += m.mr;
+            // When user types trailing "a" at the end of word (e.g. daba -> डबा, patrika -> पत्रिका),
+            // in casual Marathi it represents the kana "ा"
+            if (m.en === "a" && i + 1 === n && i > 0) {
+              res += "ा";
+            } else {
+              res += m.mr;
+            }
             i += m.en.length;
             matchedMatra = true;
             break;
@@ -163,7 +180,7 @@ export function phoneticTransliterateWord(text) {
         // In Marathi/Hindi phonetics, word-final consonants do NOT get halant
         if (!matchedMatra) {
           if (i < n && /[a-zA-Z]/.test(clean[i])) {
-            res += '्';
+            res += "्";
           }
         }