@ihabdevteam/core 0.145.0 → 0.146.0

package/dist/ihabdevteam-core.d.ts

@@ -1386,7 +1386,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.145.0";
+export declare const CORE_VERSION = "0.146.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -7397,6 +7397,8 @@ export declare type TrainingPlan = {
 declare interface TrainingProblem {
     question: string;
     distractors: string[];
+    /** 탈락 문제에서 빠진 조각(합성어 부분 탈락이 채운다 — 앞뒤로 같은 조각이 있으면 remain 만으로는 어느 쪽인지 모른다) */
+    dropped?: string;
 }
 
 /** @public */

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

@@ -1,4 +1,6 @@
+'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useId } from 'react';
 import { cx } from '../utils/cx';
 import Icon from './Icon';
 import './ActionCard.css';
@@ -15,14 +17,20 @@ import './ActionCard.css';
  * @public
  */
 export default function ActionCard({ icon, title, description, cta, tone = 'main', disabled = false, onClick, className = '', }) {
+    /* 이름은 제목, 설명·행선지(cta)는 설명으로 잇는다 — aria-label={title} 이 안의 글자를 덮어 "확인 중..." 같은 cta 변화와
+       설명이 낭독기에서 사라졌다(kscan 홈) */
+    const uid = useId();
+    const titleId = `${uid}-title`;
+    const descId = `${uid}-desc`;
+    const ctaId = `${uid}-cta`;
     const activate = () => {
         if (!disabled)
             onClick?.();
     };
-    return (_jsx("section", { role: "button", tabIndex: disabled ? -1 : 0, "aria-disabled": disabled || undefined, "aria-label": title, onClick: activate, onKeyDown: (e) => {
+    return (_jsx("section", { role: "button", tabIndex: disabled ? -1 : 0, "aria-disabled": disabled || undefined, "aria-labelledby": titleId, "aria-describedby": `${descId} ${ctaId}`, onClick: activate, onKeyDown: (e) => {
             if (e.key === 'Enter' || e.key === ' ') {
                 e.preventDefault();
                 activate();
             }
-        }, className: cx('action-card', `action-card--${tone}`, disabled && 'action-card--disabled', className), children: _jsxs("div", { className: "action-card__body", children: [_jsx("span", { "aria-hidden": true, className: "action-card__chip", children: _jsx(Icon, { icon: icon, size: 34 }) }), _jsxs("div", { className: "action-card__text", children: [_jsx("h2", { className: "action-card__title", children: title }), _jsx("p", { className: "action-card__desc", children: description })] }), _jsxs("div", { className: "action-card__cta", children: [_jsx("span", { children: cta }), _jsx("span", { "aria-hidden": true, className: "action-card__arrow", children: _jsx(Icon, { icon: "arrow-right", size: 18 }) })] })] }) }));
+        }, className: cx('action-card', `action-card--${tone}`, disabled && 'action-card--disabled', className), children: _jsxs("div", { className: "action-card__body", children: [_jsx("span", { "aria-hidden": true, className: "action-card__chip", children: _jsx(Icon, { icon: icon, size: 34 }) }), _jsxs("div", { className: "action-card__text", children: [_jsx("h2", { id: titleId, className: "action-card__title", children: title }), _jsx("p", { id: descId, className: "action-card__desc", children: description })] }), _jsxs("div", { className: "action-card__cta", children: [_jsx("span", { id: ctaId, children: cta }), _jsx("span", { "aria-hidden": true, className: "action-card__arrow", children: _jsx(Icon, { icon: "arrow-right", size: 18 }) })] })] }) }));
 }

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

