@ihabdevteam/core 0.322.0 → 0.323.0

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

@@ -20,7 +20,7 @@ import { isTouchPointer, recentlyTouched, useTouchToggle } from '../hooks/touchT
 
    ihab 은 **흰 판을 마스크로 쓴다**(사용자 지시 2026-09-30: 글자색을 입힌다) — 그쪽은
    `WordTable.css` 가 제 곁의 파일을 직접 가리키므로 여기서 안 들여온다. */
-import 말귀로고 from '../logo/Logo_speechear_kr.svg';
+import speechearLogo from '../logo/Logo_speechear_kr.svg';
 import { WORD_TABLE_PAPER, gridFor, CUT_CLASS, posLabels, wordTypeLabels, expandSlashLabel, dotDashStyle, REF_W_BOTH, REF_W_TEXT_ONLY, REF_W_IMAGE_ONLY, REF_H_BOTH, REF_H_TEXT_ONLY, REF_H_IMAGE_ONLY, } from './wordTableLayout';
 import { useFitScale } from './useFitScale';
 import { claimSound } from './Training/currentSound';
@@ -32,7 +32,7 @@ import { playOneShot } from './Training/oneShotSound';
    (상수 하나는 남긴다 — 규칙이 상수는 허용하고, 지우면 공개 API 가 바뀐다.) */
 export { WORD_TABLE_PAPER } from './wordTableLayout';
 /** 눈에는 안 보이고 낭독기에는 읽히는 글자(ProgressIndicator 와 같은 규칙) */
-const 보이지않게 = {
+const srOnly = {
     position: 'absolute', width: 1, height: 1, margin: -1, padding: 0, overflow: 'hidden',
     clipPath: 'inset(50%)', whiteSpace: 'nowrap', border: 0,
 };
@@ -42,9 +42,9 @@ const 보이지않게 = {
  * 300~500ms 가 흔한 값이다(iOS 의 길게 누르기는 500ms, Android 는 400ms 안팎).
  * 짧으면 살짝 스친 손가락에 칸이 끌려가고, 길면 "안 되네" 하고 손을 뗀다.
  */
-const 길게누름_MS = 400;
+const LONG_PRESS_MS = 400;
 /** 길게 누르기가 익기 전에 이만큼 움직이면 그건 끌기가 아니라 **스크롤**이라 취소한다 */
-const 움직임문턱_PX = 8;
+const MOVE_THRESHOLD_PX = 8;
 function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true, showImage = true, showPronunciation = true, showColloquial = true, buttonSize = 40, wordInfo, }) {
     const { t } = useTranslation();
     const outerRef = useRef(null);
@@ -54,7 +54,7 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
     const [playing, setPlaying] = useState(false);
     /* 받은 주소에 **어느 낱말의 것인지** 를 함께 둔다 — 주소만 들고 있으면 같은 칸의 낱말이 바뀐 뒤 새 주소를 받는 동안(또는
        못 받으면) 누를 때 앞 낱말 소리가 났다(틀린 자극). 지금 낱말의 것일 때만 쓴다. */
-    const [받은소리, set받은소리] = useState({ for: '', url: '' });
+    const [fetchedAudio, setFetchedAudio] = useState({ for: '', url: '' });
     const [infoAnchor, setInfoAnchor] = useState(null);
     // 발음(subLabel)이 없으면 단어로 표준발음 조회(앱 주입 resolver)
     const pron = (subLabel && subLabel.length > 0) ? subLabel : (getPronunciationResolver()?.(label, homonum) ?? '');
@@ -63,7 +63,7 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
     const handleInfoEnter = useCallback(() => setInfoAnchor(infoRef.current?.getBoundingClientRect() ?? null), []);
     const handleInfoLeave = useCallback(() => setInfoAnchor(null), []);
     /* 터치 — 톡하면 열렸다 떼자마자 닫혀 낱말 정보를 읽을 수 없었다. 톡으로 열고 닫는다(마우스·키보드는 그대로) */
-    const 정보톡 = useTouchToggle(!!infoAnchor, (next) => { if (next)
+    const infoToggle = useTouchToggle(!!infoAnchor, (next) => { if (next)
         handleInfoEnter();
     else
         handleInfoLeave(); }, infoRef);
@@ -83,8 +83,8 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
             arr.push(t('wordTable.info.wordType', { v: expandSlashLabel(wordInfo.wordType, wordTypeLabels(t)), defaultValue: '유형: {{v}}' }));
         return arr.length ? arr : null;
     }, [wordInfo, t]);
-    const 소리열쇠 = pron || label;
-    const audioUrl = 받은소리.for === 소리열쇠 ? 받은소리.url : '';
+    const audioKey = pron || label;
+    const audioUrl = fetchedAudio.for === audioKey ? fetchedAudio.url : '';
     useEffect(() => {
         const resolver = getTTSUrlResolver();
         const ttsText = pron || label;
@@ -92,7 +92,7 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
             return;
         let cancelled = false;
         Promise.resolve(resolver(ttsText)).then(url => { if (!cancelled && url)
-            set받은소리({ for: ttsText, url }); });
+            setFetchedAudio({ for: ttsText, url }); });
         return () => { cancelled = true; };
     }, [pron, label]);
     // 컴포넌트 언마운트 시 발음 재생 중단 — audioRef는 <audio> JSX가 아니라 new Audio()로
@@ -122,11 +122,11 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
         /* 끝나거나 멈추면 **그 자리에서** 자리를 비운다 — 약속으로 받으면 한 틱 늦어, 남이
            자물쇠를 가져간 순간에 이 칸이 아직 "재생 중" 으로 보인다.
            이미 다음 사람이 가져갔으면 release 는 아무것도 안 한다. */
-        const 소리 = playOneShot(audioUrl, () => { setPlaying(false); releaseRef.current?.(); });
-        audioRef.current = 소리.el;
-        stopRef.current = 소리.stop;
+        const sound = playOneShot(audioUrl, () => { setPlaying(false); releaseRef.current?.(); });
+        audioRef.current = sound.el;
+        stopRef.current = sound.stop;
         /* 자물쇠를 잡으면 앞서 울리던 것(다른 칸·훈련 카드 등)이 멈추고, 남이 잡으면 stop 이 불려 내가 멈춘다 */
