@ihabdevteam/core 0.321.0 → 0.322.0

package/dist/ihabdevteam-core.d.ts

@@ -1678,7 +1678,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.321.0";
+export declare const CORE_VERSION = "0.322.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -2039,7 +2039,7 @@ export declare interface DeviceRow {
     worn: boolean;
 }
 
-declare type DeviceSide = '좌' | '우';
+declare type DeviceSide = 'left' | 'right';
 
 export declare function DeviceSideTable({ rows, loading, onSelect, onDelete, onWear, onRelease, onAdd }: DeviceSideTableProps): JSX.Element;
 
@@ -2231,10 +2231,10 @@ export declare interface DropdownProps {
  * @public 소음이 **들리는 크기**(0~2, 원본 소음 파일 기준) = mainVolume × 비율. 켜짐 여부는 보지
  * 않는다. 결과 기록·파형이 쓴다. 소음 `<audio>` 에 거는 값은 `noiseElementVolume`.
  */
-export declare function effectiveNoiseVolume(settings: 비율설정): number;
+export declare function effectiveNoiseVolume(settings: SpeechVolumeSettings): number;
 
 /** @public 문제 소리 볼륨(0~1) = mainVolume. 비율과 상관없다. */
-export declare function effectiveSpeechVolume(settings: 비율설정): number;
+export declare function effectiveSpeechVolume(settings: SpeechVolumeSettings): number;
 
 /** @public */
 export declare function EffectPartyPopper({ active, count, duration, strength, // multiplier for speed/spread
@@ -2927,6 +2927,16 @@ export declare function getTTSUrlResolver(): ((text: string) => string | Promise
 /** @public 단어 풀 조회 */
 export declare function getWordPool(): WordPool | null;
 
+/**
+ * 등급 고르개의 설명 줄들 — 지금 언어로. 사전에 배열이 없으면 한국어 원문.
+ *
+ * **공개 API 가 아니다**(대응표에 `internal`) — 코어 안에서만 쓰고, 내보내는 것은 못이 읽기 때문이다.
+ * 그래도 **이름은 영어다** — `internal` 이라도 배포 `d.ts` 에는 그대로 나가 소비자 편집기에 보인다
+ * (사용자 지시 2026-10-13. 소비자 사용처 0 이라 옛 이름을 남기지 않았다 — 말귀의 같은 이름 함수는 제 지역 것이다).
+ * 앱은 제 열쇠(`wordSearch.filter.gradeInfo`)와 제 받는 함수를 따로 갖는다.
+ */
+export declare function gradeDescriptions(t: TFunction): string[];
+
 /** @public 이 타입에 '문제(정답) 단어' 구조 제약이 있는가(편집기 카운트/후보 좁히기 판단용). */
 export declare function hasQuestionWordConstraint(typeKey: WordTrainingTypeKey): boolean;
 
@@ -3179,20 +3189,20 @@ declare interface IsSelectionCorrectParams {
  * 여기서 막으면 이 탭이 로그인된 채로 남는다 — 막는 것보다 나쁜 쪽이다.
  *
  * ```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;
 
 /**
  * @public 문자열이 음절 패턴 DSL 문법인지 — 쉼표(,) 포함 여부로 판별한다.
@@ -3991,7 +4001,7 @@ declare interface NoiseContext_2 {
  * @public 소음 `<audio>` 볼륨(0~1) = min(1, 들리는 크기 ÷ gain). gain 은 소음 파일이 원본보다 몇 배
  * 큰지 — 기본은 `configureStorage({ noiseFileGain })`(없으면 1).
  */
-export declare function noiseElementVolume(settings: 비율설정, gain?: number): number;
+export declare function noiseElementVolume(settings: SpeechVolumeSettings, gain?: number): number;
 
 /** @public */
 export declare const NoisePlayerContext: Context<NoisePlayerContextValue | null>;
@@ -4379,10 +4389,8 @@ declare type PanelRowDescription = {
 export declare function PanelRowDevice({ devices, onRelease, emptyLabel }: PanelRowDeviceProps): JSX.Element;
 
 export declare interface PanelRowDeviceProps {
-    devices: {
-        좌: DeviceEntry | null;
-        우: DeviceEntry | null;
-    };
+    /** 쪽별로 지금 끼고 있는 기기 — 열쇠는 `DeviceSide` 값이다(`HearingDeviceInfo` 와 같은 꼴) */
+    devices: Record<DeviceSide, DeviceEntry | null>;
     /** 있으면 각 쪽 이름 옆에 '착용 해제'가 선다 — 그 쪽의 '지금 착용중' 만 내린다(이력은 남는다) */
     onRelease?: (side: DeviceSide) => void;
     /**
@@ -5287,7 +5295,7 @@ export declare const POS_LABEL: Record<string, string>;
  * 사전에 없는 약호는 한국어 전체 표기(`POS_LABEL`)로 둔다 — 자료에 새 약호가 와도 빈칸이 안 된다.
  * @public
  */
-export declare function posLabels(t: 번역): Record<string, string>;
+export declare function posLabels(t: Translate): Record<string, string>;
 
 /**
  * **늦게 받는 화면 청크를 한가할 때 미리 받아 둔다.**
@@ -6754,7 +6762,7 @@ export declare type ShuffledItem = {
     text: string;
 };
 
-declare type Side = '좌' | '우';
+declare type Side = 'left' | 'right';
 
 /** @public */
 export declare function SideNav(props: SideNavProps): React_2.JSX.Element;
@@ -7108,6 +7116,13 @@ export declare interface SpeakerPos {
 /** @public */
 export declare type SpeakerState = 'idle' | 'active' | 'played' | 'correct' | 'wrong';
 
+/** `effectiveSpeechVolume`·`effectiveNoiseVolume`·`noiseElementVolume` 이 받는 것 —
+ *  **공개 `d.ts` 에 이름이 그대로 나가는 자리**라 영어로 둔다. 안쪽 이름은 한글로 쓰는 저장소지만,
+ *  소비자가 편집기에서 보는 이름은 영어라야 한다(사용자 지시 2026-10-13). */
+declare type SpeechVolumeSettings = Pick<CoreNoiseSettings, 'level' | 'mainVolume'> & {
+    noiseRatio?: number;
+};
+
 /**
  * 앱에 처음 들어올 때 로고를 한 번 보여 주는 연출.
  *
@@ -9525,6 +9540,13 @@ export declare interface TrainingWordCardProps {
     orderRank?: number | null;
 }
 
+/** `t` 하나만 받는 작은 꼴 — `TFunction` 을 들여오지 않아 이 모듈이 i18n 에 안 매인다 */
+/** i18next `t` 와 같은 꼴 — **공개 서명(`posLabels`·`wordTypeLabels`)이 받는 자리**라 이름을 영어로 둔다
+ *  (사용자 지시 2026-10-13). 안쪽 이름은 한글이어도 소비자가 보는 이름은 영어라야 한다. */
+declare type Translate = (k: string, o: {
+    defaultValue: string;
+}) => string;
+
 declare type TranslateFn = TFunction;
 
 /**
@@ -9770,22 +9792,10 @@ export declare function useDeviceManagement(): {
     setShowDevice: Dispatch<SetStateAction<boolean>>;
     deviceDirection: Side;
     setDeviceDirection: Dispatch<SetStateAction<Side>>;
-    devices: {
-        좌: DeviceForm | null;
-        우: DeviceForm | null;
-    };
-    setDevices: Dispatch<SetStateAction<    {
-    좌: DeviceForm | null;
-    우: DeviceForm | null;
-    }>>;
-    deviceHistory: {
-        좌: DeviceForm[];
-        우: DeviceForm[];
-    };
-    setDeviceHistory: Dispatch<SetStateAction<    {
-    좌: DeviceForm[];
-    우: DeviceForm[];
-    }>>;
+    devices: Record<Side, DeviceForm | null>;
+    setDevices: Dispatch<SetStateAction<Record<Side, DeviceForm | null>>>;
+    deviceHistory: Record<Side, DeviceForm[]>;
+    setDeviceHistory: Dispatch<SetStateAction<Record<Side, DeviceForm[]>>>;
     showDeviceList: boolean;
     setShowDeviceList: Dispatch<SetStateAction<boolean>>;
     listForSide: Side;
@@ -9995,15 +10005,15 @@ export declare function usePagedList<T>(items: T[], perPage: number, page: numbe
  * 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;
 
 /**
  * 비밀번호 변경 폼 상태와 핸들러를 캡슐화한 훅.
@@ -10108,28 +10118,39 @@ export declare function useTablePaging<T>(rows: readonly T[], resetOn?: unknown,
  * **정렬이 바뀌면 첫 쪽으로** — `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[];
 };
 
 /**
@@ -11601,7 +11622,7 @@ export declare type WordTrainingTypeKey = 'SAME_SOUND_PICK' | 'SAME_OR_DIFF' | '
  * **어종 약호 → 지금 언어의 이름**(`{ '한자': 'Sino-Korean', … }`). 쓰는 법은 `posLabels` 와 같다.
  * @public
  */
-export declare function wordTypeLabels(t: 번역): Record<string, string>;
+export declare function wordTypeLabels(t: Translate): Record<string, string>;
 
 /**
  * @public 틀린 문항만 — 음소별 오류를 세는 쪽이 먼저 볼 것이다.
@@ -11610,21 +11631,4 @@ export declare function wordTypeLabels(t: 번역): Record<string, string>;
  */
 export declare function wrongItems(items: readonly TrainingItemResult[]): TrainingItemResult[];
 
-/**
- * 등급 고르개의 설명 줄들 — 지금 언어로. 사전에 배열이 없으면 한국어 원문.
- *
- * **공개 API 가 아니다**(대응표에 `internal`) — 코어 안에서만 쓰고, 내보내는 것은 못이 읽기 때문이다.
- * 앱은 제 열쇠(`wordSearch.filter.gradeInfo`)와 제 받는 함수를 따로 갖는다.
- */
-export declare function 등급설명(t: TFunction): string[];
-
-/** `t` 하나만 받는 작은 꼴 — `TFunction` 을 들여오지 않아 이 모듈이 i18n 에 안 매인다 */
-declare type 번역 = (k: string, o: {
-    defaultValue: string;
-}) => string;
-
-declare type 비율설정 = Pick<CoreNoiseSettings, 'level' | 'mainVolume'> & {
-    noiseRatio?: number;
-};
-
 export { }

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

@@ -1,5 +1,5 @@
 import './HearingDeviceInfo.css';
-export type DeviceSide = '좌' | '우';
+export type DeviceSide = 'left' | 'right';
 export interface DeviceEntry {
     brand: string;
     device: string;
@@ -10,10 +10,10 @@ export interface DeviceEntry {
     wornDay: string;
 }
 interface HearingDeviceInfoProps {
-    devices: {
-        좌: DeviceEntry | null;
-        우: DeviceEntry | null;
-    };
+    /** 쪽별로 지금 끼고 있는 기기 — 열쇠는 `DeviceSide` **값**(`'left'`·`'right'`)이다.
+     *  그 값은 서버의 `side` 열과 그대로 오가는 **자료**라 건드리지 않았고, 공개 자리에 보이는
+     *  **모양만** 영어 이름으로 돌렸다(`Record`). 값까지 바꾸는 것은 DB 결정이다(사용자 지시 2026-10-13). */
+    devices: Record<DeviceSide, DeviceEntry | null>;
     onAddDevice: (side: DeviceSide) => void;
     onOpenList: (side: DeviceSide) => void;
     onRemoveDevice: (side: DeviceSide) => void;

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

@@ -6,9 +6,9 @@ import { formatWornDate } from '../utils/wornDate';
 import './HearingDeviceInfo.css';
 export default function HearingDeviceInfo({ devices, onAddDevice, onOpenList, onRemoveDevice }) {
     const { t, i18n } = useTranslation(); /* i18n.language — 착용일이 보는 말을 따른다((118)) */
-    return (_jsxs("div", { className: "hearing-device-info", children: [_jsx("div", { className: "hearing-device-info__title body-3", children: t('customers.device.title', '청각재활기기') }), _jsx("div", { className: "hearing-device-info__row", children: ['좌', '우'].map(side => {
+    return (_jsxs("div", { className: "hearing-device-info", children: [_jsx("div", { className: "hearing-device-info__title body-3", children: t('customers.device.title', '청각재활기기') }), _jsx("div", { className: "hearing-device-info__row", children: ['left', 'right'].map(side => {
                     const d = devices[side];
-                    const sideLabel = side === '좌' ? t('device.direction.left', '좌') : t('device.direction.right', '우');
+                    const sideLabel = side === 'left' ? t('device.direction.left', '좌') : t('device.direction.right', '우');
                     return (_jsxs("div", { className: "hearing-device-info__side", children: [_jsx("span", { className: "hearing-device-info__side-label body-3", children: sideLabel }), d ? (_jsxs(_Fragment, { children: [_jsxs("div", { className: "hearing-device-info__device", children: [_jsx("span", { className: "hearing-device-info__device-name body-3", children: d.brand }), _jsxs("span", { className: "hearing-device-info__device-detail", children: [d.device, d.fitType ? ` · ${d.fitType}` : ''] }), d.productName && _jsx("span", { className: "hearing-device-info__device-product", children: d.productName }), formatWornDate(d.wornYear, d.wornMonth, d.wornDay, i18n.language) && _jsx("span", { className: "hearing-device-info__device-date", children: formatWornDate(d.wornYear, d.wornMonth, d.wornDay, i18n.language) })] }), _jsxs("div", { className: "hearing-device-info__actions", children: [_jsx(Button, { htmlType: "button", size: 40, type: "dot", icon: "plus", onClick: () => onAddDevice(side), showTooltipInfo: t('device.addNew', '새 기기 추가'), ariaLabel: t('device.addNew', '새 기기 추가') }), _jsx(Button, { htmlType: "button", size: 40, type: "dot", icon: "list", onClick: () => onOpenList(side), showTooltipInfo: t('device.selectFromList', '목록에서 선택'), ariaLabel: t('device.selectFromList', '목록에서 선택') }), _jsx(Button, { htmlType: "button", size: 40, type: "dot", icon: "x", variant: "danger", onClick: () => onRemoveDevice(side), showTooltipInfo: t('device.removeDevice', '착용 해제'), ariaLabel: t('device.removeDevice', '착용 해제') })] })] })) : (_jsxs("div", { className: "hearing-device-info__actions", children: [_jsx(Button, { htmlType: "button", size: 40, type: "dot", icon: "plus", onClick: () => onAddDevice(side), showTooltipInfo: t('device.addNew', '새 기기 추가'), ariaLabel: t('device.addNew', '새 기기 추가') }), _jsx(Button, { htmlType: "button", size: 40, type: "dot", icon: "list", onClick: () => onOpenList(side), showTooltipInfo: t('device.selectFromList', '목록에서 선택'), ariaLabel: t('device.selectFromList', '목록에서 선택') })] }))] }, side));
                 }) })] }));
 }

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

@@ -153,10 +153,8 @@ export type PanelRowProps = PanelRowToggle | PanelRowSegmented | PanelRowDropdow
 export declare function PanelRow(props: PanelRowProps): import("react").JSX.Element;
 export type { DeviceSide };
 export interface PanelRowDeviceProps {
-    devices: {
-        좌: DeviceEntry | null;
-        우: DeviceEntry | null;
-    };
+    /** 쪽별로 지금 끼고 있는 기기 — 열쇠는 `DeviceSide` 값이다(`HearingDeviceInfo` 와 같은 꼴) */
+    devices: Record<DeviceSide, DeviceEntry | null>;
     /** 있으면 각 쪽 이름 옆에 '착용 해제'가 선다 — 그 쪽의 '지금 착용중' 만 내린다(이력은 남는다) */
     onRelease?: (side: DeviceSide) => void;
     /**

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

@@ -152,10 +152,10 @@ function 메타(d) {
 }
 export function PanelRowDevice({ devices, onRelease, emptyLabel }) {
     const { t, i18n } = useTranslation(); /* i18n.language — 착용일이 보는 말을 따른다((118)) */
-    const SIDES = ['좌', '우'];
+    const SIDES = ['left', 'right'];
     return (_jsx("div", { className: "panel-row panel-row--device", children: SIDES.map(side => {
             const d = devices[side];
-            const sideLabel = side === '좌' ? t('device.direction.left', '좌') : t('device.direction.right', '우');
+            const sideLabel = side === 'left' ? t('device.direction.left', '좌') : t('device.direction.right', '우');
             return (_jsxs("div", { className: "panel-row__device-column", children: [_jsxs("div", { className: "panel-row__device-head", children: [_jsx("span", { className: "panel-row__device-side body-2b", children: sideLabel }), d && onRelease && (
                             /* 표의 줄 끝 단추와 같은 모양·같은 말 — 하는 일도 같다.
                                이력에서 지우는 것이 아니라 '지금 끼고 있음' 만 내린다

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

@@ -3,14 +3,10 @@ import type { DeviceSide } from '../Panel';
 import type { DeviceForm } from '../../types/device';
 import './DeviceListPopup.css';
 interface DeviceListPopupProps {
-    devices: {
-        좌: DeviceEntry | null;
-        우: DeviceEntry | null;
-    };
-    deviceHistory: {
-        좌: DeviceEntry[];
-        우: DeviceEntry[];
-    };
+    /** 쪽별로 지금 끼고 있는 기기 — 열쇠는 `DeviceSide` 값이다 */
+    devices: Record<DeviceSide, DeviceEntry | null>;
+    /** 쪽별로 바꿔 온 이력 */
+    deviceHistory: Record<DeviceSide, DeviceEntry[]>;
     onClose: () => void;
     onSelect: (d: DeviceForm) => void;
     onDelete: (side: DeviceSide, index: number) => void;

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

@@ -16,7 +16,7 @@ import './DeviceListPopup.css';
  */
 export default function DeviceListPopup({ devices, deviceHistory, onClose, onSelect, onDelete }) {
     const { t } = useTranslation();
-    const rows = useMemo(() => ['좌', '우'].flatMap(side => deviceHistory[side].map((d, index) => ({
+    const rows = useMemo(() => ['left', 'right'].flatMap(side => deviceHistory[side].map((d, index) => ({
         index, side,
         brand: d.brand, device: d.device,
         fitType: d.fitType ?? '', productName: d.productName ?? '',

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

@@ -17,7 +17,7 @@ function 기기종류이름(device, t) {
     return k ? t(`device.type.${k}`, { defaultValue: device }) : device;
 }
 import { useTablePaging, useTableSort } from '../../hooks/useTablePaging';
-import { 칸순빈값뒤 } from '../../utils/textSort';
+import { compareCellBlankLast } from '../../utils/textSort';
 import './DeviceListPopup.css';
 /**
  * 정렬에 쓸 문자열. 날짜는 **자리수를 채워** 잰다 — '2026.5.2' 와 '2026.11.5' 를
@@ -31,7 +31,7 @@ function 정렬값(r, key) {
 }
 export default function DeviceSideTable({ rows, loading, onSelect, onDelete, onWear, onRelease, onAdd }) {
     const { t, i18n } = useTranslation(); /* i18n.language — 착용일이 보는 말을 따른다((118)) */
-    const 방향이름 = (side) => side === '좌' ? t('device.direction.left', '좌') : t('device.direction.right', '우');
+    const 방향이름 = (side) => side === 'left' ? t('device.direction.left', '좌') : t('device.direction.right', '우');
     /* 머리행을 누르면 그 칸으로 정렬한다 — 같은 칸을 다시 누르면 방향이 뒤집힌다.
        쪽넘김보다 **앞에서** 정렬한다(훅에 이미 정렬된 줄을 건넨다). */
     const { 정렬, 칸 } = useTableSort();
@@ -44,7 +44,7 @@ export default function DeviceSideTable({ rows, loading, onSelect, onDelete, onW
                 const cmp = Number(b.worn) - Number(a.worn); // 켜진 것이 먼저
                 return asc ? cmp : -cmp;
             }
-            return 칸순빈값뒤(정렬값(a, key), 정렬값(b, key), asc); // 빈 칸(착용일 없음 등)은 오름·내림 모두 맨 뒤 — useTableSort 와 같은 규칙
+            return compareCellBlankLast(정렬값(a, key), 정렬값(b, key), asc); // 빈 칸(착용일 없음 등)은 오름·내림 모두 맨 뒤 — useTableSort 와 같은 규칙
         });
     }, [rows, 정렬]);
     /* 개수 보기·쪽넘김은 방문 표와 같은 것을 쓴다 — 같은 자리에서 같은 뜻으로 읽히게 */

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

@@ -6,7 +6,7 @@ import Popup from './Popup';
 import Table from '../Table';
 import Toolbar from '../Toolbar';
 import './ListPopup.css';
-import { 칸순빈값뒤 } from '../../utils/textSort';
+import { compareCellBlankLast } from '../../utils/textSort';
 import { cx } from '../../utils/cx';
 /** @public */
 export default function ListPopup(props) {
@@ -48,9 +48,9 @@ export default function ListPopup(props) {
                 return 0;
             /* `<`·`>` 로 견주면 코드포인트 차례가 된다 — 한글끼리는 맞아떨어져 안 드러나다가
                **한글과 영문이 섞이면** 어긋난다(라틴이 한글보다 앞이라 `fwef` 가
-               `검수테스트2` 위에 선다). 숫자 칸은 숫자로 견주는 것을 `칸순` 이 지킨다.
+               `검수테스트2` 위에 선다). 숫자 칸은 숫자로 견주는 것을 `compareCell` 이 지킨다.
                빈 값(null·undefined·'')은 오름·내림 모두 맨 뒤 — 전에는 '' 로 채워 오름차순 맨 앞에 섰다(useTableSort 와 같은 규칙). */
-            return 칸순빈값뒤(va, vb, sortAsc);
+            return compareCellBlankLast(va, vb, sortAsc);
         });
     }, [items, search, sortKey, sortAsc, searchEnabled, effectiveSearchFn]);
     const totalPages = Math.max(1, Math.ceil(filtered.length / Number(pageSize)));

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

@@ -6,7 +6,7 @@ import Popup from './Popup';
 import Button from '../Button';
 import Dropdown from '../Dropdown';
 import { getSavedTables, deleteTable as localDeleteTable } from '../../utils/savedWordTables';
-import { 한글순 } from '../../utils/textSort';
+import { compareKorean } from '../../utils/textSort';
 import { formatYmd } from '../../utils/date';
 import './LoadTablePopup.css';
 import { pressable } from '../../utils/pressable';
@@ -59,9 +59,9 @@ export default function LoadTablePopup({ onLoad, onCancel, tables: tablesProp, o
             return copy.sort((a, b) => String(b.savedAt ?? '').localeCompare(String(a.savedAt ?? '')));
         if (sortKey === 'oldest')
             return copy.sort((a, b) => String(a.savedAt ?? '').localeCompare(String(b.savedAt ?? '')));
-        /* 이름은 **`한글순`(콜레이터 하나)** — `localeCompare(…, 'ko')` 는 비교마다 콜레이터를 새로 만든다((113)) */
+        /* 이름은 **`compareKorean`(콜레이터 하나)** — `localeCompare(…, 'ko')` 는 비교마다 콜레이터를 새로 만든다((113)) */
         if (sortKey === 'name')
-            return copy.sort((a, b) => 한글순(a.name, b.name));
+            return copy.sort((a, b) => compareKorean(a.name, b.name));
         if (sortKey === 'count')
             return copy.sort((a, b) => b.items.length - a.items.length);
         return copy;

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

@@ -19,21 +19,24 @@ export declare const NOISE_RATIO_STEP = 0.1;
 export declare function noiseRatioOf(settings: Pick<CoreNoiseSettings, 'level' | 'mainVolume'> & {
     noiseRatio?: number;
 }): number;
-type 비율설정 = Pick<CoreNoiseSettings, 'level' | 'mainVolume'> & {
+/** `effectiveSpeechVolume`·`effectiveNoiseVolume`·`noiseElementVolume` 이 받는 것 —
+ *  **공개 `d.ts` 에 이름이 그대로 나가는 자리**라 영어로 둔다. 안쪽 이름은 한글로 쓰는 저장소지만,
+ *  소비자가 편집기에서 보는 이름은 영어라야 한다(사용자 지시 2026-10-13). */
+type SpeechVolumeSettings = Pick<CoreNoiseSettings, 'level' | 'mainVolume'> & {
     noiseRatio?: number;
 };
 /** @public 문제 소리 볼륨(0~1) = mainVolume. 비율과 상관없다. */
-export declare function effectiveSpeechVolume(settings: 비율설정): number;
+export declare function effectiveSpeechVolume(settings: SpeechVolumeSettings): number;
 /**
  * @public 소음이 **들리는 크기**(0~2, 원본 소음 파일 기준) = mainVolume × 비율. 켜짐 여부는 보지
  * 않는다. 결과 기록·파형이 쓴다. 소음 `<audio>` 에 거는 값은 `noiseElementVolume`.
  */
-export declare function effectiveNoiseVolume(settings: 비율설정): number;
+export declare function effectiveNoiseVolume(settings: SpeechVolumeSettings): number;
 /**
  * @public 소음 `<audio>` 볼륨(0~1) = min(1, 들리는 크기 ÷ gain). gain 은 소음 파일이 원본보다 몇 배
  * 큰지 — 기본은 `configureStorage({ noiseFileGain })`(없으면 1).
  */
-export declare function noiseElementVolume(settings: 비율설정, gain?: number): number;
+export declare function noiseElementVolume(settings: SpeechVolumeSettings, gain?: number): number;
 /**
  * @public 설정에 조각을 덮는다 — `{ ...base, ...patch }` 에 비율 규칙 하나를 더한 것.
  *

package/dist/packages/core/src/components/Training/TrainingBlock.js

@@ -7,7 +7,7 @@ import Section from '../Section';
 import './TrainingBlock.css';
 import TrainingBlockButton from './TrainingBlockButton';
 import { useWindowEvent } from '../../hooks/useWindowEvent';
-import { 키보드로눌렀나 } from '../../hooks/inputModality';
+import { wasKeyboardPress } from '../../hooks/inputModality';
 const BTN_COUNT_MAX = 20;
 /** @public */
 export default function TrainingBlock(props) {
@@ -35,7 +35,7 @@ export default function TrainingBlock(props) {
     const 더보기초점Ref = useRef(null);
     function loadMore() {
         const 단추 = document.activeElement;
-        더보기초점Ref.current = 키보드로눌렀나() && 단추 && 단추.closest?.('.training-block__more') ? visible : null;
+        더보기초점Ref.current = wasKeyboardPress() && 단추 && 단추.closest?.('.training-block__more') ? visible : null;
         setVisible((v) => Math.min(total, v + BTN_COUNT_MAX));
     }
     useEffect(() => {

package/dist/packages/core/src/components/Training/TrainingPagePopup.js

@@ -39,7 +39,7 @@ const 움직임최소화 = () => {
 };
 /** 결과를 계산하는 중인 결과 창 자리 — 이 객체와 **같은 것**이면 계산 중이다(결과 창의 '완료' 를 막는다). */
 const 결과계산중 = Object.freeze({});
-import { 키보드로눌렀나 } from '../../hooks/inputModality';
+import { wasKeyboardPress } from '../../hooks/inputModality';
 // 문장 4종은 각 PagePopup 래퍼에서 useTrainingSessionLog로 이미 기록 → 베이스에서 중복 방지
 const SENTENCE_TIME_LOGGED_TYPES = new Set(['LISTEN_IN_NOISE', 'SHORT_STORY', 'LONG_STORY', 'ORDERING_SENTENCE']);
 /** 결과 창 자료에서 정답/전체를 센다 — 결과 항목 형태가 훈련 타입마다 달라(소음 하 듣기/문장 순서화는 correct 대신
@@ -909,7 +909,7 @@ function TrainingPagePopupInner(props) {
         if (앞 === undefined || 앞 === effectivePageIndex)
             return;
         // 키보드로 넘겼을 때만 — 마우스로 누른 사람에게 매 문제 '듣기' 초점 안내가 뜨지 않게
-        if (!키보드로눌렀나())
+        if (!wasKeyboardPress())
             return;
         const panel = panelRef.current;
         if (!panel)

package/dist/packages/core/src/components/Training/TrainingStepAudioPlayer.js

@@ -19,7 +19,7 @@ import Button from '../Button';
 import Icon from '../Icon';
 import InfoTooltip from '../Tooltip/InfoTooltip';
 import { STATUS_MESSAGES, ANNOUNCED_STATUSES } from './trainingStepAudioPlayerTypes';
-import { 키보드로눌렀나 } from '../../hooks/inputModality';
+import { wasKeyboardPress } from '../../hooks/inputModality';
 import { measureAudioDuration, waitForCanPlay } from './audioWaits';
 import { useWaveReady } from './useWaveReady';
 import { useObjectUrls } from './useObjectUrls';
@@ -1426,7 +1426,7 @@ export default function TrainingStepAudioPlayer({ btnLabel, soundSrc, bucketPath
                            누르면 소리를 받으러 가거나 "가져오지 못했습니다" 를 띄웠다 — 마우스와 같게 키보드도 막는다 */
                         disabled: isDisabled, 
                         // 키보드로 눌렀을 때만 초점을 옮긴다 — 마우스로 누른 사람에게 '재생 / 멈춤' 초점 툴팁이 뜨지 않게
-                        onClick: () => { 듣기초점옮기기Ref.current = 키보드로눌렀나(); hideListenTip(); handleToggle(); }, "aria-label": typeof label === 'string' ? label : t('training.listen', '듣기'), onMouseEnter: showListenTip, onMouseLeave: hideListenTip, 
+                        onClick: () => { 듣기초점옮기기Ref.current = wasKeyboardPress(); hideListenTip(); handleToggle(); }, "aria-label": typeof label === 'string' ? label : t('training.listen', '듣기'), onMouseEnter: showListenTip, onMouseLeave: hideListenTip, 
                         // 키보드로 이 버튼에 오면 마우스와 동일하게 안내를 띄운다
                         onFocus: showListenTip, onBlur: hideListenTip, children: _jsx("span", { ref: listenBtnRef, className: "audio-player__button-triangle-wrap", children: _jsx("svg", { className: "audio-player__button-triangle", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { ref: triPathRef, d: "M13.2 7.7 L16.5 9.85 Q20.2 12 16.5 14.15 L10 18.3 Q7 19.7 7 16.3 L7 7.7 Q7 4.3 10 5.7 L13.2 7.7" }) }) }) })) : null, listenBtnRect && (_jsx(InfoTooltip, { anchorRect: listenBtnRect, text: typeof label === 'string' && label ? label : t('training.listenLabel', '문장 듣기'), offset: 8 })), _jsxs("div", { className: `audio-player__play ${stateLocal === "playMode" || displayedPlaying ? "is-visible" : ""}`, inert: !(stateLocal === "playMode" || displayedPlaying) || undefined, children: [_jsxs("div", { ref: btnsRef, className: "audio-player__buttons", children: [_jsx(Button, { htmlType: "button", size: 32, showTooltipInfo: true, type: "dot", shape: "pill", useBorder: false, icon: "skip-back", onClick: handlePrev, ariaLabel: t('training.prev', '이전'), width: "60px", variant: "transparent-white", "aria-hidden": "true", tabIndex: -1, disabled: stateLocal !== 'playMode' }), _jsx(Button, { htmlType: "button", size: 32, showTooltipInfo: true, type: "dot", shape: "pill", useBorder: false, icon: displayedPlaying ? "pause" : "play", onClick: handleToggle, ariaLabel: t('common.playPause', '재생 / 멈춤'), "aria-pressed": displayedPlaying, width: "60px", variant: "transparent-white", disabled: stateLocal !== 'playMode' }), _jsx(Button, { htmlType: "button", size: 32, showTooltipInfo: true, type: "dot", shape: "pill", useBorder: false, icon: "square", onClick: handleStop, ariaLabel: t('training.stop', '정지'), width: "60px", variant: "transparent-white", "aria-hidden": "true", tabIndex: -1, disabled: stateLocal !== 'playMode' }), sourceButtonCount > 1 ? (_jsx("div", { ref: sourceButtonsRef, className: "audio-player__source-buttons", children: Array.from({ length: sourceButtonCount }).map((_, idx) => (_jsx(Button, { htmlType: "button", size: 32, type: "dot", shape: "pill", useBorder: false, label: String(idx + 1), onClick: () => { try {
                                                 handleJumpTo(idx);

package/dist/packages/core/src/components/Training/TrainingStepTextBox.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useTranslation } from 'react-i18next';
-import { 키보드로눌렀나 } from '../../hooks/inputModality';
+import { wasKeyboardPress } from '../../hooks/inputModality';
 import Button from '../Button';
 import Toast from '../Toast';
 import { useFontScale } from '../../hooks';
@@ -36,7 +36,7 @@ export default function TrainingStepTextBox({ context, state = "disabled", theme
     const 펼친뒤초점Ref = useRef(false);
     const handleActivate = useCallback(() => {
         // 키보드로 눌렀을 때만 — 마우스로 눌렀는데 옮기면 '글자 크기 감소' 초점 툴팁이 떴다
-        펼친뒤초점Ref.current = 키보드로눌렀나() && !!상자Ref.current && 상자Ref.current.contains(document.activeElement);
+        펼친뒤초점Ref.current = wasKeyboardPress() && !!상자Ref.current && 상자Ref.current.contains(document.activeElement);
         setLocalStatus("active");
     }, []);
     const handleNoticeClose = useCallback(() => setNoticeMessage(''), []);

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

@@ -51,4 +51,4 @@ export interface OneShotSound {
  * 풀린다. 부르는 쪽이 `try` 로 감싸지 않아도 되게 하려는 것이다. 넷 가운데 셋이 저마다
  * `try` 를 적고 있었고, 그 안에서 하는 일이 조금씩 달랐다.
  */
-export declare function playOneShot(url: string, onEnd?: (들었나: boolean) => void): OneShotSound;
+export declare function playOneShot(url: string, onEnd?: (played: boolean) => void): OneShotSound;

package/dist/packages/core/src/components/Training/oneShotSound.js

@@ -41,15 +41,15 @@ export function playOneShot(url, onEnd) {
     const done = new Promise((res) => { 풀기 = res; });
     /** 끝은 한 번이다 — 거절과 `error` 가 함께 오는 일이 실제로 있다 */
     let 끝났나 = false;
-    const 끝 = (들었나) => {
+    const 끝 = (played) => {
         if (끝났나)
             return;
         끝났나 = true;
         try {
-            onEnd?.(들었나);
+            onEnd?.(played);
         }
         catch { /* 부르는 쪽의 실패로 약속을 묶어 두지 않는다 */ }
-        풀기(들었나);
+        풀기(played);
     };
     let el;
     try {

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

@@ -77,6 +77,6 @@
  * > **고치는 방식**을 말하는지가 갈렸다. 그 세 번 동안 전해 받은 말로 짓지 않은 덕에
  * > **되돌릴 것이 없었다.**
  */
-export type 단계상태 = 'disabled' | 'done' | 'active';
+export type StepState = 'disabled' | 'done' | 'active';
 /** 답을 고를 수 있나 — 닿지 않은 단계(`disabled`)만 막는다. @public */
-export declare function canAnswerStep(state: 단계상태 | undefined): boolean;
+export declare function canAnswerStep(state: StepState | undefined): boolean;

package/dist/packages/core/src/components/Training/trainingMissStats.js

@@ -15,7 +15,7 @@
  * 비어 있어 **무엇을 틀렸는지 보여 줄 수가 없다.** 조용히 빼면 화면의 수가 전부인 줄
  * 알게 되므로 몇 건을 뺐는지 함께 돌려준다.
  */
-import { 한글순 } from '../../utils/textSort';
+import { compareKorean } from '../../utils/textSort';
 /** 같은 시각 두 행의 차례 — 둘 다 id 가 있을 때만 가린다(숫자는 수 크기, 그 밖은 글자 사전순). 못 가리면 0. */
 function 같은시각차례(a, b) {
     if (a == null || b == null || a === '' || b === '')
@@ -99,7 +99,7 @@ export function summarizeMisses(records) {
         lastSelected: v.lastSelected,
         setIds: v.setIds,
     }));
-    items.sort((a, b) => a.rate - b.rate || b.tried - a.tried || 한글순(a.title, b.title));
+    items.sort((a, b) => a.rate - b.rate || b.tried - a.tried || compareKorean(a.title, b.title));
     return { items, counted, skippedNoTitle };
 }
 /**