@ihabdevteam/core 0.321.0 → 0.323.0

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

@@ -6,7 +6,7 @@ import Popup from './Popup';
 import Table from '../Table';
 import Toolbar from '../Toolbar';
 import './ListPopup.css';
-import { 칸순빈값뒤 } from '../../utils/textSort';
+import { compareCellBlankLast } from '../../utils/textSort';
 import { cx } from '../../utils/cx';
 /** @public */
 export default function ListPopup(props) {
@@ -48,9 +48,9 @@ export default function ListPopup(props) {
                 return 0;
             /* `<`·`>` 로 견주면 코드포인트 차례가 된다 — 한글끼리는 맞아떨어져 안 드러나다가
                **한글과 영문이 섞이면** 어긋난다(라틴이 한글보다 앞이라 `fwef` 가
-               `검수테스트2` 위에 선다). 숫자 칸은 숫자로 견주는 것을 `칸순` 이 지킨다.
+               `검수테스트2` 위에 선다). 숫자 칸은 숫자로 견주는 것을 `compareCell` 이 지킨다.
                빈 값(null·undefined·'')은 오름·내림 모두 맨 뒤 — 전에는 '' 로 채워 오름차순 맨 앞에 섰다(useTableSort 와 같은 규칙). */
-            return 칸순빈값뒤(va, vb, sortAsc);
+            return compareCellBlankLast(va, vb, sortAsc);
         });
     }, [items, search, sortKey, sortAsc, searchEnabled, effectiveSearchFn]);
     const totalPages = Math.max(1, Math.ceil(filtered.length / Number(pageSize)));
@@ -58,8 +58,8 @@ export default function ListPopup(props) {
        떴다. 렌더 중에 상태도 맞춘다. */
     if (page > totalPages)
         setPage(totalPages);
-    const 이쪽 = Math.min(page, totalPages);
-    const paged = filtered.slice((이쪽 - 1) * Number(pageSize), 이쪽 * Number(pageSize));
+    const clampedPage = Math.min(page, totalPages);
+    const paged = filtered.slice((clampedPage - 1) * Number(pageSize), clampedPage * Number(pageSize));
     const handleSort = useCallback((key) => {
         if (sortKey === key)
             setSortAsc(a => !a);
@@ -99,7 +99,7 @@ export default function ListPopup(props) {
         sortDir: col.sortable !== false && sortKey === col.key ? (sortAsc ? 'asc' : 'desc') : null,
     })), [columns, sortKey, sortAsc, handleSort]);
     const pageSizeOpts = useMemo(() => pageSizeOptions.map(n => ({ value: String(n), label: t('common.pageSizeLabel', { n }) })), [pageSizeOptions, t]);
