@ihabdevteam/core 0.128.0 → 0.130.0

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

@@ -5,6 +5,8 @@ export type MergedVisit = {
     status: VisitAllStatus;
 };
 /**
+ * 개수 보기 옵션의 값 목록. 라벨은 한국어 고정이다 — 화면에는 훅이 돌려주는
+ * 번역된 `vapPageSizeOptions` 를 쓴다.
  * @public
  */
 export declare const VAP_PAGE_SIZE_OPTIONS: {
@@ -20,6 +22,11 @@ export declare function useVisitAllPanel(mergedVisits: MergedVisit[]): {
     setVapSearch: import("react").Dispatch<import("react").SetStateAction<string>>;
     vapPageSize: string;
     setVapPageSize: import("react").Dispatch<import("react").SetStateAction<string>>;
+    /** 번역된 개수 보기 옵션 — `VAP_PAGE_SIZE_OPTIONS` 와 값은 같고 라벨만 지금 언어로 */
+    vapPageSizeOptions: {
+        label: string;
+        value: string;
+    }[];
     vapStatus: string;
     setVapStatus: import("react").Dispatch<import("react").SetStateAction<string>>;
     vapPage: number;

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

@@ -1,6 +1,9 @@
 'use client';
 import { useMemo, useState } from 'react';
+import { useTranslation } from 'react-i18next';
 /**
+ * 개수 보기 옵션의 값 목록. 라벨은 한국어 고정이다 — 화면에는 훅이 돌려주는
+ * 번역된 `vapPageSizeOptions` 를 쓴다.
  * @public
  */
 export const VAP_PAGE_SIZE_OPTIONS = [
@@ -14,6 +17,7 @@ export const VAP_PAGE_SIZE_OPTIONS = [
  * `mergedVisits`(예정+완료+미방문)를 받아 파생 데이터를 계산.
  */
 export function useVisitAllPanel(mergedVisits) {
+    const { t } = useTranslation();
     const [vapSearch, setVapSearch] = useState('');
     const [vapPageSize, setVapPageSize] = useState('25');
     const [vapStatus, setVapStatus] = useState('all');
@@ -38,9 +42,13 @@ export function useVisitAllPanel(mergedVisits) {
     const vapPageItems = useMemo(() => {
         return vapFiltered.slice((vapPageClamped - 1) * Number(vapPageSize), vapPageClamped * Number(vapPageSize));
     }, [vapFiltered, vapPageClamped, vapPageSize]);
+    // 내보낸 상수는 모양·라벨을 그대로 둔다(소비자가 값 목록으로 쓴다). 화면용 라벨만 여기서 번역한다.
+    const vapPageSizeOptions = useMemo(() => VAP_PAGE_SIZE_OPTIONS.map(o => ({ ...o, label: t('common.pageSizeLabel', { n: o.value, defaultValue: o.label }) })), [t]);
     return {
         vapSearch, setVapSearch,
         vapPageSize, setVapPageSize,
+        /** 번역된 개수 보기 옵션 — `VAP_PAGE_SIZE_OPTIONS` 와 값은 같고 라벨만 지금 언어로 */
+        vapPageSizeOptions,
         vapStatus, setVapStatus,
         vapPage: vapPageClamped, setVapPage,
         vapFiltered,

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

@@ -44,6 +44,9 @@ export function useWordMeanings(rows, fetchMeanings) {
                     memCache.set(meaningKey(row.Word, row.Homonum ?? undefined), row.Meaning);
             }
             setFetched(v => v + 1);
+        }).catch(() => {
+            // 조회 함수가 약속을 어기고 거절해도(망 끊김 등) 처리되지 않은 거절로 새지 않게 삼킨다 —
+            // 뜻은 있으면 좋은 것이라 빈 결과와 같게 다룬다. 캐시에 안 넣었으니 다음에 다시 받는다.
         });
         return () => { cancelled = true; };
     }, [wantedKey, fetchMeanings]);

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

@@ -5,11 +5,16 @@ export type { WordComposition } from './wordTrainingFilterModel';
 /** 설정 팝업 취소 시 되돌릴 필터 스냅샷 */
 export interface WordFilterSnapshot {
     composition: WordComposition;
+    /** 뜰 때의 대립 갯수. composition 에서 파생되므로 되돌릴 때는 읽지 않는다. */
     contrastCount: number;
     excludeNoImage: boolean;
     sameStructureOnly: boolean;
     phonemeView: 'char' | 'pron' | 'direct';
     gradeFilter: string[];
+    /** 품사 필터. 없으면(예전에 뜬 스냅샷) 되돌릴 때 지금 값을 그대로 둔다. */
+    posFilter?: string[];
+    /** 어종 필터. 없으면(예전에 뜬 스냅샷) 되돌릴 때 지금 값을 그대로 둔다. */
+    wordTypeFilter?: string[];
 }
 /**
  * 그룹이 노출할 설정 항목. 그룹에 속한 훈련 타입들의 CAPABILITY 합집합으로 결정.

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

@@ -25,6 +25,11 @@ function loadSavedFilter(groupKey) {
     catch { }
     return null;
 }
+/** 저장값에서 보기 모드 복원 — 마운트 때와 groupKey 가 바뀌어 다시 읽을 때 같은 규칙을 쓴다 */
+function readPhonemeView(saved) {
+    const v = saved?.phonemeView;
+    return v === 'pron' ? 'pron' : v === 'direct' ? 'direct' : 'char';
+}
 /** 저장값에서 composition 복원 (레거시 choseong → cho 마이그레이션) */
 function readComposition(saved) {
     const s = saved;
@@ -52,16 +57,9 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
     // resetOnMount(단어훈련 만들기 등): 진입 시 항상 기본값에서 시작하도록 저장값을 불러오지 않는다.
     // localStorage 읽기/파싱은 마운트 시 1회만 (lazy init)
     const [saved] = useState(() => opts?.resetOnMount ? null : loadSavedFilter(groupKey));
-    // 1~4개는 정확히 N개 차이, 5는 "5개 이상"(≥5) 버킷 — 런타임에서 threshold로 처리.
-    // saved.contrastCount는 localStorage에 저장된 이전 세션의 값 — 과거 포맷이나 수동 편집으로
-    // 숫자가 아닌 값이 들어있으면 Number.isFinite로 걸러 NaN이 이후 계산(비교·최소음절수 등)에
-    // 조용히 전파되는 것을 막는다.
-    const rawContrastCount = saved?.contrastCount;
-    const savedContrastCount = typeof rawContrastCount === 'number' && Number.isFinite(rawContrastCount) ? rawContrastCount : 1;
-    const [contrastCount, setContrastCount] = useState(Math.min(5, Math.max(1, savedContrastCount)));
     // 훈련 음소 그룹 보기 모드 — 'char'(글자 선택) | 'pron'(발음 선택).
     // composition 값이 모드별(글자=개별 자모, 발음=병합/대표음)로 저장되므로, 모드도 함께 persist 해야 재로드 시 일치한다.
-    const [phonemeView, setPhonemeView] = useState(saved?.phonemeView === 'pron' ? 'pron' : saved?.phonemeView === 'direct' ? 'direct' : 'char');
+    const [phonemeView, setPhonemeView] = useState(readPhonemeView(saved));
     const [composition, setComposition] = useState(() => readComposition(saved));
     // 타입별 시드 composition — 한 음절 특정(requireSyllable)은 '가'(ㄱ+ㅏ+제외), 그 외는 중립.
     // 음절 수 고정(fixedSyllable)·종성 제외 고정(fixedNoCoda)이 있으면 그 값을 반영한다.
@@ -116,7 +114,6 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
         setGradeFilter([]);
         setPosFilter([]);
         setWordTypeFilter([]);
-        setContrastCount(1);
         // seedComposition은 caps에서 파생 — resetKey와 함께 갱신되므로 deps는 resetKey만 둔다.
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [opts?.resetKey]);
@@ -131,13 +128,11 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
     // 훈련할 음소를 고른 슬롯(초성/모음/종성) 수 = 정답↔오답이 달라야 하는 음소의 최소 개수.
     // 예: 3슬롯 모두 선택하면 최소 3개 음소가 달라야 하므로 '다른 음소의 총 갯수'는 3부터 가능(1·2개 비활성).
     const minDiffCount = Math.max(1, [composition.cho, composition.jung, composition.jong].filter(Boolean).length);
-    // 최소 개수 미만이 선택돼 있으면 최소값으로 자동 상향 (비활성 옵션이 선택된 채 남지 않도록)
-    /* eslint-disable react-hooks/set-state-in-effect */
-    useEffect(() => {
-        if (contrastCount < minDiffCount)
-            setContrastCount(minDiffCount);
-    }, [minDiffCount, contrastCount]);
-    /* eslint-enable react-hooks/set-state-in-effect */
+    // 대립 갯수 = 고른 칸 수(파생값). 1~4개는 정확히 N개 차이, 5는 "5개 이상"(≥5) 버킷.
+    // 예전에는 상태로 두고 "고른 칸 수보다 작으면 올린다"만 했다 — 고르는 UI('다른 음소의 총 갯수')가
+    // 걷힌 뒤로는 내릴 길이 없어, 칸 선택을 풀어도 높은 채로 남아 오답 조건이 틀어지고 그대로
+    // 저장됐다. 저장된 contrastCount 는 이제 읽지 않는다(저장 형식은 그대로 두어 옛 판과 호환).
+    const contrastCount = minDiffCount;
     // groupKey 는 마운트 때 한 번만 읽힌다(saved 가 lazy init). 그런데 저장 effect 는
     // groupKey 를 의존성에 두고 **지금 든 값**을 새 열쇠에 쓴다. 그래서 살아 있는 훅에서
     // groupKey 를 바꾸면 앞 그룹의 값이 뒤 그룹 저장소를 덮어썼다 — 실측으로 B 에 있던
@@ -154,12 +149,11 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
             return;
         if (!opts?.resetOnMount) {
             const s = loadSavedFilter(groupKey);
-            const n = typeof s?.contrastCount === 'number' && Number.isFinite(s.contrastCount) ? s.contrastCount : 1;
-            setContrastCount(Math.min(5, Math.max(1, n)));
             setComposition(s?.composition ?? seedComposition());
             setExcludeNoImage(s?.excludeNoImage ?? true);
             setSameStructureOnly(s?.sameStructureOnly ?? true);
-            setPhonemeView(s?.phonemeView === 'pron' ? 'pron' : 'char');
+            // 마운트 때와 같은 규칙 — 여기서만 'direct' 를 'char' 로 떨구고 있었다
+            setPhonemeView(readPhonemeView(s));
             setGradeFilter(Array.isArray(s?.gradeFilter) ? s.gradeFilter : []);
             setPosFilter(Array.isArray(s?.posFilter) ? s.posFilter : []);
             setWordTypeFilter(Array.isArray(s?.wordTypeFilter) ? s.wordTypeFilter : []);
@@ -294,8 +288,6 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
     }), [viable]);
     // 번역된 레이블 — 표시용. 내부 로직은 여전히 한국어 상수 키로 동작
     const LABELS = useMemo(() => ({
-        // 다른 음소 갯수 — 정답과 오답이 서로 다른 음소(자모)의 총 개수 (위치 구분 없음)
-        diffPhonemeCount: t('training.contrast.diffPhonemeCount', { defaultValue: '다른 음소의 총 갯수' }),
         // 정답 단어 구성 — 음절수/초성/모음/종성 (정답 단어에만 적용)
         composition: t('wordPairs.composition', '정답 단어 구성'),
         syllableCount: t('wordPairs.syllableCount', '음절 수'),
@@ -433,10 +425,8 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
         }
         return sections;
     }, [caps.choseong, caps.partOfSpeech, caps.wordType, caps.requireSyllable, caps.fixedSyllable, caps.fixedNoCoda, caps.requireCoda, minSyllables, partViable, viable, phonemeView, syllableViable, LABELS, t, infoAction, selectInfoItems, attrKeys]);
+    // '다른 음소의 총 갯수' 섹션은 걷혔다 — 그 선택값·선택 처리 갈래도 함께 뺀다(대립 갯수는 파생값).
     const filterSelected = {
-        ...(caps.difficulty ? {
-            [LABELS.diffPhonemeCount]: String(contrastCount),
-        } : {}),
         ...((caps.choseong || caps.fixedSyllable != null) && composition.syllable != null ? { [LABELS.syllableCount]: syllableValue(composition.syllable) } : {}),
         ...(caps.choseong && composition.cho ? { [LABELS.trainOnset]: composition.cho } : {}),
         ...(caps.choseong && composition.jung ? { [LABELS.trainVowel]: composition.jung } : {}),
@@ -454,12 +444,7 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
         ...(caps.wordType ? { [attrKeys.wordType]: wordTypeFilter } : {}),
     };
     const handleFilterSelect = useCallback((value, sectionLabel) => {
-        if (sectionLabel === LABELS.diffPhonemeCount) {
-            const n = Number(value);
-            if (n >= 1)
-                setContrastCount(n);
-        }
-        else if (sectionLabel === LABELS.exclude) {
+        if (sectionLabel === LABELS.exclude) {
             // 다중 토글 — 클릭한 항목만 on/off
             if (value === LABELS.excludeImage) {
                 setExcludeNoImage(v => !v);
@@ -540,16 +525,21 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
         setPhonemeView(next);
     }, [phonemeView]);
     // 설정 팝업 취소용 — 현재 필터 상태 스냅샷 / 스냅샷으로 복원
+    // 품사·어종도 함께 뜬다 — 빠져 있어서 설정 팝업에서 취소해도 그 둘만 되돌아가지 않았다.
+    // contrastCount 는 composition 에서 파생되므로 되돌릴 때 따로 세우지 않는다.
     const getFilterSnapshot = useCallback(() => ({
-        composition, contrastCount, excludeNoImage, sameStructureOnly, phonemeView, gradeFilter,
-    }), [composition, contrastCount, excludeNoImage, sameStructureOnly, phonemeView, gradeFilter]);
+        composition, contrastCount, excludeNoImage, sameStructureOnly, phonemeView, gradeFilter, posFilter, wordTypeFilter,
+    }), [composition, contrastCount, excludeNoImage, sameStructureOnly, phonemeView, gradeFilter, posFilter, wordTypeFilter]);
     const restoreFilterSnapshot = useCallback((s) => {
         setComposition(s.composition);
-        setContrastCount(s.contrastCount);
         setExcludeNoImage(s.excludeNoImage);
         setSameStructureOnly(s.sameStructureOnly ?? true);
         setPhonemeView(s.phonemeView);
         setGradeFilter(Array.isArray(s.gradeFilter) ? s.gradeFilter : []);
+        if (Array.isArray(s.posFilter))
+            setPosFilter(s.posFilter);
+        if (Array.isArray(s.wordTypeFilter))
+            setWordTypeFilter(s.wordTypeFilter);
     }, []);
     return {
         difficulty,

package/dist/packages/core/src/i18n/locales/en.json

@@ -82,7 +82,8 @@
                 "w": "w-glide",
                 "velar": "ɰ-glide"
             }
-        }
+        },
+        "unknownError": "Unknown error"
     },
     "calendar": {
         "rangeSelect": "Select period",
@@ -281,7 +282,11 @@
         "security": {
             "title": "Security",
             "password": {
-                "label": "Password"
+                "label": "Password",
+                "currentRequired": "Enter your current password.",
+                "newRequired": "Enter a new password.",
+                "mismatch": "The new passwords do not match.",
+                "changed": "Your password has been changed."
             },
             "twoFactor": {
                 "label": "Two-Factor Authentication",
@@ -310,7 +315,6 @@
             "label": "Contrast",
             "type": "Contrast Type",
             "count": "Contrast Count",
-            "diffPhonemeCount": "Total differing phonemes",
             "n": "{{n}}"
         },
         "filter": {
@@ -403,7 +407,8 @@
             "notJudged": "Not judged",
             "replay": "Replay",
             "done": "Done",
-            "viewResult": "View Results"
+            "viewResult": "View Results",
+            "noContent": "(No content)"
         },
         "up": "Move up",
         "down": "Move down",
@@ -502,6 +507,11 @@
             "copy": "Copy Link",
             "inactive": "Inactive",
             "title": "Homework Progress"
+        },
+        "duration": {
+            "minSec": "{{m}}m {{s}}s",
+            "min": "{{m}}m",
+            "sec": "{{s}}s"
         }
     },
     "payment": {
@@ -672,7 +682,9 @@
         "tab": {
             "cards": "Word Table Cards",
             "tables": "Word Tables"
-        }
+        },
+        "publishedBadge": "Published",
+        "sharedBadge": "Shared"
     },
     "keyWords": {
         "title": "Key Words",
@@ -1362,5 +1374,20 @@
             "velar": "Velar",
             "glottal": "Glottal"
         }
