ipa-hangul 1.2.3 → 1.3.1

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,7 @@ function preprocessIPA(ipa) {
 function hasIPAVowel(text) {
   return /[iɪeɛæɑɒɔʌəɜɝʊuoa]/.test(text);
 }
-function getTrailingConsonants(text) {
+function getTrailingConsonants(text, preferOnset = false) {
   let i = text.length;
   while (i > 0) {
     if (i >= 2) {
@@ -284,6 +284,25 @@ function getTrailingConsonants(text) {
   if (!allTrailing) {
     return { before: text, trailing: "" };
   }
+  if (preferOnset) {
+    if (allTrailing.length >= 2) {
+      const lastTwo = allTrailing.substring(allTrailing.length - 2);
+      if (CONSONANT_TO_CHOSEONG[lastTwo] || CONSONANT_TO_JAMO[lastTwo]) {
+        return {
+          before: beforeConsonants + allTrailing.substring(0, allTrailing.length - 2),
+          trailing: lastTwo
+        };
+      }
+    }
+    const lastOne = allTrailing[allTrailing.length - 1];
+    if (CONSONANT_TO_CHOSEONG[lastOne] || CONSONANT_TO_JAMO[lastOne]) {
+      return {
+        before: beforeConsonants + allTrailing.substring(0, allTrailing.length - 1),
+        trailing: lastOne
+      };
+    }
+    return { before: text, trailing: "" };
+  }
   let keepUntil = 0;
   if (allTrailing.length >= 2) {
     const twoChar = allTrailing.substring(0, 2);
@@ -305,7 +324,7 @@ function getTrailingConsonants(text) {
 function startsWithVowel(text) {
   return matchVowel(text, 0) !== null;
 }
-function parseSyllables(text) {
+function parseSyllables(text, preferOnset = true) {
   const syllables = [];
   const parts = text.split(".");
   for (const part of parts) {
@@ -332,7 +351,7 @@ function parseSyllables(text) {
     const curr = merged[i];
     const next = merged[i + 1];
     if (startsWithVowel(next.text)) {
-      const { before, trailing } = getTrailingConsonants(curr.text);
+      const { before, trailing } = getTrailingConsonants(curr.text, preferOnset);
       if (trailing && before) {
         curr.text = before;
         next.text = trailing + next.text;
@@ -512,9 +531,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,7 @@ function preprocessIPA(ipa) {
 function hasIPAVowel(text) {
   return /[iɪeɛæɑɒɔʌəɜɝʊuoa]/.test(text);
 }
-function getTrailingConsonants(text) {
+function getTrailingConsonants(text, preferOnset = false) {
   let i = text.length;
   while (i > 0) {
     if (i >= 2) {
@@ -260,6 +260,25 @@ function getTrailingConsonants(text) {
   if (!allTrailing) {
     return { before: text, trailing: "" };
   }
+  if (preferOnset) {
+    if (allTrailing.length >= 2) {
+      const lastTwo = allTrailing.substring(allTrailing.length - 2);
+      if (CONSONANT_TO_CHOSEONG[lastTwo] || CONSONANT_TO_JAMO[lastTwo]) {
+        return {
+          before: beforeConsonants + allTrailing.substring(0, allTrailing.length - 2),
+          trailing: lastTwo
+        };
+      }
+    }
+    const lastOne = allTrailing[allTrailing.length - 1];
+    if (CONSONANT_TO_CHOSEONG[lastOne] || CONSONANT_TO_JAMO[lastOne]) {
+      return {
+        before: beforeConsonants + allTrailing.substring(0, allTrailing.length - 1),
+        trailing: lastOne
+      };
+    }
+    return { before: text, trailing: "" };
+  }
   let keepUntil = 0;
   if (allTrailing.length >= 2) {
     const twoChar = allTrailing.substring(0, 2);
@@ -281,7 +300,7 @@ function getTrailingConsonants(text) {
 function startsWithVowel(text) {
   return matchVowel(text, 0) !== null;
 }
-function parseSyllables(text) {
+function parseSyllables(text, preferOnset = true) {
   const syllables = [];
   const parts = text.split(".");
   for (const part of parts) {
@@ -308,7 +327,7 @@ function parseSyllables(text) {
     const curr = merged[i];
     const next = merged[i + 1];
     if (startsWithVowel(next.text)) {
-      const { before, trailing } = getTrailingConsonants(curr.text);
+      const { before, trailing } = getTrailingConsonants(curr.text, preferOnset);
       if (trailing && before) {
         curr.text = before;
         next.text = trailing + next.text;
@@ -488,9 +507,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.3",
+  "version": "1.3.1",
   "description": "Convert IPA (International Phonetic Alphabet) pronunciation to Korean Hangul",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",