-    return (_jsxs(Popup, { className: `popup-list ${className}`, title: title, onClose: onClose, children: [topContent, 'label' in countParts && _jsx("p", { className: "toolbar__count body-1", children: countParts.label }), _jsx(Toolbar, { count: 'label' in countParts ? undefined : { value: filtered.length, prefix: countParts.prefix, suffix: countParts.suffix }, search: searchEnabled ? { value: search, onChange: setSearch, placeholder: resolvedSearchPlaceholder } : undefined, pageSize: { options: pageSizeOpts, value: pageSize, onChange: setPageSize }, pagination: { page: 이쪽, total: totalPages, onChange: setPage } }), _jsx(Table, { size: "medium", gridTemplateColumns: gridTemplateColumns, mobileGridTemplateColumns: mobileGridTemplateColumns, 
+    return (_jsxs(Popup, { className: `popup-list ${className}`, title: title, onClose: onClose, children: [topContent, 'label' in countParts && _jsx("p", { className: "toolbar__count body-1", children: countParts.label }), _jsx(Toolbar, { count: 'label' in countParts ? undefined : { value: filtered.length, prefix: countParts.prefix, suffix: countParts.suffix }, search: searchEnabled ? { value: search, onChange: setSearch, placeholder: resolvedSearchPlaceholder } : undefined, pageSize: { options: pageSizeOpts, value: pageSize, onChange: setPageSize }, pagination: { page: clampedPage, total: totalPages, onChange: setPage } }), _jsx(Table, { size: "medium", gridTemplateColumns: gridTemplateColumns, mobileGridTemplateColumns: mobileGridTemplateColumns, 
                 /* 폭 조절은 켜되 **저장 열쇠는 안 준다** — 창은 열 때마다 새로 짓는 것이라 폭이 따라다니면
                    엉뚱하다. 그래서 이 창의 표는 끌어도 localStorage 에 아무 자국이 없고, 끈 폭은 창이 닫히면
                    사라진다. 폰에서 '오늘의 듣기 현황 상세보기' 가 `48px 48px …` 로 눌렸는데 저장소가

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

@@ -6,7 +6,7 @@ import Popup from './Popup';
 import Button from '../Button';
 import Dropdown from '../Dropdown';
 import { getSavedTables, deleteTable as localDeleteTable } from '../../utils/savedWordTables';
-import { 한글순 } from '../../utils/textSort';
+import { compareKorean } from '../../utils/textSort';
 import { formatYmd } from '../../utils/date';
 import './LoadTablePopup.css';
 import { pressable } from '../../utils/pressable';
@@ -59,9 +59,9 @@ export default function LoadTablePopup({ onLoad, onCancel, tables: tablesProp, o
             return copy.sort((a, b) => String(b.savedAt ?? '').localeCompare(String(a.savedAt ?? '')));
         if (sortKey === 'oldest')
             return copy.sort((a, b) => String(a.savedAt ?? '').localeCompare(String(b.savedAt ?? '')));
-        /* 이름은 **`한글순`(콜레이터 하나)** — `localeCompare(…, 'ko')` 는 비교마다 콜레이터를 새로 만든다((113)) */
+        /* 이름은 **`compareKorean`(콜레이터 하나)** — `localeCompare(…, 'ko')` 는 비교마다 콜레이터를 새로 만든다((113)) */
         if (sortKey === 'name')
-            return copy.sort((a, b) => 한글순(a.name, b.name));
+            return copy.sort((a, b) => compareKorean(a.name, b.name));
         if (sortKey === 'count')
             return copy.sort((a, b) => b.items.length - a.items.length);
         return copy;
@@ -77,20 +77,20 @@ export default function LoadTablePopup({ onLoad, onCancel, tables: tablesProp, o
         cardEls.current.set(id, el);
     else
         cardEls.current.delete(id); };
-    const 지운뒤초점 = useRef(null);
+    const focusAfterDeleteRef = useRef(null);
     useEffect(() => {
-        const p = 지운뒤초점.current;
+        const p = focusAfterDeleteRef.current;
         if (!p || sorted.some(t => t.id === p.id))
             return;
-        지운뒤초점.current = null;
-        const 곳 = [p.next, p.prev].find(id => id != null && sorted.some(t => t.id === id));
-        if (곳)
-            cardEls.current.get(곳)?.focus();
+        focusAfterDeleteRef.current = null;
+        const nextId = [p.next, p.prev].find(id => id != null && sorted.some(t => t.id === id));
+        if (nextId)
+            cardEls.current.get(nextId)?.focus();
     }, [sorted]);
     const handleDelete = useCallback((id, e) => {
         e.stopPropagation();
         const i = sorted.findIndex(t => t.id === id);
-        지운뒤초점.current = { id, next: sorted[i + 1]?.id ?? null, prev: i > 0 ? sorted[i - 1].id : null };
+        focusAfterDeleteRef.current = { id, next: sorted[i + 1]?.id ?? null, prev: i > 0 ? sorted[i - 1].id : null };
         if (onDeleteProp) {
             onDeleteProp(id);
         }

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

@@ -38,13 +38,13 @@ export default function Popup(props) {
         if (inline)
             return;
         if (!title && !ariaLabel && import.meta.env?.DEV) {
-            const 본문 = panelRef.current?.textContent?.replace(/\s+/g, ' ').trim().slice(0, 60) ?? '';
-            const 표시 = [
+            const bodyText = panelRef.current?.textContent?.replace(/\s+/g, ' ').trim().slice(0, 60) ?? '';
+            const marks = [
                 className ? `class="${className}"` : null,
-                본문 ? `본문 "${본문}${본문.length >= 60 ? '…' : ''}"` : null,
+                bodyText ? `본문 "${bodyText}${bodyText.length >= 60 ? '…' : ''}"` : null,
             ].filter(Boolean).join(' · ');
             console.warn(`[Popup] 제목도 ariaLabel도 없어 다이얼로그에 접근명이 없습니다 — ariaLabel을 주세요.` +
-                (표시 ? ` (${표시})` : ' (단서 없음 — 빈 팝업)'));
+                (marks ? ` (${marks})` : ' (단서 없음 — 빈 팝업)'));
         }
     }, [inline, title, ariaLabel, className]);
     // resetScrollKey가 바뀌면(탭/모드 전환 등) 본문 스크롤을 맨 위로 되돌린다 —
@@ -114,59 +114,59 @@ export default function Popup(props) {
     /* 닫힘 애니메이션 뒤 콜백을 부른다. **콜백이 던지거나 거절되면, 또는 약속을 돌려준 콜백이 끝난 뒤에도 이 창이 그대로 있으면 되살린다** —
        전에는 닫는 중 표시만 남아 투명한 막이 화면을 덮고(클릭을 가로챔) ESC·X·바탕·다시 저장이 모두 무시돼 페이지를 쓸 수
        없었다(말귀 업체 정보·훈련 묶음 수정 저장이 실패해 부모가 창을 열어 둘 때). 성공하면 부모가 곧 치우므로 되살릴 일이 없다. */
-    const 살아있음Ref = useRef(true);
+    const aliveRef = useRef(true);
     /* '동작 줄이기' 면 닫기 대기를 0 으로 — CSS 는 움직임을 없애지만 이 타이머는 못 줄여, 움직임 없이 260ms 늦게 사라지며 투명한 막이 누름을 가로챘다 */
-    const 동작줄이기 = usePrefersReducedMotion();
+    const reducedMotion = usePrefersReducedMotion();
     /* 닫기(X·ESC·바탕)가 걸어 둔 타이머 — 닫는 애니메이션(260ms) 안에 부모가 창을 치우면 **떠난 뒤에 onClose** 가 불렸다(닫으며
        다음 창을 여는 흐름에서 늦은 setX(null) 이 새 창을 닫을 수 있다). 떠날 때 걷는다. 소비자가 넘긴 animateThen(cb) 은
        "삭제·저장 확정" 일 수 있어 걷지 않는다(결정 2026-09-15: 떠난 뒤에도 부른다 — PopupOptions JSDoc). */
-    const 닫기타이머Ref = useRef(null);
+    const closeTimerRef = useRef(null);
     useEffect(() => {
-        살아있음Ref.current = true;
+        aliveRef.current = true;
         return () => {
-            살아있음Ref.current = false;
-            if (닫기타이머Ref.current) {
-                clearTimeout(닫기타이머Ref.current);
-                닫기타이머Ref.current = null;
+            aliveRef.current = false;
+            if (closeTimerRef.current) {
+                clearTimeout(closeTimerRef.current);
+                closeTimerRef.current = null;
             }
         };
     }, []);
-    const 되살리기 = useCallback(() => {
-        if (!살아있음Ref.current || !closingRef.current)
+    const restore = useCallback(() => {
+        if (!aliveRef.current || !closingRef.current)
             return;
         closingRef.current = false;
         setClosing(false);
     }, []);
-    const animateThen = useCallback((cb, 닫기뿐 = false) => {
+    const animateThen = useCallback((cb, closeOnly = false) => {
         /* 이미 떠난 창을 닫으려는 부름(ConfirmPopup 의 onConfirm 안에서 부모가 창을 치운 뒤 closeWithAnimation)은 받지 않는다 —
            정리가 끝난 뒤 걸린 타이머라 걷히지 않고 260ms 뒤 **취소 경로의 onClose** 가 불렸다(kscan 이 closeOnConfirm=false 로 우회). */
-        if (닫기뿐 && !살아있음Ref.current)
+        if (closeOnly && !aliveRef.current)
             return;
         if (closingRef.current)
             return;
         closingRef.current = true;
         setClosing(true);
         const id = setTimeout(() => {
-            if (닫기타이머Ref.current === id)
-                닫기타이머Ref.current = null;
-            let 결과;
+            if (closeTimerRef.current === id)
+                closeTimerRef.current = null;
+            let result;
             try {
-                결과 = cb ? cb() : undefined;
+                result = cb ? cb() : undefined;
             }
             catch (e) {
-                되살리기();
+                restore();
                 return;
             }
             /* 약속을 돌려준 콜백만 **끝난 뒤에도 남아 있으면** 되살린다. 동기 콜백(undefined)은 되살리지 않는다 — 부모가 저장을
                따로 기다렸다 닫는 흔한 꼴(onSave 를 부르고 약속은 안 돌려줌)에서 기다리는 사이 창이 다시 보이고 저장 단추가 다시
                눌려 두 번 저장됐다. 저장 실패에 창을 되살리고 싶으면 콜백이 그 약속을 돌려주면 된다. */
-            if (결과 && typeof 결과.then === 'function') {
-                결과.then(() => { setTimeout(되살리기, 120); }, 되살리기);
+            if (result && typeof result.then === 'function') {
+                result.then(() => { setTimeout(restore, 120); }, restore);
             }
-        }, 동작줄이기 ? 0 : ANIM_MS);
-        if (닫기뿐)
-            닫기타이머Ref.current = id;
-    }, [되살리기, 동작줄이기]);
+        }, reducedMotion ? 0 : ANIM_MS);
+        if (closeOnly)
+            closeTimerRef.current = id;
+    }, [restore, reducedMotion]);
     const closeWithAnimation = useCallback(() => {
         if (closeDisabled)
             return;

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

@@ -43,17 +43,17 @@ export default function SaveTablePopup({ title, saveLabel, defaultName = '', def
         existingNames.some(n => n.trim().toLowerCase() === name.trim().toLowerCase());
     /* 저장은 **한 번만** — 저장 단추의 닫힘 애니메이션(260ms) 동안 이름칸에서 Enter 를 치면 onSave 가 또 불렸다(Safari 는 단추를
        눌러도 포커스가 칸에 남아 쉽게 난다). */
-    const 저장함 = useRef(false);
+    const savedRef = useRef(false);
     const handleSave = useCallback((animateThen) => {
-        if (저장함.current)
+        if (savedRef.current)
             return;
-        저장함.current = true;
+        savedRef.current = true;
         animateThen(() => onSave(name.trim(), description.trim() || undefined));
     }, [name, description, onSave]);
     const handleEnter = useCallback(() => {
-        if (저장함.current || !name.trim() || isDuplicateName)
+        if (savedRef.current || !name.trim() || isDuplicateName)
             return;
-        저장함.current = true;
+        savedRef.current = true;
         onSave(name.trim(), description.trim() || undefined);
     }, [name, description, isDuplicateName, onSave]);
     return (_jsx(Popup, { className: "popup--save-table", title: title ?? t('wordTable.save.title', '단어표 저장하기'), onClose: onCancel, footer: ({ animateThen, closeWithAnimation }) => (_jsxs(_Fragment, { children: [_jsx(Button, { htmlType: "button", size: 48, type: "bar", label: t('common.cancel', '취소'), onClick: closeWithAnimation }), _jsx(Button, { htmlType: "button", size: 48, type: "bar", variant: "main", label: saveLabel ?? t('common.save', '저장'), disabled: !name.trim() || isDuplicateName, onClick: () => handleSave(animateThen) })] })), children: _jsxs("div", { className: "save-table-popup__body", children: [preview && (_jsx("div", { ref: containerRef, className: "save-table-popup__preview-wrap", style: { height: previewState.fixedH }, children: _jsx("div", { className: "save-table-popup__preview", style: {

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

@@ -60,8 +60,8 @@ function resolveDecision(it) {
 export default function TrainingResultPopup(props) {
     const { score, contextsLength, results = [], subtitle, onReplay, onClose, inline = false, pending = false } = props || {};
     const { t } = useTranslation();
-    const 까닭Id = useId();
-    const 계산중이면막기 = useCallback(() => !pending, [pending]);
+    const reasonId = useId();
+    const blockWhilePending = useCallback(() => !pending, [pending]);
     // 축하 컨페티는 정답률 50% 초과일 때만 — 낮은 점수(≤50%)에 축하가 나가지 않게 한다(언어치료 맥락).
     useEffect(() => {
         const total = contextsLength ?? 0;
@@ -114,7 +114,7 @@ export default function TrainingResultPopup(props) {
            주는 이름이 갈라진다. */
         ariaLabel: t('training.result.title', '훈련을 모두 마쳤습니다.'), className: "popup--training-result", 
         // 결과 계산 중에는 Esc 로도 완료(닫기)하지 않는다 — '완료' 단추와 같은 까닭
-        beforeClose: 계산중이면막기, footerClassName: "trp-result__foot", footer: ({ animateThen, closeWithAnimation }) => (_jsxs(_Fragment, { children: [pending && _jsx("p", { id: 까닭Id, className: "trp-actions__reason caption-1", role: "status", children: t('training.result.pendingDone', '결과를 계산하는 중이라 아직 완료할 수 없습니다.') }), _jsxs("div", { className: "trp-actions", children: [_jsx(Button, { htmlType: "button", size: 56, type: "bar", label: t('training.result.replay', '다시하기'), onClick: () => animateThen(onReplay) }), _jsx(Button, { htmlType: "button", size: 56, type: "bar", label: t('training.result.done', '완료'), variant: "main", onClick: closeWithAnimation, 
+        beforeClose: blockWhilePending, footerClassName: "trp-result__foot", footer: ({ animateThen, closeWithAnimation }) => (_jsxs(_Fragment, { children: [pending && _jsx("p", { id: reasonId, className: "trp-actions__reason caption-1", role: "status", children: t('training.result.pendingDone', '결과를 계산하는 중이라 아직 완료할 수 없습니다.') }), _jsxs("div", { className: "trp-actions", children: [_jsx(Button, { htmlType: "button", size: 56, type: "bar", label: t('training.result.replay', '다시하기'), onClick: () => animateThen(onReplay) }), _jsx(Button, { htmlType: "button", size: 56, type: "bar", label: t('training.result.done', '완료'), variant: "main", onClick: closeWithAnimation, 
                             /* 막되 초점은 남긴다(onDisabledClick 이 있으면 native disabled 대신 aria-disabled) — 키보드·낭독기가 까닭을 들을 수 있게 */
-                            disabled: pending, onDisabledClick: pending ? () => { } : undefined, "aria-describedby": pending ? 까닭Id : undefined })] })] })), children: () => (_jsxs("div", { className: "trp-result is-on", children: [_jsxs("header", { className: "trp-result__head", children: [_jsx("p", { className: "trp-result__eyebrow caption-1", children: t('training.result.eyebrow', '훈련 완료') }), _jsx("h1", { className: "trp-result__title h2", children: t('training.result.title', '훈련을 모두 마쳤습니다.') }), subtitle && _jsx("p", { className: "trp-result__subtitle body-3", children: subtitle }), _jsx("div", { className: "trp-score", children: _jsxs("div", { className: "trp-score__figure", "aria-label": t('training.result.scoreAria', { correct, total }), children: [_jsx("span", { className: "trp-score__big", children: correct }), _jsx("span", { className: "trp-score__sep", children: "/" }), _jsx("span", { className: "trp-score__total", children: total })] }) })] }), rows.length > 0 && (_jsx("section", { className: "trp-result__body", children: _jsxs("div", { className: `result-table${hasAnswerCols ? ' result-table--answer' : ''}`, role: "table", "aria-label": t('training.result.tableAriaLabel', '문항별 판정'), children: [_jsxs("div", { className: "result-table__head caption-1", role: "row", children: [_jsx("span", { role: "columnheader", children: t('common.col.problem', '문제') }), hasAnswerCols && _jsx("span", { role: "columnheader", children: t('training.result.colAnswerSelected', '정답 · 선택') }), _jsx("span", { className: "col-right", role: "columnheader", children: t('training.result.colJudge', '판정') })] }), rows.map((r, i) => (_jsxs("div", { className: "result-table__row", role: "row", children: [_jsxs("div", { className: "trp-row__problem", children: [_jsx("span", { className: "trp-row__no caption-1", children: String(i + 1).padStart(2, '0') }), _jsx("div", { className: "trp-row__q body-2", children: r.problem })] }), hasAnswerCols && (_jsxs("div", { className: "trp-row__answers", children: [r.answer !== null && (_jsxs("div", { className: "trp-row__answer-line", children: [_jsx("span", { className: "trp-row__answer-label answer-correct caption-1", children: t('training.result.colAnswer', '정답') }), _jsx("span", { className: "trp-row__answer-value body-2", children: r.answer })] })), _jsxs("div", { className: "trp-row__answer-line", children: [_jsx("span", { className: `trp-row__answer-label answer-selected caption-1 ${r.isCorrect ? 'is-correct' : 'is-wrong'}`, children: t('training.result.colSelected', '선택') }), _jsx("span", { className: `trp-row__answer-value body-2 ${r.isCorrect ? 'is-correct' : 'is-wrong'}`, children: r.selectedText ?? '—' })] })] })), _jsx("div", { className: "trp-row__judge", children: _jsx(Badge, { variant: r.variant, label: r.label, fill: "soft", minWidth: 80 }) })] }, i)))] }) }))] })) }));
+                            disabled: pending, onDisabledClick: pending ? () => { } : undefined, "aria-describedby": pending ? reasonId : undefined })] })] })), children: () => (_jsxs("div", { className: "trp-result is-on", children: [_jsxs("header", { className: "trp-result__head", children: [_jsx("p", { className: "trp-result__eyebrow caption-1", children: t('training.result.eyebrow', '훈련 완료') }), _jsx("h1", { className: "trp-result__title h2", children: t('training.result.title', '훈련을 모두 마쳤습니다.') }), subtitle && _jsx("p", { className: "trp-result__subtitle body-3", children: subtitle }), _jsx("div", { className: "trp-score", children: _jsxs("div", { className: "trp-score__figure", "aria-label": t('training.result.scoreAria', { correct, total }), children: [_jsx("span", { className: "trp-score__big", children: correct }), _jsx("span", { className: "trp-score__sep", children: "/" }), _jsx("span", { className: "trp-score__total", children: total })] }) })] }), rows.length > 0 && (_jsx("section", { className: "trp-result__body", children: _jsxs("div", { className: `result-table${hasAnswerCols ? ' result-table--answer' : ''}`, role: "table", "aria-label": t('training.result.tableAriaLabel', '문항별 판정'), children: [_jsxs("div", { className: "result-table__head caption-1", role: "row", children: [_jsx("span", { role: "columnheader", children: t('common.col.problem', '문제') }), hasAnswerCols && _jsx("span", { role: "columnheader", children: t('training.result.colAnswerSelected', '정답 · 선택') }), _jsx("span", { className: "col-right", role: "columnheader", children: t('training.result.colJudge', '판정') })] }), rows.map((r, i) => (_jsxs("div", { className: "result-table__row", role: "row", children: [_jsxs("div", { className: "trp-row__problem", children: [_jsx("span", { className: "trp-row__no caption-1", children: String(i + 1).padStart(2, '0') }), _jsx("div", { className: "trp-row__q body-2", children: r.problem })] }), hasAnswerCols && (_jsxs("div", { className: "trp-row__answers", children: [r.answer !== null && (_jsxs("div", { className: "trp-row__answer-line", children: [_jsx("span", { className: "trp-row__answer-label answer-correct caption-1", children: t('training.result.colAnswer', '정답') }), _jsx("span", { className: "trp-row__answer-value body-2", children: r.answer })] })), _jsxs("div", { className: "trp-row__answer-line", children: [_jsx("span", { className: `trp-row__answer-label answer-selected caption-1 ${r.isCorrect ? 'is-correct' : 'is-wrong'}`, children: t('training.result.colSelected', '선택') }), _jsx("span", { className: `trp-row__answer-value body-2 ${r.isCorrect ? 'is-correct' : 'is-wrong'}`, children: r.selectedText ?? '—' })] })] })), _jsx("div", { className: "trp-row__judge", children: _jsx(Badge, { variant: r.variant, label: r.label, fill: "soft", minWidth: 80 }) })] }, i)))] }) }))] })) }));
 }

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

@@ -5,8 +5,8 @@
 import i18n from 'i18next';
 import { getTodayKst } from '../../utils/date';
 /** i18n 이 아직 안 섰으면(초기화 전 `i18n.t` 는 undefined) 한국어 기본값을 직접 채운다. */
-function 번역됐거나(s, 기본, vars) {
-    return typeof s === 'string' && s ? s : 기본.replace(/\{\{(\w+)\}\}/g, (_, k) => String(vars[k]));
+function translatedOr(s, fallback, vars) {
+    return typeof s === 'string' && s ? s : fallback.replace(/\{\{(\w+)\}\}/g, (_, k) => String(vars[k]));
 }
 export function getDayOptions(year, month, daySuffix) {
     const days = new Date(Number(year), Number(month), 0).getDate();
@@ -16,16 +16,16 @@ export function getDayOptions(year, month, daySuffix) {
     });
 }
 /** 'YYYY.MM.DD' · 'YYYY-MM-DD' · 'YYYYMMDD' 를 숫자 셋으로. 없는 날(2/30 등)이면 null. */
-function 날짜쪼개기(s) {
-    const 숫자 = s.trim().replace(/[.-]/g, '');
-    if (!/^\d{8}$/.test(숫자))
+function splitDate(s) {
+    const digits = s.trim().replace(/[.-]/g, '');
+    if (!/^\d{8}$/.test(digits))
         return null;
-    const y = Number(숫자.slice(0, 4)), m = Number(숫자.slice(4, 6)), d = Number(숫자.slice(6, 8));
-    if (m < 1 || m > 12 || d < 1 || d > 말일(y, m))
+    const y = Number(digits.slice(0, 4)), m = Number(digits.slice(4, 6)), d = Number(digits.slice(6, 8));
+    if (m < 1 || m > 12 || d < 1 || d > lastDayOf(y, m))
         return null;
     return { y, m, d };
 }
-const 말일 = (y, m) => new Date(y, m, 0).getDate();
+const lastDayOf = (y, m) => new Date(y, m, 0).getDate();
 /**
  * 만 나이 — "N세 M개월" 을 `ageStr` 로 적는다. 못 읽으면 '-'.
  *
@@ -44,15 +44,15 @@ const 말일 = (y, m) => new Date(y, m, 0).getDate();
 export function calcAge(birthDate, ageStr) {
     if (!birthDate)
         return '-';
-    const b = 날짜쪼개기(birthDate);
-    const t = 날짜쪼개기(getTodayKst());
+    const b = splitDate(birthDate);
+    const t = splitDate(getTodayKst());
     if (!b || !t)
         return '-';
     let years = t.y - b.y;
     let months = t.m - b.m;
     // 일(day)까지 비교해야 함 — 월만 비교하면 생일이 아직 안 지난 달엔 나이가 1살 많게 나온다.
     // 이번 달에 그 날이 없으면 말일이 그날이다.
-    if (t.d < Math.min(b.d, 말일(t.y, t.m)))
+    if (t.d < Math.min(b.d, lastDayOf(t.y, t.m)))
         months--;
     if (months < 0) {
         years--;
@@ -78,17 +78,17 @@ export function visitItemKey(v) {
  */
 export function formatDuration(sec, durationStr) {
     // 초 단위로 반올림한 뒤 나눈다 — 90.5 가 "1분 30.5초", 59.999 가 "59.999초" 로 찍혔다
-    const 초 = Number.isFinite(sec) ? Math.round(sec) : 0;
-    if (!초 || 초 <= 0)
+    const seconds = Number.isFinite(sec) ? Math.round(sec) : 0;
+    if (!seconds || seconds <= 0)
         return '-';
-    const m = Math.floor(초 / 60);
-    const s = 초 % 60;
+    const m = Math.floor(seconds / 60);
+    const s = seconds % 60;
     if (durationStr)
         return durationStr(m, s);
     // 열쇠를 글자로 적어 둔다 — test/i18nKeysExist 가 사전에 있는지 훑는다
     if (m > 0 && s > 0)
-        return 번역됐거나(i18n.t('customers.duration.minSec', { m, s, defaultValue: '{{m}}분 {{s}}초' }), '{{m}}분 {{s}}초', { m, s });
+        return translatedOr(i18n.t('customers.duration.minSec', { m, s, defaultValue: '{{m}}분 {{s}}초' }), '{{m}}분 {{s}}초', { m, s });
     if (m > 0)
-        return 번역됐거나(i18n.t('customers.duration.min', { m, defaultValue: '{{m}}분' }), '{{m}}분', { m });
-    return 번역됐거나(i18n.t('customers.duration.sec', { s, defaultValue: '{{s}}초' }), '{{s}}초', { s });
+        return translatedOr(i18n.t('customers.duration.min', { m, defaultValue: '{{m}}분' }), '{{m}}분', { m });
+    return translatedOr(i18n.t('customers.duration.sec', { s, defaultValue: '{{s}}초' }), '{{s}}초', { s });
 }

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

@@ -37,12 +37,12 @@ import ConfirmPopup from './ConfirmPopup';
 export function useDiscardGuard(isDirty, onClose, labels = {}) {
     const { t } = useTranslation();
     const [confirming, setConfirming] = useState(false);
-    const 통과 = useRef(false);
-    const allowClose = useCallback(() => { 통과.current = true; }, []);
+    const bypassRef = useRef(false);
+    const allowClose = useCallback(() => { bypassRef.current = true; }, []);
     const beforeClose = useCallback(() => {
         /* 한 번 쓰고 되돌린다 — 안 되돌리면 그 뒤로 영영 안 묻는다 */
-        if (통과.current) {
-            통과.current = false;
+        if (bypassRef.current) {
+            bypassRef.current = false;
             return true;
         }
         if (isDirty) {

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

@@ -4,7 +4,7 @@ import { useTranslation } from 'react-i18next';
 import useMediaQuery from '../hooks/useMediaQuery';
 import './ProgressIndicator.css';
 /** 눈에는 안 보이고 낭독기에는 읽히는 글자 */
-const 보이지않게 = {
+const srOnly = {
     position: 'absolute', width: 1, height: 1, margin: -1, padding: 0, overflow: 'hidden',
     clipPath: 'inset(50%)', whiteSpace: 'nowrap', border: 0,
 };
@@ -48,13 +48,13 @@ export default function ProgressIndicator({ max, index, inactiveBg, inactiveColo
        묶고 이름표에 자리를 적는다. 화면이 스스로 넘어가는 자리에서는
        announce 로 role="status" 를 켠다. */
     if (variant === 'dot') {
-        return (_jsxs("div", { className: "progress-indicator progress-indicator--dot", style: rootStyle, role: announce ? 'status' : 'img', "aria-label": announce ? undefined : groupLabel, children: [announce && _jsx("span", { style: 보이지않게, children: groupLabel }), Array.from({ length: max }).map((_, i) => (_jsx("span", { "aria-hidden": "true", className: `progress-indicator-dot--dot${i < idx ? ' done' : i === idx ? ' active' : ''}` }, i)))] }));
+        return (_jsxs("div", { className: "progress-indicator progress-indicator--dot", style: rootStyle, role: announce ? 'status' : 'img', "aria-label": announce ? undefined : groupLabel, children: [announce && _jsx("span", { style: srOnly, children: groupLabel }), Array.from({ length: max }).map((_, i) => (_jsx("span", { "aria-hidden": "true", className: `progress-indicator-dot--dot${i < idx ? ' done' : i === idx ? ' active' : ''}` }, i)))] }));
     }
     /* 번호·모바일 모드의 알리는 자리 — 전에는 announce 가 점 모드에서만 먹었다. 목록 곁 형제로 두고 absolute 라 배치에 안 끼어든다. */
-    const 알림 = announce ? _jsx("span", { role: "status", style: 보이지않게, children: groupLabel }) : null;
+    const liveRegion = announce ? _jsx("span", { role: "status", style: srOnly, children: groupLabel }) : null;
     // 모바일: 현재 단계만 표시 (n / max 형태)
     if (isMobile) {
-        return (_jsxs(_Fragment, { children: [_jsx("div", { className: "progress-indicator progress-indicator--mobile", style: rootStyle, role: "list", "aria-label": groupLabel, children: _jsxs("span", { role: "listitem", className: "progress-indicator-dot active body-3", children: [idx + 1, " / ", max] }) }), 알림] }));
+        return (_jsxs(_Fragment, { children: [_jsx("div", { className: "progress-indicator progress-indicator--mobile", style: rootStyle, role: "list", "aria-label": groupLabel, children: _jsxs("span", { role: "listitem", className: "progress-indicator-dot active body-3", children: [idx + 1, " / ", max] }) }), liveRegion] }));
     }
-    return (_jsxs(_Fragment, { children: [알림, _jsx("div", { className: "progress-indicator", style: rootStyle, role: "list", "aria-label": groupLabel, children: Array.from({ length: max }).map((_, i) => (_jsx("span", { role: "listitem", "aria-current": i === idx ? 'step' : undefined, className: `progress-indicator-dot ${i < idx ? ' done' : i === idx ? ' active' : ''} body-3`, children: i + 1 }, i))) })] }));
+    return (_jsxs(_Fragment, { children: [liveRegion, _jsx("div", { className: "progress-indicator", style: rootStyle, role: "list", "aria-label": groupLabel, children: Array.from({ length: max }).map((_, i) => (_jsx("span", { role: "listitem", "aria-current": i === idx ? 'step' : undefined, className: `progress-indicator-dot ${i < idx ? ' done' : i === idx ? ' active' : ''} body-3`, children: i + 1 }, i))) })] }));
 }

package/dist/packages/core/src/components/PromoBannerBg/promoBannerBg.js

@@ -2,9 +2,9 @@ import i18n from '../../i18n';
 /* 라벨은 **읽는 때의 언어**로 — 전에는 한국어가 박혀 영어 화면의 배경 고르개(어드민 공지 폼·놀이터)도 한국어였다.
    배열·항목 모양(key·label·textTone)은 그대로 두고 label 만 읽을 때 사전(`promoBannerBg.<key>`)에서 꺼내는 getter 로 둔다
    — 모듈을 읽은 순간의 언어로 굳지 않고, `{ ...o }` 로 펼치면 그때의 글자가 담긴다. ko 글자는 전과 같다. */
-const 배경 = (key, 한국어, textTone) => ({
+const bg = (key, ko, textTone) => ({
     key,
-    get label() { return i18n.t(`promoBannerBg.${key}`, 한국어); },
+    get label() { return i18n.t(`promoBannerBg.${key}`, ko); },
     textTone,
 });
 /**
@@ -12,20 +12,20 @@ const 배경 = (key, 한국어, textTone) => ({
  * @public
  */
 export const PROMO_BANNER_BG_OPTIONS = [
-    배경('main', '메인 그라디언트', 'light'),
-    배경('soft', '소프트', 'dark'),
-    배경('sub', '서브 컬러', 'light'),
-    배경('deep', '딥 그라디언트', 'light'),
-    배경('softSub', '소프트 서브', 'dark'),
-    배경('warm', '웜(강조)', 'dark'),
-    배경('dark', '다크', 'light'),
-    배경('radial', '방사형 그라디언트', 'light'),
-    배경('diagonal', '대각선 패턴', 'dark'),
-    배경('dots', '도트 패턴', 'dark'),
-    배경('outline', '아웃라인', 'dark'),
-    배경('success', '성공/완료', 'light'),
-    배경('naver', '네이버 블로그 안내', 'light'),
-    배경('instagram', '인스타그램 안내', 'light'),
+    bg('main', '메인 그라디언트', 'light'),
+    bg('soft', '소프트', 'dark'),
+    bg('sub', '서브 컬러', 'light'),
+    bg('deep', '딥 그라디언트', 'light'),
+    bg('softSub', '소프트 서브', 'dark'),
+    bg('warm', '웜(강조)', 'dark'),
+    bg('dark', '다크', 'light'),
+    bg('radial', '방사형 그라디언트', 'light'),
+    bg('diagonal', '대각선 패턴', 'dark'),
+    bg('dots', '도트 패턴', 'dark'),
+    bg('outline', '아웃라인', 'dark'),
+    bg('success', '성공/완료', 'light'),
+    bg('naver', '네이버 블로그 안내', 'light'),
+    bg('instagram', '인스타그램 안내', 'light'),
 ];
 import PromoBannerBgMain from './PromoBannerBgMain';
 import PromoBannerBgSoft from './PromoBannerBgSoft';

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

@@ -17,16 +17,16 @@ export default function Rating({ value, onChange, max = 5, readOnly = false, siz
     const [hoverValue, setHoverValue] = useState(null);
     /* 고르는 모드는 별 하나 단위라 **반올림한 값**으로 그리고 옮긴다 — 소수 value(3.4)를 그대로 두면 별 셋 반쯤이 칠해지는데
        어느 라디오도 골라지지 않았고(aria-checked 없음), 화살표는 4.4·2.4 로 옮겨 가 정수 별과 어긋났다. 읽기 전용은 소수 그대로. */
-    const 값 = isReadOnly ? value : (Number.isFinite(value) ? Math.round(value) : 0);
-    const displayValue = hoverValue ?? 값;
+    const current = isReadOnly ? value : (Number.isFinite(value) ? Math.round(value) : 0);
+    const displayValue = hoverValue ?? current;
     const iconSize = ICON_SIZE[size];
     /* 값이 바뀔 때만 onChange(2026-09-15 결정) — 소수 value 3.4 에서 별 3 을 누르면 3 으로 바뀌는 것이라 부른다 */
-    const 알림 = (다음) => { if (다음 !== value)
-        onChange?.(다음); };
+    const notify = (next) => { if (next !== value)
+        onChange?.(next); };
     const handleClick = (star) => {
         if (isReadOnly)
             return;
-        알림(star);
+        notify(star);
     };
     const handleMouseEnter = (star) => {
         if (isReadOnly)
@@ -41,38 +41,38 @@ export default function Rating({ value, onChange, max = 5, readOnly = false, siz
        이라 읽어 주는데 화살표가 죽어 있다. 실측으로 별 다섯이 전부 Tab 자리였다.
        별점은 순서가 뜻을 지니므로 **돌지 않는다** — 1에서 왼쪽, 5에서 오른쪽은 그 자리에
        머문다. 아직 안 골랐으면 첫 화살표가 1을 고른다. */
-    const 그룹 = useRef(null);
-    const 옮기기 = (다음) => {
-        const 잡은값 = Math.min(max, Math.max(1, 다음));
-        알림(잡은값);
-        const 칸 = Array.from(그룹.current?.querySelectorAll('[data-star]') ?? [])
-            .find((el) => el.dataset.star === String(잡은값));
-        칸?.focus();
+    const groupRef = useRef(null);
+    const moveTo = (next) => {
+        const clamped = Math.min(max, Math.max(1, next));
+        notify(clamped);
+        const stars = Array.from(groupRef.current?.querySelectorAll('[data-star]') ?? [])
+            .find((el) => el.dataset.star === String(clamped));
+        stars?.focus();
     };
-    const 키 = (e) => {
+    const onKeyDown = (e) => {
         if (isReadOnly)
             return;
         switch (e.key) {
             case 'ArrowRight':
             case 'ArrowUp':
-                옮기기((값 || 0) + 1);
+                moveTo((current || 0) + 1);
                 break;
             case 'ArrowLeft':
             case 'ArrowDown':
-                옮기기((값 || 1) - 1);
+                moveTo((current || 1) - 1);
                 break;
             case 'Home':
-                옮기기(1);
+                moveTo(1);
                 break;
             case 'End':
-                옮기기(max);
+                moveTo(max);
                 break;
             default: return;
         }
         e.preventDefault();
     };
     /* Tab 자리를 받을 한 칸 — 고른 별, 없으면 첫 별 */
-    const 탭자리 = 값 >= 1 && 값 <= max ? Math.round(값) : 1;
+    const tabValue = current >= 1 && current <= max ? Math.round(current) : 1;
     const handleMouseLeave = () => {
         if (isReadOnly)
             return;
@@ -83,7 +83,7 @@ export default function Rating({ value, onChange, max = 5, readOnly = false, siz
        대체 글자가 없으면 낭독기에는 빈 자리다 — 눈에는 별 넷 반이 보이는데 아무것도
        안 읽힌다. 별점을 보여 주는 것이 이 모드의 유일한 일인데 그것이 사라진다.
        (별을 하나씩 읽히게 하면 "별·별·별…" 이 다섯 번 나올 뿐이라 묶음에 준다.) */
-    _jsx("div", { className: `rating rating--${size}${isReadOnly ? ' rating--readOnly' : ''} ${className}`.trim(), ref: 그룹, onKeyDown: 키, role: isReadOnly ? 'img' : 'radiogroup', "aria-label": isReadOnly
+    _jsx("div", { className: `rating rating--${size}${isReadOnly ? ' rating--readOnly' : ''} ${className}`.trim(), ref: groupRef, onKeyDown: onKeyDown, role: isReadOnly ? 'img' : 'radiogroup', "aria-label": isReadOnly
             ? t('rating.valueLabel', { value, max })
             : (ariaLabel ?? t('rating.groupLabel', '별점')), onMouseLeave: handleMouseLeave, 
         /* 터치를 떼거나 취소되면 미리보기를 푼다 */
@@ -99,6 +99,6 @@ export default function Rating({ value, onChange, max = 5, readOnly = false, siz
             if (isReadOnly) {
                 return (_jsx("span", { className: "rating__item", "aria-hidden": "true", children: starNode }, star));
             }
-            return (_jsx("button", { type: "button", className: "rating__item rating__item--interactive", role: "radio", "aria-checked": 값 === star, "aria-label": t('rating.starLabel', { n: star }), "data-star": star, tabIndex: star === 탭자리 ? 0 : -1, onClick: () => handleClick(star), onMouseEnter: () => handleMouseEnter(star), children: starNode }, star));
+            return (_jsx("button", { type: "button", className: "rating__item rating__item--interactive", role: "radio", "aria-checked": current === star, "aria-label": t('rating.starLabel', { n: star }), "data-star": star, tabIndex: star === tabValue ? 0 : -1, onClick: () => handleClick(star), onMouseEnter: () => handleMouseEnter(star), children: starNode }, star));
         }) }));
 }