@ihabdevteam/core 0.146.0 → 0.148.0

package/dist/packages/core/src/components/Word/wordTablePrint.js

@@ -105,7 +105,14 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
            아무도 opacity 를 되돌리지 않아 **빈칸으로 인쇄**되고, 새 창·내려받은 HTML 에서는 스피너가 영영 돈다(말귀 내 단어표
            '인쇄' 는 열자마자 100ms 뒤 인쇄해 처음 보는 표는 거의 늘 이랬다). */
         clone.querySelectorAll('.word-table-cell__spinner').forEach(s => s.remove());
-        clone.querySelectorAll('img').forEach(i => i.style.removeProperty('opacity'));
+        /* 불러오는 중이던 그림은 opacity 를 **그대로 두고** 받아지면 보이고 실패하면 숨게 한다 — 지우기만 하면 없는 그림(404, 화면에서는
+           onError 로 칸이 사라짐)이 인쇄 문서에서 깨진 그림 아이콘과 alt 글자로 찍혔다. autoPrint 는 그림 로드를 기다린 뒤 인쇄한다. */
+        clone.querySelectorAll('img').forEach(i => {
+            if (i.style.opacity !== '0')
+                return;
+            i.setAttribute('onload', "this.style.opacity=''");
+            i.setAttribute('onerror', "this.style.visibility='hidden'");
+        });
         return `<div class="paper-wrap">${headHtml}${clone.outerHTML}</div>`;
     }).join('\n');
     /* 이 꾸러미의 CSS 는 전부 `.ihabdevteam-core-scope` **아래**에 산다(styles.css 스코핑).

package/dist/packages/core/src/hooks/useDailyTrainingSelection.js

@@ -45,6 +45,8 @@ export function useDailyTrainingSelection(userId) {
     }, []);
     useEffect(() => {
         let cancelled = false;
+        let 떠남 = false;
+        let 적용됨 = false;
         let timer;
         let attempts = 0;
         const MAX_ATTEMPTS = 40; // 250ms * 40 = 10초 후 폴링 중단(풀이 영영 비는 경우 무한루프 방지)
@@ -60,6 +62,9 @@ export function useDailyTrainingSelection(userId) {
         }
         catch { }
         const apply = (sel) => {
+            if (떠남)
+                return;
+            적용됨 = true;
             todayRef.current = sel.today;
             yesterdayRef.current = sel.yesterday;
             setLoaded(true);
@@ -79,13 +84,16 @@ export function useDailyTrainingSelection(userId) {
                     return;
                 }
             }
-            // 캐시 miss → 데이터 로드 후 새 선택
-            try {
-                await ensureTrainingDataLoaded(3000);
+            /* 캐시 miss → 데이터 로드 후 새 선택. 로드는 **2초마다 한 번만** 다시 청한다 — 250ms 마다 부르면 받기가 곧바로 실패하는
+               배포(형식 오류)에서 10초에 850KB 자료를 40번 받았다. 그 사이 폴링은 선택만 다시 계산한다. */
+            if (attempts % 8 === 0) {
+                try {
+                    await ensureTrainingDataLoaded(3000);
+                }
+                catch { }
+                if (cancelled)
+                    return;
             }
-            catch { }
-            if (cancelled)
-                return;
             const sel = resolveSelection(forceRefresh, undefined, userId);
             if (hasItems(sel.today)) {
                 apply(sel);
@@ -101,9 +109,29 @@ export function useDailyTrainingSelection(userId) {
                 stop();
             }
         };
+        /* 포기한 뒤(10초)라도 자료가 도착하면 다시 계산한다 — 느린 회선에서 13초 걸려 받은 회원은 새로고침 전까지 "자료를 못 찾음" 에 남았다 */
+        const 자료도착 = () => {
+            if (떠남 || 적용됨)
+                return;
+            const sel = resolveSelection(forceRefresh, undefined, userId);
+            if (hasItems(sel.today))
+                apply(sel);
+        };
+        try {
+            window.addEventListener('speechear.data.updated', 자료도착);
+        }
+        catch { }
         tryFill();
         timer = setInterval(tryFill, 250);