-        releaseRef.current = claimSound(소리.stop);
+        releaseRef.current = claimSound(sound.stop);
     }, [playing, audioUrl]);
     const hasImage = showImage && !!imageUrl && !imgFailed;
     const refW = hasImage && showWord ? REF_W_BOTH : hasImage ? REF_W_IMAGE_ONLY : REF_W_TEXT_ONLY;
@@ -165,7 +165,7 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
                         /* 아이콘만 있는 버튼이라 이름이 없으면 화면 낭독기가 "버튼"으로만 읽는다.
                            한 표에 칸마다 하나씩 있어 열두 개가 다 "버튼"이 된다 — 어느 낱말의
                            것인지 알 길이 없으므로 낱말을 이름에 넣는다. */
-                        ariaLabel: t('wordTable.wordInfo', '{{word}} 낱말 정보', { word: label }), onClick: (e) => { e.stopPropagation(); 정보톡.touchPress(); } }), infoAnchor && infoTooltipItems && (_jsx(DescriptionTooltip, { anchorRect: infoAnchor, items: infoTooltipItems, showIndex: false }))] }))] }));
+                        ariaLabel: t('wordTable.wordInfo', '{{word}} 낱말 정보', { word: label }), onClick: (e) => { e.stopPropagation(); infoToggle.touchPress(); } }), infoAnchor && infoTooltipItems && (_jsx(DescriptionTooltip, { anchorRect: infoAnchor, items: infoTooltipItems, showIndex: false }))] }))] }));
 }
 /**
  * 단어표(표 디자인) — A4 종이를 컨테이너에 맞춰 축소(scale)하고,
@@ -173,7 +173,7 @@ function WordCell({ label, subLabel, colloquialLabel, homonum, showWord = true,
  * 표시(items)·편집(editCells) 두 모드를 지원한다.
  * @public
  */
-export default function WordTable({ title, titleIcon, disc, className, orientation = 'landscape', contentTypes = ['이미지', '단어', '표준 발음'], cutLine = '표시', showOutline = true, showDivLine = true, items, editCells, count, activeCell = null, onActivateCell, onRemoveCell, onRemoveItem, onReorder, renderCellAction, showFillerAdd = false, contentRef, buttonSize = 40, brand, code, pageNumber, pageNumberPosition = 'right', fitHeight = false, scoring = false, marks, onMarkClick, scoreIndexOffset = 0, }) {
+export default function WordTable({ title, titleIcon, disc, className, orientation = 'landscape', contentTypes = ['image', 'word', 'standardPron'], cutLine = 'show', showOutline = true, showDivLine = true, items, editCells, count, activeCell = null, onActivateCell, onRemoveCell, onRemoveItem, onReorder, renderCellAction, showFillerAdd = false, contentRef, buttonSize = 40, brand, code, pageNumber, pageNumberPosition = 'right', fitHeight = false, scoring = false, marks, onMarkClick, scoreIndexOffset = 0, }) {
     const clickMark = useCallback((cellIndex, clicked) => {
         onMarkClick?.(scoreIndexOffset + cellIndex, clicked);
     }, [onMarkClick, scoreIndexOffset]);
@@ -188,7 +188,7 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
         _jsx("div", { className: cx('word-table-cell__score', mark ? 'word-table-cell__score--marked' : ''), 
             /* CSS 의 가운데 맞춤(translateX(-50%))을 그대로 두고 되돌림만 얹는다. 바닥 가운데를
                기준으로 키워야 칸 아래쪽에 붙은 자리가 흔들리지 않는다. */
-            style: 채점되돌림 > 1 ? { transform: `translateX(-50%) scale(${채점되돌림})`, transformOrigin: 'bottom center' } : undefined, children: MARKS.map(m => (_jsx("span", { className: cx('word-table-cell__score-slot', mark === m ? 'word-table-cell__score-slot--on' : ''), children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", 
+            style: markUnscale > 1 ? { transform: `translateX(-50%) scale(${markUnscale})`, transformOrigin: 'bottom center' } : undefined, children: MARKS.map(m => (_jsx("span", { className: cx('word-table-cell__score-slot', mark === m ? 'word-table-cell__score-slot--on' : ''), children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", 
                     /* **동그라미다**(말귀 요청 ㊸, 2026-10-01). `Button` 기본은 모서리가 둥근
                        네모(`shape="rounded"`)인데, 같은 평가를 말하는 셈과 낱말 목록은
                        `CircleBadge` 라 한 창 안에서 **같은 뜻이 두 모양**으로 섰다.
@@ -197,7 +197,7 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
                        프롭으로 열지 않는다: 둥근 네모를 원하는 자리가 없고, 열어 두면 **같은
                        결정을 자리마다 다시 적어야** 해서 조용히 갈린다(말귀가 두 창에서 실제로
                        갈렸다 — 회차 창은 동그라미, 채점 창은 둥근 네모). */
-                    shape: "pill", icon: MARK_ICON[m], variant: mark === m ? MARK_VARIANT[m] : 'default', selected: mark === m, useBorder: false, ...(매길수있나 ? {} : { tabIndex: -1, role: 'img' }), 
+                    shape: "pill", icon: MARK_ICON[m], variant: mark === m ? MARK_VARIANT[m] : 'default', selected: mark === m, useBorder: false, ...(canMark ? {} : { tabIndex: -1, role: 'img' }), 
                     /* **마우스를 올리면 이름이 뜬다**(말귀 요청 ㊴, 2026-10-01). 이 셋은 아이콘만
                        있어 낭독기에는 `낙지 맞음` 으로 제대로 읽히는데 **눈으로 보는 사람에게는
                        이름이 없었다** — 세모가 '애매' 인지 '반만 맞음' 인지 알 길이 없다.
@@ -205,14 +205,14 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
                        얹은 자리에서 알고 싶은 것은 이 표식이 무엇이냐 하나다.
                        `ariaLabel` 은 그대로 둔다 — 낭독기는 칸을 안 보고 지나므로 거기서는
                        낱말이 있어야 "어느 칸의 맞음" 인지 알 수 있다. 둘이 일부러 다르다. */
-                    showTooltipInfo: t(`wordTable.scoring.markName.${m}`, { defaultValue: m }), ariaLabel: t(`wordTable.scoring.${m}`, { word: cellLabel, defaultValue: `${cellLabel} ${m}` }), onClick: 매길수있나 ? (e) => { e.stopPropagation(); clickMark(cellIndex, m); } : undefined }) }, m))) }));
+                    showTooltipInfo: t(`wordTable.scoring.markName.${m}`, { defaultValue: m }), ariaLabel: t(`wordTable.scoring.${m}`, { word: cellLabel, defaultValue: `${cellLabel} ${m}` }), onClick: canMark ? (e) => { e.stopPropagation(); clickMark(cellIndex, m); } : undefined }) }, m))) }));
     };
     const { t } = useTranslation();
     const isEdit = editCells !== undefined;
     /** title·titleIcon·disc 중 하나라도 있으면 Section 으로 감싼다 */
     const wrapped = title != null || !!titleIcon || !!disc;
     /* 틀 높이는 화면 폭에 따라 갈린다 — 훅은 늘 부른다(순서 고정) */