+    },
+    "bulkBar": {
+        "clearSelection": "Clear selection"
+    },
+    "debug": {
+        "showResult": "Show {{type}} result"
+    },
+    "badge": {
+        "selected": "Selected",
+        "remove": "Remove",
+        "exclude": "Excluded",
+        "nthSelected": "Selection {{n}}"
+    },
+    "loader": {
+        "loading": "Loading"
     }
 }

package/dist/packages/core/src/i18n/locales/ko.json

@@ -80,7 +80,8 @@
                 "w": "w활음",
                 "velar": "ɰ활음"
             }
-        }
+        },
+        "unknownError": "알 수 없는 오류"
     },
     "calendar": {
         "rangeSelect": "기간 선택",
@@ -279,7 +280,11 @@
         "security": {
             "title": "보안",
             "password": {
-                "label": "비밀번호"
+                "label": "비밀번호",
+                "currentRequired": "현재 비밀번호를 입력하세요.",
+                "newRequired": "새 비밀번호를 입력하세요.",
+                "mismatch": "새 비밀번호가 일치하지 않습니다.",
+                "changed": "비밀번호가 변경되었습니다."
             },
             "twoFactor": {
                 "label": "2단계 인증",
@@ -308,7 +313,6 @@
             "label": "대립",
             "type": "대립 종류",
             "count": "대립 갯수",
-            "diffPhonemeCount": "다른 음소의 총 갯수",
             "n": "{{n}}개"
         },
         "filter": {
@@ -401,7 +405,8 @@
             "notJudged": "미판정",
             "replay": "다시하기",
             "done": "완료",
-            "viewResult": "결과 확인"
+            "viewResult": "결과 확인",
+            "noContent": "(내용없음)"
         },
         "up": "위로",
         "down": "아래로",
@@ -500,6 +505,11 @@
                 "completedFmt": "완료 {{done}}/{{total}} · {{duration}}"
             },
             "visitSuffix": "의 방문"
+        },
+        "duration": {
+            "minSec": "{{m}}분 {{s}}초",
+            "min": "{{m}}분",
+            "sec": "{{s}}초"
         }
     },
     "payment": {
@@ -670,7 +680,9 @@
             "publishStore": "말귀자료실에 올리기",
             "unpublishStore": "말귀자료실에서 내리기"
         },