-        return () => { cancelled = true; stop(); };
+        return () => {
+            cancelled = true;
+            떠남 = true;
+            stop();
+            try {
+                window.removeEventListener('speechear.data.updated', 자료도착);
+            }
+            catch { }
+        };
         // 오늘 은 날짜가 바뀌었다는 신호 — resolveSelection 이 안에서 오늘 날짜를 읽는다
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [userId, 오늘]);

package/dist/packages/core/src/hooks/useTrainingSessionLog.d.ts

@@ -1,6 +1,9 @@
 /**
- * 훈련 팝업 마운트~언마운트 시간을 기록합니다.
- * 5초 미만 세션(잘못 열었다 닫은 경우)은 무시합니다.
+ * 훈련 팝업을 **보고 있던** 시간을 기록합니다.
+ * 보인 시간이 5초 미만(잘못 열었다 닫은 경우)이면 무시합니다.
+ *
+ * 한 팝업에 **한 줄** 만 보냅니다 — 떠날 때, 또는 페이지가 내려갈 때(pagehide: 팝업을 연 채 탭·앱을 닫음). 화면이 가려진
+ * 동안(탭 전환·앱 백그라운드)의 시간은 빼고 모읍니다 — 전에는 연 채 3시간 잠가 둔 시간이 훈련 시간으로 적혔다.
  *
  * @public
  */

package/dist/packages/core/src/hooks/useTrainingSessionLog.js

@@ -2,8 +2,11 @@
 import { useEffect } from 'react';
 import { logTrainingTime } from '../utils/trainingLogger';
 /**
- * 훈련 팝업 마운트~언마운트 시간을 기록합니다.
- * 5초 미만 세션(잘못 열었다 닫은 경우)은 무시합니다.
+ * 훈련 팝업을 **보고 있던** 시간을 기록합니다.
+ * 보인 시간이 5초 미만(잘못 열었다 닫은 경우)이면 무시합니다.
+ *
+ * 한 팝업에 **한 줄** 만 보냅니다 — 떠날 때, 또는 페이지가 내려갈 때(pagehide: 팝업을 연 채 탭·앱을 닫음). 화면이 가려진
+ * 동안(탭 전환·앱 백그라운드)의 시간은 빼고 모읍니다 — 전에는 연 채 3시간 잠가 둔 시간이 훈련 시간으로 적혔다.
  *
  * @public
  */