-    const 좁은화면 = useMediaQuery('(max-width: 767px)');
+    const isNarrow = useMediaQuery('(max-width: 767px)');
     // 드래그 상태(표시 모드 재정렬)
     const dragIndex = useRef(null);
     const [dragOver, setDragOver] = useState(null);
@@ -221,171 +221,171 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
        바꿀 길이 아예 없었고(끌 수 있다는 것조차 알 수 없다), 터치 기기에서는 HTML5 DnD 가
        굴러가지도 않아 손가락으로도 못 바꿨다. 표를 만드는 화면의 핵심 조작인데
        마우스 있는 사람만 쓸 수 있었다. 마우스 끌기는 그대로 두고 두 길을 더한다. */
-    const 낱말수 = items?.length ?? 0;
+    const wordCount = items?.length ?? 0;
     /** 지금 손가락에 끌려가는 칸 */
-    const [끌기, set끌기] = useState(null);
+    const [dragging, setDragging] = useState(null);
     /** 낭독기에 바뀐 자리를 알리는 글. 처음에는 비워 둔다 — 열자마자 뜬금없이 읽지 않게. */
-    const [옮김알림, set옮김알림] = useState('');
+    const [moveAnnounce, setMoveAnnounce] = useState('');
     /** 다시 그린 뒤 초점을 둘 칸 번호 — 옮긴 칸을 초점이 따라가야 다음 Alt+화살표가 같은 칸을 민다 */
-    const 초점갈곳 = useRef(null);
+    const focusTarget = useRef(null);
     /** 칸 격자 DOM — 손가락 밑의 칸을 찾고, 옮긴 뒤 손잡이에 초점을 주는 데 쓴다 */
-    const 격자 = useRef(null);
+    const gridRef = useRef(null);
     /** 지금 떨어뜨릴 자리(상태와 같은 값의 ref) — pointerup 은 마지막 렌더를 기다려 주지 않는다 */
-    const 떨굴자리 = useRef(null);
+    const dropIndex = useRef(null);
     /** 길게 누르기가 걸어 둔 것들을 한 번에 푸는 함수 */
-    const 풀기 = useRef(null);
+    const release = useRef(null);
     /** `contentRef`(인쇄·캡처용, 부르는 쪽 것)와 우리 `격자` 를 함께 채운다 */
