@ihabdevteam/core 0.150.0 → 0.151.0

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

@@ -33,20 +33,26 @@ export function reviewCells(items, marks) {
     }
     return out;
 }
-/**
- * 복습표 이름.
- *
- * 원래 이름을 앞에 두어 **목록에서 나란히 붙어 보이게** 한다(대개 이름순·최신순으로 본다).
- * 날짜를 붙이는 것은 같은 표를 여러 번 돌리기 때문이다 — 없으면 같은 이름이 쌓여
- * 어느 것이 이번 것인지 알 수 없다.
- */
-export function reviewTableName(original, today) {
-    /* 지역 날짜가 아니라 KST 로 읽는다 — 이 날짜는 **표 이름에 저장되고** 같은 이름끼리
-       겹치는지 세는 데 쓰인다. 기기 시간대를 따르면 같은 날 만든 표가 다른 날짜를 달고
-       남아 회차 세기가 어긋난다. */
-    const [, 월, 일] = toKstYmd(today).split('-');
-    const 날짜 = `${월}.${일}`;
-    /* **복습표를 또 복습하면 꼬리가 쌓인다.** 그대로 두면
+/** 복습 꼬리 — `[N차 ]복습 MM.DD`. '복습' 뒤에 날짜가 따라와야만 꼬리로 본다("복습 자료" 같은 이름을 잘라 먹지 않게). */
+const 복습꼬리 = /\s*(?:(\d+)차\s*)?복습\s*\d{2}\.\d{2}$/;
+/** 원래 표 → (꼬리를 뗀 바탕 이름, 새 복습표의 회차). 메타가 있으면 메타를, 없으면 이름을 읽는다. */
+function 바탕과회차(src) {
+    const 이름 = src.name.trim();
+    const 메타회차 = src.reviewRound;
+    if (typeof 메타회차 === 'number' && Number.isFinite(메타회차) && 메타회차 >= 0) {
+        const 지난 = Math.floor(메타회차);
+        if (지난 === 0)
+            return { 바탕: 이름, 회차: 1 };
+        /* 메타가 말하는 **그 회차의 꼬리 하나만** 뗀다 — `수업 3차 복습 09.15`(1회) 에서 `3차` 를 회차로 먹지 않는다.
+           N차는 앞이 공백·처음일 때만 — `수업 13차 복습`(3회) 의 `3차` 를 떼지 않게. 사람이 이름을 고쳐 꼬리가 없으면
+           이름을 통째로 바탕으로 둔다. */
+        const 그꼬리 = 지난 === 1
+            ? /\s*복습\s*\d{2}\.\d{2}$/
+            : new RegExp(`(?:^|\\s)${지난}차\\s*복습\\s*\\d{2}\\.\\d{2}$`);
+        const m = 그꼬리.exec(이름);
+        return { 바탕: m ? 이름.slice(0, m.index).trim() : 이름, 회차: 지난 + 1 };
+    }
+    /* **메타 없는 옛 표 — 이름을 파싱한다.** 복습표를 또 복습하면 꼬리가 쌓인다. 그대로 두면
        `검수 대립쌍 복습 08.29 복습 08.30 복습 09.02` 처럼 자란다 — 복습을 거듭하는 것은
        정상 쓰임이라 금방 읽을 수 없는 이름이 된다. 붙어 있던 복습 꼬리를 떼고 새로 단다.
   
@@ -57,19 +63,52 @@ export function reviewTableName(original, today) {
   
        '복습' 은 뒤에 `MM.DD` 가 따라와야만 꼬리로 본다 — "복습 자료" 같은 사람이 지은
        이름을 잘라 먹지 않으려는 것이다. */
-    const 꼬리 = /\s*(?:(\d+)차\s*)?복습\s*\d{2}\.\d{2}$/;
-    let 바탕 = original.trim();
+    let 바탕 = 이름;
     let 세대 = 1;
     for (;;) {
-        const m = 꼬리.exec(바탕);
+        const m = 복습꼬리.exec(바탕);
         if (!m)
             break;
         세대 = Math.max(세대, (m[1] ? Number(m[1]) : 1) + 1);
         바탕 = 바탕.slice(0, m.index).trim();
     }
+    return { 바탕, 회차: 세대 };
+}
+/**
+ * 복습표 이름.
+ *
+ * 원래 이름을 앞에 두어 **목록에서 나란히 붙어 보이게** 한다(대개 이름순·최신순으로 본다).
+ * 날짜를 붙이는 것은 같은 표를 여러 번 돌리기 때문이다 — 없으면 같은 이름이 쌓여
+ * 어느 것이 이번 것인지 알 수 없다.
+ *
+ * 이름 형식(`바탕 [N차 ]복습 MM.DD`)은 저장된 이름·파싱과 맞추느라 바꾸지 않는다.
+ * 원래 표를 {@link ReviewSource} 로 넘기면 복습 메타(`reviewRound`)를 이름 파싱보다 먼저 쓴다 —
+ * 새 복습표를 저장할 때는 {@link reviewMeta} 의 값을 함께 남긴다. 글자만 넘기면 지금처럼 이름을 파싱한다.
+ */
+export function reviewTableName(original, today) {
+    /* 지역 날짜가 아니라 KST 로 읽는다 — 이 날짜는 **표 이름에 저장되고** 같은 이름끼리
+       겹치는지 세는 데 쓰인다. 기기 시간대를 따르면 같은 날 만든 표가 다른 날짜를 달고
+       남아 회차 세기가 어긋난다. */
+    const [, 월, 일] = toKstYmd(today).split('-');
+    const 날짜 = `${월}.${일}`;
+    const { 바탕, 회차: 세대 } = 바탕과회차(typeof original === 'string' ? { name: original } : original);
     const 회차 = 세대 >= 2 ? `${세대}차 ` : '';
     return `${바탕 || '단어표'} ${회차}복습 ${날짜}`;
 }
+/**
+ * 새로 만들 복습표에 **함께 저장할 메타** — 맨 처음 원본 표 id 와 이번이 몇 번째 복습인지.
+ *
+ * `reviewOf` 는 원래 표가 복습표면 그 표의 `reviewOf` 를, 아니면 원래 표의 `id` 를 잇는다(둘 다 없으면 `undefined`).
+ * `reviewRound` 는 {@link reviewTableName} 이 이름에 적는 회차와 같다(1 = 첫 복습).
+ *
+ * @public
+ */
+export function reviewMeta(source) {
+    return {
+        reviewOf: source.reviewOf ?? source.id ?? undefined,
+        reviewRound: 바탕과회차(source).회차,
+    };
+}
 /**
  * 칸 번호 → 그때 보인 낱말. 채점과 **함께 저장한다.**
  *
@@ -96,6 +135,25 @@ export function labelsForSave(labels, marks) {
 export function cellLabel(words) {
     return words.map(w => w.label).join(' / ');
 }
+/**
+ * 한 칸의 낱말들을 **동형어 번호까지** 한 줄로 — `배#2 / 패`. 번호가 없는 낱말은 {@link cellLabel} 과 같다.
+ *
+ * 채점과 함께 저장하는 칸 낱말(`labelsForSave` 에 넘길 것)로 쓰면 `weakItems` 가 '배'(1)·'배'(2) 를 따로 센다.
+ * 글자만(`cellLabel`) 저장하면 둘의 성적이 한 줄로 합쳐진다. 화면에 보일 글자는 {@link labelOfCellKey} 로 되돌린다.
+ *
+ * @public
+ */
+export function cellKey(words) {
+    return words.map(w => (w.homonum != null ? `${w.label}#${w.homonum}` : w.label)).join(' / ');
+}
+/**
+ * {@link cellKey} 로 만든 칸 낱말에서 동형어 번호를 뗀 보이는 글자 — `배#2 / 패` → `배 / 패`. 번호가 없으면 그대로.
+ *
+ * @public
+ */
+export function labelOfCellKey(key) {
+    return key.split(' / ').map(s => s.replace(/#\d+$/, '')).join(' / ');
+}
 /**
  * 채점한 표를 인쇄할 때 종이 맨 위에 찍는 한 줄.
  *

package/dist/packages/core/src/components/Word/wordTableSettings.d.ts

@@ -26,6 +26,15 @@ export declare function buildItemsPerPageSection(t: TFunction, opts: {
     hasPairs: boolean;
     itemCount: number;
 }): FilterPanelSection;
+/**
+ * 페이지당 개수 섹션에서 고른 값 → 기억할 페이지당 개수.
+ *
+ * **첫 칸(그때의 항목 수 = 한 쪽에 전부)을 고르면 늘 전체(`Infinity`)** 로 기억한다 — 항목 수가 표준값(8·4·2·1)과
+ * 같을 때 숫자로 담으면, 4개일 때 '4개(전부)' 를 골라 둔 표에 낱말을 더 담는 순간 4개씩 두 쪽으로 나뉘었다
+ * (5개일 때 '5개' 는 목록에 없는 수라 전체로 기억돼 한 쪽에 남았다 — 같은 첫 칸인데 뜻이 갈렸다).
+ * 목록에 없는 수(항목이 줄어 사라진 옛 선택)도 전체로 본다. 나머지 표준값은 그 수로 나눈다.
+ */
+export declare function itemsPerPageFromChoice(n: number, itemCount: number): number;
 /** @public 페이지 번호 위치(왼쪽/중앙/오른쪽/미표시) 세그먼트 섹션 — 실제 2페이지 이상일 때만 노출. */
 export declare function buildPageNumberSection(t: TFunction): FilterPanelSection;
 /** @public 페이지 번호 위치 → filterSelected 표시값. */

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

@@ -77,6 +77,17 @@ export function buildItemsPerPageSection(t, opts) {
         display: 'segmented',
     };
 }
+/**
+ * 페이지당 개수 섹션에서 고른 값 → 기억할 페이지당 개수.
+ *
+ * **첫 칸(그때의 항목 수 = 한 쪽에 전부)을 고르면 늘 전체(`Infinity`)** 로 기억한다 — 항목 수가 표준값(8·4·2·1)과
+ * 같을 때 숫자로 담으면, 4개일 때 '4개(전부)' 를 골라 둔 표에 낱말을 더 담는 순간 4개씩 두 쪽으로 나뉘었다
+ * (5개일 때 '5개' 는 목록에 없는 수라 전체로 기억돼 한 쪽에 남았다 — 같은 첫 칸인데 뜻이 갈렸다).
+ * 목록에 없는 수(항목이 줄어 사라진 옛 선택)도 전체로 본다. 나머지 표준값은 그 수로 나눈다.
+ */
+export function itemsPerPageFromChoice(n, itemCount) {
+    return n === itemCount || !ITEMS_PER_PAGE_OPTIONS.includes(n) ? Number.POSITIVE_INFINITY : n;
+}
 /** @public 페이지 번호 위치(왼쪽/중앙/오른쪽/미표시) 세그먼트 섹션 — 실제 2페이지 이상일 때만 노출. */
 export function buildPageNumberSection(t) {
     return {

package/dist/packages/core/src/components/WordTable.css

@@ -266,6 +266,16 @@
     opacity: 1;
 }
 
+/* 터치 기기에는 hover 가 없다 — 위 규칙들이 :hover 로만 드러내 손가락으로는 빼기·재생·정보 단추가 보이지 않았다
+   (보이지 않는 단추를 짐작으로 눌러야 했다). 늘 보이게만 한다 — 색·모양은 그대로. 인쇄에서는 아래 @media print 가 치운다. */
+@media (hover: none) {
+    .word-table-block__card-close,
+    .word-table-cell__play-button,
+    .word-table-cell__info-button {
+        opacity: 1;
+    }
+}
+
 .word-table-cell__image-wrap {
     position: relative;
     width: 240px;

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

@@ -12,18 +12,16 @@ import { getTTSUrlResolver } from '../utils/ttsConfig';
 import { getImageResolver } from '../utils/imageConfig';
 import { getPronunciationResolver } from '../utils/pronunciationConfig';
 import { useWordImage } from '../hooks/useWordImage';
+import { isTouchPointer, recentlyTouched, useTouchToggle } from '../hooks/touchToggle';
 import { WORD_TABLE_PAPER, gridFor, CUT_CLASS, POS_LABEL, WORD_TYPE_LABEL, expandSlashLabel, dotDashStyle, REF_W_BOTH, REF_W_TEXT_ONLY, REF_W_IMAGE_ONLY, REF_H_BOTH, REF_H_TEXT_ONLY, REF_H_IMAGE_ONLY, } from './wordTableLayout';
 import { useFitScale } from './useFitScale';
+import { claimSound } from './Training/currentSound';
 // 외부(배럴·TodayPage·WordTableBlock 등) import 호환을 위해 재export
 /* 순수 함수(printWordTable·chunkItems)는 여기서 재수출하지 않는다 — 컴포넌트 파일이
    컴포넌트 아닌 것을 내보내면 Fast Refresh 가 깨져, 이 파일을 고칠 때마다 화면 상태가
    통째로 날아간다. 쓰는 쪽은 `wordTableLayout` 에서 바로 가져온다.
    (상수 하나는 남긴다 — 규칙이 상수는 허용하고, 지우면 공개 API 가 바뀐다.) */
 export { WORD_TABLE_PAPER } from './wordTableLayout';
-// 모듈 레벨 — 단어표 안에는 WordCell이 다수 렌더되는데, 각자 자기 audio만 관리하면
-// 여러 셀을 빠르게 연달아 클릭했을 때 발음이 겹쳐 재생된다. 마지막으로 재생을 시작한
-// 인스턴스만 currentlyPlaying으로 추적해, 새 재생이 시작될 때 이전 것을 정지시킨다.
-let currentlyPlaying = null;
 function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true, showImage = true, showPronunciation = true, showColloquial = true, buttonSize = 40, wordInfo, }) {
     const { t } = useTranslation();
     const outerRef = useRef(null);
@@ -41,6 +39,11 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
     const { imgRef, loading: imgLoading, failed: imgFailed, onLoad: handleImgLoad, onError: handleImgError } = useWordImage(imageUrl);
     const handleInfoEnter = useCallback(() => setInfoAnchor(infoRef.current?.getBoundingClientRect() ?? null), []);
     const handleInfoLeave = useCallback(() => setInfoAnchor(null), []);
+    /* 터치 — 톡하면 열렸다 떼자마자 닫혀 낱말 정보를 읽을 수 없었다. 톡으로 열고 닫는다(마우스·키보드는 그대로) */
+    const 정보톡 = useTouchToggle(!!infoAnchor, (next) => { if (next)
+        handleInfoEnter();
+    else
+        handleInfoLeave(); }, infoRef);
     const infoTooltipItems = useMemo(() => {
         if (!wordInfo)
             return null;
@@ -72,38 +75,41 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
     // 컴포넌트 언마운트 시 발음 재생 중단 — audioRef는 <audio> JSX가 아니라 new Audio()로
     // 직접 만든 객체라 DOM에서 안 사라지므로, 재생 중에 팝업이 닫히는 등으로 언마운트되면
     // pause() 없이는 화면이 사라진 뒤에도 계속 재생된다.
+    /** 지금 내 소리를 멈추는 함수(자물쇠에 맡긴 것)와, 자물쇠 자리만 비우는 함수 */
+    const stopRef = useRef(null);
+    const releaseRef = useRef(null);
     useEffect(() => () => {
         audioRef.current?.pause();
-        if (currentlyPlaying?.audio === audioRef.current)
-            currentlyPlaying = null;
+        /* 자리만 비운다(내가 아직 주인일 때만) — 멈춤 함수를 부르면 사라진 화면의 상태를 건드린다 */
+        releaseRef.current?.();
     }, []);
     const handlePlay = useCallback(async (e) => {
         e.stopPropagation();
         if (playing) {
-            audioRef.current?.pause();
-            setPlaying(false);
-            currentlyPlaying = null;
+            stopRef.current?.();
             return;
         }
         if (!audioUrl)
             return;
-        currentlyPlaying?.stop();
         setPlaying(true);
         try {
             const audio = new Audio(audioUrl);
             audioRef.current = audio;
-            const clearIfSelf = () => { setPlaying(false); if (currentlyPlaying?.audio === audio)
-                currentlyPlaying = null; };
-            currentlyPlaying = { audio, stop: () => { audio.pause(); clearIfSelf(); } };
-            audio.onended = clearIfSelf;
-            audio.onerror = clearIfSelf;
+            /* 끝나거나 멈추면 자리를 비운다 — 이미 다음 사람이 가져갔으면 release 는 아무것도 안 한다 */
+            const done = () => { setPlaying(false); releaseRef.current?.(); };
+            const stop = () => { audio.pause(); done(); };
+            stopRef.current = stop;
+            /* 자물쇠를 잡으면 앞서 울리던 것(다른 칸·훈련 카드 등)이 멈추고, 남이 잡으면 stop 이 불려 내가 멈춘다 */
+            const release = claimSound(stop);
+            releaseRef.current = release;
+            audio.onended = done;
+            audio.onerror = done;
             await audio.play();
         }
         catch {
             setPlaying(false);
-            if (currentlyPlaying?.audio === audioRef.current)
-                currentlyPlaying = null;
-        }
+            releaseRef.current?.();
+        } // 재생 거절(자동재생 막힘 등) — 울리지 않으니 자리만 비운다
     }, [playing, audioUrl]);
     const hasImage = showImage && !!imageUrl && !imgFailed;
     const refW = hasImage && showWord ? REF_W_BOTH : hasImage ? REF_W_IMAGE_ONLY : REF_W_TEXT_ONLY;
@@ -124,14 +130,17 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
         obs.observe(el);
         return () => obs.disconnect();
     }, [refW, refH]);
-    return (_jsxs("div", { ref: outerRef, className: "word-table-cell", children: [_jsxs("div", { className: "word-table-cell__inner", style: { transform: `scale(${scale})` }, children: [hasImage && (_jsxs("div", { className: "word-table-cell__image-wrap", children: [imgLoading && _jsx("div", { className: "word-table-cell__spinner" }), _jsx("img", { ref: imgRef, className: "word-table-cell__image", src: imageUrl, alt: label, draggable: false, style: { opacity: imgLoading ? 0 : 1 }, onLoad: handleImgLoad, onError: handleImgError })] })), showWord && _jsx("span", { className: "word-table-cell__word h0", children: label }), showPronunciation && pron && _jsxs("span", { className: "word-table-cell__sub h3", children: ["[", pron, "]"] }), showColloquial && colloquialLabel && _jsxs("span", { className: "word-table-cell__colloquial h5", children: ["[", colloquialLabel, "]"] })] }), _jsxs("div", { className: "word-table-cell__play-button", "data-audio-src": audioUrl, children: [_jsx("span", { "data-play-state": "play", style: { display: playing ? 'none' : undefined }, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "play", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: t('common.play', '재생'), onClick: handlePlay }) }), _jsx("span", { "data-play-state": "pause", style: { display: playing ? undefined : 'none' }, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "pause", useBorder: false, selected: true, showTooltipInfo: t('common.pause', '멈춤'), onClick: handlePlay }) })] }), wordInfo && (_jsxs("div", { ref: infoRef, className: "word-table-cell__info-button", onPointerEnter: handleInfoEnter, onPointerLeave: handleInfoLeave, 
+    return (_jsxs("div", { ref: outerRef, className: "word-table-cell", children: [_jsxs("div", { className: "word-table-cell__inner", style: { transform: `scale(${scale})` }, children: [hasImage && (_jsxs("div", { className: "word-table-cell__image-wrap", children: [imgLoading && _jsx("div", { className: "word-table-cell__spinner" }), _jsx("img", { ref: imgRef, className: "word-table-cell__image", src: imageUrl, alt: label, draggable: false, style: { opacity: imgLoading ? 0 : 1 }, onLoad: handleImgLoad, onError: handleImgError })] })), showWord && _jsx("span", { className: "word-table-cell__word h0", children: label }), showPronunciation && pron && _jsxs("span", { className: "word-table-cell__sub h3", children: ["[", pron, "]"] }), showColloquial && colloquialLabel && _jsxs("span", { className: "word-table-cell__colloquial h5", children: ["[", colloquialLabel, "]"] })] }), _jsxs("div", { className: "word-table-cell__play-button", "data-audio-src": audioUrl, children: [_jsx("span", { "data-play-state": "play", style: { display: playing ? 'none' : undefined }, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "play", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: t('common.play', '재생'), onClick: handlePlay }) }), _jsx("span", { "data-play-state": "pause", style: { display: playing ? undefined : 'none' }, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "pause", useBorder: false, selected: true, showTooltipInfo: t('common.pause', '멈춤'), onClick: handlePlay }) })] }), wordInfo && (_jsxs("div", { ref: infoRef, className: "word-table-cell__info-button", onPointerEnter: (e) => { if (!isTouchPointer(e))
+                    handleInfoEnter(); }, onPointerLeave: (e) => { if (!isTouchPointer(e))
+                    handleInfoLeave(); }, 
                 // 이 div 자체는 포커스 대상이 아니지만 안의 Button이 포커스를 받으면
-                // focusin이 여기로 올라온다 — 그래서 래퍼에 걸어도 동작한다.
-                onFocus: handleInfoEnter, onBlur: handleInfoLeave, children: [_jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "info", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: false, 
+                // focusin이 여기로 올라온다 — 그래서 래퍼에 걸어도 동작한다. 톡으로 온 초점은 톡 토글이 정한다.
+                onFocus: () => { if (!recentlyTouched())
+                    handleInfoEnter(); }, onBlur: handleInfoLeave, children: [_jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "info", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: false, 
                         /* 아이콘만 있는 버튼이라 이름이 없으면 화면 낭독기가 "버튼"으로만 읽는다.
                            한 표에 칸마다 하나씩 있어 열두 개가 다 "버튼"이 된다 — 어느 낱말의
                            것인지 알 길이 없으므로 낱말을 이름에 넣는다. */
-                        ariaLabel: t('wordTable.wordInfo', '{{word}} 낱말 정보', { word: label }), onClick: (e) => e.stopPropagation() }), infoAnchor && infoTooltipItems && (_jsx(DescriptionTooltip, { anchorRect: infoAnchor, items: infoTooltipItems, showIndex: false }))] }))] }));
+                        ariaLabel: t('wordTable.wordInfo', '{{word}} 낱말 정보', { word: label }), onClick: (e) => { e.stopPropagation(); 정보톡.touchPress(); } }), infoAnchor && infoTooltipItems && (_jsx(DescriptionTooltip, { anchorRect: infoAnchor, items: infoTooltipItems, showIndex: false }))] }))] }));
 }
 // ── WordTable (표 디자인) ──────────────────────────────────────
 /* 품사·어종 약호 → 지금 언어의 이름. 사전에 없으면 원본 한국어 이름표(POS_LABEL·WORD_TYPE_LABEL) */