@@ -11,16 +14,50 @@ export default function useTrainingSessionLog(trainingType) {
     useEffect(() => {
         if (!trainingType)
             return; // 타입 미상이면 기록하지 않음
-        const startedAt = new Date();
-        return () => {
-            const endedAt = new Date();
-            if (endedAt.getTime() - startedAt.getTime() < 5000)
+        /* **한 팝업 = 한 줄.** 보이는 구간마다 따로 보내면 서버가 줄 수를 세션 수로 세어(v_user_training_time_stats) 탭을 오갈 때마다
+           문장 훈련 횟수가 늘었다. 보이던 시간만 모아 두었다가 떠날 때(또는 페이지가 내려갈 때) 한 번 보낸다 — 끝 시각은 처음 보인 때 + 보인 시간. */
+        const 보임 = () => typeof document === 'undefined' || document.visibilityState !== 'hidden';
+        let 처음보임 = null;
+        let 구간시작 = null;
+        let 모은ms = 0;
+        let 보냄 = false;
+        const 구간열기 = () => { const t = Date.now(); if (처음보임 == null)
+            처음보임 = t; if (구간시작 == null)
+            구간시작 = t; };
+        const 구간닫기 = () => { if (구간시작 != null) {
+            모은ms += Date.now() - 구간시작;
+            구간시작 = null;
+        } };
+        if (보임())
+            구간열기();
+        const 보내기 = () => {
+            if (보냄)
+                return;
+            구간닫기();
+            if (처음보임 == null || 모은ms < 5000)
                 return;
+            보냄 = true;
             logTrainingTime({
                 trainingType,
-                startedAt: startedAt.toISOString(),
-                endedAt: endedAt.toISOString(),
+                startedAt: new Date(처음보임).toISOString(),
+                endedAt: new Date(처음보임 + 모은ms).toISOString(),
             });
         };
+        const 보임바뀜 = () => { if (보임())
+            구간열기();
+        else
+            구간닫기(); };
+        if (typeof document !== 'undefined')
+            document.addEventListener('visibilitychange', 보임바뀜);
+        // 페이지가 내려가면(탭·앱 닫기) React 정리가 안 돈다 — 그때 보낸다
+        if (typeof window !== 'undefined')
+            window.addEventListener('pagehide', 보내기);
+        return () => {
+            if (typeof document !== 'undefined')
+                document.removeEventListener('visibilitychange', 보임바뀜);
+            if (typeof window !== 'undefined')
+                window.removeEventListener('pagehide', 보내기);
+            보내기();
+        };
     }, [trainingType]);
 }

package/dist/packages/core/src/hooks/useWordMeanings.js

@@ -26,6 +26,10 @@ const memCache = new Map();
 /* 받아 봤는데 뜻이 없던 열쇠 — 다시 묻지 않는다. 전에는 뜻 없는 낱말이 캐시에 안 남아 표를 다시 정렬하거나 쪽을
    넘길 때마다 같은 낱말을 또 조회했다. (조회가 실패한 것은 여기 넣지 않는다 — 다음에 다시 받는다.) */
 const noMeaning = new Set();
+/* 빈 응답(한 줄도 못 받음)으로 '뜻 없음' 이 된 열쇠와 그 때 — 조회 함수는 실패도 빈 배열로 돌려주므로 영영 굳히지 않고, 사용자 추가
+   낱말처럼 정말 뜻이 없는 쪽을 오갈 때마다 다시 묻지도 않게 **잠시만**(1분) 묻지 않는다. */
+const 빈응답때 = new Map();
+const 빈응답유예ms = 60_000;
 export function useWordMeanings(rows, fetchMeanings) {
     /* 캐시는 모듈 스코프 Map 이라 갱신이 렌더에 자동 반영되지 않는다 — 조회가 끝나면 이 값을
        올려 아래 스냅샷을 다시 계산시킨다(캐시 히트만으로 리렌더가 연쇄되지 않도록 분리). */
@@ -35,7 +39,8 @@ export function useWordMeanings(rows, fetchMeanings) {
     const wantedKey = Array.from(new Set(rows.map(r => meaningKey(r.word, r.homonum)))).sort().join('|');
     useEffect(() => {
         const wanted = wantedKey ? wantedKey.split('|') : [];
-        const missing = wanted.filter(k => !memCache.has(k) && !noMeaning.has(k));
+        const 지금 = Date.now();
+        const missing = wanted.filter(k => !memCache.has(k) && !noMeaning.has(k) && !(지금 - (빈응답때.get(k) ?? -Infinity) < 빈응답유예ms));
         if (missing.length === 0)
             return; // 전부 캐시에 있음 — 네트워크·상태 갱신 불필요
         let cancelled = false;
@@ -50,9 +55,15 @@ export function useWordMeanings(rows, fetchMeanings) {
             /* 한 줄도 못 받았으면 '뜻 없음' 으로 굳히지 않는다 — 조회 함수는 실패를 빈 배열로 돌려주는 약속이라, 잠깐 끊긴 망이
                그 쪽 낱말들을 새로고침 전까지 '뜻 없음' 으로 묶었다. 받은 게 있으면 그 응답에 빠진 낱말만 없는 것으로 본다. */
             if (got.length > 0)
-                for (const k of missing)
+                for (const k of missing) {
                     if (!memCache.has(k))
                         noMeaning.add(k);
+                }
+            else {
+                const t = Date.now();
+                for (const k of missing)
+                    빈응답때.set(k, t);
+            }
             if (cancelled || got.length === 0)
                 return;
             setFetched(v => v + 1);

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

@@ -56,7 +56,11 @@ export declare function getTrainingPools(): Record<string, unknown[]>;
 export declare function loadTrainingData(): Promise<void>;
 /** @public */
 export declare function isTrainingDataLoaded(): boolean;
-export declare function ensureTrainingDataLoaded(timeout?: number): Promise<unknown>;
+/**
+ * 자료를 받게 하고 **받았는지** 를 돌려준다(시간 초과·실패는 false). 전에는 성공·3초 초과·실패가 모두 undefined 로 끝나
+ * 부르는 쪽이 빈 풀로 계획을 만들고도 알 길이 없었다. 늦게 도착하면 'speechear.data.updated' 가 온다.
+ */
+export declare function ensureTrainingDataLoaded(timeout?: number): Promise<boolean>;
 declare const _default: {
     NOISE_DATAS: unknown[];
     SHORT_STORIES: unknown[];

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

@@ -111,6 +111,9 @@ export async function loadTrainingData() {
             for (const key of Object.keys(map || {})) {
                 const groups = map[key] || [];
                 for (const g of groups) {
+                    // 한 행이 null·글자면 건너뛴다 — 그 한 행의 TypeError 로 자료 전체를 버리고 매번 같은 실패를 되풀이했다
+                    if (!g || typeof g !== 'object')
+                        continue;
                     const gr = g;
                     const t = String(gr.training_type || key);
                     const cat0 = String(gr.category_main_code || gr.category_main || gr.category_0 || '');
@@ -149,22 +152,35 @@ export async function loadTrainingData() {
         SHORT_STORIES.push(...받음.short);
         LONG_STORIES.push(...받음.long);
         ORDER_SETS.push(...받음.order);
+        // 다 채운 뒤 _loaded 를 먼저 세운다 — 'updated' 를 받은 쪽이 isTrainingDataLoaded() 로 확인하면 아직 false 였다
+        _loaded = true;
         try {
-            window.dispatchEvent(new Event('speechear.data.updated'));
+            computeDailySelection();
         }
         catch (e) { }
         try {
-            computeDailySelection();
+            window.dispatchEvent(new Event('speechear.data.updated'));
         }
         catch (e) { }
-        _loaded = true;
     })();
     return _loading;
 }
 /** @public */
 export function isTrainingDataLoaded() { return _loaded; }
+/**
+ * 자료를 받게 하고 **받았는지** 를 돌려준다(시간 초과·실패는 false). 전에는 성공·3초 초과·실패가 모두 undefined 로 끝나
+ * 부르는 쪽이 빈 풀로 계획을 만들고도 알 길이 없었다. 늦게 도착하면 'speechear.data.updated' 가 온다.
+ */
 export async function ensureTrainingDataLoaded(timeout = 3000) {
     const p = loadTrainingData();
-    return Promise.race([p, new Promise((res) => setTimeout(res, timeout))]);
+    let t;
+    try {
+        await Promise.race([p, new Promise((res) => { t = setTimeout(res, timeout); })]);
+    }
+    finally {
+        if (t !== undefined)
+            clearTimeout(t);
+    }
+    return _loaded;
 }
 export default { NOISE_DATAS, SHORT_STORIES, LONG_STORIES, ORDER_SETS, loadTrainingData, ensureTrainingDataLoaded };

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

@@ -461,8 +461,10 @@ preferAsTarget) {
     }
     const targetWords = allWords.filter(({ syls, wordSyls }) => {
         const filterSyls = !phonemic && wordSyls ? wordSyls : syls;
+        /* 일치(ordered) 는 조건의 자리가 곧 음절 자리다 — 빈 슬롯을 걸러 낸 reqs 를 쓰면 [{}, {초성:ㄴ}] 의 ㄴ 이 첫 음절에 걸렸다.
+           wordContainsAllPhonemes 는 빈 슬롯을 스스로 건너뛴다. */
         return ordered
-            ? wordContainsAllPhonemes(filterSyls, reqs)
+            ? wordContainsAllPhonemes(filterSyls, requiredPhonemes)
             : wordContainsAllPhonemesUnordered(filterSyls, reqs);
     });
     const groups = new Map();
@@ -534,10 +536,12 @@ preferAsTarget) {
                         if (tv !== cv)
                             diffValues = [tv, cv];
                     }
-                    const isRelevant = reqs.some(req => {
-                        const reqVal = req[diffSection];
+                    const 맞나 = (req) => {
+                        const reqVal = req?.[diffSection];
                         return reqVal !== undefined && (diffValues[0] === reqVal || diffValues[1] === reqVal);
-                    });
+                    };
+                    // 일치(ordered): "첫번째 음절에서 초성 ㄱ 이 대립" — 대립한 자리의 조건이어야 한다(다른 음절에서 대립한 쌍이 섞였다)
+                    const isRelevant = ordered ? 맞나(requiredPhonemes[analysis.diff.idx]) : reqs.some(맞나);
                     if (!isRelevant)
                         continue;
                 }
@@ -545,6 +549,8 @@ preferAsTarget) {
                 const diffVals = analysis.diff.diffs[diffSection];
                 const diffHasEmpty = diffHasEmptyPair(diffSection, diffVals);
                 const item = {
+                    /* 정렬 꼴 그대로 — 기준 방향을 넣으면 음소를 ㄱ→ㄴ 으로 바꿔 찾거나 저장한 표를 다시 열 때 같은 쌍의 id 가 달라져
+                       바구니(id 로 견줌)에서 선택이 풀리고 두 번 담겼다. 이미 저장된 대립쌍표 id 도 이 꼴이다. */
                     id: dedupKey,
                     diffSection,
                     diffHasEmpty,

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

@@ -58,4 +58,4 @@ export interface PlanLimits {
 /** @public 요금제 티어별 제한 (표시되지 않는 레거시 티어는 생략) */
 export declare const PLAN_LIMITS: Partial<Record<PlanTier, PlanLimits>>;
 /** product code → 요금제 티어 */
-export declare function getPlanTier(productCode: string): PlanTier;
+export declare function getPlanTier(productCode: string | null | undefined): PlanTier;

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

@@ -145,7 +145,13 @@ export const PLAN_LIMITS = {
 };
 /** product code → 요금제 티어 */
 export function getPlanTier(productCode) {
-    const c = productCode.toLowerCase();
+    const c = (productCode ?? '').toLowerCase();
+    /* 무료 코드는 접두사 규칙보다 먼저 — 'speechear_free' 가 아래 speechear_ 규칙에 걸려 유료 개인 스탠다드로 올라갔고,
+       'manager_free' 는 규칙이 없어 none 이었다(어드민 요금제 PLANS 의 plan_id). null 코드는 던지지 않고 none. */
+    if (c === 'speechear_free' || c === 'free')
+        return 'free';
+    if (c.startsWith('manager_free') || c.startsWith('mgr_free'))
+        return 'mgr_free';
     if (c.startsWith('manager_enterprise'))
         return 'enterprise';
     if (c.startsWith('manager_pro'))

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

@@ -65,7 +65,9 @@ export function 칸순(a, b) {
     const sa = 글(a), sb = 글(b);
     if (sa === sb)
         return 0;
-    const ka = 조각내기(sa), kb = 조각내기(sb);
+    /* 수(number)는 글로 바꿔 쪼개지 않고 **수 조각 하나** 로 — '1e+21'·'1e-7' 로 쪼개면 1e21 이 5 앞에, -Infinity 가 끝에 섰다 */
+    const 열쇠 = (v, s) => (typeof v === 'number' && !Number.isNaN(v) ? [v] : 조각내기(s));
+    const ka = 열쇠(a, sa), kb = 열쇠(b, sb);
     const n = Math.min(ka.length, kb.length);
     for (let i = 0; i < n; i++) {
         const x = ka[i], y = kb[i];
@@ -73,7 +75,7 @@ export function 칸순(a, b) {
             if (x !== y)
                 return x - y;
             continue;
-        }
+        } // 같지 않은 ±Infinity 끼리도 부호가 맞다
         if (typeof x === 'number')
             return -1;
         if (typeof y === 'number')

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

@@ -59,7 +59,7 @@ export declare function syllablePron(ch: string): string;
 export declare function soundOf(syll: string, pronMap: Map<string, string>): string;
 /** @public comp에서 실제로 선택된 파트 1개(초성 우선)를 반환. 없으면 null. */
 export declare function primarySelPart(comp: CompositionFilter | null): 'cho' | 'jung' | 'jong' | null;
-/** @public 음절(분해값 s)이 comp의 선택 파트들과 모두 일치하는지(=선택 음소를 가진 음절). */
+/** @public 음절(분해값 s)이 comp의 선택 파트들과 모두 일치하는지(=선택 음소를 가진 음절). `jongNone` 이면 받침 없는 음절만 맞고 `jong` 은 보지 않는다(풀 필터와 같게). */
 export declare function syllMatchesComp(s: Syllable, comp: CompositionFilter): boolean;
 /**
  * @public 발음 모드에서 comp 매칭에 쓸 음절 배열. 표준발음(pronMap)의 음절수가 철자와 같으면 발음 음절로,
@@ -94,7 +94,7 @@ export declare function buildDropContrast3Problem(word: string, comp: Compositio
  * @public 합성어 부분 탈락 → [문제단어(합성어), 남는 실단어(정답), 그 단어의 대립쌍 실단어 오답 2].
  * 합성어 근사: 앞/뒤로 나눈 두 조각이 '둘 다 실단어'(wordSet)인 첫 조합을 채택(예: 손수건=손+수건).
  * 정답·오답 전부 실단어라 발음이 그대로. comp(훈련음소) 지정 시 남는 단어의 그 자리를 대립, 없으면 전 음절.
- * dropPos: 0=어두 어근(앞) 탈락, 1=어말 어근(뒤) 탈락. 편집기·런타임 공용.
+ * dropPos: 0=어두 어근(앞) 탈락, 1=어말 어근(뒤) 탈락. 결과의 `dropped` 에 뺀 조각을 담는다. 편집기·런타임 공용.
  */
 export declare function buildDropCompoundProblem(word: string, comp: CompositionFilter | null, pronMap: Map<string, string>, phonemeView: 'char' | 'pron', wordSet: Set<string>, dropPos?: number | null): TrainingProblem | null;
 /**

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

@@ -207,7 +207,7 @@ export function primarySelPart(comp) {
         return 'jong';
     return null;
 }
-/** @public 음절(분해값 s)이 comp의 선택 파트들과 모두 일치하는지(=선택 음소를 가진 음절). */
+/** @public 음절(분해값 s)이 comp의 선택 파트들과 모두 일치하는지(=선택 음소를 가진 음절). `jongNone` 이면 받침 없는 음절만 맞고 `jong` 은 보지 않는다(풀 필터와 같게). */
 export function syllMatchesComp(s, comp) {
     const ok = (arr, val) => !hasSel(arr) || asArr(arr).includes(val);
     /* '받침 없음'(jongNone)도 본다 — 풀 필터(wordTrainingPool)는 jongNone 이면 받침 없는 음절만 맞다고 보는데 여기만 무시해, 초성 ㅎ +
@@ -367,7 +367,7 @@ export function buildDropContrast3Problem(word, comp, pronMap, phonemeView, word
  * @public 합성어 부분 탈락 → [문제단어(합성어), 남는 실단어(정답), 그 단어의 대립쌍 실단어 오답 2].
  * 합성어 근사: 앞/뒤로 나눈 두 조각이 '둘 다 실단어'(wordSet)인 첫 조합을 채택(예: 손수건=손+수건).
  * 정답·오답 전부 실단어라 발음이 그대로. comp(훈련음소) 지정 시 남는 단어의 그 자리를 대립, 없으면 전 음절.
- * dropPos: 0=어두 어근(앞) 탈락, 1=어말 어근(뒤) 탈락. 편집기·런타임 공용.
+ * dropPos: 0=어두 어근(앞) 탈락, 1=어말 어근(뒤) 탈락. 결과의 `dropped` 에 뺀 조각을 담는다. 편집기·런타임 공용.
  */
 export function buildDropCompoundProblem(word, comp, pronMap, phonemeView, wordSet, dropPos = null) {
     const chars = [...word];

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

@@ -19,7 +19,8 @@ export declare function getViableChoseongs(opts?: {
     excludeNoImage?: boolean;
 }): Promise<Set<string>>;
 /** @public 현재 필터(GenOptions) 조건으로 만들 수 있는 정답 단어 수.
- *  fullCount로 샘플링 캡을 우회해 실제 가능 단어 수를 그대로 센다(무작위 왜곡 방지). */
+ *  fullCount로 샘플링 캡을 우회해 실제 가능 단어 수를 그대로 센다(무작위 왜곡 방지).
+ *  보기형 생성과 같게 **서로 소리가 다른 오답이 보기 수(choicesPerItem, 기본 3) − 1 개** 있는 낱말만 센다. */
 export declare function countUsableWords(opts: GenOptions): Promise<number>;
 /** @public 위치별(초성/중성/종성) 선택 가능한 자모 set + 음절 수 set — 실제 단어에 존재하는 값만.
  *

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

@@ -659,12 +659,15 @@ export async function getViableChoseongs(opts = {}) {
     return set;
 }
 /** @public 현재 필터(GenOptions) 조건으로 만들 수 있는 정답 단어 수.
- *  fullCount로 샘플링 캡을 우회해 실제 가능 단어 수를 그대로 센다(무작위 왜곡 방지). */
+ *  fullCount로 샘플링 캡을 우회해 실제 가능 단어 수를 그대로 센다(무작위 왜곡 방지).
+ *  보기형 생성과 같게 **서로 소리가 다른 오답이 보기 수(choicesPerItem, 기본 3) − 1 개** 있는 낱말만 센다. */
 export async function countUsableWords(opts) {
     const pool = await buildUsablePool({ ...opts, fullCount: true });
     /* 보기형 생성(genChoicePick)은 **서로 소리가 다른 오답** 이 보기 수 − 1 개 있어야 문항을 만든다 — 오답 1개만 있어도 세어
        "41개 가능" 인데 같은 소리 고르기가 4문항만 만들었다. 같은 기준으로 센다. */
-    const need = Math.max(1, (opts.choicesPerItem ?? 3) - 1);
+    /* 보기 수를 **알려 줄 때만**(choicesPerItem) 그만큼의 서로 다른 소리 오답을 요구한다. 안 주면(여러 유형이 함께 쓰는 안내 숫자)
+       오답 하나로 센다 — 늘 둘을 요구하면 같다/다르다·음절 합치기처럼 만들 수 있는 유형이 있는데도 "0개" 가 떴다. */
+    const need = opts.choicesPerItem != null ? Math.max(1, opts.choicesPerItem - 1) : 1;
     return pool.filter(e => new Set(e.usable.map(u => pronOfWord(u))).size >= need).length;
 }
 /** @public 위치별(초성/중성/종성) 선택 가능한 자모 set + 음절 수 set — 실제 단어에 존재하는 값만.

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

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

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

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