marathi-transliterate 1.1.1 → 1.2.0

package/README.md

@@ -146,6 +146,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.2.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,178 @@ 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': 'कमलेश'
 };
 

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,21 @@ 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 ळ (LLA) and ल (LA) variants expansion
+  const initialCandidates = [...suggestions];
+  for (const s of initialCandidates) {
+    if (s.includes("ल")) {
+      // Special Marathi phonetic rule: words ending in "al" often end in "ाळ" (e.g. bhusal -> भुसाळ)
+      if (clean.endsWith("al") && s.endsWith("ल")) {
+        add(s.slice(0, -1) + "ाळ");
+      }
+      add(s.replace(/ल/g, "ळ"));
+    } else if (s.includes("ळ")) {
+      add(s.replace(/ळ/g, "ल"));
+    }
+  }
+
+  // 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 +152,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 +167,8 @@ export default {
   toDevanagari,
   getSuggestions,
   attachDevanagari,
+  extendDictionary,
+  normalizeMarathi,
   MARATHI_DICTIONARY,
   fetchOnlineMarathi
 };