@ihabdevteam/core 0.201.0 → 0.203.0

package/dist/ihabdevteam-core.d.ts

@@ -1626,7 +1626,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.201.0";
+export declare const CORE_VERSION = "0.203.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -10324,9 +10324,9 @@ export declare interface WordSearchResultWord {
  * 표시(items)·편집(editCells) 두 모드를 지원한다.
  * @public
  */
-export declare function WordTable({ title, titleIcon, disc, className, orientation, contentTypes, cutLine, showOutline, showDivLine, items, editCells, count, activeCell, onActivateCell, onRemoveCell, onRemoveItem, onReorder, showFillerAdd, contentRef, buttonSize, pageNumber, pageNumberPosition, fitHeight, scoring, marks, onMarkClick, scoreIndexOffset, }: WordTableProps): JSX.Element;
+export declare function WordTable({ title, titleIcon, disc, className, orientation, contentTypes, cutLine, showOutline, showDivLine, items, editCells, count, activeCell, onActivateCell, onRemoveCell, onRemoveItem, onReorder, renderCellAction, showFillerAdd, contentRef, buttonSize, pageNumber, pageNumberPosition, fitHeight, scoring, marks, onMarkClick, scoreIndexOffset, }: WordTableProps): JSX.Element;
 
-export declare function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel }: WordTableBlockProps): JSX.Element;
+export declare function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel, initialItemsPerPage, renderCellAction }: WordTableBlockProps): JSX.Element;
 
 /** @public */
 export declare interface WordTableBlockProps {
@@ -10393,6 +10393,34 @@ export declare interface WordTableBlockProps {
     hideControls?: boolean;
     /** 액션 중 저장 버튼만 노출 (불러오기/새 창/인쇄 숨김) */
     saveOnly?: boolean;
+    /**
+     * **'페이지당 개수' 로 들어설 때 골라져 있을 값** — 안 주면 지금까지처럼 8,
+     * `'all'` 이면 한 쪽에 전부.
+     *
+     * 한 쪽에 다 담는 길은 이미 있었다(고르개 첫 칸이 늘 항목 수 그대로다). 막혀 있던 것은
+     * **처음 값**뿐이라, 열두 낱말짜리 표를 만들어 놓고도 늘 여덟씩 두 쪽으로 시작해 사람이
+     * 매번 `12개` 를 다시 눌러야 했다(말귀 간편 제작 — 요청 ㉑, 2026-09-27).
+     *
+     * **처음 값이지 매인 값이 아니다.** 들어설 때 한 번만 읽고, 그 뒤 사람이 고른 것을 덮지
+     * 않는다 — 밖에서 계속 밀어 넣으면 사람이 고른 쪽을 앱이 도로 바꿔 버린다. 그래서 나중에
+     * 이 값을 바꿔도 화면은 안 따라간다.
+     *
+     * **개수가 도중에 바뀌는 화면이면 `'all'` 을 준다.** 그러면 설정이 "전부" 로 남아 있어,
+     * 낱말이 8개든 12개든 그때그때 한 쪽으로 선다 — 수를 바꿀 때마다 다시 넣어 줄 필요가 없다.
+     * 숫자를 주면 그 숫자에 못 박히므로 도중에 늘어난 만큼은 다음 쪽으로 넘어간다.
+     */
+    initialItemsPerPage?: number | 'all';
+    /**
+     * **칸 오른쪽 위에 부르는 쪽이 얹는 것** — 안쪽 `WordTable` 의 같은 이름 프롭으로 그대로 간다.
+     * 자리·드러나는 때·인쇄에서 치우는 규칙은 그쪽 글에 있다.
+     *
+     * **칸 번호는 표 전체 기준이다.** 쪽이 나뉘면 안쪽 표는 제 쪽 안의 번호(0부터)를 주는데,
+     * 여기서 쪽 몫을 더해 넘긴다 — 부르는 쪽은 쪽이 몇으로 나뉘었는지 몰라도 된다
+     * (`onReorder` 가 쓰는 셈과 같다).
+     *
+     * **표시 모드에만 간다** — 편집 모드(칸을 손으로 채우는 꼴)에는 얹을 항목이 없다.
+     */
+    renderCellAction?: (index: number, item: WordSearchResultItem) => ReactNode;
 }
 
 /**
@@ -10565,6 +10593,27 @@ export declare interface WordTableProps {
     onReorder?: (fromIndex: number, toIndex: number) => void;
     /** 표시 모드에서 `count` 안의 빈칸(항목 수 뒤 ~ count)에 '추가' 버튼 노출. count 가 항목 수와 같으면 그런 칸이 없다. `onActivateCell` 필요. */
     showFillerAdd?: boolean;
+    /**
+     * **칸 오른쪽 위에 부르는 쪽이 얹는 것** — 칸 번호와 그 칸의 항목을 준다. 안 주면 아무것도 안 얹는다.
+     *
+     * 표 전체를 다시 고르는 길(`onReshuffle` 을 쥔 화면)만 있으면 **여덟 칸 중 하나가 마음에 안 들어도
+     * 나머지 일곱이 함께 바뀐다** — 치료사가 고른 것을 잃는다(말귀 요청 ⑳, 2026-09-27). 그 자리를 연다.
+     *
+     * **무엇을 할지가 아니라 어디에 놓을지만 코어가 안다.** 동작(`onReplaceItem` 같은 것)으로 받으면
+     * 단추의 모양·이름·뜻까지 코어가 정하게 되는데, 이 자리는 화면마다 뜻이 다르다(한 곳은 '다른 쌍으로',
+     * 다른 곳은 '이 낱말만 빼기' 일 수 있다). 그려 넣는 것은 부르는 쪽 몫이다.
+     *
+     * 코어가 쥐는 것 셋 —
+     *  · **자리**: 칸 오른쪽 위. 빼기(`onRemoveItem`)가 함께 서면 **한 줄로 나란히** 선다(지우는 것이
+     *    오른쪽 끝 — `ItemActions` 와 같은 차례). 겹칠 일이 없다.
+     *  · **드러나는 때**: 칸에 마우스를 얹거나 초점이 들어올 때. 재생·정보·빼기와 같은 규칙이고,
+     *    hover 가 없는 기기에서는 늘 보인다.
+     *  · **인쇄·캡처에서는 안 나온다** — 만드는 동안만 쓰는 손잡이다. 화면 인쇄(`@media print`)와
+     *    인쇄 창(`wordTablePrint`) 둘 다에서 치운다.
+     *
+     * **표시 모드(`items`)에만 있다** — 편집 모드(`cells`)에는 얹을 항목이 없다.
+     */
+    renderCellAction?: (index: number, item: WordSearchResultItem) => ReactNode;
     /** 그리드 콘텐츠 DOM ref — 인쇄/캡처용 */
     contentRef?: Ref<HTMLDivElement>;
     buttonSize?: number;

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

@@ -1,4 +1,4 @@
 import './WordTableBlock.css';
 import type { WordTableBlockProps } from './wordTableBlockTypes';
 export type { WordEntry, WordTableBlockProps } from './wordTableBlockTypes';
-export default function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel }: WordTableBlockProps): import("react").JSX.Element;
+export default function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel, initialItemsPerPage, renderCellAction }: WordTableBlockProps): import("react").JSX.Element;

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