@@ -1,6 +1,6 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useId, useState } from 'react';
+import { useEffect, useId, useRef, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import { pushEsc } from '../hooks/escStack';
 import './LandingHeader.css';
@@ -27,12 +27,19 @@ export default function LandingHeader({ logo, logoAlt = '', logoHref, links = []
     // 서랍 id 를 고정 문자열로 두면 한 화면에 헤더가 둘일 때(미리보기·놀이터 견본) id 가 겹쳐
     // 햄버거의 aria-controls 가 엉뚱한 서랍을 가리킨다 — 헤더마다 따로 짓는다.
     const drawerId = useId();
+    const toggleRef = useRef(null);
     /* 서랍이 열려 있으면 Esc 로 닫는다(공유 ESC 스택 — 맨 위 하나만). 넓은 화면(961px~, 서랍이 CSS 로 숨는 폭)으로 가면
        닫는다 — 안 닫으면 open 이 남아 좁은 폭으로 돌아오는 순간 서랍이 다시 펼쳐졌다. */
     useEffect(() => {
         if (!open)
             return;
-        const 풀기 = pushEsc(() => setOpen(false));
+        // 서랍 안에 포커스가 있으면 햄버거로 돌려 준다 — 서랍이 hidden 이 되며 포커스가 숨은 링크에 남아 갈 곳을 잃었다
+        const 풀기 = pushEsc(() => {
+            const 서랍 = document.getElementById(drawerId);
+            if (서랍 && 서랍.contains(document.activeElement))
+                toggleRef.current?.focus();
+            setOpen(false);
+        });
         const mq = typeof window !== 'undefined' && window.matchMedia ? window.matchMedia('(min-width: 961px)') : null;
         const 넓어짐 = (e) => { if (e.matches)
             setOpen(false); };
@@ -42,7 +49,7 @@ export default function LandingHeader({ logo, logoAlt = '', logoHref, links = []
             mq.addEventListener?.('change', 넓어짐);
         }
         return () => { 풀기(); mq?.removeEventListener?.('change', 넓어짐); };
-    }, [open]);
+    }, [open, drawerId]);
     const innerClass = containerClassName
         ? `${containerClassName} landing-header__inner`
         : 'landing-header__inner';
@@ -58,7 +65,7 @@ export default function LandingHeader({ logo, logoAlt = '', logoHref, links = []
                         return logoHref
                             ? _jsx("a", { href: logoHref, className: "landing-header__brand", children: brand })
                             : _jsx("div", { className: "landing-header__brand", children: brand });
-                    })(), links.length > 0 && (_jsx("nav", { className: "landing-header__links", children: links.map(item => (_jsx("span", { children: link(item) }, item.href))) })), _jsxs("div", { className: "landing-header__actions", children: [actions, links.length > 0 && (_jsx("button", { type: "button", onClick: () => setOpen(v => !v), "aria-expanded": open, "aria-controls": drawerId, "aria-label": open ? menuLabel.close : menuLabel.open, className: open
+                    })(), links.length > 0 && (_jsx("nav", { className: "landing-header__links", children: links.map((item, i) => (_jsx("span", { children: link(item) }, `${i}:${item.href}`))) })), _jsxs("div", { className: "landing-header__actions", children: [actions, links.length > 0 && (_jsx("button", { ref: toggleRef, type: "button", onClick: () => setOpen(v => !v), "aria-expanded": open, "aria-controls": drawerId, "aria-label": open ? menuLabel.close : menuLabel.open, className: open
                                     ? 'landing-header__toggle landing-header__toggle--open'
-                                    : 'landing-header__toggle', children: _jsxs("span", { className: "landing-header__burger", children: [_jsx("span", {}), _jsx("span", {}), _jsx("span", {})] }) }))] })] }), links.length > 0 && (_jsx("nav", { id: drawerId, hidden: !open, className: "landing-header__drawer", children: _jsx("div", { className: containerClassName ?? undefined, children: links.map(item => (_jsx("span", { className: "landing-header__drawer-item", children: link(item, () => setOpen(false)) }, item.href))) }) }))] }));
+                                    : 'landing-header__toggle', children: _jsxs("span", { className: "landing-header__burger", children: [_jsx("span", {}), _jsx("span", {}), _jsx("span", {})] }) }))] })] }), links.length > 0 && (_jsx("nav", { id: drawerId, hidden: !open, className: "landing-header__drawer", children: _jsx("div", { className: containerClassName ?? undefined, children: links.map((item, i) => (_jsx("span", { className: "landing-header__drawer-item", children: link(item, () => setOpen(false)) }, `${i}:${item.href}`))) }) }))] }));
 }

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