@@ -168,6 +177,8 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
     };
     const { t } = useTranslation();
     const isEdit = editCells !== undefined;
+    /** title·titleIcon·disc 중 하나라도 있으면 Section 으로 감싼다 */
+    const wrapped = title != null || !!titleIcon || !!disc;
     // 드래그 상태(표시 모드 재정렬)
     const dragIndex = useRef(null);
     const [dragOver, setDragOver] = useState(null);
@@ -185,19 +196,21 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
     };
     const hasPairs = isEdit
         ? (editCells ?? []).some(c => c !== null && c.length > 1)
-        : (items ?? []).some(item => item.words.length > 1);
+        : (items ?? []).some(item => (item.words ?? []).length > 1);
     const contentClass = cx('word-table-block__content', CUT_CLASS[cutLine], showOutline && 'word-table-block__content--outline', showDivLine && hasPairs && 'word-table-block__content--div-line');
     // 빈칸(추가버튼)은 스케일 역보정으로 실제 크기 유지
     const counterScale = { transform: `scale(${1 / scale})`, transformOrigin: 'center center' };
-    const grid = (_jsx("div", { ref: scalerRef, className: "word-table__scaler", style: { height: height * scale }, children: _jsx("div", { className: cx('word-table', className), style: { width, height, transform: `scale(${scale})`, transformOrigin: 'top left', marginLeft: offset }, children: _jsxs("div", { ref: contentRef, className: contentClass, style: { gridTemplateColumns: `repeat(${cols}, 1fr)`, gridTemplateRows: `repeat(${rows}, 1fr)` }, children: [isEdit ? (_jsx(_Fragment, { children: (editCells ?? []).map((cell, i) => (_jsx("div", { className: cx('word-table-block__edit-cell', cell ? 'word-table-block__edit-cell--filled' : 'word-table-block__edit-cell--empty', activeCell === i ? 'word-table-block__edit-cell--active' : ''), style: dotDashStyle(i, cols, rows, cutLine), children: cell ? (_jsxs(_Fragment, { children: [cell.map((e, wi) => (_jsxs(Fragment, { children: [wi > 0 && _jsx("div", { className: "word-table-block__pair-divider" }), _jsx(WordCell, { label: e.word, subLabel: e.pronunciation, 
+    const grid = (_jsx("div", { ref: scalerRef, className: "word-table__scaler", style: { height: height * scale }, children: _jsx("div", { 
+            /* title 로 Section 에 감쌀 때는 className 을 바깥 한 곳에만 — 두 곳에 붙어 소비자 스타일이 두 번 걸렸다 */
+            className: cx('word-table', !wrapped && className), style: { width, height, transform: `scale(${scale})`, transformOrigin: 'top left', marginLeft: offset }, children: _jsxs("div", { ref: contentRef, className: contentClass, style: { gridTemplateColumns: `repeat(${cols}, 1fr)`, gridTemplateRows: `repeat(${rows}, 1fr)` }, children: [isEdit ? (_jsx(_Fragment, { children: (editCells ?? []).map((cell, i) => (_jsx("div", { className: cx('word-table-block__edit-cell', cell ? 'word-table-block__edit-cell--filled' : 'word-table-block__edit-cell--empty', activeCell === i ? 'word-table-block__edit-cell--active' : ''), style: dotDashStyle(i, cols, rows, cutLine), children: cell ? (_jsxs(_Fragment, { children: [cell.map((e, wi) => (_jsxs(Fragment, { children: [wi > 0 && _jsx("div", { className: "word-table-block__pair-divider" }), _jsx(WordCell, { label: e.word, subLabel: e.pronunciation, 
                                                 // 편집 칸도 구어체 발음을 넘긴다 — 빠져 있어 '구어체 발음'을 켜도 편집 모드에서만 비었다.
                                                 colloquialLabel: e.colloquialPronunciation, homonum: e.homonum, showWord: show.word, showImage: show.image, showPronunciation: show.pron, showColloquial: show.colloq, buttonSize: buttonSize })] }, wi))), scoring && renderScore(i, cell.map(e => e.word).join(' / ')), onRemoveCell && (_jsx("div", { className: "word-table-block__card-close", children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "x", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: cell.length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), ariaLabel: cell.length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), onClick: () => onRemoveCell(i) }) }))] })) : (onActivateCell && (_jsx("div", { style: counterScale, children: _jsx(Button, { htmlType: "button", size: "48", type: "bar", icon: "plus", label: t('wordTable.addWord', '추가하기'), onClick: () => onActivateCell(i) }) }))) }, i))) })) : (_jsxs(_Fragment, { children: [(items ?? []).map((item, index) => (_jsxs("div", { className: `word-table-block__card${onReorder ? ' word-table-block__card--draggable' : ''}${dragOver === index ? ' word-table-block__card--drag-over' : ''}`, style: dotDashStyle(index, cols, rows, cutLine), draggable: !!onReorder, onDragStart: onReorder ? () => { dragIndex.current = index; } : undefined, onDragOver: onReorder ? (e) => { e.preventDefault(); setDragOver(index); } : undefined, onDragLeave: onReorder ? () => setDragOver(null) : undefined, onDrop: onReorder ? (e) => { e.preventDefault(); if (dragIndex.current !== null && dragIndex.current !== index) {
                                     onReorder(dragIndex.current, index);
-                                } ; dragIndex.current = null; setDragOver(null); } : undefined, onDragEnd: onReorder ? () => { dragIndex.current = null; setDragOver(null); } : undefined, children: [item.words.map((w, i) => (_jsxs(Fragment, { children: [i > 0 && _jsx("div", { className: "word-table-block__pair-divider" }), _jsx(WordCell, { label: w.label, subLabel: w.subLabel, colloquialLabel: w.colloquialLabel, homonum: w.homonum, showWord: show.word, showImage: show.image, showPronunciation: show.pron, showColloquial: show.colloq, buttonSize: buttonSize, wordInfo: (w.grade || w.syllables != null || w.pos || w.wordType) ? { grade: w.grade, syllables: w.syllables, pos: w.pos, wordType: w.wordType } : undefined })] }, i))), scoring && renderScore(index, item.words.map(w => w.label).join(' / ')), onRemoveItem && (_jsx("div", { className: "word-table-block__card-close", children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "x", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: item.words.length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), ariaLabel: item.words.length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), onClick: () => onRemoveItem(item.id) }) }))] }, item.id))), Array.from({ length: Math.max(0, cols * rows - (items?.length ?? 0)) }).map((_, i) => {
+                                } ; dragIndex.current = null; setDragOver(null); } : undefined, onDragEnd: onReorder ? () => { dragIndex.current = null; setDragOver(null); } : undefined, children: [(item.words ?? []).map((w, i) => (_jsxs(Fragment, { children: [i > 0 && _jsx("div", { className: "word-table-block__pair-divider" }), _jsx(WordCell, { label: w.label, subLabel: w.subLabel, colloquialLabel: w.colloquialLabel, homonum: w.homonum, showWord: show.word, showImage: show.image, showPronunciation: show.pron, showColloquial: show.colloq, buttonSize: buttonSize, wordInfo: (w.grade || w.syllables != null || w.pos || w.wordType) ? { grade: w.grade, syllables: w.syllables, pos: w.pos, wordType: w.wordType } : undefined })] }, i))), scoring && renderScore(index, (item.words ?? []).map(w => w.label).join(' / ')), onRemoveItem && (_jsx("div", { className: "word-table-block__card-close", children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "x", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: (item.words ?? []).length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), ariaLabel: (item.words ?? []).length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), onClick: () => onRemoveItem(item.id) }) }))] }, item.id))), Array.from({ length: Math.max(0, cols * rows - (items?.length ?? 0)) }).map((_, i) => {
                                 const isWithinCount = (items?.length ?? 0) + i < cellCount;
                                 return (_jsx("div", { className: "word-table-block__card word-table-block__card--filler", children: showFillerAdd && onActivateCell && isWithinCount && (_jsx("div", { style: counterScale, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "bar", icon: "plus", label: t('wordTable.addWord', '추가하기'), onClick: () => onActivateCell((items?.length ?? 0) + i) }) })) }, `filler-${i}`));
                             })] })), pageNumber && pageNumberPosition !== 'none' && (_jsx("span", { className: `word-table__page-number body-3 word-table__page-number--${pageNumberPosition}`, children: t('wordTable.filter.pageIndicator', { current: pageNumber.current, total: pageNumber.total }) }))] }) }) }));
-    if (title != null || titleIcon || disc) {
+    if (wrapped) {
         return (_jsx(Section, { type: "page", icon: titleIcon, title: title, disc: disc, className: cx('word-table-block', className), children: grid }));
     }
     return grid;

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

@@ -42,7 +42,7 @@ export interface BarChartProps {
      *
      * 굵기만 줄이고 싶을 때 `small` 로 가면 높이·헤더 컨트롤·합계 라벨까지 같이
      * 줄어든다(2026-09-10 말귀 실측). 이 값은 굵기만 바꾼다. 막대가 많아지면 여기
-     * 적은 값을 **위 한계**로 두고 점진 축소하는 것은 그대로다.
+     * 적은 값을 **위 한계**로 두고 점진 축소하는 것은 그대로다. 아래 한계는 2px(그보다 작은 값은 2 로).
      *
      * CSS 로 덮고 싶으면 `.manager-bar-chart-bar`·`-stack` 의 `--bar-width` 를 쓴다 —
      * 굵기는 인라인이 아니라 그 변수로 박혀 있다.
@@ -58,7 +58,7 @@ export interface BarChartProps {
     /** 계열 A/B 레이블 i18n 키. labelBKey 미지정 시 단일 계열 */
     labelAKey: string;
     labelBKey?: string;
-    /** 선택된 구간의 합계(a+b)를 헤더 아래 히어로로 표시 */
+    /** 선택된 구간의 합계(a+b)를 헤더 아래 히어로로 표시. 월 보기는 그 달 날짜만 센다(주 막대가 달 경계를 넘어도 합계는 달력 달 — 상세 목록과 같은 범위) */
     showTotal?: boolean;
     /** 합계 단위 i18n 키 (예: 'trainingStatus.weekly.unit' → '회') */
     totalUnitKey?: string;

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

@@ -66,6 +66,14 @@ export interface ButtonProps {
     align?: 'center' | 'left' | 'right' | 'grid';
     selected?: boolean;
     toggleable?: boolean;
+    /**
+     * 여닫이 단추(설정 판·미리보기·유의사항 펼치기)의 열림 상태. 주면 `aria-expanded` 로 알리고 **`aria-pressed` 는 달지 않는다** —
+     * `selected={열림}` 만 주면 "눌림" 으로 읽혀 무엇이 열렸는지 알 수 없었다. 켜진 모양(`is-selected`)은 `selected` 로 따로 준다.
+     * @example <Button label="훈련 설정" selected={open} ariaExpanded={open} ariaControls={panelId} />
+     */
+    ariaExpanded?: boolean;
+    /** 이 단추가 여닫는 영역의 id — `aria-controls` 로 단다(`ariaExpanded` 와 함께 쓴다) */
+    ariaControls?: string;
     disabled?: boolean;
     /** label을 숨기려면 false로 설정 */
     useLabel?: boolean;

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

@@ -0,0 +1,2 @@
+/** 자리를 올린다. 돌려준 함수로 내린다. 같은 스택 안의 여러 장은 한 자리를 함께 쓴다 */
+export declare function registerUpdateAlertSlot(el: HTMLElement): () => void;

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

@@ -0,0 +1,68 @@
+/**
+ * 우상단 알림 자리들을 한 줄로 쌓는다(내부).
+ *
+ * 낱장 `UpdateAlert` 와 `.update-alert-stack` 은 **둘 다** 창 우상단(top 16px)에 fixed 로 붙는다. 한 화면에 둘이 함께 뜨면
+ * (말귀: 앱 자리의 단어 자료 업데이트 알림 + 이용권 만료 스택) 서로 완전히 겹쳐 아래 것의 글·닫기 단추를 가렸다.
+ * 자리(낱장 또는 스택 하나)마다 문서 순서대로 앞 자리들의 높이를 더해 `--update-alert-stack-offset` 으로 내려 준다.
+ *
+ * 같은 fixed 기준(뷰포트, 또는 transform 을 건 조상 — 놀이터 시연 틀)을 쓰는 자리끼리만 쌓는다.
+ */
+const 자리수 = new Map();
+let 관찰 = null;
+const GAP = 12;
+/* fixed 의 기준이 되는 조상 — transform·filter·perspective·contain 이 걸린 가장 가까운 조상, 없으면 문서 */
+function 기준찾기(el) {
+    for (let p = el.parentElement; p && p !== document.body; p = p.parentElement) {
+        const cs = window.getComputedStyle(p);
+        if ((cs.transform && cs.transform !== 'none') || (cs.filter && cs.filter !== 'none') || (cs.perspective && cs.perspective !== 'none') || /paint|layout|strict|content/.test(cs.contain || ''))
+            return p;
+    }
+    return document;
+}
+function 다시쌓기() {
+    const 무리 = new Map();
+    for (const el of 자리수.keys()) {
+        if (!el.isConnected)
+            continue;
+        const k = 기준찾기(el);
+        const 줄 = 무리.get(k) ?? [];
+        줄.push(el);
+        무리.set(k, 줄);
+    }
+    for (const 줄 of 무리.values()) {
+        줄.sort((a, b) => (a.compareDocumentPosition(b) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1));
+        let 아래로 = 0;
+        for (const el of 줄) {
+            if (아래로 > 0)
+                el.style.setProperty('--update-alert-stack-offset', `${아래로}px`);
+            else
+                el.style.removeProperty('--update-alert-stack-offset');
+            const h = el.getBoundingClientRect().height;
+            if (h > 0)
+                아래로 += h + GAP;
+        }
+    }
+}
+/** 자리를 올린다. 돌려준 함수로 내린다. 같은 스택 안의 여러 장은 한 자리를 함께 쓴다 */
+export function registerUpdateAlertSlot(el) {
+    if (typeof window === 'undefined')
+        return () => { };
+    자리수.set(el, (자리수.get(el) ?? 0) + 1);
+    if (자리수.get(el) === 1 && typeof ResizeObserver !== 'undefined') {
+        관찰 ??= new ResizeObserver(() => 다시쌓기());
+        관찰.observe(el);
+    }
+    다시쌓기();
+    return () => {
+        const n = (자리수.get(el) ?? 1) - 1;
+        if (n > 0) {
+            자리수.set(el, n);
+            다시쌓기();
+            return;
+        }
+        자리수.delete(el);
+        관찰?.unobserve(el);
+        el.style.removeProperty('--update-alert-stack-offset');
+        다시쌓기();
+    };
+}

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

@@ -7,6 +7,9 @@ export interface UseCalendarMonthResult {
 }
 /**
  * "현재 보고 있는 연/월" 상태 + 이전/다음 달 이동. DatePicker의 달력 네비게이션에서 쓴다.
+ *
+ * @param value 고른 날 'YYYY-MM-DD'. 비었으면 오늘의 달을 본다.
+ * @param today 선택. '오늘' 로 쓸 'YYYY-MM-DD'(로컬 앱·SSR). 없거나 꼴이 틀리면 KST 오늘.
  * @public
  */
-export declare function useCalendarMonth(value: string): UseCalendarMonthResult;
+export declare function useCalendarMonth(value: string, today?: string): UseCalendarMonthResult;

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

@@ -1,17 +1,20 @@
 'use client';
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { getTodayKst } from '../utils/date';
+import { todayYmdOr } from '../utils/date';
 /**
  * "현재 보고 있는 연/월" 상태 + 이전/다음 달 이동. DatePicker의 달력 네비게이션에서 쓴다.
+ *
+ * @param value 고른 날 'YYYY-MM-DD'. 비었으면 오늘의 달을 본다.
+ * @param today 선택. '오늘' 로 쓸 'YYYY-MM-DD'(로컬 앱·SSR). 없거나 꼴이 틀리면 KST 오늘.
  * @public
  */
-export function useCalendarMonth(value) {
+export function useCalendarMonth(value, today) {
     const initYM = () => {
         if (value) {
             const [y, m] = value.split('-');
             return { y: +y, m: +m - 1 };
         }
-        const [y, m] = getTodayKst().split('-'); // 값이 없으면 KST 오늘의 달(해외 기기 공식 지원)
+        const [y, m] = todayYmdOr(today).split('-'); // 값이 없으면 오늘(기본 KST — 해외 기기 공식 지원)의 달
         return { y: +y, m: +m - 1 };
     };
     const [viewY, setViewY] = useState(() => initYM().y);

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

@@ -3,6 +3,9 @@ import { type KeyboardEvent } from 'react';
  * TextField의 `suggestions` 옵션이 쓰는 자동완성 콤보박스 상태/키보드 로직.
  * 순수 입력(값 관리)과 분리해서, 자동완성이 필요 없는 TextField 사용처는
  * 이 훅의 상태가 전혀 관여하지 않는다(항상 호출되지만 open은 기본 false로 시작).
+ *
+ * 한글 조합 중에는 걸리는 후보가 0 건이 되어도 직전 목록을 유지한다 — 입력칸에 `handleCompositionStart`·
+ * `handleCompositionEnd` 를 걸어야 한다(TextField 는 건다). 걸지 않으면 지금처럼 매 값마다 다시 거른다.
  * @public
  */
 export declare function useComboboxSuggestions({ value, onChange, suggestions, openOnFocus, }: {
@@ -20,4 +23,8 @@ export declare function useComboboxSuggestions({ value, onChange, suggestions, o
     handleInput: () => void;
     handleKeyDown: (e: KeyboardEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
     handleSelect: (item: string) => void;
+    /** 입력칸의 onCompositionStart 에 건다 — 조합 중에는 걸리는 후보가 0 건이 되어도 직전 목록을 둔다 */
+    handleCompositionStart: () => void;
+    /** 입력칸의 onCompositionEnd 에 건다 — 조합이 끝나면 목록을 다시 계산한다 */
+    handleCompositionEnd: () => void;
 };

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

@@ -4,6 +4,9 @@ import { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react'
  * TextField의 `suggestions` 옵션이 쓰는 자동완성 콤보박스 상태/키보드 로직.
  * 순수 입력(값 관리)과 분리해서, 자동완성이 필요 없는 TextField 사용처는
  * 이 훅의 상태가 전혀 관여하지 않는다(항상 호출되지만 open은 기본 false로 시작).
+ *
+ * 한글 조합 중에는 걸리는 후보가 0 건이 되어도 직전 목록을 유지한다 — 입력칸에 `handleCompositionStart`·
+ * `handleCompositionEnd` 를 걸어야 한다(TextField 는 건다). 걸지 않으면 지금처럼 매 값마다 다시 거른다.
  * @public
  */
 export function useComboboxSuggestions({ value, onChange, suggestions, openOnFocus = false, }) {
@@ -11,7 +14,7 @@ export function useComboboxSuggestions({ value, onChange, suggestions, openOnFoc
     const [open, setOpen] = useState(false);
     const [activeIdx, setActiveIdx] = useState(-1);
     const blurTimerRef = useRef(null);
-    const filtered = useMemo(() => {
+    const 계산한것 = useMemo(() => {
         if (!suggestions.length)
             return [];
         const v = value ?? '';
@@ -19,6 +22,16 @@ export function useComboboxSuggestions({ value, onChange, suggestions, openOnFoc
             return openOnFocus ? suggestions : [];
         return suggestions.filter(s => s.toLowerCase().includes(v.toLowerCase()));
     }, [suggestions, value, openOnFocus]);
+    /* **한글 조합 중에는 0 건이 되어도 직전 목록을 둔다.** '사'→'삭'→'사고' 로 치는 동안 중간값 '삭' 에 걸리는 후보가 없어
+       목록이 한 박자 사라졌다 돌아왔다(깜빡임·스크린리더가 목록 닫힘을 알림). 조합이 끝나면(compositionend) 다시 계산한다.
+       부르는 쪽이 suggestions 를 값으로 미리 거른 경우(matchesWordQuery 순위 등)도 같다 — 순위 규칙은 건드리지 않는다. */
+    const [조합중, set조합중] = useState(false);
+    const 직전목록 = useRef([]);
+    const filtered = 조합중 && 계산한것.length === 0 ? 직전목록.current : 계산한것;
+    useEffect(() => { if (filtered.length)
+        직전목록.current = filtered; }, [filtered]);
+    const handleCompositionStart = useCallback(() => set조합중(true), []);
+    const handleCompositionEnd = useCallback(() => set조합중(false), []);
     // 메뉴가 닫히면 활성 인덱스를 리셋하는 의도된 동기화다
     // eslint-disable-next-line react-hooks/set-state-in-effect
     useEffect(() => { if (!open)
@@ -66,5 +79,11 @@ export function useComboboxSuggestions({ value, onChange, suggestions, openOnFoc
             } // 제안이 열렸을 때만 소비(상위 팝업 ESC보다 우선하지 않도록)
         }
     }, [filtered, safeIdx, open, handleSelect]);
-    return { listId, open, activeIdx: safeIdx, filtered, handleFocus, handleBlur, handleInput, handleKeyDown, handleSelect };
+    return {
+        listId, open, activeIdx: safeIdx, filtered, handleFocus, handleBlur, handleInput, handleKeyDown, handleSelect,
+        /** 입력칸의 onCompositionStart 에 건다 — 조합 중에는 걸리는 후보가 0 건이 되어도 직전 목록을 둔다 */
+        handleCompositionStart,
+        /** 입력칸의 onCompositionEnd 에 건다 — 조합이 끝나면 목록을 다시 계산한다 */
+        handleCompositionEnd,
+    };
 }

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

@@ -29,6 +29,10 @@ export declare const WORD_TABLE_PAPER: Record<WordTableOrientation, {
 /**
  * 화면에 렌더된 단어표(.word-table)를 인쇄한다.
  * @page 방향/크기를 임시 주입한 뒤 window.print()를 호출하고, 인쇄 후 정리한다.
+ *
+ * @deprecated WordTablePopup 의 `renderButtons` 가 넘기는 `print`(또는 `useWordTablePrint().print`)를 쓴다.
+ * 이 함수는 앱 화면 전체를 인쇄하며 전역 print CSS 로 `.word-table` 만 남기는데, 화면에 표가 둘이면 둘 다 찍히고
+ * 창·팝업 스타일이 섞인다 — 그쪽은 넘긴 표만 격리 iframe 에서 인쇄한다. 동작은 그대로 두고 개발 모드에서 한 번 알린다.
  * @public
  */
 export declare function printWordTable(orientation?: WordTableOrientation): void;

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

@@ -1,4 +1,5 @@
 'use client';
+import { devWarnOnce } from '../utils/devWarn';
 /** 종이 규격(A4) — 인쇄 캡처에서도 쓰도록 공개 */
 export const WORD_TABLE_PAPER = {
     landscape: { width: 1123, height: 794, printSize: 'A4 landscape', printW: '297mm', printH: '210mm' },
@@ -7,9 +8,14 @@ export const WORD_TABLE_PAPER = {
 /**
  * 화면에 렌더된 단어표(.word-table)를 인쇄한다.
  * @page 방향/크기를 임시 주입한 뒤 window.print()를 호출하고, 인쇄 후 정리한다.
+ *
+ * @deprecated WordTablePopup 의 `renderButtons` 가 넘기는 `print`(또는 `useWordTablePrint().print`)를 쓴다.
+ * 이 함수는 앱 화면 전체를 인쇄하며 전역 print CSS 로 `.word-table` 만 남기는데, 화면에 표가 둘이면 둘 다 찍히고
+ * 창·팝업 스타일이 섞인다 — 그쪽은 넘긴 표만 격리 iframe 에서 인쇄한다. 동작은 그대로 두고 개발 모드에서 한 번 알린다.
  * @public
  */
 export function printWordTable(orientation = 'landscape') {
+    devWarnOnce('print-word-table-deprecated', '[printWordTable] @deprecated — WordTablePopup renderButtons 의 print(또는 useWordTablePrint().print)를 쓰세요. 전역 인쇄는 화면의 모든 단어표를 함께 찍습니다.');
     const { printSize, printW, printH } = WORD_TABLE_PAPER[orientation];
     const style = document.createElement('style');
     style.textContent = `@page { size: ${printSize}; margin: 0; } .word-table { width: ${printW} !important; height: ${printH} !important; }`;

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

@@ -171,7 +171,8 @@ export { default as WordTablePopup } from './components/Training/WordTablePopup'
 export type { WordTablePopupProps, WordTablePopupActions } from './components/Training/WordTablePopup';
 export { MARKS, MARK_ICON, MARK_VARIANT, markAfterClick, marksForSave, pageStartIndexes, scoreKey, shouldConfirmDiscard, summarize } from './components/Word/wordTableScoring';
 export type { ScoreMark, ScoreSummary } from './components/Word/wordTableScoring';
-export { reviewCells, reviewTableName, scoreSheetHeader, labelsForSave, cellLabel } from './components/Word/wordTableReview';
+export { reviewCells, reviewTableName, reviewMeta, scoreSheetHeader, labelsForSave, cellLabel, cellKey, labelOfCellKey } from './components/Word/wordTableReview';
+export type { ReviewSource } from './components/Word/wordTableReview';
 export { weakItems, tableTrends, nextFocus } from './components/Word/wordScoreStats';
 export { summarizeMisses, nextMisses, missesByType, reviewSetPlan, SENTENCE_TRAINING_TYPES } from './components/Training/trainingMissStats';
 export type { TrainingResultRecord, MissedItem, MissSummary, MissGroup, ReviewSetRef, ReviewSetPlan } from './components/Training/trainingMissStats';

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

@@ -112,7 +112,7 @@ export { default as WordTablePopup } from './components/Training/WordTablePopup'
 /* 단어표 채점 규칙 — 앱 쪽(저장·요약 표시)에서도 같은 규칙을 써야 한다. */
 export { MARKS, MARK_ICON, MARK_VARIANT, markAfterClick, marksForSave, pageStartIndexes, scoreKey, shouldConfirmDiscard, summarize } from './components/Word/wordTableScoring';
 /* 채점 결과로 다음 표를 짜는 규칙 — 앱 쪽에서 복습표를 만들 때 쓴다. */
-export { reviewCells, reviewTableName, scoreSheetHeader, labelsForSave, cellLabel } from './components/Word/wordTableReview';
+export { reviewCells, reviewTableName, reviewMeta, scoreSheetHeader, labelsForSave, cellLabel, cellKey, labelOfCellKey } from './components/Word/wordTableReview';
 /* 쌓인 채점을 읽는 셈 — 무엇이 부족하고 다음에 무엇을 할지. */
 export { weakItems, tableTrends, nextFocus } from './components/Word/wordScoreStats';
 /* 앱에서 푼 훈련의 오답을 읽는 셈 — 단어표 채점과 같은 결. */