@ihabdevteam/core 0.321.0 → 0.323.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.323.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;
     /**
@@ -4850,6 +4858,33 @@ export declare interface PhonemeFilterPanelProps {
  */
 export declare function phonemePartsOf(word: string): string[];
 
+/**
+ * **음절 자리의 코드** — `onset`·`vowel`·`coda`·`glide`, 그리고 빔(`none`).
+ *
+ * ## 왜 제 모듈인가
+ *
+ * 처음에는 이 가름을 `phonemePairSearch` 에 두고 `phonemeConvert` 가 들여왔다 — 그런데
+ * `phonemePairSearch` 도 `phonemeConvert`(`VOWEL_TO_PHONEME`)를 들여온다. **돌림 import** 가
+ * 되어 시험 **338 꾸러미**가 한꺼번에 무너졌다(2026-10-13). 두 쪽이 함께 쓰는 것은 **어느
+ * 한쪽이 아니라 그 아래**에 둔다.
+ *
+ * ## 왜 코드인가
+ *
+ * 전에는 열쇠가 한글(`'초성'`)이었고 그것이 **저장된다** — 단어표의
+ * `searchConfig.phonemeSelected` 가 그 꼴이다. 저장되는 값이 표시 언어에 묶이면 말을 고치려
+ * 해도 자료를 밀어야 한다(사장님 지시 2026-10-13 "동작에 한글이 끼지 말라").
+ *
+ * **값을 바꾸지 않고 읽는 쪽을 너그럽게 했다** — 표준의 *lenient reader · strict writer*.
+ * 저장된 표를 밀지 않아도 되고 소비자 코드도 안 바뀐다. 안쪽 로직에서만 한글이 사라진다.
+ *
+ * 어휘는 **훈련 필터가 이미 쓰던 것**과 같게 뒀다(`useWordTrainingFilter` 의 `onset`·`vowel`·
+ * `coda`) — 같은 뜻에 어휘가 둘이던 것을 모았다.
+ *
+ * **값(자모 `'ㄴ'`)은 그대로다** — 그것은 한국어 글자 그 자체이고 바꿀 것은 열쇠와 빔 값이다.
+ */
+/** 음절 자리 코드 @public */
+declare type PhonemeSectionCode = 'onset' | 'vowel' | 'coda' | 'glide';
+
 /** @public */
 export declare function PhonemeSelectBlock({ sections, selectedList, count, onCountChange, maxCount, minCount, combinationSections, combinationSectionsForSlot, onSelect, placeholder, className, title, titleIcon, disc, showInfoButton, onClearPhoneme, onSearch, onSearchEmpty, searchDisabled, searchLabel, searchChecking, pairMode, sectionType, beforeSearchContent, beforeContent, afterContent, hideCountControl, ordinal, }: PhonemeSelectBlockProps): JSX.Element;
 
@@ -5287,7 +5322,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 +6789,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 +7143,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 +9567,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 +9819,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 +10032,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 +10145,28 @@ 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;
-    칸: (label: string, key: K) => {
+    field: (label: string, key: K) => {
         label: string;
         sortDir: "desc" | "asc" | null;
         onClick: () => void;
     };
-    sortRows: <R>(rows: readonly R[], 값: (row: R, key: K) => unknown) => readonly R[];
+    sortRows: <R>(rows: readonly R[], getValue: (row: R, key: K) => unknown) => readonly R[];
 };
 
 /**
@@ -10987,7 +11024,16 @@ export declare interface WordSearchResultGroup {
 export declare interface WordSearchResultItem {
     id: string;
     words: WordSearchResultWord[];
+    /**
+     * 갈린 자리 — **옛 한글 이름**(`'초성'`·`'모음'`·`'종성'`·`'활음'`)이다.
+     *
+     * @deprecated `diffSectionCode` 를 쓴다 — 같은 자리를 코드로 가리킨다. 2026-10-13 안쪽을
+     * 코드로 옮겼지만 **소비자가 이 값으로 묶음을 가른다**(말귀 `WordPairsPage` 의 `GROUP_ORDER`).
+     * 혼자 바꾸면 그쪽 묶음이 조용히 빈다. 소비자가 옮긴 뒤 걷는다.
+     */
     diffSection?: string;
+    /** 갈린 자리 — 코드(`'onset'`·`'vowel'`·`'coda'`·`'glide'`). 이쪽이 정본이다. */
+    diffSectionCode?: PhonemeSectionCode;
     diffHasEmpty?: boolean;
 }
 
@@ -11238,11 +11284,24 @@ export declare interface WordTableButtonProps {
     className?: string;
 }
 
