@ihabdevteam/core 0.146.0 → 0.148.0

package/dist/ihabdevteam-core.d.ts

@@ -526,7 +526,7 @@ export declare function buildChangeWholeSyllableProblem(word: string, compFrom:
  * @public 합성어 부분 탈락 → [문제단어(합성어), 남는 실단어(정답), 그 단어의 대립쌍 실단어 오답 2].
  * 합성어 근사: 앞/뒤로 나눈 두 조각이 '둘 다 실단어'(wordSet)인 첫 조합을 채택(예: 손수건=손+수건).
  * 정답·오답 전부 실단어라 발음이 그대로. comp(훈련음소) 지정 시 남는 단어의 그 자리를 대립, 없으면 전 음절.
- * dropPos: 0=어두 어근(앞) 탈락, 1=어말 어근(뒤) 탈락. 편집기·런타임 공용.
+ * dropPos: 0=어두 어근(앞) 탈락, 1=어말 어근(뒤) 탈락. 결과의 `dropped` 에 뺀 조각을 담는다. 편집기·런타임 공용.
  */
 export declare function buildDropCompoundProblem(word: string, comp: CompositionFilter | null, pronMap: Map<string, string>, phonemeView: 'char' | 'pron', wordSet: Set<string>, dropPos?: number | null): TrainingProblem | null;
 
@@ -1254,7 +1254,9 @@ export declare interface ConfirmPopupProps {
     };
     /**
      * 확인 클릭 시 실행. `close`로 직접 닫을 수 있음(async 지원).
-     * 기본은 onConfirm 완료 후 자동으로 닫힘(closeOnConfirm).
+     * 기본은 onConfirm 완료 후 자동으로 닫힘(closeOnConfirm). 받은 `close()` 를 부르면 그것도 닫힘으로 센다(닫히는 동안 잠금 유지).
+     * 던지거나 거절되면 창이 남고 잠금이 풀린다 — 거절은 console.error 로 받는다.
+     * 안에서 부모가 창을 치우면 그 뒤 onClose 는 불리지 않는다.
      */
     onConfirm: (close: () => void) => void | Promise<void>;
     /** false면 자동으로 닫지 않음 — onConfirm이 전달받은 close로 닫힘 시점을 제어 (성공 시에만 닫기 등). 기본 true */
@@ -1386,7 +1388,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.146.0";
+export declare const CORE_VERSION = "0.148.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -1929,7 +1931,11 @@ export declare interface EmptyStateProps {
     className?: string;
 }
 
-export declare function ensureTrainingDataLoaded(timeout?: number): Promise<unknown>;
+/**
+ * 자료를 받게 하고 **받았는지** 를 돌려준다(시간 초과·실패는 false). 전에는 성공·3초 초과·실패가 모두 undefined 로 끝나
+ * 부르는 쪽이 빈 풀로 계획을 만들고도 알 길이 없었다. 늦게 도착하면 'speechear.data.updated' 가 온다.
+ */
+export declare function ensureTrainingDataLoaded(timeout?: number): Promise<boolean>;
 
 export declare function ErrorState({ message, hint, icon, onRetry, retryLabel, className }: ErrorStateProps): JSX.Element;
 
@@ -2364,7 +2370,7 @@ export declare function getPairIndex(): PairIndex | null;
 export declare function getPayloadTimestamp(payload: unknown): number;
 
 /** product code → 요금제 티어 */
-export declare function getPlanTier(productCode: string): PlanTier;
+export declare function getPlanTier(productCode: string | null | undefined): PlanTier;
 
 /** 레지스트리에서 theme 조회 */
 export declare function getPromoBannerBgTheme(el: Element | null): PromoBannerBgTheme | undefined;