-        "newBadge": "새로 만든 표"
+        "newBadge": "새로 만든 표",
+        "publishedBadge": "발행됨",
+        "sharedBadge": "공유 중"
     },
     "keyWords": {
         "title": "주요 단어",
@@ -1360,5 +1372,20 @@
             "velar": "연구개음",
             "glottal": "성문음"
         }
+    },
+    "bulkBar": {
+        "clearSelection": "선택 해제"
+    },
+    "debug": {
+        "showResult": "{{type}} 결과보기"
+    },
+    "badge": {
+        "selected": "선택됨",
+        "remove": "제거",
+        "exclude": "제외",
+        "nthSelected": "{{n}}번째 선택"
+    },
+    "loader": {
+        "loading": "불러오는 중…"
     }
 }

package/dist/packages/core/src/tokens.css

@@ -269,7 +269,8 @@
     --text-h0-size: 32px; --text-h0-line: 44px; --text-h0-spacing: -0.75px;
     --text-h1-size: 28px; --text-h1-line: 40px; --text-h1-spacing: -0.4px;
     --text-h2-size: 22px; --text-h2-line: 32px; --text-h2-spacing: -0.2px;
-    --text-h3-size: 18px; --text-h3-line: 28px;
+    /* h3 는 태블릿에서 줄이지 않는다 — 데스크톱 20px/30px 그대로(2026-09-14 사용자 결정).
+       모바일(≤767px)의 17px 은 따로 둔다. */
     --text-h4-size: 16px; --text-h4-line: 24px;
     --text-h5-size: 14px; --text-h5-line: 21px;  /* 15→14: h5↔body-2 충돌 해소 */
     --text-body-1-size: 17px; --text-body-1-line: 27px;  /* 16→17: h4(16px)와 분리 */

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

