@ihabdevteam/core 0.146.0 → 0.147.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.147.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;

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/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/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;

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

@@ -105,7 +105,14 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
            아무도 opacity 를 되돌리지 않아 **빈칸으로 인쇄**되고, 새 창·내려받은 HTML 에서는 스피너가 영영 돈다(말귀 내 단어표
            '인쇄' 는 열자마자 100ms 뒤 인쇄해 처음 보는 표는 거의 늘 이랬다). */
         clone.querySelectorAll('.word-table-cell__spinner').forEach(s => s.remove());
-        clone.querySelectorAll('img').forEach(i => i.style.removeProperty('opacity'));
+        /* 불러오는 중이던 그림은 opacity 를 **그대로 두고** 받아지면 보이고 실패하면 숨게 한다 — 지우기만 하면 없는 그림(404, 화면에서는
+           onError 로 칸이 사라짐)이 인쇄 문서에서 깨진 그림 아이콘과 alt 글자로 찍혔다. autoPrint 는 그림 로드를 기다린 뒤 인쇄한다. */
+        clone.querySelectorAll('img').forEach(i => {
+            if (i.style.opacity !== '0')
+                return;
+            i.setAttribute('onload', "this.style.opacity=''");
+            i.setAttribute('onerror', "this.style.visibility='hidden'");
+        });
         return `<div class="paper-wrap">${headHtml}${clone.outerHTML}</div>`;
     }).join('\n');
     /* 이 꾸러미의 CSS 는 전부 `.ihabdevteam-core-scope` **아래**에 산다(styles.css 스코핑).

package/dist/packages/core/src/hooks/useDailyTrainingSelection.js

@@ -45,6 +45,8 @@ export function useDailyTrainingSelection(userId) {
     }, []);
     useEffect(() => {
         let cancelled = false;
+        let 떠남 = false;
+        let 적용됨 = false;
         let timer;
         let attempts = 0;
         const MAX_ATTEMPTS = 40; // 250ms * 40 = 10초 후 폴링 중단(풀이 영영 비는 경우 무한루프 방지)
@@ -60,6 +62,9 @@ export function useDailyTrainingSelection(userId) {
         }
         catch { }
         const apply = (sel) => {
+            if (떠남)
+                return;
+            적용됨 = true;
             todayRef.current = sel.today;
             yesterdayRef.current = sel.yesterday;
             setLoaded(true);
@@ -79,13 +84,16 @@ export function useDailyTrainingSelection(userId) {
                     return;
                 }
             }
-            // 캐시 miss → 데이터 로드 후 새 선택
-            try {
-                await ensureTrainingDataLoaded(3000);
+            /* 캐시 miss → 데이터 로드 후 새 선택. 로드는 **2초마다 한 번만** 다시 청한다 — 250ms 마다 부르면 받기가 곧바로 실패하는
+               배포(형식 오류)에서 10초에 850KB 자료를 40번 받았다. 그 사이 폴링은 선택만 다시 계산한다. */
+            if (attempts % 8 === 0) {
+                try {
+                    await ensureTrainingDataLoaded(3000);
+                }
+                catch { }
+                if (cancelled)
+                    return;
             }
-            catch { }
-            if (cancelled)
-                return;
             const sel = resolveSelection(forceRefresh, undefined, userId);
             if (hasItems(sel.today)) {
                 apply(sel);
@@ -101,9 +109,29 @@ export function useDailyTrainingSelection(userId) {
                 stop();
             }
         };
+        /* 포기한 뒤(10초)라도 자료가 도착하면 다시 계산한다 — 느린 회선에서 13초 걸려 받은 회원은 새로고침 전까지 "자료를 못 찾음" 에 남았다 */
+        const 자료도착 = () => {
+            if (떠남 || 적용됨)
+                return;
+            const sel = resolveSelection(forceRefresh, undefined, userId);
+            if (hasItems(sel.today))
+                apply(sel);
+        };
+        try {
+            window.addEventListener('speechear.data.updated', 자료도착);
+        }
+        catch { }
         tryFill();
         timer = setInterval(tryFill, 250);
