@ihabdevteam/core 0.134.0 → 0.136.0

package/dist/packages/core/src/components/Training/TrainingStepOrderList.js

@@ -28,6 +28,8 @@ export default function TrainingStepOrderList({ index, stepIndex, isLast = false
             return "active";
         return "disabled";
     }, [stepIndex, index]);
+    /** 옮기기 단추·끌어놓기를 여는가 — 진행 중이거나 끝낸 단계(아래 move 머리말) */
+    const 조작가능 = currentState !== 'disabled';
     // context 변경 시 items/shuffled를 다시 초기화하는 의도된 동기화다
     /* eslint-disable react-hooks/set-state-in-effect */
     useEffect(() => {
@@ -75,11 +77,13 @@ export default function TrainingStepOrderList({ index, stepIndex, isLast = false
     /**
      * 카드 한 칸 옮기기.
      *
-     * **조작은 진행 중(active)일 때만 열려 있다.** 예전에는 끝낸 단계(done)에서도 단추와
-     * 끌어놓기가 살아 있었는데, 여기와 handleDrop 은 `currentState === 'active'` 일 때만
-     * onDone 을 부른다 — 그래서 화면 배치는 바뀌는데 **기록된 점수는 그대로**였다.
-     * 되돌아본 사람은 옮겨 놓은 배치를 보면서 옛 점수를 읽게 된다. 끝난 단계는 결과를
-     * 그대로 보여 주기만 한다.
+     * **조작은 진행 중(active)과 끝낸(done) 단계에서 열려 있다.** onDone 은 진행 중일 때만 부른다(단계를 넘기는 신호).
+     * 옮길 때마다 flipSetShuffled 가 onChange 로 새 배치·점수를 내보내고, OrderListStep 은 그것을 **이 단계 번호로**
+     * 기록하므로 끝낸 단계에서 옮겨도 점수가 따라간다.
+     *
+     * 한때(92b71ac) done 에서 조작을 닫았다 — "끝낸 단계에서 옮기면 점수가 안 나간다" 고 봤는데 위 onChange 기록을
+     * 놓친 판단이었고, 그 결과 **카드를 한 번 옮기는 순간**(첫 이동의 onDone 이 단계를 넘긴다) 단추·끌어놓기가 모두
+     * 사라져 문장 순서화를 끝까지 맞출 수 없었다(2026-09-14 훈련 검수 — 말귀 OrderTrainingPagePopup).
      */
     const move = (idx, dir) => {
         const arr = [...shuffled];
@@ -423,7 +427,7 @@ export default function TrainingStepOrderList({ index, stepIndex, isLast = false
                                         map.set(it.id, el);
                                     else
                                         map.delete(it.id);
-                                }, className: `order-list__draggable ${draggedIndex === idx ? "dragging" : ""}`, "data-disabled": currentState === 'disabled', "aria-disabled": currentState === 'disabled', tabIndex: currentState === 'disabled' ? -1 : 0, draggable: currentState === 'active', onDragStart: currentState === 'active' ? (e) => handleDragStart(idx, e) : undefined, onDragEnter: currentState === 'active' ? (e) => handleDragOverWithClass(idx, e) : undefined, onDragOver: currentState === 'active' ? (e) => handleDragOverWithClass(idx, e) : undefined, onDragLeave: currentState === 'active' ? () => {
+                                }, className: `order-list__draggable ${draggedIndex === idx ? "dragging" : ""}`, "data-disabled": currentState === 'disabled', "aria-disabled": currentState === 'disabled', tabIndex: currentState === 'disabled' ? -1 : 0, draggable: 조작가능, onDragStart: 조작가능 ? (e) => handleDragStart(idx, e) : undefined, onDragEnter: 조작가능 ? (e) => handleDragOverWithClass(idx, e) : undefined, onDragOver: 조작가능 ? (e) => handleDragOverWithClass(idx, e) : undefined, onDragLeave: 조작가능 ? () => {
                                     try {
                                         if (dragLeaveTimeoutRef.current !== null)
                                             clearTimeout(dragLeaveTimeoutRef.current);
@@ -440,6 +444,6 @@ export default function TrainingStepOrderList({ index, stepIndex, isLast = false
                                         }, 80);
                                     }
                                     catch (err) { }
-                                } : undefined, onDrop: currentState === 'active' ? (e) => handleDrop(idx, e) : undefined, onDragEnd: currentState === 'active' ? handleDragEnd : undefined, children: [_jsx("span", { className: "order-list__item-text body-2", children: it.text }), currentState === 'active' ? (_jsxs("span", { className: "order-list__item-buttons", children: [_jsx(Button, { htmlType: "button", size: 32, type: "dot", onClick: () => move(idx, -1), ariaLabel: t("training.up"), icon: 'chevron-up', variant: 'transparent-gray', width: 48, useFaded: "true", disabled: idx === 0, useBorder: false, useDisabledInvisible: true }), _jsx(Button, { htmlType: "button", size: 32, type: "dot", onClick: () => move(idx, 1), ariaLabel: t("training.down"), icon: 'chevron-down', variant: 'transparent-gray', width: 48, useFaded: "true", disabled: idx === shuffled.length - 1, useBorder: false, useDisabledInvisible: true })] })) : null] })] }) }, it.id));
+                                } : undefined, onDrop: 조작가능 ? (e) => handleDrop(idx, e) : undefined, onDragEnd: 조작가능 ? handleDragEnd : undefined, children: [_jsx("span", { className: "order-list__item-text body-2", children: it.text }), 조작가능 ? (_jsxs("span", { className: "order-list__item-buttons", children: [_jsx(Button, { htmlType: "button", size: 32, type: "dot", onClick: () => move(idx, -1), ariaLabel: t("training.up"), icon: 'chevron-up', variant: 'transparent-gray', width: 48, useFaded: "true", disabled: idx === 0, useBorder: false, useDisabledInvisible: true }), _jsx(Button, { htmlType: "button", size: 32, type: "dot", onClick: () => move(idx, 1), ariaLabel: t("training.down"), icon: 'chevron-down', variant: 'transparent-gray', width: 48, useFaded: "true", disabled: idx === shuffled.length - 1, useBorder: false, useDisabledInvisible: true })] })) : null] })] }) }, it.id));
             }) }) }));
 }