@@ -45,7 +45,7 @@ function 겹치지않는id(list) {
         return id === it.id ? it : { ...it, id };
     });
 }
-export default function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel }) {
+export default function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel, initialItemsPerPage, renderCellAction }) {
     const { t } = useTranslation();
     const resolvedResetLabel = resetLabel ?? t('wordPrint.clearAllSelection', '모두 선택 해제');
     const isEditable = items === undefined;
@@ -86,8 +86,10 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
     const contentRef = useRef(null);
     // 인쇄 캡처용 그리드 콘텐츠 ref 배열 (다중 페이지 — 페이지 분할 시)
     const pageRefs = useRef([]);
-    // 페이지 분할(표시 모드 전용) — 페이지당 단어/대립쌍 개수. 기본값 8(=1페이지에 전부)
-    const [itemsPerPageSetting, setItemsPerPageSetting] = useState(8);
+    /* 페이지 분할(표시 모드 전용) — 페이지당 단어/대립쌍 개수.
+       **들어설 때 한 번만 읽는다.** 그 뒤 사람이 고른 것을 밖에서 덮지 않는다(`initialItemsPerPage`).
+       `'all'` 은 무한대로 둔다 — 아래에서 항목 수로 조이므로 늘 한 쪽이 된다. */
+    const [itemsPerPageSetting, setItemsPerPageSetting] = useState(initialItemsPerPage === 'all' ? Number.POSITIVE_INFINITY : initialItemsPerPage ?? 8);
     // 종이 안에 페이지 번호(1 / N)를 찍을 위치 — 미표시 포함
     const [pageNumberPosition, setPageNumberPosition] = useState('right');
     // 내부 저장 팝업
@@ -319,7 +321,12 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
                     }), !hideControls && (_jsx(TableFilterPanel, { hasImage: hasImage, hasColloquial: hasColloquial, contentTypes: contentTypes, orientation: orientation, showOutline: showOutline, cutLine: cutLine, showDivLine: showDivLine, setters: { setContentTypes, setOrientation, setShowOutline, setCutLine, setShowDivLine }, showCutLine: (pagesEnabled ? itemsPerPage : count) > 1, showDivLine2: hasPairs, middleSections: middleSections, extraSelected: middleSelected, onExtraSelect: handleMiddleSelect })), 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)), 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, showFillerAdd: !!onAddItem, contentRef: contentRef })), 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', '이 단어표에 대한 제목을 입력하세요.'), 