-        return () => { cancelled = true; stop(); };
+        return () => {
+            cancelled = true;
+            떠남 = true;
+            stop();
+            try {
+                window.removeEventListener('speechear.data.updated', 자료도착);
+            }
+            catch { }
+        };
         // 오늘 은 날짜가 바뀌었다는 신호 — resolveSelection 이 안에서 오늘 날짜를 읽는다
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [userId, 오늘]);

package/dist/packages/core/src/hooks/useTrainingSessionLog.d.ts

@@ -1,6 +1,9 @@
 /**
- * 훈련 팝업 마운트~언마운트 시간을 기록합니다.
- * 5초 미만 세션(잘못 열었다 닫은 경우)은 무시합니다.
+ * 훈련 팝업을 **보고 있던** 시간을 기록합니다.
+ * 보인 시간이 5초 미만(잘못 열었다 닫은 경우)이면 무시합니다.
+ *
+ * 한 팝업에 **한 줄** 만 보냅니다 — 떠날 때, 또는 페이지가 내려갈 때(pagehide: 팝업을 연 채 탭·앱을 닫음). 화면이 가려진
+ * 동안(탭 전환·앱 백그라운드)의 시간은 빼고 모읍니다 — 전에는 연 채 3시간 잠가 둔 시간이 훈련 시간으로 적혔다.
  *
  * @public
  */

package/dist/packages/core/src/hooks/useTrainingSessionLog.js

@@ -2,8 +2,11 @@
 import { useEffect } from 'react';
 import { logTrainingTime } from '../utils/trainingLogger';
 /**
- * 훈련 팝업 마운트~언마운트 시간을 기록합니다.
- * 5초 미만 세션(잘못 열었다 닫은 경우)은 무시합니다.
+ * 훈련 팝업을 **보고 있던** 시간을 기록합니다.
+ * 보인 시간이 5초 미만(잘못 열었다 닫은 경우)이면 무시합니다.
+ *
+ * 한 팝업에 **한 줄** 만 보냅니다 — 떠날 때, 또는 페이지가 내려갈 때(pagehide: 팝업을 연 채 탭·앱을 닫음). 화면이 가려진
+ * 동안(탭 전환·앱 백그라운드)의 시간은 빼고 모읍니다 — 전에는 연 채 3시간 잠가 둔 시간이 훈련 시간으로 적혔다.
  *
  * @public
  */