-    const 내용ref = useCallback((el) => {
-        격자.current = el;
+    const gridContentRef = useCallback((el) => {
+        gridRef.current = el;
         if (typeof contentRef === 'function')
             contentRef(el);
         else if (contentRef)
             contentRef.current = el;
     }, [contentRef]);
-    const 옮기기 = useCallback((from, to) => {
-        초점갈곳.current = to;
+    const move = useCallback((from, to) => {
+        focusTarget.current = to;
         onReorder?.(from, to);
-        set옮김알림(t('wordTable.reorder.moved', {
-            n: to + 1, total: 낱말수, defaultValue: '{{total}}칸 가운데 {{n}}번째로 옮김',
+        setMoveAnnounce(t('wordTable.reorder.moved', {
+            n: to + 1, total: wordCount, defaultValue: '{{total}}칸 가운데 {{n}}번째로 옮김',
         }));
-    }, [onReorder, t, 낱말수]);
+    }, [onReorder, t, wordCount]);
     /* 옮긴 칸을 초점이 따라간다. 자리를 잃으면 다음 Alt+화살표가 엉뚱한 칸을 민다 —
        아예 문서 처음으로 튀어 어디였는지도 알 수 없다. 의존성 배열 없이 매 렌더 뒤에
        보되 `초점갈곳` 이 비어 있으면 곧바로 돌아온다(거의 언제나 그렇다). */
     useEffect(() => {
-        const to = 초점갈곳.current;
+        const to = focusTarget.current;
         if (to == null)
             return;
-        초점갈곳.current = null;
-        const 칸 = 격자.current?.querySelectorAll('.word-table-block__card:not(.word-table-block__card--filler)');
-        칸?.[to]?.querySelector('.word-table-block__card-handle button')?.focus();
+        focusTarget.current = null;
+        const cells = gridRef.current?.querySelectorAll('.word-table-block__card:not(.word-table-block__card--filler)');
+        cells?.[to]?.querySelector('.word-table-block__card-handle button')?.focus();
     });
     /* 떠날 때 걸어 둔 것을 푼다 — 길게 누르는 중에 팝업이 닫히면 window 리스너와
        타이머가 남아 사라진 화면의 상태를 건드린다(표의 폭 조절에서 겪은 것과 같다). */
-    useEffect(() => () => { 풀기.current?.(); }, []);
+    useEffect(() => () => { release.current?.(); }, []);
     /**
      * **키보드로 옮긴다** — 손잡이에 초점을 두고 `Alt`+`←`/`→`.
      *
      * 낱말 카드 안 다른 단추(재생·정보·빼기)는 Enter·Space 로 눌리고, 화살표만으로는
      * 아무 일도 안 일어난다. `Alt` 를 얹어 그 둘 어느 쪽과도 부딪히지 않게 했다.
      */
-    const 키로옮기기 = useCallback((e, index) => {
+    const moveByKey = useCallback((e, index) => {
         if (!onReorder)
             return;
         if (!e.altKey || e.ctrlKey || e.metaKey)
             return;
-        const 뒤로 = e.key === 'ArrowRight';
-        if (!뒤로 && e.key !== 'ArrowLeft')
+        const forward = e.key === 'ArrowRight';
+        if (!forward && e.key !== 'ArrowLeft')
             return;
         e.preventDefault();
-        const to = index + (뒤로 ? 1 : -1);
-        if (to < 0 || to >= 낱말수)
+        const to = index + (forward ? 1 : -1);
+        if (to < 0 || to >= wordCount)
             return; // 양 끝 — 아무 일도 하지 않는다
-        옮기기(index, to);
-    }, [onReorder, 낱말수, 옮기기]);
+        move(index, to);
+    }, [onReorder, wordCount, move]);
     /**
      * **손가락으로 옮긴다** — 길게 누르면(400ms) 끌기가 시작되고 손가락 밑의 칸으로 떨어진다.
      *
      * 마우스는 손대지 않는다. 기존 HTML5 드래그 앤 드롭이 그대로 맡는다 —
      * 두 길이 같은 포인터를 두고 다투면 끌기가 중간에 끊긴다.
      */
-    const 길게눌러끌기 = useCallback((e, index) => {
+    const longPressDrag = useCallback((e, index) => {
         if (!onReorder || e.pointerType === 'mouse')
             return;
         /* 칸 안 단추를 길게 누른 것은 그 단추 몫이다(재생·정보·빼기) — 옮기기 손잡이만 예외.
            안 가르면 발음을 들으려고 꾹 누른 손가락에 칸이 끌려간다. */
-        const 눌린단추 = e.target.closest?.('button');
-        if (눌린단추 && !눌린단추.closest('.word-table-block__card-handle'))
+        const pressedButton = e.target.closest?.('button');
+        if (pressedButton && !pressedButton.closest('.word-table-block__card-handle'))
             return;
-        풀기.current?.();
-        const 시작 = { x: e.clientX, y: e.clientY };
-        let 익음 = false;
+        release.current?.();
+        const start = { x: e.clientX, y: e.clientY };
+        let armed = false;
         /* 끌기 중에는 화면이 따라 스크롤되면 안 된다. React 가 다는 touchmove 는 passive 라
            거기서는 막을 수 없어, 익은 순간 직접 단다(passive:false). */
-        const 스크롤막기 = (ev) => { if (익음 && ev.cancelable)
+        const blockScroll = (ev) => { if (armed && ev.cancelable)
             ev.preventDefault(); };
         /* **길이 둘이라 갈라 둔다**(2026-10-10, 코어 자체 조사). *문턱을 넘었나* 는 **안 미룬다** — 그 판정이
            길게누름을 거두는 일이라, 한 틀 미루면 손가락을 움직였는데도 끌기가 익어 버린다. *밑에 어느 칸인가*
            는 `elementFromPoint`(레이아웃을 읽는다) + 상태 바꾸기라 **틀에 한 번으로 모은다** — 보이는 일뿐이다. */
-        let 자리예약 = null;
-        let 마지막점 = null;
-        const 자리셈 = () => {
-            const pt = 마지막점;
+        let rafId = null;
+        let lastPoint = null;
+        const computeIndex = () => {
+            const pt = lastPoint;
             if (!pt)
                 return;
             /* 손가락 밑의 칸. `elementFromPoint` 가 없는 환경(구형·시험)에서는 자리를 못 고른다 —
                그때는 떨어뜨려도 아무 일이 없다(끌기가 시작되지 않은 것과 같다). */
-            const 밑 = document.elementFromPoint?.(pt.x, pt.y);
-            const 칸 = 밑?.closest?.('[data-wordtable-cell]');
-            const i = 칸 ? Number(칸.dataset.wordtableCell) : NaN;
-            const 자리 = Number.isInteger(i) ? i : null;
-            떨굴자리.current = 자리;
-            setDragOver(prev => (prev === 자리 ? prev : 자리));
+            const under = document.elementFromPoint?.(pt.x, pt.y);
+            const cell = under?.closest?.('[data-wordtable-cell]');
+            const i = cell ? Number(cell.dataset.wordtableCell) : NaN;
+            const overIndex = Number.isInteger(i) ? i : null;
+            dropIndex.current = overIndex;
+            setDragOver(prev => (prev === overIndex ? prev : overIndex));
         };
-        const 이동 = (ev) => {
-            if (!익음) {
-                if (Math.abs(ev.clientX - 시작.x) > 움직임문턱_PX || Math.abs(ev.clientY - 시작.y) > 움직임문턱_PX)
-                    해제();
+        const onMove = (ev) => {
+            if (!armed) {
+                if (Math.abs(ev.clientX - start.x) > MOVE_THRESHOLD_PX || Math.abs(ev.clientY - start.y) > MOVE_THRESHOLD_PX)
+                    cleanup();
                 return;
             }
-            마지막점 = { x: ev.clientX, y: ev.clientY };
+            lastPoint = { x: ev.clientX, y: ev.clientY };
             if (typeof requestAnimationFrame === 'undefined') {
-                자리셈();
+                computeIndex();
                 return;
             }
-            if (자리예약 !== null)
+            if (rafId !== null)
                 return;
-            자리예약 = requestAnimationFrame(() => { 자리예약 = null; 자리셈(); });
+            rafId = requestAnimationFrame(() => { rafId = null; computeIndex(); });
         };
-        const 뗌 = () => {
+        const onUp = () => {
             /* **떼기 전에 밀린 셈을 치른다.** 자리셈을 틀로 모았으니, 움직이고 **같은 틀 안에** 떼면 틀이
                오기 전에 여기 닿는다 — 그러면 `떨굴자리` 가 비어 **떨어뜨린 자리를 잃는다.** 옛 시험
                (`wordTableReorder0916`)이 그것을 짚었다. 모으는 고침을 할 때는 **그 값을 읽는 쪽**도 봐야 한다. */
-            if (자리예약 !== null) {
-                cancelAnimationFrame(자리예약);
-                자리예약 = null;
-                자리셈();
+            if (rafId !== null) {
+                cancelAnimationFrame(rafId);
+                rafId = null;
+                computeIndex();
             }
-            const 자리 = 떨굴자리.current;
-            const 끌었다 = 익음;
-            해제();
-            if (끌었다 && 자리 != null && 자리 !== index)
-                옮기기(index, 자리);
+            const dropAt = dropIndex.current;
+            const didDrag = armed;
+            cleanup();
+            if (didDrag && dropAt != null && dropAt !== index)
+                move(index, dropAt);
         };
-        const 타이머 = setTimeout(() => {
-            익음 = true;
-            set끌기(index);
-            떨굴자리.current = index;
+        const timer = setTimeout(() => {
+            armed = true;
+            setDragging(index);
+            dropIndex.current = index;
             setDragOver(index);
             /* **안-모음: `preventDefault()` 는 못 미룬다** — 틀로 미루면 이벤트가 이미 지나가 막을 수 없다
                (`passive: false` 로 다는 까닭이 그것이다). */
-            window.addEventListener('touchmove', 스크롤막기, { passive: false });
-        }, 길게누름_MS);
-        function 해제() {
-            clearTimeout(타이머);
-            window.removeEventListener('pointermove', 이동);
-            window.removeEventListener('pointerup', 뗌);
-            window.removeEventListener('pointercancel', 뗌);
-            window.removeEventListener('touchmove', 스크롤막기);
-            익음 = false;
-            if (자리예약 !== null) {
-                cancelAnimationFrame(자리예약);
-                자리예약 = null;
+            window.addEventListener('touchmove', blockScroll, { passive: false });
+        }, LONG_PRESS_MS);
+        function cleanup() {
+            clearTimeout(timer);
+            window.removeEventListener('pointermove', onMove);
+            window.removeEventListener('pointerup', onUp);
+            window.removeEventListener('pointercancel', onUp);
+            window.removeEventListener('touchmove', blockScroll);
+            armed = false;
+            if (rafId !== null) {
+                cancelAnimationFrame(rafId);
+                rafId = null;
             }
-            떨굴자리.current = null;
-            풀기.current = null;
-            set끌기(null);
+            dropIndex.current = null;
+            release.current = null;
+            setDragging(null);
             setDragOver(null);
         }
-        풀기.current = 해제;
-        window.addEventListener('pointermove', 이동);
-        window.addEventListener('pointerup', 뗌);
-        window.addEventListener('pointercancel', 뗌);
-    }, [onReorder, 옮기기]);
+        release.current = cleanup;
+        window.addEventListener('pointermove', onMove);
+        window.addEventListener('pointerup', onUp);
+        window.addEventListener('pointercancel', onUp);
+    }, [onReorder, move]);
     const { width, height } = WORD_TABLE_PAPER[orientation];
     /* 담는 틀의 높이 — 수나 `{ wide, narrow }` 를 주면 표가 그 틀을 스스로 두른다(`true` 는 예전대로 부모 몫) */
-    const 틀높이 = typeof fitHeight === 'number' ? fitHeight
-        : (fitHeight && typeof fitHeight === 'object') ? (좁은화면 ? fitHeight.narrow : fitHeight.wide)
+    const frameHeight = typeof fitHeight === 'number' ? fitHeight
+        : (fitHeight && typeof fitHeight === 'object') ? (isNarrow ? fitHeight.narrow : fitHeight.wide)
             : null;
     // 스케일러 — 용지(width 고정)를 컨테이너 폭에 맞춰 축소 + 가운데 정렬. fitHeight면 높이도 함께 맞춘다.
     const { scalerRef, scale, offset } = useFitScale(width, fitHeight ? height : undefined);
@@ -393,10 +393,10 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
     const cellCount = Math.max(count ?? dataLen, 1);
     const { cols, rows } = gridFor(orientation, cellCount);
     const show = {
-        word: contentTypes.length === 0 || contentTypes.includes('단어'),
-        image: contentTypes.length === 0 || contentTypes.includes('이미지'),
-        pron: contentTypes.length === 0 || contentTypes.includes('표준 발음'),
-        colloq: contentTypes.length === 0 || contentTypes.includes('구어체 발음'),
+        word: contentTypes.length === 0 || contentTypes.includes('word'),
+        image: contentTypes.length === 0 || contentTypes.includes('image'),
+        pron: contentTypes.length === 0 || contentTypes.includes('standardPron'),
+        colloq: contentTypes.length === 0 || contentTypes.includes('colloquialPron'),
     };
     const hasPairs = isEdit
         ? (editCells ?? []).some(c => c !== null && c.length > 1)
@@ -405,16 +405,16 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
        그 값들도 설 자리가 없다 — 켜는 스위치를 하나로 둔다. */
     /* 띠를 쓰기로 한 종이인가 — 한쪽을 꺼도 이 종이는 '띠를 쓰는 꼴'이다.
        쪽 번호가 어디에 서는지를 이 값이 가른다(아래를 보라). */
-    const 브랜드쓰나 = Boolean(brand?.show);
-    const 위띠쓰나 = Boolean(brand?.show) && brand?.top !== false;
-    const 아래띠쓰나 = Boolean(brand?.show) && brand?.bottom !== false;
-    const 저작권 = brand?.copyright ?? '© IHAB, Inc. All rights reserved.';
+    const showBrand = Boolean(brand?.show);
+    const showTopBand = Boolean(brand?.show) && brand?.top !== false;
+    const showBottomBand = Boolean(brand?.show) && brand?.bottom !== false;
+    const copyright = brand?.copyright ?? '© IHAB, Inc. All rights reserved.';
     const contentClass = cx('word-table-block__content', CUT_CLASS[cutLine], showOutline && 'word-table-block__content--outline', showDivLine && hasPairs && 'word-table-block__content--div-line', 
     /* 번호가 설 자리를 비운다 — 번호가 없으면 비우지 않는다(표가 공연히 낮아지지 않게) */
-    !브랜드쓰나 && pageNumber && pageNumberPosition !== 'none' && 'word-table-block__content--page-number', 
+    !showBrand && pageNumber && pageNumberPosition !== 'none' && 'word-table-block__content--page-number', 
     /* 띠가 설 자리를 위아래로 비운다 — 같은 까닭으로 띠가 없으면 안 비운다.
        바닥 띠가 쪽 번호 자리를 겸하므로 둘이 겹쳐도 아래는 한 번만 비운다(CSS 가 덮어쓴다). */
-    위띠쓰나 && 'word-table-block__content--brand-top', 아래띠쓰나 && 'word-table-block__content--brand-bottom');
+    showTopBand && 'word-table-block__content--brand-top', showBottomBand && 'word-table-block__content--brand-bottom');
     // 빈칸(추가버튼)은 스케일 역보정으로 실제 크기 유지
     const counterScale = { transform: `scale(${1 / scale})`, transformOrigin: 'center center' };
     /* **채점 단추는 표와 함께 줄어들면 안 된다.**
@@ -423,7 +423,7 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
        다만 끝까지 되돌리면(1/scale) 단추 셋(40×3 + 사이 8 = 128)이 **칸보다 넓어져** 옆 칸을
        침범한다 — 칸 폭을 천장으로 둔다. 이 견줌은 표 좌표에서 하므로 배율이 양쪽에서 약분된다.
        넓은 화면(배율 1)에서는 1 이라 아무것도 달라지지 않는다. */
-    const 채점행폭 = buttonSize * MARKS.length + 4 * (MARKS.length - 1);
+    const markRowWidth = buttonSize * MARKS.length + 4 * (MARKS.length - 1);
     /* **누를 수 없는 표에서는 되돌리지 않는다**(말귀 요청 ㊷, 2026-10-01).
        위 되돌림은 '손가락으로 누를 수 있게' 하려고 있는 것이다. `onMarkClick` 이 없으면
        눌러도 아무 일이 없으므로(바로 위 `clickMark` 가 빈 호출이다) 되돌릴 까닭이 없고,
@@ -431,19 +431,19 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
        배율을 그대로 받아 작아져, 칸이 작을수록 표시가 **낱말 위로 올라탄다**
        (말귀 실측: 데스크톱 배율 0.54·40px 에서 `사과`·`수박` 을 덮었다).
        지난 채점을 **매긴 그 표 그대로** 펴 보이는 창이 그 자리다. */
-    const 매길수있나 = Boolean(onMarkClick);
-    const 채점되돌림 = 매길수있나 ? Math.max(1, Math.min(1 / scale, (width / cols) / 채점행폭)) : 1;
+    const canMark = Boolean(onMarkClick);
+    const markUnscale = canMark ? Math.max(1, Math.min(1 / scale, (width / cols) / markRowWidth)) : 1;
     const grid = (_jsxs("div", { ref: scalerRef, className: "word-table__scaler", style: { height: height * scale }, children: [_jsx("div", { 
                 /* title 로 Section 에 감쌀 때는 className 을 바깥 한 곳에만 — 두 곳에 붙어 소비자 스타일이 두 번 걸렸다 */
                 /* 읽기만 하는 채점 표 — 안 매긴 ○△✕ 를 드러내지 않는다(CSS 가 받는다).
                    드러내는 규칙은 '매길 수 있게' 하려고 있는 것이라, 손가락 기기에서 셋이
                    늘 서면 **읽기만 하는 표가 아직 안 매긴 표처럼** 보였다(말귀 요청 ㊷). */
-                className: cx('word-table', scoring && !매길수있나 && 'word-table--score-readonly', !wrapped && className), style: { width, height, transform: `scale(${scale})`, transformOrigin: 'top left', marginLeft: offset }, children: _jsxs("div", { ref: 내용ref, className: contentClass, style: {
+                className: cx('word-table', scoring && !canMark && 'word-table--score-readonly', !wrapped && className), style: { width, height, transform: `scale(${scale})`, transformOrigin: 'top left', marginLeft: offset }, children: _jsxs("div", { ref: gridContentRef, className: contentClass, style: {
                         gridTemplateColumns: `repeat(${cols}, 1fr)`,
                         gridTemplateRows: `repeat(${rows}, 1fr)`,
                     }, children: [isEdit ? (_jsx(_Fragment, { children: (editCells ?? []).map((cell, i) => (_jsx("div", { className: cx('word-table-block__edit-cell', cell ? 'word-table-block__edit-cell--filled' : 'word-table-block__edit-cell--empty', activeCell === i ? 'word-table-block__edit-cell--active' : ''), style: dotDashStyle(i, cols, rows, cutLine), children: cell ? (_jsxs(_Fragment, { children: [cell.map((e, wi) => (_jsxs(Fragment, { children: [wi > 0 && _jsx("div", { className: "word-table-block__pair-divider" }), _jsx(WordCell, { label: e.word, subLabel: e.pronunciation, 
                                                     // 편집 칸도 구어체 발음을 넘긴다 — 빠져 있어 '구어체 발음'을 켜도 편집 모드에서만 비었다.
-                                                    colloquialLabel: e.colloquialPronunciation, homonum: e.homonum, showWord: show.word, showImage: show.image, showPronunciation: show.pron, showColloquial: show.colloq, buttonSize: buttonSize })] }, wi))), scoring && renderScore(i, cell.map(e => e.word).join(' / ')), onRemoveCell && (_jsx("div", { className: "word-table-block__card-close", children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "x", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: cell.length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), ariaLabel: cell.length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), onClick: () => onRemoveCell(i) }) }))] })) : (onActivateCell && (_jsx("div", { style: counterScale, children: _jsx(Button, { htmlType: "button", size: "48", type: "bar", icon: "plus", label: t('wordTable.addWord', '추가하기'), onClick: () => onActivateCell(i) }) }))) }, i))) })) : (_jsxs(_Fragment, { children: [(items ?? []).map((item, index) => (_jsxs("div", { "data-wordtable-cell": onReorder ? index : undefined, className: `word-table-block__card${onReorder ? ' word-table-block__card--draggable' : ''}${dragOver === index ? ' word-table-block__card--drag-over' : ''}${끌기 === index ? ' word-table-block__card--dragging' : ''}`, style: dotDashStyle(index, cols, rows, cutLine), draggable: !!onReorder, onPointerDown: onReorder ? (e) => 길게눌러끌기(e, index) : undefined, onKeyDown: onReorder ? (e) => 키로옮기기(e, index) : undefined, onDragStart: onReorder ? () => { dragIndex.current = index; } : undefined, onDragOver: onReorder ? (e) => { e.preventDefault(); setDragOver(index); } : undefined, onDragLeave: onReorder ? () => setDragOver(null) : undefined, onDrop: onReorder ? (e) => { e.preventDefault(); if (dragIndex.current !== null && dragIndex.current !== index) {
+                                                    colloquialLabel: e.colloquialPronunciation, homonum: e.homonum, showWord: show.word, showImage: show.image, showPronunciation: show.pron, showColloquial: show.colloq, buttonSize: buttonSize })] }, wi))), scoring && renderScore(i, cell.map(e => e.word).join(' / ')), onRemoveCell && (_jsx("div", { className: "word-table-block__card-close", children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "x", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: cell.length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), ariaLabel: cell.length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), onClick: () => onRemoveCell(i) }) }))] })) : (onActivateCell && (_jsx("div", { style: counterScale, children: _jsx(Button, { htmlType: "button", size: "48", type: "bar", icon: "plus", label: t('wordTable.addWord', '추가하기'), onClick: () => onActivateCell(i) }) }))) }, i))) })) : (_jsxs(_Fragment, { children: [(items ?? []).map((item, index) => (_jsxs("div", { "data-wordtable-cell": onReorder ? index : undefined, className: `word-table-block__card${onReorder ? ' word-table-block__card--draggable' : ''}${dragOver === index ? ' word-table-block__card--drag-over' : ''}${dragging === index ? ' word-table-block__card--dragging' : ''}`, style: dotDashStyle(index, cols, rows, cutLine), draggable: !!onReorder, onPointerDown: onReorder ? (e) => longPressDrag(e, index) : undefined, onKeyDown: onReorder ? (e) => moveByKey(e, index) : undefined, onDragStart: onReorder ? () => { dragIndex.current = index; } : undefined, onDragOver: onReorder ? (e) => { e.preventDefault(); setDragOver(index); } : undefined, onDragLeave: onReorder ? () => setDragOver(null) : undefined, onDrop: onReorder ? (e) => { e.preventDefault(); if (dragIndex.current !== null && dragIndex.current !== index) {
                                         onReorder(dragIndex.current, index);
                                     } ; dragIndex.current = null; setDragOver(null); } : undefined, onDragEnd: onReorder ? () => { dragIndex.current = null; setDragOver(null); } : undefined, children: [(item.words ?? []).map((w, i) => (_jsxs(Fragment, { children: [i > 0 && _jsx("div", { className: "word-table-block__pair-divider" }), _jsx(WordCell, { label: w.label, subLabel: w.subLabel, colloquialLabel: w.colloquialLabel, homonum: w.homonum, showWord: show.word, showImage: show.image, showPronunciation: show.pron, showColloquial: show.colloq, buttonSize: buttonSize, wordInfo: (w.grade || w.syllables != null || w.pos || w.wordType) ? { grade: w.grade, syllables: w.syllables, pos: w.pos, wordType: w.wordType } : undefined })] }, i))), scoring && renderScore(index, (item.words ?? []).map(w => w.label).join(' / ')), onReorder && (
                                         /* **옮기기 손잡이.** 키보드로 순서를 바꾸려면 초점이 갈 자리가 있어야 하는데,
@@ -460,26 +460,26 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
                                         _jsxs("div", { className: "word-table-block__card-actions", children: [renderCellAction?.(index, item), onRemoveItem && (_jsx("div", { className: "word-table-block__card-close", children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "dot", icon: "x", variant: "transparent-lightGray", useBorder: false, showTooltipInfo: (item.words ?? []).length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), ariaLabel: (item.words ?? []).length > 1 ? t('wordPrint.removePair', '대립쌍 빼기') : t('wordPrint.removeWord', '단어 빼기'), onClick: () => onRemoveItem(item.id) }) }))] }))] }, item.id))), Array.from({ length: Math.max(0, cols * rows - (items?.length ?? 0)) }).map((_, i) => {
                                     const isWithinCount = (items?.length ?? 0) + i < cellCount;
                                     return (_jsx("div", { className: "word-table-block__card word-table-block__card--filler", children: showFillerAdd && onActivateCell && isWithinCount && (_jsx("div", { style: counterScale, children: _jsx(Button, { htmlType: "button", size: buttonSize, type: "bar", icon: "plus", label: t('wordTable.addWord', '추가하기'), onClick: () => onActivateCell((items?.length ?? 0) + i) }) })) }, `filler-${i}`));
-                                })] })), 위띠쓰나 && (_jsx(_Fragment, { children: _jsxs("div", { className: "word-table__band word-table__band--top", children: [_jsx("img", { className: "word-table__brand-logo", src: brand?.topLogo?.src ?? 말귀로고, alt: brand?.topLogo?.alt ?? '말귀' }), (() => {
+                                })] })), showTopBand && (_jsx(_Fragment, { children: _jsxs("div", { className: "word-table__band word-table__band--top", children: [_jsx("img", { className: "word-table__brand-logo", src: brand?.topLogo?.src ?? speechearLogo, alt: brand?.topLogo?.alt ?? '말귀' }), (() => {
                                         /* 표 제목 · 기관 이름 · 표 번호 — 있는 것끼리만 가운뎃점으로 잇는다
                                            (사용자 지시 2026-09-30). 없는 것 자리에 점이 남으면 안 된다. */
-                                        const 조각들 = [
+                                        const pieces = [
                                             brand?.title && _jsx("span", { className: "word-table__paper-title", children: brand.title }, "t"),
                                             brand?.owner && _jsx("span", { className: "word-table__owner", children: brand.owner }, "o"),
                                             code && _jsx("span", { className: "word-table__code", children: code }, "c"),
                                         ].filter(Boolean);
-                                        if (조각들.length === 0)
+                                        if (pieces.length === 0)
                                             return null;
-                                        return (_jsx("span", { className: "word-table__ident", children: 조각들.map((조각, i) => (_jsxs(Fragment, { children: [i > 0 && _jsx("span", { className: "word-table__ident-dot", "aria-hidden": "true", children: "\u00B7" }), 조각] }, i))) }));
-                                    })()] }) })), 아래띠쓰나 && (_jsx(_Fragment, { children: _jsxs("div", { className: "word-table__band word-table__band--bottom", children: [_jsxs("span", { className: "word-table__brand-by", children: [brand?.bottomLogo
+                                        return (_jsx("span", { className: "word-table__ident", children: pieces.map((piece, i) => (_jsxs(Fragment, { children: [i > 0 && _jsx("span", { className: "word-table__ident-dot", "aria-hidden": "true", children: "\u00B7" }), piece] }, i))) }));
+                                    })()] }) })), showBottomBand && (_jsx(_Fragment, { children: _jsxs("div", { className: "word-table__band word-table__band--bottom", children: [_jsxs("span", { className: "word-table__brand-by", children: [brand?.bottomLogo
                                                 ? _jsx("img", { className: "word-table__brand-logo--ihab word-table__brand-logo--given", src: brand.bottomLogo.src, alt: brand.bottomLogo.alt })
-                                                : _jsx("span", { className: "word-table__brand-logo--ihab", role: "img", "aria-label": "IHAB" }), _jsx("span", { className: "word-table__copyright", children: 저작권 })] }), _jsxs("span", { className: "word-table__band-end", children: [brand?.link && _jsx("span", { className: "word-table__link", children: brand.link }), pageNumber && pageNumberPosition !== 'none' && (_jsx("span", { className: "word-table__page-count", children: t('wordTable.filter.pageIndicator', { current: pageNumber.current, total: pageNumber.total }) }))] })] }) })), !브랜드쓰나 && pageNumber && pageNumberPosition !== 'none' && (_jsx("span", { className: `word-table__page-number body-3 word-table__page-number--${pageNumberPosition}`, children: t('wordTable.filter.pageIndicator', { current: pageNumber.current, total: pageNumber.total }) }))] }) }), onReorder && _jsx("span", { role: "status", style: 보이지않게, children: 옮김알림 })] }));
+                                                : _jsx("span", { className: "word-table__brand-logo--ihab", role: "img", "aria-label": "IHAB" }), _jsx("span", { className: "word-table__copyright", children: copyright })] }), _jsxs("span", { className: "word-table__band-end", children: [brand?.link && _jsx("span", { className: "word-table__link", children: brand.link }), pageNumber && pageNumberPosition !== 'none' && (_jsx("span", { className: "word-table__page-count", children: t('wordTable.filter.pageIndicator', { current: pageNumber.current, total: pageNumber.total }) }))] })] }) })), !showBrand && pageNumber && pageNumberPosition !== 'none' && (_jsx("span", { className: `word-table__page-number body-3 word-table__page-number--${pageNumberPosition}`, children: t('wordTable.filter.pageIndicator', { current: pageNumber.current, total: pageNumber.total }) }))] }) }), onReorder && _jsx("span", { role: "status", style: srOnly, children: moveAnnounce })] }));
     /* 담는 틀 — 높이를 받은 자리에서만 두른다. `useFitScale` 은 **스케일러의 부모**를 재므로
        이 틀이 곧 그 자(척도)가 된다. 가운데 맞춤은 남는 세로를 위아래로 나눈다 — 표가 상자보다
        납작할 때 아래로만 쏠려 보이지 않게. */