+                            onReorder: onReorder && ((from, to) => onReorder(from + i * itemsPerPage, to + i * itemsPerPage)), 
+                            /* 안쪽 표는 제 쪽 안의 번호를 준다 — 부르는 쪽에는 **표 전체 기준**으로 넘긴다
+                               (위 `onReorder` 와 같은 셈이다. 쪽이 몇으로 나뉘었는지는 부르는 쪽 일이 아니다). */
+                            renderCellAction: renderCellAction && ((n, item) => renderCellAction(n + i * itemsPerPage, item)), 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, showFillerAdd: !!onAddItem, contentRef: contentRef })), 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/wordTableBlockTypes.d.ts

@@ -79,6 +79,34 @@ export interface WordTableBlockProps {
     hideControls?: boolean;
     /** 액션 중 저장 버튼만 노출 (불러오기/새 창/인쇄 숨김) */
     saveOnly?: boolean;
+    /**
+     * **'페이지당 개수' 로 들어설 때 골라져 있을 값** — 안 주면 지금까지처럼 8,
+     * `'all'` 이면 한 쪽에 전부.
+     *
+     * 한 쪽에 다 담는 길은 이미 있었다(고르개 첫 칸이 늘 항목 수 그대로다). 막혀 있던 것은
+     * **처음 값**뿐이라, 열두 낱말짜리 표를 만들어 놓고도 늘 여덟씩 두 쪽으로 시작해 사람이
+     * 매번 `12개` 를 다시 눌러야 했다(말귀 간편 제작 — 요청 ㉑, 2026-09-27).
+     *
+     * **처음 값이지 매인 값이 아니다.** 들어설 때 한 번만 읽고, 그 뒤 사람이 고른 것을 덮지
+     * 않는다 — 밖에서 계속 밀어 넣으면 사람이 고른 쪽을 앱이 도로 바꿔 버린다. 그래서 나중에
+     * 이 값을 바꿔도 화면은 안 따라간다.
+     *
+     * **개수가 도중에 바뀌는 화면이면 `'all'` 을 준다.** 그러면 설정이 "전부" 로 남아 있어,
+     * 낱말이 8개든 12개든 그때그때 한 쪽으로 선다 — 수를 바꿀 때마다 다시 넣어 줄 필요가 없다.
+     * 숫자를 주면 그 숫자에 못 박히므로 도중에 늘어난 만큼은 다음 쪽으로 넘어간다.
+     */
+    initialItemsPerPage?: number | 'all';
+    /**
+     * **칸 오른쪽 위에 부르는 쪽이 얹는 것** — 안쪽 `WordTable` 의 같은 이름 프롭으로 그대로 간다.
+     * 자리·드러나는 때·인쇄에서 치우는 규칙은 그쪽 글에 있다.
+     *
+     * **칸 번호는 표 전체 기준이다.** 쪽이 나뉘면 안쪽 표는 제 쪽 안의 번호(0부터)를 주는데,
+     * 여기서 쪽 몫을 더해 넘긴다 — 부르는 쪽은 쪽이 몇으로 나뉘었는지 몰라도 된다
+     * (`onReorder` 가 쓰는 셈과 같다).
+     *
+     * **표시 모드에만 간다** — 편집 모드(칸을 손으로 채우는 꼴)에는 얹을 항목이 없다.
+     */
+    renderCellAction?: (index: number, item: WordSearchResultItem) => ReactNode;
 }
 export declare const CELL_COUNTS: number[];
 /** 표시(인쇄) 모드에서 선택 가능한 "페이지당 개수"(단어/대립쌍 수) — 이 값 그대로 페이지당 칸 수가 된다 */

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

