@ihabdevteam/core 0.142.0 → 0.144.0

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

@@ -11,7 +11,8 @@ import Dropdown from '../Dropdown';
 import Pagination from '../Pagination';
 import WordImageTooltip from '../Tooltip/WordImageTooltip';
 import { useHoverAnchor } from '../../hooks/useHoverAnchor';
-import { matchesWordQuery } from '../../utils/koreanSyllable';
+import { makeWordQueryMatcher } from '../../utils/koreanSyllable';
+const 가나다 = new Intl.Collator('ko');
 import { withIga, withEulReul } from '../../utils/josa';
 /** @public */
 export default function WordSearchResultBlock({ titleIcon, resultCount, resultUnit, searchQuery, items, groups, selected = [], onSelect, maxSelect, onClearSelection, onPrint, onPrintEmpty, className, emptyHint, sectionType = 'page', disc, notice, }) {
@@ -61,6 +62,21 @@ export default function WordSearchResultBlock({ titleIcon, resultCount, resultUn
         value: v, label: t('wordSearch.pageSize', { count: Number(v), defaultValue: `${v}개씩 보기` }),
     })), [t]);
     const firstWord = (it) => it.words[0];
+    /* '시작 우선' 순위는 검색어가 바뀔 때 판별기를 한 번 만들고 항목마다 한 번만 센다 — 비교할 때마다 검색어를 다시 펼치고
+       localeCompare 를 불러 결과가 바뀔 때 23k 개에 38ms 걸렸다. */
+    const 시작순위 = useMemo(() => {
+        const qLen = [...q].length;
+        const m = makeWordQueryMatcher(q);
+        const memo = new Map();
+        return (it) => {
+            let r = memo.get(it);
+            if (r === undefined) {
+                r = m((it.words[0]?.label ?? '').slice(0, qLen)) ? 0 : 1;
+                memo.set(it, r);
+            }
+            return r;
+        };
+    }, [q]);
     // 정렬 비교자 — flat/그룹 뷰가 공유한다.
     const sortCompare = useCallback((a, b) => {
         const label = (it) => firstWord(it)?.label ?? '';
@@ -70,9 +86,7 @@ export default function WordSearchResultBlock({ titleIcon, resultCount, resultUn
             // 시작 우선 — 검색어로 시작하는 단어를 위로. 앞 q 글자만 잘라 매칭하면 "첫 음절부터 일치"만
             // 남는다(초성 검색도 동일: 'ㄴ' → '나무'가 위). 동순위는 가나다.
             case 'match': {
-                const qLen = [...q].length;
-                const rank = (it) => matchesWordQuery(label(it).slice(0, qLen), q) ? 0 : 1;
-                return rank(a) - rank(b) || label(a).localeCompare(label(b), 'ko');
+                return 시작순위(a) - 시작순위(b) || 가나다.compare(label(a), label(b));
             }
             case 'ganada': return label(a).localeCompare(label(b), 'ko');
             case 'ganada_desc': return label(b).localeCompare(label(a), 'ko');
@@ -82,7 +96,7 @@ export default function WordSearchResultBlock({ titleIcon, resultCount, resultUn
             case 'grade_desc': return grade(b) - grade(a) || label(a).localeCompare(label(b), 'ko');
             default: return 0;
         }
-    }, [effectiveSortKey, q]);
+    }, [effectiveSortKey, 시작순위]);
     const sortedItems = useMemo(() => items.slice().sort(sortCompare), [items, sortCompare]);
     const pageSize = Number(pageSizeStr) || 10;
     // 그룹 뷰(대립쌍표 음소대립)도 flat과 동일하게 정렬·페이지네이션한다 — 그룹 순서를 유지하고 그룹 내부를

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

@@ -166,7 +166,7 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
         Promise.all(imagePairs.map(([w, h]) => checkImageExists(w, h))).then(results => {
             if (!cancelled)
                 setImageFound(results.some(Boolean));
-        });
+        }, () => { }); // 확인이 거절돼도(리졸버 예외 등) 처리되지 않은 거절로 새지 않게 — 이미지 없음으로 둔다
         return () => { cancelled = true; };
     }, [imagePairs]);
     const hasImage = imagePairs.length > 0 && imageFound;
