@ihabdevteam/core 0.149.0 → 0.151.0

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

@@ -16,7 +16,9 @@ export declare const hasSel: (v: string | string[] | null | undefined) => boolea
  * 두 (표준발음) 분해배열 A·B가 '음절 구조'에서 달라지는 자리가 있는지.
  * 초성 ㅇ(무음)은 '초성 없음', 종성 0은 '받침 없음'(둘 다 구조상 '비움')으로 본다.
  * 어떤 자리에서 초성 ㅇ 유무 또는 받침 유무가 뒤바뀌면, 자음 '교체'가 아니라 음절 '구조' 차이이므로
- * 청각 변별 오답으로 부적절 → true(제외 대상). 자음↔자음, 모음↔모음 교체는 false.
+ * 청각 변별 오답으로 부적절 → true(제외 대상). 자음↔자음 교체는 false.
+ * 모음은 **활음이 갈리면**(ㅏ↔ㅘ·ㅐ↔ㅙ·ㅑ↔ㅘ) 구조 차이, 활음이 같으면(ㅏ↔ㅓ·ㅑ↔ㅕ) 모음 교체라 false —
+ * 대립쌍 표('음소 구조 같은 단어만', phonemePairSearch)와 같은 함수(vowelGlidesDiffer)로 판정한다.
  */
 export declare function hasStructureContrast(A: Decomp, B: Decomp): boolean;
 /** 표준발음 기준 오답 필터에 필요한 의존성 */
@@ -27,7 +29,7 @@ export interface ContrastFilterOpts {
     pronOf: (w: string) => string;
     /** 표준발음 문자열 → 음절 분해(캐시 권장). sameStructureOnly일 때만 필요. */
     decompOf?: (pron: string) => Decomp;
-    /** true면 구조 대립(초성 ㅇ 유무·받침 유무)도 제외(decompOf 필요). */
+    /** true면 구조 대립(초성 ㅇ 유무·활음 유무·종류·받침 유무)도 제외(decompOf 필요). */
     sameStructureOnly?: boolean;
 }
 /**

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

@@ -7,6 +7,7 @@
  * - buildMultiPartPosContrast: 초성/모음/종성 선택 시 '선택 위치 대립' 오답 사전계산.
  */
 import { CHOSEONG, JUNGSEONG, JONGSEONG } from './koreanSyllable';
+import { vowelGlidesDiffer } from './phonemeConvert';
 /** 파트 인덱스 → 자모 배열 (이 파일 내부 전용) */
 const PART_ARR = { cho: CHOSEONG, jung: JUNGSEONG, jong: JONGSEONG };
 /** 선택 값(단일/배열)이 실제로 지정됐는지 */
@@ -15,7 +16,9 @@ export const hasSel = (v) => (Array.isArray(v) ? v.length > 0 : !!v);
  * 두 (표준발음) 분해배열 A·B가 '음절 구조'에서 달라지는 자리가 있는지.
  * 초성 ㅇ(무음)은 '초성 없음', 종성 0은 '받침 없음'(둘 다 구조상 '비움')으로 본다.
  * 어떤 자리에서 초성 ㅇ 유무 또는 받침 유무가 뒤바뀌면, 자음 '교체'가 아니라 음절 '구조' 차이이므로
- * 청각 변별 오답으로 부적절 → true(제외 대상). 자음↔자음, 모음↔모음 교체는 false.
+ * 청각 변별 오답으로 부적절 → true(제외 대상). 자음↔자음 교체는 false.
+ * 모음은 **활음이 갈리면**(ㅏ↔ㅘ·ㅐ↔ㅙ·ㅑ↔ㅘ) 구조 차이, 활음이 같으면(ㅏ↔ㅓ·ㅑ↔ㅕ) 모음 교체라 false —
+ * 대립쌍 표('음소 구조 같은 단어만', phonemePairSearch)와 같은 함수(vowelGlidesDiffer)로 판정한다.
  */
 export function hasStructureContrast(A, B) {
     if (A.length !== B.length)
@@ -26,6 +29,9 @@ export function hasStructureContrast(A, B) {
             continue;
         if (sa.cho !== sb.cho && (CHOSEONG[sa.cho] === 'ㅇ') !== (CHOSEONG[sb.cho] === 'ㅇ'))
             return true;
+        /* 전에는 초성 ㅇ·받침만 봐, 대립쌍 표에서는 '구조가 달라' 빠지는 사↔솨 가 같은 '음소 구조 같은 단어만' 훈련에서 오답으로 나왔다 */
+        if (sa.jung !== sb.jung && vowelGlidesDiffer(JUNGSEONG[sa.jung], JUNGSEONG[sb.jung]))
+            return true;
         if (sa.jong !== sb.jong && (sa.jong === 0) !== (sb.jong === 0))
             return true;
     }
@@ -188,7 +194,7 @@ position) {
                     }
                     if (!good)
                         continue;