@@ -141,7 +141,10 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
         flex-shrink: 0;
         transform-origin: top center;
       }
-      .word-table-block__card-close { display: none; }
+      /* 만드는 동안만 쓰는 손잡이들 — 종이에는 안 나간다(renderCellAction 이 얹은 것도 이 줄 안에 있다).
+         **여기는 템플릿 글 안이다** — 홑따옴표 대신 역따옴표를 쓰면 글이 거기서 끊긴다. */
+      .word-table-block__card-close,
+      .word-table-block__card-actions { display: none; }
       /* 머리글은 격자 위에 얹힌다. 용지 안쪽 여백(57px)을 이미 .paper-wrap 이 갖고 있어
          여기서는 아래 간격만 준다. 격자는 제 높이를 스스로 잡으므로 밀려도 잘리지 않는다. */
       .paper-head {

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

@@ -25,10 +25,39 @@
     box-sizing: border-box;
 }
 
-/* ── 페이지 번호(종이 안에 직접 표기) ──────────────────── */
+/* ── 페이지 번호 ───────────────────────────────────────── */
+
+/* **격자가 번호 몫을 비워 준다.** `bottom` 이 양수(8px)인데 비워 둔 자리가 없어서, 번호가
+   **마지막 칸 위에 겹쳐** 있었다(실측 2026-09-27: 번호 y 570~592, 마지막 칸 y 262~601 —
+   사장님이 "칸 안으로 들어와 있네" 로 짚으신 것이다). 격자가 종이 안쪽을 꽉 채우므로
+   (`height: 100%`) 비워 주지 않으면 번호가 설 자리가 없다.
+
+   **격자 밖으로 낼 수는 없다** — 인쇄가 베끼는 것이 이 격자다(`contentRef` 가 가리키는
+   요소를 통째로 복사해 인쇄 문서에 넣는다). 밖으로 내면 종이에서 번호가 사라진다.
+   음수 `bottom` 으로 종이 여백에 앉히는 길도 접었다 — 이 저장소는 **밖으로 내민 절대배치**를
+   전수로 막고 있고(`tableFieldResizer` 시험), 그 봐줄 목록은 "부모가 잘라 준다" 를 근거로
+   요구한다. 여기는 잘리면 안 되는 자리라 그 근거를 댈 수 없다.
+
+   그래서 **번호가 있을 때만** 격자가 아래를 그만큼 비운다. 칸은 그만큼 낮아지는데, 그게
+   번호가 설 자리다. 번호가 없는 표는 한 픽셀도 안 바뀐다. */
+.word-table-block__content--page-number {
+    padding-bottom: 28px;
+}
+/* 절취선 바탕은 **칸이 있는 데까지만** 칠한다 — 안 그러면 비워 둔 띠가 선 색으로 꽉 찬다
+   (`--cut-show` 는 격자 바탕을 선 색으로 깔고 칸이 그 위를 덮는 꼴이다). 칸 사이 틈은
+   content-box 안이라 그대로 남는다. */
+.word-table-block__content--page-number.word-table-block__content--cut-show {
+    background-clip: content-box;
+}
+/* 외곽선도 칸이 있는 데까지 — 비워 둔 띠까지 두르면 번호가 표 안에 든 것처럼 보인다 */
+.word-table-block__content--page-number.word-table-block__content--outline::after {
+    bottom: 28px;
+}
+
 .word-table__page-number {
     position: absolute;
-    bottom: 8px;
+    /* 비워 둔 28px 안이다 — 밖으로 내밀지 않는다 */
+    bottom: 4px;
     z-index: 2;
     color: var(--color-gray);
     pointer-events: none;
@@ -149,7 +178,34 @@
     transition: opacity 0.15s;
 }
 