@@ -4179,8 +4185,8 @@ export declare interface PopupProps {
      *
      * "입력 중인데 정말 닫을까요?" 같은 확인 절차용. onClose에서 막지 않는 이유 —
      * onClose는 이미 닫힘 애니메이션(260ms)이 끝난 뒤(animateThen의 setTimeout 안)에 불리므로,
-     * 거기서 닫기를 취소하면 창이 한 번 사라졌다가 되살아난다(animateThen 은 콜백 뒤에도 창이
-     * 남아 있으면 되살린다). 사라지지 않고 그대로 머물게 하려면 이 시점에 판단한다.
+     * 거기서 닫기를 취소하면(열림 상태를 끄지 않으면) 창이 닫힌 모양으로 남는다(animateThen 은 약속을 돌려준
+     * 콜백만 되살린다 — onClose 같은 동기 콜백 뒤에는 되살리지 않는다). 사라지지 않고 그대로 머물게 하려면 이 시점에 판단한다.
      *
      * 미지정이면 묻지 않고 닫는다.
      */
@@ -4195,8 +4201,9 @@ export declare interface PopupProps {
     closeOnBackdrop?: boolean;
     className?: string;
     /**
-     * 다이얼로그 접근명 — `title`이 없는 팝업(useTitle=false 등)에서 쓴다.
-     * title이 있으면 그쪽이 `aria-labelledby`로 연결되므로 이 값은 무시된다.
+     * 다이얼로그 접근명 — 제목을 그리지 않는 팝업(`title` 이 없거나 useTitle=false)에서 쓴다.
+     * 제목을 그리면(useTitle 이고 title 이 있으면) 그쪽이 `aria-labelledby`로 연결되므로 이 값은 무시된다.
+     * useTitle=false 인데 이 값이 없으면 글자 `title` 을 이름으로 쓴다.
      * (없으면 스크린리더가 "대화상자"라고만 읽어 무슨 창인지 알 수 없다.)
      */
     ariaLabel?: string;
@@ -4790,7 +4797,7 @@ export declare interface ReportBlock {
     /**
      * 쪽을 나눌 때 한 덩어리로 다룰 묶음. 표 머리와 그 행들처럼 갈라지면 읽을 수
      * 없는 것들에 같은 값을 준다 — 남은 자리가 모자라면 통째로 다음 장으로 간다.
-     * 묶음 하나가 한 장보다 크면 어쩔 수 없이 블록 단위로 쪼갠다.
+     * 묶음 하나가 한 장보다 크면 어쩔 수 없이 블록 단위로 쪼갠다. `section` 이 다르면 같은 값이어도 한 묶음이 아니다.
      */
     group?: string;
 }
@@ -4803,7 +4810,8 @@ export declare interface ReportBlock {
  * 바닥(로고·저작권 + 쪽 번호)이 반복된다.
  *
  * 재는 방식이라 글꼴이 늦게 오거나 이미지가 나중에 뜨면 쪽이 밀릴 수 있다.
- * 다시 재는 때는 블록들의 `id`·`section`·`group` 구성이 바뀔 때와 처음 그릴 때뿐이다 —
+ * 다시 재는 때는 블록들의 `id`·`section`·`group` 구성이나 장 규격(`pageWidth`·`pageHeight`·`margin`)이 바뀔 때와
+ * 처음 그릴 때(숨겨져 있다 보이게 될 때 포함)뿐이다 —
  * 같은 구성으로 다시 그리거나 `content` 만 바뀌어서는 다시 재지 않는다(렌더마다 재면
  * 재기 → 쪽 나눔 → 렌더가 끝없이 돈다). 글꼴·이미지가 다 온 뒤 다시 재야 하면
  * `key` 를 바꿔 새로 붙인다.
@@ -6113,7 +6121,7 @@ export declare function syllablePron(ch: string): string;
 /** composition.syllable 선택값을 실제 매칭용 음절 수 배열로 변환 (SYLLABLE_MIN 이상은 범위로 확장) */
 export declare function syllableToFilter(syllable: number): number[];
 
-/** @public 음절(분해값 s)이 comp의 선택 파트들과 모두 일치하는지(=선택 음소를 가진 음절). */
+/** @public 음절(분해값 s)이 comp의 선택 파트들과 모두 일치하는지(=선택 음소를 가진 음절). `jongNone` 이면 받침 없는 음절만 맞고 `jong` 은 보지 않는다(풀 필터와 같게). */
 export declare function syllMatchesComp(s: Syllable, comp: CompositionFilter): boolean;
 
 /** @public */
@@ -8426,7 +8434,8 @@ export declare interface UseWordTablePrintOptions {
 
 /** @public */
 export declare interface UseWordTablePrintResult {
-    /** 화면 밖 iframe에서 격리 인쇄(전역 print CSS·팝업 차단 무관). */
+    /** 화면 밖 iframe에서 격리 인쇄(전역 print CSS·팝업 차단 무관). 인쇄가 진행 중이면(10초 한도) 다시 불러도 받지 않는다.
+     *  세 동작 모두 문서는 늘 light 테마(종이가 흰색). */
     print: () => void;
     /** 새 탭에 단어표를 열어 사용자가 직접 인쇄/저장하게 한다. */
     openNewWindow: () => void;
@@ -8934,7 +8943,6 @@ export declare interface WordSearchResultWord {
  */
 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;
 
-/** @public */
 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;
 
 /** @public */

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

@@ -40,16 +40,25 @@ export default function BottomNav({ items = [], activeKey, onChange, appMode, on
         ro.observe(el);
         return () => ro.disconnect();
     }, []);
+    /* 잰 폭은 "…"(구분선 1px + 52px 칸)가 서 있으면 그만큼 줄어든 값이다. 그 폭으로만 판정하면 같은 폭·같은 항목인데 지나온 길에 따라
+       넘침이 달랐다(13개 매니저 메뉴 → 8개 말귀 메뉴로 바꾸면 들어갈 8개 중 하나가 "…" 에 갇힘). 유틸이 없을 때 지난 렌더에 "…" 가
+       서 있었다면(넘침 때문이든 그때의 유틸 때문이든) 그 폭을 되돌려 **"…" 없는 폭** 으로 판정하고, 넘치면 "…" 자리를 뺀 폭으로 센다. */
+    const MORE_W = BTN_SIZE + 1;
+    const 더보기섰음Ref = useRef(false);
+    const 온폭 = containerWidth > 0 && moreItems.length === 0 && 더보기섰음Ref.current ? containerWidth + MORE_W : containerWidth;
+    const 다들어감 = itemsLen * (BTN_SIZE + BTN_GAP) - BTN_GAP <= 온폭;
     // n개 버튼: n*52 + (n-1)*10 <= W → n <= (W + 10) / 62
-    const n = containerWidth > 0
-        ? Math.floor((containerWidth + BTN_GAP) / (BTN_SIZE + BTN_GAP))
-        : itemsLen;
+    const n = containerWidth <= 0 ? itemsLen
+        : moreItems.length > 0 ? Math.floor((containerWidth + BTN_GAP) / (BTN_SIZE + BTN_GAP))
+            : 다들어감 ? itemsLen
+                : Math.floor((온폭 - MORE_W + BTN_GAP) / (BTN_SIZE + BTN_GAP));
     const overflow = containerWidth > 0 && n < itemsLen;
     const maxVisible = overflow ? n : itemsLen;
     const visibleItems = items.slice(0, maxVisible);
     const hiddenItems = items.slice(maxVisible);
     // 넘친 nav 항목이 있거나 유틸(moreItems)이 있으면 더보기(…) 버튼을 노출
     const showMore = overflow || moreItems.length > 0;
+    useEffect(() => { 더보기섰음Ref.current = showMore; });
     const computeMenuStyle = useCallback((rect) => ({
         position: 'fixed',
         bottom: window.innerHeight - rect.top + 8,
@@ -66,7 +75,7 @@ export default function BottomNav({ items = [], activeKey, onChange, appMode, on
     const nameWithCount = useCallback((label, count) => count > 0 ? t('nav.badgeLabel', { label, count, defaultValue: '{{label}}, {{count}}개' }) : label, [t]);
     const handleModeChange = useCallback(() => onAppModeChange?.(nextMode), [onAppModeChange, nextMode]);
     // 넘친 nav 항목 또는 유틸 항목이 현재 활성 상태면 … 버튼에 그 아이콘/선택표시를 반영
-    const activeMore = useMemo(() => hiddenItems.find(it => it.key === activeKey) ?? moreItems.find(it => it.selected || (it.key && it.key === activeKey)), [hiddenItems, activeKey, moreItems]);
+    const activeMore = useMemo(() => hiddenItems.find(it => !!it.key && it.key === activeKey) ?? moreItems.find(it => it.selected || (it.key && it.key === activeKey)), [hiddenItems, activeKey, moreItems]);
     // 넘친 nav 항목 + 유틸 항목을 한 컬럼으로 합쳐 더보기 메뉴에 노출(각자 아이콘으로 구분)
     const moreColumns = useMemo(() => [{
             items: [
@@ -74,7 +83,7 @@ export default function BottomNav({ items = [], activeKey, onChange, appMode, on
                     label: it.label,
                     icon: it.icon,
                     badgeCount: it.badgeCount,
-                    selected: it.key === activeKey,
+                    selected: !!it.key && it.key === activeKey,
                     closeOnSelect: true,
                     // "…" 로 넘어간 꺼진 항목도 꺼진 채로 — 줄에서는 막히는데 메뉴에서는 골라졌다
                     disabled: it.state === 'disabled',
@@ -105,6 +114,6 @@ export default function BottomNav({ items = [], activeKey, onChange, appMode, on
                     const count = badgeOf(it.badgeCount);
                     return (
                     // key 는 선택 prop 이다 — 없으면 자리 번호로(형제 key 가 모두 undefined 가 되던 것)
-                    _jsxs("span", { className: "bottom-nav__slot", children: [_jsx(Button, { htmlType: "button", size: 52, type: "dot", icon: it.icon, ariaLabel: nameWithCount(it.label, count), selected: it.key === activeKey, disabled: it.state === 'disabled', className: "bottom-nav-item", onClick: () => it.key && onChange?.(it.key) }), count > 0 && (_jsx("span", { "aria-hidden": "true", children: _jsx(Badge, { type: "dot", position: "top-right", number: Math.min(count, 99), size: 24 }) }))] }, it.key ?? `__slot-${i}`));
+                    _jsxs("span", { className: "bottom-nav__slot", children: [_jsx(Button, { htmlType: "button", size: 52, type: "dot", icon: it.icon, ariaLabel: nameWithCount(it.label, count), selected: !!it.key && it.key === activeKey, disabled: it.state === 'disabled', className: "bottom-nav-item", onClick: () => it.key && onChange?.(it.key) }), count > 0 && (_jsx("span", { "aria-hidden": "true", children: _jsx(Badge, { type: "dot", position: "top-right", number: Math.min(count, 99), size: 24 }) }))] }, it.key ?? `__slot-${i}`));
                 }) }), showMore && (_jsxs(_Fragment, { children: [_jsx("div", { className: "bottom-nav__divider", "aria-hidden": "true" }), _jsx("div", { className: "bottom-nav__right", children: _jsxs("div", { ref: moreRef, className: "bottom-nav__slot", children: [_jsx(Button, { htmlType: "button", size: 52, type: "dot", icon: activeMore?.icon ?? 'ellipsis', ariaLabel: nameWithCount(activeMore?.label ?? t('nav.more', '더보기'), moreBadge), selected: !!activeMore, className: "bottom-nav-item", onClick: handleToggleMore, "aria-expanded": moreOpen, "aria-controls": moreOpen ? moreMenuId : undefined }), moreBadge > 0 && (_jsx("span", { "aria-hidden": "true", children: _jsx(Badge, { type: "dot", position: "top-right", number: Math.min(moreBadge, 99), size: 24 }) })), moreOpen && createPortal(_jsx("div", { id: moreMenuId, role: "group", "aria-label": t('nav.moreMenu', '더보기 메뉴'), className: "tooltip-content", style: menuStyle, ref: menuRef, children: _jsx(MenuTooltip, { columns: moreColumns, onClose: handleCloseMore }) }), document.body)] }) })] }))] }));
 }

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

@@ -125,8 +125,8 @@ export default function Dropdown({ options, value, onChange, placeholder, disabl
             e.preventDefault();
             if (options[activeIdx])
                 select(options[activeIdx]);
-            else if (e.key === ' ')
-                setOpen(false);
+            else
+                setOpen(false); // Enter 도 — 가리킨 것 없이 기본 동작만 막으면 목록이 열린 채 아무 일도 없었다
         }
     }, [disabled, open, options, activeIdx, select, setOpen]);
     const menu = open ? (_jsx("div", { ref: menuRef, id: listId, className: "dropdown__menu", "data-tooltip-ignore": true, role: "listbox", style: menuStyle, onMouseLeave: handleMenuLeave, 

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

@@ -50,7 +50,9 @@ export interface ConfirmPopupProps {
     };
     /**
      * 확인 클릭 시 실행. `close`로 직접 닫을 수 있음(async 지원).
-     * 기본은 onConfirm 완료 후 자동으로 닫힘(closeOnConfirm).
+     * 기본은 onConfirm 완료 후 자동으로 닫힘(closeOnConfirm). 받은 `close()` 를 부르면 그것도 닫힘으로 센다(닫히는 동안 잠금 유지).
+     * 던지거나 거절되면 창이 남고 잠금이 풀린다 — 거절은 console.error 로 받는다.
+     * 안에서 부모가 창을 치우면 그 뒤 onClose 는 불리지 않는다.
      */
     onConfirm: (close: () => void) => void | Promise<void>;
     /** false면 자동으로 닫지 않음 — onConfirm이 전달받은 close로 닫힘 시점을 제어 (성공 시에만 닫기 등). 기본 true */

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

@@ -40,8 +40,8 @@ export interface PopupProps {
      *
      * "입력 중인데 정말 닫을까요?" 같은 확인 절차용. onClose에서 막지 않는 이유 —
      * onClose는 이미 닫힘 애니메이션(260ms)이 끝난 뒤(animateThen의 setTimeout 안)에 불리므로,
-     * 거기서 닫기를 취소하면 창이 한 번 사라졌다가 되살아난다(animateThen 은 콜백 뒤에도 창이
-     * 남아 있으면 되살린다). 사라지지 않고 그대로 머물게 하려면 이 시점에 판단한다.
+     * 거기서 닫기를 취소하면(열림 상태를 끄지 않으면) 창이 닫힌 모양으로 남는다(animateThen 은 약속을 돌려준
+     * 콜백만 되살린다 — onClose 같은 동기 콜백 뒤에는 되살리지 않는다). 사라지지 않고 그대로 머물게 하려면 이 시점에 판단한다.
      *
      * 미지정이면 묻지 않고 닫는다.
      */
@@ -56,8 +56,9 @@ export interface PopupProps {
     closeOnBackdrop?: boolean;
     className?: string;
     /**
-     * 다이얼로그 접근명 — `title`이 없는 팝업(useTitle=false 등)에서 쓴다.
-     * title이 있으면 그쪽이 `aria-labelledby`로 연결되므로 이 값은 무시된다.
+     * 다이얼로그 접근명 — 제목을 그리지 않는 팝업(`title` 이 없거나 useTitle=false)에서 쓴다.
+     * 제목을 그리면(useTitle 이고 title 이 있으면) 그쪽이 `aria-labelledby`로 연결되므로 이 값은 무시된다.
+     * useTitle=false 인데 이 값이 없으면 글자 `title` 을 이름으로 쓴다.
      * (없으면 스크린리더가 "대화상자"라고만 읽어 무슨 창인지 알 수 없다.)
      */
     ariaLabel?: string;

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

@@ -109,7 +109,7 @@ export default function Popup(props) {
     /* Tab 순환을 패널 안으로 가둔다 — 네 곳에 있던 같은 열두 줄을 훅 한 벌로 모았다.
        inline 으로 쓸 때는 다이얼로그가 아니라 걸지 않는다(예전과 같다). */
     useFocusTrap(panelRef, !inline);
-    /* 닫힘 애니메이션 뒤 콜백을 부른다. **콜백이 던지거나 거절되면, 또는 콜백 뒤에도 이 창이 그대로 있으면 되살린다** —
+    /* 닫힘 애니메이션 뒤 콜백을 부른다. **콜백이 던지거나 거절되면, 또는 약속을 돌려준 콜백이 끝난 뒤에도 이 창이 그대로 있으면 되살린다** —
        전에는 닫는 중 표시만 남아 투명한 막이 화면을 덮고(클릭을 가로챔) ESC·X·바탕·다시 저장이 모두 무시돼 페이지를 쓸 수
        없었다(말귀 업체 정보·훈련 묶음 수정 저장이 실패해 부모가 창을 열어 둘 때). 성공하면 부모가 곧 치우므로 되살릴 일이 없다. */
     const 살아있음Ref = useRef(true);

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

@@ -15,7 +15,7 @@ export interface ReportBlock {
     /**
      * 쪽을 나눌 때 한 덩어리로 다룰 묶음. 표 머리와 그 행들처럼 갈라지면 읽을 수
      * 없는 것들에 같은 값을 준다 — 남은 자리가 모자라면 통째로 다음 장으로 간다.
-     * 묶음 하나가 한 장보다 크면 어쩔 수 없이 블록 단위로 쪼갠다.
+     * 묶음 하나가 한 장보다 크면 어쩔 수 없이 블록 단위로 쪼갠다. `section` 이 다르면 같은 값이어도 한 묶음이 아니다.
      */
     group?: string;
 }
@@ -54,7 +54,8 @@ export interface ReportDocumentProps {
  * 바닥(로고·저작권 + 쪽 번호)이 반복된다.
  *
  * 재는 방식이라 글꼴이 늦게 오거나 이미지가 나중에 뜨면 쪽이 밀릴 수 있다.
- * 다시 재는 때는 블록들의 `id`·`section`·`group` 구성이 바뀔 때와 처음 그릴 때뿐이다 —
+ * 다시 재는 때는 블록들의 `id`·`section`·`group` 구성이나 장 규격(`pageWidth`·`pageHeight`·`margin`)이 바뀔 때와
+ * 처음 그릴 때(숨겨져 있다 보이게 될 때 포함)뿐이다 —
  * 같은 구성으로 다시 그리거나 `content` 만 바뀌어서는 다시 재지 않는다(렌더마다 재면
  * 재기 → 쪽 나눔 → 렌더가 끝없이 돈다). 글꼴·이미지가 다 온 뒤 다시 재야 하면
  * `key` 를 바꿔 새로 붙인다.

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

@@ -15,7 +15,8 @@ const DEFAULT_PAGE_LABEL = (page, total) => `${page} / ${total}`;
  * 바닥(로고·저작권 + 쪽 번호)이 반복된다.
  *
  * 재는 방식이라 글꼴이 늦게 오거나 이미지가 나중에 뜨면 쪽이 밀릴 수 있다.
- * 다시 재는 때는 블록들의 `id`·`section`·`group` 구성이 바뀔 때와 처음 그릴 때뿐이다 —
+ * 다시 재는 때는 블록들의 `id`·`section`·`group` 구성이나 장 규격(`pageWidth`·`pageHeight`·`margin`)이 바뀔 때와
+ * 처음 그릴 때(숨겨져 있다 보이게 될 때 포함)뿐이다 —
  * 같은 구성으로 다시 그리거나 `content` 만 바뀌어서는 다시 재지 않는다(렌더마다 재면
  * 재기 → 쪽 나눔 → 렌더가 끝없이 돈다). 글꼴·이미지가 다 온 뒤 다시 재야 하면
  * `key` 를 바꿔 새로 붙인다.
@@ -134,12 +135,13 @@ export default function ReportDocument({ blocks, sectionTitles, logo, footer, pa
             if (cur.length && blocks[cur[0]].section !== blocks[grp[0]].section)
                 flush();
             // 덩어리 전체가 남은 자리에 안 들어가면 통째로 다음 장으로.
-            if (cur.length && used + groupH > budget)
+            // 소수 높이는 배율(transform: scale) 안에서 요소마다 1/64px 안팎 오차가 붙는다 — 딱 찬 결과지가 두 장이 되지 않게 조금 봐준다
+            if (cur.length && used + groupH > budget + 0.01)
                 flush();
             if (groupH > budget) {
                 // 덩어리 하나가 한 장보다 크면 쪼갤 수밖에 없다.
                 grp.forEach((i) => {
-                    if (cur.length && used + heights[i] > budget)
+                    if (cur.length && used + heights[i] > budget + 0.01)
                         flush();
                     cur.push(i);
                     used += heights[i];

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

@@ -8,7 +8,9 @@ import Button from './Button';
 /** @public */
 export default function SegmentedControl(props) {
     const { t } = useTranslation();
-    const { options = [], value = options[0]?.key, onChange = (_v) => { }, className = '', size = 48, shape = 'pill', useBG = true, fullWidth = false, ariaLabel, } = props || {};
+    const { options = [], 
+    // 안 주면 **켜진** 첫 칸 — 꺼진 첫 칸이 골라져 있었다(Tabs 와 같게)
+    value = options.find((o) => !o.disabled)?.key ?? options[0]?.key, onChange = (_v) => { }, className = '', size = 48, shape = 'pill', useBG = true, fullWidth = false, ariaLabel, } = props || {};
     /* **라디오 무리는 Tab 자리 하나 + 화살표**가 ARIA 규칙이다.
        `role="radiogroup"`·`role="radio"` 만 붙여 놓고 키를 안 만들면 **안 붙인 것보다
        나쁘다** — 낭독기가 "라디오 그룹, 3 중 2" 라고 읽어 주니 사람은 화살표를 누르는데

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

@@ -63,7 +63,7 @@ export default function SideNav(props) {
     const handleModeSwitch = useCallback(() => onAppModeChange?.(isManager ? 'malgwi' : 'manager'), [onAppModeChange, isManager]);
     return (_jsxs("nav", { "aria-label": t('nav.mainMenu', '메인 메뉴'), className: "side-nav__menu", children: [_jsxs("div", { className: "side-nav__menu-list", children: [(items || [])
                         .filter((it) => !it.section && (it.key || it.label))
-                        .map((it, idx) => (_jsxs(React.Fragment, { children: [it.divider && _jsx("div", { className: "side-nav__separator" }), _jsx(SideNavButton, { item: it, active: it.key === activeKey, state: it.disabled ? 'disabled' : undefined, onClick: (_key, btnEl, fromPointer) => {
+                        .map((it, idx) => (_jsxs(React.Fragment, { children: [it.divider && _jsx("div", { className: "side-nav__separator" }), _jsx(SideNavButton, { item: it, active: !!it.key && it.key === activeKey, state: it.disabled ? 'disabled' : undefined, onClick: (_key, btnEl, fromPointer) => {
                                     if (it.disabled)
                                         return;
                                     if (it.href) {

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

@@ -19,7 +19,11 @@ export default function TopBanner({ children, interval = 5000, dotTone, classNam
     const slides = Children.toArray(children);
     const count = slides.length;
     const [index, setIndex] = useState(0);
-    const [paused, setPaused] = useState(false);
+    /* 마우스 머무름과 포커스를 따로 든다 — 한 값으로 들면 포커스가 든 채 마우스가 스치고 나가면 멈춤이 풀려 포커스가 든 장이 넘어가
+       inert 가 되고 포커스가 body 로 떨어졌다(반대로 마우스 아래에서 포커스만 나가도 넘어갔다) */
+    const [hovered, setHovered] = useState(false);
+    const [focused, setFocused] = useState(false);
+    const paused = hovered || focused;
     // 슬라이드 수가 줄어도 범위를 벗어나지 않도록
     const current = count > 0 ? index % count : 0;
     useEffect(() => {
@@ -30,7 +34,8 @@ export default function TopBanner({ children, interval = 5000, dotTone, classNam
     }, [count, interval, paused]);
     if (count === 0)
         return null;
-    return (_jsxs("section", { className: cx('top-banner', className), "aria-label": ariaLabel, "aria-roledescription": "carousel", onMouseEnter: () => setPaused(true), onMouseLeave: () => setPaused(false), onFocus: () => setPaused(true), onBlur: () => setPaused(false), children: [_jsx("div", { className: "top-banner__viewport", children: _jsx("div", { className: "top-banner__track", style: { transform: `translateX(-${current * 100}%)` }, children: slides.map((slide, i) => (_jsx("div", { className: "top-banner__slide", "aria-hidden": i !== current, ...(i !== current ? { inert: true } : {}), children: slide }, i))) }) }), count > 1 && (_jsx("div", { className: `top-banner__dots${(dotTone?.[current] ?? 'light') === 'dark' ? ' top-banner__dots--dark' : ''}`, children: slides.map((_, i) => (_jsx("button", { type: "button", className: `top-banner__dot${i === current ? ' top-banner__dot--active' : ''}`, "aria-label": t('topBanner.dotAriaLabel', {
+    return (_jsxs("section", { className: cx('top-banner', className), "aria-label": ariaLabel, "aria-roledescription": "carousel", onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false), onFocus: () => setFocused(true), onBlur: (e) => { if (!e.currentTarget.contains(e.relatedTarget))
+            setFocused(false); }, children: [_jsx("div", { className: "top-banner__viewport", children: _jsx("div", { className: "top-banner__track", style: { transform: `translateX(-${current * 100}%)` }, children: slides.map((slide, i) => (_jsx("div", { className: "top-banner__slide", "aria-hidden": i !== current, ...(i !== current ? { inert: true } : {}), children: slide }, i))) }) }), count > 1 && (_jsx("div", { className: `top-banner__dots${(dotTone?.[current] ?? 'light') === 'dark' ? ' top-banner__dots--dark' : ''}`, children: slides.map((_, i) => (_jsx("button", { type: "button", className: `top-banner__dot${i === current ? ' top-banner__dot--active' : ''}`, "aria-label": t('topBanner.dotAriaLabel', {
                         count, index: i + 1, defaultValue: `${count}개 중 ${i + 1}번째 배너`,
                     }), "aria-current": i === current, onClick: () => setIndex(i) }, i))) }))] }));
 }

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

@@ -51,13 +51,13 @@ export default function WordTablePopup({ items, words, title, subtitle, emptyTex
        새 함수 → 알림 이 끝없이 돈다. 부모가 어떻게 짜든 안 돌게 한다. */
     const notifyRef = useRef(onScoreChange);
     useEffect(() => { notifyRef.current = onScoreChange; });
-    // 처음 열 때는 알리지 않는다 — 아무것도 안 매겼는데 onScoreChange({}) 가 나갔다
-    const 첫알림Ref = useRef(true);
+    /* 매긴 것이 **바뀌었을 때만** 알린다 — 처음 열 때 onScoreChange({}) 가 나갔다. '첫 실행 건너뛰기' 는 StrictMode 의 두 번째 실행에서
+       새어 이전 값과 견준다. */
+    const 알린marksRef = useRef(marks);
     useEffect(() => {
-        if (첫알림Ref.current) {
-            첫알림Ref.current = false;
+        if (알린marksRef.current === marks)
             return;
-        }
+        알린marksRef.current = marks;
         notifyRef.current?.(marksForSave(marks));
     }, [marks]);
     /* 표에는 지운 칸(null)이 빠진 것만 넘긴다 — 표는 "매겨진 것"만 알면 된다. */

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

@@ -240,6 +240,9 @@ export function useNoiseFade({ noisePlayer, audioRef, playbackStateRef, }) {
             ? { enabled: noisePlayer.settings.enabled, volume: noiseVolume, type: noisePlayer.settings.type }
             : null;
     }, [noisePlayer, noisePlayer?.settings.enabled, noiseVolume, noisePlayer?.settings.type]);
+    /* 새 소음 파일의 canplay 를 기다리는 핸들러 — 다음 종류 변경·떠날 때 뗀다(옛 파일 기다림이 새 설정 위에서 울리지 않게) */
+    const canplay떼기Ref = useRef(null);
+    useEffect(() => () => { canplay떼기Ref.current?.(); canplay떼기Ref.current = null; }, []);
     // 소음 설정 변경 → 오디오 반영
     useEffect(() => {
         const ns = noisePlayer?.settings;
@@ -267,14 +270,23 @@ export function useNoiseFade({ noisePlayer, audioRef, playbackStateRef, }) {
                     noiseEl.load();
                     const mainAudio = audioRef.current;
                     if (mainAudio && !mainAudio.paused) {
-                        noiseEl.addEventListener('canplay', function h() {
+                        canplay떼기Ref.current?.();
+                        const h = () => {
                             noiseEl.removeEventListener('canplay', h);
+                            if (canplay떼기Ref.current === 떼기)
+                                canplay떼기Ref.current = null;
                             // 파일 로드가 끝난 "이 시점"에 메인이 여전히 재생 중인지 재확인 —
                             // 로드가 느리면 예약 시점과 실행 시점 사이에 메인이 끝났을 수 있다.
+                            /* 볼륨·켜짐은 **지금** 설정으로 — 효과 때 붙잡은 값으로 켜면, 불러오는 동안 치료사가 비율을 0.3 으로 내렸거나 소음을
+                               껐어도 canplay 에서 1 로 다시 켜져 끝까지 났다(난이도가 뜻보다 어려워지고 기록과 들린 소리가 어긋남). */
                             const cur = audioRef.current;
-                            if (cur && !cur.paused && !cur.ended)
-                                fadeInNoise(volume);
-                        });
+                            const 지금 = noiseSettingsRef.current;
+                            if (cur && !cur.paused && !cur.ended && 지금?.enabled && 지금.volume > 0)
+                                fadeInNoise(지금.volume);
+                        };
+                        const 떼기 = () => noiseEl.removeEventListener('canplay', h);
+                        canplay떼기Ref.current = 떼기;
+                        noiseEl.addEventListener('canplay', h);
                     }
                 });
             }
@@ -286,8 +298,14 @@ export function useNoiseFade({ noisePlayer, audioRef, playbackStateRef, }) {
             // — 그때 noiseEl이 아직(레이스 등으로) paused가 아니면 볼륨만 올려버려 소음이 계속
             // 나오는 버그가 있었다. 메인이 재생 중이 아니면 무조건 정지시킨다.
             const mainAudio = audioRef.current;
-            const mainPlaying = !!mainAudio && !mainAudio.paused && !mainAudio.ended;
-            if (mainPlaying && noiseEl.paused && noiseEl.src) {
+            // speechSynthesis TTS 경로는 메인 <audio> 없이 재생된다 — 감시 타이머처럼 playbackState 도 본다(안 보면 비율만 바꿔도 소음이 멈췄다)
+            const mainPlaying = (!!mainAudio && !mainAudio.paused && !mainAudio.ended) || playbackStateRef.current === 'playing';
+            if (mainPlaying && pendingNoiseUrlRef.current) {
+                /* 종류를 바꾼 뒤 150ms 페이드아웃 안에 다른 설정을 바꾸면, 아래 볼륨만 옮기는 갈래가 파일을 바꿀 페이드를 지워 화면의 종류와
+                   들리는 종류가 문장 끝까지 달랐다 — 기다리는 파일이 있으면 fadeInNoise 가 그것을 끼운다. */
+                fadeInNoise(volume);
+            }
+            else if (mainPlaying && noiseEl.paused && noiseEl.src) {
                 fadeInNoise(volume);
             }
             else if (!noiseEl.paused) {
@@ -315,7 +333,7 @@ export function useNoiseFade({ noisePlayer, audioRef, playbackStateRef, }) {
                 }
             }
         }
-    }, [noisePlayer?.settings, noisePlayer?.settings.enabled, noiseVolume, noisePlayer?.settings.type, cancelNoiseFade, fadeInNoise, fadeOutNoise, audioRef]);
+    }, [noisePlayer?.settings, noisePlayer?.settings.enabled, noiseVolume, noisePlayer?.settings.type, cancelNoiseFade, fadeInNoise, fadeOutNoise, audioRef, playbackStateRef, noiseSettingsRef]);
     // 소음 재생 속도(playbackRate) 반영 — 0.75~1.25. 엘리먼트 속성이라 src 변경에도 유지됨
     useEffect(() => {
         const el = noiseAudioRef.current;

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

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

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

@@ -23,6 +23,28 @@ import { useWordTablePrint } from './useWordTablePrint';
 import { CELL_COUNTS, ITEMS_PER_PAGE_OPTIONS } from './wordTableBlockTypes';
 // ── 컴포넌트 ───────────────────────────────────────────────
 /** @public */
+/** 편집 칸의 낱말 → 저장 항목의 낱말. 편집 칸에서 보이던 구어체 발음·등급·품사·유형을 그대로 옮긴다. */
+function 항목낱말(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) {
+    return entries.map(e => (e.homonum != null ? `${e.word}#${e.homonum}` : e.word)).join('|');
+}
+/** 표 안에서 같은 낱말을 두 칸에 넣었을 때도 id 가 겹치지 않게 뒤에 ~2, ~3 을 붙인다 */
+function 겹치지않는id(list) {
+    const 쓴 = new Set();
+    return list.map(it => {
+        let id = it.id;
+        for (let n = 2; 쓴.has(id); n++)
+            id = `${it.id}~${n}`;
+        쓴.add(id);
+        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 }) {
     const { t } = useTranslation();
     const resolvedResetLabel = resetLabel ?? t('wordPrint.clearAllSelection', '모두 선택 해제');
@@ -53,6 +75,7 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
     const [cells, setCells] = useState(Array(4).fill(null));
     const [cellCount, setCellCount] = useState(4);
     const [activeCell, setActiveCell] = useState(null);
+    const visibleCells = cells.slice(0, cellCount);
     // 공통 단어 표 설정 상태
     const [orientation, setOrientation] = useState('landscape');
     const [contentTypes, setContentTypes] = useState(['이미지', '단어', '표준 발음']);
@@ -104,7 +127,7 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
     const pages = pagesEnabled ? chunkItems(items ?? [], itemsPerPage) : null;
     const isPaginated = !!pages && pages.length > 1;
     const hasPairs = isEditable
-        ? cells.some(c => c !== null && c.length > 1)
+        ? visibleCells.some(c => c !== null && c.length > 1)
         : (items ?? []).some(item => item.words.length > 1);
     // PDF로 저장할 때 OS가 제안하는 기본 파일명. 저장된 표 이름이 있으면 그대로, 없으면 "오늘 날짜 + 단어표/대립쌍표"
     const printFileName = tableName?.trim()
@@ -118,13 +141,11 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
         onPopupBlocked: () => { showWarning(t('wordTable.popupBlocked', '팝업이 차단되었습니다. 브라우저 설정에서 팝업을 허용해 주세요.')); },
     });
     // 편집 모드 핸들러
+    /* 칸 수를 줄여도 뒤 칸의 낱말은 버리지 않고 들고 있는다 — 4칸→2칸→4칸에 셋째·넷째 낱말이 조용히 사라졌다.
+       보이는(저장되는) 것은 앞의 cellCount 칸뿐이다. */
     const handleCellCountChange = (next) => {
         setCellCount(next);
-        setCells(prev => {
-            const arr = Array(next).fill(null);
-            prev.slice(0, next).forEach((v, i) => { arr[i] = v; });
-            return arr;
-        });
+        setCells(prev => prev.length >= next ? prev : [...prev, ...Array(next - prev.length).fill(null)]);
         setActiveCell(null);
     };
     const handleRemove = (idx) => {
@@ -136,12 +157,13 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
         if (activeCell === null)
             return;
         const idx = activeCell;
-        setCells(prev => { const next = [...prev]; next[idx] = entries; return next; });
-        const nextEmpty = cells.findIndex((c, i) => i > idx && c === null);
+        // 빈 배열로 확인하면 비운 칸으로 둔다 — [] 를 담으면 저장 항목을 만들 때 c[0].word 에서 던졌다
+        setCells(prev => { const next = [...prev]; next[idx] = entries.length > 0 ? entries : null; return next; });
+        const nextEmpty = visibleCells.findIndex((c, i) => i > idx && c === null);
         setActiveCell(nextEmpty !== -1 ? nextEmpty : null);
     };
     const hasColloquial = isEditable
-        ? cells.some(c => c?.some(e => !!e.colloquialPronunciation))
+        ? visibleCells.some(c => c?.some(e => !!e.colloquialPronunciation))
         : (items ?? []).some(item => item.words.some(w => !!w.colloquialLabel));
     // 표에 실제로 이미지가 있는지 — resolver(word)는 존재 여부와 무관하게 항상 URL을 만들어 반환하므로
     // 그 truthiness만으로는 판정할 수 없다(항상 true가 되어 이미지 없는 표에서도 '이미지' 토글이
@@ -153,9 +175,9 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
         if (!getImageResolver())
             return [];
         return isEditable
-            ? cells.flatMap(c => (c ?? []).map(e => [e.word, e.homonum]))
+            ? cells.slice(0, cellCount).flatMap(c => (c ?? []).map(e => [e.word, e.homonum]))
             : (items ?? []).flatMap(item => item.words.map(w => [w.label, w.homonum]));
-    }, [isEditable, cells, items]);
+    }, [isEditable, cells, cellCount, items]);
     /* 실제로 파일이 있는지는 물어봐야 안다(HEAD 요청 + 캐시). 그 답만 상태로 든다.
        `imagePairs` 가 비면 물어볼 것도 없으므로 아래 유도에서 곧바로 false 가 된다. */
     const [imageFound, setImageFound] = useState(false);
@@ -179,7 +201,7 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
         ...(isPaginated ? [buildPageNumberSection(t)] : []),
     ], [t, isEditable, showCellCount, pagesEnabled, items?.length, hasPairs, itemCount, isPaginated]);
     const middleSelected = {
-        ...((isEditable || showCellCount) ? { [t('wordTable.filter.columns', '칸 수')]: `${isEditable ? cellCount : displayCellCount}칸` } : {}),
+        ...((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] } : {}),
     };
@@ -187,8 +209,9 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
         if (sectionLabel === t('wordTable.filter.columns', '칸 수')) {
             if (isEditable)
                 handleCellCountChange(parseInt(value));
+            // 항목 수보다 적게는 못 줄인다(그리드는 항목 수만큼 그린다) — 고른 값을 그대로 담으면 켜진 칸 수와 보이는 표가 달랐다
             else
-                setDisplayCellCount(parseInt(value));
+                setDisplayCellCount(Math.max(parseInt(value), items?.length ?? 1));
         }
         else if (sectionLabel === t(hasPairs ? 'wordTable.filter.itemsPerPagePair' : 'wordTable.filter.itemsPerPageWord')) {
             /* 목록에 없는 개수(= 그때의 '전체' 칸)를 고르면 **전체** 로 기억한다 — 숫자로 담으면 항목이 늘었을 때 고른 값('10개')이
@@ -202,10 +225,10 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
     };
     // 저장 팝업용 현재 items / preview
     const saveItems = isEditable
-        ? cells.filter((c) => c !== null).map(c => ({
-            id: c[0].word,
-            words: c.map(e => ({ label: e.word, subLabel: e.pronunciation, homonum: e.homonum })),
-        }))
+        ? 겹치지않는id(visibleCells.filter((c) => c !== null && c.length > 0).map(c => ({
+            id: 항목id(c),
+            words: c.map(항목낱말),
+        })))
         : items ?? [];
     const handleSave = (asNew = false) => {
         setSaveAsNew(asNew);
@@ -279,10 +302,12 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
                             if (onAddItem) {
                                 const entry = entries[0];
                                 if (entry) {
-                                    onAddItem({
-                                        id: entry.word,
-                                        words: [{ label: entry.word, subLabel: entry.pronunciation, homonum: entry.homonum }],
-                                    });
+                                    // 이미 있는 항목과 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)] });
                                 }
                             }
                             setActiveCell(null);
@@ -291,7 +316,7 @@ 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 ? cells : 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)), 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', '이 단어표에 대한 제목을 입력하세요.'), 
                                     /* PanelRow의 라벨은 시각적으로만 붙어 있고 입력과 연결돼 있지 않아, 낭독기에는
                                        이름 없는 입력으로 읽혔다. placeholder는 자동완성 안내문("Tab 또는 space…")이
                                        섞여 있어 이름으로 부적절하므로 같은 라벨 문구를 넘긴다. */

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

@@ -15,7 +15,8 @@ export interface UseWordTablePrintOptions {
 }
 /** @public */
 export interface UseWordTablePrintResult {
-    /** 화면 밖 iframe에서 격리 인쇄(전역 print CSS·팝업 차단 무관). */
+    /** 화면 밖 iframe에서 격리 인쇄(전역 print CSS·팝업 차단 무관). 인쇄가 진행 중이면(10초 한도) 다시 불러도 받지 않는다.
+     *  세 동작 모두 문서는 늘 light 테마(종이가 흰색). */
     print: () => void;
     /** 새 탭에 단어표를 열어 사용자가 직접 인쇄/저장하게 한다. */
     openNewWindow: () => void;