@ihabdevteam/core 0.322.0 → 0.323.0

package/dist/packages/core/src/utils/format.js

@@ -67,10 +67,10 @@ export function formatPhone(raw) {
  * **사람에게 거는 번호** — 휴대폰 · 지역번호(02·0NN) · 050X 안심번호 · 0303 착신전환.
  * 새 대역은 여기에만 더하면 아래 둘이 함께 받는다.
  */
-const 개인번호 = String.raw `(?:0\d{1,2}|050\d|0303)-\d{3,4}-\d{4}`;
+const PERSONAL_PHONE = String.raw `(?:0\d{1,2}|050\d|0303)-\d{3,4}-\d{4}`;
 /** **대표번호**(1588 등) — 거는 곳이 사람이 아니라 기관이다 */
-const 대표번호 = String.raw `1[5-9]\d{2}-\d{4}`;
-export const PHONE_REGEX = new RegExp(`^(?:${개인번호}|${대표번호})$`);
+const SERVICE_PHONE = String.raw `1[5-9]\d{2}-\d{4}`;
+export const PHONE_REGEX = new RegExp(`^(?:${PERSONAL_PHONE}|${SERVICE_PHONE})$`);
 /**
  * **대표번호를 뺀 것만** 받는 자 — `PHONE_REGEX` 에서 대표번호 갈래를 뺀 것이다.
  *
@@ -81,7 +81,7 @@ export const PHONE_REGEX = new RegExp(`^(?:${개인번호}|${대표번호})$`);
  * 않는 대역이 하나 더 생기는 날 **두 앱이 조용히 그것을 받게 된다.** 뜻대로 적어 둔다.
  * @public
  */
-export const PERSONAL_PHONE_REGEX = new RegExp(`^${개인번호}$`);
+export const PERSONAL_PHONE_REGEX = new RegExp(`^${PERSONAL_PHONE}$`);
 /** 연락처가 `formatPhone` 이 끝까지 채워 낸 모양인가 — 규칙은 `PHONE_REGEX`. @public */
 export function isValidPhone(phone) {
     return PHONE_REGEX.test(phone);

package/dist/packages/core/src/utils/getTrainingData.js

@@ -106,7 +106,7 @@ export async function loadTrainingData() {
         }
         /* 다 읽은 뒤에 한꺼번에 넣는다 — 도중에 형식 오류로 멈추면 이미 넣은 것이 남은 채 재시도가 또 넣어, 부를 때마다 풀에
            중복이 쌓였다(하루 선택이 중복 문항을 뽑고 기기마다 세트가 달라짐). */
-        const 받음 = { noise: [], short: [], long: [], order: [] };
+        const received = { noise: [], short: [], long: [], order: [] };
         try {
             for (const key of Object.keys(map || {})) {
                 const groups = map[key] || [];
@@ -121,16 +121,16 @@ export async function loadTrainingData() {
                     // Preserve original group structure from allTrainingData.json
                     const groupObj = Object.assign({}, gr, { training_type: t, category_0: cat0, category_1: cat1 });
                     if (t === 'LISTEN_IN_NOISE') {
-                        받음.noise.push(groupObj);
+                        received.noise.push(groupObj);
                     }
                     else if (t === 'SHORT_STORY') {
-                        받음.short.push(groupObj);
+                        received.short.push(groupObj);
                     }
                     else if (t === 'LONG_STORY') {
-                        받음.long.push(groupObj);
+                        received.long.push(groupObj);
                     }
                     else if (t === 'ORDERING_SENTENCE') {
-                        받음.order.push(groupObj);
+                        received.order.push(groupObj);
                     }
                 }
             }
@@ -148,10 +148,10 @@ export async function loadTrainingData() {
             catch { /* SSR 등 */ }
             return;
         }
-        NOISE_DATAS.push(...받음.noise);
-        SHORT_STORIES.push(...받음.short);
-        LONG_STORIES.push(...받음.long);
-        ORDER_SETS.push(...받음.order);
+        NOISE_DATAS.push(...received.noise);
+        SHORT_STORIES.push(...received.short);
+        LONG_STORIES.push(...received.long);
+        ORDER_SETS.push(...received.order);
         // 다 채운 뒤 _loaded 를 먼저 세운다 — 'updated' 를 받은 쪽이 isTrainingDataLoaded() 로 확인하면 아직 false 였다
         _loaded = true;
         try {

package/dist/packages/core/src/utils/imageConfig.js

@@ -13,11 +13,11 @@ const LS_KEY = 'word_image_existence_map_v1';
 let memMap = null;
 /* 캐시가 바뀔 때마다 오르는 판 번호 — 통계·'있음' 낱말 집합을 판마다 한 번만 센다(단어훈련 칩 한 번에 유형 수만큼
    2.3만 칸을 훑었다). 캐시를 바꾸는 곳(확인 결과 담기·일괄 주입·비우기)은 모두 판을 올린다. */
-let 캐시판 = 0;
-let 통계판 = -1;
-let 통계값 = null;
-let 있음판 = -1;
-let 있음집합 = new Set();
+let cacheVersion = 0;
+let statsVersion = -1;
+let statsValue = null;
+let okVersion = -1;
+let okSet = new Set();
 const inflight = new Map(); // 중복 fetch 방지
 function ensureLoaded() {
     if (memMap)
@@ -80,7 +80,7 @@ export async function checkImageExists(word, homonum) {
         if (ok === null)
             return false;
         map[k] = ok;
-        캐시판++;
+        cacheVersion++;
         scheduleSave();
         return ok;
     });
@@ -143,24 +143,24 @@ export async function prewarmImageCache(words, options = {}) {
  */
 export function getImageExistenceStats() {
     const map = ensureLoaded();
-    if (통계판 === 캐시판)
-        return 통계값 ? { ...통계값 } : null;
+    if (statsVersion === cacheVersion)
+        return statsValue ? { ...statsValue } : null;
     const values = Object.values(map);
-    통계값 = values.length === 0 ? null : { total: values.length, exists: values.filter(Boolean).length };
-    통계판 = 캐시판;
-    return 통계값 ? { ...통계값 } : null;
+    statsValue = values.length === 0 ? null : { total: values.length, exists: values.filter(Boolean).length };
+    statsVersion = cacheVersion;
+    return statsValue ? { ...statsValue } : null;
 }
 /** @internal 동음이의 번호 없이(=1) '이미지 있음' 으로 확인된 낱말 집합 — 캐시 판마다 한 번 만든다. 돌려받은 집합을 고치지 말 것. */
 export function getImageOkWordSet() {
     const map = ensureLoaded();
-    if (있음판 === 캐시판)
-        return 있음집합;
+    if (okVersion === cacheVersion)
+        return okSet;
     const s = new Set();
     for (const k in map)
         if (map[k] === true && k.endsWith('_1'))
             s.add(k.slice(0, -2));
-    있음집합 = s;
-    있음판 = 캐시판;
+    okSet = s;
+    okVersion = cacheVersion;
     return s;
 }
 /**
@@ -171,7 +171,7 @@ export function getImageOkWordSet() {
 export function bulkSetImageExistence(entries) {
     const map = ensureLoaded();
     Object.assign(map, entries);
-    캐시판++;
+    cacheVersion++;
     try {
         if (typeof localStorage !== 'undefined') {
             localStorage.setItem(LS_KEY, JSON.stringify(map));
@@ -182,7 +182,7 @@ export function bulkSetImageExistence(entries) {
 /** @public 캐시 초기화 (이미지 데이터 변경 시 호출) */
 export function clearImageExistenceCache() {
     memMap = {};
-    캐시판++;
+    cacheVersion++;
     try {
         if (typeof localStorage !== 'undefined')
             localStorage.removeItem(LS_KEY);

package/dist/packages/core/src/utils/koreanSyllable.js

@@ -241,10 +241,10 @@ export function wordContainsJungseong(word, jamo) {
 }
 /** 음절의 종성이 고른 자모 하나와 맞는지 — 두 모드의 단일 출처. */
 function jongMatchesJamo(jong, jamo, mode) {
-    const 글자 = JONGSEONG[jong];
-    if (글자 === jamo)
+    const glyph = JONGSEONG[jong];
+    if (glyph === jamo)
         return true;
-    return mode === 'phoneme' && finalToPhoneme(글자) === finalToPhoneme(jamo);
+    return mode === 'phoneme' && finalToPhoneme(glyph) === finalToPhoneme(jamo);
 }
 /** @public 단어가 특정 자모를 종성(coda)으로 포함하는지.
  *  `jongMatch` 로 **글자 그대로**(기본) · **받침 소리**(`'phoneme'`)를 고른다 — `JongMatch` 설명을 본다. */
@@ -373,41 +373,41 @@ export function wordHasConsonantAt(word, parts, position,
 jongMatch = 'glyph') {
     if (!word)
         return false;
-    const 음절 = [...word].map(parseSyllable).filter((s) => !!s);
-    if (음절.length === 0)
+    const syllables = [...word].map(parseSyllable).filter((s) => !!s);
+    if (syllables.length === 0)
         return false;
-    const 끝 = 음절.length - 1;
+    const last = syllables.length - 1;
     if (position === 'head') {
         /* 어두는 **첫 음절의 초성**뿐이다. `ㅇ` 은 음가가 없어 자리를 안 가진다 —
            `아기` 의 어두초성은 **없다**(`cho: ['ㅇ']` 로 물으면 거짓). */
         if (!parts.cho)
             return false;
-        const c = CHOSEONG[음절[0].cho];
+        const c = CHOSEONG[syllables[0].cho];
         return c !== 'ㅇ' && parts.cho.includes(c);
     }
     if (position === 'tail') {
         /* 어말은 **마지막 받침**뿐이다. 받침이 없으면 자리가 없다. */
         if (parts.jongNone)
-            return 음절[끝].jong === 0;
+            return syllables[last].jong === 0;
         if (!parts.jong)
             return false;
-        return syllableJongMatches(음절[끝], parts.jong, jongMatch);
+        return syllableJongMatches(syllables[last], parts.jong, jongMatch);
     }
     /* 어중 — 첫 초성과 마지막 종성을 **뺀** 나머지 자음 전부. 2음절 `선물` 이면
        ㄴ(0번 종성) · ㅁ(1번 초성) 둘이 어중이다. */
-    const 초성맞나 = !parts.cho || 음절.some((s, i) => {
+    const onsetMatches = !parts.cho || syllables.some((s, i) => {
         if (i === 0)
             return false; // 첫 초성은 어두다
         const c = CHOSEONG[s.cho];
         return c !== 'ㅇ' && parts.cho.includes(c); // 음가 없는 ㅇ 은 자리를 안 가진다
     });
-    const 종성맞나 = parts.jongNone
-        ? 음절.some((s, i) => i !== 끝 && s.jong === 0)
-        : !parts.jong || 음절.some((s, i) => i !== 끝 && syllableJongMatches(s, parts.jong, jongMatch));
+    const codaMatches = parts.jongNone
+        ? syllables.some((s, i) => i !== last && s.jong === 0)
+        : !parts.jong || syllables.some((s, i) => i !== last && syllableJongMatches(s, parts.jong, jongMatch));
     /* 둘 다 줬으면 **둘 다** 있어야 한다(AND) — 하나만 줬으면 그쪽만 참이면 된다 */
     if (!parts.cho && !parts.jong && !parts.jongNone)
         return false;
-    return 초성맞나 && 종성맞나;
+    return onsetMatches && codaMatches;
 }
 /**
  * @public 문자열이 음절 패턴 DSL 문법인지 — 쉼표(,) 포함 여부로 판별한다.
@@ -749,12 +749,12 @@ export function searchAndRankWords(items, query) {
     const headLen = [...q].length;
     const startsWith = (s) => !!s && m(s.normalize('NFC').slice(0, headLen));
     // 순위는 두 갈래로 나눠 잇는다(안정 정렬과 같은 순서)
-    const 앞 = [];
-    const 뒤 = [];
+    const before = [];
+    const after = [];
     for (const w of items) {
         if (!(m(w.word) || m(w.pronunciation ?? '')))
             continue;
-        (startsWith(w.word) || startsWith(w.pronunciation ?? '') ? 앞 : 뒤).push(w);
+        (startsWith(w.word) || startsWith(w.pronunciation ?? '') ? before : after).push(w);
     }
-    return 앞.concat(뒤);
+    return before.concat(after);
 }

package/dist/packages/core/src/utils/navScroll.js

@@ -17,8 +17,8 @@ export function scrollNavTargetToTop(scrollContainer, from = 'Nav') {
             el.scrollTop = 0;
             return;
         }
-        const 문서 = document.scrollingElement ?? document.documentElement;
-        if (문서 && 문서.scrollHeight <= 문서.clientHeight) {
+        const doc = document.scrollingElement ?? document.documentElement;
+        if (doc && doc.scrollHeight <= doc.clientHeight) {
             devWarnOnce('nav-scroll-container', `[${from}] 본문을 맨 위로 되돌릴 통을 못 찾았다(기본 ${DEFAULT_SCROLL_SELECTOR}) — 창도 구를 수 없어 아무 일도 하지 않는다. scrollContainer 로 통을 알려 준다.`);
         }
         window.scrollTo({ top: 0 });

package/dist/packages/core/src/utils/phonemeConvert.d.ts

@@ -15,4 +15,11 @@ export declare const VOWEL_TO_PHONEME: Record<string, {
 export declare function vowelGlidesDiffer(a: string, b: string): boolean;
 /** 종성 글자 → 음소(대표음) 변환. 매핑에 없으면 원본 유지. */
 export declare function finalToPhoneme(jong: string): string;
+/**
+ * 고른 글자를 음소 꼴로 — **열쇠는 코드로 낸다**(`onset`·`vowel`·`coda`·`glide`).
+ *
+ * **들어오는 것은 둘 다 받는다** — 저장된 단어표의 고른값은 옛 한글 열쇠(`{ 초성: 'ㄴ' }`)일
+ * 수 있다(2026-10-13 코드로 옮기며, 저장된 표를 밀지 않으려고 읽는 쪽을 너그럽게 뒀다).
+ * 값(자모·`'ㄴ'`)은 한국어 글자 그 자체라 그대로 둔다 — 바꿀 것은 **열쇠와 빔 값**이다.
+ */
 export declare function convertToPhoneme(sel: Record<string, string>): Record<string, string>;

package/dist/packages/core/src/utils/phonemeConvert.js

@@ -1,3 +1,4 @@
+import { toPhonemeCodes, PHONEME_NONE } from './phonemeSectionCodes';
 export const VALID_GLIDES = {
     ㅏ: ['j', 'w'], ㅓ: ['j', 'w'], ㅗ: ['j'], ㅜ: ['j'],
     'ㅔ/ㅐ': ['j', 'w'], ㅣ: ['w', 'ɰ'], ㅡ: [],
@@ -44,21 +45,29 @@ export function vowelGlidesDiffer(a, b) {
 export function finalToPhoneme(jong) {
     return JONGSEONG_TO_PHONEME[jong] ?? jong;
 }
+/**
+ * 고른 글자를 음소 꼴로 — **열쇠는 코드로 낸다**(`onset`·`vowel`·`coda`·`glide`).
+ *
+ * **들어오는 것은 둘 다 받는다** — 저장된 단어표의 고른값은 옛 한글 열쇠(`{ 초성: 'ㄴ' }`)일
+ * 수 있다(2026-10-13 코드로 옮기며, 저장된 표를 밀지 않으려고 읽는 쪽을 너그럽게 뒀다).
+ * 값(자모·`'ㄴ'`)은 한국어 글자 그 자체라 그대로 둔다 — 바꿀 것은 **열쇠와 빔 값**이다.
+ */
 export function convertToPhoneme(sel) {
+    const coded = toPhonemeCodes(sel);
     const result = {};
-    if (sel['초성'])
-        result['초성'] = sel['초성'];
-    if (sel['모음']) {
-        const m = VOWEL_TO_PHONEME[sel['모음']];
-        // 활음을 항상 명시한다('없음' 포함). 단어 분해(decomposePhonemicSyllable)는 활음 없는 모음에도
-        // 활음:'없음'을 넣으므로, 선택 변환도 대칭으로 맞춰야 활음 대비(예: ㅐ↔ㅙ = 없음↔w)가 매칭된다.
+    if (coded.onset)
+        result.onset = coded.onset;
+    if (coded.vowel) {
+        const m = VOWEL_TO_PHONEME[coded.vowel];
+        // 활음을 항상 명시한다(빔 포함). 단어 분해(decomposePhonemicSyllable)는 활음 없는 모음에도
+        // glide: 빔을 넣으므로, 선택 변환도 대칭으로 맞춰야 활음 대비(예: ㅐ↔ㅙ = 빔↔w)가 매칭된다.
         // (안 넣으면 ㅐ/ㅔ↔ㅚ/ㅙ 대립이 모음(nucleus)만 같고 대비 섹션이 없어 0건이 됨.)
         if (m) {
-            result['모음'] = m.nucleus;
-            result['활음'] = m.glide ?? '없음';
+            result.vowel = m.nucleus;
+            result.glide = m.glide ?? PHONEME_NONE;
         }
     }
-    if (sel['종성'])
-        result['종성'] = JONGSEONG_TO_PHONEME[sel['종성']] ?? sel['종성'];
+    if (coded.coda)
+        result.coda = JONGSEONG_TO_PHONEME[coded.coda] ?? coded.coda;
     return result;
 }

package/dist/packages/core/src/utils/phonemeGroups.js

@@ -50,8 +50,8 @@ export function phoneticLabel(t, f) {
     return f.glide ? `${v} · ${GLIDE_LABEL[f.glide](t)}` : v;
 }
 /** 기본값만 돌려주는 t — 옛 `tooltip`(한국어 고정)을 같은 표에서 만들어 두 글이 갈라지지 않게 한다. */
-const 한국어 = (_key, { defaultValue }) => defaultValue;
-const item = (jamos, phonetic) => ({ jamos, phonetic, tooltip: phoneticLabel(한국어, phonetic) });
+const koTranslate = (_key, { defaultValue }) => defaultValue;
+const item = (jamos, phonetic) => ({ jamos, phonetic, tooltip: phoneticLabel(koTranslate, phonetic) });
 /** 자음 행: 같은 조음 위치를 공유하는 단일 자모 버튼들. */
 const consonantRow = (place, jamos) => jamos.map(j => item([j], { place }));
 /** 모음/병합 아이템: `chars`가 여러 글자면 동음 병합 버튼(예: 'ㅔㅐ' → ['ㅔ','ㅐ']). */

package/dist/packages/core/src/utils/phonemePairSearch.d.ts

@@ -1,5 +1,6 @@
 export type { WordEntry, PairFilterKeys, SearchPairsDebugReport } from './phonemePairSearchTypes';
 import type { WordSearchResultItem } from '../types/wordSearch';
+export { toPhonemeCodes, PHONEME_NONE, type PhonemeSectionCode } from './phonemeSectionCodes';
 import type { WordEntry } from './phonemePairSearchTypes';
 import type { PairFilterKeys } from './phonemePairSearchTypes';
 /** applyFilters/matchesFilters가 공통으로 판정하는 필드 — WordEntry와 WordSearchResultWord