+/* **오른쪽 위 한 줄** — 부르는 쪽이 얹은 것(`renderCellAction`)과 빼기가 함께 설 때 쓴다.
+   둘 다 같은 모서리를 원해서, 각자 `position: absolute` 로 두면 그대로 겹친다. 줄이 자리를
+   한 번만 잡고 안엣것들은 흐름으로 선다. 빼기는 그 안에서 **오른쪽 끝**이다 — 지우는 것이
+   끝에 서는 차례는 `ItemActions` 와 같다. */
+.word-table-block__card-actions {
+    position: absolute;
+    top: 20px;
+    right: 20px;
+    z-index: 1;
+    display: flex;
+    align-items: center;
+    gap: var(--spacing-xs);
+    opacity: 0;
+    transition: opacity 0.15s;
+}
+/* 줄 안에 들면 제 자리를 안 잡는다 — 줄이 잡아 준다. 편집 모드(`cells`)의 빼기는 줄 없이
+   혼자 서므로 위 규칙이 그대로 산다. */
+.word-table-block__card-actions .word-table-block__card-close {
+    position: static;
+    top: auto;
+    right: auto;
+    opacity: 1;
+}
+
 /* 키보드 대응 — opacity:0인 채로 포커스가 가면 사용자는 보이지 않는 버튼을 누르게 된다 */
+.word-table-block__card:focus-within .word-table-block__card-actions,
+.word-table-block__card-actions:focus-within,
+.word-table-block__card:hover .word-table-block__card-actions,
 .word-table-block__card:focus-within .word-table-block__card-close,
 /* 이 요소들은 **버튼을 감싼 div**라 자신은 포커스를 못 받는다 — :focus-visible이 아니라
    :focus-within으로 봐야 안의 버튼이 포커스를 받았을 때 드러난다(실측으로 확인). */