-                    // 구조(초성 ㅇ 유무·받침 유무) 대립 제외 — 발음 분해 기준
+                    // 구조(초성 ㅇ 유무·활음·받침 유무) 대립 제외 — 발음 분해 기준
                     if (!(sameStructureOnly && hasStructureContrast(A.dPron, D.dPron)))
                         dists.push(D.w);
                 }

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

@@ -24,7 +24,9 @@ export declare function mergeQuestionText(parts: string[], phoneme?: boolean): s
  */
 export declare function getMergeCardTitle(typeKey: string | undefined, parts: string[]): string;
 /**
- * @public 바꾸기(대치) 카드 질문 문장 — 러너·프리워밍 공용. item의 word/changedFrom/changedTo로 구성.
+ * @public 바꾸기(대치) 카드 질문 문장 — 러너·프리워밍 공용.
+ * 음소 바꾸기(1·2음절)는 바뀌는 음소를 말한다(`"옆"에서 모음 "ㅕ"를 "ㅞ"로 바꾸면…`, `"사과"의 "과"에서 초성 "ㄱ"을 "ㅎ"으로…`,
+ * 받침이 생기면 `"가"에 받침 "ㄴ"을 더하면…`). 음절 바꾸기는 음절을 말한다. item의 word/changedFrom/changedTo로 구성.
  * 프리워밍이 만든 문장이 러너 재생 문장과 문자 단위로 같아야 캐시 키가 일치하므로 반드시 이 함수를 공유한다.
  */
 export declare function getChangeCardTitle(typeKey: string | undefined, item: Record<string, unknown>): string;