@@ -7,8 +7,8 @@ export const TRAINING_TYPES = [
 ];
 /** @public */
 export const TOPIC_TYPES = [
-    { key: 'FOOD', label: '음식', icon: 'salad', color: '#FF8A65', subs: [{ key: 'TRKRFD', label: ' 한국 전통음식' }, { key: 'MDKRFD', label: '한국 현대음식' }, { key: 'WRLDFD', label: '세계의 음식' }, { key: 'MTRFRT', label: '식재료와 과일' }, { key: 'GEFDKL', label: '음식 상식' }] },
-    { key: 'HLTH', label: '건강', icon: 'heart', color: '#66BB6A', subs: [{ key: 'HTETHB', label: '건강한 식습관' }, { key: 'DISILL', label: '병과 질환' }, { key: 'EXCISE', label: '운동' }, { key: 'GEHTKL', label: '건상상식' }] },
+    { key: 'FOOD', label: '음식', icon: 'salad', color: '#FF8A65', subs: [{ key: 'TRKRFD', label: '한국 전통음식' }, { key: 'MDKRFD', label: '한국 현대음식' }, { key: 'WRLDFD', label: '세계의 음식' }, { key: 'MTRFRT', label: '식재료와 과일' }, { key: 'GEFDKL', label: '음식 상식' }] },
+    { key: 'HLTH', label: '건강', icon: 'heart', color: '#66BB6A', subs: [{ key: 'HTETHB', label: '건강한 식습관' }, { key: 'DISILL', label: '병과 질환' }, { key: 'EXCISE', label: '운동' }, { key: 'GEHTKL', label: '건강상식' }] },
     { key: 'WETH', label: '날씨', icon: 'sun-medium', color: '#42A5F5', subs: [{ key: 'GESSKL', label: '계절상식' }, { key: 'SNWRAN', label: '눈과 비' }, { key: 'WTHFCT', label: '일기예보' }, { key: 'GEWTKL', label: '날씨상식' }] },
     { key: 'PRSN', label: '인물', icon: 'user-round', desc: '소음 환경 속 문장 이해 훈련', color: '#AB47BC', subs: [{ key: 'JODYPS', label: '조선시대' }, { key: 'MDKRPS', label: '한국 근현대' }, { key: 'THKDPS', label: '삼국시대' }, { key: 'WRLART', label: '세계의 예술가' }, { key: 'WRLPSN', label: '세계의 인물' }] },
     { key: 'KRCT', label: '한국문화', icon: 'bow-arrow', desc: '소음 환경 속 문장 이해 훈련', color: '#EC407A', subs: [{ key: 'KRLANG', label: '우리말' }, { key: 'TRPLCT', label: '전통놀이' }, { key: 'HERITG', label: '문화재' }, { key: 'EVTFES', label: '행사와 축제' }, { key: 'GECTKL', label: '상식' }] },

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

@@ -1,5 +1,8 @@
 const ABSOLUTE_URL_RE = /^(?:[a-z]+:)?\/\//i;
-let configuredAssetBaseUrl = '';
+// globalThis 싱글톤: 다른 설정(storage·ttsConfig·imageConfig)과 같은 방식.
+// 모듈 변수로 두면 CJS 묶음이 여럿일 때(utils.cjs 에서 설정, components.cjs 에서 읽기)
+// 묶음마다 한 벌씩 생겨 설정이 안 보였다.
+const ASSET_GLOBAL_KEY = '__ihab_core_asset_base_url__';
 function normalizeAssetBaseUrl(baseUrl) {
     const raw = String(baseUrl || '').trim();
     if (!raw)
@@ -30,11 +33,12 @@ function normalizeAssetBaseUrl(baseUrl) {
  * @public
  */
 export function setAssetBaseUrl(baseUrl) {
-    configuredAssetBaseUrl = normalizeAssetBaseUrl(baseUrl);
+    ;
+    globalThis[ASSET_GLOBAL_KEY] = normalizeAssetBaseUrl(baseUrl);
 }
 /** @public */
 export function getAssetBaseUrl() {
-    return configuredAssetBaseUrl;
+    return globalThis[ASSET_GLOBAL_KEY] ?? '';
 }
 /**
  * 에셋 경로를 절대 URL 또는 베이스 URL 기준의 경로로 변환합니다.

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

@@ -10,8 +10,12 @@
 export async function copyText(text) {
     // 1순위: execCommand (동기 — 제스처 유지, iframe 대응)
     if (typeof document !== 'undefined') {
+        // 숨긴 textarea 에 포커스를 옮기므로, 끝나면 원래 자리로 돌려준다 — 안 돌리면 복사 단추를
+        // 누른 뒤 키보드 포커스가 body 로 떨어져 스크린리더·Tab 이동이 처음부터 다시 시작된다.
+        const 원래포커스 = document.activeElement;
+        let ta = null;
         try {
-            const ta = document.createElement('textarea');
+            ta = document.createElement('textarea');
             ta.value = text;
             ta.setAttribute('readonly', '');
             ta.style.position = 'fixed';
@@ -24,13 +28,23 @@ export async function copyText(text) {
             ta.select();
             ta.setSelectionRange(0, text.length);
             const ok = document.execCommand('copy');
-            document.body.removeChild(ta);
             if (ok)
                 return true;
         }
         catch {
             /* 폴백으로 진행 */
         }
+        finally {
+            // 성공·실패·던짐 어느 길이든 textarea 를 거두고 포커스를 되돌린다
+            if (ta?.parentNode)
+                ta.parentNode.removeChild(ta);
+            if (원래포커스 && 원래포커스 !== document.activeElement && typeof 원래포커스.focus === 'function' && 원래포커스.isConnected) {
+                try {
+                    원래포커스.focus({ preventScroll: true });
+                }
+                catch { /* 무시 */ }
+            }
+        }
     }
     // 2순위: Async Clipboard API
     try {

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

@@ -11,7 +11,8 @@
  * 곳곳에 흩어져 있어 여기 한 벌로 모은다.
  *
  * 문자열도 그대로 쓴다 — `throw '문구'` 로 던지는 자리가 있다. 끝내 못 읽는
- * 값(숫자·null·빈 객체·빈 문구)일 때만 fallback 을 쓴다.
+ * 값(숫자·null·빈 객체·빈 문구)일 때만 fallback 을 쓴다. fallback 을 주지 않으면 지금
+ * 언어의 '알 수 없는 오류'(`common.unknownError`), 주면 그 문구 그대로.
  *
  * 회원 앱은 `src/libs/errorUtils.ts` 가 이것을 다시 내보낸다 — 한 벌만 둔다.
  * @public

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

@@ -1,3 +1,16 @@
+import i18n from 'i18next';
+/**
+ * 못 읽을 때의 기본 문구 — 지금 언어로. 사전에 없거나 i18n 이 아직 안 섰으면 한국어.
+ *
+ * `src/i18n` 이 초기화하는 것도 i18next 의 **기본 인스턴스**다(묶음에서 i18next 는 external).
+ * 여기서 `../i18n` 을 가져오면 utils 묶음이 사전 JSON 과 init 부작용을 끌어안으므로 기본
+ * 인스턴스를 직접 본다. 초기화 전의 `i18n.t` 는 undefined 를 돌려준다.
+ */
+const 알수없는오류 = () => {
+    const 기본 = '알 수 없는 오류';
+    const s = typeof i18n?.t === 'function' ? i18n.t('common.unknownError', { defaultValue: 기본 }) : undefined;
+    return typeof s === 'string' && s ? s : 기본;
+};
 /**
  * 잡은 값에서 **사람이 읽을 수 있는 원인**을 꺼낸다.
  *
@@ -11,12 +24,16 @@
  * 곳곳에 흩어져 있어 여기 한 벌로 모은다.
  *
  * 문자열도 그대로 쓴다 — `throw '문구'` 로 던지는 자리가 있다. 끝내 못 읽는
- * 값(숫자·null·빈 객체·빈 문구)일 때만 fallback 을 쓴다.
+ * 값(숫자·null·빈 객체·빈 문구)일 때만 fallback 을 쓴다. fallback 을 주지 않으면 지금
+ * 언어의 '알 수 없는 오류'(`common.unknownError`), 주면 그 문구 그대로.
  *
  * 회원 앱은 `src/libs/errorUtils.ts` 가 이것을 다시 내보낸다 — 한 벌만 둔다.
  * @public
  */
-export function getErrorMessage(e, fallback = '알 수 없는 오류') {
+export function getErrorMessage(e, fallback) {
+    // 기본 문구는 부를 때마다 지금 언어로 만든다(모듈 로드 때 한 번 정하면 언어 전환을 못 따른다)
+    if (fallback === undefined)
+        fallback = 알수없는오류();
     if (e instanceof Error)
         return e.message || fallback;
     if (typeof e === 'string')

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

@@ -26,7 +26,14 @@ export type ComputeDailySelectionOptions = {
     counts?: TrainingCounts;
     forceRefresh?: boolean;
 };
-/** @public */
+/**
+ * 오늘·어제 세트를 뽑아 `TODAY_SETS`·`YESTERDAY_SETS` 에 채운다(`loadTrainingData` 가 부른다).
+ *
+ * **어제 세트는 "어제 뽑힌 세트" 가 아니다** — 캐시가 메모리에만 있어, 날이 바뀌면 어제 몫도 따로 새로 뽑는다.
+ * 사용자에게 보이는 오늘·어제 세트는 사용자와 날짜로 시드를 정하는 `useDailyTrainingSelection` 을 쓴다
+ * (같은 날 같은 사용자면 늘 같은 세트, 어제 세트도 어제와 같다).
+ * @public
+ */
 export declare function computeDailySelection({ counts, forceRefresh }?: ComputeDailySelectionOptions): {
     today: {
         [k: string]: unknown[];

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

@@ -18,7 +18,14 @@ const DEFAULT_TRAINING_COUNTS = { LISTEN_IN_NOISE: 3, SHORT_STORY: 2, LONG_STORY
 let _cachedCountsKey = null;
 let _cachedTodayDate = null;
 let _cachedSelection = null;
-/** @public */
+/**
+ * 오늘·어제 세트를 뽑아 `TODAY_SETS`·`YESTERDAY_SETS` 에 채운다(`loadTrainingData` 가 부른다).
+ *
+ * **어제 세트는 "어제 뽑힌 세트" 가 아니다** — 캐시가 메모리에만 있어, 날이 바뀌면 어제 몫도 따로 새로 뽑는다.
+ * 사용자에게 보이는 오늘·어제 세트는 사용자와 날짜로 시드를 정하는 `useDailyTrainingSelection` 을 쓴다
+ * (같은 날 같은 사용자면 늘 같은 세트, 어제 세트도 어제와 같다).
+ * @public
+ */
 export function computeDailySelection({ counts, forceRefresh } = {}) {
     const c = Object.assign({}, DEFAULT_TRAINING_COUNTS, counts || {});
     // 오늘의 훈련은 KST 자정에 바뀌어야 한다 — UTC 날짜를 쓰면 오전 9시에 바뀐다

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

@@ -83,19 +83,21 @@ export declare function wordHasSyllableMatching(word: string, parts: {
  */
 export declare function isSyllablePattern(query: string): boolean;
 /**
- * @public 음절 패턴 미니 DSL 매칭. 쉼표(,)로 나눈 조각을 자리(음절) 단위로 자동 분해하며,
- * **분해된 총 자리 수는 반드시 단어의 음절 수와 같아야** 매칭된다. 한 자리는 다음 중 하나:
+ * @public 음절 패턴 미니 DSL 매칭. 쉼표(,)로 나눈 조각을 연속된 음절 자리들로 풀고, 그 자리들이 단어의
+ * **어느 위치에서든 연속으로** 맞으면 매칭된다(포함 매칭 — 단어 음절 수가 자리 수보다 많아도 된다).
+ * 한 자리는 다음 중 하나:
  *  - 빈 자리(쉼표 사이가 비어 있음) — 무관(아무 음절이나 허용).
- *  - 완성 음절 한 글자(예: '가') — 그 자리 음절이 정확히 이 글자와 같아야 함.
+ *  - 완성 음절 한 글자(예: '가', '강') — 받침 없는 글자는 초성·중성만 같으면 되고(받침 무관: '수' → 수·술·숙),
+ *    받침 있는 글자는 정확히 같아야 함.
  *  - 자음/모음 한 글자(예: 'ㄴ', 'ㅏ') — 자음이면 그 자리 초성이, 모음이면 그 자리 중성이 정확히 그
  *    자모여야 함(나머지는 무관).
- *  - 초성·중성·종성 3자모 템플릿(예: '__ㄱ', 쉼표로 나눈 조각이 정확히 3글자일 때만) — 각 자리가 '_'면
- *    무관, 자모면 그 위치(초성/중성/종성)가 정확히 그 자모여야 함. 종성 자리 '_'는 받침 유무 모두 허용.
- * 쉼표 사이에 완성 음절·자음·모음을 이어 붙이면(예: '가ㄴ') 한 글자씩 각각 한 음절 자리로 자동 분해된다
- * (3글자로 붙이면 템플릿과 구분이 안 되므로 예외 — 그 경우는 쉼표로 나눠 쓴다).
- * 예: '가,,다' → 3음절, 첫 음절 '가' · 가운데 무관 · 끝 음절 '다'.
- * 예: '__ㄱ,고' → 2음절, 첫 음절 종성이 'ㄱ'(초성·중성 무관) · 끝 음절 '고'.
- * 예: '가ㄴ,,다'(= '가,ㄴ,,다'와 동일) → 4음절, 첫 음절 '가' · 둘째 음절 초성 'ㄴ' · 셋째 무관 · 넷째 '다'.
+ *  - 한 음절 템플릿(조각에 '_'가 하나라도 있을 때, 1~4글자) — 초성·중성·종성 순으로 읽고, '_'나 생략한 뒤
+ *    자리는 무관, 자모면 그 위치가 정확히 그 자모여야 함. 종성은 겹받침 두 자모('ㄹㄱ' = ㄺ)까지.
+ *    예: '__ㄱ' = 종성 ㄱ, 'ㄱ_' = 초성 ㄱ, 'ㄱ_ㄱ' = 초성 ㄱ·종성 ㄱ.
+ * '_' 없이 완성 음절·자음·모음을 이어 붙이면(예: '가ㄴ') 한 글자씩 각각 한 음절 자리로 분해된다.
+ * 예: '가,,다' → 첫 음절 '가'(받침 무관) · 가운데 무관 · 끝 음절 '다'인 연속 3음절을 포함한 단어.
+ * 예: '__ㄱ,고' → 종성 'ㄱ'인 음절 바로 뒤에 '고'가 오는 단어(먹고·박고구마 …).
+ * 예: '가ㄴ,,다'(= '가,ㄴ,,다'와 동일) → 연속 4음절 '가' · 초성 'ㄴ' · 무관 · '다'.
  * 해석할 수 없는 글자(자음·모음·완성 음절이 아님)가 섞이면 그 자리는 항상 매칭 실패 처리되어 결과가
  * 0건이 된다(조용히 무관 처리하지 않는다 — 제약이 무시된 채 결과가 나오는 오해를 막기 위해).
  */
@@ -117,8 +119,9 @@ export declare function patternToComposition(pattern: string): {
 } | null;
 /**
  * @public 단어 검색 '글자 입력'의 형식 유효성 검사.
- * 허용: 완성 음절('가'), 초성/중성 자모('ㄱ'·'ㅏ'), 초성·중성·종성 3자모 템플릿('__ㄱ', 정확히 3글자),
- * 쉼표(,) 구분(빈 자리는 '무관'). 그 외(예: '_' 오용, 라틴 문자, 한 자리에 음소 4개 이상인 '___ㄱ')는 무효.
+ * 허용: 완성 음절('가'), 초성/중성 자모('ㄱ'·'ㅏ'), '_'가 든 한 음절 템플릿(1~4글자, 초성·중성·종성 순 —
+ * '__ㄱ'·'ㄱ_'·'ㄱ_ㄹㄱ'), 쉼표(,) 구분(빈 자리는 '무관'). 그 외(예: 5글자 이상 템플릿, 템플릿 자리에 맞지 않는
+ * 자모('ㅏ_'), 라틴 문자)는 무효.
  * @returns 유효하면 `{ ok: true }`, 아니면 `{ ok: false }`(호출부가 안내 문구를 표시).
  */
 export declare function validateSyllableSearchInput(input: string): {