ipa-hangul 1.2.2 → 1.3.0

package/dist/index.d.mts

@@ -12,6 +12,13 @@
  */
 interface IpaToHangulOptions {
     markStress?: 'markdown' | 'html';
+    /**
+     * When true, trailing consonants move to next syllable if it starts with a vowel.
+     * This produces more natural Korean loan word pronunciation.
+     * e.g., "tɪti" → "티티" instead of "팉이"
+     * @default true
+     */
+    preferOnset?: boolean;
 }
 /**
  * Convert IPA notation to Korean Hangul pronunciation

package/dist/index.d.ts

@@ -12,6 +12,13 @@
  */
 interface IpaToHangulOptions {
     markStress?: 'markdown' | 'html';
+    /**
+     * When true, trailing consonants move to next syllable if it starts with a vowel.
+     * This produces more natural Korean loan word pronunciation.
+     * e.g., "tɪti" → "티티" instead of "팉이"
+     * @default true
+     */
+    preferOnset?: boolean;
 }
 /**
  * Convert IPA notation to Korean Hangul pronunciation

package/dist/index.js

@@ -262,7 +262,56 @@ function preprocessIPA(ipa) {
 function hasIPAVowel(text) {
   return /[iɪeɛæɑɒɔʌəɜɝʊuoa]/.test(text);
 }
-function parseSyllables(text) {
+function getTrailingConsonants(text, preferOnset = false) {
+  let i = text.length;
+  while (i > 0) {
+    if (i >= 2) {
+      const twoChar = text.substring(i - 2, i);
+      if (CONSONANT_TO_CHOSEONG[twoChar] || CONSONANT_TO_JAMO[twoChar]) {
+        i -= 2;
+        continue;
+      }
+    }
+    const oneChar = text[i - 1];
+    if (CONSONANT_TO_CHOSEONG[oneChar] || CONSONANT_TO_JAMO[oneChar]) {
+      i--;
+      continue;
+    }
+    break;
+  }
+  const beforeConsonants = text.substring(0, i);
+  const allTrailing = text.substring(i);
+  if (!allTrailing) {
+    return { before: text, trailing: "" };
+  }
+  if (preferOnset) {
+    return {
+      before: beforeConsonants,
+      trailing: allTrailing
+    };
+  }
+  let keepUntil = 0;
+  if (allTrailing.length >= 2) {
+    const twoChar = allTrailing.substring(0, 2);
+    if (CONSONANT_TO_JONGSEONG[twoChar] !== void 0) {
+      keepUntil = 2;
+    }
+  }
+  if (keepUntil === 0 && allTrailing.length >= 1) {
+    const oneChar = allTrailing[0];
+    if (CONSONANT_TO_JONGSEONG[oneChar] !== void 0) {
+      keepUntil = 1;
+    }
+  }
+  return {
+    before: beforeConsonants + allTrailing.substring(0, keepUntil),
+    trailing: allTrailing.substring(keepUntil)
+  };
+}
+function startsWithVowel(text) {
+  return matchVowel(text, 0) !== null;
+}
+function parseSyllables(text, preferOnset = true) {
   const syllables = [];
   const parts = text.split(".");
   for (const part of parts) {
@@ -285,6 +334,17 @@ function parseSyllables(text) {
     }
     merged.push(curr);
   }
+  for (let i = 0; i < merged.length - 1; i++) {
+    const curr = merged[i];
+    const next = merged[i + 1];
+    if (startsWithVowel(next.text)) {
+      const { before, trailing } = getTrailingConsonants(curr.text, preferOnset);
+      if (trailing && before) {
+        curr.text = before;
+        next.text = trailing + next.text;
+      }
+    }
+  }
   return merged;
 }
 function splitByLongVowel(text) {
@@ -458,9 +518,10 @@ function applyStressMarker(hangul, stress, format) {
 }
 function ipaToHangul(ipa, options) {
   if (!ipa) return "";
+  const preferOnset = options?.preferOnset !== false;
   const cleaned = preprocessIPA(ipa);
   if (!cleaned) return "";
-  const syllables = parseSyllables(cleaned);
+  const syllables = parseSyllables(cleaned, preferOnset);
   const results = [];
   for (const syllable of syllables) {
     const segments = splitByLongVowel(syllable.text);

package/dist/index.mjs

@@ -238,7 +238,56 @@ function preprocessIPA(ipa) {
 function hasIPAVowel(text) {
   return /[iɪeɛæɑɒɔʌəɜɝʊuoa]/.test(text);
 }
-function parseSyllables(text) {
+function getTrailingConsonants(text, preferOnset = false) {
+  let i = text.length;
+  while (i > 0) {
+    if (i >= 2) {
+      const twoChar = text.substring(i - 2, i);
+      if (CONSONANT_TO_CHOSEONG[twoChar] || CONSONANT_TO_JAMO[twoChar]) {
+        i -= 2;
+        continue;
+      }
+    }
+    const oneChar = text[i - 1];
+    if (CONSONANT_TO_CHOSEONG[oneChar] || CONSONANT_TO_JAMO[oneChar]) {
+      i--;
+      continue;
+    }
+    break;
+  }
+  const beforeConsonants = text.substring(0, i);
+  const allTrailing = text.substring(i);
+  if (!allTrailing) {
+    return { before: text, trailing: "" };
+  }
+  if (preferOnset) {
+    return {
+      before: beforeConsonants,
+      trailing: allTrailing
+    };
+  }
+  let keepUntil = 0;
+  if (allTrailing.length >= 2) {
+    const twoChar = allTrailing.substring(0, 2);
+    if (CONSONANT_TO_JONGSEONG[twoChar] !== void 0) {
+      keepUntil = 2;
+    }
+  }
+  if (keepUntil === 0 && allTrailing.length >= 1) {
+    const oneChar = allTrailing[0];
+    if (CONSONANT_TO_JONGSEONG[oneChar] !== void 0) {
+      keepUntil = 1;
+    }
+  }
+  return {
+    before: beforeConsonants + allTrailing.substring(0, keepUntil),
+    trailing: allTrailing.substring(keepUntil)
+  };
+}
+function startsWithVowel(text) {
+  return matchVowel(text, 0) !== null;
+}
+function parseSyllables(text, preferOnset = true) {
   const syllables = [];
   const parts = text.split(".");
   for (const part of parts) {
@@ -261,6 +310,17 @@ function parseSyllables(text) {
     }
     merged.push(curr);
   }
+  for (let i = 0; i < merged.length - 1; i++) {
+    const curr = merged[i];
+    const next = merged[i + 1];
+    if (startsWithVowel(next.text)) {
+      const { before, trailing } = getTrailingConsonants(curr.text, preferOnset);
+      if (trailing && before) {
+        curr.text = before;
+        next.text = trailing + next.text;
+      }
+    }
+  }
   return merged;
 }
 function splitByLongVowel(text) {
@@ -434,9 +494,10 @@ function applyStressMarker(hangul, stress, format) {
 }
 function ipaToHangul(ipa, options) {
   if (!ipa) return "";
+  const preferOnset = options?.preferOnset !== false;
   const cleaned = preprocessIPA(ipa);
   if (!cleaned) return "";
-  const syllables = parseSyllables(cleaned);
+  const syllables = parseSyllables(cleaned, preferOnset);
   const results = [];
   for (const syllable of syllables) {
     const segments = splitByLongVowel(syllable.text);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ipa-hangul",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "Convert IPA (International Phonetic Alphabet) pronunciation to Korean Hangul",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",