-/** @public */
-export declare type WordTableContentType = '단어' | '이미지' | '표준 발음' | '구어체 발음';
+/**
+ * 단어표 칸에 무엇을 그리나 — **코드다, 보일 글이 아니다.**
+ *
+ * 2026-10-13 한글 값(`'단어'`·`'이미지'`…)에서 옮겼다(사장님 지시 "모두 표준으로"). 저장되는
+ * 값이 표시 언어에 묶이면 **말을 고치려 해도 자료를 밀어야** 한다 — 보일 글은 사전이 쥐고
+ * (`wordTable.filter.*`), 코드는 안 바뀐다. 같은 저장소의 `wordAttributeFilterCodes` 가
+ * 이미 그 꼴이었다(`'grade'`·`'native'`…).
+ *
+ * 옮길 때 소비자 넷을 셌다 — `WordTableContentType`·`WordTableCutLine` 을 적는 줄이 **0** 이고,
+ * 저장되는 자리도 없었다(`SavedWordTable` 에 안 들고 `localStorage` 에도 안 적는다).
+ * 그래서 받침 없이 그냥 옮겼다 — `DeviceSide` 때와 달리 밀 자료가 없다.
+ *
+ * @public
+ */
+export declare type WordTableContentType = 'word' | 'image' | 'standardPron' | 'colloquialPron';
 
-/** @public */
-export declare type WordTableCutLine = '표시' | '점선' | '코너' | '미표시';
+/** 칸 사이 선 — **코드다.** 보일 글은 사전(`wordTable.filter.show`·`.dotted`·`.corner`·`.hide`). @public */
+export declare type WordTableCutLine = 'show' | 'dashed' | 'corner' | 'hide';
 
 /** 표시(비편집) 단어표의 표 설정 값 — WordTable 렌더 props에 그대로 전달한다. */
 export declare interface WordTableDisplaySettings {
@@ -11601,7 +11660,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 +11669,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/Accordion.js

@@ -37,7 +37,7 @@ function Item({ title, body, open = false, onToggle, avatar, titleClassName = 'b
 export default function Accordion({ items = [], defaultOpenIndex = 0, size = 72, className = '', bodyClassName, }) {
     /* 펼침을 자리 번호로만 들고 있어, 앞에 항목이 더해지면 **다른 항목이** 펼쳐졌다. id 가 있는 항목을 누르면 id 로 기억한다.
        처음(아직 누르기 전)은 defaultOpenIndex 자리 — 항목이 늦게 와도 그 자리가 열린다(예전과 같다). */
-    const [열림, set열림] = useState({ index: defaultOpenIndex });
-    const 열렸나 = (item, i) => 열림.id != null && item.id != null ? item.id === 열림.id : 열림.id == null && i === 열림.index;
-    return (_jsx("div", { className: `accordion-group accordion-group--s${size} ${className}`.trim(), role: "list", children: items.map((item, i) => (_jsx(Item, { title: item.title, body: item.body, avatar: item.avatar, open: 열렸나(item, i), onToggle: () => set열림(열렸나(item, i) ? { index: -1 } : { index: i, id: item.id }), bodyClassName: bodyClassName }, item.id ?? i))) }));
+    const [open, setOpen] = useState({ index: defaultOpenIndex });
+    const isOpen = (item, i) => open.id != null && item.id != null ? item.id === open.id : open.id == null && i === open.index;
+    return (_jsx("div", { className: `accordion-group accordion-group--s${size} ${className}`.trim(), role: "list", children: items.map((item, i) => (_jsx(Item, { title: item.title, body: item.body, avatar: item.avatar, open: isOpen(item, i), onToggle: () => setOpen(isOpen(item, i) ? { index: -1 } : { index: i, id: item.id }), bodyClassName: bodyClassName }, item.id ?? i))) }));
 }

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

@@ -29,8 +29,8 @@ export default function Alert({ tone = 'info', title, message, children, dismiss
         return null;
     const cls = cx('alert', `alert--${tone}`, className);
     /* 톤과 상관없이 늘 role="alert" 였다 — "저장했습니다"(success)·안내(info)까지 하던 말을 끊고 읽혔다 */
-    const 방식 = live ?? (tone === 'danger' || tone === 'warning' ? 'assertive' : 'polite');
-    const role = 방식 === 'assertive' ? 'alert' : 방식 === 'polite' ? 'status' : undefined;
+    const liveMode = live ?? (tone === 'danger' || tone === 'warning' ? 'assertive' : 'polite');
+    const role = liveMode === 'assertive' ? 'alert' : liveMode === 'polite' ? 'status' : undefined;
     const hasTitle = Boolean(title);
     const hasMessage = Boolean(message || children);
     return (_jsxs("div", { ref: rootRef, className: cls, role: role, children: [_jsxs("div", { className: "alert__body", children: [_jsxs("div", { className: "alert__header", children: [_jsx(Icon, { icon: TONE_ICON[tone], size: 20, className: "alert__icon" }), hasTitle && _jsx("span", { className: "alert__title body-2", children: title }), !hasTitle && hasMessage && _jsx("div", { className: "alert__message body-3", children: message || children })] }), hasTitle && hasMessage && (_jsx("div", { className: "alert__message alert__message--indented body-3", children: message || children }))] }), dismissible && (_jsx("button", { type: "button", className: "alert__dismiss", onClick: handleDismiss, "aria-label": t('common.close', '닫기'), children: "\u00D7" }))] }));