@ihabdevteam/core 0.127.0 → 0.130.0

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

@@ -1,5 +1,7 @@
 'use client';
 import { useCallback, useState } from 'react';
+/** form.direction 이 '좌'·'우' 가 아니면 null — 캐스팅만 하면 devices['엉뚱한값'] 같은 열쇠가 생긴다 */
+const toSide = (d) => (d === '좌' || d === '우' ? d : null);
 /**
  * 보청기 기기 등록 / 이력 관리 상태를 캡슐화한 훅.
  */
@@ -16,14 +18,21 @@ export function useDeviceManagement() {
     // form.direction은 각 팝업(DeviceRegistrationPopup의 방향 드롭다운, DeviceListPopup의
     // 좌/우 탭)에서 사용자가 실제로 고른 값이다 — deviceDirection/listForSide는 팝업을 열 때의
     // 초기값일 뿐이라 팝업 내부에서 방향을 바꾸면 더 이상 실제 선택과 일치하지 않는다.
+    // 방향이 비었거나 '좌'·'우' 밖이면 **아무것도 바꾸지 않는다** — 예전에는 검사 없이 캐스팅해
+    // devices·deviceHistory 에 없는 열쇠가 생겼고 prev[side] 가 undefined 라 이력 펼치기에서 터졌다.
+    // 팝업은 닫지 않는다(사용자가 방향을 고르고 다시 제출할 수 있게).
     const handleDeviceSubmit = useCallback((form) => {
-        const side = form.direction;
+        const side = toSide(form.direction);
+        if (!side)
+            return;
         setDevices(prev => ({ ...prev, [side]: form }));
         setDeviceHistory(prev => ({ ...prev, [side]: [form, ...prev[side]] }));
         setShowDevice(false);
     }, []);
     const handleSelectFromList = useCallback((form) => {
-        const side = form.direction;
+        const side = toSide(form.direction);
+        if (!side)
+            return;
         setDevices(prev => ({ ...prev, [side]: form }));
         setShowDeviceList(false);
     }, []);

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

@@ -12,7 +12,9 @@ baseFont = 20, minScale = 0.8, maxScale = 1.4, step = 0.1, lineHeightRatio = 1.4
             // 손상된/비숫자 저장값(Number(raw) === NaN)이 그대로 초기값이 되면 scale이 NaN으로
             // 고정되어 canIncrease/canDecrease 비교가 항상 false가 되고 fontSize/lineHeight도
             // NaN이 된다 — 파싱 실패 시 기본값(1)으로 폴백한다.
-            return Number.isFinite(parsed) ? parsed : 1;
+            // 범위 밖 저장값(다른 min/max 로 저장했거나 손으로 고친 값)도 조인다 — 안 조이면 첫 화면이
+            // 범위 밖 크기로 그려지고 canIncrease/canDecrease 가 둘 다 한쪽으로 쏠린다.
+            return Number.isFinite(parsed) ? clamp(parsed) : clamp(1);
         }
         catch (e) {
             return 1;

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

@@ -1,10 +1,9 @@
 /**
  * 아이콘 이름을 받아 lucide 컴포넌트를 돌려줍니다.
  *
- * 자주 쓰는 아이콘은 정적으로 번들되어 첫 렌더에, 서버 렌더에서도 바로
- * 나옵니다. 목록에 없는 이름만 아이콘 하나를 지연 로드하므로 그때만 잠깐
- * 비어 보입니다 — 어떤 아이콘이 목록에 있는지는
- * `utils/lucideIconSet.ts` 참조.
+ * 정적 목록(`utils/lucideIconSet.ts`)에 있는 아이콘은 첫 렌더에, 서버 렌더에서도
+ * 바로 나옵니다. 목록에 없는 이름은 `null` 을 돌려줍니다 — 받아 오지 않으며,
+ * 개발 모드에서 이름당 한 번 경고를 남깁니다. URL·에셋 경로도 `null` 입니다.
  *
  * @example
  * const HomeIcon = useLucideIcon('home')

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

@@ -36,10 +36,9 @@ const lazyCache = new Map();
 /**
  * 아이콘 이름을 받아 lucide 컴포넌트를 돌려줍니다.
  *
- * 자주 쓰는 아이콘은 정적으로 번들되어 첫 렌더에, 서버 렌더에서도 바로
- * 나옵니다. 목록에 없는 이름만 아이콘 하나를 지연 로드하므로 그때만 잠깐
- * 비어 보입니다 — 어떤 아이콘이 목록에 있는지는
- * `utils/lucideIconSet.ts` 참조.
+ * 정적 목록(`utils/lucideIconSet.ts`)에 있는 아이콘은 첫 렌더에, 서버 렌더에서도
+ * 바로 나옵니다. 목록에 없는 이름은 `null` 을 돌려줍니다 — 받아 오지 않으며,
+ * 개발 모드에서 이름당 한 번 경고를 남깁니다. URL·에셋 경로도 `null` 입니다.
  *
  * @example
  * const HomeIcon = useLucideIcon('home')

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

@@ -1,5 +1,7 @@
 'use client';
 import { useCallback, useEffect, useRef, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { getErrorMessage } from '../utils/errorMessage';
 /**
  * 비밀번호 변경 폼 상태와 핸들러를 캡슐화한 훅.
  * showModal 상태는 컴포넌트가 직접 관리 (훅 밖에 두어야 모달 열기 트리거 제어 가능).
@@ -8,6 +10,7 @@ import { useCallback, useEffect, useRef, useState } from 'react';
  * @public
  */
 export function usePasswordChange(onChangePassword) {
+    const { t } = useTranslation();
     const [pw, setPw] = useState({ current: '', next: '', confirm: '' });
     const [pwMsg, setPwMsg] = useState(null);
     const [pwLoading, setPwLoading] = useState(false);
@@ -24,31 +27,41 @@ export function usePasswordChange(onChangePassword) {
     }, []);
     const handleChangePw = useCallback(async () => {
         if (!pw.current) {
-            setPwMsg({ type: 'error', text: '현재 비밀번호를 입력하세요.' });
+            setPwMsg({ type: 'error', text: t('account.security.password.currentRequired', '현재 비밀번호를 입력하세요.') });
             return;
         }
         // 길이·복잡도 규칙은 onChangePassword(앱 측)가 관리자 보안 정책으로 검증한다 —
         // 여기서 고정 규칙을 두면 정책과 불일치가 생기므로 빈 값만 거른다.
         if (!pw.next) {
-            setPwMsg({ type: 'error', text: '새 비밀번호를 입력하세요.' });
+            setPwMsg({ type: 'error', text: t('account.security.password.newRequired', '새 비밀번호를 입력하세요.') });
             return;
         }
         if (pw.next !== pw.confirm) {
-            setPwMsg({ type: 'error', text: '새 비밀번호가 일치하지 않습니다.' });
+            setPwMsg({ type: 'error', text: t('account.security.password.mismatch', '새 비밀번호가 일치하지 않습니다.') });
             return;
         }
         setPwLoading(true);
-        const err = onChangePassword ? await onChangePassword(pw.current, pw.next) : null;
-        setPwLoading(false);
+        // 콜백이 문구 대신 **거절**하면(망 끊김 등) 로딩이 true 로 남아 단추가 영영 잠겼고,
+        // reset() 도 로딩은 안 건드려 풀 길이 없었다. 거절도 오류 문구로 보이고 로딩은 늘 내린다.
+        let err;
+        try {
+            err = onChangePassword ? await onChangePassword(pw.current, pw.next) : null;
+        }
+        catch (e) {
+            err = getErrorMessage(e);
+        }
+        finally {
+            setPwLoading(false);
+        }
         if (err) {
             setPwMsg({ type: 'error', text: err });
             return;
         }
-        setPwMsg({ type: 'success', text: '비밀번호가 변경되었습니다.' });
+        setPwMsg({ type: 'success', text: t('account.security.password.changed', '비밀번호가 변경되었습니다.') });
         setPw({ current: '', next: '', confirm: '' });
         if (clearTimerRef.current !== null)
             clearTimeout(clearTimerRef.current);
         clearTimerRef.current = setTimeout(() => setPwMsg(null), 1500);
-    }, [pw, onChangePassword]);
+    }, [pw, onChangePassword, t]);
     return { pw, setPw, pwMsg, setPwMsg, pwLoading, handleChangePw, reset };
 }

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