@ihabdevteam/core 0.321.0 → 0.322.0

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

@@ -1,7 +1,7 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { cx } from '../../utils/cx';
-import { 한글순 } from '../../utils/textSort';
+import { compareKorean } from '../../utils/textSort';
 import { useEscToClose } from '../../hooks/useEscToClose';
 import { useState, useCallback, useMemo, useEffect } from 'react';
 import { useTranslation } from 'react-i18next';
@@ -86,7 +86,7 @@ export default function WordSearchResultBlock({ titleIcon, resultCount, resultUn
         };
     }, [q]);
     /* 정렬 비교자 — flat/그룹 뷰가 공유한다.
-       **글자 견주기는 `한글순`(콜레이터 하나) 으로만 한다**(말귀 요청 (113), 2026-10-10). 전에는 '시작 우선'
+       **글자 견주기는 `compareKorean`(콜레이터 하나) 으로만 한다**(말귀 요청 (113), 2026-10-10). 전에는 '시작 우선'
        갈래만 콜레이터를 쓰고 **여섯 갈래는 `localeCompare(…, 'ko')`** 였다 — 그 부름은 비교마다 콜레이터를
        새로 만든다. 하필 기본 정렬이 `ganada` 라 **주된 길이 느린 쪽**이었다(말귀 실측 6,357개: 30.3ms → 8.1ms).
        이 파일에 콜레이터가 하나 더 있었던 것(`new Intl.Collator('ko')`)도 걷었다 — 같은 결정이 두 자리에
@@ -104,14 +104,14 @@ export default function WordSearchResultBlock({ titleIcon, resultCount, resultUn
             // 시작 우선 — 검색어로 시작하는 단어를 위로. 앞 q 글자만 잘라 매칭하면 "첫 음절부터 일치"만
             // 남는다(초성 검색도 동일: 'ㄴ' → '나무'가 위). 동순위는 가나다.
             case 'match': {
-                return 시작순위(a) - 시작순위(b) || 한글순(label(a), label(b));
+                return 시작순위(a) - 시작순위(b) || compareKorean(label(a), label(b));
             }
-            case 'ganada': return 한글순(label(a), label(b));
-            case 'ganada_desc': return 한글순(label(b), label(a));
-            case 'syllable': return syll(a) - syll(b) || 한글순(label(a), label(b));
-            case 'syllable_desc': return syll(b) - syll(a) || 한글순(label(a), label(b));
-            case 'grade': return grade(a) - grade(b) || 한글순(label(a), label(b));
-            case 'grade_desc': return grade(b) - grade(a) || 한글순(label(a), label(b));
+            case 'ganada': return compareKorean(label(a), label(b));
+            case 'ganada_desc': return compareKorean(label(b), label(a));
+            case 'syllable': return syll(a) - syll(b) || compareKorean(label(a), label(b));
+            case 'syllable_desc': return syll(b) - syll(a) || compareKorean(label(a), label(b));
+            case 'grade': return grade(a) - grade(b) || compareKorean(label(a), label(b));
+            case 'grade_desc': return grade(b) - grade(a) || compareKorean(label(a), label(b));
             // 받은 순서 — Array.prototype.sort 는 안정 정렬이라 0 이면 받은 차례가 남는다
             default: return 0;
         }

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

@@ -1,4 +1,4 @@
-import { 한글순 } from '../../utils/textSort';
+import { compareKorean } from '../../utils/textSort';
 import { labelOfCellKey } from './wordTableReview';
 /** △ 를 반 점으로 치는 셈 — 저장할 때 서버가 쓰는 규칙과 같다. */
 function 점수(o, triangle, marked) {
@@ -46,7 +46,7 @@ export function weakItems(records) {
         const tried = v.o + v.triangle + v.x;
         out.push({ label: labelOfCellKey(key), key, tried, o: v.o, triangle: v.triangle, x: v.x, rate: 점수(v.o, v.triangle, tried), latest: v.latest, latestAt: v.latestAt });
     }
-    out.sort((a, b) => a.rate - b.rate || b.tried - a.tried || 한글순(a.label, b.label) || 한글순(a.key ?? a.label, b.key ?? b.label));
+    out.sort((a, b) => a.rate - b.rate || b.tried - a.tried || compareKorean(a.label, b.label) || compareKorean(a.key ?? a.label, b.key ?? b.label));
     return out;
 }
 /**

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

@@ -7,7 +7,7 @@
  *
  * 화면도 통신도 없다. 표 목록과 약한 낱말만 받아 순서를 매긴다.
  */