@@ -309,6 +365,7 @@
    (보이지 않는 단추를 짐작으로 눌러야 했다). 늘 보이게만 한다 — 색·모양은 그대로. 인쇄에서는 아래 @media print 가 치운다. */
 @media (hover: none) {
     .word-table-block__card-close,
+    .word-table-block__card-actions,
     .word-table-block__card-handle,
     .word-table-cell__play-button,
     .word-table-cell__info-button {
@@ -400,6 +457,7 @@
     }
 
     .word-table-block__card-close,
+    .word-table-block__card-actions,
     .word-table-block__card-handle { display: none; }
 
     .word-table-cell__play-button,

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

@@ -38,6 +38,27 @@ export interface WordTableProps {
     onReorder?: (fromIndex: number, toIndex: number) => void;
     /** 표시 모드에서 `count` 안의 빈칸(항목 수 뒤 ~ count)에 '추가' 버튼 노출. count 가 항목 수와 같으면 그런 칸이 없다. `onActivateCell` 필요. */
     showFillerAdd?: boolean;
+    /**
+     * **칸 오른쪽 위에 부르는 쪽이 얹는 것** — 칸 번호와 그 칸의 항목을 준다. 안 주면 아무것도 안 얹는다.
+     *
+     * 표 전체를 다시 고르는 길(`onReshuffle` 을 쥔 화면)만 있으면 **여덟 칸 중 하나가 마음에 안 들어도
+     * 나머지 일곱이 함께 바뀐다** — 치료사가 고른 것을 잃는다(말귀 요청 ⑳, 2026-09-27). 그 자리를 연다.
+     *
+     * **무엇을 할지가 아니라 어디에 놓을지만 코어가 안다.** 동작(`onReplaceItem` 같은 것)으로 받으면
+     * 단추의 모양·이름·뜻까지 코어가 정하게 되는데, 이 자리는 화면마다 뜻이 다르다(한 곳은 '다른 쌍으로',
+     * 다른 곳은 '이 낱말만 빼기' 일 수 있다). 그려 넣는 것은 부르는 쪽 몫이다.
+     *
+     * 코어가 쥐는 것 셋 —
+     *  · **자리**: 칸 오른쪽 위. 빼기(`onRemoveItem`)가 함께 서면 **한 줄로 나란히** 선다(지우는 것이
+     *    오른쪽 끝 — `ItemActions` 와 같은 차례). 겹칠 일이 없다.
+     *  · **드러나는 때**: 칸에 마우스를 얹거나 초점이 들어올 때. 재생·정보·빼기와 같은 규칙이고,
+     *    hover 가 없는 기기에서는 늘 보인다.
+     *  · **인쇄·캡처에서는 안 나온다** — 만드는 동안만 쓰는 손잡이다. 화면 인쇄(`@media print`)와
+     *    인쇄 창(`wordTablePrint`) 둘 다에서 치운다.
+     *
+     * **표시 모드(`items`)에만 있다** — 편집 모드(`cells`)에는 얹을 항목이 없다.
+     */
+    renderCellAction?: (index: number, item: WordSearchResultItem) => ReactNode;
     /** 그리드 콘텐츠 DOM ref — 인쇄/캡처용 */
     contentRef?: Ref<HTMLDivElement>;
     buttonSize?: number;
@@ -93,4 +114,4 @@ export interface WordTableProps {
  * 표시(items)·편집(editCells) 두 모드를 지원한다.
  * @public
  */
-export default function WordTable({ title, titleIcon, disc, className, orientation, contentTypes, cutLine, showOutline, showDivLine, items, editCells, count, activeCell, onActivateCell, onRemoveCell, onRemoveItem, onReorder, showFillerAdd, contentRef, buttonSize, pageNumber, pageNumberPosition, fitHeight, scoring, marks, onMarkClick, scoreIndexOffset, }: WordTableProps): import("react").JSX.Element;
+export default function WordTable({ title, titleIcon, disc, className, orientation, contentTypes, cutLine, showOutline, showDivLine, items, editCells, count, activeCell, onActivateCell, onRemoveCell, onRemoveItem, onReorder, renderCellAction, showFillerAdd, contentRef, buttonSize, pageNumber, pageNumberPosition, fitHeight, scoring, marks, onMarkClick, scoreIndexOffset, }: WordTableProps): import("react").JSX.Element;

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

@@ -184,7 +184,7 @@ function 어종이름(t) {
  * 표시(items)·편집(editCells) 두 모드를 지원한다.
  * @public
  */
-export default function WordTable({ title, titleIcon, disc, className, orientation = 'landscape', contentTypes = ['이미지', '단어', '표준 발음'], cutLine = '표시', showOutline = true, showDivLine = true, items, editCells, count, activeCell = null, onActivateCell, onRemoveCell, onRemoveItem, onReorder, showFillerAdd = false, contentRef, buttonSize = 40, pageNumber, pageNumberPosition = 'right', fitHeight = false, scoring = false, marks, onMarkClick, scoreIndexOffset = 0, }) {
+export default function WordTable({ title, titleIcon, disc, className, orientation = 'landscape', contentTypes = ['이미지', '단어', '표준 발음'], cutLine = '표시', showOutline = true, showDivLine = true, items, editCells, count, activeCell = null, onActivateCell, onRemoveCell, onRemoveItem, onReorder, renderCellAction, showFillerAdd = false, contentRef, buttonSize = 40, pageNumber, pageNumberPosition = 'right', fitHeight = false, scoring = false, marks, onMarkClick, scoreIndexOffset = 0, }) {
     const clickMark = useCallback((cellIndex, clicked) => {
         onMarkClick?.(scoreIndexOffset + cellIndex, clicked);
     }, [onMarkClick, scoreIndexOffset]);
@@ -363,7 +363,9 @@ 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);
-    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 contentClass = cx('word-table-block__content', CUT_CLASS[cutLine], showOutline && 'word-table-block__content--outline', showDivLine && hasPairs && 'word-table-block__content--div-line', 
+    /* 번호가 설 자리를 비운다 — 번호가 없으면 비우지 않는다(표가 공연히 낮아지지 않게) */
+    pageNumber && pageNumberPosition !== 'none' && 'word-table-block__content--page-number');
     // 빈칸(추가버튼)은 스케일 역보정으로 실제 크기 유지
     const counterScale = { transform: `scale(${1 / scale})`, transformOrigin: 'center center' };
     /* **채점 단추는 표와 함께 줄어들면 안 된다.**
@@ -390,7 +392,9 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
                                                 ariaLabel: t('wordTable.reorder.handle', {
                                                     word: (item.words ?? []).map(w => w.label).join(' / '),
                                                     defaultValue: '{{word}} 순서 바꾸기 (Alt + 화살표)',
-                                                }) }) })), 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) => {
+                                                }) }) })), (renderCellAction || onRemoveItem) && (
+                                        /* 오른쪽 위 한 줄 — 부르는 쪽이 얹은 것과 빼기가 나란히 선다(지우는 것이 끝) */
+                                        _jsxs("div", { className: "word-table-block__card-actions", children: [renderCellAction?.(index, item), 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 }) }))] }) }), onReorder && _jsx("span", { role: "status", style: 보이지않게, children: 옮김알림 })] }));

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

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.201.0";
+export declare const CORE_VERSION = "0.203.0";

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

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export const CORE_VERSION = '0.201.0';
+export const CORE_VERSION = '0.203.0';