@ihabdevteam/core 0.322.0 → 0.324.0

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

@@ -2,7 +2,11 @@
 .word-table-button {
   position: relative;
   box-sizing: border-box;
-  width: 240px;
+  /* 280 — 대립쌍표는 한 칸에 낱말이 둘('가게 / 마개') 들어가 240 에서는 글자가 칸에 꽉 찼다.
+     320 도 보았으나 한 줄에 드는 카드 수가 줄어 280 으로 정했다(사장님 지시 2026-10-13).
+     **이 카드를 쓰는 세 화면이 함께 바뀐다** — 같은 카드가 화면마다 다른 폭이면 그 까닭을
+     나중에 아무도 설명하지 못한다. 자리의 사정이 아니라 카드 자체의 값이다. */
+  width: 280px;
   display: flex;
   flex-direction: column;
   border: 1px solid var(--color-whiteLine);
@@ -98,7 +102,17 @@
 }
 /* 설명 — 제목 아래, 2줄까지 표시 후 말줄임 (폰트는 body-3 토큰 그대로) */
 .word-table-button__desc {
-  color: var(--color-gray);
+  /* **곁들이는 줄이라 가장 흐리다**(사장님 지시 2026-10-13, 말귀_2 청).
+     제목(#111)과 `--color-gray`(#64748b)가 충분히 안 갈려 **제목과 설명이 한 덩어리로
+     읽혔다.** 한 급 내려 제목이 먼저 잡히게 한다.
+
+     > **흰 바탕 2.53:1 로 본문 기준(4.5)에 못 미치는 것을 알고 그렇게 둔다.** 무엇인지는
+     > 제목과 썸네일이 이미 말해 주고, 이 줄은 곁들이는 설명이다. 사장님이 손잡이
+     > (`descTone`)와 기본값을 나란히 놓고 그 수를 보신 뒤 **기본값**으로 정하셨다.
+
+     이 자리를 옮기거나 본문으로 승격할 일이 생기면 **대비를 먼저 다시 본다** —
+     `--color-gray`(4.8:1)가 그때의 기본이다. 코어에는 대비를 세는 못이 없어 사람이 본다. */
+  color: var(--color-lightGray);
   display: -webkit-box;
   -webkit-line-clamp: 2;
   -webkit-box-orient: vertical;

package/dist/packages/core/src/components/Word/WordTableThumbnail.css

@@ -31,7 +31,12 @@
 }
 
 .word-table-thumb__word {
-  color: var(--color-black);
+  /* **제목보다 한 급 흐리다**(사장님 지시 2026-10-13, 말귀_2 청).
+     전에는 제목과 **둘 다 `--color-black`(#111)** 이어서 같은 무게로 서고, 눈이 어디부터
+     가야 할지 안 정해졌다. 썸네일은 **무슨 표인지 알아보는 그림**이지 읽는 글이 아니다.
+     카드 안의 읽는 차례를 세 겹으로 둔다 — 제목 #111 · 썸네일 #434d56 · 설명 #96a4b8.
+     흰 바탕 대비 약 9.1:1 로 넉넉하다. */
+  color: var(--color-darkGray);
 }
 
 /* 줄간격을 좁힌다. **선택자를 한 단계 겹쳐 쓴 이유가 있다** — 쓰는 쪽이 `body-3` 을

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

@@ -10,14 +10,14 @@
 /** 값들을 초안으로 만든다(처음엔 아무것도 고정돼 있지 않다). */
 export function toDraft(values, keyOf) {
     const out = [];
-    const 본것 = new Set();
+    const seen = new Set();
     for (const v of values) {
         const key = keyOf(v);
         /* 같은 열쇠가 두 번 오면 한 번만 담는다 — 초안에 같은 줄이 둘이면 고정·빼기가
            어느 것에 걸린 것인지 사람이 알 수 없다. */
-        if (본것.has(key))
+        if (seen.has(key))
             continue;
-        본것.add(key);
+        seen.add(key);
         out.push({ key, value: v, pinned: false });
     }
     return out;
@@ -44,24 +44,24 @@ export function removeItem(draft, key) {
  * 돌연변이로 확인했다: 그 줄을 없애도 결과가 같다.
  */
 export function regenerateUnpinned(draft, candidates, keyOf) {
-    const 고정 = draft.filter(d => d.pinned);
-    const 고정열쇠 = new Set(고정.map(d => d.key));
-    const 자리 = draft.length - 고정.length;
-    const 새것 = [];
-    const 본것 = new Set(고정열쇠);
+    const pinned = draft.filter(d => d.pinned);
+    const pinnedKeys = new Set(pinned.map(d => d.key));
+    const slots = draft.length - pinned.length;
+    const fresh = [];
+    const seen = new Set(pinnedKeys);
     for (const v of candidates) {
-        if (새것.length >= 자리)
+        if (fresh.length >= slots)
             break; // 정확성이 아니라 효율 — 위 주석 참고
         const key = keyOf(v);
-        if (본것.has(key))
+        if (seen.has(key))
             continue;
-        본것.add(key);
-        새것.push({ key, value: v, pinned: false });
+        seen.add(key);
+        fresh.push({ key, value: v, pinned: false });
     }
     /* **고정한 것의 자리를 지킨다.** 앞으로 몰아 두면, 다시 뽑을 때마다 사람이 보던 줄이
        위아래로 움직여 어디를 보고 있었는지 놓친다. */
-    const 새것들 = [...새것];
-    return draft.map(d => (d.pinned ? d : 새것들.shift())).filter((d) => d !== undefined);
+    const freshList = [...fresh];
+    return draft.map(d => (d.pinned ? d : freshList.shift())).filter((d) => d !== undefined);
 }
 /** 저장할 값들 — 화면에 보이는 차례 그대로. */
 export function draftValues(draft) {

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

@@ -3,7 +3,7 @@ import { useMemo, useState, useCallback, useEffect } from 'react';
 import { useTranslation } from 'react-i18next';
 import { chunkItems } from '../wordTableLayout';
 import { getImageResolver, checkImageExists } from '../../utils/imageConfig';
-import { buildCompositionSection, buildOrientationSection, buildBorderSection, buildCutLineSection, buildDivLineSection, buildTopInfoSection, buildBottomInfoSection, buildItemsPerPageSection, buildTableSettingsSelected, applyTableSettingsSelect, PAGE_NUM_POSITION_VALUE, parsePageNumberPosition, itemsPerPageFromChoice, } from './wordTableSettings';
+import { buildCompositionSection, buildOrientationSection, buildBorderSection, buildCutLineSection, buildDivLineSection, buildTopInfoSection, buildBottomInfoSection, buildItemsPerPageSection, buildTableSettingsSelected, applyTableSettingsSelect, parsePageNumberPosition, itemsPerPageFromChoice, } from './wordTableSettings';
 /**
  * 표시 전용 단어표(편집 없음)의 '표 설정' FilterPanel 상태·섹션을 제공하는 훅.
  * 구성·용지 방향·외곽선, 내용이 있으면 페이지당 개수, 2페이지 이상이면 페이지 번호, 항목이 2개 이상이면
@@ -16,10 +16,10 @@ export function useWordTableDisplaySettings(items,
  *  안 쓰는 화면에 켜고 끌 것이 없는 절이 서면 안 되므로 기본은 거짓이다. */
 opts) {
     const { t } = useTranslation();
-    const 띠쓰나 = opts?.paperBands === true;
+    const showBands = opts?.paperBands === true;
     const [orientation, setOrientation] = useState('landscape');
-    const [contentTypes, setContentTypes] = useState(['이미지', '단어', '표준 발음']);
-    const [cutLine, setCutLine] = useState('표시');
+    const [contentTypes, setContentTypes] = useState(['image', 'word', 'standardPron']);
+    const [cutLine, setCutLine] = useState('show');
     const [showOutline, setShowOutline] = useState(true);
     /* 종이 머리·바닥 띠 — 기본은 켬(브랜드가 찍힌 종이가 기본값이다) */
     const [showTopInfo, setShowTopInfo] = useState(true);
@@ -72,12 +72,12 @@ opts) {
         ...(count > 1 ? [buildCutLineSection(t)] : []),
         ...(hasPairs ? [buildDivLineSection(t)] : []),
         /* 띠를 쓰는 화면에서만 — 안 쓰는 표에 켜고 끌 것이 없는 절이 서면 안 된다 */
-        ...(띠쓰나 ? [buildTopInfoSection(t), buildBottomInfoSection(t)] : []),
-    ], [t, hasImage, hasColloquial, itemCount, hasPairs, isPaginated, count, 띠쓰나]);
+        ...(showBands ? [buildTopInfoSection(t), buildBottomInfoSection(t)] : []),
+    ], [t, hasImage, hasColloquial, itemCount, hasPairs, isPaginated, count, showBands]);
     const filterSelected = {
         ...buildTableSettingsSelected(t, { contentTypes, orientation, showOutline, cutLine, showDivLine, showTopInfo, showBottomInfo }),
         ...(itemCount > 0 ? { [t(hasPairs ? 'wordTable.filter.itemsPerPagePair' : 'wordTable.filter.itemsPerPageWord')]: `${effectiveItemsPerPage}개` } : {}),
-        ...(isPaginated ? { [t('wordTable.filter.pageNumber', '페이지 번호')]: PAGE_NUM_POSITION_VALUE[pageNumberPosition] } : {}),
+        ...(isPaginated ? { [t('wordTable.filter.pageNumber', '페이지 번호')]: pageNumberPosition } : {}),
     };
     const handleSelect = useCallback((value, sectionLabel) => {
         // 기본 5개 설정은 공용 헬퍼가 처리 — 처리했으면 종료. 나머지(페이지당 개수·페이지 번호)만 여기서.

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

@@ -1,7 +1,7 @@
 import { compareKorean } from '../../utils/textSort';
 import { labelOfCellKey } from './wordTableReview';
 /** △ 를 반 점으로 치는 셈 — 저장할 때 서버가 쓰는 규칙과 같다. */
-function 점수(o, triangle, marked) {
+function scoreOf(o, triangle, marked) {
     return marked === 0 ? 0 : (o + triangle * 0.5) / marked;
 }
 /**
@@ -18,16 +18,16 @@ function 점수(o, triangle, marked) {
  * 지금처럼 글자로 묶는다 — 그래서 같은 '배' 가 옛 기록 한 줄·번호 있는 기록 한 줄로 나뉘어 보일 수 있다.
  */
 export function weakItems(records) {
-    const 모음 = new Map();
+    const byKey = new Map();
     /* 최근 것을 알려면 시간순으로 훑어야 한다. 서버는 최신순으로 주지만 여기서 다시
        정렬한다 — 부르는 쪽의 차례에 기대면 그쪽이 바뀔 때 조용히 어긋난다. */
-    const 시간순 = [...records].sort((a, b) => a.scoredAt.localeCompare(b.scoredAt));
-    for (const r of 시간순) {
+    const byTime = [...records].sort((a, b) => a.scoredAt.localeCompare(b.scoredAt));
+    for (const r of byTime) {
         for (const [cell, mark] of Object.entries(r.marks)) {
             const label = r.labels?.[cell];
             if (!label)
                 continue;
-            const cur = 모음.get(label) ?? { o: 0, triangle: 0, x: 0, latest: mark, latestAt: r.scoredAt };
+            const cur = byKey.get(label) ?? { o: 0, triangle: 0, x: 0, latest: mark, latestAt: r.scoredAt };
             if (mark === 'o')
                 cur.o++;
             else if (mark === 'triangle')
@@ -38,13 +38,13 @@ export function weakItems(records) {
                 continue;
             cur.latest = mark;
             cur.latestAt = r.scoredAt;
-            모음.set(label, cur);
+            byKey.set(label, cur);
         }
     }
     const out = [];
-    for (const [key, v] of 모음) {
+    for (const [key, v] of byKey) {
         const tried = v.o + v.triangle + v.x;
-        out.push({ label: labelOfCellKey(key), key, tried, o: v.o, triangle: v.triangle, x: v.x, rate: 점수(v.o, v.triangle, tried), latest: v.latest, latestAt: v.latestAt });
+        out.push({ label: labelOfCellKey(key), key, tried, o: v.o, triangle: v.triangle, x: v.x, rate: scoreOf(v.o, v.triangle, tried), latest: v.latest, latestAt: v.latestAt });
     }
     out.sort((a, b) => a.rate - b.rate || b.tried - a.tried || compareKorean(a.label, b.label) || compareKorean(a.key ?? a.label, b.key ?? b.label));
     return out;
@@ -56,27 +56,27 @@ export function weakItems(records) {
  * 0으로 두면 "제자리걸음"으로 읽혀, 아직 재 본 적 없는 것이 나쁜 소식처럼 보인다.
  */
 export function tableTrends(records) {
-    const 모음 = new Map();
+    const byKey = new Map();
     for (const r of records) {
         /* 표를 지워도 이름으로는 이어 볼 수 있어야 한다 — id 가 없으면 이름을 열쇠로 쓴다. */
         const key = r.tableId ?? `name:${r.tableName}`;
-        const cur = 모음.get(key) ?? { tableName: r.tableName, tableId: r.tableId, rows: [] };
+        const cur = byKey.get(key) ?? { tableName: r.tableName, tableId: r.tableId, rows: [] };
         cur.rows.push(r);
-        모음.set(key, cur);
+        byKey.set(key, cur);
     }
     const out = [];
-    for (const v of 모음.values()) {
+    for (const v of byKey.values()) {
         /* 매긴 칸이 하나도 없는 기록은 흐름에서 뺀다 — 정답률 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));
+        const markedCount = (r) => Object.values(r.marks).filter(m => m === 'o' || m === 'triangle' || m === 'x').length;
+        const rows = v.rows.filter(r => markedCount(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, 매긴수(r));
+            return scoreOf(o, tri, markedCount(r));
         });
         out.push({
             tableName: v.tableName,

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

@@ -18,10 +18,10 @@ export function sanitizeFileName(name) {
     return name.replace(/[\\/:*?"<>|]/g, '_').trim();
 }
 /** 아직 되돌리지 못한 탭 제목 되돌리기(인쇄가 끝나기 전 다음 인쇄가 올 때) */
-let 제목되돌리기 = null;
+let restoreTitle = null;
 /* 진행 중인 인쇄 — 그림을 기다리는(최대 3초) 사이 다시 누르면 숨김 iframe 이 둘 생겨 인쇄 대화상자가 두 번 떴다(autoPrint 대기 중 '인쇄').
    afterprint 가 안 오는 브라우저에서 영영 막히지 않게 10초가 지나면 새 인쇄를 받는다. */
-let 인쇄중 = null;
+let printing = null;
 /**
  * 캡처한 콘텐츠 엘리먼트들을 화면 밖 숨김 iframe에서 인쇄한다. 전역 @media print(모든
  * .word-table 노출)나 팝업 차단의 간섭 없이 넘긴 엘리먼트만 격리 인쇄한다. WordTableBlock의
@@ -31,14 +31,14 @@ let 인쇄중 = null;
 export function printWordTableElements(elements, paperW, paperH, fileName = '', header = '') {
     if (elements.length === 0)
         return;
-    if (인쇄중 && 인쇄중.iframe.isConnected && Date.now() - 인쇄중.at < 10_000)
+    if (printing && printing.iframe.isConnected && Date.now() - printing.at < 10_000)
         return;
     const safeFileName = fileName ? sanitizeFileName(fileName) : '';
     // "PDF로 저장" 기본 파일명은 iframe이 아니라 최상위 탭(document)의 title에서 온다.
     /* 탭 제목은 **어느 쪽 afterprint 가 와도** 되돌린다 — 브라우저에 따라 iframe 인쇄의 print 이벤트가 그 프레임에만 가서,
        최상위에만 걸면 제목이 표 이름으로 남았고, 다음 인쇄가 그 표 이름을 '원래 제목' 으로 잡아 영영 안 돌아왔다.
        되돌리지 못한 앞 인쇄가 있으면 먼저 되돌린 뒤 원래 제목을 잡는다. */
-    제목되돌리기?.();
+    restoreTitle?.();
     let restore = null;
     if (safeFileName) {
         const prevTitle = document.title;
@@ -46,10 +46,10 @@ export function printWordTableElements(elements, paperW, paperH, fileName = '',
         restore = () => {
             document.title = prevTitle;
             window.removeEventListener('afterprint', restore);
-            if (제목되돌리기 === restore)
-                제목되돌리기 = null;
+            if (restoreTitle === restore)
+                restoreTitle = null;
         };
-        제목되돌리기 = restore;
+        restoreTitle = restore;
         window.addEventListener('afterprint', restore);
     }
     const iframe = document.createElement('iframe');
@@ -60,14 +60,14 @@ export function printWordTableElements(elements, paperW, paperH, fileName = '',
         iframe.remove();
         return;
     }
-    인쇄중 = { iframe, at: Date.now() };
+    printing = { iframe, at: Date.now() };
     doc.open();
     doc.write(captureHtml(elements, paperW, paperH, true, safeFileName, header));
     doc.close();
     iframe.contentWindow?.addEventListener('afterprint', () => {
         restore?.();
-        setTimeout(() => { iframe.remove(); if (인쇄중?.iframe === iframe)
-            인쇄중 = null; }, 0);
+        setTimeout(() => { iframe.remove(); if (printing?.iframe === iframe)
+            printing = null; }, 0);
     });
 }
 // 인쇄 시 PDF로 저장할 때 OS가 제안하는 기본 파일명은 문서 <title>에서 온다.

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

@@ -23,18 +23,18 @@ import { compareKorean } from '../../utils/textSort';
  */
 export function recommendTables(tables, weakLabels, limit = 5) {
     /* 약한 낱말을 Set 으로 — 표가 수십 개면 칸마다 배열을 훑는 비용이 쌓인다. */
-    const 약한것 = new Set(weakLabels);
-    if (약한것.size === 0)
+    const weakSet = new Set(weakLabels);
+    if (weakSet.size === 0)
         return [];
     const out = [];
     for (const t of tables) {
         /* **한 표 안에서 같은 낱말이 두 번 나와도 한 번으로 센다** — 대립쌍표에는 같은 쌍이
            거듭 나오는 일이 있고, 그걸 두 번 세면 실속 없는 표가 위로 올라온다. */
-        const 품은것 = new Set();
+        const coveredSet = new Set();
         const covered = [];
         for (const label of t.cellLabels) {
-            if (약한것.has(label) && !품은것.has(label)) {
-                품은것.add(label);
+            if (weakSet.has(label) && !coveredSet.has(label)) {
+                coveredSet.add(label);
                 covered.push(label);
             }
         }
@@ -57,8 +57,8 @@ export function recommendTables(tables, weakLabels, limit = 5) {
  * 고를 때 또 헷갈린다.
  */
 export function uncoveredLabels(recommendations, weakLabels) {
-    const 덮인것 = new Set(recommendations.flatMap(r => r.covered));
-    return weakLabels.filter(l => !덮인것.has(l));
+    const alreadyCovered = new Set(recommendations.flatMap(r => r.covered));
+    return weakLabels.filter(l => !alreadyCovered.has(l));
 }
 /**
  * 새 표에 담을 **칸**을 가진 표들에서 찾아온다.
@@ -74,17 +74,17 @@ export function uncoveredLabels(recommendations, weakLabels) {
  * 표를 훑은 차례로 담으면 그 순서가 흐트러진다.
  */
 export function cellsForLabels(tables, labels) {
-    const 찾은것 = new Map();
+    const found = new Map();
     for (const t of tables) {
         for (const cell of t.cells) {
             const label = t.labelOf(cell);
-            if (!찾은것.has(label))
-                찾은것.set(label, cell);
+            if (!found.has(label))
+                found.set(label, cell);
         }
     }
     const out = [];
     for (const label of labels) {
-        const cell = 찾은것.get(label);
+        const cell = found.get(label);
         if (cell !== undefined)
             out.push(cell);
     }

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

@@ -9,7 +9,7 @@ import { toKstYmd, formatYmd } from '../../utils/date';
  * 이 파일에는 화면도 저장도 없다. 무엇을 담을지만 안다.
  */
 /** 다음 표에 담을 표시 — 틀림과 애매. */
-const 담을것 = new Set(['x', 'triangle']);
+const COUNTED_MARKS = new Set(['x', 'triangle']);
 /**
  * 다음 표에 담을 칸들.
  *
@@ -28,29 +28,29 @@ export function reviewCells(items, marks) {
     const out = [];
     for (let i = 0; i < items.length; i++) {
         const m = marks[String(i)];
-        if (m && 담을것.has(m))
+        if (m && COUNTED_MARKS.has(m))
             out.push(items[i]);
     }
     return out;
 }
 /** 복습 꼬리 — `[N차 ]복습 MM.DD`. '복습' 뒤에 날짜가 따라와야만 꼬리로 본다("복습 자료" 같은 이름을 잘라 먹지 않게). */
-const 복습꼬리 = /\s*(?:(\d+)차\s*)?복습\s*\d{2}\.\d{2}$/;
+const REVIEW_SUFFIX = /\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 };
+function baseAndRound(src) {
+    const name = src.name.trim();
+    const metaRound = src.reviewRound;
+    if (typeof metaRound === 'number' && Number.isFinite(metaRound) && metaRound >= 0) {
+        const past = Math.floor(metaRound);
+        if (past === 0)
+            return { base: name, round: 1 };
         /* 메타가 말하는 **그 회차의 꼬리 하나만** 뗀다 — `수업 3차 복습 09.15`(1회) 에서 `3차` 를 회차로 먹지 않는다.
            N차는 앞이 공백·처음일 때만 — `수업 13차 복습`(3회) 의 `3차` 를 떼지 않게. 사람이 이름을 고쳐 꼬리가 없으면
            이름을 통째로 바탕으로 둔다. */
-        const 그꼬리 = 지난 === 1
+        const suffix = past === 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 };
+            : new RegExp(`(?:^|\\s)${past}차\\s*복습\\s*\\d{2}\\.\\d{2}$`);
+        const m = suffix.exec(name);
+        return { base: m ? name.slice(0, m.index).trim() : name, round: past + 1 };
     }
     /* **메타 없는 옛 표 — 이름을 파싱한다.** 복습표를 또 복습하면 꼬리가 쌓인다. 그대로 두면
        `검수 대립쌍 복습 08.29 복습 08.30 복습 09.02` 처럼 자란다 — 복습을 거듭하는 것은
@@ -63,16 +63,16 @@ function 바탕과회차(src) {
   
        '복습' 은 뒤에 `MM.DD` 가 따라와야만 꼬리로 본다 — "복습 자료" 같은 사람이 지은
        이름을 잘라 먹지 않으려는 것이다. */
-    let 바탕 = 이름;
-    let 세대 = 1;
+    let base = name;
+    let generation = 1;
     for (;;) {
-        const m = 복습꼬리.exec(바탕);
+        const m = REVIEW_SUFFIX.exec(base);
         if (!m)
             break;
-        세대 = Math.max(세대, (m[1] ? Number(m[1]) : 1) + 1);
-        바탕 = 바탕.slice(0, m.index).trim();
+        generation = Math.max(generation, (m[1] ? Number(m[1]) : 1) + 1);
+        base = base.slice(0, m.index).trim();
     }
-    return { 바탕, 회차: 세대 };
+    return { base, round: generation };
 }
 /**
  * 복습표 이름.
@@ -89,11 +89,11 @@ export function reviewTableName(original, today) {
     /* 지역 날짜가 아니라 KST 로 읽는다 — 이 날짜는 **표 이름에 저장되고** 같은 이름끼리
        겹치는지 세는 데 쓰인다. 기기 시간대를 따르면 같은 날 만든 표가 다른 날짜를 달고
        남아 회차 세기가 어긋난다. */
-    const [, 월, 일] = toKstYmd(today).split('-');
-    const 날짜 = `${월}.${일}`;
-    const { 바탕, 회차: 세대 } = 바탕과회차(typeof original === 'string' ? { name: original } : original);
-    const 회차 = 세대 >= 2 ? `${세대}차 ` : '';
-    return `${바탕 || '단어표'} ${회차}복습 ${날짜}`;
+    const [, month, day] = toKstYmd(today).split('-');
+    const dateLabel = `${month}.${day}`;
+    const { base, round: generation } = baseAndRound(typeof original === 'string' ? { name: original } : original);
+    const round = generation >= 2 ? `${generation}차 ` : '';
+    return `${base || '단어표'} ${round}복습 ${dateLabel}`;
 }
 /**
  * 새로 만들 복습표에 **함께 저장할 메타** — 맨 처음 원본 표 id 와 이번이 몇 번째 복습인지.
@@ -106,7 +106,7 @@ export function reviewTableName(original, today) {
 export function reviewMeta(source) {
     return {
         reviewOf: source.reviewOf ?? source.id ?? undefined,
-        reviewRound: 바탕과회차(source).회차,
+        reviewRound: baseAndRound(source).round,
     };
 }
 /**
@@ -165,6 +165,6 @@ export function labelOfCellKey(key) {
  */
 export function scoreSheetHeader(customerName, tableName, today) {
     /* 인쇄물에 찍히는 날짜다 — 치료실의 그날(KST)이어야 한다. */
-    const 날짜 = formatYmd(today);
-    return [customerName.trim(), 날짜, tableName.trim()].filter(Boolean).join(' · ');
+    const dateLabel = formatYmd(today);
+    return [customerName.trim(), dateLabel, tableName.trim()].filter(Boolean).join(' · ');
 }

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

@@ -1,14 +1,6 @@
 import type { TFunction } from 'i18next';
 import { type FilterPanelSection } from '../FilterPanel';
 import type { WordTableOrientation, WordTableContentType, WordTableCutLine, PageNumberPosition } from '../WordTable';
-/**
- * '표 설정'(단어표 표시 옵션) 공용 섹션 빌더·선택상태·핸들러.
- * 표시 전용 훅(useWordTableDisplaySettings)과 편집/페이지분할까지 있는 WordTableBlock이 기본 5개 설정
- * (구성·용지 방향·외곽선·절취선·구분선)을 여기서 공용으로 조립한다. 각 소비처는 자신의 표시 조건
- * (절취선=칸>1, 구분선=대립쌍 등)에 따라 섹션 포함 여부만 결정하고, WordTableBlock은 칸 수·페이지당
- * 개수·페이지 번호 섹션을 그 사이에 끼워 넣는다.
- */
-/** @public 구성(이미지/단어/표준발음/구어체발음) 다중 토글 섹션. */
 export declare function buildCompositionSection(t: TFunction, opts: {
     hasImage: boolean;
     hasColloquial: boolean;
@@ -41,9 +33,14 @@ export declare function buildItemsPerPageSection(t: TFunction, opts: {
 export declare function itemsPerPageFromChoice(n: number, itemCount: number): number;
 /** @public 페이지 번호 위치(왼쪽/중앙/오른쪽/미표시) 세그먼트 섹션 — 실제 2페이지 이상일 때만 노출. */
 export declare function buildPageNumberSection(t: TFunction): FilterPanelSection;
-/** @public 페이지 번호 위치 → filterSelected 표시값. */
-export declare const PAGE_NUM_POSITION_VALUE: Record<PageNumberPosition, string>;
-/** @public FilterPanel 선택값 → 페이지 번호 위치. */
+/**
+ * @public FilterPanel 선택값 → 페이지 번호 위치.
+ *
+ * **섹션의 `value` 가 곧 코드다.** 전에는 `value` 가 한글(`'왼쪽'`)이라 여기서 되돌리는 표
+ * (`PAGE_NUM_POSITION_VALUE`)와 파서가 **둘 다** 필요했다 — 값을 코드로 돌리니 그 둘이
+ * 항등식이 되어 표를 걷었다(2026-10-13). *옮기는 표가 사라지는 것이 옳게 옮긴 표시다.*
+ * 모르는 값은 `'none'` 으로 떨어뜨린다(옛 한글 값이 어디선가 오더라도 번호를 안 찍는다).
+ */
 export declare function parsePageNumberPosition(value: string): PageNumberPosition;
 /** @public 기본 5개 설정의 filterSelected 엔트리(호출부가 자신의 추가 섹션과 spread). */
 export declare function buildTableSettingsSelected(t: TFunction, v: {