@@ -92,7 +94,8 @@ export declare function buildDropContrastProblem(word: string, comp: Composition
 export declare function buildDropContrast3Problem(word: string, comp: CompositionFilter | null, pronMap: Map<string, string>, phonemeView: 'char' | 'pron', wordSet: Set<string>, dropPos?: number | null): TrainingProblem | null;
 /**
  * @public 합성어 부분 탈락 → [문제단어(합성어), 남는 실단어(정답), 그 단어의 대립쌍 실단어 오답 2].
- * 합성어 근사: 앞/뒤로 나눈 두 조각이 '둘 다 실단어'(wordSet)인 첫 조합을 채택(예: 손수건=손+수건).
+ * 합성어 근사: 앞/뒤로 나눈 두 조각이 '둘 다 실단어'(wordSet)이고 **적어도 한 조각이 2음절 이상**인 조합을 채택(예: 손수건=손+수건).
+ * 1음절 조각 둘(하품=하+품)은 합성어로 보지 않는다 — 그래서 2음절 낱말은 늘 null.
  * 정답·오답 전부 실단어라 발음이 그대로. comp(훈련음소) 지정 시 남는 단어의 그 자리를 대립, 없으면 전 음절.
  * dropPos: 0=어두 어근(앞) 탈락, 1=어말 어근(뒤) 탈락. 결과의 `dropped` 에 뺀 조각을 담는다. 편집기·런타임 공용.
  */

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

@@ -98,14 +98,59 @@ export function mergeQuestionText(parts, phoneme = false) {
 export function getMergeCardTitle(typeKey, parts) {
     return mergeQuestionText(parts, typeKey === 'MERGE_2_PHONEMES' || typeKey === 'MERGE_3_PHONEMES');
 }
+/** 조사를 붙일 때 읽는 꼴 — 자모면 낱자 이름(ㅂ→비읍), 아니면 그대로 */
+const josaBaseOf = (x) => JAMO_NAME[x] ?? x;
+const PART_LABEL = { cho: '초성', jung: '모음', jong: '받침' };
 /**
- * @public 바꾸기(대치) 카드 질문 문장 — 러너·프리워밍 공용. item의 word/changedFrom/changedTo로 구성.
+ * 두 음절 사이에서 바뀐 음소 하나. 철자로 한 자리만 다르면 그 자리, 아니면 끝소리 규칙 발음([옆→엽]↔[웹])으로 한 자리만
+ * 다르면 그 자리. 받침이 생기거나 없어지면 add·remove. 둘 이상이 다르면 null(음소 하나로 말할 수 없다).
+ */
+function changedPhonemeOf(a, b) {
+    const diffOf = (x, y) => {
+        const sx = [...x].length === 1 ? parseSyllable(x) : null;
+        const sy = [...y].length === 1 ? parseSyllable(y) : null;
+        if (!sx || !sy)
+            return null;
+        const parts = ['cho', 'jung', 'jong'].filter(p => sx[p] !== sy[p]);
+        return parts.length === 1 ? { part: parts[0], sx, sy } : null;
+    };
+    const d = diffOf(a, b) ?? diffOf(syllablePron(a), syllablePron(b));
+    if (!d)
+        return null;
+    const arr = d.part === 'cho' ? CHOSEONG : d.part === 'jung' ? JUNGSEONG : JONGSEONG;
+    const from = arr[d.sx[d.part]], to = arr[d.sy[d.part]];
+    const kind = d.part === 'jong' && !from ? 'add' : d.part === 'jong' && !to ? 'remove' : 'swap';
+    return { part: d.part, from, to, kind };
+}
+/**
+ * @public 바꾸기(대치) 카드 질문 문장 — 러너·프리워밍 공용.
+ * 음소 바꾸기(1·2음절)는 바뀌는 음소를 말한다(`"옆"에서 모음 "ㅕ"를 "ㅞ"로 바꾸면…`, `"사과"의 "과"에서 초성 "ㄱ"을 "ㅎ"으로…`,
+ * 받침이 생기면 `"가"에 받침 "ㄴ"을 더하면…`). 음절 바꾸기는 음절을 말한다. item의 word/changedFrom/changedTo로 구성.
  * 프리워밍이 만든 문장이 러너 재생 문장과 문자 단위로 같아야 캐시 키가 일치하므로 반드시 이 함수를 공유한다.
  */
 export function getChangeCardTitle(typeKey, item) {
     const word = String(item?.word ?? item?.original ?? '');
     const changedFrom = String(item?.changedFrom ?? '');
     const changedTo = String(item?.changedTo ?? '');
+    /* 음소 바꾸기는 **바뀌는 음소**를 말한다 — 전에는 바뀐 음절을 말해 1음절은 "'옆'을 '웹'으로 바꾸면" 이 곧 정답이었고,
+       2음절도 새 음절을 불러 줘 음소를 다룰 일이 없었다. 음소 하나로 설명이 안 되는 자료(옛 저장 문제 등)는 전 문장으로 물러선다. */
+    if (typeKey === 'CHANGE_1_PHONEME_IN_1SYLL' || typeKey === 'CHANGE_1_PHONEME_IN_2SYLL') {
+        const one = typeKey === 'CHANGE_1_PHONEME_IN_1SYLL';
+        const from = one ? (changedFrom || word) : changedFrom;
+        const change = changedPhonemeOf(from, changedTo);
+        if (change) {
+            // 1음절: "옆"에서 … / 2음절: "사과"의 "과"에서 …  ('더하면'은 에서 대신 에)
+            const head = one ? `"${word}"` : `"${word}"의 "${from}"`;
+            const 곳 = change.kind === 'add' ? '에' : '에서';
+            const f = `"${change.from}"${josaEulReul(josaBaseOf(change.from))}`;
+            const t = `"${change.to}"${josaEuRo(josaBaseOf(change.to))}`;
+            if (change.kind === 'add')
+                return `${head}${곳} 받침 "${change.to}"${josaEulReul(josaBaseOf(change.to))} 더하면 무엇이 되나요?`;
+            if (change.kind === 'remove')
+                return `${head}${곳} 받침 ${f} 빼면 무엇이 되나요?`;
+            return `${head}${곳} ${PART_LABEL[change.part]} ${f} ${t} 바꾸면 무엇이 되나요?`;
+        }
+    }
     if (typeKey === 'CHANGE_1_PHONEME_IN_1SYLL') {
         // 1음절 단어 전체가 바뀌는 케이스 — "에서 X를" 없이 단순 표현
         return `"${word}"${josaEulReul(word)} "${changedTo}"${josaEuRo(changedTo)} 바꾸면 무엇이 되나요?`;
@@ -365,7 +410,8 @@ export function buildDropContrast3Problem(word, comp, pronMap, phonemeView, word
 }
 /**
  * @public 합성어 부분 탈락 → [문제단어(합성어), 남는 실단어(정답), 그 단어의 대립쌍 실단어 오답 2].
- * 합성어 근사: 앞/뒤로 나눈 두 조각이 '둘 다 실단어'(wordSet)인 첫 조합을 채택(예: 손수건=손+수건).
+ * 합성어 근사: 앞/뒤로 나눈 두 조각이 '둘 다 실단어'(wordSet)이고 **적어도 한 조각이 2음절 이상**인 조합을 채택(예: 손수건=손+수건).
+ * 1음절 조각 둘(하품=하+품)은 합성어로 보지 않는다 — 그래서 2음절 낱말은 늘 null.
  * 정답·오답 전부 실단어라 발음이 그대로. comp(훈련음소) 지정 시 남는 단어의 그 자리를 대립, 없으면 전 음절.
  * dropPos: 0=어두 어근(앞) 탈락, 1=어말 어근(뒤) 탈락. 결과의 `dropped` 에 뺀 조각을 담는다. 편집기·런타임 공용.
  */
@@ -383,6 +429,10 @@ export function buildDropCompoundProblem(word, comp, pronMap, phonemeView, wordS
     for (const { remain, dropped, droppedEnd } of shuffled(candidates)) {
         if (dropPos != null && droppedEnd !== dropPos)
             continue; // 위치(삭제할 어근) 지정 시 그 끝만.
+        /* 1음절 조각 둘은 합성어로 보지 않는다 — 두 글자가 우연히 모두 낱말이면(하품 = 하 + 품, 바지 = 바 + 지) 합성어로 읽어
+           "하품에서 품이 없어지면" 을 냈다. 2음절 이상 조각이 하나는 있어야 한다(손수건 = 손 + 수건). 자료에 합성어 표시가 없어 근사다. */
+        if ([...remain].length === 1 && [...dropped].length === 1)
+            continue;
         if (remain === word || !wordSet.has(remain) || !wordSet.has(dropped))
             continue;
         const rChars = [...remain];

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

@@ -251,7 +251,7 @@ async function _buildUsablePool(opts) {
     const { difficulty = null, choseong = null, composition = null, targetSyllable = null, excludeNoImage = false } = opts;
     // 난이도 등급('1'~'4') 필터 — 정답(후보) 단어에만 적용(구성 필터와 동일 원칙, 오답 풀은 무관)
     const gradeSet = opts.grade && opts.grade.length > 0 ? new Set(opts.grade) : null;
-    // 음소 구조 같은 단어만(초성 ㅇ 유무·받침 유무 대립 제외) — 기본 true
+    // 음소 구조 같은 단어만(초성 ㅇ 유무·활음·받침 유무 대립 제외) — 기본 true
     const sameStructureOnly = opts.sameStructureOnly ?? true;
     // 음소 선택 방식 — 정답 검색 기준(글자입력=철자 / 발음입력=발음). 대립 비교는 두 모드 모두 발음.
     const phonemeView = opts.phonemeView === 'pron' ? 'pron' : 'char';
@@ -475,7 +475,7 @@ async function _buildUsablePool(opts) {
                 usable = fallbackSample.filter(other => other !== w.w && classifyPairDifficulty(w.w, other) === difficulty && pronOfWord(other) !== wPron);
             }
         }
-        // 음절 구조 대립(초성 ㅇ 유무·받침 유무) 제외 — 자음/모음 '교체'가 아닌 구조 차이는 청각 변별 오답으로 부적절.
+        // 음절 구조 대립(초성 ㅇ 유무·활음·받침 유무) 제외 — 자음/모음 '교체'가 아닌 구조 차이는 청각 변별 오답으로 부적절.
         // '음소 구조 같은 단어만'(sameStructureOnly)일 때만. posContrast 는 buildMultiPartPosContrast 안에서 적용. random/null 제외.
         if (sameStructureOnly && usable.length > 0 && (isTyped || (isCount && !posContrast))) {
             const wPronDecomp = decompOf(pronOfWord(w.w));

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

@@ -15,7 +15,7 @@ import { getPairIndex } from './wordPairIndex';
 import { wordContainsPhoneme, syllableLength, parseSyllable, CHOSEONG, JUNGSEONG, JONGSEONG, JONG_DECOMPOSE } from './koreanSyllable';
 export { CAPABILITY, cardGroupOf, isValidQuestionWord, hasQuestionWordConstraint, isManualOnlyType, QUESTION_WORD_RULE, MANUAL_ONLY_TYPES } from './wordTrainingRuntimeTypes';
 import { CAPABILITY, QUESTION_WORD_RULE } from './wordTrainingRuntimeTypes';
-import { buildDropContrastProblem, buildDropContrast3Problem, buildDropCompoundProblem, buildDropFinalConsonantProblem, buildRemoveConsonantProblem, buildChangeWholeSyllableProblem, buildSyllableMaskIndex } from './wordTrainingGenerators';
+import { buildDropContrastProblem, buildDropContrast3Problem, buildDropCompoundProblem, buildDropFinalConsonantProblem, buildRemoveConsonantProblem, buildChangeWholeSyllableProblem, buildSyllableMaskIndex, primarySelPart, syllMatchesComp } from './wordTrainingGenerators';
 /* 재료 고르기(풀 추리기·캐시·오답 샘플링)는 wordTrainingPool 로 갈라 두었다. */
 import { MVP, buildUsablePool, filterByCachedImage, getPronMap, nextId, pickOne, sample, sampleDistinctPron, _poolCacheKey, _EMPTY_SET, answerWordFilter, pronOfWord, } from './wordTrainingPool';
 // ────────────────────────────────────────────────────────────────────────────
@@ -60,6 +60,7 @@ async function genIncluded(opts) {
     const allPool = (await buildUsablePool({ ...opts, difficulty: null }));
     if (allPool.length < choicesPerItem)
         return [];
+    const comp = opts.composition ?? null;
     const results = [];
     const candidates = shuffle([...allPool]);
     for (const entry of candidates) {
@@ -70,7 +71,12 @@ async function genIncluded(opts) {
         // '맏이(마지)'에서 '맏'이 나와 실제로는 들리지 않는 소리를 문제로 내게 된다. 표준발음에서 뽑는다.
         const pron = entry.word.pron || word;
         const syllables = [...pron]; // 한 글자 = 한 음절
-        const targetSyllable = pickOne(syllables);
+        /* 음소를 골랐으면 **그 음소를 가진 음절**을 들려준다 — 전에는 아무 음절이나 골라 초성 ㄱ 을 골라도 '가방' 의 '방' 을
+           들려주었다(고른 음소와 무관한 훈련). 들리는 음절(발음)에 그 음소가 없으면 전처럼 아무 음절. */
+        const 고른음절 = comp && primarySelPart(comp)
+            ? syllables.filter(s => { const p = parseSyllable(s); return !!p && syllMatchesComp(p, comp); })
+            : [];
+        const targetSyllable = pickOne(고른음절.length ? 고른음절 : syllables);
         if (!targetSyllable)
             continue;
         // 오답: targetSyllable이 발음에 포함되지 않고, 정답과 음절수(글자수)가 같으며, 발음이 다른 단어.
@@ -426,8 +432,9 @@ async function genDrop1From3Syll(opts) {
 /** DROP_PART_FROM_COMPOUND — 합성어(앞/뒤 조각이 둘 다 실단어)에서 한 어근 탈락. 편집기와 동일 코어 빌더 사용. */
 async function genDropCompound(opts) {
     const { count = 10 } = opts;
-    // 합성어 후보 — 2음절 이상. 훈련음소는 선택적(있으면 남는 단어의 그 자리를 대립으로 좁힘).
-    const pool = (await buildUsablePool({ ...opts })).filter(e => e.word.s >= 2);
+    // 합성어 후보 — 3음절 이상. 훈련음소는 선택적(있으면 남는 단어의 그 자리를 대립으로 좁힘).
+    // 2음절 낱말은 1음절 조각 둘로만 나뉘어 합성어가 될 수 없다(buildDropCompoundProblem) — 3음절부터
+    const pool = (await buildUsablePool({ ...opts })).filter(e => e.word.s >= 3);
     const pronMap = getPronMap();
     const wordSet = 탈락낱말집합(opts);
     const phonemeView = opts.phonemeView ?? 'char';
@@ -497,15 +504,16 @@ function realWordsOfLen(N, opts, pred) {
     }
     return out;
 }
-/** MERGE_2_PHONEMES — 초성+모음 합쳐 1음절(받침 없음). 실단어 데이터 기반 */
+/** MERGE_2_PHONEMES — 초성+모음 합쳐 1음절(받침 없음·초성이 소리 있는 자음). 실단어 데이터 기반 */
 function genMerge2Phonemes(opts) {
-    const pool = realWordsOfLen(1, opts, s => s.jong === 0);
+    // 편집기 검증과 같은 규칙 한 벌(QUESTION_WORD_RULE) — 초성 ㅇ(소리 없음)은 합칠 음소가 아니라 뺀다
+    const pool = realWordsOfLen(1, opts, QUESTION_WORD_RULE.MERGE_2_PHONEMES.syllable);
     return sample(pool, opts.count ?? 10).map((e, i) => {
         const s = parseSyllable(e.w);
         return { id: nextId('M2P-item'), index: i + 1, parts: [CHOSEONG[s.cho], JUNGSEONG[s.jung]], answer: e.w, word: e.w };
     });
 }
-/** MERGE_3_PHONEMES — 초성+모음+종성 합쳐 1음절(홑받침). 실단어 데이터 기반 */
+/** MERGE_3_PHONEMES — 초성+모음+종성 합쳐 1음절(홑받침·초성이 소리 있는 자음). 실단어 데이터 기반 */
 function genMerge3Phonemes(opts) {
     // 홑받침만(겹받침은 음소 2개라 '3음소'가 아니게 됨) — 편집기 검증과 같은 규칙 한 벌(QUESTION_WORD_RULE)
     const pool = realWordsOfLen(1, opts, QUESTION_WORD_RULE.MERGE_3_PHONEMES.syllable);

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

@@ -35,7 +35,7 @@ export interface GenOptions {
      */
     excludeNoImage?: boolean;
     /**
-     * true(기본) 이면 오답이 정답과 '음절 구조'(초성 ㅇ 유무·받침 유무)가 같은 단어만 되도록 강제.
+     * true(기본) 이면 오답이 정답과 '음절 구조'(초성 ㅇ 유무·활음(ㅏ↔ㅘ)·받침 유무)가 같은 단어만 되도록 강제(대립쌍 표와 같은 정의).
      * false 이면 구조가 다른 대립(예: 발↔알, 파↔판)도 오답으로 허용.
      */
     sameStructureOnly?: boolean;

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

@@ -47,11 +47,12 @@ export const QUESTION_WORD_RULE = {
     MERGE_2_SYLLABLES: { syllables: 2, syllable: () => true },
     // 음절 3개 합치기: 정답 단어가 항상 3음절이어야 함(genMerge3Syllables와 동일 제약)
     MERGE_3_SYLLABLES: { syllables: 3, syllable: () => true },
-    // 음소 2개 합치기(초성+중성): 정답은 받침 없는 1음절(CV) — genMerge2Phonemes(s.jong===0)와 동일 제약
-    MERGE_2_PHONEMES: { syllables: 1, syllable: s => s.jong === 0 },
+    // 음소 2개 합치기(초성+중성): 정답은 받침 없는 1음절(CV) — genMerge2Phonemes 가 이 규칙을 쓴다.
+    // 초성 ㅇ 은 소리가 없어 합칠 음소가 아니다 — 전에는 '아' 를 "ㅇ과 ㅏ를 합치면" 으로 냈다(실제로는 음소 하나). 뺀다.
+    MERGE_2_PHONEMES: { syllables: 1, syllable: s => s.jong === 0 && s.cho !== _IEUNG_CHO },
     // 음소 3개 합치기(초성+중성+종성): 정답은 **홑받침** 1음절(CVC) — 겹받침(닭·값)은 음소 넷이라 뺀다(genMerge3Phonemes 가 이 규칙을 쓴다).
-    // 전에는 편집기가 '닭' 을 받아 "ㄷ, ㅏ, ㄺ 을 합치면" 을 냈다.
-    MERGE_3_PHONEMES: { syllables: 1, syllable: s => s.jong > 0 && !JONG_DECOMPOSE[s.jong] },
+    // 전에는 편집기가 '닭' 을 받아 "ㄷ, ㅏ, ㄺ 을 합치면" 을 냈다. 초성 ㅇ('앙' = 음소 둘)도 2개 합치기와 같은 까닭으로 뺀다.
+    MERGE_3_PHONEMES: { syllables: 1, syllable: s => s.jong > 0 && !JONG_DECOMPOSE[s.jong] && s.cho !== _IEUNG_CHO },
 };
 /** @public 자동 문제생성이 불가하고 수동 구성만 지원하는 타입. 현재는 없음.
  *  (합성어 부분 탈락은 앞/뒤 조각이 모두 실단어인 합성어를 휴리스틱으로 자동 추천 — buildDropCompoundProblem.) */

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

@@ -0,0 +1,12 @@
+/**
+ * 기기 착용일(연·월·일 세 칸) 을 글자로 — 표(DeviceSideTable)·패널(PanelRowDevice)·HearingDeviceInfo 가 함께 쓴다.
+ *
+ * 타입은 문자열이지만 서버에서는 **월·일이 null 로 오기도 한다**(연도만 적은 옛 기록). 그대로 끼우면 화면에
+ * `2026.null.null` 이 찍혔고, 정렬 열쇠를 만들 때는 `null.padStart` 에서 표가 통째로 터졌다. 빈 값은 '' 로 다룬다.
+ */
+type 칸값 = string | number | null | undefined;
+/** 화면에 적을 착용일 — `2026.05.02`. 뒤쪽 빈 칸은 떼고(`2026`), 전부 비면 ''. */
+export declare function formatWornDate(year: 칸값, month: 칸값, day: 칸값): string;
+/** 착용일 정렬 열쇠 — 자리수를 채워(`2026-05-02`) 글자 비교가 날짜 차례와 같게. 연도가 없으면 ''. */
+export declare function wornDateSortKey(year: 칸값, month: 칸값, day: 칸값): string;
+export {};

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

@@ -0,0 +1,15 @@
+const 글자 = (v) => (v == null ? '' : String(v).trim());
+/** 화면에 적을 착용일 — `2026.05.02`. 뒤쪽 빈 칸은 떼고(`2026`), 전부 비면 ''. */
+export function formatWornDate(year, month, day) {
+    const 조각 = [글자(year), 글자(month), 글자(day)];
+    while (조각.length > 0 && 조각[조각.length - 1] === '')
+        조각.pop();
+    return 조각.join('.');
+}
+/** 착용일 정렬 열쇠 — 자리수를 채워(`2026-05-02`) 글자 비교가 날짜 차례와 같게. 연도가 없으면 ''. */
+export function wornDateSortKey(year, month, day) {
+    const y = 글자(year);
+    if (!y)
+        return '';
+    return `${y}-${글자(month).padStart(2, '0')}-${글자(day).padStart(2, '0')}`;
+}

package/dist/packages/core/src/version.d.ts

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.149.0";
+export declare const CORE_VERSION = "0.151.0";

package/dist/packages/core/src/version.js

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export const CORE_VERSION = '0.149.0';
+export const CORE_VERSION = '0.151.0';