@@ -288,7 +288,10 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
                             setActiveCell(null);
                         },
                         onClose: handleCloseWordSearch,
-                    }), !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, 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', '이 단어표에 대한 제목을 입력하세요.'), 
+                    }), !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', '이 단어표에 대한 제목을 입력하세요.'), 
                                     /* PanelRow의 라벨은 시각적으로만 붙어 있고 입력과 연결돼 있지 않아, 낭독기에는
                                        이름 없는 입력으로 읽혔다. placeholder는 자동완성 안내문("Tab 또는 space…")이
                                        섞여 있어 이름으로 부적절하므로 같은 라벨 문구를 넘긴다. */

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

@@ -3,13 +3,13 @@ import type { WordSearchResultItem } from '../../types/wordSearch';
 import './WordTableButton.css';
 /** @public */
 export interface WordTableButtonProps {
-    /** 단어표 내용(썸네일 미리보기 + 개수) */
+    /** 단어표 내용(썸네일 미리보기) */
     items: WordSearchResultItem[];
     /** 단어표 이름 */
     name: string;
     /** 설명 — 제목 아래 body-3로 표시(있을 때만) */
     description?: string;
-    /** 생성일(ISO) — 메타(날짜)에 표시. 없으면 개수만. */
+    /** 생성일(ISO) — 메타(날짜)에 표시. */
     createdAt?: string;
     /** 스토어 발행 배지 표시 */
     published?: boolean;
@@ -43,6 +43,6 @@ export interface WordTableButtonProps {
 }
 /**
  * @public 단어표를 '문서형' 미리보기 카드로 표현하는 컴포넌트.
- * 내용 썸네일(WordTableThumbnail) + 이름 + 날짜·개수 + (발행 배지 / 더보기 / 스토어 푸터).
+ * 내용 썸네일(WordTableThumbnail) + 이름 + 날짜 + (발행 배지 / 더보기 / 스토어 푸터).
  */
 export default function WordTableButton({ items, name, description, createdAt, published, publishedLabel, shared, sharedLabel, isNew, publisherName, publishedAt, likeCount, downloadCount, onPublisherClick, selected, onClick, onMore, titleNode, className, }: WordTableButtonProps): import("react").JSX.Element;

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

@@ -9,7 +9,7 @@ import { formatRelativeTime } from '../../utils/date';
 import './WordTableButton.css';
 /**
  * @public 단어표를 '문서형' 미리보기 카드로 표현하는 컴포넌트.
- * 내용 썸네일(WordTableThumbnail) + 이름 + 날짜·개수 + (발행 배지 / 더보기 / 스토어 푸터).
+ * 내용 썸네일(WordTableThumbnail) + 이름 + 날짜 + (발행 배지 / 더보기 / 스토어 푸터).
  */
 export default function WordTableButton({ items, name, description, createdAt, published, publishedLabel, shared, sharedLabel, isNew, publisherName, publishedAt, likeCount, downloadCount, onPublisherClick, selected, onClick, onMore, titleNode, className, }) {
     const { t } = useTranslation();

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

@@ -43,7 +43,7 @@ export function useWordTableDisplaySettings(items) {
         }
         Promise.all(items.flatMap(item => item.words.map(w => checkImageExists(w.label, w.homonum))))
             .then(results => { if (!cancelled)
-            setHasImage(results.some(Boolean)); });
+            setHasImage(results.some(Boolean)); }, () => { }); // 거절은 이미지 없음으로 둔다
         return () => { cancelled = true; };
     }, [items]);
     /* eslint-enable react-hooks/set-state-in-effect */

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

