@ihabdevteam/core 0.322.0 → 0.323.0

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

@@ -5,13 +5,13 @@ import { resolveAssetUrl } from '../utils';
 /* 속성 값이 **문서 밖을 가리키는** url( 을 품었나. `url(#그라데이션)`·`url(#clip)` 처럼 같은 SVG 안의 조각만 가리키는 것은 둔다 —
    코어 로고 서른여섯 장이 clip-path·fill 로 그것을 쓴다(걷으면 인라인으로 그린 로고가 깨진다).
    CSS 이스케이프로 url 을 숨긴 꼴(역슬래시 + 괄호)도 걷는다 — 아이콘 속성에 그런 값을 쓸 까닭이 없다. */
-function 바깥url있나(value) {
+function hasExternalUrl(value) {
     if (value.includes('\\') && value.includes('('))
         return true;
     if (!/url\s*\(/i.test(value))
         return false;
-    const 조각만뺀 = value.replace(/url\(\s*(['"]?)#[^)'"]*\1\s*\)/gi, '');
-    return /url\s*\(/i.test(조각만뺀);
+    const withoutFragments = value.replace(/url\(\s*(['"]?)#[^)'"]*\1\s*\)/gi, '');
+    return /url\s*\(/i.test(withoutFragments);
 }
 function sanitizeSvg(raw) {
     if (typeof window === 'undefined')
@@ -19,11 +19,11 @@ function sanitizeSvg(raw) {
     /* 인라인 SVG 에서 **바깥 자원을 부르는 길** 을 걷는다 — `<style>`(@import·background:url) 과 바깥 url( 이 든 속성(style·fill·filter…).
        그대로 두면 아이콘 한 장이 제3자 주소로 요청을 보내거나(추적) CSS 로 화면을 덮을 수 있었다.
        훅은 DOMPurify 전역에 붙으므로 이 한 번의 sanitize 동안만 걸고 곧바로 뗀다(앱의 다른 DOMPurify 쓰임에 새지 않게). */
-    const 훅 = (_node, data) => {
-        if (typeof data.attrValue === 'string' && 바깥url있나(data.attrValue))
+    const hook = (_node, data) => {
+        if (typeof data.attrValue === 'string' && hasExternalUrl(data.attrValue))
             data.keepAttr = false;
     };
-    DOMPurify.addHook('uponSanitizeAttribute', 훅);
+    DOMPurify.addHook('uponSanitizeAttribute', hook);
     try {
         return DOMPurify.sanitize(raw, {
             USE_PROFILES: { svg: true, svgFilters: true },
@@ -32,7 +32,7 @@ function sanitizeSvg(raw) {
         });
     }
     finally {
-        DOMPurify.removeHook('uponSanitizeAttribute', 훅);
+        DOMPurify.removeHook('uponSanitizeAttribute', hook);
     }
 }
 /** @public */

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

@@ -42,8 +42,8 @@ export function useListControls(opts = {}) {
     const [page, setPage] = useState(1);
     /* 못 읽히는 쪽크기('' · 'all' · '0')는 기본값으로 — 그 셈이 화면마다 한 벌씩 있었다.
        기본값 자체가 못 읽히면 25 다. 목록이 통째로 사라지는 값(0·NaN)을 여기서 닫는다. */
-    const 기본수 = Number(defaultPageSize) || 25;
-    const perPage = Number(pageSize) || 기본수;
+    const defaultSize = Number(defaultPageSize) || 25;
+    const perPage = Number(pageSize) || defaultSize;
     /* **검색어와 쪽크기를 여기서 넣는다** — 부르는 쪽이 적으면 빠뜨릴 수 있고, 빠뜨려도 안 빨개진다.
        이어 붙이는 것은 `usePageResetOnChange` 가 글 하나를 받기 때문이고, 값이 글·수·참거짓뿐이라
        `[object Object]` 로 뭉개질 일이 없다(타입이 막는다). */

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

@@ -22,9 +22,9 @@ import { useState } from 'react';
  * @public
  */
 export function usePageResetOnChange(key, setPage) {
-    const [본열쇠, set본열쇠] = useState(key);
-    if (본열쇠 !== key) {
-        set본열쇠(key);
+    const [seenKey, setSeenKey] = useState(key);
+    if (seenKey !== key) {
+        setSeenKey(key);
         setPage(1);
     }
 }

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

@@ -17,7 +17,7 @@ export function usePasswordChange(onChangePassword) {
     const clearTimerRef = useRef(null);
     /* 처리 중에는 다시 받지 않는다 — 두 번 누르면 변경이 두 번 나가, 먼저 온 성공 뒤에 늦게 온 "현재 비밀번호 틀림" 이
        남아 바뀌었는데 오류 문구가 떴다(말귀 계정 화면 단추는 로딩 중에도 눌린다) */
-    const 처리중Ref = useRef(false);
+    const busyRef = useRef(false);
     useEffect(() => {
         return () => {
             if (clearTimerRef.current !== null)
@@ -29,7 +29,7 @@ export function usePasswordChange(onChangePassword) {
         setPwMsg(null);
     }, []);
     const handleChangePw = useCallback(async () => {
-        if (처리중Ref.current)
+        if (busyRef.current)
             return;
         if (!pw.current) {
             setPwMsg({ type: 'error', text: t('account.security.password.currentRequired', '현재 비밀번호를 입력하세요.') });
@@ -46,7 +46,7 @@ export function usePasswordChange(onChangePassword) {
             return;
         }
         setPwLoading(true);
-        처리중Ref.current = true;
+        busyRef.current = true;
         // 콜백이 문구 대신 **거절**하면(망 끊김 등) 로딩이 true 로 남아 단추가 영영 잠겼고,
         // reset() 도 로딩은 안 건드려 풀 길이 없었다. 거절도 오류 문구로 보이고 로딩은 늘 내린다.
         let err;
@@ -57,7 +57,7 @@ export function usePasswordChange(onChangePassword) {
             err = getErrorMessage(e);
         }
         finally {
-            처리중Ref.current = false;
+            busyRef.current = false;
             setPwLoading(false);
         }
         if (err) {

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

@@ -7,19 +7,19 @@ import { useCallback, useEffect, useRef, useState } from 'react';
  */
 export function usePendingPress(fn) {
     const [pending, setPending] = useState(false);
-    const 진행중 = useRef(false);
-    const 붙어있음 = useRef(true);
-    useEffect(() => { 붙어있음.current = true; return () => { 붙어있음.current = false; }; }, []);
+    const running = useRef(false);
+    const mounted = useRef(true);
+    useEffect(() => { mounted.current = true; return () => { mounted.current = false; }; }, []);
     const press = useCallback(() => {
-        if (!fn || 진행중.current)
+        if (!fn || running.current)
             return;
         const r = fn();
         if (r && typeof r.then === 'function') {
-            진행중.current = true;
+            running.current = true;
             setPending(true);
-            const 풀기 = () => { 진행중.current = false; if (붙어있음.current)
+            const settle = () => { running.current = false; if (mounted.current)
                 setPending(false); };
-            r.then(풀기, 풀기);
+            r.then(settle, settle);
         }
     }, [fn]);
     return { pending, press };

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

@@ -3,7 +3,7 @@ import { useCallback } from 'react';
 import { useTranslation } from 'react-i18next';
 import { getTodayKst, toKstYmd } from '../utils/date';
 /** 'YYYY-MM-DD' 두 날짜 사이의 달력날 수 */
-function 날수(from, to) {
+function dayDiff(from, to) {
     const [fy, fm, fd] = from.split('-').map(Number);
     const [ty, tm, td] = to.split('-').map(Number);
     return Math.round((Date.UTC(ty, tm - 1, td) - Date.UTC(fy, fm - 1, fd)) / 86400000);
@@ -23,10 +23,10 @@ export function useRelativeDay() {
     return useCallback((iso) => {
         if (!iso)
             return '';
-        const 그날 = toKstYmd(iso);
-        if (!그날)
+        const ymd = toKstYmd(iso);
+        if (!ymd)
             return '';
-        const days = 날수(그날, getTodayKst());
+        const days = dayDiff(ymd, getTodayKst());
         if (days <= 0)
             return t('myHomework.relativeDay.today', '오늘');
         if (days === 1)

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

@@ -26,7 +26,7 @@ export function useSoundCompassExam(speakers, { mode = 'playback', autoStart = f
     useEffect(() => () => clearTimers(), []);
     const answerId = queue[index]?.id ?? null;
     /** 이미 고른 문항 번호 — 새 문항이 대기에 들어가면 풀린다(playQuestion) */
-    const 고름잠금 = useRef(null);
+    const pickLockRef = useRef(null);
     // ── playback: 모든 스피커를 순서대로 ──────────────────────────────────
     const runPlayback = useCallback(() => {
         clearTimers();
@@ -49,7 +49,7 @@ export function useSoundCompassExam(speakers, { mode = 'playback', autoStart = f
             onDoneRef.current?.({ score: scoreRef.current, total: q.length });
             return;
         }
-        고름잠금.current = null;
+        pickLockRef.current = null;
         setIndex(i);
         setSelectedId(null);
         setPhase('playing');
@@ -87,7 +87,7 @@ export function useSoundCompassExam(speakers, { mode = 'playback', autoStart = f
     /* eslint-disable react-hooks/set-state-in-effect */
     /* 배치가 바뀌었는지는 **스피커 id 들**로 본다 — 개수만 보면 수가 같은 다른 배치(HORIZON_7 ↔ PRESET_27 가로)로 바꿔도
        초기화되지 않아 옛 문제 줄이 남고 정답 id 가 새 배치에 없어 무엇을 골라도 오답이었다. */
-    const 배치열쇠 = speakers.map((sp) => sp.id).join('|');
+    const layoutKey = speakers.map((sp) => sp.id).join('|');
     useEffect(() => {
         if (autoStart)
             start();
@@ -96,14 +96,14 @@ export function useSoundCompassExam(speakers, { mode = 'playback', autoStart = f
         // 배치·모드가 바뀌거나 떠날 때 앞 판의 예약을 걷는다
         return () => clearTimers();
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [mode, 배치열쇠, autoStart]);
+    }, [mode, layoutKey, autoStart]);
     /* eslint-enable react-hooks/set-state-in-effect */
     const onSelectSpeaker = useCallback((id) => {
         /* 같은 대기에서 **한 번만** 받는다 — 다시 그려지기 전에 같은 핸들러가 두 번 불리면(렌더 시점의 phase 만 보면) 점수가 +2,
            다음 문제가 두 번 예약됐다. 고르는 순간 ref 로 닫는다. */
-        if (phase !== 'waiting' || mode === 'playback' || 고름잠금.current === index)
+        if (phase !== 'waiting' || mode === 'playback' || pickLockRef.current === index)
             return;
-        고름잠금.current = index;
+        pickLockRef.current = index;
         setSelectedId(id);
         const correct = id === queue[index]?.id;
         if (correct)

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

@@ -78,15 +78,4 @@ export declare function useTableSort<K extends string>(opts?: TableSortOptions<K
         onClick: () => void;
     };
     sortRows: <R>(rows: readonly R[], getValue: (row: R, key: K) => unknown) => readonly R[];
-    /** @deprecated `sort` 를 쓴다 — 같은 값이다(2026-10-13) */
-    정렬: {
-        key: K;
-        asc: boolean;
-    } | null;
-    /** @deprecated `field` 를 쓴다 — 같은 함수다(2026-10-13) */
-    칸: (label: string, key: K) => {
-        label: string;
-        sortDir: "desc" | "asc" | null;
-        onClick: () => void;
-    };
 };

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

@@ -26,17 +26,17 @@ import { compareCellBlankLast } from '../utils/textSort';
 export function useTablePaging(rows, resetOn, opts) {
     const { t } = useTranslation();
     const [pageSize, setPageSizeRaw] = useState(() => {
-        const 처음 = opts?.initialPageSize;
-        return 처음 && VAP_PAGE_SIZE_OPTIONS.some(o => o.value === 처음) ? 처음 : '25';
+        const initial = opts?.initialPageSize;
+        return initial && VAP_PAGE_SIZE_OPTIONS.some(o => o.value === initial) ? initial : '25';
     });
     const [page, setPage] = useState(1);
     /* 늘어놓는 차례가 바뀌면 첫 쪽으로 — 3쪽을 보던 중에 정렬하면 무엇이 위로 왔는지
        못 본다. 렌더 중에 되돌린다(저장소의 다른 곳들과 같은 꼴: 값이 바뀐 그 렌더에서
        바로 맞춰야 한 박자 늦은 화면이 안 뜬다). */
-    const [본것, set본것] = useState(resetOn);
+    const [seen, setSeen] = useState(resetOn);
     // Object.is — NaN 이면 `!==` 가 늘 참이라 렌더가 끝나지 않았다. 객체는 렌더마다 새로 만들면 매번 바뀐 것이다(원시값을 넘길 것)
-    if (!Object.is(본것, resetOn)) {
-        set본것(resetOn);
+    if (!Object.is(seen, resetOn)) {
+        setSeen(resetOn);
         if (page !== 1)
             setPage(1);
     }
@@ -50,14 +50,14 @@ export function useTablePaging(rows, resetOn, opts) {
     // 1 보다 작은 쪽(setPage(0)·-1)도 막는다 — 0 은 빈 쪽, -1 은 음수 slice 로 엉뚱한 줄이 나왔다
     if (page > total || page < 1 || !Number.isFinite(page))
         setPage(Math.min(Math.max(1, Number.isFinite(page) ? page : 1), total));
-    const 이쪽 = Math.min(Math.max(1, Number.isFinite(page) ? page : 1), total);
-    const pageRows = useMemo(() => rows.slice((이쪽 - 1) * Number(pageSize), 이쪽 * Number(pageSize)), [rows, 이쪽, pageSize]);
+    const clampedPage = Math.min(Math.max(1, Number.isFinite(page) ? page : 1), total);
+    const pageRows = useMemo(() => rows.slice((clampedPage - 1) * Number(pageSize), clampedPage * Number(pageSize)), [rows, clampedPage, pageSize]);
     return {
         pageRows,
         /** Toolbar 의 pageSize 자리에 그대로 넣는다 */
         pageSizeProps: { options: pageSizeOptions, value: pageSize, onChange: setPageSize },
         /** Toolbar 의 pagination 자리에 그대로 넣는다 */
-        paginationProps: { page: 이쪽, total, onChange: setPage },
+        paginationProps: { page: clampedPage, total, onChange: setPage },
         setPage,
     };
 }
@@ -79,42 +79,37 @@ export function useTablePaging(rows, resetOn, opts) {
  * @public
  */
 export function useTableSort(opts) {
-    const [정렬, 정렬바꾸기] = useState(null);
+    const [sortState, setSortState] = useState(null);
     /* 다음 정렬은 **ref 에서** 계산해 알린다 — 갱신 함수 안에서 부르면 StrictMode 가 두 번 부른다 */
-    const 지금정렬 = useRef(정렬);
-    const 알림 = useRef(opts?.onSortChange);
-    알림.current = opts?.onSortChange;
-    const 누름 = useCallback((key) => {
-        const 앞 = 지금정렬.current;
-        const 다음 = 앞?.key === key ? { key, asc: !앞.asc } : { key, asc: true };
-        지금정렬.current = 다음;
-        정렬바꾸기(다음);
-        알림.current?.(다음);
+    const sortRef = useRef(sortState);
+    const onChangeRef = useRef(opts?.onSortChange);
+    onChangeRef.current = opts?.onSortChange;
+    const onHeadClick = useCallback((key) => {
+        const prev = sortRef.current;
+        const next = prev?.key === key ? { key, asc: !prev.asc } : { key, asc: true };
+        sortRef.current = next;
+        setSortState(next);
+        onChangeRef.current?.(next);
     }, []);
     /** Table 의 field 하나에 붙일 것 — 라벨과 함께 쓴다 */
-    const 칸 = useCallback((label, key) => ({
+    const fieldHead = useCallback((label, key) => ({
         label,
-        sortDir: 정렬?.key === key ? (정렬.asc ? 'asc' : 'desc') : null,
-        onClick: () => 누름(key),
-    }), [정렬, 누름]);
+        sortDir: sortState?.key === key ? (sortState.asc ? 'asc' : 'desc') : null,
+        onClick: () => onHeadClick(key),
+    }), [sortState, onHeadClick]);
     /** 지금 정렬로 세운 새 배열(정렬 없으면 받은 배열 그대로). 빈 값은 오름·내림 모두 맨 뒤. */
     const sortRows = useCallback((rows, getValue) => {
-        if (!정렬)
+        if (!sortState)
             return rows;
-        const { key, asc } = 정렬;
+        const { key, asc } = sortState;
         return [...rows].sort((a, b) => compareCellBlankLast(getValue(a, key), getValue(b, key), asc));
-    }, [정렬]);
+    }, [sortState]);
     /* 쪽넘김에 그대로 건넨다 — 차례가 바뀌면 첫 쪽으로 돌아가게.
-       **영어 이름이 정본이다**(`sort`·`field`) — 공개 API 는 영어라야 한다(사용자 지시 2026-10-13).
-       한글 이름(`정렬`·`칸`)은 **같은 것을 가리키는 옛 이름**으로 남긴다: 말귀가 77 줄에서 그 이름으로
-       풀어 쓰고 있어, 한 번에 걷으면 그 저장소가 통째로 빨개진다. 그쪽이 옮긴 뒤 걷는다. */
+       **옛 한글 이름(`정렬`·`칸`)은 2026-10-13 걷었다** — 소비자가 다 옮긴 것을 세어 보고 걷었다
+       (말귀의 코어 `useTableSort` 자리 열, 전부 `{ sort, field }`. kscan·소리방향성·fe 는 0). */
     return {
-        sort: 정렬,
-        field: 칸,
+        sort: sortState,
+        field: fieldHead,
         sortRows,
-        /** @deprecated `sort` 를 쓴다 — 같은 값이다(2026-10-13) */
-        정렬,
-        /** @deprecated `field` 를 쓴다 — 같은 함수다(2026-10-13) */
-        칸,
     };
 }

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

@@ -54,72 +54,72 @@ import { logTrainingTime } from '../utils/trainingLogger';
  * @public
  */
 /** 지금 그 갈래의 시간을 적고 있는 주인 — 갈래마다 하나(위 머리말 참고) */
-const 적는주인 = new Set();
+const writers = new Set();
 export default function useTrainingSessionLog(trainingType) {
     useEffect(() => {
         if (!trainingType)
             return; // 타입 미상이면 기록하지 않음
         /* **갈래마다 주인은 하나다.** 이미 누가 적고 있으면 조용히 물러난다 — 안 그러면
            두 창이 제 시간을 따로 적어 겹친 만큼이 두 번 세어진다. */
-        if (적는주인.has(trainingType))
+        if (writers.has(trainingType))
             return;
-        적는주인.add(trainingType);
-        const 보임 = () => typeof document === 'undefined' || document.visibilityState !== 'hidden';
-        let 처음보임 = null;
-        let 구간시작 = null;
-        let 모은ms = 0;
-        let 보낸ms = 0; // 지금까지 줄로 내보낸 누계 — 다음 줄은 여기서부터 이어 붙인다
-        const 구간열기 = () => { const t = Date.now(); if (처음보임 == null)
-            처음보임 = t; if (구간시작 == null)
-            구간시작 = t; };
-        const 구간닫기 = () => { if (구간시작 != null) {
-            모은ms += Date.now() - 구간시작;
-            구간시작 = null;
+        writers.add(trainingType);
+        const isVisible = () => typeof document === 'undefined' || document.visibilityState !== 'hidden';
+        let firstVisibleAt = null;
+        let spanStartedAt = null;
+        let accumulatedMs = 0;
+        let sentMs = 0; // 지금까지 줄로 내보낸 누계 — 다음 줄은 여기서부터 이어 붙인다
+        const openSpan = () => { const t = Date.now(); if (firstVisibleAt == null)
+            firstVisibleAt = t; if (spanStartedAt == null)
+            spanStartedAt = t; };
+        const closeSpan = () => { if (spanStartedAt != null) {
+            accumulatedMs += Date.now() - spanStartedAt;
+            spanStartedAt = null;
         } };
-        if (보임())
-            구간열기();
+        if (isVisible())
+            openSpan();
         /* 아직 안 보낸 만큼을 한 줄로. 끝 시각은 처음 보인 때 + 모은 시간, 시작 시각은 앞 줄이
            끝난 자리 — 줄끼리 겹치지 않으니 합산해도 이중으로 세지 않는다.
            전달은 등록된 로거(logTrainingTime)로 간다. 코어는 보낼 주소를 모르므로
            navigator.sendBeacon 을 여기서 직접 쓸 수 없다 — 앱이 등록하는 로거의 몫이다. */
-        const 보내기 = () => {
-            구간닫기();
-            if (처음보임 == null)
+        const send = () => {
+            closeSpan();
+            if (firstVisibleAt == null)
                 return;
-            const 남은ms = 모은ms - 보낸ms;
+            const pendingMs = accumulatedMs - sentMs;
             /* 1초가 안 되는 조각은 보내지 않는다 — 서버(log_training_category_time)가 1초 미만 줄을 버리므로
                부르기 제한(10분 60번)만 축낸다(말귀 확인 2026-09-16). */
-            if (남은ms < 1000)
+            if (pendingMs < 1000)
                 return;
             // 첫 줄에만 5초 문턱을 건다(잘못 열었다 닫은 판). 한 번 보낸 판은 이미 실재하는
             // 훈련이라, 돌아와 더 한 시간은 짧아도 버리지 않는다.
-            if (보낸ms === 0 && 모은ms < 5000)
+            if (sentMs === 0 && accumulatedMs < 5000)
                 return;
-            const 시작ms = 처음보임 + 보낸ms;
-            보낸ms = 모은ms;
+            const startMs = firstVisibleAt + sentMs;
+            sentMs = accumulatedMs;
             logTrainingTime({
                 trainingType,
-                startedAt: new Date(시작ms).toISOString(),
-                endedAt: new Date(처음보임 + 모은ms).toISOString(),
+                startedAt: new Date(startMs).toISOString(),
+                endedAt: new Date(firstVisibleAt + accumulatedMs).toISOString(),
             });
         };
         // 숨으면 보낸다(앱이 그대로 죽을 수 있다). 다시 보이면 이어서 모은다.
-        const 보임바뀜 = () => { if (보임())
-            구간열기();
+        const onVisibilityChange = () => { if (isVisible())
+            openSpan();
         else
-            보내기(); };
+            send(); };
         if (typeof document !== 'undefined')
-            document.addEventListener('visibilitychange', 보임바뀜);
+            document.addEventListener('visibilitychange', onVisibilityChange);
         // 페이지가 내려가면(탭·앱 닫기) React 정리가 안 돈다 — 그때 보낸다
         if (typeof window !== 'undefined')
-            window.addEventListener('pagehide', 보내기);
+            window.addEventListener('pagehide', send);
         return () => {
             if (typeof document !== 'undefined')
-                document.removeEventListener('visibilitychange', 보임바뀜);
+                document.removeEventListener('visibilitychange', onVisibilityChange);
             if (typeof window !== 'undefined')
-                window.removeEventListener('pagehide', 보내기);
-            보내기();
-            적는주인.delete(trainingType);
+                window.removeEventListener('pagehide', send);
+            send();
+            writers.delete(trainingType);
         };
     }, [trainingType]);
 }

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

@@ -13,10 +13,10 @@ import { useEditableList, isSameEditableItem } from './useEditableList';
  * 없었다** — V8 의 TimSort 는 같은 값 구간에서 비교를 아예 안 불러, 뒤섞인 자료로
  * 재 봐도 결과가 같았다(실측). 그래서 이 한 가지는 시험으로 못 박는다.
  */
-const 정렬키 = (v) => `${v.year.padStart(4, '0')}-${v.month.padStart(2, '0')}-${v.day.padStart(2, '0')}` +
+const sortKeyOf = (v) => `${v.year.padStart(4, '0')}-${v.month.padStart(2, '0')}-${v.day.padStart(2, '0')}` +
     ` ${v.hour.padStart(2, '0')}:${v.minute.padStart(2, '0')}`;
 const sortByDate = (list) => [...list].sort((a, b) => {
-    const x = 정렬키(a), y = 정렬키(b);
+    const x = sortKeyOf(a), y = sortKeyOf(b);
     return x < y ? -1 : x > y ? 1 : 0;
 });
 const emptyScheduleItem = { year: '', month: '', day: '', hour: '09', minute: '00', memo: '' };
@@ -34,8 +34,8 @@ initialSchedule = []) {
        useMemo 로 묶는 것은 성능 때문이 아니라 **되돌이를 막기 위해서다** —
        useEditableList 는 초기 목록을 원소 참조로 견주는데, 렌더마다 새 배열을 만들면
        원소는 같아도 매번 setList 가 돌아 무한 렌더가 된다. */
-    const 정렬된초기목록 = useMemo(() => sortByDate(initialSchedule), [initialSchedule]);
-    const { list: scheduleList, setList: setScheduleList, selected: selectedSchedule, setSelected: setSelectedSchedule, isEditing: isEditingSchedule, setIsEditing: setIsEditingSchedule, editForm: editScheduleForm, setEditForm: setEditScheduleForm, openDetail: openScheduleDetail, commitEdit, remove, } = useEditableList(emptyScheduleItem, 정렬된초기목록);
+    const sortedInitial = useMemo(() => sortByDate(initialSchedule), [initialSchedule]);
+    const { list: scheduleList, setList: setScheduleList, selected: selectedSchedule, setSelected: setSelectedSchedule, isEditing: isEditingSchedule, setIsEditing: setIsEditingSchedule, editForm: editScheduleForm, setEditForm: setEditScheduleForm, openDetail: openScheduleDetail, commitEdit, remove, } = useEditableList(emptyScheduleItem, sortedInitial);
     /** 미방문 처리된 예약 — 삭제하지 않고 보존해 통합 방문 목록에서 뱃지로 표시 */
     const [noShowList, setNoShowList] = useState([]);
     const { year: ty, month: tm, day: td } = today();

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

@@ -119,22 +119,22 @@ export function buildPositionSection(t, opts) {
  * 저장할 때는 `toWordAttributeFilterCodes` 로 코드 모양을 함께 담는다.
  */
 export function toggleAttributeFilter(prev, value, sectionLabel) {
-    const 섹션 = wordAttributeSectionOf(sectionLabel);
-    const 값코드 = 섹션 && value !== FILTER_ALL_VALUE ? wordAttributeValueCodeOf(섹션, value) : null;
-    if (섹션 && (value === FILTER_ALL_VALUE || 값코드)) {
-        const 남김 = {};
-        const 같은섹션 = {};
+    const section = wordAttributeSectionOf(sectionLabel);
+    const valueCode = section && value !== FILTER_ALL_VALUE ? wordAttributeValueCodeOf(section, value) : null;
+    if (section && (value === FILTER_ALL_VALUE || valueCode)) {
+        const kept = {};
+        const sameSection = {};
         for (const [k, v] of Object.entries(prev))
-            (wordAttributeSectionOf(k) === 섹션 ? 같은섹션 : 남김)[k] = v;
+            (wordAttributeSectionOf(k) === section ? sameSection : kept)[k] = v;
         if (value === FILTER_ALL_VALUE)
-            return 남김;
-        const 지금 = toWordAttributeFilterCodes(같은섹션)[섹션] ?? [];
-        const 다음 = 지금.includes(값코드) ? 지금.filter(c => c !== 값코드) : [...지금, 값코드];
-        if (다음.length === 0)
-            return 남김;
-        const 라벨 = wordAttributeFilterFromCodes({ [섹션]: 다음 }, wordAttributeLabelLanguageOf(sectionLabel));
-        const 값들 = Object.values(라벨)[0] ?? [];
-        return { ...남김, [sectionLabel]: 값들 };
+            return kept;
+        const current = toWordAttributeFilterCodes(sameSection)[section] ?? [];
+        const nextCodes = current.includes(valueCode) ? current.filter(c => c !== valueCode) : [...current, valueCode];
+        if (nextCodes.length === 0)
+            return kept;
+        const labels = wordAttributeFilterFromCodes({ [section]: nextCodes }, wordAttributeLabelLanguageOf(sectionLabel));
+        const values = Object.values(labels)[0] ?? [];
+        return { ...kept, [sectionLabel]: values };
     }
     if (value === FILTER_ALL_VALUE) {
         const { [sectionLabel]: _omit, ...rest } = prev;

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

@@ -28,8 +28,8 @@ const memCache = new Map();
 const noMeaning = new Set();
 /* 빈 응답(한 줄도 못 받음)으로 '뜻 없음' 이 된 열쇠와 그 때 — 조회 함수는 실패도 빈 배열로 돌려주므로 영영 굳히지 않고, 사용자 추가
    낱말처럼 정말 뜻이 없는 쪽을 오갈 때마다 다시 묻지도 않게 **잠시만**(1분) 묻지 않는다. */
-const 빈응답때 = new Map();
-const 빈응답유예ms = 60_000;
+const emptyAt = new Map();
+const EMPTY_GRACE_MS = 60_000;
 export function useWordMeanings(rows, fetchMeanings) {
     /* 캐시는 모듈 스코프 Map 이라 갱신이 렌더에 자동 반영되지 않는다 — 조회가 끝나면 이 값을
        올려 아래 스냅샷을 다시 계산시킨다(캐시 히트만으로 리렌더가 연쇄되지 않도록 분리). */
@@ -39,8 +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 지금 = Date.now();
-        const missing = wanted.filter(k => !memCache.has(k) && !noMeaning.has(k) && !(지금 - (빈응답때.get(k) ?? -Infinity) < 빈응답유예ms));
+        const now = Date.now();
+        const missing = wanted.filter(k => !memCache.has(k) && !noMeaning.has(k) && !(now - (emptyAt.get(k) ?? -Infinity) < EMPTY_GRACE_MS));
         if (missing.length === 0)
             return; // 전부 캐시에 있음 — 네트워크·상태 갱신 불필요
         let cancelled = false;
@@ -62,7 +62,7 @@ export function useWordMeanings(rows, fetchMeanings) {
             else {
                 const t = Date.now();
                 for (const k of missing)
-                    빈응답때.set(k, t);
+                    emptyAt.set(k, t);
             }
             if (cancelled || got.length === 0)
                 return;

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

@@ -8,7 +8,7 @@ import { useWordAttributeFilterKeys, buildGradeSection, buildPartOfSpeechSection
 import { matchesFilters } from '../utils/phonemePairSearch';
 import { wordAttributeValueCodeOf, wordAttributeValueLabelOf, isGradeCode } from '../utils/wordAttributeFilterCodes';
 /** 저장된 등급을 되읽을 때 코드 아닌 것은 버린다 — 0.320.0 작업본이 잠깐 `['']` 를 저장했다 */
-const 등급코드만 = (v) => (Array.isArray(v) ? v.filter(isGradeCode) : []);
+const gradeCodesOnly = (v) => (Array.isArray(v) ? v.filter(isGradeCode) : []);
 import { hasSel } from '../utils/wordContrast';
 import { phoneticLabel } from '../utils/phonemeGroups';
 /* 글자↔발음 변환과 음절 상수는 wordTrainingFilterModel.ts 로 옮겼다(React 없는 순수 계층).
@@ -145,12 +145,12 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
     // 음소 구조 같은 단어만(초성 ㅇ 유무·받침 유무 대립 제외) — 기본 true (reset 시 OFF)
     const [sameStructureOnly, setSameStructureOnly] = useState(opts?.resetOnMount ? false : (saved?.sameStructureOnly ?? true));
     // 난이도 등급('1'~'4') 필터 — 배열(다중 선택), 빈 배열은 전체(무제약)
-    const [gradeFilter, setGradeFilter] = useState(등급코드만(saved?.gradeFilter));
+    const [gradeFilter, setGradeFilter] = useState(gradeCodesOnly(saved?.gradeFilter));
     // 품사/어종 필터 — 단어표·대립쌍표와 동일 라벨 배열(다중 선택). caps로 노출 여부 결정(기본 미노출).
-    const 라벨언어들 = Array.from(new Set([i18n.language, 'ko', 'en'].filter(Boolean)));
+    const labelLanguages = Array.from(new Set([i18n.language, 'ko', 'en'].filter(Boolean)));
     const labelOf = (lng, key) => i18n.getFixedT(lng)(key);
-    const posCodesOf = (v) => toAttrCodes(v, POS_CODES, c => `wordSearch.filter.pos.${c}`, labelOf, 라벨언어들);
-    const typeCodesOf = (v) => toAttrCodes(v, TYPE_CODES, c => `wordSearch.filter.type.${c}`, labelOf, 라벨언어들);
+    const posCodesOf = (v) => toAttrCodes(v, POS_CODES, c => `wordSearch.filter.pos.${c}`, labelOf, labelLanguages);
+    const typeCodesOf = (v) => toAttrCodes(v, TYPE_CODES, c => `wordSearch.filter.type.${c}`, labelOf, labelLanguages);
     const [posCodes, setPosCodes] = useState(() => posCodesOf(saved?.posFilter));
     const [typeCodes, setTypeCodes] = useState(() => typeCodesOf(saved?.wordTypeFilter));
     // 훈련 타입(resetKey) 변경 시 필터를 그 타입 기본값으로 초기화 — 이전 타입의 고정값(음절수/받침/한음절 시드)이
@@ -213,7 +213,7 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
             setSameStructureOnly(s?.sameStructureOnly ?? true);
             // 마운트 때와 같은 규칙 — 여기서만 'direct' 를 'char' 로 떨구고 있었다
             setPhonemeView(readPhonemeView(s));
-            setGradeFilter(등급코드만(s?.gradeFilter));
+            setGradeFilter(gradeCodesOnly(s?.gradeFilter));
             setPosCodes(posCodesOf(s?.posFilter));
             setTypeCodes(typeCodesOf(s?.wordTypeFilter));
         }
@@ -621,7 +621,7 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
         setExcludeNoImage(s.excludeNoImage);
         setSameStructureOnly(s.sameStructureOnly ?? true);
         setPhonemeView(s.phonemeView);
-        setGradeFilter(등급코드만(s.gradeFilter));
+        setGradeFilter(gradeCodesOnly(s.gradeFilter));
         if (Array.isArray(s.posFilter))
             setPosCodes(posCodesOf(s.posFilter));
         if (Array.isArray(s.wordTypeFilter))

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

@@ -114,6 +114,7 @@
             "Fri",
             "Sat"
         ],
+        "weekLabel": "Week {{ord}}",
         "yearMonth": "{{month}}/{{year}}",
         "prevMonth": "Previous month",
         "addOnDate": "Add a visit on {{date}}",
@@ -128,7 +129,16 @@
         "periodSelect": "Period unit",
         "visitCount_one": "{{count}} visit",
         "visitCount_other": "{{count}} visits",
-        "statusCount": "{{count}} {{label}}"
+        "statusCount": "{{count}} {{label}}",
+        "weekOrdinal": [
+            "1",
+            "2",
+            "3",
+            "4",
+            "5",
+            "6",
+            "7"
+        ]
     },
     "passCard": {
         "planSuffix": "Plan",
@@ -1059,7 +1069,8 @@
         "removeDevice": "Remove",
         "type": {
             "hearingAid": "Hearing Aid",
-            "cochlearImplant": "Cochlear Implant"
+            "cochlearImplant": "Cochlear Implant",
+            "other": "Other"
         }
     },
     "manager": {