@ihabdevteam/core 0.318.0 → 0.322.0

package/dist/ihabdevteam-core.d.ts

@@ -672,7 +672,16 @@ export declare function buildDropContrastProblem(word: string, comp: Composition
  */
 export declare function buildDropFinalConsonantProblem(word: string, _comp: CompositionFilter | null, pronMap: Map<string, string>, _pv: 'char' | 'pron', _ws: Set<string>, _dropPos?: number | null): TrainingProblem | null;
 
-/** @public 등급(1~4등급) FilterPanelSection — 세 화면 공용. labelAction/allLabel은 호출부가 자신의 i18n으로 구성해 넘긴다. */
+/**
+ * @public 등급 FilterPanelSection — 세 화면 공용. labelAction/allLabel은 호출부가 자신의 i18n으로 구성해 넘긴다.
+ *
+ * **맨 끝에 `없음` 이 선다**((205), 2026-10-12) — 등급이 비어 있는 단어도 고를 수 있어야 한다.
+ * 맨 끝인 까닭은 **1~4 가 센 순서**이고 `없음` 은 그 줄 밖이기 때문이다(앞에 두면 `1등급` 앞에
+ * 숫자 아닌 것이 끼어 읽는 차례가 흔들린다).
+ *
+ * 이 줄의 글자는 `wordAttributeFilterCodes` 의 사전과 **같아야** 한다 — 거기서 코드로 못 읽으면
+ * 필터는 켜져 보이는데 한 단어도 안 걸린다. `test/gradeNoneOption.test.ts` 가 둘을 맞춰 센다.
+ */
 export declare function buildGradeSection(t: TFunction, keys: WordAttributeFilterKeys, opts?: {
     allLabel?: string;
     labelAction?: ReactNode;
@@ -1669,7 +1678,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.318.0";
+export declare const CORE_VERSION = "0.322.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -2030,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;
 
@@ -2222,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
@@ -2918,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;
 
@@ -3170,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 문법인지 — 쉼표(,) 포함 여부로 판별한다.
@@ -3982,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>;
@@ -4040,13 +4059,28 @@ export declare interface NoiseSettingsStore {
  * 설정값은 NoisePlayerContext(useNoisePlayer)로 읽고 쓴다.
  * @public
  */
-export declare function NoiseSettingsTooltip({ anchorRect, onClose }: NoiseSettingsTooltipProps): JSX.Element;
+export declare function NoiseSettingsTooltip({ anchorRect, onClose, hideNoiseRows }: NoiseSettingsTooltipProps): JSX.Element;
 
 /** @public */
 export declare interface NoiseSettingsTooltipProps {
     /** 앵커(소음 설정 버튼) 위치. */
     anchorRect: DOMRect | null;
     onClose: () => void;
+    /**
+     * **소음 두 줄을 안 그린다** — `소음 종류`·`소음 비율`(사장님 지시 (207), 2026-10-12).
+     *
+     * 소음이 아예 없는 훈련(짧은 이야기 듣기 · 긴 이야기 듣기 · 문장 순서화)에서 쓴다.
+     * `전체 소리`·`재생 속도` 는 그대로 선다.
+     *
+     * **흐리게가 아니라 안 그린다.** 흐린 줄은 *"지금은 못 바꾼다"* 를 말하는데, 여기서 할 말은
+     * *"이 훈련에는 소음이 없다"* 다. 흐린 채로 두면 치료사가 **바꿀 수 있는 줄을 찾아 헤맨다**
+     * (사장님이 그 줄을 짚으며 *"왜 이거 수정요청 했는데 계속 나오고 있지?"* 라 하셨다).
+     *
+     * **`noiseOverride` 와 따로 둔다 — 덮개는 *값*, 이 칸은 *보임*.** 묶으면 *"덮개는 걸되 줄은
+     * 보이게"* 를 못 한다 — 소음 하 문장 듣기의 제안 갈래가 그 꼴이다(덮개를 걸고도 치료사가
+     * 창에서 고친다). **한 칸이 두 가지를 뜻하게 하지 않는다.**
+     */
+    hideNoiseRows?: boolean;
 }
 
 /**
@@ -4355,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;
     /**
@@ -5263,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>;
 
 /**
  * **늦게 받는 화면 청크를 한가할 때 미리 받아 둔다.**
@@ -6730,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;
@@ -7084,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;
+};
+
 /**
  * 앱에 처음 들어올 때 로고를 한 번 보여 주는 연출.
  *
@@ -8501,7 +8540,7 @@ export declare interface TrainingBlockProps {
 export declare function TrainingCard({ title, titleLevel, description, topActions, children, footerLeft, footerRight, ariaLabel, onClick, draggable, onDragStart, onDragEnd, className, }: TrainingCardProps): JSX.Element;
 
 /** @public */
-export declare function TrainingCardGroup({ title, titleLevel, count, collapsed, onToggle, sort, actions, empty, emptyContent, dragOver, onDragOver, onDragLeave, onDrop, children, className, }: TrainingCardGroupProps): JSX.Element;
+export declare function TrainingCardGroup({ title, titleLevel, count, collapsed, onToggle, beforeSort, sort, actions, empty, emptyContent, dragOver, onDragOver, onDragLeave, onDrop, children, className, }: TrainingCardGroupProps): JSX.Element;
 
 /** @public */
 declare type TrainingCardGroupProps = {
@@ -8535,6 +8574,25 @@ declare type TrainingCardGroupProps = {
      * "접기, 단추" 로 읽혔다. 소비자 아홉 자리 중 여덟이 그랬다.)
      */
     onToggle?: () => void;
+    /**
+     * **정렬 드롭다운 바로 왼쪽 자리**((209), 사장님 지시 2026-10-12 — 노션 QA *"단어표, 대립쌍표의
+     * 그룹 순서 변경 기능 필요"*). 그룹 **차례를 바꾸는 손잡이**가 설 자리다.
+     *
+     * 사장님이 길 둘을 말씀하셨다 — *"그룹 자체를 드래그 하거나 정렬 왼쪽에 올림 내림 버튼을
+     * 넣어서"*. **둘 다 이 한 자리에 든다**(끄는 손잡이든 ↑↓ 단추든). 그래서 코어는 자리만 열고
+     * **무엇을 세울지는 부르는 쪽이 고른다** — 차례를 알고 간수하는 것이 그쪽이다.
+     *
+     * `actions` 와 **같은 대접**이다: 같은 `__actions` 감싸개 안이라 누름이 **접기 토글로 안
+     * 번진다.** 밖에 두면 ↑ 를 누를 때마다 그 그룹이 접힌다.
+     *
+     * **낭독기 이름은 부르는 쪽이 단다** — `접기`·`정렬` 은 이 조각이 묶음 이름을 달지만(위
+     * `titleLevel` 글), 넘겨받은 마디의 속을 이 조각이 고쳐 쓸 수는 없다. `actions` 와 같은
+     * 규칙이다: **`위로` 가 그룹 수만큼 서면 단추 목록에서 못 가린다** — `위로` 가 아니라
+     * `'sdfa' 그룹 위로` 꼴로 지어 넘긴다.
+     *
+     * 안 주면 자리를 안 만든다(지금과 같다).
+     */
+    beforeSort?: ReactNode;
     /** 헤더 우측, actions 앞에 놓이는 그룹 내 정렬 드롭다운 */
     sort?: TrainingCardGroupSort;
     /** 헤더 우측 액션 영역 (이름변경·추가·삭제 등) — 클릭이 토글로 전파되지 않음 */
@@ -8823,7 +8881,7 @@ export declare interface TrainingItemResult {
 export declare const TrainingPagePopup: TrainingPagePopupComponent;
 
 /** @public */
-export declare function TrainingPagePopupBottom({ useNoiseSettingBtn, onSettings, onNext, onResult, stepIndex, stepCount, pageIndex, pageCount, resultOpen, }: TrainingPagePopupBottomProps): JSX.Element;
+export declare function TrainingPagePopupBottom({ useNoiseSettingBtn, onSettings, onNext, onResult, stepIndex, stepCount, pageIndex, pageCount, resultOpen, hideNoiseRows, }: TrainingPagePopupBottomProps): JSX.Element;
 
 /** @public */
 export declare type TrainingPagePopupBottomProps = {
@@ -8838,6 +8896,21 @@ export declare type TrainingPagePopupBottomProps = {
     pageIndex?: number;
     /** 쪽 수. 0(쪽이 없음)이어도 '결과보기'(완료) 단추는 보이고, '다음 문제'(쪽 이동)만 숨는다. 기본 1. */
     pageCount?: number;
+    /**
+     * **소음 두 줄을 안 그린다** — `소음 종류`·`소음 비율`(사장님 지시 (207), 2026-10-12).
+     *
+     * 소음이 아예 없는 훈련(짧은 이야기 듣기 · 긴 이야기 듣기 · 문장 순서화)에서 쓴다.
+     * `전체 소리`·`재생 속도` 는 그대로 선다.
+     *
+     * **흐리게가 아니라 안 그린다.** 흐린 줄은 *"지금은 못 바꾼다"* 를 말하는데, 여기서 할 말은
+     * *"이 훈련에는 소음이 없다"* 다. 흐린 채로 두면 치료사가 **바꿀 수 있는 줄을 찾아 헤맨다**
+     * (사장님이 그 줄을 짚으며 *"왜 이거 수정요청 했는데 계속 나오고 있지?"* 라 하셨다).
+     *
+     * **`noiseOverride` 와 따로 둔다 — 덮개는 *값*, 이 칸은 *보임*.** 묶으면 *"덮개는 걸되 줄은
+     * 보이게"* 를 못 한다 — 소음 하 문장 듣기의 제안 갈래가 그 꼴이다(덮개를 걸고도 치료사가
+     * 창에서 고친다). **한 칸이 두 가지를 뜻하게 하지 않는다.**
+     */
+    hideNoiseRows?: boolean;
 };
 
 /** @public */
@@ -8922,6 +8995,21 @@ export declare type TrainingPagePopupProps = {
      * 판에 실제로 걸린 값은 `NoiseSettingsStore.applied` 로 받는다.
      */
     noiseOverride?: Partial<CoreNoiseSettings> | ((saved: CoreNoiseSettings) => Partial<CoreNoiseSettings>);
+    /**
+     * **소음 두 줄을 안 그린다** — `소음 종류`·`소음 비율`(사장님 지시 (207), 2026-10-12).
+     *
+     * 소음이 아예 없는 훈련(짧은 이야기 듣기 · 긴 이야기 듣기 · 문장 순서화)에서 쓴다.
+     * `전체 소리`·`재생 속도` 는 그대로 선다.
+     *
+     * **흐리게가 아니라 안 그린다.** 흐린 줄은 *"지금은 못 바꾼다"* 를 말하는데, 여기서 할 말은
+     * *"이 훈련에는 소음이 없다"* 다. 흐린 채로 두면 치료사가 **바꿀 수 있는 줄을 찾아 헤맨다**
+     * (사장님이 그 줄을 짚으며 *"왜 이거 수정요청 했는데 계속 나오고 있지?"* 라 하셨다).
+     *
+     * **`noiseOverride` 와 따로 둔다 — 덮개는 *값*, 이 칸은 *보임*.** 묶으면 *"덮개는 걸되 줄은
+     * 보이게"* 를 못 한다 — 소음 하 문장 듣기의 제안 갈래가 그 꼴이다(덮개를 걸고도 치료사가
+     * 창에서 고친다). **한 칸이 두 가지를 뜻하게 하지 않는다.**
+     */
+    hideNoiseRows?: boolean;
     /** 훈련 결과 팝업 렌더러 — 없으면 기본 결과 팝업(TrainingResultPopup)을 띄운다 */
     renderResultPopup?: (props: {
         score?: number | null;
@@ -9205,7 +9293,9 @@ export declare type TrainingStepConfirmProps = {
      * 그 판이 통째로 사라졌다(말귀 실측: 「3대 영양소」 보기 여섯·정답 넷, 셋을 골라도 아무
      * 일도 안 남). **기억을 묻는 문제에서 덜 기억한 답도 그 사람의 답이다.**
      *
-     * 이제 여럿 고르기는 **`확인` 단추**로 낸다. 이 값은 채점 쪽이 쓰라고 그대로 받아 둔다.
+     * 내는 자리는 **`결과보기`** 다 — (102) 때 세운 `확인` 단추는 (206) 으로 걷혔다. 고르는
+     * 그 자리에서 매번 보고하되 **개수로는 넘어가지 않으므로** 위 두 까닭이 그대로 선다.
+     * 이 값은 채점 쪽이 쓰라고 그대로 받아 둔다 — **이 조각은 이 수로 아무 가름도 하지 않는다.**
      */
     correctCount?: number;
     useDisabledCovered?: boolean;
@@ -9450,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;
 
 /**
@@ -9695,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;
@@ -9920,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;
 
 /**
  * 비밀번호 변경 폼 상태와 핸들러를 캡슐화한 훅.
@@ -10033,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[];
 };
 
 /**
@@ -10321,12 +10417,6 @@ export declare function useWordTrainingDataGeneration(types: WordTrainingType[],
     generating: boolean;
 };
 
-/**
- * 단어 훈련 그룹별 필터 상태.
- * @param groupKey  그룹 식별자 (localStorage 키 및 상태 격리에 사용)
- * @param caps      그룹이 노출할 설정 (난이도/단어구성). 제외 필터는 항상 노출.
- * @public
- */
 export declare function useWordTrainingFilter(groupKey: string, caps: WordTrainingFilterCaps, opts?: {
     resetOnMount?: boolean;
     resetKey?: string;
@@ -11532,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 틀린 문항만 — 음소별 오류를 세는 쪽이 먼저 볼 것이다.
@@ -11541,13 +11631,4 @@ export declare function wordTypeLabels(t: 번역): Record<string, string>;
  */
 export declare function wrongItems(items: readonly TrainingItemResult[]): TrainingItemResult[];
 
-/** `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/NoiseSettingsTooltip.css

@@ -62,3 +62,22 @@
 .noise-settings__value--disabled {
     opacity: 0.4;
 }
+
+/* (208) 폭만 빌리는 그림자 줄 — NoiseSettingsTooltip.tsx 의 `noise-settings__width-ghost` 주석을 볼 것.
+   가로 폭은 참 줄과 똑같이 내고(그래서 좌우 패딩은 그대로), 높이만 0 으로 접는다.
+   `visibility: hidden` 이라 선도 그림자도 안 그린다. 줄 사이 구분선은 `.panel-row + .panel-row` 인데
+   이 감싸개는 `.panel-row` 가 아니라 그 규칙에 안 걸린다 — 그래도 안쪽 줄의 선·여백·최소높이를 0 으로 둔다. */
+.noise-settings__width-ghost {
+  visibility: hidden;
+  height: 0;
+  overflow: hidden;
+  pointer-events: none;
+}
+.noise-settings__width-ghost .panel-row {
+  padding-top: 0;
+  padding-bottom: 0;
+  margin: 0;
+  border: 0;
+  min-height: 0;
+}
+