@@ -23,7 +23,7 @@ export interface WordTableBlockProps {
     tableName?: string;
     /** 전달하면 외부 데이터 표시 모드, 없으면 편집 모드 */
     items?: WordSearchResultItem[];
-    /** 전달하면 저장 팝업을 내부에서 열고 확인 후 name·items·description을 전달.
+    /** 전달하면 저장하기가 저장 팝업(`renderSavePopup` 이 그림 — 없으면 아무것도 뜨지 않는다)을 열고 확인 후 name·items·description을 전달.
      *  saveAsNew=true면 '다른 이름으로 저장'(수정 대신 새 표 생성)을 뜻한다. */
     onSaveComplete?: (name: string, items: WordSearchResultItem[], description?: string, saveAsNew?: boolean) => void;
     onLoad?: () => void;
@@ -49,7 +49,7 @@ export interface WordTableBlockProps {
     editingName?: string;
     /** 지정하면 인쇄하기 왼쪽에 '취소' 버튼을 표시(PagePopup 닫기 등). */
     onCancel?: () => void;
-    /** 전달하면 카드 드래그로 순서 변경 가능 */
+    /** 전달하면 카드 드래그로 순서 변경 가능. 쪽이 나뉘면 같은 쪽 안에서만 옮기며, 자리는 전체 목록 기준이다. */
     onReorder?: (fromIndex: number, toIndex: number) => void;
     /** display 모드에서도 칸 수 조절 허용 */
     showCellCount?: boolean;

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

@@ -19,6 +19,9 @@ export function sanitizeFileName(name) {
 }
 /** 아직 되돌리지 못한 탭 제목 되돌리기(인쇄가 끝나기 전 다음 인쇄가 올 때) */
 let 제목되돌리기 = null;
+/* 진행 중인 인쇄 — 그림을 기다리는(최대 3초) 사이 다시 누르면 숨김 iframe 이 둘 생겨 인쇄 대화상자가 두 번 떴다(autoPrint 대기 중 '인쇄').
+   afterprint 가 안 오는 브라우저에서 영영 막히지 않게 10초가 지나면 새 인쇄를 받는다. */
+let 인쇄중 = null;
 /**
  * 캡처한 콘텐츠 엘리먼트들을 화면 밖 숨김 iframe에서 인쇄한다. 전역 @media print(모든
  * .word-table 노출)나 팝업 차단의 간섭 없이 넘긴 엘리먼트만 격리 인쇄한다. WordTableBlock의
@@ -28,6 +31,8 @@ let 제목되돌리기 = null;
 export function printWordTableElements(elements, paperW, paperH, fileName = '', header = '') {
     if (elements.length === 0)
         return;
+    if (인쇄중 && 인쇄중.iframe.isConnected && Date.now() - 인쇄중.at < 10_000)
+        return;
     const safeFileName = fileName ? sanitizeFileName(fileName) : '';
     // "PDF로 저장" 기본 파일명은 iframe이 아니라 최상위 탭(document)의 title에서 온다.
     /* 탭 제목은 **어느 쪽 afterprint 가 와도** 되돌린다 — 브라우저에 따라 iframe 인쇄의 print 이벤트가 그 프레임에만 가서,
@@ -55,10 +60,15 @@ export function printWordTableElements(elements, paperW, paperH, fileName = '',
         iframe.remove();
         return;
     }
+    인쇄중 = { iframe, at: Date.now() };
     doc.open();
     doc.write(captureHtml(elements, paperW, paperH, true, safeFileName, header));
     doc.close();
-    iframe.contentWindow?.addEventListener('afterprint', () => { restore?.(); setTimeout(() => iframe.remove(), 0); });
+    iframe.contentWindow?.addEventListener('afterprint', () => {
+        restore?.();
+        setTimeout(() => { iframe.remove(); if (인쇄중?.iframe === iframe)
+            인쇄중 = null; }, 0);
+    });
 }
 // 인쇄 시 PDF로 저장할 때 OS가 제안하는 기본 파일명은 문서 <title>에서 온다.
 export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '', header = '') {
@@ -71,11 +81,10 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
             return [];
         }
     }).join('\n');
-    // styles.css의 다크 테마는 <html data-theme="..."> 속성으로 켜진다. 새 문서는 이 속성이
-    // 없어 "auto"로 취급되고, OS가 다크 모드면 프로그램상 라이트 테마여도 팝업만 다크로 보였다.
-    // 속성 값을 문서 글자에 그대로 끼우므로 **아는 세 값만** — 누가 data-theme 에 `"><script>` 를 넣어도 인쇄·새 창·내려받기 문서에 새지 않게
-    const 읽은테마 = document.documentElement.getAttribute('data-theme');
-    const theme = 읽은테마 === 'dark' || 읽은테마 === 'auto' ? 읽은테마 : 'light';
+    /* 종이는 늘 흰색(#fff)이라 문서 테마는 **light 로 고정**한다. 화면의 dark 를 옮기면 낱말 색(--color-black)이 밝은 색이 되어
+       흰 종이에 흰 글자로 인쇄·새 창·내려받기가 나갔다. 속성이 없으면 "auto" 로 취급돼 OS 다크 모드에서 팝업만 어두워지던 것도
+       이것으로 막힌다. 화면 테마 값은 문서 글자에 끼우지 않는다(주입 걱정도 없다). */
+    const theme = 'light';
     /* 종이 맨 위에 찍는 한 줄(누구의·언제·무슨 표). **격자만 인쇄되므로** 이것이 없으면
        뽑아 둔 채점지가 며칠 뒤 누구 것인지 알 수 없는 종이가 된다. 쪽마다 찍는다 —
        여러 장이 섞이면 첫 장에만 있는 이름은 소용이 없다. */
@@ -92,6 +101,11 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
            복사할 때 지우면 인쇄·새 창·내려받기가 한꺼번에 맞는다. */
         clone.querySelectorAll('.word-table-cell__score-slot:not(.word-table-cell__score-slot--on)')
             .forEach(s => s.remove());
+        /* 화면에서 아직 불러오는 중인 그림은 스피너 + 인라인 opacity:0 이다 — 그대로 옮기면 인쇄 문서에서 그림이 다 받아져도
+           아무도 opacity 를 되돌리지 않아 **빈칸으로 인쇄**되고, 새 창·내려받은 HTML 에서는 스피너가 영영 돈다(말귀 내 단어표
+           '인쇄' 는 열자마자 100ms 뒤 인쇄해 처음 보는 표는 거의 늘 이랬다). */
+        clone.querySelectorAll('.word-table-cell__spinner').forEach(s => s.remove());
+        clone.querySelectorAll('img').forEach(i => i.style.removeProperty('opacity'));
         return `<div class="paper-wrap">${headHtml}${clone.outerHTML}</div>`;
     }).join('\n');
     /* 이 꾸러미의 CSS 는 전부 `.ihabdevteam-core-scope` **아래**에 산다(styles.css 스코핑).
@@ -144,11 +158,16 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
            .word-table-block__content 클론) 전부 숨겨진 채 인쇄된다. 여기서 복원한다. */
         body * { visibility: visible; }
         html, body { background: #fff; overflow: visible; padding: 0; gap: 0; }
+        /* 종이 한 장 = 한 쪽. height:100% 는 앱에 html·body 높이가 없으면 auto 로 풀려 종이가 내용만큼 커지고(2장 → 4쪽),
+           세로·머리글이면 넘친 만큼 끝에 빈 쪽이 붙었다. 뷰포트 높이로 자르고 격자는 남은 칸만 쓴다. 마지막 종이는
+           body 의 마지막 자식이 아니라(닫기 단추·script) :last-child 가 안 맞았다 — :last-of-type. (Chromium PDF 로 7가지 확인) */
         .paper-wrap {
-          box-shadow: none; border: none; transform: none !important; width: 100% !important; height: 100% !important;
+          box-shadow: none; border: none; transform: none !important; width: 100% !important; height: 100vh !important;
+          display: flex; flex-direction: column; overflow: hidden;
           page-break-after: always; break-after: page;
         }
-        .paper-wrap:last-child { page-break-after: auto; break-after: auto; }
+        .paper-wrap > .word-table-block__content { flex: 1 1 0; min-height: 0; height: auto; }
+        .paper-wrap:last-of-type { page-break-after: auto; break-after: auto; }
         .word-table-cell__play-button { display: none; }
         .new-window-close { display: none; }
       }

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