-import { 한글순 } from '../../utils/textSort';
+import { compareKorean } from '../../utils/textSort';
 /**
  * 약한 낱말을 많이 품은 표부터 내놓는다.
  *
@@ -44,7 +44,7 @@ export function recommendTables(tables, weakLabels, limit = 5) {
     }
     out.sort((a, b) => b.covered.length - a.covered.length
         || a.totalCells - b.totalCells
-        || 한글순(a.name, b.name));
+        || compareKorean(a.name, b.name));
     return out.slice(0, Math.max(0, limit));
 }
 /**

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

@@ -67,7 +67,9 @@ export declare const POS_LABEL: Record<string, string>;
 /** 어종(단어 유형) 약호 → 전체 표기. 데이터의 Class 컬럼은 축약형('고유'/'한자'/'외래'/'혼종')을 쓴다. */
 export declare const WORD_TYPE_LABEL: Record<string, string>;
 /** `t` 하나만 받는 작은 꼴 — `TFunction` 을 들여오지 않아 이 모듈이 i18n 에 안 매인다 */
-type 번역 = (k: string, o: {
+/** i18next `t` 와 같은 꼴 — **공개 서명(`posLabels`·`wordTypeLabels`)이 받는 자리**라 이름을 영어로 둔다
+ *  (사용자 지시 2026-10-13). 안쪽 이름은 한글이어도 소비자가 보는 이름은 영어라야 한다. */
+type Translate = (k: string, o: {
     defaultValue: string;
 }) => string;
 /**
@@ -76,12 +78,12 @@ type 번역 = (k: string, o: {
  * 사전에 없는 약호는 한국어 전체 표기(`POS_LABEL`)로 둔다 — 자료에 새 약호가 와도 빈칸이 안 된다.
  * @public
  */
-export declare function posLabels(t: 번역): Record<string, string>;
+export declare function posLabels(t: Translate): Record<string, string>;
 /**
  * **어종 약호 → 지금 언어의 이름**(`{ '한자': 'Sino-Korean', … }`). 쓰는 법은 `posLabels` 와 같다.
  * @public
  */
-export declare function wordTypeLabels(t: 번역): Record<string, string>;
+export declare function wordTypeLabels(t: Translate): Record<string, string>;
 /**
  * 약호 → i18n 열쇠 조각 표(품사·어종).
  *

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

@@ -1,2 +1,2 @@
 /** 마지막 입력이 키보드였으면 true(모르면 false) */
-export declare function 키보드로눌렀나(): boolean;
+export declare function wasKeyboardPress(): boolean;

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

@@ -25,7 +25,7 @@ function 붙이기() {
 // 불러오는 즉시 듣는다 — 첫 누름부터 알아야 한다
 붙이기();
 /** 마지막 입력이 키보드였으면 true(모르면 false) */
-export function 키보드로눌렀나() {
+export function wasKeyboardPress() {
     붙이기();
     return 마지막 === 'keyboard';
 }

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

@@ -1,5 +1,5 @@
 import type { DeviceForm } from '../types/device';
-type Side = '좌' | '우';
+type Side = 'left' | 'right';
 /**
  * 보청기 기기 등록 / 이력 관리 상태를 캡슐화한 훅.
  */
@@ -11,22 +11,10 @@ export declare function useDeviceManagement(): {
     setShowDevice: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     deviceDirection: Side;
     setDeviceDirection: import("react").Dispatch<import("react").SetStateAction<Side>>;
-    devices: {
-        좌: DeviceForm | null;
-        우: DeviceForm | null;
-    };
-    setDevices: import("react").Dispatch<import("react").SetStateAction<{
-        좌: DeviceForm | null;
-        우: DeviceForm | null;
-    }>>;
-    deviceHistory: {
-        좌: DeviceForm[];
-        우: DeviceForm[];
-    };
-    setDeviceHistory: import("react").Dispatch<import("react").SetStateAction<{
-        좌: DeviceForm[];
-        우: DeviceForm[];
-    }>>;
+    devices: Record<Side, DeviceForm | null>;
+    setDevices: import("react").Dispatch<import("react").SetStateAction<Record<Side, DeviceForm | null>>>;
+    deviceHistory: Record<Side, DeviceForm[]>;
+    setDeviceHistory: import("react").Dispatch<import("react").SetStateAction<Record<Side, DeviceForm[]>>>;
     showDeviceList: boolean;
     setShowDeviceList: import("react").Dispatch<import("react").SetStateAction<boolean>>;
     listForSide: Side;

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

@@ -1,7 +1,17 @@
 'use client';
 import { useCallback, useState } from 'react';
-/** form.direction 이 '좌'·'우' 가 아니면 null — 캐스팅만 하면 devices['엉뚱한값'] 같은 열쇠가 생긴다 */
-const toSide = (d) => (d === '좌' || d === '우' ? d : null);
+/**
+ * `form.direction` 이 `'left'`·`'right'` 가 아니면 null — 캐스팅만 하면 `devices['엉뚱한값']` 같은 열쇠가 생긴다.
+ *
+ * **옛 값(`'좌'`·`'우'`)은 받지 않는다.** 2026-10-13 사장님 결정으로 값을 영어로 옮겼고,
+ * 너그럽게 받는 몫은 **소비자가 진다** — 말귀가 DB 와 오가는 길목 한 자리에 세워 두었다
+ * (`toDbDirection`/`fromDbDirection`). 여기서 함께 받으면 **두 자리가 같은 일을 하고**,
+ * DB 가 다 옮겨진 뒤에도 어느 쪽이 걷혔는지 아무도 모르게 된다.
+ *
+ * 걸리면 **조용히 `null`** 이다 — 터지지도 찍지도 않는다. 옛 값이 그대로 들어오면
+ * 기기가 안 골라지는 꼴로 보이니, 소비자는 **코어에 넘기기 전에** 옮겨 둔다.
+ */
+const toSide = (d) => (d === 'left' || d === 'right' ? d : null);
 /**
  * 보청기 기기 등록 / 이력 관리 상태를 캡슐화한 훅.
  */
@@ -10,15 +20,17 @@ const toSide = (d) => (d === '좌' || d === '우' ? d : null);
  */
 export function useDeviceManagement() {
     const [showDevice, setShowDevice] = useState(false);
-    const [deviceDirection, setDeviceDirection] = useState('좌');
-    const [devices, setDevices] = useState({ 좌: null, 우: null });
-    const [deviceHistory, setDeviceHistory] = useState({ 좌: [], 우: [] });
+    const [deviceDirection, setDeviceDirection] = useState('left');
+    /* 열쇠는 `Side`(= `DeviceSide`) **값**(`'left'`·`'right'`) — 서버의 `side` 열에 오가는 자료다.
+       이름도 값도 영어다 — 값은 2026-10-13 사장님 결정으로 옮겼다(`'좌'`·`'우'` → `'left'`·`'right'`). */
+    const [devices, setDevices] = useState({ left: null, right: null });
+    const [deviceHistory, setDeviceHistory] = useState({ left: [], right: [] });
     const [showDeviceList, setShowDeviceList] = useState(false);
-    const [listForSide, setListForSide] = useState('좌');
+    const [listForSide, setListForSide] = useState('left');
     // form.direction은 각 팝업(DeviceRegistrationPopup의 방향 드롭다운, DeviceListPopup의
-    // 좌/우 탭)에서 사용자가 실제로 고른 값이다 — deviceDirection/listForSide는 팝업을 열 때의
+    // left/right 탭)에서 사용자가 실제로 고른 값이다 — deviceDirection/listForSide는 팝업을 열 때의
     // 초기값일 뿐이라 팝업 내부에서 방향을 바꾸면 더 이상 실제 선택과 일치하지 않는다.
-    // 방향이 비었거나 '좌'·'우' 밖이면 **아무것도 바꾸지 않는다** — 예전에는 검사 없이 캐스팅해
+    // 방향이 비었거나 'left'·'right' 밖이면 **아무것도 바꾸지 않는다** — 예전에는 검사 없이 캐스팅해
     // devices·deviceHistory 에 없는 열쇠가 생겼고 prev[side] 가 undefined 라 이력 펼치기에서 터졌다.
     // 팝업은 닫지 않는다(사용자가 방향을 고르고 다시 제출할 수 있게).
     const handleDeviceSubmit = useCallback((form) => {

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

@@ -11,12 +11,12 @@
  * React 가 이 꼴을 위해 내준 길이다(같은 컴포넌트를 바로 다시 그린다).
  *
  * ```ts
- * usePageResetOnChange(`${검색어}|${갈래}|${정렬}`, setPage)
+ * usePageResetOnChange(`${검색어}|${갈래}|${sort}`, setPage)
  * const { pageItems, totalPages } = usePagedList(걸러낸것, 쪽크기, page)
  * ```
  *
- * @param 열쇠 조건을 하나로 이어 붙인 글 — 이것이 달라지면 첫 쪽이다
+ * @param key 조건을 하나로 이어 붙인 글 — 이것이 달라지면 첫 쪽이다
  * @param setPage 쪽 번호를 쥔 쪽에서 준다
  * @public
  */
-export declare function usePageResetOnChange(열쇠: string, setPage: (n: number) => void): void;
+export declare function usePageResetOnChange(key: string, setPage: (n: number) => void): void;

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

@@ -13,18 +13,18 @@ import { useState } from 'react';
  * React 가 이 꼴을 위해 내준 길이다(같은 컴포넌트를 바로 다시 그린다).
  *
  * ```ts
- * usePageResetOnChange(`${검색어}|${갈래}|${정렬}`, setPage)
+ * usePageResetOnChange(`${검색어}|${갈래}|${sort}`, setPage)
  * const { pageItems, totalPages } = usePagedList(걸러낸것, 쪽크기, page)
  * ```
  *
- * @param 열쇠 조건을 하나로 이어 붙인 글 — 이것이 달라지면 첫 쪽이다
+ * @param key 조건을 하나로 이어 붙인 글 — 이것이 달라지면 첫 쪽이다
  * @param setPage 쪽 번호를 쥔 쪽에서 준다
  * @public
  */
-export function usePageResetOnChange(열쇠, setPage) {
-    const [본열쇠, set본열쇠] = useState(열쇠);
-    if (본열쇠 !== 열쇠) {
-        set본열쇠(열쇠);
+export function usePageResetOnChange(key, setPage) {
+    const [본열쇠, set본열쇠] = useState(key);
+    if (본열쇠 !== key) {
+        set본열쇠(key);
         setPage(1);
     }
 }

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

@@ -56,26 +56,37 @@ export interface TableSortOptions<K extends string> {
  * **정렬이 바뀌면 첫 쪽으로** — `useTablePaging` 의 `resetOn` 에 돌려받은 `정렬` 을 그대로 넣는다.
  * `정렬` 은 누를 때만 새 객체가 되므로(렌더마다 새로 만들지 않는다) 그 자체가 열쇠다. 쪽을 따로 들고 있으면 `onSortChange` 에서 되돌린다.
  *
- * `sortRows(rows, 값)` 은 지금 정렬로 줄을 세운 **새 배열**을 준다(정렬이 없으면 받은 배열 그대로) — `칸순`(숫자는 수로,
+ * `sortRows(rows, getValue)` 은 지금 정렬로 줄을 세운 **새 배열**을 준다(정렬이 없으면 받은 배열 그대로) — `compareCell`(숫자는 수로,
  * 한글·영문은 사람 차례) 으로 견주고 **빈 값(null·undefined·'')은 오름·내림 모두 맨 뒤**(ListPopup 과 같은 규칙).
  *
  * @example
- * const { 정렬, 칸, sortRows } = useTableSort<'name' | 'joined'>()
+ * const { sort, field, sortRows } = useTableSort<'name' | 'joined'>()
  * const 세운줄 = useMemo(() => sortRows(rows, (r, key) => r[key]), [rows, sortRows])
- * const { pageRows, pageSizeProps, paginationProps } = useTablePaging(세운줄, 정렬)   // 정렬이 바뀌면 첫 쪽
- * <Table fields={[칸('이름', 'name'), 칸('가입일', 'joined')]} … />
+ * const { pageRows, pageSizeProps, paginationProps } = useTablePaging(세운줄, sort)   // 정렬이 바뀌면 첫 쪽
+ * <Table fields={[field('이름', 'name'), field('가입일', 'joined')]} … />
  *
  * @public
  */
 export declare function useTableSort<K extends string>(opts?: TableSortOptions<K>): {
+    sort: {
+        key: K;
+        asc: boolean;
+    } | null;
+    field: (label: string, key: K) => {
+        label: string;
+        sortDir: "desc" | "asc" | null;
+        onClick: () => void;
+    };
+    sortRows: <R>(rows: readonly R[], getValue: (row: R, key: K) => unknown) => readonly R[];
+    /** @deprecated `sort` 를 쓴다 — 같은 값이다(2026-10-13) */
     정렬: {
         key: K;
         asc: boolean;
     } | null;
+    /** @deprecated `field` 를 쓴다 — 같은 함수다(2026-10-13) */
     칸: (label: string, key: K) => {
         label: string;
         sortDir: "desc" | "asc" | null;
         onClick: () => void;
     };
-    sortRows: <R>(rows: readonly R[], 값: (row: R, key: K) => unknown) => readonly R[];
 };

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

@@ -2,7 +2,7 @@
 import { useCallback, useMemo, useRef, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import { VAP_PAGE_SIZE_OPTIONS } from './useVisitAllPanel';
-import { 칸순빈값뒤 } from '../utils/textSort';
+import { compareCellBlankLast } from '../utils/textSort';
 /**
  * 표의 쪽넘김 — 개수 보기 · 쪽 · 이번 쪽 줄.
  *
@@ -67,14 +67,14 @@ export function useTablePaging(rows, resetOn, opts) {
  * **정렬이 바뀌면 첫 쪽으로** — `useTablePaging` 의 `resetOn` 에 돌려받은 `정렬` 을 그대로 넣는다.
  * `정렬` 은 누를 때만 새 객체가 되므로(렌더마다 새로 만들지 않는다) 그 자체가 열쇠다. 쪽을 따로 들고 있으면 `onSortChange` 에서 되돌린다.
  *
- * `sortRows(rows, 값)` 은 지금 정렬로 줄을 세운 **새 배열**을 준다(정렬이 없으면 받은 배열 그대로) — `칸순`(숫자는 수로,
+ * `sortRows(rows, getValue)` 은 지금 정렬로 줄을 세운 **새 배열**을 준다(정렬이 없으면 받은 배열 그대로) — `compareCell`(숫자는 수로,
  * 한글·영문은 사람 차례) 으로 견주고 **빈 값(null·undefined·'')은 오름·내림 모두 맨 뒤**(ListPopup 과 같은 규칙).
  *
  * @example
- * const { 정렬, 칸, sortRows } = useTableSort<'name' | 'joined'>()
+ * const { sort, field, sortRows } = useTableSort<'name' | 'joined'>()
  * const 세운줄 = useMemo(() => sortRows(rows, (r, key) => r[key]), [rows, sortRows])
- * const { pageRows, pageSizeProps, paginationProps } = useTablePaging(세운줄, 정렬)   // 정렬이 바뀌면 첫 쪽
- * <Table fields={[칸('이름', 'name'), 칸('가입일', 'joined')]} … />
+ * const { pageRows, pageSizeProps, paginationProps } = useTablePaging(세운줄, sort)   // 정렬이 바뀌면 첫 쪽
+ * <Table fields={[field('이름', 'name'), field('가입일', 'joined')]} … />
  *
  * @public
  */
@@ -98,12 +98,23 @@ export function useTableSort(opts) {
         onClick: () => 누름(key),
     }), [정렬, 누름]);
     /** 지금 정렬로 세운 새 배열(정렬 없으면 받은 배열 그대로). 빈 값은 오름·내림 모두 맨 뒤. */
-    const sortRows = useCallback((rows, 값) => {
+    const sortRows = useCallback((rows, getValue) => {
         if (!정렬)
             return rows;
         const { key, asc } = 정렬;
-        return [...rows].sort((a, b) => 칸순빈값뒤(값(a, key), 값(b, key), asc));
+        return [...rows].sort((a, b) => compareCellBlankLast(getValue(a, key), getValue(b, key), asc));
     }, [정렬]);
-    /* 쪽넘김에 그대로 건넨다 — 차례가 바뀌면 첫 쪽으로 돌아가게 */
-    return { 정렬, 칸, sortRows };
+    /* 쪽넘김에 그대로 건넨다 — 차례가 바뀌면 첫 쪽으로 돌아가게.
+       **영어 이름이 정본이다**(`sort`·`field`) — 공개 API 는 영어라야 한다(사용자 지시 2026-10-13).
+       한글 이름(`정렬`·`칸`)은 **같은 것을 가리키는 옛 이름**으로 남긴다: 말귀가 77 줄에서 그 이름으로
+       풀어 쓰고 있어, 한 번에 걷으면 그 저장소가 통째로 빨개진다. 그쪽이 옮긴 뒤 걷는다. */
+    return {
+        sort: 정렬,
+        field: 칸,
+        sortRows,
+        /** @deprecated `sort` 를 쓴다 — 같은 값이다(2026-10-13) */
+        정렬,
+        /** @deprecated `field` 를 쓴다 — 같은 함수다(2026-10-13) */
+        칸,
+    };
 }

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

@@ -56,9 +56,11 @@ export interface WordTrainingFilterCaps {
  * 등급 고르개의 설명 줄들 — 지금 언어로. 사전에 배열이 없으면 한국어 원문.
  *
  * **공개 API 가 아니다**(대응표에 `internal`) — 코어 안에서만 쓰고, 내보내는 것은 못이 읽기 때문이다.
+ * 그래도 **이름은 영어다** — `internal` 이라도 배포 `d.ts` 에는 그대로 나가 소비자 편집기에 보인다
+ * (사용자 지시 2026-10-13. 소비자 사용처 0 이라 옛 이름을 남기지 않았다 — 말귀의 같은 이름 함수는 제 지역 것이다).
  * 앱은 제 열쇠(`wordSearch.filter.gradeInfo`)와 제 받는 함수를 따로 갖는다.
  */
-export declare function 등급설명(t: TFunction): string[];
+export declare function gradeDescriptions(t: TFunction): string[];
 export declare function useWordTrainingFilter(groupKey: string, caps: WordTrainingFilterCaps, opts?: {
     resetOnMount?: boolean;
     resetKey?: string;

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

@@ -78,7 +78,7 @@ function readComposition(saved) {
  * @public
  */
 /** 사전이 배열을 안 주면 한국어 원문으로 물러선다 — 빈 줄을 띄우지 않는다((205)) */
-const 등급설명기본 = [
+const GRADE_DESCRIPTIONS_KO = [
     '1등급 : 학령전기에 습득하여 평생에 걸쳐 일상 언어생활을 하는 데 사용되는 어휘',
     '2등급 : 초등학교 1-2학년 난이도 어휘',
     '3등급 : 초등학교 3-4학년 난이도 어휘',
@@ -89,11 +89,13 @@ const 등급설명기본 = [
  * 등급 고르개의 설명 줄들 — 지금 언어로. 사전에 배열이 없으면 한국어 원문.
  *
  * **공개 API 가 아니다**(대응표에 `internal`) — 코어 안에서만 쓰고, 내보내는 것은 못이 읽기 때문이다.
+ * 그래도 **이름은 영어다** — `internal` 이라도 배포 `d.ts` 에는 그대로 나가 소비자 편집기에 보인다
+ * (사용자 지시 2026-10-13. 소비자 사용처 0 이라 옛 이름을 남기지 않았다 — 말귀의 같은 이름 함수는 제 지역 것이다).
  * 앱은 제 열쇠(`wordSearch.filter.gradeInfo`)와 제 받는 함수를 따로 갖는다.
  */
-export function 등급설명(t) {
-    const v = t('wordPairs.filter.difficultyInfo', { returnObjects: true, defaultValue: 등급설명기본 });
-    return Array.isArray(v) && v.length > 0 && v.every(x => typeof x === 'string') ? v : 등급설명기본;
+export function gradeDescriptions(t) {
+    const v = t('wordPairs.filter.difficultyInfo', { returnObjects: true, defaultValue: GRADE_DESCRIPTIONS_KO });
+    return Array.isArray(v) && v.length > 0 && v.every(x => typeof x === 'string') ? v : GRADE_DESCRIPTIONS_KO;
 }
 export function useWordTrainingFilter(groupKey, caps, opts) {
     const { t, i18n } = useTranslation();
@@ -450,7 +452,7 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
                    사전이 배열을 안 주면(옛 사전을 덮어쓴 소비자 등) **한국어 원문으로 물러선다** — 빈 줄을
                    띄우지 않는다. 재 보고 적는다: `returnObjects` 는 배열을 그대로 주고 `defaultValue` 도
                    배열로 물러선다(i18next 26.4.1). */
-                labelInfo: infoAction(등급설명(t)),
+                labelInfo: infoAction(gradeDescriptions(t)),
             }),
             label: LABELS.gradeLabel,
         });

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

@@ -1,5 +1,5 @@
 export declare const isDev: boolean;
-/** `키` 하나당 한 번만 찍는다. 운영 빌드에서는 아무 일도 하지 않는다. */
-export declare function devWarnOnce(키: string, ...말: unknown[]): void;
+/** `key` 하나당 한 번만 찍는다. 운영 빌드에서는 아무 일도 하지 않는다. */
+export declare function devWarnOnce(key: string, ...args: unknown[]): void;
 /** 시험용 — 기록을 비운다. 운영 코드에서 부를 일은 없다. */
 export declare function __resetDevWarnOnce(): void;

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

@@ -27,12 +27,12 @@ export const isDev = (() => {
         return false;
     }
 })();
-/** `키` 하나당 한 번만 찍는다. 운영 빌드에서는 아무 일도 하지 않는다. */
-export function devWarnOnce(키, ...말) {
-    if (!isDev || 찍은것.has(키))
+/** `key` 하나당 한 번만 찍는다. 운영 빌드에서는 아무 일도 하지 않는다. */
+export function devWarnOnce(key, ...args) {
+    if (!isDev || 찍은것.has(key))
         return;
-    찍은것.add(키);
-    console.warn(...말);
+    찍은것.add(key);
+    console.warn(...args);
 }
 /** 시험용 — 기록을 비운다. 운영 코드에서 부를 일은 없다. */
 export function __resetDevWarnOnce() {

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

@@ -11,4 +11,4 @@ import type { FilterPanelSection } from '../types/filterPanel';
  * 안 담는 절: `note`(고르는 절이 아니다) · `input`(빈 칸을 '전체'라 말하면 거짓이다) ·
  * 고른 것이 없는데 '전체' 보기도 없는 절(말할 것이 없다).
  */
-export declare function buildFilterSummary(sections: readonly FilterPanelSection[], selected: Record<string, string | string[]> | undefined, 전체말: string): string;
+export declare function buildFilterSummary(sections: readonly FilterPanelSection[], selected: Record<string, string | string[]> | undefined, allLabel: string): string;

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

@@ -11,13 +11,13 @@ import { FILTER_ALL_VALUE } from '../types/filterPanel';
  * 안 담는 절: `note`(고르는 절이 아니다) · `input`(빈 칸을 '전체'라 말하면 거짓이다) ·
  * 고른 것이 없는데 '전체' 보기도 없는 절(말할 것이 없다).
  */
-export function buildFilterSummary(sections, selected, 전체말) {
+export function buildFilterSummary(sections, selected, allLabel) {
     const 조각들 = [];
     for (const section of sections ?? []) {
         if (section.type === 'note' || section.type === 'input')
             continue;
         const 이름 = section.displayLabel ?? section.label;
-        const 값 = 값말(section, selected?.[section.label], 전체말);
+        const 값 = 값말(section, selected?.[section.label], allLabel);
         if (값 === null)
             continue;
         조각들.push(`${이름} ${값}`);
@@ -25,12 +25,12 @@ export function buildFilterSummary(sections, selected, 전체말) {
     return 조각들.join(' · ');
 }
 /** 한 절이 무엇으로 정해져 있는지 — 말할 것이 없으면 `null` */
-function 값말(section, sel, 전체말) {
+function 값말(section, sel, allLabel) {
     const 고른것 = Array.isArray(sel) ? sel : sel === undefined ? [] : [sel];
     /* '전체' 는 두 꼴로 온다 — 아무것도 안 고른 것과 '전체' 보기를 고른 것. 같은 말로 읽는다. */
     const 실제 = 고른것.filter(v => v !== FILTER_ALL_VALUE);
     if (실제.length === 0) {
-        return section.allOption ? (section.allLabel ?? 전체말) : null;
+        return section.allOption ? (section.allLabel ?? allLabel) : null;
     }
     return 실제.map(v => 보기말(section, v)).join(', ');
 }

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

@@ -1,6 +1,6 @@
 import type { RefObject } from 'react';
 /** 소비자가 통을 안 알려 줄 때 찾아 보는 이름 — 옛 동작 유지(말귀 셸의 본문). @internal */
-export declare const 기본통고르개 = ".content-area";
+export declare const DEFAULT_SCROLL_SELECTOR = ".content-area";
 /**
  * 갈래를 고른 뒤 본문을 맨 위로 — 내비(SideNav·BottomNav)가 함께 쓴다. @internal
  *
@@ -8,4 +8,4 @@ export declare const 기본통고르개 = ".content-area";
  * 그것이 **아무 일도 하지 않는다** — 그때는 조용히 죽는 대신 개발 모드에 한 번 알린다.
  * 코어가 `.content-area`(소비자 클래스 이름)를 붙잡고 있던 자리라, 부르는 쪽이 통을 알려 주는 것이 정본이다.
  */
-export declare function scrollNavTargetToTop(scrollContainer?: string | RefObject<HTMLElement | null>, 어디서?: string): void;
+export declare function scrollNavTargetToTop(scrollContainer?: string | RefObject<HTMLElement | null>, from?: string): void;

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

@@ -1,6 +1,6 @@
 import { devWarnOnce } from './devWarn';
 /** 소비자가 통을 안 알려 줄 때 찾아 보는 이름 — 옛 동작 유지(말귀 셸의 본문). @internal */
-export const 기본통고르개 = '.content-area';
+export const DEFAULT_SCROLL_SELECTOR = '.content-area';
 /**
  * 갈래를 고른 뒤 본문을 맨 위로 — 내비(SideNav·BottomNav)가 함께 쓴다. @internal
  *
@@ -8,18 +8,18 @@ export const 기본통고르개 = '.content-area';
  * 그것이 **아무 일도 하지 않는다** — 그때는 조용히 죽는 대신 개발 모드에 한 번 알린다.
  * 코어가 `.content-area`(소비자 클래스 이름)를 붙잡고 있던 자리라, 부르는 쪽이 통을 알려 주는 것이 정본이다.
  */
-export function scrollNavTargetToTop(scrollContainer, 어디서 = 'Nav') {
+export function scrollNavTargetToTop(scrollContainer, from = 'Nav') {
     try {
         const el = typeof scrollContainer === 'string'
             ? document.querySelector(scrollContainer)
-            : scrollContainer?.current ?? document.querySelector(기본통고르개);
+            : scrollContainer?.current ?? document.querySelector(DEFAULT_SCROLL_SELECTOR);
         if (el) {
             el.scrollTop = 0;
             return;
         }
         const 문서 = document.scrollingElement ?? document.documentElement;
         if (문서 && 문서.scrollHeight <= 문서.clientHeight) {
-            devWarnOnce('nav-scroll-container', `[${어디서}] 본문을 맨 위로 되돌릴 통을 못 찾았다(기본 ${기본통고르개}) — 창도 구를 수 없어 아무 일도 하지 않는다. scrollContainer 로 통을 알려 준다.`);
+            devWarnOnce('nav-scroll-container', `[${from}] 본문을 맨 위로 되돌릴 통을 못 찾았다(기본 ${DEFAULT_SCROLL_SELECTOR}) — 창도 구를 수 없어 아무 일도 하지 않는다. scrollContainer 로 통을 알려 준다.`);
         }
         window.scrollTo({ top: 0 });
     }

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

@@ -17,7 +17,7 @@
 export declare function pressable<E extends {
     key: string;
     preventDefault: () => void;
-}>(onPress?: (e: E) => void, 옵션?: {
+}>(onPress?: (e: E) => void, options?: {
     role?: 'button' | 'option';
     selected?: boolean;
 }): {};

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

@@ -14,13 +14,13 @@
  * 진짜 `<button>` 을 쓸 수 있으면 그쪽이 낫다. 이건 이미 `<div>`·`<li>` 로 짜인
  * 자리를 **모양을 안 바꾸고** 눌리게 만드는 길이다.
  */
-export function pressable(onPress, 옵션) {
+export function pressable(onPress, options) {
     if (!onPress)
         return {};
     return {
-        role: 옵션?.role ?? 'button',
+        role: options?.role ?? 'button',
         tabIndex: 0,
-        ...(옵션?.selected === undefined ? {} : { 'aria-selected': 옵션.selected }),
+        ...(options?.selected === undefined ? {} : { 'aria-selected': options.selected }),
         onKeyDown: (e) => {
             /* **이 자리 자신에서 난 키만** 받는다. 안에 든 진짜 단추(랜딩 띠의 action 등)에서 누른 Enter 가 올라오면
                전에는 여기서 preventDefault 해 그 단추의 click 을 막고 이 자리의 onPress 를 대신 불렀다. */

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

@@ -20,17 +20,17 @@ export interface TabSessionLike {
  * 여기서 막으면 이 탭이 로그인된 채로 남는다 — 막는 것보다 나쁜 쪽이다.
  *
  * ```ts
- * onAuthStateChange((event, 받은것) => {
+ * onAuthStateChange((event, incoming) => {
  *   getSession().then(({ data }) => {
- *     const 이탭것 = data.session
- *     if (!isSessionForThisTab(받은것, 이탭것)) return   // 다른 탭에서 온 것 — 무시
- *     …이탭것 으로 상태를 맞춘다
+ *     const thisTab = data.session
+ *     if (!isSessionForThisTab(incoming, thisTab)) return   // 다른 탭에서 온 것 — 무시
+ *     …thisTab 으로 상태를 맞춘다
  *   })
  * })
  * ```
  *
- * @param 받은것 이벤트가 실어 온 세션(없을 수 있다)
- * @param 이탭것 `getSession()` 이 이 탭 저장소에서 다시 읽은 세션
+ * @param incoming 이벤트가 실어 온 세션(없을 수 있다)
+ * @param thisTab `getSession()` 이 이 탭 저장소에서 다시 읽은 세션
  * @public
  */
-export declare function isSessionForThisTab(받은것: TabSessionLike | null | undefined, 이탭것: TabSessionLike | null | undefined): boolean;
+export declare function isSessionForThisTab(incoming: TabSessionLike | null | undefined, thisTab: TabSessionLike | null | undefined): boolean;

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

@@ -16,21 +16,21 @@
  * 여기서 막으면 이 탭이 로그인된 채로 남는다 — 막는 것보다 나쁜 쪽이다.
  *
  * ```ts
- * onAuthStateChange((event, 받은것) => {
+ * onAuthStateChange((event, incoming) => {
  *   getSession().then(({ data }) => {
- *     const 이탭것 = data.session
- *     if (!isSessionForThisTab(받은것, 이탭것)) return   // 다른 탭에서 온 것 — 무시
- *     …이탭것 으로 상태를 맞춘다
+ *     const thisTab = data.session
+ *     if (!isSessionForThisTab(incoming, thisTab)) return   // 다른 탭에서 온 것 — 무시
+ *     …thisTab 으로 상태를 맞춘다
  *   })
  * })
  * ```
  *
- * @param 받은것 이벤트가 실어 온 세션(없을 수 있다)
- * @param 이탭것 `getSession()` 이 이 탭 저장소에서 다시 읽은 세션
+ * @param incoming 이벤트가 실어 온 세션(없을 수 있다)
+ * @param thisTab `getSession()` 이 이 탭 저장소에서 다시 읽은 세션
  * @public
  */
-export function isSessionForThisTab(받은것, 이탭것) {
-    if (!받은것)
+export function isSessionForThisTab(incoming, thisTab) {
+    if (!incoming)
         return true;
-    return !!이탭것 && 이탭것.access_token === 받은것.access_token;
+    return !!thisTab && thisTab.access_token === incoming.access_token;
 }

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

@@ -1,5 +1,5 @@
 /** 글자 둘을 한국어 차례로 견준다 */
-export declare function 한글순(a: string, b: string): number;
+export declare function compareKorean(a: string, b: string): number;
 /**
  * 표의 한 칸끼리 견준다 — **숫자는 숫자로, 글자 속 숫자도 수로.**
  *
@@ -13,10 +13,20 @@ export declare function 한글순(a: string, b: string): number;
  * 비어 있는 값(`null`·`undefined`·NaN)은 빈 글자로 본다 — 부르는 쪽이 이미
  * `?? ''` 로 채워 넘기던 것과 같은 뜻이다.
  */
-export declare function 칸순(a: unknown, b: unknown): number;
+export declare function compareCell(a: unknown, b: unknown): number;
 /**
- * 표 정렬 한 번의 비교 — 칸순에 방향을 입히되 **빈 값은 오름·내림 모두 맨 뒤.**
- * 방향을 `-칸순` 으로 뒤집기만 하면 빈 값이 오름차순 맨 앞·내림차순 맨 뒤로 오가, 표마다 빈 줄이 다른 끝에 섰다.
+ * @deprecated **`compareCell` 을 쓴다 — 같은 함수다.**
+ *
+ * 2026-10-13 공개 이름을 영어로 옮기며(사장님 지시) 옛 이름을 남겼다. 말귀가
+ * `import { 칸순 } from '@ihabdevteam/core/utils/textSort'` 를 **다섯 줄**에서
+ * 쓰고 있어 한 번에 걷으면 그쪽이 통째로 빨개진다. 옮긴 뒤 알려 주면 걷는다.
+ *
+ * 같은 꼴로 남겨 둔 것이 또 있다 — `useTableSort()` 의 `정렬`·`칸`.
+ */
+export declare const 칸순: typeof compareCell;
+/**
+ * 표 정렬 한 번의 비교 — compareCell에 방향을 입히되 **빈 값은 오름·내림 모두 맨 뒤.**
+ * 방향을 `-compareCell` 으로 뒤집기만 하면 빈 값이 오름차순 맨 앞·내림차순 맨 뒤로 오가, 표마다 빈 줄이 다른 끝에 섰다.
  * ListPopup 과 useTableSort().sortRows 가 함께 쓴다.
  */
-export declare function 칸순빈값뒤(a: unknown, b: unknown, asc: boolean): number;
+export declare function compareCellBlankLast(a: unknown, b: unknown, asc: boolean): number;