package/dist/packages/core/src/components/Training/TrainingStepTextBox.js

@@ -54,10 +54,13 @@ export default function TrainingStepTextBox({ context, state = "disabled", theme
             return context;
         return "";
     }, [context]);
-    useEffect(() => {
-        const id = setTimeout(() => setLocalStatus("disabled"), 0);
-        return () => clearTimeout(id);
-    }, [content]);
+    /* 문장이 바뀌면 **그 렌더에서** 가린다 — 타이머로 한 틱 뒤에 가리면, 앞 문제에서 펼쳐 둔 상자에 다음 문제 문장이
+       잠깐 드러났다(정답 문장이 번쩍). 렌더 중 상태 조정은 React 가 권하는 꼴이다. */
+    const [보던문장, set보던문장] = useState(content);
+    if (보던문장 !== content) {
+        set보던문장(content);
+        setLocalStatus("disabled");
+    }
     const displayStatus = state === "disabled" ? localStatus : state;
     const stateClass = displayStatus === "disabled"
         ? "training-text-box--disabled"

package/dist/packages/core/src/components/Training/TrainingStepTitle.js

@@ -87,5 +87,8 @@ export default function TrainingStepTitle({ title, children, className = "", sta
             setPreviewContent(null);
         }
     }, [onPreviewTextBtn, previewText, showPreview]);
-    return (_jsxs("div", { className: rowClass, children: [_jsx("p", { className: cls, children: _jsx("span", { className: "training-step__title-text", children: title ?? children }) }), (usePreviewTextBtn || usePlayAllBtn) ? (_jsxs("div", { className: "title-controls", children: [_jsxs("div", { className: "title-buttons", children: [usePlayAllBtn && (_jsx(Button, { htmlType: "button", size: 32, type: isMobile ? 'dot' : 'bar', icon: "play-circle", label: isMobile ? undefined : t('training.playAll', '모두 듣기'), ariaLabel: t('training.playAll', '모두 듣기'), selected: playAllActive, onClick: onPlayAll, variant: state === 'disabled' ? 'disabled' : 'default', disabled: state === 'disabled' || playAllActive })), usePreviewTextBtn && (_jsx("div", { ref: btnRef, children: _jsx(Button, { htmlType: "button", size: 32, type: isMobile ? 'dot' : 'bar', icon: "eye", label: isMobile ? undefined : t('training.sentencePreview', '문장 미리보기'), ariaLabel: t('training.sentencePreview', '문장 미리보기'), selected: showPreview, onClick: handlePreviewButtonClick, variant: state === 'disabled' ? 'disabled' : 'default', disabled: !previewText && typeof onPreviewTextBtn !== 'function' }) }))] }), showPreview && (_jsx(TextBoxTooltip, { text: (previewContent ?? previewText), label: t('training.sentencePreview', '문장 미리보기'), anchorRect: anchorRect, onClose: handlePreviewClose, closeOnOutsideClick: false, isMobilePopup: true }))] })) : null] }));
+    return (_jsxs("div", { className: rowClass, children: [_jsx("p", { className: cls, children: _jsx("span", { className: "training-step__title-text", children: title ?? children }) }), (usePreviewTextBtn || usePlayAllBtn) ? (_jsxs("div", { className: "title-controls", children: [_jsxs("div", { className: "title-buttons", children: [usePlayAllBtn && (_jsx(Button, { htmlType: "button", size: 32, type: isMobile ? 'dot' : 'bar', icon: "play-circle", label: isMobile ? undefined : t('training.playAll', '모두 듣기'), ariaLabel: t('training.playAll', '모두 듣기'), selected: playAllActive, onClick: onPlayAll, variant: state === 'disabled' ? 'disabled' : 'default', disabled: state === 'disabled' || playAllActive, 
+                                // 재생 중에는 native disabled 를 달지 않는다 — 키보드로 누른 단추에 disabled 가 붙으면 초점이 body 로 빠졌다.
+                                // onDisabledClick 을 주면 Button 은 aria-disabled 로만 막고 클릭은 여기서 버린다.
+                                onDisabledClick: playAllActive && state !== 'disabled' ? () => { } : undefined })), usePreviewTextBtn && (_jsx("div", { ref: btnRef, children: _jsx(Button, { htmlType: "button", size: 32, type: isMobile ? 'dot' : 'bar', icon: "eye", label: isMobile ? undefined : t('training.sentencePreview', '문장 미리보기'), ariaLabel: t('training.sentencePreview', '문장 미리보기'), selected: showPreview, onClick: handlePreviewButtonClick, variant: state === 'disabled' ? 'disabled' : 'default', disabled: !previewText && typeof onPreviewTextBtn !== 'function' }) }))] }), showPreview && (_jsx(TextBoxTooltip, { text: (previewContent ?? previewText), label: t('training.sentencePreview', '문장 미리보기'), anchorRect: anchorRect, onClose: handlePreviewClose, closeOnOutsideClick: false, isMobilePopup: true }))] })) : null] }));
 }

