@ihabdevteam/core 0.321.0 → 0.323.0

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

@@ -12,7 +12,7 @@ import Popup from '../Popup/Popup';
 import WordTable, { WORD_TABLE_PAPER } from '../WordTable';
 import { chunkItems } from '../wordTableLayout';
 import TableFilterPanel from './TableFilterPanel';
-import { buildItemsPerPageSection, buildPageNumberSection, PAGE_NUM_POSITION_VALUE, parsePageNumberPosition, itemsPerPageFromChoice } from './wordTableSettings';
+import { buildItemsPerPageSection, buildPageNumberSection, parsePageNumberPosition, itemsPerPageFromChoice } from './wordTableSettings';
 import Toast from '../Toast';
 import { useToastState } from '../../hooks/useToastState';
 import { getImageResolver, checkImageExists } from '../../utils/imageConfig';
@@ -24,24 +24,24 @@ import { CELL_COUNTS } from './wordTableBlockTypes';
 // ── 컴포넌트 ───────────────────────────────────────────────
 /** @public */
 /** 편집 칸의 낱말 → 저장 항목의 낱말. 편집 칸에서 보이던 구어체 발음·등급·품사·유형을 그대로 옮긴다. */
-function 항목낱말(e) {
+function toResultWord(e) {
     return {
         label: e.word, subLabel: e.pronunciation, colloquialLabel: e.colloquialPronunciation, homonum: e.homonum,
         grade: e.grade, syllables: [...e.word].length, pos: e.pos, wordType: e.wordType,
     };
 }
 /** 동음이의어 번호까지 넣은 낱말들로 만든 id — 첫 낱말만 쓰면 '배'(1)·'배'(2), '가다|나다'·'가다|다다' 가 같은 id 였다 */
-function 항목id(entries) {
+function itemId(entries) {
     return entries.map(e => (e.homonum != null ? `${e.word}#${e.homonum}` : e.word)).join('|');
 }
 /** 표 안에서 같은 낱말을 두 칸에 넣었을 때도 id 가 겹치지 않게 뒤에 ~2, ~3 을 붙인다 */
-function 겹치지않는id(list) {
-    const 쓴 = new Set();
+function withUniqueIds(list) {
+    const used = new Set();
     return list.map(it => {
         let id = it.id;
-        for (let n = 2; 쓴.has(id); n++)
+        for (let n = 2; used.has(id); n++)
             id = `${it.id}~${n}`;
-        쓴.add(id);
+        used.add(id);
         return id === it.id ? it : { ...it, id };
     });
 }
@@ -78,14 +78,14 @@ export default function WordTableBlock({ title, titleIcon, disc, filterTitle, fi
     const visibleCells = cells.slice(0, cellCount);
     /* 띠를 켠 표면 설정 판에 '상단 정보'·'하단 정보' 고르개가 선다 — 스위치를 따로 두지
        않는다(부르는 쪽이 둘을 어긋나게 줄 일이 없게). 고른 값은 `brand.top`·`bottom` 을 덮는다. */
-    const 띠쓰나 = Boolean(brand?.show);
+    const showBand = Boolean(brand?.show);
     const [showTopInfo, setShowTopInfo] = useState(true);
     const [showBottomInfo, setShowBottomInfo] = useState(true);
-    const 띠 = brand && { ...brand, top: showTopInfo, bottom: showBottomInfo };
+    const band = brand && { ...brand, top: showTopInfo, bottom: showBottomInfo };
     // 공통 단어 표 설정 상태
     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 [showDivLine, setShowDivLine] = useState(true);
     // 인쇄 캡처용 그리드 콘텐츠 ref (단일 페이지)
@@ -209,7 +209,7 @@ export default function WordTableBlock({ title, titleIcon, disc, filterTitle, fi
     const middleSelected = {
         ...((isEditable || showCellCount) ? { [t('wordTable.filter.columns', '칸 수')]: `${count}칸` } : {}),
         ...(pagesEnabled && (items?.length ?? 0) > 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 handleMiddleSelect = (value, sectionLabel) => {
         if (sectionLabel === t('wordTable.filter.columns', '칸 수')) {
@@ -229,14 +229,14 @@ export default function WordTableBlock({ title, titleIcon, disc, filterTitle, fi
     };
     // 저장 팝업용 현재 items / preview
     const saveItems = isEditable
-        ? 겹치지않는id(visibleCells.filter((c) => c !== null && c.length > 0).map(c => ({
-            id: 항목id(c),
-            words: c.map(항목낱말),
+        ? withUniqueIds(visibleCells.filter((c) => c !== null && c.length > 0).map(c => ({
+            id: itemId(c),
+            words: c.map(toResultWord),
         })))
         : items ?? [];
     /* 저장한 뒤에는 **숨은 칸(cellCount 뒤)을 비운다** — 2칸으로 줄여 저장한 표를 4칸으로 늘리면 저장본에 없던
        셋째·넷째 낱말이 다시 떠, 저장한 것과 화면이 달랐다. 저장하지 않고 줄였다 늘리는 동안에는 그대로 들고 있는다. */
-    const 숨은칸비우기 = () => {
+    const clearHiddenCells = () => {
         if (isEditable)
             setCells(prev => (prev.length > cellCount ? prev.slice(0, cellCount) : prev));
     };
@@ -250,13 +250,13 @@ export default function WordTableBlock({ title, titleIcon, disc, filterTitle, fi
             if (savedLower)
                 setSavedNames(prev => prev.includes(savedLower) ? prev : [...prev, savedLower]);
             onSaveComplete(trimmedName, saveItems, trimmedDescription || undefined, asNew);
-            숨은칸비우기();
+            clearHiddenCells();
             return;
         }
         // saveOnly: 이름 입력 팝업 없이 바로 저장(이름은 상위에서 처리)
         if (saveOnly && onSaveComplete) {
             onSaveComplete('', saveItems, undefined, asNew);
-            숨은칸비우기();
+            clearHiddenCells();
             return;
         }
         if (onSaveComplete) {
@@ -279,7 +279,7 @@ export default function WordTableBlock({ title, titleIcon, disc, filterTitle, fi
         if (!saveAsTrimmed || saveAsCollides || !onSaveComplete)
             return;
         onSaveComplete(saveAsTrimmed, saveItems, trimmedDescription || undefined, true);
-        숨은칸비우기();
+        clearHiddenCells();
         setShowSaveAsPopup(false);
     };
     // 저장 버튼 활성 조건 — 인라인 모드에선 이름 필수·중복(others) 불가. 항목이 비어도 불가.
@@ -307,7 +307,7 @@ export default function WordTableBlock({ title, titleIcon, disc, filterTitle, fi
                         items: saveItems,
                         existingNames: getSavedTables().map(tb => tb.name),
                         saveAsNew,
-                        onSave: (name, description) => { onSaveComplete(name, saveItems, description, saveAsNew); 숨은칸비우기(); setShowSavePopup(false); },
+                        onSave: (name, description) => { onSaveComplete(name, saveItems, description, saveAsNew); clearHiddenCells(); setShowSavePopup(false); },
                         onCancel: () => setShowSavePopup(false),
                     }), (isEditable || onAddItem) && activeCell !== null && renderWordSearch?.({
                         cellIndex: activeCell,
@@ -316,25 +316,25 @@ export default function WordTableBlock({ title, titleIcon, disc, filterTitle, fi
                                 const entry = entries[0];
                                 if (entry) {
                                     // 이미 있는 항목과 id 가 겹치면(같은 낱말의 다른 동음이의어·같은 낱말) onRemoveItem(id) 가 둘을 함께 지운다
-                                    const 쓴id = new Set((items ?? []).map(it => it.id));
-                                    let id = 항목id([entry]);
-                                    for (let n = 2; 쓴id.has(id); n++)
-                                        id = `${항목id([entry])}~${n}`;
-                                    onAddItem({ id, words: [항목낱말(entry)] });
+                                    const usedIds = new Set((items ?? []).map(it => it.id));
+                                    let id = itemId([entry]);
+                                    for (let n = 2; usedIds.has(id); n++)
+                                        id = `${itemId([entry])}~${n}`;
+                                    onAddItem({ id, words: [toResultWord(entry)] });
                                 }
                             }
                             setActiveCell(null);
                         },
                         onClose: handleCloseWordSearch,
-                    }), !hideControls && (_jsx(TableFilterPanel, { title: filterTitle, collapsible: filterCollapsible, defaultCollapsed: filterDefaultCollapsed, collapsed: filterCollapsed, onCollapsedChange: onFilterCollapsedChange, headerSummary: filterHeaderSummary, hasImage: hasImage, hasColloquial: hasColloquial, contentTypes: contentTypes, orientation: orientation, showOutline: showOutline, cutLine: cutLine, showDivLine: showDivLine, setters: { setContentTypes, setOrientation, setShowOutline, setCutLine, setShowDivLine, setShowTopInfo, setShowBottomInfo }, showCutLine: (pagesEnabled ? itemsPerPage : count) > 1, showDivLine2: hasPairs, middleSections: middleSections, extraSelected: middleSelected, onExtraSelect: handleMiddleSelect, showPaperBands: 띠쓰나, showTopInfo: showTopInfo, showBottomInfo: showBottomInfo })), isPaginated && pages ? (_jsx("div", { className: "word-table-block__pages", children: pages.map((page, i) => (_jsx(WordTable, { orientation: orientation, contentTypes: contentTypes, cutLine: cutLine, showOutline: showOutline, showDivLine: showDivLine, count: itemsPerPage, items: page, onRemoveItem: onRemoveItem, 
+                    }), !hideControls && (_jsx(TableFilterPanel, { title: filterTitle, collapsible: filterCollapsible, defaultCollapsed: filterDefaultCollapsed, collapsed: filterCollapsed, onCollapsedChange: onFilterCollapsedChange, headerSummary: filterHeaderSummary, hasImage: hasImage, hasColloquial: hasColloquial, contentTypes: contentTypes, orientation: orientation, showOutline: showOutline, cutLine: cutLine, showDivLine: showDivLine, setters: { setContentTypes, setOrientation, setShowOutline, setCutLine, setShowDivLine, setShowTopInfo, setShowBottomInfo }, showCutLine: (pagesEnabled ? itemsPerPage : count) > 1, showDivLine2: hasPairs, middleSections: middleSections, extraSelected: middleSelected, onExtraSelect: handleMiddleSelect, showPaperBands: showBand, showTopInfo: showTopInfo, showBottomInfo: showBottomInfo })), isPaginated && pages ? (_jsx("div", { className: "word-table-block__pages", children: pages.map((page, i) => (_jsx(WordTable, { orientation: orientation, contentTypes: contentTypes, cutLine: cutLine, showOutline: showOutline, showDivLine: showDivLine, count: itemsPerPage, items: page, onRemoveItem: onRemoveItem, 
                             /* 쪽이 나뉘면 끌어 옮기기가 통째로 꺼졌다(말귀 단어 찾기: 9개부터). 쪽 안의 자리를 전체 자리로 옮겨 넘긴다 —
                                쪽을 넘는 이동은 하지 않는다. */
                             onReorder: onReorder && ((from, to) => onReorder(from + i * itemsPerPage, to + i * itemsPerPage)), 
                             /* 안쪽 표는 제 쪽 안의 번호를 준다 — 부르는 쪽에는 **표 전체 기준**으로 넘긴다
                                (위 `onReorder` 와 같은 셈이다. 쪽이 몇으로 나뉘었는지는 부르는 쪽 일이 아니다). */
-                            renderCellAction: renderCellAction && ((n, item) => renderCellAction(n + i * itemsPerPage, item)), brand: 띠, code: code, contentRef: el => { pageRefs.current[i] = el; }, pageNumber: { current: i + 1, total: pages.length }, pageNumberPosition: pageNumberPosition }, i))) })) : (_jsx(WordTable, { orientation: orientation, contentTypes: contentTypes, cutLine: cutLine, showOutline: showOutline, showDivLine: showDivLine, count: count, items: isEditable ? undefined : (items ?? []), editCells: isEditable ? visibleCells : undefined, activeCell: activeCell, onActivateCell: (isEditable || onAddItem) ? setActiveCell : undefined, onRemoveCell: isEditable ? handleRemove : undefined, onRemoveItem: !isEditable ? onRemoveItem : undefined, onReorder: !isEditable ? onReorder : undefined, 
+                            renderCellAction: renderCellAction && ((n, item) => renderCellAction(n + i * itemsPerPage, item)), brand: band, code: code, contentRef: el => { pageRefs.current[i] = el; }, pageNumber: { current: i + 1, total: pages.length }, pageNumberPosition: pageNumberPosition }, i))) })) : (_jsx(WordTable, { orientation: orientation, contentTypes: contentTypes, cutLine: cutLine, showOutline: showOutline, showDivLine: showDivLine, count: count, items: isEditable ? undefined : (items ?? []), editCells: isEditable ? visibleCells : undefined, activeCell: activeCell, onActivateCell: (isEditable || onAddItem) ? setActiveCell : undefined, onRemoveCell: isEditable ? handleRemove : undefined, onRemoveItem: !isEditable ? onRemoveItem : undefined, onReorder: !isEditable ? onReorder : undefined, 
                         /* 편집 모드에는 얹을 항목이 없다 — 칸을 손으로 채우는 꼴이다 */
-                        renderCellAction: !isEditable ? renderCellAction : undefined, brand: 띠, code: code, showFillerAdd: !!onAddItem, contentRef: contentRef })), !hideControls && !saveOnly && (onReset || actionsLeftExtra != null) && (_jsxs("div", { className: "word-table-block__table-actions", children: [onReset && (_jsx(Button, { htmlType: "button", size: 48, type: "bar", label: resolvedResetLabel, onClick: onReset })), actionsLeftExtra] })), inlineNameFields && !hideControls && (_jsxs(Panel, { size: "medium", labelWidth: 64, useBorder: false, useRowBorder: false, className: "word-table-block__meta", children: [_jsx(PanelRow, { variant: "custom", label: t('wordTable.save.nameLabel', '이름'), required: true, align: "vertical", useFullWidth: true, children: _jsx(TextField, { required: true, value: nameValue ?? '', onChange: onNameChange, placeholder: namePlaceholder ? namePlaceholder + t('wordTable.save.autoFillHint', ' (Tab 또는 space 입력시 자동 입력)') : t('wordTable.save.placeholder', '이 단어표에 대한 제목을 입력하세요.'), 
+                        renderCellAction: !isEditable ? renderCellAction : undefined, brand: band, code: code, showFillerAdd: !!onAddItem, contentRef: contentRef })), !hideControls && !saveOnly && (onReset || actionsLeftExtra != null) && (_jsxs("div", { className: "word-table-block__table-actions", children: [onReset && (_jsx(Button, { htmlType: "button", size: 48, type: "bar", label: resolvedResetLabel, onClick: onReset })), actionsLeftExtra] })), inlineNameFields && !hideControls && (_jsxs(Panel, { size: "medium", labelWidth: 64, useBorder: false, useRowBorder: false, className: "word-table-block__meta", children: [_jsx(PanelRow, { variant: "custom", label: t('wordTable.save.nameLabel', '이름'), required: true, align: "vertical", useFullWidth: true, children: _jsx(TextField, { required: true, value: nameValue ?? '', onChange: onNameChange, placeholder: namePlaceholder ? namePlaceholder + t('wordTable.save.autoFillHint', ' (Tab 또는 space 입력시 자동 입력)') : t('wordTable.save.placeholder', '이 단어표에 대한 제목을 입력하세요.'), 
                                     /* PanelRow의 라벨은 시각적으로만 붙어 있고 입력과 연결돼 있지 않아, 낭독기에는
                                        이름 없는 입력으로 읽혔다. placeholder는 자동완성 안내문("Tab 또는 space…")이
                                        섞여 있어 이름으로 부적절하므로 같은 라벨 문구를 넘긴다. */

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 { 한글순 } from '../../utils/textSort';
+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,15 +38,15 @@ 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 || 한글순(a.label, b.label) || 한글순(a.key ?? a.label, b.key ?? b.label));
+    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

@@ -7,7 +7,7 @@
  *
  * 화면도 통신도 없다. 표 목록과 약한 낱말만 받아 순서를 매긴다.
  */
-import { 한글순 } from '../../utils/textSort';
+import { compareKorean } from '../../utils/textSort';
 /**
  * 약한 낱말을 많이 품은 표부터 내놓는다.
  *
@@ -23,18 +23,18 @@ import { 한글순 } 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);
             }
         }
@@ -44,7 +44,7 @@ export function recommendTables(tables, weakLabels, limit = 5) {
     }
     out.sort((a, b) => b.covered.length - a.covered.length
         || a.totalCells - b.totalCells
-        || 한글순(a.name, b.name));
+        || compareKorean(a.name, b.name));
     return out.slice(0, Math.max(0, limit));
 }
 /**
@@ -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);
     }