@@ -11,16 +14,50 @@ export default function useTrainingSessionLog(trainingType) {
     useEffect(() => {
         if (!trainingType)
             return; // 타입 미상이면 기록하지 않음
-        const startedAt = new Date();
-        return () => {
-            const endedAt = new Date();
-            if (endedAt.getTime() - startedAt.getTime() < 5000)
+        /* **한 팝업 = 한 줄.** 보이는 구간마다 따로 보내면 서버가 줄 수를 세션 수로 세어(v_user_training_time_stats) 탭을 오갈 때마다
+           문장 훈련 횟수가 늘었다. 보이던 시간만 모아 두었다가 떠날 때(또는 페이지가 내려갈 때) 한 번 보낸다 — 끝 시각은 처음 보인 때 + 보인 시간. */
+        const 보임 = () => typeof document === 'undefined' || document.visibilityState !== 'hidden';
+        let 처음보임 = null;
+        let 구간시작 = null;
+        let 모은ms = 0;
+        let 보냄 = false;
+        const 구간열기 = () => { const t = Date.now(); if (처음보임 == null)
+            처음보임 = t; if (구간시작 == null)
+            구간시작 = t; };
+        const 구간닫기 = () => { if (구간시작 != null) {
+            모은ms += Date.now() - 구간시작;
+            구간시작 = null;
+        } };
+        if (보임())
+            구간열기();
+        const 보내기 = () => {
+            if (보냄)
+                return;
+            구간닫기();
+            if (처음보임 == null || 모은ms < 5000)
                 return;
+            보냄 = true;
             logTrainingTime({
                 trainingType,
-                startedAt: startedAt.toISOString(),
-                endedAt: endedAt.toISOString(),
+                startedAt: new Date(처음보임).toISOString(),
+                endedAt: new Date(처음보임 + 모은ms).toISOString(),
             });
         };
+        const 보임바뀜 = () => { if (보임())
+            구간열기();
+        else
+            구간닫기(); };
+        if (typeof document !== 'undefined')
+            document.addEventListener('visibilitychange', 보임바뀜);
+        // 페이지가 내려가면(탭·앱 닫기) React 정리가 안 돈다 — 그때 보낸다
+        if (typeof window !== 'undefined')
+            window.addEventListener('pagehide', 보내기);
+        return () => {
+            if (typeof document !== 'undefined')
+                document.removeEventListener('visibilitychange', 보임바뀜);
+            if (typeof window !== 'undefined')
+                window.removeEventListener('pagehide', 보내기);
+            보내기();
+        };
     }, [trainingType]);
 }

package/dist/packages/core/src/hooks/useWordMeanings.js

@@ -26,6 +26,10 @@ const memCache = new Map();
 /* 받아 봤는데 뜻이 없던 열쇠 — 다시 묻지 않는다. 전에는 뜻 없는 낱말이 캐시에 안 남아 표를 다시 정렬하거나 쪽을
    넘길 때마다 같은 낱말을 또 조회했다. (조회가 실패한 것은 여기 넣지 않는다 — 다음에 다시 받는다.) */
 const noMeaning = new Set();
+/* 빈 응답(한 줄도 못 받음)으로 '뜻 없음' 이 된 열쇠와 그 때 — 조회 함수는 실패도 빈 배열로 돌려주므로 영영 굳히지 않고, 사용자 추가
+   낱말처럼 정말 뜻이 없는 쪽을 오갈 때마다 다시 묻지도 않게 **잠시만**(1분) 묻지 않는다. */
+const 빈응답때 = new Map();
+const 빈응답유예ms = 60_000;
 export function useWordMeanings(rows, fetchMeanings) {
     /* 캐시는 모듈 스코프 Map 이라 갱신이 렌더에 자동 반영되지 않는다 — 조회가 끝나면 이 값을
        올려 아래 스냅샷을 다시 계산시킨다(캐시 히트만으로 리렌더가 연쇄되지 않도록 분리). */
@@ -35,7 +39,8 @@ export function useWordMeanings(rows, fetchMeanings) {
     const wantedKey = Array.from(new Set(rows.map(r => meaningKey(r.word, r.homonum)))).sort().join('|');
     useEffect(() => {
         const wanted = wantedKey ? wantedKey.split('|') : [];
-        const missing = wanted.filter(k => !memCache.has(k) && !noMeaning.has(k));
+        const 지금 = Date.now();
+        const missing = wanted.filter(k => !memCache.has(k) && !noMeaning.has(k) && !(지금 - (빈응답때.get(k) ?? -Infinity) < 빈응답유예ms));
         if (missing.length === 0)
             return; // 전부 캐시에 있음 — 네트워크·상태 갱신 불필요
         let cancelled = false;
@@ -50,9 +55,15 @@ export function useWordMeanings(rows, fetchMeanings) {
             /* 한 줄도 못 받았으면 '뜻 없음' 으로 굳히지 않는다 — 조회 함수는 실패를 빈 배열로 돌려주는 약속이라, 잠깐 끊긴 망이
                그 쪽 낱말들을 새로고침 전까지 '뜻 없음' 으로 묶었다. 받은 게 있으면 그 응답에 빠진 낱말만 없는 것으로 본다. */
             if (got.length > 0)
-                for (const k of missing)
+                for (const k of missing) {
                     if (!memCache.has(k))
                         noMeaning.add(k);
+                }
+            else {
+                const t = Date.now();
+                for (const k of missing)
+                    빈응답때.set(k, t);
+            }
             if (cancelled || got.length === 0)
                 return;
             setFetched(v => v + 1);

package/dist/packages/core/src/utils/getTrainingData.d.ts

@@ -56,7 +56,11 @@ export declare function getTrainingPools(): Record<string, unknown[]>;
 export declare function loadTrainingData(): Promise<void>;
 /** @public */
 export declare function isTrainingDataLoaded(): boolean;
-export declare function ensureTrainingDataLoaded(timeout?: number): Promise<unknown>;
+/**
+ * 자료를 받게 하고 **받았는지** 를 돌려준다(시간 초과·실패는 false). 전에는 성공·3초 초과·실패가 모두 undefined 로 끝나
+ * 부르는 쪽이 빈 풀로 계획을 만들고도 알 길이 없었다. 늦게 도착하면 'speechear.data.updated' 가 온다.
+ */
+export declare function ensureTrainingDataLoaded(timeout?: number): Promise<boolean>;
 declare const _default: {
     NOISE_DATAS: unknown[];
     SHORT_STORIES: unknown[];

package/dist/packages/core/src/utils/getTrainingData.js

@@ -111,6 +111,9 @@ export async function loadTrainingData() {
             for (const key of Object.keys(map || {})) {
                 const groups = map[key] || [];
                 for (const g of groups) {
+                    // 한 행이 null·글자면 건너뛴다 — 그 한 행의 TypeError 로 자료 전체를 버리고 매번 같은 실패를 되풀이했다
+                    if (!g || typeof g !== 'object')
+                        continue;
                     const gr = g;
                     const t = String(gr.training_type || key);
                     const cat0 = String(gr.category_main_code || gr.category_main || gr.category_0 || '');
@@ -149,22 +152,35 @@ export async function loadTrainingData() {
         SHORT_STORIES.push(...받음.short);
         LONG_STORIES.push(...받음.long);
         ORDER_SETS.push(...받음.order);
+        // 다 채운 뒤 _loaded 를 먼저 세운다 — 'updated' 를 받은 쪽이 isTrainingDataLoaded() 로 확인하면 아직 false 였다
+        _loaded = true;
         try {
-            window.dispatchEvent(new Event('speechear.data.updated'));
+            computeDailySelection();
         }
         catch (e) { }
         try {
-            computeDailySelection();
+            window.dispatchEvent(new Event('speechear.data.updated'));
         }
         catch (e) { }
-        _loaded = true;
     })();
     return _loading;
 }
 /** @public */
 export function isTrainingDataLoaded() { return _loaded; }
+/**
+ * 자료를 받게 하고 **받았는지** 를 돌려준다(시간 초과·실패는 false). 전에는 성공·3초 초과·실패가 모두 undefined 로 끝나
+ * 부르는 쪽이 빈 풀로 계획을 만들고도 알 길이 없었다. 늦게 도착하면 'speechear.data.updated' 가 온다.
+ */
 export async function ensureTrainingDataLoaded(timeout = 3000) {
     const p = loadTrainingData();
-    return Promise.race([p, new Promise((res) => setTimeout(res, timeout))]);
+    let t;
+    try {
+        await Promise.race([p, new Promise((res) => { t = setTimeout(res, timeout); })]);
+    }
+    finally {
+        if (t !== undefined)
+            clearTimeout(t);
+    }
+    return _loaded;
 }
 export default { NOISE_DATAS, SHORT_STORIES, LONG_STORIES, ORDER_SETS, loadTrainingData, ensureTrainingDataLoaded };

package/dist/packages/core/src/utils/planFeatures.d.ts

@@ -58,4 +58,4 @@ export interface PlanLimits {
 /** @public 요금제 티어별 제한 (표시되지 않는 레거시 티어는 생략) */
 export declare const PLAN_LIMITS: Partial<Record<PlanTier, PlanLimits>>;
 /** product code → 요금제 티어 */
-export declare function getPlanTier(productCode: string): PlanTier;
+export declare function getPlanTier(productCode: string | null | undefined): PlanTier;

package/dist/packages/core/src/utils/planFeatures.js

@@ -145,7 +145,13 @@ export const PLAN_LIMITS = {
 };
 /** product code → 요금제 티어 */
 export function getPlanTier(productCode) {
-    const c = productCode.toLowerCase();
+    const c = (productCode ?? '').toLowerCase();
+    /* 무료 코드는 접두사 규칙보다 먼저 — 'speechear_free' 가 아래 speechear_ 규칙에 걸려 유료 개인 스탠다드로 올라갔고,
+       'manager_free' 는 규칙이 없어 none 이었다(어드민 요금제 PLANS 의 plan_id). null 코드는 던지지 않고 none. */
+    if (c === 'speechear_free' || c === 'free')
+        return 'free';
+    if (c.startsWith('manager_free') || c.startsWith('mgr_free'))
+        return 'mgr_free';
     if (c.startsWith('manager_enterprise'))
         return 'enterprise';
     if (c.startsWith('manager_pro'))