package/dist/packages/core/src/components/Training/TrainingWordCard.js

@@ -223,6 +223,10 @@ const TrainingWordCard = forwardRef(function TrainingWordCard({ item, disabled =
         // 읽히는데 정작 고를 수가 없어, 훈련 문항을 키보드만으로 풀 수 없었다.
         tabIndex: selectable && !disabled ? 0 : undefined, "aria-disabled": selectable && disabled ? true : undefined, onKeyDown: selectable && !disabled
             ? (e) => {
+                /* 카드 자신에서 난 키만 — 안의 '소리 듣기' 에서 누른 Enter 가 올라오면 전에는 소리 대신 **그 카드를 답으로
+                   골라** 되돌릴 수 없었다. */
+                if (e.target !== e.currentTarget)
+                    return;
                 // Space 는 기본 동작이 스크롤이라 막고, 둘 다 클릭과 같은 선택으로 잇는다.
                 if (e.key === 'Enter' || e.key === ' ' || e.key === 'Spacebar') {
                     e.preventDefault();

package/dist/packages/core/src/components/Training/WordTablePopup.js

@@ -93,13 +93,19 @@ export default function WordTablePopup({ items, words, title, subtitle, emptyTex
     const customFooter = useMemo(() => (renderFooter ? renderFooter({ print: handlePrint, openNewWindow }) : undefined), [renderFooter, handlePrint, openNewWindow]);
     // 메뉴 '인쇄하기' 진입: 팝업이 열리고 표가 렌더된 직후 인쇄를 1회 자동 시작.
     // 짧은 지연은 WordTable 레이아웃 확정용 — 인쇄 iframe 쪽이 이미지 로드는 별도로 기다린다(wordTablePrint).
+    /* '했다' 는 **타이머가 실제로 울렸을 때** 적는다 — 걸 때 적으면 StrictMode 의 두 번 실행이나 100ms 안에 인쇄 설정이
+       바뀌어(handlePrint 가 새로 만들어져) 앞 타이머가 걷힌 뒤 다시 걸지 못해, 인쇄가 한 번도 안 떴다. 부르는 것은 최신 print. */
     const autoPrintDone = useRef(false);
+    const printRef = useRef(handlePrint);
+    useEffect(() => { printRef.current = handlePrint; }, [handlePrint]);
     useEffect(() => {
         if (!autoPrint || autoPrintDone.current)
             return;
-        autoPrintDone.current = true;
-        const id = window.setTimeout(() => handlePrint(), 100);
+        const id = window.setTimeout(() => {
+            autoPrintDone.current = true;
+            printRef.current();
+        }, 100);
         return () => window.clearTimeout(id);
-    }, [autoPrint, handlePrint]);
+    }, [autoPrint]);
     return (_jsxs(Popup, { title: title ?? t('keyWords.title', '주요 단어'), subtitle: subtitle, size: "large", className: cx('word-table-popup', className), buttons: footerButtons, footer: customFooter, footerClassName: footerClassName, beforeClose: beforeClose, onClose: onClose, children: [tableItems.length > 0 ? (_jsxs("div", { className: "word-table-popup__body", children: [showSettings && (_jsx(TableFilterPanel, { sections: filterSections, selected: filterSelected, onSelect: handleSelect })), isPaginated ? (_jsx("div", { className: "word-table-popup__pages", children: pages.map((page, i) => (_jsx(WordTable, { items: page, orientation: settings.orientation, contentTypes: settings.contentTypes, cutLine: settings.cutLine, showOutline: settings.showOutline, showDivLine: settings.showDivLine, count: settings.count, contentRef: el => { pageRefs.current[i] = el; }, pageNumber: { current: i + 1, total: pages.length }, pageNumberPosition: pageNumberPosition, scoring: scoring, scoreIndexOffset: pageStart[i], marks: 표에줄채점, onMarkClick: handleMarkClick }, i))) })) : (_jsx("div", { className: "word-table-popup__table", children: _jsx(WordTable, { items: tableItems, orientation: settings.orientation, contentTypes: settings.contentTypes, cutLine: settings.cutLine, showOutline: settings.showOutline, showDivLine: settings.showDivLine, count: settings.count, contentRef: contentRef, fitHeight: true, scoring: scoring, marks: 표에줄채점, onMarkClick: handleMarkClick }) }))] })) : (_jsx("p", { className: "word-table-popup__empty body-3", children: emptyText ?? t('keyWords.empty', '추출된 주요 단어가 없습니다.') })), _jsx(Toast, { message: toastMsg, position: "top", onClose: handleToastClose }, toastKey)] }));
 }

package/dist/packages/core/src/components/Training/trainingBlockButtonTypes.d.ts

@@ -41,8 +41,10 @@ export interface TrainingBlockButtonProps {
      * - `small`: 120×120px 축소 카드 (행 펼치기 영역 등 좁은 공간용)
      * - `list`: 너비 200px · 최소 높이 68px 가로형 항목
      * - `compact`: 툴팁 등 좁은 공간용 소형 리스트 항목 (전체 너비 × 높이 40px, 작은 아이콘)
+     * - `row`: 전체 너비 가로 행 — [아이콘][유형·제목][문항수]. 미리 듣기 단추는 없다.
+     *   좁은 화면에서 정사각형 카드 대신 쓴다(카드는 폭이 줄면 내용이 눌린다). 유형 줄은 `showTypeLabel` 일 때.
      */
-    size?: 'square' | 'small' | 'list' | 'compact';
+    size?: 'square' | 'small' | 'list' | 'compact' | 'row';
     renderPopup?: (props: TrainingBlockButtonPopupProps) => ReactNode;
     completedIds?: Set<string>;
     /** 선택 상태 ID Set. 포함된 항목(완료가 아닌 것)에 체크 배지를 표시 — 완료와 같은 배지이고, `hideCheckBadge` 면 숨는다. */

package/dist/packages/core/src/components/Training/trainingMissStats.js

@@ -57,8 +57,15 @@ export function summarizeMisses(records) {
         cur.lastSelected = r.selected;
         /* 세트는 **최근 것이 앞**이어야 한다 — 다음 훈련을 짤 때 옛 세트를 먼저 집으면
            그 사이 세트가 바뀌었을 수 있다. 시간순으로 훑고 있으니 앞에 넣는다. */
-        if (r.setId && !cur.setIds.includes(r.setId))
-            cur.setIds.unshift(r.setId);
+        /* 이미 있던 세트를 다시 풀었으면 **빼서 다시 앞으로** — 건너뛰기만 하면 A→B→A 순서에서 [B, A] 로 남아
+           복습이 가장 최근 세트(A) 대신 옛 세트(B)로 짜였다. */
+        if (r.setId) {
+            const at = cur.setIds.indexOf(r.setId);
+            if (at > 0)
+                cur.setIds.splice(at, 1);
+            if (at !== 0)
+                cur.setIds.unshift(r.setId);
+        }
         모음.set(key, cur);
     }
     const items = [...모음.entries()].map(([key, v]) => ({

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

@@ -20,7 +20,7 @@ import { formatYmd, getTodayKst } from '../../utils/date';
 import { getSavedTables } from '../../utils/savedWordTables';
 import { devWarnOnce } from '../../utils/devWarn';
 import { useWordTablePrint } from './useWordTablePrint';
-import { CELL_COUNTS } from './wordTableBlockTypes';
+import { CELL_COUNTS, ITEMS_PER_PAGE_OPTIONS } from './wordTableBlockTypes';
 // ── 컴포넌트 ───────────────────────────────────────────────
 /** @public */
 export default function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel }) {
@@ -191,7 +191,10 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
                 setDisplayCellCount(parseInt(value));
         }
         else if (sectionLabel === t(hasPairs ? 'wordTable.filter.itemsPerPagePair' : 'wordTable.filter.itemsPerPageWord')) {
-            setItemsPerPageSetting(parseInt(value));
+            /* 목록에 없는 개수(= 그때의 '전체' 칸)를 고르면 **전체** 로 기억한다 — 숫자로 담으면 항목이 늘었을 때 고른 값('10개')이
+               선택지([20, 8, 4, 2, 1])에 없어 켜진 칸이 없는데 표는 10개씩 나뉘었다. */
+            const n = parseInt(value);
+            setItemsPerPageSetting(ITEMS_PER_PAGE_OPTIONS.includes(n) ? n : Number.POSITIVE_INFINITY);
         }
         else if (sectionLabel === t('wordTable.filter.pageNumber', '페이지 번호')) {
             setPageNumberPosition(parsePageNumberPosition(value));
@@ -233,7 +236,8 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
     const saveAsTrimmed = saveAsName.trim();
     const saveAsCollides = saveAsTrimmed !== '' && namesLower.includes(saveAsTrimmed.toLowerCase());
     const openSaveAsPopup = () => {
-        setSaveAsName(trimmedName ? `${trimmedName} (복사)` : '');
+        // 복사본 이름도 사전을 탄다 — 박혀 있어 영어 화면에 'My table (복사)' 가 채워졌다
+        setSaveAsName(trimmedName ? t('wordTable.save.copyName', { name: trimmedName, defaultValue: '{{name}} (복사)' }) : '');
         setShowSaveAsPopup(true);
     };
     const handleSaveAsConfirm = () => {

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

@@ -16,6 +16,9 @@ export default function WordTableButton({ items, name, description, createdAt, p
     const renaming = titleNode != null;
     const hasStoreFooter = publisherName != null || publishedAt != null || likeCount != null || downloadCount != null;
     const handleKey = (e) => {
+        // 카드 안 단추('더보기'·게시자)에서 누른 키는 그 단추 몫이다 — 가로채면 카드가 열리고 단추 클릭은 막혔다(pressable 과 같은 규칙)
+        if (e.target !== e.currentTarget)
+            return;
         if (!renaming && (e.key === 'Enter' || e.key === ' ')) {
             e.preventDefault();
             onClick?.();

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

@@ -2,6 +2,7 @@
 import { useMemo, useState, useCallback, useEffect } from 'react';
 import { useTranslation } from 'react-i18next';
 import { chunkItems } from '../wordTableLayout';
+import { ITEMS_PER_PAGE_OPTIONS } from './wordTableBlockTypes';
 import { getImageResolver, checkImageExists } from '../../utils/imageConfig';
 import { buildCompositionSection, buildOrientationSection, buildBorderSection, buildCutLineSection, buildDivLineSection, buildItemsPerPageSection, buildPageNumberSection, buildTableSettingsSelected, applyTableSettingsSelect, PAGE_NUM_POSITION_VALUE, parsePageNumberPosition, } from './wordTableSettings';
 /**
@@ -68,7 +69,10 @@ export function useWordTableDisplaySettings(items) {
         if (applyTableSettingsSelect(t, value, sectionLabel, { setContentTypes, setOrientation, setShowOutline, setCutLine, setShowDivLine }))
             return;
         if (sectionLabel === t('wordTable.filter.itemsPerPagePair', '페이지당 대립쌍 수') || sectionLabel === t('wordTable.filter.itemsPerPageWord', '페이지당 단어 수')) {
-            setItemsPerPageSetting(parseInt(value));
+            /* 목록에 없는 개수(= 그때의 '전체' 칸)를 고르면 **전체** 로 기억한다 — 숫자로 담으면 항목이 늘었을 때 고른 값('10개')이
+               선택지([20, 8, 4, 2, 1])에 없어 켜진 칸이 없는데 표는 10개씩 나뉘었다. */
+            const n = parseInt(value);
+            setItemsPerPageSetting(ITEMS_PER_PAGE_OPTIONS.includes(n) ? n : Number.POSITIVE_INFINITY);
         }
         else if (sectionLabel === t('wordTable.filter.pageNumber', '페이지 번호')) {
             setPageNumberPosition(parsePageNumberPosition(value));

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

@@ -62,12 +62,17 @@ export function tableTrends(records) {
     }
     const out = [];
     for (const v of 모음.values()) {
-        const rows = [...v.rows].sort((a, b) => a.scoredAt.localeCompare(b.scoredAt));
+        /* 매긴 칸이 하나도 없는 기록은 흐름에서 뺀다 — 정답률 0%로 넣으면 [0, 0.5] 처럼 나아진 적 없는 표가 +50%로 읽혔다
+           (summarize 는 같은 경우를 null 로 따로 둔다). 모두 비었으면 그 표는 흐름이 없다. */
+        const 매긴수 = (r) => Object.values(r.marks).filter(m => m === 'o' || m === 'triangle' || m === 'x').length;
+        const rows = v.rows.filter(r => 매긴수(r) > 0).sort((a, b) => a.scoredAt.localeCompare(b.scoredAt));
+        if (rows.length === 0)
+            continue;
         const rates = rows.map(r => {
             const vals = Object.values(r.marks);
             const o = vals.filter(m => m === 'o').length;
             const tri = vals.filter(m => m === 'triangle').length;
-            return 점수(o, tri, vals.filter(m => m === 'o' || m === 'triangle' || m === 'x').length);
+            return 점수(o, tri, 매긴수(r));
         });
         out.push({
             tableName: v.tableName,

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

@@ -17,6 +17,8 @@ function escapeHtml(s) {
 export function sanitizeFileName(name) {
     return name.replace(/[\\/:*?"<>|]/g, '_').trim();
 }
+/** 아직 되돌리지 못한 탭 제목 되돌리기(인쇄가 끝나기 전 다음 인쇄가 올 때) */
+let 제목되돌리기 = null;
 /**
  * 캡처한 콘텐츠 엘리먼트들을 화면 밖 숨김 iframe에서 인쇄한다. 전역 @media print(모든
  * .word-table 노출)나 팝업 차단의 간섭 없이 넘긴 엘리먼트만 격리 인쇄한다. WordTableBlock의
@@ -28,10 +30,21 @@ export function printWordTableElements(elements, paperW, paperH, fileName = '',
         return;
     const safeFileName = fileName ? sanitizeFileName(fileName) : '';
     // "PDF로 저장" 기본 파일명은 iframe이 아니라 최상위 탭(document)의 title에서 온다.
+    /* 탭 제목은 **어느 쪽 afterprint 가 와도** 되돌린다 — 브라우저에 따라 iframe 인쇄의 print 이벤트가 그 프레임에만 가서,
+       최상위에만 걸면 제목이 표 이름으로 남았고, 다음 인쇄가 그 표 이름을 '원래 제목' 으로 잡아 영영 안 돌아왔다.
+       되돌리지 못한 앞 인쇄가 있으면 먼저 되돌린 뒤 원래 제목을 잡는다. */
+    제목되돌리기?.();
+    let restore = null;
     if (safeFileName) {
         const prevTitle = document.title;
         document.title = safeFileName;
-        const restore = () => { document.title = prevTitle; window.removeEventListener('afterprint', restore); };
+        restore = () => {
+            document.title = prevTitle;
+            window.removeEventListener('afterprint', restore);
+            if (제목되돌리기 === restore)
+                제목되돌리기 = null;
+        };
+        제목되돌리기 = restore;
         window.addEventListener('afterprint', restore);
     }
     const iframe = document.createElement('iframe');
@@ -45,7 +58,7 @@ export function printWordTableElements(elements, paperW, paperH, fileName = '',
     doc.open();
     doc.write(captureHtml(elements, paperW, paperH, true, safeFileName, header));
     doc.close();
-    iframe.contentWindow?.addEventListener('afterprint', () => setTimeout(() => iframe.remove(), 0));
+    iframe.contentWindow?.addEventListener('afterprint', () => { restore?.(); setTimeout(() => iframe.remove(), 0); });
 }
 // 인쇄 시 PDF로 저장할 때 OS가 제안하는 기본 파일명은 문서 <title>에서 온다.
 export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '', header = '') {

package/dist/packages/core/src/components/barChartData.d.ts

@@ -53,4 +53,12 @@ export declare const MONTH_OPTIONS: {
     year: number;
     month: number;
 }[];
+/** 지금 시각 기준 월 옵션 — 모듈 상수(MONTH_OPTIONS)는 불러온 순간의 달에 굳어, 탭을 열어 둔 채 달이 넘어가면 이번 달이
+ *  옵션에서 빠졌다. 컨트롤 훅은 자료가 바뀔 때마다 이것으로 다시 만든다. */
+export declare function monthOptionsNow(): {
+    value: string;
+    label: string;
+    year: number;
+    month: number;
+}[];
 export declare const KO_ORD: string[];

package/dist/packages/core/src/components/barChartData.js

@@ -48,6 +48,24 @@ export function buildMonthChartData(points) {
             byMonth.set(key, []);
         byMonth.get(key).push(p);
     }
+    /* **앞 달 칸도 만든다.** 첫 월요일 이전 날(9/1~9/6)은 앞 달의 마지막 주에 속하는데, 앞 달에 자료가 없으면 그 달 칸이
+       안 생겨 그 날들이 **어느 막대에도 안 들어갔다**(신규 회원·한 달 쉰 회원의 달 초 훈련이 사라짐). 오늘이 든 주도 앞 달
+       마지막 주면 주 보기 기본 선택이 미래 주로 갔다. 그 날에 자료가 있거나 오늘이 그 날이면 앞 달을 빈 칸으로라도 둔다. */
+    for (const [key, pts] of [...byMonth.entries()]) {
+        const m = key.match(/^(\d+)년 (\d+)월$/);
+        if (!m)
+            continue;
+        const year = Number(m[1]);
+        const month0 = Number(m[2]) - 1;
+        const 첫월 = firstMondayOfMonth(year, month0);
+        const 오늘이앞 = key === curKey && now.getDate() < 첫월;
+        if (!오늘이앞 && !pts.some(p => p.date.getDate() < 첫월))
+            continue;
+        const prev = new Date(year, month0, 0);
+        const prevKey = 달키(prev.getFullYear(), prev.getMonth());
+        if (!byMonth.has(prevKey))
+            byMonth.set(prevKey, []);
+    }
     const 칸들 = new Map();
     for (const [key, pts] of byMonth) {
         const m = key.match(/^(\d+)년 (\d+)월$/);
@@ -138,5 +156,8 @@ function genMonthOptions() {
     return opts.reverse();
 }
 export const MONTH_OPTIONS = genMonthOptions();
+/** 지금 시각 기준 월 옵션 — 모듈 상수(MONTH_OPTIONS)는 불러온 순간의 달에 굳어, 탭을 열어 둔 채 달이 넘어가면 이번 달이
+ *  옵션에서 빠졌다. 컨트롤 훅은 자료가 바뀔 때마다 이것으로 다시 만든다. */
+export function monthOptionsNow() { return genMonthOptions(); }
 // 한글 서수(주차) — '첫째주', '둘째주' …
 export const KO_ORD = ['첫째', '둘째', '셋째', '넷째', '다섯째', '여섯째', '일곱째'];

package/dist/packages/core/src/components/buttonTypes.d.ts

@@ -87,6 +87,12 @@ export interface ButtonProps {
         title?: string;
         items: string[];
     } | null;
+    /**
+     * 누르는 단추가 아니라 **툴팁을 보여 주는 칩** 이다 — 커서를 손가락이 아닌 기본 화살표로 둔다.
+     * 모양(바탕·hover)과 포커스·툴팁은 그대로다. `onClick` 없이 `showTooltipInfo`·`tooltipDescription` 만 다는
+     * 자리(점수 칩 등)에 쓴다. 막힌 단추(`disabled`)와는 다르다 — 흐려지지 않는다.
+     */
+    tooltipOnly?: boolean;
     iconSize?: 'small' | 'medium' | 'large';
     iconColor?: string;
     /**

package/dist/packages/core/src/components/useBarChartControl.js

@@ -1,7 +1,7 @@
 'use client';
 import { useState, useEffect, useMemo, useCallback } from 'react';
 import { useTranslation } from 'react-i18next';
-import { firstMondayOfMonth, todayWeekValue, MONTH_OPTIONS, KO_ORD } from './barChartData';
+import { firstMondayOfMonth, todayWeekValue, monthOptionsNow, KO_ORD } from './barChartData';
 /**
  * BarChart 기간 상태/옵션/네비게이션을 캡슐화한 훅.
  * 여러 BarChart가 하나의 컨트롤을 공유하려면 이 훅을 상위에서 호출해 control을 내려준다.
@@ -10,7 +10,8 @@ import { firstMondayOfMonth, todayWeekValue, MONTH_OPTIONS, KO_ORD } from './bar
 export function useBarChartControl(data) {
     const { t, i18n } = useTranslation();
     const [period, setPeriod] = useState('week');
-    const DATA_MONTH_OPTIONS = useMemo(() => MONTH_OPTIONS.filter(o => o.value in data), [data]);
+    // 달 옵션·오늘은 자료가 바뀔 때 다시 센다 — 모듈 로드 때 한 번 세면 자정을 넘긴 탭에서 이번 달·오늘 주가 옛날에 굳었다
+    const DATA_MONTH_OPTIONS = useMemo(() => monthOptionsNow().filter(o => o.value in data), [data]);
     const WEEK_OPTIONS = useMemo(() => {
         const opts = [];
         for (const o of DATA_MONTH_OPTIONS) {
@@ -34,7 +35,8 @@ export function useBarChartControl(data) {
     })), [t, DATA_MONTH_OPTIONS]);
     const weekOptions = useMemo(() => WEEK_OPTIONS.map(o => ({ value: o.value, label: weekOptionLabel(o) })), [WEEK_OPTIONS, weekOptionLabel]);
     // 진입 시 기본 선택을 오늘 기준으로 — 오늘이 속한 월/주(데이터에 있으면), 없으면 최신
-    const today = useMemo(() => todayWeekValue(), []);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    const today = useMemo(() => todayWeekValue(), [data]);
     const defaultMonth = useMemo(() => DATA_MONTH_OPTIONS.find(o => o.value === today.monthKey)?.value ?? DATA_MONTH_OPTIONS[0]?.value ?? '', [DATA_MONTH_OPTIONS, today]);
     const defaultWeek = useMemo(() => WEEK_OPTIONS.find(o => o.value === today.value)?.value ?? WEEK_OPTIONS[0]?.value ?? '', [WEEK_OPTIONS, today]);
     const [monthRange, setMonthRange] = useState('');

package/dist/packages/core/src/components/useCalendarMonth.js

@@ -29,22 +29,20 @@ export function useCalendarMonth(value) {
         setViewM(next.m);
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [value]);
-    const prevMonth = useCallback(() => {
-        if (viewM === 0) {
-            setViewY(y => y - 1);
-            setViewM(11);
-        }
-        else
-            setViewM(m => m - 1);
-    }, [viewM]);
-    const nextMonth = useCallback(() => {
-        if (viewM === 11) {
-            setViewY(y => y + 1);
-            setViewM(0);
-        }
-        else
-            setViewM(m => m + 1);
-    }, [viewM]);
-    const setViewYM = useCallback((y, m) => { setViewY(y); setViewM(m); }, []);
+    /* 달 넘김은 **지금 가리키는 연·월 하나** 에서 센다 — 갈래는 렌더 때의 viewM 으로, 갱신은 함수형으로 나눠 하던 때는
+       한 핸들러에서 두 번 부르면(2월에서 prevMonth 두 번) (2026, -1) 이 됐다. 부른 즉시 ref 도 옮겨 둔다. */
+    const ymRef = useRef({ y: viewY, m: viewM });
+    useEffect(() => { ymRef.current = { y: viewY, m: viewM }; }, [viewY, viewM]);
+    const moveMonth = useCallback((d) => {
+        const total = ymRef.current.y * 12 + ymRef.current.m + d;
+        const y = Math.floor(total / 12);
+        const m = total - y * 12;
+        ymRef.current = { y, m };
+        setViewY(y);
+        setViewM(m);
+    }, []);
+    const prevMonth = useCallback(() => moveMonth(-1), [moveMonth]);
+    const nextMonth = useCallback(() => moveMonth(1), [moveMonth]);
+    const setViewYM = useCallback((y, m) => { ymRef.current = { y, m }; setViewY(y); setViewM(m); }, []);
     return { viewY, viewM, prevMonth, nextMonth, setViewYM };
 }

package/dist/packages/core/src/components/useToastLifecycle.js

@@ -83,8 +83,13 @@ export function useToastLifecycle({ message, position, duration, onClose }) {
             // 이미 보이는 중 → 텍스트만 업데이트, 애니메이션 재실행 없음
             if (showingRef.current) {
                 if (DURATION_MS > 0 && !hideTimerRef.current) {
-                    멈춤Ref.current = false;
-                    사라짐걸기.current(DURATION_MS);
+                    /* 멈춘 채(마우스·포커스가 올라가 있는 채) 문구가 바뀌면 시계를 새로 걸지 않는다 — 전에는 멈춤을 풀고 걸어
+                       읽고 있는 알림이 손 밑에서 사라졌고, 떠날 때의 resume 은 멈춤이 이미 풀려 아무것도 안 했다.
+                       새 문구의 시간은 **처음부터** 남겨 두고 resume 이 그만큼 돌린다. */
+                    if (멈춤Ref.current)
+                        남은Ref.current = DURATION_MS;
+                    else
+                        사라짐걸기.current(DURATION_MS);
                 }
                 lastMessageRef.current = message;
                 /* 여기서 건 사라짐 타이머도 떠날 때 걷는다 — 빈 정리 함수라 문구를 바꾼 뒤 언마운트하면 타이머가 살아

package/dist/packages/core/src/context/I18nProvider.js

@@ -3,13 +3,22 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect } from 'react';
 import i18n, { SUPPORTED_LOCALES, DEFAULT_LOCALE } from '../i18n';
 import { I18nContext } from './I18nContext';
+function 지원코드(locale) {
+    const 있나 = (c) => SUPPORTED_LOCALES.some(l => l.code === c);
+    if (있나(locale))
+        return locale;
+    const 기본 = locale.split(/[-_]/)[0]?.toLowerCase() ?? '';
+    return 있나(기본) ? 기본 : DEFAULT_LOCALE;
+}
 /** @public */
 export function I18nProvider({ locale = DEFAULT_LOCALE, children }) {
+    /* 지역이 붙은 코드('en-US'·'ko_KR')는 기본 언어로 읽는다 — 전에는 목록에 없다고 기본(ko)으로 떨어져 영어를 달라 했는데
+       한국어가 나오고, context 의 locale 은 'en-US' 로 남아 둘이 갈렸다. context 에도 실제로 건 코드를 넣는다. */
+    const code = 지원코드(locale);
     useEffect(() => {
-        const code = SUPPORTED_LOCALES.find(l => l.code === locale) ? locale : DEFAULT_LOCALE;
         if (i18n.language !== code) {
             i18n.changeLanguage(code);
         }
-    }, [locale]);
-    return (_jsx(I18nContext.Provider, { value: { locale, supportedLocales: SUPPORTED_LOCALES }, children: children }));
+    }, [code]);
+    return (_jsx(I18nContext.Provider, { value: { locale: code, supportedLocales: SUPPORTED_LOCALES }, children: children }));
 }

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

@@ -1,6 +1,7 @@
 'use client';
 import { useCallback, useEffect, useRef, useState } from 'react';
 import { ensureTrainingDataLoaded } from '../utils/getTrainingData';
+import { getTodayKst } from '../utils/date';
 import { hasItems, resolveSelection, } from '../utils/dailySelectionUtils';
 // ─── 훅 ──────────────────────────────────────────────────────────────────────
 /**
@@ -29,6 +30,19 @@ export function useDailyTrainingSelection(userId) {
     // 가를 수가 없어** 설명 없는 빈 화면을 그리게 된다(실제로 그런 화면이 있다).
     // loaded 의 뜻을 바꾸면 지금 쓰는 곳이 깨지므로, 가를 수 있는 값을 따로 낸다.
     const [hasData, setHasData] = useState(false);
+    /* 오늘(KST) — 자정을 넘기면 바뀌어 아래 선택을 **새 날짜 시드로** 다시 계산하게 한다. 전에는 userId 만 봐서 화면을 열어 둔 채
+       자정을 넘기면 어제 시드의 세트가 '오늘' 로 보이는데 완료 기록에는 새 날짜가 찍혔다. */
+    const [오늘, set오늘] = useState(() => getTodayKst());
+    useEffect(() => {
+        const 다음자정까지 = () => {
+            const 지금 = Date.now();
+            const kst = new Date(지금 + 9 * 3600_000);
+            const 자정 = Date.UTC(kst.getUTCFullYear(), kst.getUTCMonth(), kst.getUTCDate() + 1) - 9 * 3600_000;
+            return Math.max(1000, 자정 - 지금 + 1000);
+        };
+        let t = setTimeout(function 넘김() { set오늘(getTodayKst()); t = setTimeout(넘김, 다음자정까지()); }, 다음자정까지());
+        return () => clearTimeout(t);
+    }, []);
     useEffect(() => {
         let cancelled = false;
         let timer;
@@ -90,7 +104,9 @@ export function useDailyTrainingSelection(userId) {
         tryFill();
         timer = setInterval(tryFill, 250);
         return () => { cancelled = true; stop(); };
-    }, [userId]);
+        // 오늘 은 날짜가 바뀌었다는 신호 — resolveSelection 이 안에서 오늘 날짜를 읽는다
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [userId, 오늘]);
     const getTrainingPerType = useCallback((typeKey) => {
         const src = showYesterday ? yesterdayRef.current : todayRef.current;
         const fallback = showYesterday ? todayRef.current : yesterdayRef.current;

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

@@ -3,6 +3,12 @@
  *
  * @public
  */
+/**
+ * 같은 항목인가 — 같은 참조이거나, **둘 다 비지 않은 같은 id 를 가지면** 같다(빈 id 는 새로 만든 로컬 항목이라 견주지 않는다).
+ * 서버에서 목록을 다시 받으면 항목이 모두 새 객체가 되는데, 고른 항목·지울 항목을 참조로만 견주면 옛 참조가 아무것도
+ * 못 찾았다(수정 저장 → 재조회 → 같은 상세에서 '방문' 을 누르면 예정이 안 지워져 방문예정·방문완료 양쪽에 떴다).
+ */
+export declare function isSameEditableItem<T>(a: T, b: T): boolean;
 export declare function useEditableList<T>(emptyItem: T, initialList?: T[]): {
     list: T[];
     setList: import("react").Dispatch<import("react").SetStateAction<T[]>>;

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

@@ -5,6 +5,18 @@ import { useCallback, useEffect, useRef, useState } from 'react';
  *
  * @public
  */
+/**
+ * 같은 항목인가 — 같은 참조이거나, **둘 다 비지 않은 같은 id 를 가지면** 같다(빈 id 는 새로 만든 로컬 항목이라 견주지 않는다).
+ * 서버에서 목록을 다시 받으면 항목이 모두 새 객체가 되는데, 고른 항목·지울 항목을 참조로만 견주면 옛 참조가 아무것도
+ * 못 찾았다(수정 저장 → 재조회 → 같은 상세에서 '방문' 을 누르면 예정이 안 지워져 방문예정·방문완료 양쪽에 떴다).
+ */
+export function isSameEditableItem(a, b) {
+    if (a === b)
+        return true;
+    const ia = a?.id;
+    const ib = b?.id;
+    return ia != null && ia !== '' && ia === ib;
+}
 export function useEditableList(emptyItem, initialList = []) {
     const [list, setList] = useState(initialList);
     const [selected, setSelected] = useState(null);
@@ -42,7 +54,14 @@ export function useEditableList(emptyItem, initialList = []) {
             return;
         prevInitialRef.current = initialList;
         setList(initialList);
+        // 고른 항목도 새 목록의 같은 항목(id)으로 옮긴다 — 옛 참조로 남으면 지우기·수정 대상 찾기가 헛돈다
+        setSelected(prev => (prev == null ? prev : initialList.find(v => isSameEditableItem(v, prev)) ?? prev));
     }, [initialList]);
+    /* 편집 중이 아닐 때는 편집 폼을 고른 항목에 맞춘다 — 취소하거나(서버 거절로) 되돌려도 폼이 저장 안 된 값을 들고 있어,
+       상세 화면에 거절된 값이 보이고 다시 '수정하기' 를 누르면 그 값에서 시작했다. */
+    // eslint-disable-next-line react-hooks/set-state-in-effect
+    useEffect(() => { if (!isEditing && selected != null)
+        setEditForm({ ...selected }); }, [isEditing, selected]);
     const openDetail = useCallback((item) => {
         setSelected(item);
         setIsEditing(false);
@@ -56,7 +75,7 @@ export function useEditableList(emptyItem, initialList = []) {
         setIsEditing(false);
     }, []);
     const remove = useCallback((item) => {
-        setList(prev => prev.filter(v => v !== item));
+        setList(prev => prev.filter(v => !isSameEditableItem(v, item)));
         setSelected(null);
     }, []);
     return {

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

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