@ihabdevteam/core 0.322.0 → 0.323.0

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

@@ -41,13 +41,13 @@ export function todayWeekValue() {
 export function buildMonthChartData(points) {
     const now = getTodayKstDate();
     const curKey = `${now.getFullYear()}년 ${now.getMonth() + 1}월`;
-    const 달키 = (y, m0) => `${y}년 ${m0 + 1}월`;
+    const monthKey = (y, m0) => `${y}년 ${m0 + 1}월`;
     const byMonth = new Map();
     byMonth.set(curKey, []);
     for (const p of points) {
         if (isNaN(p.date.getTime()))
             continue;
-        const key = 달키(p.date.getFullYear(), p.date.getMonth());
+        const key = monthKey(p.date.getFullYear(), p.date.getMonth());
         if (!byMonth.has(key))
             byMonth.set(key, []);
         byMonth.get(key).push(p);
@@ -61,16 +61,16 @@ export function buildMonthChartData(points) {
             continue;
         const year = Number(m[1]);
         const month0 = Number(m[2]) - 1;
-        const 첫월 = firstMondayOfMonth(year, month0);
-        const 오늘이앞 = key === curKey && now.getDate() < 첫월;
-        if (!오늘이앞 && !pts.some(p => p.date.getDate() < 첫월))
+        const firstMonday = firstMondayOfMonth(year, month0);
+        const todayBeforeFirst = key === curKey && now.getDate() < firstMonday;
+        if (!todayBeforeFirst && !pts.some(p => p.date.getDate() < firstMonday))
             continue;
         const prev = new Date(year, month0, 0);
-        const prevKey = 달키(prev.getFullYear(), prev.getMonth());
+        const prevKey = monthKey(prev.getFullYear(), prev.getMonth());
         if (!byMonth.has(prevKey))
             byMonth.set(prevKey, []);
     }
-    const 칸들 = new Map();
+    const cells = new Map();
     for (const [key, pts] of byMonth) {
         const m = key.match(/^(\d+)년 (\d+)월$/);
         if (!m)
@@ -96,18 +96,18 @@ export function buildMonthChartData(points) {
                 for (let k = 0; k < partsLen; k++)
                     dayPartsB[d][k] += p.partsB[k] ?? 0;
         }
-        칸들.set(key, { year, month, daysInMonth, partsLen, hasPartsB, dayA, dayB, dayParts, dayPartsB });
+        cells.set(key, { year, month, daysInMonth, partsLen, hasPartsB, dayA, dayB, dayParts, dayPartsB });
     }
     /** 그 날이 오늘 뒤인가 — 다음 달 날을 이어 붙일 때 미래는 세지 않는다 */
-    const 미래 = (y, m0, d) => new Date(y, m0, d).getTime() > new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
+    const isFuture = (y, m0, d) => new Date(y, m0, d).getTime() > new Date(now.getFullYear(), now.getMonth(), now.getDate()).getTime();
     const result = {};
-    for (const [key, 칸] of 칸들) {
-        const { year, month, daysInMonth, dayA, dayB, dayParts, dayPartsB } = 칸;
+    for (const [key, cell] of cells) {
+        const { year, month, daysInMonth, dayA, dayB, dayParts, dayPartsB } = cell;
         const isCurMonth = year === now.getFullYear() && month === now.getMonth();
         const today = now.getDate();
-        const 다음 = 칸들.get(달키(month === 11 ? year + 1 : year, (month + 1) % 12));
+        const nextCell = cells.get(monthKey(month === 11 ? year + 1 : year, (month + 1) % 12));
         /* 마지막 주가 다음 달 계열을 더 많이 가질 수 있다 — 그 주만 넓힌다 */
-        const partsLen = 칸.partsLen;
+        const partsLen = cell.partsLen;
         const daily = [];
         for (let d = 1; d <= daysInMonth; d++) {
             const isFuture = isCurMonth && d > today;
@@ -118,16 +118,16 @@ export function buildMonthChartData(points) {
                 a: isFuture && dayA[d] === 0 && dayB[d] === 0 ? -1 : dayA[d],
                 b: dayB[d],
                 ...(partsLen ? { parts: dayParts[d] } : {}),
-                ...(partsLen && 칸.hasPartsB ? { partsB: dayPartsB[d] } : {}),
+                ...(partsLen && cell.hasPartsB ? { partsB: dayPartsB[d] } : {}),
             });
         }
         // 월요일 시작 — 그 달의 '첫 월요일'부터 7일 단위로 버킷. 첫 월요일 이전 날짜는
         // 이전 달의 마지막(걸침) 주에 속하므로 이 달에서는 제외한다. 마지막 주는 다음 달로 넘어간다.
         const weekly = [];
         for (let start = firstMondayOfMonth(year, month); start <= daysInMonth; start += 7) {
-            const 넘침 = Math.max(0, start + 6 - daysInMonth); // 다음 달에서 이어 붙일 날 수
-            const wLen = 넘침 && 다음 ? Math.max(partsLen, 다음.partsLen) : partsLen;
-            const wHasB = 칸.hasPartsB || !!(넘침 && 다음?.hasPartsB);
+            const spill = Math.max(0, start + 6 - daysInMonth); // 다음 달에서 이어 붙일 날 수
+            const wLen = spill && nextCell ? Math.max(partsLen, nextCell.partsLen) : partsLen;
+            const wHasB = cell.hasPartsB || !!(spill && nextCell?.hasPartsB);
             let a = 0;
             let b = 0;
             const wParts = new Array(wLen).fill(0);
@@ -140,20 +140,20 @@ export function buildMonthChartData(points) {
                     wPartsB[k] += dayPartsB[d][k];
                 }
             }
-            if (넘침 && 다음) {
-                for (let d = 1; d <= 넘침; d++) {
-                    if (미래(다음.year, 다음.month, d))
+            if (spill && nextCell) {
+                for (let d = 1; d <= spill; d++) {
+                    if (isFuture(nextCell.year, nextCell.month, d))
                         break;
-                    a += 다음.dayA[d];
-                    b += 다음.dayB[d];
-                    for (let k = 0; k < 다음.partsLen; k++) {
-                        wParts[k] += 다음.dayParts[d][k];
-                        wPartsB[k] += 다음.dayPartsB[d][k];
+                    a += nextCell.dayA[d];
+                    b += nextCell.dayB[d];
+                    for (let k = 0; k < nextCell.partsLen; k++) {
+                        wParts[k] += nextCell.dayParts[d][k];
+                        wPartsB[k] += nextCell.dayPartsB[d][k];
                     }
                 }
             }
-            const 끝 = 넘침 ? `${(month + 1) % 12 + 1}/${넘침}` : `${start + 6}`;
-            weekly.push({ label: `${weekly.length + 1}주`, sublabel: `[${start}일~${끝}일]`, a, b, ...(wLen ? { parts: wParts } : {}), ...(wLen && wHasB ? { partsB: wPartsB } : {}) });
+            const endLabel = spill ? `${(month + 1) % 12 + 1}/${spill}` : `${start + 6}`;
+            weekly.push({ label: `${weekly.length + 1}주`, sublabel: `[${start}일~${endLabel}일]`, a, b, ...(wLen ? { parts: wParts } : {}), ...(wLen && wHasB ? { partsB: wPartsB } : {}) });
         }
         result[key] = { weekly, daily };
     }
@@ -178,5 +178,25 @@ export const MONTH_OPTIONS = genMonthOptions();
 /** 지금 시각 기준 월 옵션 — 모듈 상수(MONTH_OPTIONS)는 불러온 순간의 달에 굳어, 탭을 열어 둔 채 달이 넘어가면 이번 달이
  *  옵션에서 빠졌다. 컨트롤 훅은 자료가 바뀔 때마다 이것으로 다시 만든다. */
 export function monthOptionsNow() { return genMonthOptions(); }
-// 한글 서수(주차) — '첫째주', '둘째주' …
-export const KO_ORD = ['첫째', '둘째', '셋째', '넷째', '다섯째', '여섯째', '일곱째'];
+/**
+ * 몇째 주인가를 **지금 언어로** 적는다 — `0` 이 첫째 주다.
+ *
+ * **언어 가름을 부르는 쪽이 하지 않는다.** 전에는 한글 서수 배열(`KO_ORD`)을 내주고
+ * 쓰는 쪽마다 `lang.startsWith('ko') ? KO_ORD[w] + '주' : 'Week ' + (w+1)` 를 되풀이했다 —
+ * 코어 두 자리와 말귀 한 자리가 **같은 가름을 각자** 적고 있었다. 말이 하나 늘면 세 자리를
+ * 다 고쳐야 하고, 한 자리만 안 고치면 화면에서 갈린다.
+ *
+ * 글귀는 사전이 쥔다(`calendar.weekLabel`·`calendar.weekOrdinal`) — 한국어는 서수가
+ * 규칙으로 안 나와(첫째·둘째…) 표가 필요하고, **그 표의 자리는 코드가 아니라 사전이다.**
+ * 서수 표가 없는 말은 `{{n}}` 으로 적는다(영어 `Week 3`).
+ *
+ * @public
+ */
+export function weekLabel(t, week) {
+    const ords = t('calendar.weekOrdinal', { returnObjects: true, defaultValue: [] });
+    const ord = Array.isArray(ords) && typeof ords[week] === 'string' ? ords[week] : null;
+    /* **변수는 하나다(`ord`).** 말마다 다른 변수를 쓰면(`{{ord}}` vs `{{n}}`) 사전 지킴이가
+       운다 — 로케일을 바꿀 때 `{{변수}}` 가 그대로 보이거나 값이 비는 꼴이다. 영어 서수 표는
+       숫자 그대로(`'1'`…)여서 `Week {{ord}}` 가 같은 변수로 맞는다. */
+    return t('calendar.weekLabel', { ord: ord ?? String(week + 1) });
+}

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

@@ -4,12 +4,12 @@ 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, 첫날),
+const rangeOf = (y, m0, firstDay, dayCount) => ({
+    from: kstStartOfDay(y, m0, firstDay),
     // 끝은 그날의 **마지막 밀리초까지** — 23:59:59.000 이면 마지막 999ms 에 남은 기록이 목록에서 빠졌다
-    to: new Date(kstStartOfDay(y, m0, 첫날 + 날수).getTime() - 1),
-    fromYmd: ymdOf(y, m0, 첫날),
-    toYmd: ymdOf(y, m0, 첫날 + 날수 - 1),
+    to: new Date(kstStartOfDay(y, m0, firstDay + dayCount).getTime() - 1),
+    fromYmd: ymdOf(y, m0, firstDay),
+    toYmd: ymdOf(y, m0, firstDay + dayCount - 1),
 });
 /**
  * 현재 컨트롤 선택(주/월)의 기간 — 상세보기(기간별 리스트)용. **KST 의 날로 자른다**(해외 기기도 같은 기간).
@@ -23,8 +23,8 @@ export function getControlDateRange(control, offset = 0) {
         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 dayCount = new Date(Date.UTC(y, m0 + 1, 0)).getUTCDate();
+        return rangeOf(y, m0, 1, dayCount);
     }
     const opt = control.weekRanges.find(o => o.value === control.weekRange);
     if (!opt) {
@@ -33,5 +33,5 @@ export function getControlDateRange(control, offset = 0) {
         return { from: n, to: n, fromYmd: ymd, toYmd: ymd };
     }
     const firstMon = firstMondayOfMonth(opt.year, opt.month - 1);
-    return 범위(opt.year, opt.month - 1, firstMon + (opt.week + offset) * 7, 7);
+    return rangeOf(opt.year, opt.month - 1, firstMon + (opt.week + offset) * 7, 7);
 }

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

@@ -10,23 +10,23 @@ export function splitTrackList(template) {
     if (!template)
         return [];
     const out = [];
-    let 깊이 = 0;
-    let 조각 = '';
+    let depth = 0;
+    let piece = '';
     for (const c of template.trim()) {
         if (c === '(')
-            깊이++;
+            depth++;
         else if (c === ')')
-            깊이--;
-        if (/\s/.test(c) && 깊이 === 0) {
-            if (조각) {
-                out.push(조각);
-                조각 = '';
+            depth--;
+        if (/\s/.test(c) && depth === 0) {
+            if (piece) {
+                out.push(piece);
+                piece = '';
             }
             continue;
         }
-        조각 += c;
+        piece += c;
     }
-    if (조각)
-        out.push(조각);
+    if (piece)
+        out.push(piece);
     return out;
 }

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

@@ -7,11 +7,11 @@
  *
  * 같은 fixed 기준(뷰포트, 또는 transform 을 건 조상 — 놀이터 시연 틀)을 쓰는 자리끼리만 쌓는다.
  */
-const 자리수 = new Map();
-let 관찰 = null;
+const offsets = new Map();
+let observer = null;
 const GAP = 12;
 /* fixed 의 기준이 되는 조상 — transform·filter·perspective·contain 이 걸린 가장 가까운 조상, 없으면 문서 */
-function 기준찾기(el) {
+function rootOf(el) {
     for (let p = el.parentElement; p && p !== document.body; p = p.parentElement) {
         const cs = window.getComputedStyle(p);
         if ((cs.transform && cs.transform !== 'none') || (cs.filter && cs.filter !== 'none') || (cs.perspective && cs.perspective !== 'none') || /paint|layout|strict|content/.test(cs.contain || ''))
@@ -19,27 +19,27 @@ function 기준찾기(el) {
     }
     return document;
 }
-function 다시쌓기() {
-    const 무리 = new Map();
-    for (const el of 자리수.keys()) {
+function restack() {
+    const byRoot = new Map();
+    for (const el of offsets.keys()) {
         if (!el.isConnected)
             continue;
-        const k = 기준찾기(el);
-        const 줄 = 무리.get(k) ?? [];
-        줄.push(el);
-        무리.set(k, 줄);
+        const k = rootOf(el);
+        const list = byRoot.get(k) ?? [];
+        list.push(el);
+        byRoot.set(k, list);
     }
-    for (const 줄 of 무리.values()) {
-        줄.sort((a, b) => (a.compareDocumentPosition(b) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1));
-        let 아래로 = 0;
-        for (const el of 줄) {
-            if (아래로 > 0)
-                el.style.setProperty('--update-alert-stack-offset', `${아래로}px`);
+    for (const list of byRoot.values()) {
+        list.sort((a, b) => (a.compareDocumentPosition(b) & Node.DOCUMENT_POSITION_FOLLOWING ? -1 : 1));
+        let offset = 0;
+        for (const el of list) {
+            if (offset > 0)
+                el.style.setProperty('--update-alert-stack-offset', `${offset}px`);
             else
                 el.style.removeProperty('--update-alert-stack-offset');
             const h = el.getBoundingClientRect().height;
             if (h > 0)
-                아래로 += h + GAP;
+                offset += h + GAP;
         }
     }
 }
@@ -47,22 +47,22 @@ function 다시쌓기() {
 export function registerUpdateAlertSlot(el) {
     if (typeof window === 'undefined')
         return () => { };
-    자리수.set(el, (자리수.get(el) ?? 0) + 1);
-    if (자리수.get(el) === 1 && typeof ResizeObserver !== 'undefined') {
-        관찰 ??= new ResizeObserver(() => 다시쌓기());
-        관찰.observe(el);
+    offsets.set(el, (offsets.get(el) ?? 0) + 1);
+    if (offsets.get(el) === 1 && typeof ResizeObserver !== 'undefined') {
+        observer ??= new ResizeObserver(() => restack());
+        observer.observe(el);
     }
-    다시쌓기();
+    restack();
     return () => {
-        const n = (자리수.get(el) ?? 1) - 1;
+        const n = (offsets.get(el) ?? 1) - 1;
         if (n > 0) {
-            자리수.set(el, n);
-            다시쌓기();
+            offsets.set(el, n);
+            restack();
             return;
         }
-        자리수.delete(el);
-        관찰?.unobserve(el);
+        offsets.delete(el);
+        observer?.unobserve(el);
         el.style.removeProperty('--update-alert-stack-offset');
-        다시쌓기();
+        restack();
     };
 }

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

@@ -1,14 +1,14 @@
 'use client';
 import { useState, useEffect, useMemo, useCallback } from 'react';
 import { useTranslation } from 'react-i18next';
-import { firstMondayOfMonth, todayWeekValue, monthOptionsNow, KO_ORD } from './barChartData';
+import { firstMondayOfMonth, todayWeekValue, monthOptionsNow, weekLabel } from './barChartData';
 /**
  * BarChart 기간 상태/옵션/네비게이션을 캡슐화한 훅.
  * 여러 BarChart가 하나의 컨트롤을 공유하려면 이 훅을 상위에서 호출해 control을 내려준다.
  * @public
  */
 export function useBarChartControl(data) {
-    const { t, i18n } = useTranslation();
+    const { t } = useTranslation();
     const [period, setPeriod] = useState('week');
     // 달 옵션·오늘은 자료가 바뀔 때 다시 센다 — 모듈 로드 때 한 번 세면 자정을 넘긴 탭에서 이번 달·오늘 주가 옛날에 굳었다
     const DATA_MONTH_OPTIONS = useMemo(() => monthOptionsNow().filter(o => o.value in data), [data]);
@@ -26,10 +26,8 @@ export function useBarChartControl(data) {
     }, [DATA_MONTH_OPTIONS]);
     const weekOptionLabel = useCallback((o) => {
         const m = t('calendar.yearMonth', { year: o.year, month: o.month });
-        return i18n.language?.startsWith('ko')
-            ? `${m} ${KO_ORD[o.week] ?? `${o.week + 1}`}주`
-            : `${m} Week ${o.week + 1}`;
-    }, [t, i18n.language]);
+        return `${m} ${weekLabel(t, o.week)}`;
+    }, [t]);
     const monthOptions = useMemo(() => DATA_MONTH_OPTIONS.map(o => ({
         value: o.value, label: t('calendar.yearMonth', { year: o.year, month: o.month }),
     })), [t, DATA_MONTH_OPTIONS]);

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

@@ -1,7 +1,7 @@
 'use client';
 import { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react';
 /** 글자 하나든 한 줄이든 **줄에 적히는 말**을 꺼낸다 */
-function 라벨(x) {
+function labelOf(x) {
     return typeof x === 'string' ? x : x.label;
 }
 /**
@@ -18,7 +18,7 @@ export function useComboboxSuggestions({ value, onChange, suggestions, openOnFoc
     const [open, setOpen] = useState(false);
     const [activeIdx, setActiveIdx] = useState(-1);
     const blurTimerRef = useRef(null);
-    const 계산한것 = useMemo(() => {
+    const computed = useMemo(() => {
         if (!suggestions.length)
             return [];
         const v = value ?? '';
@@ -30,40 +30,40 @@ export function useComboboxSuggestions({ value, onChange, suggestions, openOnFoc
             return openOnFocus ? suggestions : [];
         if (typeof filterSuggestions === 'function')
             return filterSuggestions(suggestions, v);
-        return suggestions.filter(s => 라벨(s).toLowerCase().includes(v.toLowerCase()));
+        return suggestions.filter(s => labelOf(s).toLowerCase().includes(v.toLowerCase()));
     }, [suggestions, value, openOnFocus, filterSuggestions]);
     /* **한글 조합 중에는 0 건이 되어도 직전 목록을 둔다.** '사'→'삭'→'사고' 로 치는 동안 중간값 '삭' 에 걸리는 후보가 없어
        목록이 한 박자 사라졌다 돌아왔다(깜빡임·스크린리더가 목록 닫힘을 알림). 조합이 끝나면(compositionend) 다시 계산한다.
        부르는 쪽이 suggestions 를 값으로 미리 거른 경우(matchesWordQuery 순위 등)도 같다 — 순위 규칙은 건드리지 않는다. */
-    const [조합중, set조합중] = useState(false);
-    const 직전목록 = useRef([]);
-    const filtered = 조합중 && 계산한것.length === 0 ? 직전목록.current : 계산한것;
+    const [composing, setComposing] = useState(false);
+    const prevList = useRef([]);
+    const filtered = composing && computed.length === 0 ? prevList.current : computed;
     useEffect(() => { if (filtered.length)
-        직전목록.current = filtered; }, [filtered]);
-    const handleCompositionStart = useCallback(() => set조합중(true), []);
-    const handleCompositionEnd = useCallback(() => set조합중(false), []);
+        prevList.current = filtered; }, [filtered]);
+    const handleCompositionStart = useCallback(() => setComposing(true), []);
+    const handleCompositionEnd = useCallback(() => setComposing(false), []);
     // 메뉴가 닫히면 활성 인덱스를 리셋하는 의도된 동기화다
     // eslint-disable-next-line react-hooks/set-state-in-effect
-    const 처음짚는자리 = autoActiveFirst ? 0 : -1;
+    const initialActiveIdx = autoActiveFirst ? 0 : -1;
     useEffect(() => { if (!open)
-        setActiveIdx(처음짚는자리); }, [open, 처음짚는자리]);
+        setActiveIdx(initialActiveIdx); }, [open, initialActiveIdx]);
     useEffect(() => () => { if (blurTimerRef.current)
         clearTimeout(blurTimerRef.current); }, []);
     /* 입력으로 후보가 줄면 가리키던 번호가 목록 밖에 남는다 — 그 채로 Enter 를 누르면 filtered[3] 같은
        없는 칸을 골라 onChange(undefined) 가 나갔다. 밖이면 '안 가리킴' 으로 본다. */
-    const safeIdx = activeIdx < filtered.length ? activeIdx : 처음짚는자리 < filtered.length ? 처음짚는자리 : -1;
+    const safeIdx = activeIdx < filtered.length ? activeIdx : initialActiveIdx < filtered.length ? initialActiveIdx : -1;
     const handleSelect = useCallback((item) => {
         /* 고르는 것이 '값 채우기' 가 아닌 자리가 있다 — 그때는 칸을 안 건드린다 */
         if (onSelectSuggestion)
             onSelectSuggestion(item);
         else
-            onChange?.(라벨(item));
+            onChange?.(labelOf(item));
         setOpen(false);
     }, [onChange, onSelectSuggestion]);
     const handleFocus = useCallback(() => setOpen(true), []);
     /* 글자를 치면 목록을 다시 연다 — 고르거나 Esc 로 닫은 뒤에는 포커스를 뺐다 넣어야만 열렸다.
        새 글자에는 새 후보가 서므로 가리킴도 처음으로 돌린다. */
-    const handleInput = useCallback(() => { setOpen(true); setActiveIdx(처음짚는자리); }, [처음짚는자리]);
+    const handleInput = useCallback(() => { setOpen(true); setActiveIdx(initialActiveIdx); }, [initialActiveIdx]);
     // blur가 리스트 항목의 onMouseDown보다 먼저 발생하는 걸 막기 위한 딜레이
     const handleBlur = useCallback(() => {
         blurTimerRef.current = setTimeout(() => setOpen(false), 120);
@@ -76,12 +76,12 @@ export function useComboboxSuggestions({ value, onChange, suggestions, openOnFoc
         if (e.key === 'ArrowDown') {
             e.preventDefault();
             setOpen(true);
-            setActiveIdx(i => Math.min(filtered.length - 1, (i < filtered.length ? i : 처음짚는자리) + 1));
+            setActiveIdx(i => Math.min(filtered.length - 1, (i < filtered.length ? i : initialActiveIdx) + 1));
         }
         else if (e.key === 'ArrowUp') {
             e.preventDefault();
             /* 첫 줄을 늘 짚는 칸에서는 **안 짚은 상태로 못 올라간다** — 그 상태가 없다 */
-            setActiveIdx(i => Math.max(처음짚는자리, (i < filtered.length ? i : filtered.length) - 1));
+            setActiveIdx(i => Math.max(initialActiveIdx, (i < filtered.length ? i : filtered.length) - 1));
         }
         else if (e.key === 'Enter') {
             // 한글 조합을 끝내는 Enter는 선택이 아니다 — 조합 중엔 제안을 고르지 않는다
@@ -94,7 +94,7 @@ export function useComboboxSuggestions({ value, onChange, suggestions, openOnFoc
                 setOpen(false);
             } // 제안이 열렸을 때만 소비(상위 팝업 ESC보다 우선하지 않도록)
         }
-    }, [filtered, safeIdx, open, handleSelect, 처음짚는자리]);
+    }, [filtered, safeIdx, open, handleSelect, initialActiveIdx]);
     return {
         listId, open, activeIdx: safeIdx, filtered, handleFocus, handleBlur, handleInput, handleKeyDown, handleSelect,
         /** 입력칸의 onCompositionStart 에 건다 — 조합 중에는 걸리는 후보가 0 건이 되어도 직전 목록을 둔다 */

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

@@ -21,16 +21,16 @@ export function useToastLifecycle({ message, position, duration, onClose }) {
     const DURATION_MS = duration;
     const hideTimerRef = useRef(null);
     /* 멈췄다 다시 돌릴 때 **남은 만큼만** 돌리려고 언제 시작했는지와 남은 값을 들고 있는다 */
-    const 시작한때Ref = useRef(0);
-    const 남은Ref = useRef(0);
-    const 멈춤Ref = useRef(false);
+    const startedAtRef = useRef(0);
+    const remainingRef = useRef(0);
+    const pausedRef = useRef(false);
     const exitTimerRef = useRef(null);
     const rafOuterRef = useRef(null);
     const rafInnerRef = useRef(null);
     const styleResetTimerRef = useRef(null);
     /* 사라짐 타이머를 거는 한 곳 — 처음 걸 때도, 멈췄다 다시 돌릴 때도 여기를 쓴다 */
-    const 사라짐걸기 = useRef(() => { });
-    사라짐걸기.current = (ms) => {
+    const scheduleDismissRef = useRef(() => { });
+    scheduleDismissRef.current = (ms) => {
         /* 0 은 막지 않는다 — 0 이면 "지금 사라져라" 이지 "사라지지 마라" 가 아니다.
            다만 **지금 이 값이 0 이 되는 길은 없다.** 걸 때는 부르는 쪽이
            `DURATION_MS > 0` 로 가리고, `resume()` 이 남은 0 으로 부르려면 그 전에
@@ -39,8 +39,8 @@ export function useToastLifecycle({ message, position, duration, onClose }) {
            뜻이 맞는 쪽으로만 적어 둔다. */
         if (ms < 0)
             return;
-        시작한때Ref.current = Date.now();
-        남은Ref.current = ms;
+        startedAtRef.current = Date.now();
+        remainingRef.current = ms;
         hideTimerRef.current = setTimeout(() => {
             hideTimerRef.current = null;
             setShowing(false);
@@ -54,18 +54,18 @@ export function useToastLifecycle({ message, position, duration, onClose }) {
         }, ms);
     };
     const pause = useCallback(() => {
-        if (멈춤Ref.current || !hideTimerRef.current)
+        if (pausedRef.current || !hideTimerRef.current)
             return;
-        멈춤Ref.current = true;
+        pausedRef.current = true;
         clearTimeout(hideTimerRef.current);
         hideTimerRef.current = null;
-        남은Ref.current = Math.max(0, 남은Ref.current - (Date.now() - 시작한때Ref.current));
+        remainingRef.current = Math.max(0, remainingRef.current - (Date.now() - startedAtRef.current));
     }, []);
     const resume = useCallback(() => {
-        if (!멈춤Ref.current)
+        if (!pausedRef.current)
             return;
-        멈춤Ref.current = false;
-        사라짐걸기.current(남은Ref.current);
+        pausedRef.current = false;
+        scheduleDismissRef.current(remainingRef.current);
     }, []);
     // message 변경 시 진입/퇴장 애니메이션과 타이머를 재구동하는 의도된 동기화다
     /* eslint-disable react-hooks/set-state-in-effect */
@@ -88,10 +88,10 @@ export function useToastLifecycle({ message, position, duration, onClose }) {
                     /* 멈춘 채(마우스·포커스가 올라가 있는 채) 문구가 바뀌면 시계를 새로 걸지 않는다 — 전에는 멈춤을 풀고 걸어
                        읽고 있는 알림이 손 밑에서 사라졌고, 떠날 때의 resume 은 멈춤이 이미 풀려 아무것도 안 했다.
                        새 문구의 시간은 **처음부터** 남겨 두고 resume 이 그만큼 돌린다. */
-                    if (멈춤Ref.current)
-                        남은Ref.current = DURATION_MS;
+                    if (pausedRef.current)
+                        remainingRef.current = DURATION_MS;
                     else
-                        사라짐걸기.current(DURATION_MS);
+                        scheduleDismissRef.current(DURATION_MS);
                 }
                 lastMessageRef.current = message;
                 /* 여기서 건 사라짐 타이머도 떠날 때 걷는다 — 빈 정리 함수라 문구를 바꾼 뒤 언마운트하면 타이머가 살아
@@ -154,8 +154,8 @@ export function useToastLifecycle({ message, position, duration, onClose }) {
                 setShowing(true);
             }
             if (DURATION_MS > 0) {
-                멈춤Ref.current = false;
-                사라짐걸기.current(DURATION_MS);
+                pausedRef.current = false;
+                scheduleDismissRef.current(DURATION_MS);
             }
         }
         else {

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

@@ -4,10 +4,23 @@
  */
 import type { CSSProperties } from 'react';
 export type WordTableOrientation = 'landscape' | 'portrait';
-/** @public */
-export type WordTableContentType = '단어' | '이미지' | '표준 발음' | '구어체 발음';
-/** @public */
-export type WordTableCutLine = '표시' | '점선' | '코너' | '미표시';
+/**
+ * 단어표 칸에 무엇을 그리나 — **코드다, 보일 글이 아니다.**
+ *
+ * 2026-10-13 한글 값(`'단어'`·`'이미지'`…)에서 옮겼다(사장님 지시 "모두 표준으로"). 저장되는
+ * 값이 표시 언어에 묶이면 **말을 고치려 해도 자료를 밀어야** 한다 — 보일 글은 사전이 쥐고
+ * (`wordTable.filter.*`), 코드는 안 바뀐다. 같은 저장소의 `wordAttributeFilterCodes` 가
+ * 이미 그 꼴이었다(`'grade'`·`'native'`…).
+ *
+ * 옮길 때 소비자 넷을 셌다 — `WordTableContentType`·`WordTableCutLine` 을 적는 줄이 **0** 이고,
+ * 저장되는 자리도 없었다(`SavedWordTable` 에 안 들고 `localStorage` 에도 안 적는다).
+ * 그래서 받침 없이 그냥 옮겼다 — `DeviceSide` 때와 달리 밀 자료가 없다.
+ *
+ * @public
+ */
+export type WordTableContentType = 'word' | 'image' | 'standardPron' | 'colloquialPron';
+/** 칸 사이 선 — **코드다.** 보일 글은 사전(`wordTable.filter.show`·`.dotted`·`.corner`·`.hide`). @public */
+export type WordTableCutLine = 'show' | 'dashed' | 'corner' | 'hide';
 /** 페이지 분할 시 종이 안에 찍는 페이지 번호 위치 — 'none'이면 미표시 */
 /** @public */
 export type PageNumberPosition = 'left' | 'center' | 'right' | 'none';

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

@@ -102,10 +102,10 @@ export function gridFor(orientation, count) {
     return { cols, rows };
 }
 export const CUT_CLASS = {
-    '표시': 'word-table-block__content--cut-show',
-    '점선': '',
-    '코너': 'word-table-block__content--cut-corner',
-    '미표시': '',
+    show: 'word-table-block__content--cut-show',
+    dashed: '',
+    corner: 'word-table-block__content--cut-corner',
+    hide: '',
 };
 export const POS_LABEL = {
     '명': '명사', '동': '동사', '형': '형용사', '부': '부사',
@@ -175,7 +175,7 @@ export function expandSlashLabel(raw, labelMap) {
     return raw.split('/').map(part => labelMap[part] ?? part).join('/');
 }
 export function dotDashStyle(index, cols, rows, cutLine) {
-    if (cutLine !== '점선')
+    if (cutLine !== 'dashed')
         return {};
     const col = index % cols;
     const row = Math.floor(index / cols);

package/dist/packages/core/src/context/I18nProvider.js

@@ -3,18 +3,18 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useMemo } from 'react';
 import i18n, { SUPPORTED_LOCALES, DEFAULT_LOCALE } from '../i18n';
 import { I18nContext } from './I18nContext';
-function 지원코드(locale) {
-    const 있나 = (c) => SUPPORTED_LOCALES.some(l => l.code === c);
-    if (있나(locale))
+function supportedCode(locale) {
+    const has = (c) => SUPPORTED_LOCALES.some(l => l.code === c);
+    if (has(locale))
         return locale;
-    const 기본 = locale.split(/[-_]/)[0]?.toLowerCase() ?? '';
-    return 있나(기본) ? 기본 : DEFAULT_LOCALE;
+    const base = locale.split(/[-_]/)[0]?.toLowerCase() ?? '';
+    return has(base) ? base : DEFAULT_LOCALE;
 }
 /** @public */
 export function I18nProvider({ locale = DEFAULT_LOCALE, children }) {
     /* 지역이 붙은 코드('en-US'·'ko_KR')는 기본 언어로 읽는다 — 전에는 목록에 없다고 기본(ko)으로 떨어져 영어를 달라 했는데
        한국어가 나오고, context 의 locale 은 'en-US' 로 남아 둘이 갈렸다. context 에도 실제로 건 코드를 넣는다. */
-    const code = 지원코드(locale);
+    const code = supportedCode(locale);
     useEffect(() => {
         if (i18n.language !== code) {
             i18n.changeLanguage(code);