@@ -22,6 +22,12 @@ export default function ConfirmPopup(props) {
        동안 한 번 더 누르면 onConfirm 이 또 불렸다(말귀 단어표 삭제·이용권 삭제가 두 번 나가 성공 뒤 실패 토스트).
        닫기로 끝나면 잠금을 풀지 않는다 — 창이 사라지는 중이다. 닫지 않고 끝나면(closeOnConfirm=false·실패) 풀고, 처리 중에
        단추가 꺼지며 body 로 떨어진 포커스를 누른 단추로 되돌린다. */
+    /* closeOnConfirm=false 로 두고 콜백이 넘겨받은 close() 를 **스스로** 부르면(문서가 권하는 "성공했을 때만 닫기") 그것도 닫힘으로
+       센다 — 전에는 closeOnConfirm(false) 만 돌려 닫히는 260ms 동안 잠금이 풀려, 한 번 더 누르면 확인이 두 번 나갔다. */
+    const 닫기를센다 = (closeWithAnimation) => {
+        let 닫았음 = false;
+        return { close: () => { 닫았음 = true; closeWithAnimation(); }, 닫았나: () => 닫았음 };
+    };
     const 한번만 = async (일) => {
         if (busyRef.current)
             return;
@@ -32,6 +38,11 @@ export default function ConfirmPopup(props) {
         try {
             닫는중 = await 일();
         }
+        catch (e) {
+            /* 거절은 창을 남기고 잠금을 푸는 것으로 끝낸다(계약) — 받아 주지 않으면 처리되지 않은 거절로 새어 Next 개발 오버레이가 떴다 */
+            if (typeof console !== 'undefined')
+                console.error(e);
+        }
         finally {
             if (!닫는중) {
                 busyRef.current = false;
@@ -58,11 +69,12 @@ export default function ConfirmPopup(props) {
                     // 두 번째는 엉뚱한 실패로 돌아온다.
                     onClick: async ({ closeWithAnimation }) => {
                         await 한번만(async () => {
-                            await extraAction.onClick(closeWithAnimation);
+                            const 닫기 = 닫기를센다(closeWithAnimation);
+                            await extraAction.onClick(닫기.close);
                             const 닫음 = extraAction.closeOnClick ?? true;
                             if (닫음)
                                 closeWithAnimation();
-                            return 닫음;
+                            return 닫음 || 닫기.닫았나();
                         });
                     },
                 }] : []),
@@ -78,10 +90,11 @@ export default function ConfirmPopup(props) {
                 disabled: confirmDisabled || busy,
                 onClick: async ({ closeWithAnimation }) => {
                     await 한번만(async () => {
-                        await onConfirm(closeWithAnimation);
+                        const 닫기 = 닫기를센다(closeWithAnimation);
+                        await onConfirm(닫기.close);
                         if (closeOnConfirm)
                             closeWithAnimation();
-                        return closeOnConfirm;
+                        return closeOnConfirm || 닫기.닫았나();
                     });
                 },
             },

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

@@ -66,6 +66,7 @@ export default function ListPopup(props) {
             setSortKey(key);
             setSortAsc(true);
         }
+        setPage(1); // 차례가 바뀌면 첫 쪽으로 — 3쪽에서 머리를 누르면 3쪽에 남아 새 차례의 앞을 못 봤다
     }, [sortKey]);
     // countLabel("총 {n}명")을 Toolbar count의 prefix/suffix로 분해
     const countParts = useMemo(() => {

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

@@ -134,6 +134,10 @@ export default function Popup(props) {
         setClosing(false);
     }, []);
     const animateThen = useCallback((cb, 닫기뿐 = false) => {
+        /* 이미 떠난 창을 닫으려는 부름(ConfirmPopup 의 onConfirm 안에서 부모가 창을 치운 뒤 closeWithAnimation)은 받지 않는다 —
+           정리가 끝난 뒤 걸린 타이머라 걷히지 않고 260ms 뒤 **취소 경로의 onClose** 가 불렸다(kscan 이 closeOnConfirm=false 로 우회). */
+        if (닫기뿐 && !살아있음Ref.current)
+            return;
         if (closingRef.current)
             return;
         closingRef.current = true;

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

@@ -10,7 +10,8 @@ const TITLE_CLASS = {
 /** @public */
 export default function Section({ type = 'page', title, headingLevel, icon, action, disc, children, className, style }) {
     const titleClass = TITLE_CLASS[type];
-    const hasHeader = title || disc;
+    // action·icon 만 줘도 머리를 그린다 — 제목·설명이 없으면 추가 단추가 조용히 버려졌다
+    const hasHeader = title || disc || action || icon;
     /* 제목이 맨 div 라 낭독기의 제목 목록에 안 잡혔다. 단계는 페이지 구조에 달려 있어
        부르는 쪽이 정한다 — 안 주면 예전 그대로 div. 모양은 클래스(h3/h4/h5)가 정하고
        제목 태그의 기본 여백은 .section__title 의 margin:0 이 지운다. */

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

@@ -105,9 +105,12 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
         const d = dragRef.current;
         if (!d)
             return;
-        setColWidths(prev => {
-            if (!prev)
-                return prev;
+        /* 저장할 값(colWidthsRef)을 **여기서 곧바로** 맞춘다 — 렌더 뒤 효과에서야 갱신돼, 마지막 이동 직후 손을 떼면 화면은 새 폭인데
+           저장소에는 한 박자 전 폭이 남았다(window pointermove 는 React 밖이라 렌더가 밀린다). */
+        const prev = colWidthsRef.current;
+        if (!prev)
+            return;
+        {
             const copy = [...prev];
             if (d.next != null && d.startWNext != null) {
                 // fit — 이동량을 두 컬럼이 나눠 갖는다. 둘 다 최소폭 밑으로 내려가지 않도록
@@ -120,8 +123,9 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
             else {
                 copy[d.index] = Math.max(MIN_COL_W, d.startW + (e.clientX - d.startX));
             }
-            return copy;
-        });
+            colWidthsRef.current = copy;
+            setColWidths(copy);
+        }
     }, []);
     const onResizeEnd = useCallback(() => {
         dragRef.current = null;
@@ -157,6 +161,7 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
         dragRef.current = next >= 0
             ? { index, startX: e.clientX, startW: measured[index], next, startWNext: measured[next] }
             : { index, startX: e.clientX, startW: measured[index] };
+        colWidthsRef.current = measured;
         setColWidths(measured);
         window.addEventListener('pointermove', onResizeMove);
         window.addEventListener('pointerup', onResizeEnd);
@@ -194,7 +199,10 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
                 if (c)
                     w = Math.max(w, c.getBoundingClientRect().width);
             }
-            return Math.max(MIN_COL_W, Math.ceil(w));
+            /* 고정 px 열은 정해 둔 값 그대로 — 최소 폭(MIN_COL_W)으로 올린 값을 고정 합에 넣으면 격자에는 원래 값(40px)으로 나가
+               그만큼(8px) 표 오른쪽이 비었다(말귀 어드민 버그 탭·쿠폰) */
+            const 고정값 = isFixedPxRef.current(i) ? parseFloat(defaultColsRef.current[i]) : NaN;
+            return Number.isFinite(고정값) ? 고정값 : Math.max(MIN_COL_W, Math.ceil(w));
         });
         /* 격자가 실제로 채우는 폭 — `clientWidth` 는 안쪽 여백을 포함하므로 뺀다
            (되돌리기 단추 자리로 40px 을 비워 두었다). */
@@ -319,10 +327,12 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
                                 const isDragging = draggingId != null && item.id === draggingId;
                                 const 눌림 = !!onRowClick && (isRowClickable ? isRowClickable(item) : true);
                                 const isExpanded = expandedId != null && (expandedId instanceof Set ? expandedId.has(item.id) : item.id === expandedId);
-                                return (_jsx(TableRow, { className: `${눌림 ? ' table-row--clickable' : ''}${onRowDragStart ? ' table-row--draggable' : ''}${isDragging ? ' table-row--dragging' : ''}`.trim(), draggable: !!onRowDragStart, 
+                                return (_jsx(TableRow
+                                // 타입까지 열쇠에 — id 없는 줄(idx 0)과 id:0, 1 과 '1' 이 같은 열쇠가 되어 목록을 바꾼 뒤 옛 줄이 남았다
+                                , { className: `${눌림 ? ' table-row--clickable' : ''}${onRowDragStart ? ' table-row--draggable' : ''}${isDragging ? ' table-row--dragging' : ''}`.trim(), draggable: !!onRowDragStart, 
                                     // 옆의 핸들러들처럼 있을 때만 넘긴다. 항상 함수를 만들어 넘기면
                                     // TableRow 가 "클릭 가능"으로 보고 role="button" · tabIndex=0 을 붙여,
                                     // 클릭 동작이 없는 표의 모든 행이 버튼으로 읽히고 탭 정지점이 된다.
-                                    onClick: 눌림 ? () => onRowClick(item) : undefined, onMouseEnter: onRowMouseEnter ? (e) => onRowMouseEnter(item, e) : undefined, onMouseLeave: onRowMouseLeave ? (e) => onRowMouseLeave(item, e) : undefined, onDragStart: onRowDragStart ? (e) => onRowDragStart(item, e) : undefined, onDragEnd: onRowDragEnd ? (e) => onRowDragEnd(item, e) : undefined, expandedContent: isExpanded && renderExpandedRow ? renderExpandedRow(item) : undefined, children: renderRow(item).map((cell, i) => (_jsx(TableCell, { className: cell.className, style: cell.style, children: cell.content }, i))) }, String(item.id ?? idx)));
+                                    onClick: 눌림 ? () => onRowClick(item) : undefined, onMouseEnter: onRowMouseEnter ? (e) => onRowMouseEnter(item, e) : undefined, onMouseLeave: onRowMouseLeave ? (e) => onRowMouseLeave(item, e) : undefined, onDragStart: onRowDragStart ? (e) => onRowDragStart(item, e) : undefined, onDragEnd: onRowDragEnd ? (e) => onRowDragEnd(item, e) : undefined, expandedContent: isExpanded && renderExpandedRow ? renderExpandedRow(item) : undefined, children: renderRow(item).map((cell, i) => (_jsx(TableCell, { className: cell.className, style: cell.style, children: cell.content }, i))) }, item.id != null ? `${typeof item.id}:${item.id}` : `__idx:${idx}`));
                             }) })] }))] }) }));
 }

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