-    const 담긴것 = 틀높이 == null ? grid : (_jsx("div", { className: "word-table__frame", style: { height: 틀높이 }, children: grid }));
+    const contents = frameHeight == null ? grid : (_jsx("div", { className: "word-table__frame", style: { height: frameHeight }, children: grid }));
     if (wrapped) {
-        return (_jsx(Section, { type: "page", icon: titleIcon, title: title, disc: disc, className: cx('word-table-block', className), children: 담긴것 }));
+        return (_jsx(Section, { type: "page", icon: titleIcon, title: title, disc: disc, className: cx('word-table-block', className), children: contents }));
     }
-    return 담긴것;
+    return contents;
 }

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

@@ -1,3 +1,4 @@
+import type { TFunction } from 'i18next';
 /** 막대 하나의 데이터 — a/b 두 계열. a === -1 이면 미래(데이터 없음)로 표시하지 않음.
  *  parts: 다계열용 계열별 값(있으면 a는 합계로 사용).
  *  partsB: `parts` 와 1:1 인 계열별 **분모** — `rate` 에서 계열마다 parts[k]/partsB[k] 를 낸다(a/b 의 계열판). */
@@ -67,4 +68,18 @@ export declare function monthOptionsNow(): {
     year: number;
     month: number;
 }[];
-export declare const KO_ORD: string[];
+/**
+ * 몇째 주인가를 **지금 언어로** 적는다 — `0` 이 첫째 주다.
+ *
+ * **언어 가름을 부르는 쪽이 하지 않는다.** 전에는 한글 서수 배열(`KO_ORD`)을 내주고
+ * 쓰는 쪽마다 `lang.startsWith('ko') ? KO_ORD[w] + '주' : 'Week ' + (w+1)` 를 되풀이했다 —
+ * 코어 두 자리와 말귀 한 자리가 **같은 가름을 각자** 적고 있었다. 말이 하나 늘면 세 자리를
+ * 다 고쳐야 하고, 한 자리만 안 고치면 화면에서 갈린다.
+ *
+ * 글귀는 사전이 쥔다(`calendar.weekLabel`·`calendar.weekOrdinal`) — 한국어는 서수가
+ * 규칙으로 안 나와(첫째·둘째…) 표가 필요하고, **그 표의 자리는 코드가 아니라 사전이다.**
+ * 서수 표가 없는 말은 `{{n}}` 으로 적는다(영어 `Week 3`).
+ *
+ * @public
+ */
+export declare function weekLabel(t: TFunction, week: number): string;