@@ -1,7 +1,3 @@
-/**
- * barChartData.ts
- * BarChart의 순수 데이터 계층 — 날짜→월/주/일 막대 데이터 집계 (React 무관).
- */
 /** 막대 하나의 데이터 — a/b 두 계열. a === -1 이면 미래(데이터 없음)로 표시하지 않음.
  *  parts: 다계열 stacked용 계열별 값(있으면 a는 합계로 사용). */
 export interface BarData {
@@ -19,7 +15,9 @@ export type MonthBarData = {
     weekly: BarData[];
     daily: BarData[];
 };
-/** 날짜별 카운트 포인트 — a/b 2계열 또는 parts(다계열 stacked, a는 합계) */
+/** 날짜별 카운트 포인트 — a/b 2계열 또는 parts(다계열 stacked, a는 합계).
+ *  `date` 는 **KST 달력 날짜를 기기 달력 자정 Date 로** 옮긴 것: 시각이면 `parseLocalYmd(toKstYmd(createdAt))`,
+ *  서버가 KST 로 집계한 'YYYY-MM-DD' 면 `parseLocalYmd(log_date)`. */
 export interface ChartPoint {
     date: Date;
     a: number;

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

@@ -1,7 +1,11 @@
 /**
  * barChartData.ts
  * BarChart의 순수 데이터 계층 — 날짜→월/주/일 막대 데이터 집계 (React 무관).
+ *
+ * **날은 KST 달력으로 센다.** 칸은 `getFullYear()/getMonth()/getDate()` 로 나누므로 '지금'도 KST 오늘을 기기 달력 Date 로
+ * 옮긴 것(`getTodayKstDate`)을 쓴다 — 전에는 기기 시각이라 해외 기기에서 오늘·이번 주·이번 달이 KST 와 하루 어긋났다.
  */
+import { getTodayKstDate } from '../utils/date';
 /** 해당 월(0-based)의 첫 월요일 날짜(1~7). 예: 2026-05(금요일 시작) → 4 */
 export function firstMondayOfMonth(year, month0) {
     const dow = new Date(year, month0, 1).getDay(); // 0=일 … 6=토
@@ -10,7 +14,7 @@ export function firstMondayOfMonth(year, month0) {
 /** 오늘이 속한 (월키, 주값) 계산 — 진입 시 기본 선택을 오늘 기준으로 맞춤.
  *  월요일 시작 버킷 기준이며, 첫 월요일 이전 날짜는 이전 달 마지막 주에 속한다. */
 export function todayWeekValue() {
-    const now = new Date();
+    const now = getTodayKstDate();
     let y = now.getFullYear(), m0 = now.getMonth(), date = now.getDate();
     if (date < firstMondayOfMonth(y, m0)) {
         const prevLast = new Date(y, m0, 0); // 이전 달 마지막 날
@@ -35,7 +39,7 @@ export function todayWeekValue() {
  * 다음 달의 오늘 뒤 날은 세지 않는다. 일별(`daily`)은 그 달 날만이다.
  */
 export function buildMonthChartData(points) {
-    const now = new Date();
+    const now = getTodayKstDate();
     const curKey = `${now.getFullYear()}년 ${now.getMonth() + 1}월`;
     const 달키 = (y, m0) => `${y}년 ${m0 + 1}월`;
     const byMonth = new Map();
@@ -142,7 +146,7 @@ export function buildMonthChartData(points) {
 }
 // 드롭다운에 노출할 월 옵션 (2024년 1월 ~ 현재, 최신순)
 function genMonthOptions() {
-    const now = new Date();
+    const now = getTodayKstDate();
     const curY = now.getFullYear();
     const curM = now.getMonth() + 1;
     const opts = [];

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

@@ -88,8 +88,21 @@ export interface BarChartProps {
     /** CSS 격자 칸 안에 세운다 — 아래 여백·최소 폭을 풀고 막대를 카드 바닥에 맞춘다. ChartSection `inGrid` 참고. */
     inGrid?: boolean;
 }
-/** 현재 컨트롤 선택(주/월)의 날짜 범위 — 상세보기(기간별 리스트)용 */
-export declare function getControlDateRange(control: BarChartControl): {
+/** @public getControlDateRange 의 결과 — 기간의 첫날 00:00 KST ~ 끝날 23:59:59.999 KST 순간과, 그 두 날의 KST 달력 날짜 */
+export interface ControlDateRange {
+    /** 첫날 00:00:00.000 KST 순간 — 서버에 물을 때 `from.toISOString()` */
     from: Date;
+    /** 끝날 23:59:59.999 KST 순간 */
     to: Date;
-};
+    /** 첫날 KST 'YYYY-MM-DD' — 이름표·달력 셈은 `parseLocalYmd(fromYmd)` 로(순간 `from` 을 기기 getter 로 읽으면 해외에서 하루 어긋난다) */
+    fromYmd: string;
+    /** 끝날 KST 'YYYY-MM-DD' */
+    toYmd: string;
+}
+/**
+ * 현재 컨트롤 선택(주/월)의 기간 — 상세보기(기간별 리스트)용. **KST 의 날로 자른다**(해외 기기도 같은 기간).
+ *
+ * @param offset 몇 기간 앞·뒤인가 — `-1` 이면 앞 달 한 달(달력 달 그대로, 30일 앞이 아니다) · 앞 주 한 주.
+ * @public
+ */
+export declare function getControlDateRange(control: BarChartControl, offset?: number): ControlDateRange;

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

@@ -1,23 +1,37 @@
 import { firstMondayOfMonth } from './barChartData';
-/** 현재 컨트롤 선택(주/월)의 날짜 범위 — 상세보기(기간별 리스트)용 */
-export function getControlDateRange(control) {
+import { getTodayKst, getTodayKstDate, kstStartOfDay } from '../utils/date';
+const ymdOf = (y, m0, d) => {
+    const t = new Date(Date.UTC(y, m0, d));
+    return `${t.getUTCFullYear()}-${String(t.getUTCMonth() + 1).padStart(2, '0')}-${String(t.getUTCDate()).padStart(2, '0')}`;
+};
+const 범위 = (y, m0, 첫날, 날수) => ({
+    from: kstStartOfDay(y, m0, 첫날),
+    // 끝은 그날의 **마지막 밀리초까지** — 23:59:59.000 이면 마지막 999ms 에 남은 기록이 목록에서 빠졌다
+    to: new Date(kstStartOfDay(y, m0, 첫날 + 날수).getTime() - 1),
+    fromYmd: ymdOf(y, m0, 첫날),
+    toYmd: ymdOf(y, m0, 첫날 + 날수 - 1),
+});
+/**
+ * 현재 컨트롤 선택(주/월)의 기간 — 상세보기(기간별 리스트)용. **KST 의 날로 자른다**(해외 기기도 같은 기간).
+ *
+ * @param offset 몇 기간 앞·뒤인가 — `-1` 이면 앞 달 한 달(달력 달 그대로, 30일 앞이 아니다) · 앞 주 한 주.
+ * @public
+ */
+export function getControlDateRange(control, offset = 0) {
     if (control.period === 'month') {
         const m = control.monthRange.match(/^(\d+)년 (\d+)월$/);
-        const now = new Date();
-        const y = m ? Number(m[1]) : now.getFullYear();
-        const mo = m ? Number(m[2]) : now.getMonth() + 1;
-        // 끝은 그날의 **마지막 밀리초까지** — 23:59:59.000 이면 마지막 999ms 에 남은 기록이 목록에서 빠졌다
-        return { from: new Date(y, mo - 1, 1, 0, 0, 0), to: new Date(y, mo, 0, 23, 59, 59, 999) };
+        const today = getTodayKstDate();
+        const y = m ? Number(m[1]) : today.getFullYear();
+        const m0 = (m ? Number(m[2]) : today.getMonth() + 1) - 1 + offset;
+        const 날수 = new Date(Date.UTC(y, m0 + 1, 0)).getUTCDate();
+        return 범위(y, m0, 1, 날수);
     }
     const opt = control.weekRanges.find(o => o.value === control.weekRange);
     if (!opt) {
         const n = new Date();
-        return { from: n, to: n };
+        const ymd = getTodayKst();
+        return { from: n, to: n, fromYmd: ymd, toYmd: ymd };
     }
     const firstMon = firstMondayOfMonth(opt.year, opt.month - 1);
-    const monday = new Date(opt.year, opt.month - 1, firstMon + opt.week * 7, 0, 0, 0);
-    const sunday = new Date(monday);
-    sunday.setDate(monday.getDate() + 6);
-    sunday.setHours(23, 59, 59, 999);
-    return { from: monday, to: sunday };
+    return 범위(opt.year, opt.month - 1, firstMon + (opt.week + offset) * 7, 7);
 }

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

@@ -1,5 +1,6 @@
 'use client';
 import { useCallback, useEffect, useRef, useState } from 'react';
+import { getTodayKst } from '../utils/date';
 /**
  * "현재 보고 있는 연/월" 상태 + 이전/다음 달 이동. DatePicker의 달력 네비게이션에서 쓴다.
  * @public
@@ -10,8 +11,8 @@ export function useCalendarMonth(value) {
             const [y, m] = value.split('-');
             return { y: +y, m: +m - 1 };
         }
-        const today = new Date();
-        return { y: today.getFullYear(), m: today.getMonth() };
+        const [y, m] = getTodayKst().split('-'); // 값이 없으면 KST 오늘의 달(해외 기기 공식 지원)
+        return { y: +y, m: +m - 1 };
     };
     const [viewY, setViewY] = useState(() => initYM().y);
     const [viewM, setViewM] = useState(() => initYM().m);

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

@@ -99,6 +99,11 @@ export function useToastLifecycle({ message, position, duration, onClose }) {
                         clearTimeout(hideTimerRef.current);
                         hideTimerRef.current = null;
                     }
+                    // 사라지는 중(hide 가 울리며 건 exit)도 — 남으면 떠난 뒤에 onClose 가 불렸다(아래 첫 등장 갈래의 정리와 같게)
+                    if (exitTimerRef.current) {
+                        clearTimeout(exitTimerRef.current);
+                        exitTimerRef.current = null;
+                    }
                 };
             }
             // 처음 등장할 때만 슬라이드인 애니메이션 실행

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

@@ -142,6 +142,7 @@ export { default as BarChart, BarChartControls } from './components/BarChart';
 export { useBarChartControl } from './components/useBarChartControl';
 export { buildMonthChartData } from './components/barChartData';
 export { getControlDateRange } from './components/barChartTypes';
+export type { ControlDateRange } from './components/barChartTypes';
 export type { BarChartProps, BarChartControl, BarChartSize, BarData, MonthBarData, ChartPoint } from './components/BarChart';
 export { default as RingChart } from './components/RingChart';
 export type { RingChartProps, RingChartSize, RingChartSegment } from './components/RingChart';

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

@@ -0,0 +1,4 @@
+/** 창 판과, 그 창이 열릴 때 포커스였던 요소를 적는다 */
+export declare function rememberFocusReturn(panel: Element | null, previouslyFocused: HTMLElement | null): void;
+/** 실제로 돌려줄 곳 — 문서에 붙어 있으면 그대로, 떼어졌으면 그것을 품었던 창이 적어 둔 곳을 따라간다 */
+export declare function resolveFocusReturn(previouslyFocused: HTMLElement | null): HTMLElement | null;

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

@@ -0,0 +1,27 @@
+/**
+ * 창(Popup·Dialog·TrainingPagePopup)이 닫힐 때 포커스를 돌려줄 곳 — 창끼리 한 표를 쓴다.
+ *
+ * 창은 열릴 때 그때 포커스였던 요소를 기억했다가 닫힐 때 돌려준다. 그런데 **닫으면서 다음 창을 여는** 흐름
+ * (미리보기 → 삭제 확인)에서는 확인 창이 기억한 것이 미리보기 안의 삭제 단추이고, 그 단추는 260ms 뒤
+ * 미리보기와 함께 사라진다. 확인 창을 닫으면 떼어진 단추에 focus() 해 아무 일도 없이 body 에 떨어졌다.
+ * 각 창의 판(panel) → 그 창이 돌려줄 곳을 적어 두고, 돌려줄 곳이 떼어졌으면 그것을 품었던 창의 돌려줄 곳을 따라 올라간다.
+ */
+const 돌아갈곳표 = new WeakMap();
+/** 창 판과, 그 창이 열릴 때 포커스였던 요소를 적는다 */
+export function rememberFocusReturn(panel, previouslyFocused) {
+    if (panel)
+        돌아갈곳표.set(panel, previouslyFocused);
+}
+/** 실제로 돌려줄 곳 — 문서에 붙어 있으면 그대로, 떼어졌으면 그것을 품었던 창이 적어 둔 곳을 따라간다 */
+export function resolveFocusReturn(previouslyFocused) {
+    let 대상 = previouslyFocused;
+    for (let 번 = 0; 대상 && !대상.isConnected && 번 < 10; 번++) {
+        let 창 = 대상;
+        while (창 && !돌아갈곳표.has(창))
+            창 = 창.parentElement;
+        if (!창)
+            return 대상;
+        대상 = 돌아갈곳표.get(창) ?? null;
+    }
+    return 대상;
+}

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

@@ -11,6 +11,8 @@ export type VisitItem = {
     id?: string;
 };
 /**
+ * 오늘의 **KST** 연·월·일(두 자리 월·일). 방문 폼의 기본 날짜 — 소비자가 이 칸을 KST 벽시계로 읽어 저장하므로, 기기 달력이면
+ * 해외 기기에서 손대지 않고 등록한 방문이 하루 전으로 저장됐다(해외 기기 공식 지원).
  * @public
  */
 export declare const today: () => {

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

@@ -1,16 +1,15 @@
 'use client';
 import { useState } from 'react';
 import { useEditableList, isSameEditableItem } from './useEditableList';
+import { getTodayKst } from '../utils/date';
 /**
+ * 오늘의 **KST** 연·월·일(두 자리 월·일). 방문 폼의 기본 날짜 — 소비자가 이 칸을 KST 벽시계로 읽어 저장하므로, 기기 달력이면
+ * 해외 기기에서 손대지 않고 등록한 방문이 하루 전으로 저장됐다(해외 기기 공식 지원).
  * @public
  */
 export const today = () => {
-    const now = new Date();
-    return {
-        year: String(now.getFullYear()),
-        month: String(now.getMonth() + 1).padStart(2, '0'),
-        day: String(now.getDate()).padStart(2, '0'),
-    };
+    const [year, month, day] = getTodayKst().split('-');
+    return { year, month, day };
 };
 const emptyVisitItem = { year: '', month: '', day: '', hour: '09', minute: '00', memo: '' };
 export function useVisitHistory(initialHistory = []) {

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

@@ -47,9 +47,12 @@ export function useWordMeanings(rows, fetchMeanings) {
                 if (row.Meaning)
                     memCache.set(meaningKey(row.Word, row.Homonum ?? undefined), row.Meaning);
             }
-            for (const k of missing)
-                if (!memCache.has(k))
-                    noMeaning.add(k);
+            /* 한 줄도 못 받았으면 '뜻 없음' 으로 굳히지 않는다 — 조회 함수는 실패를 빈 배열로 돌려주는 약속이라, 잠깐 끊긴 망이
+               그 쪽 낱말들을 새로고침 전까지 '뜻 없음' 으로 묶었다. 받은 게 있으면 그 응답에 빠진 낱말만 없는 것으로 본다. */
+            if (got.length > 0)
+                for (const k of missing)
+                    if (!memCache.has(k))
+                        noMeaning.add(k);
             if (cancelled || got.length === 0)
                 return;
             setFetched(v => v + 1);

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

@@ -11,9 +11,9 @@ export interface WordFilterSnapshot {
     sameStructureOnly: boolean;
     phonemeView: 'char' | 'pron' | 'direct';
     gradeFilter: string[];
-    /** 품사 필터. 없으면(예전에 뜬 스냅샷) 되돌릴 때 지금 값을 그대로 둔다. */
+    /** 품사 필터 — 고정 코드(noun·verb·modifier). 라벨(옛 스냅샷)도 받는다. 없으면 되돌릴 때 지금 값을 그대로 둔다. */
     posFilter?: string[];
-    /** 어종 필터. 없으면(예전에 뜬 스냅샷) 되돌릴 때 지금 값을 그대로 둔다. */
+    /** 어종 필터 — 고정 코드(native·sino·foreign·mixed). 라벨(옛 스냅샷)도 받는다. 없으면 되돌릴 때 지금 값을 그대로 둔다. */
     wordTypeFilter?: string[];
 }
 /**