@@ -850,6 +850,8 @@ function TrainingPagePopupInner(props) {
                 results: (resultOverlay.results || resultOverlay.answers || []),
                 contextsLength: resultOverlay.results ? resultOverlay.results.length : (resultOverlay.answers ? resultOverlay.answers.length : 0),
                 onReplay: () => {
+                    // 다시 푸는 판의 소요 시간은 지금부터 — 마운트 때 한 번만 찍어 앞 판 시간·결과 창을 보던 시간까지 섞였다(60초가 660초)
+                    completionStartRef.current = Date.now();
                     결과창닫기();
                     setReplayCount((n) => n + 1);
                     if (hasScenario) {

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

@@ -1,6 +1,6 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useCallback, useMemo, useState, useEffect } from 'react';
+import { useCallback, useMemo, useState, useEffect, useRef } from 'react';
 import { useTranslation } from 'react-i18next';
 import TrainingStep from './TrainingStep';
 import TrainingWordCard from './TrainingWordCard';
@@ -29,6 +29,16 @@ export default function TrainingStepCardOrder({ index, stepIndex, isLast = false
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [choicesKey]);
     /* eslint-enable react-hooks/set-state-in-effect */
+    /* 쪽 전환: stepIndex 가 이 단계 이상이었다가 미만으로 돌아오면(다음 문제가 시작됨) 고른 순서를 비운다(Confirm 과 같게) —
+       보기가 같은 다음 문항(같은 세 낱말·섞은 배치가 같음)에서 앞 문항의 순서가 남아 고른 적 없는 카드까지 채점됐다. */
+    const prevStepIndexRef = useRef(undefined);
+    useEffect(() => {
+        const prev = prevStepIndexRef.current;
+        if (typeof prev === 'number' && typeof stepIndex === 'number' && typeof index === 'number' && prev >= index && stepIndex < index) {
+            setSelectedOrder(Array.from({ length: choiceCount }, () => null));
+        }
+        prevStepIndexRef.current = stepIndex;
+    }, [stepIndex, index, choiceCount]);
     const nextRank = useMemo(() => selectedOrder.filter(v => v !== null).length + 1, [selectedOrder]);
     /* 다음 배열은 updater **밖에서** 셈하고 알린다 — updater 안에서 onChange·onDone 을 부르면 StrictMode 에서 한 번
        클릭에 두 번씩 나갔다. 풀 때도 알린다(전에는 풀면 부모가 옛 순서를 그대로 들고 있었다). */

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

@@ -46,9 +46,10 @@ export function useTablePaging(rows, resetOn, opts) {
     const total = Math.max(1, Math.ceil(rows.length / Number(pageSize)));
     /* 행이 줄어 범위를 넘으면 **상태도** 끝 쪽으로 맞춘다 — 보이는 쪽만 조이고 상태를 두면, 필터로 줄었다가 다시 늘 때 예전
        5쪽으로 튀었다. 렌더 중에 맞춘다(위 resetOn 과 같은 꼴). */
-    if (page > total)
-        setPage(total);
-    const 이쪽 = Math.min(page, total);
+    // 1 보다 작은 쪽(setPage(0)·-1)도 막는다 — 0 은 빈 쪽, -1 은 음수 slice 로 엉뚱한 줄이 나왔다
+    if (page > total || page < 1 || !Number.isFinite(page))
+        setPage(Math.min(Math.max(1, Number.isFinite(page) ? page : 1), total));
+    const 이쪽 = Math.min(Math.max(1, Number.isFinite(page) ? page : 1), total);
     const pageRows = useMemo(() => rows.slice((이쪽 - 1) * Number(pageSize), 이쪽 * Number(pageSize)), [rows, 이쪽, pageSize]);
     return {
         pageRows,

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

@@ -1,13 +1,13 @@
 /** 글자 둘을 한국어 차례로 견준다 */
 export declare function 한글순(a: string, b: string): number;
 /**
- * 표의 한 칸끼리 견준다 — **숫자는 숫자로, 나머지는 글자 속 숫자까지 수로.**
+ * 표의 한 칸끼리 견준다 — **숫자는 숫자로, 글자 속 숫자도 수로.**
  *
  * 표의 칸은 무엇이든 올 수 있어서 늘 글자로 견주면 **숫자 칸이 망가진다**
- * (`10` 이 `9` 앞에 선다). 그래서 둘 다 온전한 숫자(수, 또는 숫자만 든 글자)면 숫자로 견주고,
- * 그 밖에는 한국어 차례로 견주되 글자 안의 숫자는 수로 읽는다(`회차 9` 가 `회차 10` 앞).
+ * (`10` 이 `9` 앞에 선다). 값을 숫자 조각과 글자 조각으로 나눠 앞에서부터 견준다 —
+ * `회차 9` 가 `회차 10` 앞, `12.25%` 가 `12.5%` 앞, `-10 dB` 가 `-5 dB` 앞. 숫자 조각은 글자 조각 앞에 선다.
  *
- * 비어 있는 값(`null`·`undefined`)은 빈 글자로 본다 — 부르는 쪽이 이미
+ * 비어 있는 값(`null`·`undefined`·NaN)은 빈 글자로 본다 — 부르는 쪽이 이미
  * `?? ''` 로 채워 넘기던 것과 같은 뜻이다.
  */
 export declare function 칸순(a: unknown, b: unknown): number;

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

@@ -22,39 +22,67 @@ const 콜레이터 = (() => {
 export function 한글순(a, b) {
     return 콜레이터().compare(a, b);
 }
-const 숫자글자 = /^-?\d+(\.\d+)?$/;
-/* 칸의 글자 비교는 **안의 숫자도 수로** 본다 — 숫자 칸끼리는 수로, 섞인 칸은 글자로 견주면 '9'<'10'(수)·'10'<'10분'(글자)·
-   '10분'<'9'(글자) 로 돌고 돌아, 같은 행을 들어온 차례만 바꿔도 정렬 결과가 달랐다. 수를 수로 읽는 콜레이터는
-   숫자끼리의 차례와 같은 쪽을 낸다. */
-const 칸콜레이터 = (() => {
-    let 것 = null;
-    return () => {
-        if (!것)
-            것 = new Intl.Collator('ko', { numeric: true });
-        return 것;
-    };
-})();
+const 조각열쇠 = new Map();
+function 조각내기(s) {
+    const 있음 = 조각열쇠.get(s);
+    if (있음)
+        return 있음;
+    const out = [];
+    // 뒤돌아보기(?<=) 는 iOS 15 Safari 가 못 읽어 모듈째 깨지므로 쓰지 않는다 — 빼기표 앞 글자를 손으로 본다
+    const re = /-?\d+(?:\.\d+)?/g;
+    let 끝 = 0;
+    for (let m = re.exec(s); m; m = re.exec(s)) {
+        let 시작 = m.index;
+        let 수 = m[0];
+        if (수[0] === '-' && 시작 > 0 && !/\s/.test(s[시작 - 1])) {
+            시작 += 1;
+            수 = 수.slice(1);
+        }
+        if (시작 > 끝)
+            out.push(s.slice(끝, 시작));
+        out.push(Number(수));
+        끝 = m.index + m[0].length;
+    }
+    if (끝 < s.length)
+        out.push(s.slice(끝));
+    if (조각열쇠.size > 5000)
+        조각열쇠.clear();
+    조각열쇠.set(s, out);
+    return out;
+}
 /**
- * 표의 한 칸끼리 견준다 — **숫자는 숫자로, 나머지는 글자 속 숫자까지 수로.**
+ * 표의 한 칸끼리 견준다 — **숫자는 숫자로, 글자 속 숫자도 수로.**
  *
  * 표의 칸은 무엇이든 올 수 있어서 늘 글자로 견주면 **숫자 칸이 망가진다**
- * (`10` 이 `9` 앞에 선다). 그래서 둘 다 온전한 숫자(수, 또는 숫자만 든 글자)면 숫자로 견주고,
- * 그 밖에는 한국어 차례로 견주되 글자 안의 숫자는 수로 읽는다(`회차 9` 가 `회차 10` 앞).
+ * (`10` 이 `9` 앞에 선다). 값을 숫자 조각과 글자 조각으로 나눠 앞에서부터 견준다 —
+ * `회차 9` 가 `회차 10` 앞, `12.25%` 가 `12.5%` 앞, `-10 dB` 가 `-5 dB` 앞. 숫자 조각은 글자 조각 앞에 선다.
  *
- * 비어 있는 값(`null`·`undefined`)은 빈 글자로 본다 — 부르는 쪽이 이미
+ * 비어 있는 값(`null`·`undefined`·NaN)은 빈 글자로 본다 — 부르는 쪽이 이미
  * `?? ''` 로 채워 넘기던 것과 같은 뜻이다.
  */
 export function 칸순(a, b) {
-    /* NaN 은 숫자가 아닌 것으로 — a - b 가 NaN 이면 정렬 비교가 어긋나 줄이 뒤섞였다. 글자로 온 숫자('10'·'9')도
-       둘 다 온전한 숫자면 숫자로 견준다(전에는 '10' 이 '9' 앞에 섰다). */
-    const 수 = (v) => (typeof v === 'number' && !Number.isNaN(v) ? v : typeof v === 'string' && 숫자글자.test(v.trim()) ? Number(v) : null);
-    const na = 수(a), nb = 수(b);
-    if (na !== null && nb !== null)
-        return na - nb;
-    const sa = a == null ? '' : String(a), sb = b == null ? '' : String(b);
-    /* 소수점·음수가 든 글자('12.5%'·'-10 dB')는 수로 읽는 콜레이터가 틀린다 — 점 뒤를 따로 떼어 '12.5' 가 '12.25' 뒤에,
-       빼기표를 버려 '-5' 가 '-10' 뒤에 섰다. 그런 칸은 한국어 글자 차례로 둔다. 선행 0 도 수로 읽으면 'A007'='A7' 이 되어 글자로. */
-    if (/\d\.\d|-\d|(^|\D)0\d/.test(sa) || /\d\.\d|-\d|(^|\D)0\d/.test(sb))
-        return 한글순(sa, sb);
-    return 칸콜레이터().compare(sa, sb);
+    const 글 = (v) => (v == null || (typeof v === 'number' && Number.isNaN(v)) ? '' : String(v).trim());
+    const sa = 글(a), sb = 글(b);
+    if (sa === sb)
+        return 0;
+    const ka = 조각내기(sa), kb = 조각내기(sb);
+    const n = Math.min(ka.length, kb.length);
+    for (let i = 0; i < n; i++) {
+        const x = ka[i], y = kb[i];
+        if (typeof x === 'number' && typeof y === 'number') {
+            if (x !== y)
+                return x - y;
+            continue;
+        }
+        if (typeof x === 'number')
+            return -1;
+        if (typeof y === 'number')
+            return 1;
+        const c = 한글순(x, y);
+        if (c !== 0)
+            return c;
+    }
+    if (ka.length !== kb.length)
+        return ka.length - kb.length;
+    return 한글순(sa, sb);
 }

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

@@ -55,7 +55,9 @@ export function toItemResults(raw) {
             /* 물음이 담긴 칸 이름이 유형마다 다르다 — 문장 훈련 넷(소음 하 듣기·문장 순서화·
                짧은/긴 이야기)은 `sentence` 에, 낱말 훈련은 `word` 에 담는다. `sentence` 를
                빠뜨렸더니 대면 세션 기록의 item_id 가 전부 null 이었다(2026-08-27 실측). */
-            question: text(r.question) ?? text(r.sentence) ?? text(r.word) ?? text(r.targetSyllable),
+            /* 단어 조작(합성·대치·탈락)·확인형은 물음을 `text` 에 담는다 — 빠져 기록의 question 이 null 이라 오답 패널에서 통째로
+               빠졌는데, 결과 창(resolveProblem)은 text 를 읽어 보여 두 화면이 어긋났다. 결과 창과 같은 칸들을 본다. */
+            question: text(r.question) ?? text(r.q) ?? text(r.sentence) ?? text(r.text) ?? text(r.prompt) ?? text(r.word) ?? text(r.targetSyllable),
             answer: text(r.answer),
             selected: text(r.selectedText) ?? text(r.selected),
             correct: itemCorrectness(r),

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

@@ -75,6 +75,8 @@ export declare function syllableContrasts(cs: Syllable, part: 'cho' | 'jung' | '
 export interface TrainingProblem {
     question: string;
     distractors: string[];
+    /** 탈락 문제에서 빠진 조각(합성어 부분 탈락이 채운다 — 앞뒤로 같은 조각이 있으면 remain 만으로는 어느 쪽인지 모른다) */
+    dropped?: string;
 }
 /**
  * @public 2음절 단어 → [문제단어, 남는 1음절(정답), 대립쌍 오답 2]. 정답·오답 모두 '실단어'(wordSet)만 인정.

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

@@ -210,7 +210,10 @@ export function primarySelPart(comp) {
 /** @public 음절(분해값 s)이 comp의 선택 파트들과 모두 일치하는지(=선택 음소를 가진 음절). */
 export function syllMatchesComp(s, comp) {
     const ok = (arr, val) => !hasSel(arr) || asArr(arr).includes(val);
-    return ok(comp.cho, CHOSEONG[s.cho]) && ok(comp.jung, JUNGSEONG[s.jung]) && ok(comp.jong, JONGSEONG[s.jong]);
+    /* '받침 없음'(jongNone)도 본다 — 풀 필터(wordTrainingPool)는 jongNone 이면 받침 없는 음절만 맞다고 보는데 여기만 무시해, 초성 ㅎ +
+       받침 없음으로 골라도 음절 바꾸기가 '해협' 의 '협' 을 바꿀 음절로 골랐다. jongNone 이면 jong 선택은 보지 않는다(풀과 같게). */
+    const jongOk = comp.jongNone ? s.jong === 0 : ok(comp.jong, JONGSEONG[s.jong]);
+    return ok(comp.cho, CHOSEONG[s.cho]) && ok(comp.jung, JUNGSEONG[s.jung]) && jongOk;
 }
 /**
  * @public 발음 모드에서 comp 매칭에 쓸 음절 배열. 표준발음(pronMap)의 음절수가 철자와 같으면 발음 음절로,
@@ -407,7 +410,7 @@ export function buildDropCompoundProblem(word, comp, pronMap, phonemeView, wordS
                     break;
             }
             if (wrongs.length >= 2)
-                return { question: word, distractors: [remain, ...wrongs] };
+                return { question: word, distractors: [remain, ...wrongs], dropped };
         }
     }
     return null;

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

@@ -25,6 +25,7 @@ export declare function pickOne<T>(arr: T[]): T | undefined;
 /** 부분 Fisher-Yates: n개만 선택 — arr.length 전체를 교환하지 않고 n번만 교환(대용량 풀 성능용, 공용 sample과 별개). */
 export declare function sample<T>(arr: T[], n: number): T[];
 export declare function getPronMap(): Map<string, string>;
+export declare function pronOfWord(word: string): string;
 /**
  * 후보군에서 n개를 뽑되, 이미 선택된 것들(또는 usedPron으로 미리 배제한 것들)과
  * 발음이 겹치지 않도록 그리디하게 샘플링한다.

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

@@ -103,7 +103,7 @@ export function getPronMap() {
     _cachedPronMapPool = pool;
     return m;
 }
-function pronOfWord(word) {
+export function pronOfWord(word) {
     return getPronMap().get(word) || word;
 }
 /**
@@ -433,7 +433,8 @@ async function _buildUsablePool(opts) {
                 usable = bucket.filter(other => {
                     if (other === w.w || pronOfWord(other) === wPron)
                         return false;
-                    const d = countPhonemeDiff(w.w, other);
+                    // 대립 비교는 두 모드 모두 **발음** — 철자로 세면 '팥빵[팓빵]/팥밥[팓빱]' 이 2개, '틀다/끊다[끈타]' 가 2개로 셌다
+                    const d = countPhonemeDiff(wPron, pronOfWord(other));
                     return contrastCount >= 5 ? d >= 5 : d === contrastCount;
                 });
             }
@@ -442,11 +443,24 @@ async function _buildUsablePool(opts) {
             // 'random' 또는 null(difficulty:false 타입): 음운론적 제약은 없지만,
             // 정답과 오답의 음절수는 같아야 한다(단어 길이만으로 정답을 짐작하지 못하도록) — 본 단어와 다른 단어 + 음절수(글자수) 동일
             const 쓸수있음 = (other) => other !== w.w && other.length === w.w.length && pronOfWord(other) !== wPron;
-            /* 셈(fullCount — 가능 단어 수 안내)은 '오답이 하나라도 있나' 만 본다. 2.2만 후보마다 600개를 끝까지 걸러 칩 한 번에
-               300ms 넘게 멈췄다. 셈은 결과 개수만 쓰고(countUsableWords → pool.length) 오답 목록은 쓰지 않는다. */
+            /* 셈(fullCount — 가능 단어 수 안내)은 **서로 소리가 다른 오답이 보기 수 − 1 개** 있는지까지만 본다(countUsableWords 가 그
+               기준으로 센다). 2.2만 후보마다 600개를 끝까지 걸러 칩 한 번에 300ms 넘게 멈췄다. */
             if (opts.fullCount) {
-                const one = distractorPool.find(쓸수있음);
-                usable = one === undefined ? [] : [one];
+                const need = Math.max(1, (opts.choicesPerItem ?? 3) - 1);
+                const 고름 = [];
+                const 소리 = new Set();
+                for (const other of distractorPool) {
+                    if (!쓸수있음(other))
+                        continue;
+                    const p = pronOfWord(other);
+                    if (소리.has(p))
+                        continue;
+                    소리.add(p);
+                    고름.push(other);
+                    if (고름.length >= need)
+                        break;
+                }
+                usable = 고름;
             }
             else
                 usable = distractorPool.filter(쓸수있음);