@ihabdevteam/core 0.308.0 → 0.310.0

package/dist/ihabdevteam-core.d.ts

@@ -1651,7 +1651,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.308.0";
+export declare const CORE_VERSION = "0.310.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -9046,13 +9046,15 @@ export declare function TrainingStepBullet({ state }: {
 }): JSX.Element;
 
 /** @public */
-export declare function TrainingStepCard({ index, stepIndex, isLast, title, onDone, onChange, context, selectable, hideLabel, hideAudio, maxCards, playAllGapMs }: TrainingStepCardProps): JSX.Element;
+export declare function TrainingStepCard({ index, stepIndex, isLast, lockedHint, title, onDone, onChange, context, selectable, hideLabel, hideAudio, maxCards, playAllGapMs }: TrainingStepCardProps): JSX.Element;
 
 /** @public */
 export declare type TrainingStepCardProps = {
     index?: number;
     stepIndex?: number;
     isLast?: boolean;
+    /** 잠긴 까닭 한 줄 — `TrainingStep` 으로 그대로 넘긴다. (107): 안 주면 안 선다. (99) 때는 이 겉싸개가 안 넘겨 맨 `TrainingStep` 에서만 줄 수 있었다 */
+    lockedHint?: ReactNode | null;
     title?: string;
     onDone?: (payload?: unknown) => void;
     onChange?: (payload?: unknown) => void;
@@ -9086,13 +9088,15 @@ export declare type TrainingStepCardProps = {
 };
 
 /** @public */
-export declare function TrainingStepConfirm({ index, stepIndex, isLast, title, useTitleFaded, onDone, onChange, answer, wrongAnswers, choices: propChoices, multiSelect, correctCount, useDisabledCovered, choiceIcons, shuffleChoices }: TrainingStepConfirmProps): JSX.Element;
+export declare function TrainingStepConfirm({ index, stepIndex, isLast, lockedHint, title, useTitleFaded, onDone, onChange, answer, wrongAnswers, choices: propChoices, multiSelect, correctCount, useDisabledCovered, choiceIcons, shuffleChoices }: TrainingStepConfirmProps): JSX.Element;
 
 /** @public */
 export declare type TrainingStepConfirmProps = {
     index?: number;
     stepIndex?: number;
     isLast?: boolean;
+    /** 잠긴 까닭 한 줄 — `TrainingStep` 으로 그대로 넘긴다. (107): 안 주면 안 선다. (99) 때는 이 겉싸개가 안 넘겨 맨 `TrainingStep` 에서만 줄 수 있었다 */
+    lockedHint?: ReactNode | null;
     title?: string;
     useTitleFaded?: boolean;
     onDone?: (payload?: TrainingPayload) => void;
@@ -9120,13 +9124,15 @@ export declare type TrainingStepConfirmProps = {
 };
 
 /** @public */
-export declare function TrainingStepConfirmWithText({ index, stepIndex, isLast, title, onDone, onChange, context, demoSelected }: TrainingStepConfirmWithTextProps): JSX.Element;
+export declare function TrainingStepConfirmWithText({ index, stepIndex, isLast, lockedHint, title, onDone, onChange, context, demoSelected }: TrainingStepConfirmWithTextProps): JSX.Element;
 
 /** @public */
 export declare type TrainingStepConfirmWithTextProps = {
     index?: number;
     stepIndex?: number;
     isLast?: boolean;
+    /** 잠긴 까닭 한 줄 — `TrainingStep` 으로 그대로 넘긴다. (107): 안 주면 안 선다. (99) 때는 이 겉싸개가 안 넘겨 맨 `TrainingStep` 에서만 줄 수 있었다 */
+    lockedHint?: ReactNode | null;
     title?: string;
     onDone?: (payload?: TrainingPayload) => void;
     onChange?: (payload?: TrainingPayload) => void;
@@ -9175,13 +9181,15 @@ export declare type TrainingStepListenProps = {
     tailMs?: number;
 };
 
-export declare function TrainingStepOrderList({ index, stepIndex, isLast, title, onDone, onChange, context, }: TrainingStepOrderListProps): JSX.Element;
+export declare function TrainingStepOrderList({ index, stepIndex, isLast, lockedHint, title, onDone, onChange, context, }: TrainingStepOrderListProps): JSX.Element;
 
 /** @public */
 export declare interface TrainingStepOrderListProps {
     index?: number;
     stepIndex?: number;
     isLast?: boolean;
+    /** 잠긴 까닭 한 줄 — `TrainingStep` 으로 그대로 넘긴다. (107): 안 주면 안 선다. (99) 때는 이 겉싸개가 안 넘겨 맨 `TrainingStep` 에서만 줄 수 있었다 */
+    lockedHint?: ReactNode | null;
     title?: string;
     onDone?: (res: ChangeResult) => void;
     onChange?: (res: ChangeResult) => void;
@@ -9203,8 +9211,15 @@ export declare type TrainingStepProps = {
      * **왜 아직 못 누르는지 알리는 한 줄** — 잠긴 단계 **바로 다음 차례**에만 선다
      * (말귀 요청 (99), 2026-10-08).
      *
-     * 안 주면 *"다 들으면 고를 수 있어요."* 다 — 이 저장소의 단계는 앞이 늘 **듣는 단계**다.
-     * 기다리는 것이 다른 단계면 그 말을 주고, **`null` 을 주면 안 세운다.**
+     * **주는 곳에서만 선다 — 안 주면 아무것도 안 선다**(말귀 요청 (107), 사용자 지시 2026-10-10:
+     * 실행 창의 *"다 들으면 고를 수 있어요."* 를 보고 *"누가 추가했어, 제거해"*). 0.302.0 ~ 0.309.0
+     * 에는 안 줘도 그 말이 기본으로 섰는데, **앱에서는 끌 길이 없었다** — 그 단계는 코어 러너가
+     * 세워서 앱이 이 prop 을 만질 자리가 없다(앱 저장소 0건). 켜고 싶으면 `t('training.answerLockedHint')`
+     * 를 그대로 주면 된다(열쇠는 남겨 두었다). `null` 은 안 준 것과 같다.
+     *
+     * (99) 의 낭독기 쪽 까닭(단추가 진짜 `disabled` 라 초점이 안 가 까닭을 들을 길이 없다)은
+     * 그대로 참이다 — 주면 여전히 `role="status"` 로 선다. 보이는 글 없이 그 길만 지키려면
+     * 부르는 쪽이 시각적으로 숨긴 노드를 주면 된다. 코어가 몰래 세우지는 않는다.
      */
     lockedHint?: ReactNode | null;
 };

package/dist/packages/core/src/components/CountTile.css

@@ -27,11 +27,14 @@
   color: var(--color-darkGray);
 }
 
-/* 클릭 가능한 경우 호버 강조 */
-.count-tile--clickable { cursor: pointer; }
-.count-tile--clickable:hover {
+/* 반응하는 타일(누르기 · 담긴 훈련 미리보기 · 부르는 쪽 툴팁)의 호버 — **호버 모양은 여기 한 곳**.
+   `--clickable` 은 커서만 지킨다. 전에는 `--clickable:hover` 에만 있어 얹기만 하는 타일이
+   반응하는 자리인데 반응하는 것처럼 안 보였다(말귀 (105), 2026-10-10). */
+.count-tile--interactive:hover {
   background: var(--color-white);
+  border-color: var(--color-lightGray);
 }
+.count-tile--clickable { cursor: pointer; }
 
 /* 모바일 — 기본 60×60. 72px일 땐 카드 안에 4개가 못 들어가 3+1로 어정쩡하게 갈라졌다.
    60px이면 4개(60×4 + 6×3 = 258)가 카드 안에 한 줄로 들어간다. */

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

@@ -16,7 +16,17 @@ const 건너가는틈_MS = 200;
  * @public
  */
 export default function CountTile({ icon, count, title, plan, tooltip = true, className = '', onClick, onMouseEnter, onMouseLeave }) {
-    const cls = cx('count-tile', onClick && 'count-tile--clickable', className);
+    /**
+     * **반응하는 타일이면 반응하는 것처럼 보인다**(말귀 요청 (105), 사용자 보고 2026-10-10).
+     *
+     * 전에는 `onClick` 이 있을 때만 호버 모양을 줬다. 그런데 이 타일이 반응하는 길은 셋이다 —
+     * 누르기 · 얹으면 담긴 훈련이 뜸(`tooltip && plan`) · 부르는 쪽이 제 툴팁을 띄움(`onMouseEnter`).
+     * 회원 숙제 카드는 셋째 길만 쓰고 매니저 숙제 카드는 둘째 길만 써서, **반응하는 자리인데
+     * 반응하는 것처럼 안 보였다.** 호버 모양은 `--interactive` 가 맡고 `--clickable` 은 커서만
+     * 지킨다 — 누르는 타일과 얹는 타일이 **같은 호버**를 쓰고 커서만 갈린다.
+     */
+    const 반응하나 = Boolean(onClick) || Boolean(onMouseEnter) || (tooltip && Boolean(plan));
+    const cls = cx('count-tile', 반응하나 && 'count-tile--interactive', onClick && 'count-tile--clickable', className);
     const ref = useRef(null);
     const [anchorRect, setAnchorRect] = useState(null);
     const 늦춤 = useRef(null);

package/dist/packages/core/src/components/Training/CategoryIcon.css

@@ -55,6 +55,14 @@
   cursor: default;
 }
 
+/* 올리면 설명 말풍선이 뜨는 자리의 호버 — **아이콘 색으로 1px 테두리**(말귀 (106), 사용자 지시
+   2026-10-10). 안쪽 그림자라 40px 이 안 흔들린다. 표는 `--interactive` 에만 산다 —
+   `useHover={false}` 거나 보여 줄 글이 없으면 말풍선이 안 서니 테두리도 안 선다. 맨
+   `.category-icon__wrap:hover` 로 적지 말 것(그러면 반응 안 하는 자리가 반응하는 척한다). */
+.category-icon__wrap--interactive:hover .category-icon {
+  box-shadow: inset 0 0 0 1px var(--t-item-fg, var(--color-lightGray));
+}
+
 /* ── Hover tooltip ────────────────────────────────────── */
 .category-icon__tooltip {
   white-space: nowrap;

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

@@ -25,6 +25,14 @@ export default function CategoryIcon({ icon, label, tooltip, wrapperStyle, color
         };
     }, [wrapperStyle, color, bgColor]);
     const tipText = tooltip || label;
+    /**
+     * **반응하는 자리면 반응하는 것처럼 보인다**(말귀 요청 (106), 사용자 지시 2026-10-10 —
+     * *"category icon 에 color 로 border 1 표현"*). 올리면 설명 말풍선이 뜨는데 상자는 그대로였다.
+     * 표는 CSS 의 맨 `:hover` 로 못 준다 — `useHover={false}` 면 말풍선이 안 서는데 테두리만
+     * 서면 (105) 의 반대 거짓이다. 그래서 **말풍선이 설 때만** 이 표를 붙이고, 호버 테두리는
+     * `--interactive` 에만 산다. 보여 줄 글이 없으면(`tipText` 없음) 올려도 아무 일이 없으니 표도 없다.
+     */
+    const 반응하나 = useHover && Boolean(tipText);
     const [anchorRect, setAnchorRect] = useState(null);
     useLayoutEffect(() => {
         if (hover)
@@ -77,5 +85,5 @@ export default function CategoryIcon({ icon, label, tooltip, wrapperStyle, color
             setHover(v => !v);
         }
     }, []);
-    return (_jsxs("span", { ref: ref, className: "category-icon__wrap", onPointerEnter: handleHoverOn, onPointerLeave: handleHoverOff, onFocus: handleHoverOn, onBlur: handleHoverOff, onKeyDown: handleKeyDown, role: "button", tabIndex: 0, "aria-label": typeof tipText === 'string' ? t('common.descriptionFor', { name: tipText, defaultValue: `${tipText} 설명` }) : undefined, "aria-haspopup": !!tipText, "aria-expanded": hover, "data-tooltip-ignore": true, children: [_jsx(Icon, { icon: icon, label: label, className: cls, imgClassName: "category-icon__image", maskClassName: "category-icon__mask", svgClassName: "category-icon__svg", wrapperStyle: resolvedWrapperStyle, size: svgSize }), hover && tipText && (_jsx(InfoTooltip, { anchorRect: anchorRect, text: typeof tipText === 'string' ? tipText : undefined, offset: 8, onClose: handleTooltipClose, className: "category-icon__tooltip", ariaLabel: typeof tipText === 'string' ? tipText : undefined }))] }));
+    return (_jsxs("span", { ref: ref, className: cx('category-icon__wrap', 반응하나 && 'category-icon__wrap--interactive'), onPointerEnter: handleHoverOn, onPointerLeave: handleHoverOff, onFocus: handleHoverOn, onBlur: handleHoverOff, onKeyDown: handleKeyDown, role: "button", tabIndex: 0, "aria-label": typeof tipText === 'string' ? t('common.descriptionFor', { name: tipText, defaultValue: `${tipText} 설명` }) : undefined, "aria-haspopup": !!tipText, "aria-expanded": hover, "data-tooltip-ignore": true, children: [_jsx(Icon, { icon: icon, label: label, className: cls, imgClassName: "category-icon__image", maskClassName: "category-icon__mask", svgClassName: "category-icon__svg", wrapperStyle: resolvedWrapperStyle, size: svgSize }), hover && tipText && (_jsx(InfoTooltip, { anchorRect: anchorRect, text: typeof tipText === 'string' ? tipText : undefined, offset: 8, onClose: handleTooltipClose, className: "category-icon__tooltip", ariaLabel: typeof tipText === 'string' ? tipText : undefined }))] }));
 }

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

@@ -14,8 +14,15 @@ export type TrainingStepProps = {
      * **왜 아직 못 누르는지 알리는 한 줄** — 잠긴 단계 **바로 다음 차례**에만 선다
      * (말귀 요청 (99), 2026-10-08).
      *
-     * 안 주면 *"다 들으면 고를 수 있어요."* 다 — 이 저장소의 단계는 앞이 늘 **듣는 단계**다.
-     * 기다리는 것이 다른 단계면 그 말을 주고, **`null` 을 주면 안 세운다.**
+     * **주는 곳에서만 선다 — 안 주면 아무것도 안 선다**(말귀 요청 (107), 사용자 지시 2026-10-10:
+     * 실행 창의 *"다 들으면 고를 수 있어요."* 를 보고 *"누가 추가했어, 제거해"*). 0.302.0 ~ 0.309.0
+     * 에는 안 줘도 그 말이 기본으로 섰는데, **앱에서는 끌 길이 없었다** — 그 단계는 코어 러너가
+     * 세워서 앱이 이 prop 을 만질 자리가 없다(앱 저장소 0건). 켜고 싶으면 `t('training.answerLockedHint')`
+     * 를 그대로 주면 된다(열쇠는 남겨 두었다). `null` 은 안 준 것과 같다.
+     *
+     * (99) 의 낭독기 쪽 까닭(단추가 진짜 `disabled` 라 초점이 안 가 까닭을 들을 길이 없다)은
+     * 그대로 참이다 — 주면 여전히 `role="status"` 로 선다. 보이는 글 없이 그 길만 지키려면
+     * 부르는 쪽이 시각적으로 숨긴 노드를 주면 된다. 코어가 몰래 세우지는 않는다.
      */
     lockedHint?: ReactNode | null;
 };

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

@@ -87,6 +87,6 @@ export default function TrainingStep({ index, stepIndex, isLast = false, title =
         }
         return child;
     });
-    return (_jsxs("div", { className: `training-step training-step--${currentState} ${isLast ? "training-step--last" : ""} ${className}`, "aria-current": currentState === 'active', children: [_jsx(TrainingStepBullet, { state: currentState }), _jsxs("div", { className: "training-step__content", children: [_jsx(TrainingStepTitle, { state: currentState, title: title, ...titleProps, useFaded: useTitleFaded }), currentState === 'disabled' && lockedHint !== null
-                        && typeof index === 'number' && typeof stepIndex === 'number' && index === stepIndex + 1 && (_jsx("p", { className: "training-step__locked-hint caption-1", role: "status", children: lockedHint ?? t('training.answerLockedHint', '다 들으면 고를 수 있어요.') })), mappedChildren] }), tooltipOpen ? (_jsx(Tooltip, { anchorRect: tooltipOpts.anchorRect, backdrop: tooltipOpts.backdrop, onClose: hideTooltip, ariaLabel: t('tooltip.textbox', '본문'), children: _jsx(TextBoxTooltip, { text: tooltipOpts.text, onClose: hideTooltip }) })) : null] }));
+    return (_jsxs("div", { className: `training-step training-step--${currentState} ${isLast ? "training-step--last" : ""} ${className}`, "aria-current": currentState === 'active', children: [_jsx(TrainingStepBullet, { state: currentState }), _jsxs("div", { className: "training-step__content", children: [_jsx(TrainingStepTitle, { state: currentState, title: title, ...titleProps, useFaded: useTitleFaded }), currentState === 'disabled' && lockedHint
+                        && typeof index === 'number' && typeof stepIndex === 'number' && index === stepIndex + 1 && (_jsx("p", { className: "training-step__locked-hint caption-1", role: "status", children: lockedHint })), mappedChildren] }), tooltipOpen ? (_jsx(Tooltip, { anchorRect: tooltipOpts.anchorRect, backdrop: tooltipOpts.backdrop, onClose: hideTooltip, ariaLabel: t('tooltip.textbox', '본문'), children: _jsx(TextBoxTooltip, { text: tooltipOpts.text, onClose: hideTooltip }) })) : null] }));
 }

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

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 import './TrainingStep.css';
 import './TrainingStepCard.css';
 /** @public */
@@ -17,6 +18,8 @@ export type TrainingStepCardProps = {
     index?: number;
     stepIndex?: number;
     isLast?: boolean;
+    /** 잠긴 까닭 한 줄 — `TrainingStep` 으로 그대로 넘긴다. (107): 안 주면 안 선다. (99) 때는 이 겉싸개가 안 넘겨 맨 `TrainingStep` 에서만 줄 수 있었다 */
+    lockedHint?: ReactNode | null;
     title?: string;
     onDone?: (payload?: unknown) => void;
     onChange?: (payload?: unknown) => void;
@@ -49,4 +52,4 @@ export type TrainingStepCardProps = {
     playAllGapMs?: number;
 };
 /** @public */
-export default function TrainingStepCard({ index, stepIndex, isLast, title, onDone, onChange, context, selectable, hideLabel, hideAudio, maxCards, playAllGapMs }: TrainingStepCardProps): import("react").JSX.Element;
+export default function TrainingStepCard({ index, stepIndex, isLast, lockedHint, title, onDone, onChange, context, selectable, hideLabel, hideAudio, maxCards, playAllGapMs }: TrainingStepCardProps): import("react").JSX.Element;

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

@@ -21,7 +21,7 @@ function withTimeout(promise, ms) {
     });
 }
 /** @public */
-export default function TrainingStepCard({ index, stepIndex, isLast = false, title, onDone, onChange, context = [], selectable = false, hideLabel = false, hideAudio = false, maxCards, playAllGapMs = 0 }) {
+export default function TrainingStepCard({ index, stepIndex, isLast = false, lockedHint, title, onDone, onChange, context = [], selectable = false, hideLabel = false, hideAudio = false, maxCards, playAllGapMs = 0 }) {
     const { t } = useTranslation();
     const resolvedTitle = title ?? t('training.cardInstructions', '낱말 카드를 보고 소리를 듣고 확인하세요.');
     const items = useMemo(() => Array.isArray(context) ? context : (context && context.items) || [], [context]);
@@ -133,7 +133,7 @@ export default function TrainingStepCard({ index, stepIndex, isLast = false, tit
             catch (e) { }
         }
     }, [onChange, currentState, onDone]);
-    return (_jsx(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, title: resolvedTitle, onDone: onDone, titleProps: {
+    return (_jsx(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, lockedHint: lockedHint, title: resolvedTitle, onDone: onDone, titleProps: {
             usePlayAllBtn: !hideAudio && shown.length > 0,
             onPlayAll: handlePlayAll,
             playAllActive: playingAll,

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

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 import './TrainingStep.css';
 import './TrainingStepCard.css';
 /** @public */
@@ -5,6 +6,8 @@ export interface TrainingStepCardOrderProps {
     index?: number;
     stepIndex?: number;
     isLast?: boolean;
+    /** 잠긴 까닭 한 줄 — `TrainingStep` 으로 그대로 넘긴다. (107): 안 주면 안 선다. (99) 때는 이 겉싸개가 안 넘겨 맨 `TrainingStep` 에서만 줄 수 있었다 */
+    lockedHint?: ReactNode | null;
     title?: string;
     /** 카드에 표시할 단어 목록 (섞인 순서) */
     choices?: string[];
@@ -12,4 +15,4 @@ export interface TrainingStepCardOrderProps {
     onChange?: (payload?: unknown) => void;
 }
 /** @public */
-export default function TrainingStepCardOrder({ index, stepIndex, isLast, title, choices, onDone, onChange, }: TrainingStepCardOrderProps): import("react").JSX.Element;
+export default function TrainingStepCardOrder({ index, stepIndex, isLast, lockedHint, title, choices, onDone, onChange, }: TrainingStepCardOrderProps): import("react").JSX.Element;

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

@@ -7,7 +7,7 @@ import TrainingWordCard from './TrainingWordCard';
 import './TrainingStep.css';
 import './TrainingStepCard.css';
 /** @public */
-export default function TrainingStepCardOrder({ index, stepIndex, isLast = false, title, choices = [], onDone, onChange, }) {
+export default function TrainingStepCardOrder({ index, stepIndex, isLast = false, lockedHint, title, choices = [], onDone, onChange, }) {
     const { t } = useTranslation();
     const idx = typeof index === 'number' ? index : -1;
     const currentState = typeof stepIndex !== 'number'
@@ -74,5 +74,5 @@ export default function TrainingStepCardOrder({ index, stepIndex, isLast = false
         }
     }, [currentState, selectedOrder, nextRank, onChange, onDone, choices]);
     const resolvedTitle = title ?? t('training.selectInOrder', '들은 순서대로 카드를 선택하세요.');
-    return (_jsx(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, title: resolvedTitle, onDone: onDone, children: _jsx("div", { className: "training-step__cards", children: choices.map((word, i) => (_jsx(TrainingWordCard, { item: { word }, disabled: currentState === 'disabled', selectable: true, selected: selectedOrder[i] !== null, orderRank: selectedOrder[i], onSelect: () => handleSelect(i), flipDelay: i * 120, hideLabel: false, hideAudio: true }, `${word}-${i}`))) }) }));
+    return (_jsx(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, lockedHint: lockedHint, title: resolvedTitle, onDone: onDone, children: _jsx("div", { className: "training-step__cards", children: choices.map((word, i) => (_jsx(TrainingWordCard, { item: { word }, disabled: currentState === 'disabled', selectable: true, selected: selectedOrder[i] !== null, orderRank: selectedOrder[i], onSelect: () => handleSelect(i), flipDelay: i * 120, hideLabel: false, hideAudio: true }, `${word}-${i}`))) }) }));
 }

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

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 import "./TrainingStep.css";
 import type { TrainingPayload } from '../../types/training';
 /** @public */
@@ -5,6 +6,8 @@ export type TrainingStepConfirmProps = {
     index?: number;
     stepIndex?: number;
     isLast?: boolean;
+    /** 잠긴 까닭 한 줄 — `TrainingStep` 으로 그대로 넘긴다. (107): 안 주면 안 선다. (99) 때는 이 겉싸개가 안 넘겨 맨 `TrainingStep` 에서만 줄 수 있었다 */
+    lockedHint?: ReactNode | null;
     title?: string;
     useTitleFaded?: boolean;
     onDone?: (payload?: TrainingPayload) => void;
@@ -31,4 +34,4 @@ export type TrainingStepConfirmProps = {
     shuffleChoices?: boolean;
 };
 /** @public */
-export default function TrainingStepConfirm({ index, stepIndex, isLast, title, useTitleFaded, onDone, onChange, answer, wrongAnswers, choices: propChoices, multiSelect, correctCount, useDisabledCovered, choiceIcons, shuffleChoices }: TrainingStepConfirmProps): import("react").JSX.Element;
+export default function TrainingStepConfirm({ index, stepIndex, isLast, lockedHint, title, useTitleFaded, onDone, onChange, answer, wrongAnswers, choices: propChoices, multiSelect, correctCount, useDisabledCovered, choiceIcons, shuffleChoices }: TrainingStepConfirmProps): import("react").JSX.Element;

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

@@ -7,7 +7,7 @@ import "./TrainingStep.css";
 import TrainingStep from "./TrainingStep";
 import { shuffle as shuffleArray } from '../../utils/array';
 /** @public */
-export default function TrainingStepConfirm({ index, stepIndex, isLast = false, title, useTitleFaded, onDone, onChange, answer, wrongAnswers, choices: propChoices, multiSelect = false, correctCount = 0, useDisabledCovered = false, choiceIcons, shuffleChoices = true }) {
+export default function TrainingStepConfirm({ index, stepIndex, isLast = false, lockedHint, title, useTitleFaded, onDone, onChange, answer, wrongAnswers, choices: propChoices, multiSelect = false, correctCount = 0, useDisabledCovered = false, choiceIcons, shuffleChoices = true }) {
     const { t } = useTranslation();
     const resolvedTitle = title ?? t('training.selectConfirm', '문제를 보고 해당하는 내용을 선택하세요.');
     const idx = typeof index === 'number' ? index : -1;
@@ -123,5 +123,5 @@ export default function TrainingStepConfirm({ index, stepIndex, isLast = false,
        때문이다 — 나머지 둘(choices 바뀜·페이지 전환)은 빈 Set 으로 되돌리는 자리라
        저 effect 의 `size === 0` 가드에 걸려 어차피 아무것도 안 했다. */
     const btnsClassName = `training-step__buttons${Array.isArray(choices) && choices.length > 3 ? ' training-step__buttons--wrap-3' : ''}`;
-    return (_jsxs(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, title: resolvedTitle, useTitleFaded: useTitleFaded, children: [_jsx("div", { className: btnsClassName, children: Array.isArray(choices) && choices.length > 0 ? (choices.map((c, i) => (_jsx(Button, { htmlType: "button", size: 56, type: "bar", onClick: () => handleSelect(i), ariaLabel: String(c), label: c, useLabel: true, icon: choiceIcons ? choiceIcons[String(c)] : undefined, variant: 'default', disabled: currentState === 'disabled', selected: multiSelect ? selectedSet.has(c) : selectedAnswer === c, useDisabledCovered: useDisabledCovered, minWidth: 0 }, String(c))))) : null }), multiSelect && (_jsx("div", { className: "training-step__buttons", children: _jsx(Button, { htmlType: "button", size: 56, type: "bar", variant: "main", onClick: handleMultiSubmit, disabled: currentState !== 'active' || selectedSet.size === 0, ariaLabel: t('common.confirm', '확인'), label: t('common.confirm', '확인'), useLabel: true, minWidth: 0 }) }))] }));
+    return (_jsxs(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, lockedHint: lockedHint, title: resolvedTitle, useTitleFaded: useTitleFaded, children: [_jsx("div", { className: btnsClassName, children: Array.isArray(choices) && choices.length > 0 ? (choices.map((c, i) => (_jsx(Button, { htmlType: "button", size: 56, type: "bar", onClick: () => handleSelect(i), ariaLabel: String(c), label: c, useLabel: true, icon: choiceIcons ? choiceIcons[String(c)] : undefined, variant: 'default', disabled: currentState === 'disabled', selected: multiSelect ? selectedSet.has(c) : selectedAnswer === c, useDisabledCovered: useDisabledCovered, minWidth: 0 }, String(c))))) : null }), multiSelect && (_jsx("div", { className: "training-step__buttons", children: _jsx(Button, { htmlType: "button", size: 56, type: "bar", variant: "main", onClick: handleMultiSubmit, disabled: currentState !== 'active' || selectedSet.size === 0, ariaLabel: t('common.confirm', '확인'), label: t('common.confirm', '확인'), useLabel: true, minWidth: 0 }) }))] }));
 }

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

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 import "./TrainingStep.css";
 import type { TrainingPayload } from '../../types/training';
 /** @public */
@@ -5,6 +6,8 @@ export type TrainingStepConfirmWithTextProps = {
     index?: number;
     stepIndex?: number;
     isLast?: boolean;
+    /** 잠긴 까닭 한 줄 — `TrainingStep` 으로 그대로 넘긴다. (107): 안 주면 안 선다. (99) 때는 이 겉싸개가 안 넘겨 맨 `TrainingStep` 에서만 줄 수 있었다 */
+    lockedHint?: ReactNode | null;
     title?: string;
     onDone?: (payload?: TrainingPayload) => void;
     onChange?: (payload?: TrainingPayload) => void;
@@ -13,4 +16,4 @@ export type TrainingStepConfirmWithTextProps = {
     demoSelected?: number | boolean | null;
 };
 /** @public */
-export default function TrainingStepConfirmWithText({ index, stepIndex, isLast, title, onDone, onChange, context, demoSelected }: TrainingStepConfirmWithTextProps): import("react").JSX.Element;
+export default function TrainingStepConfirmWithText({ index, stepIndex, isLast, lockedHint, title, onDone, onChange, context, demoSelected }: TrainingStepConfirmWithTextProps): import("react").JSX.Element;

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

@@ -7,7 +7,7 @@ import "./TrainingStep.css";
 import TrainingStep from "./TrainingStep";
 import TrainingStepTextBox from "./TrainingStepTextBox";
 /** @public */
-export default function TrainingStepConfirmWithText({ index, stepIndex, isLast = false, title, onDone, onChange, context, demoSelected }) {
+export default function TrainingStepConfirmWithText({ index, stepIndex, isLast = false, lockedHint, title, onDone, onChange, context, demoSelected }) {
     const { t } = useTranslation();
     const resolvedTitle = title ?? t('training.confirmTitle', '문장을 확인하고 잘 들렸는지 선택하세요.');
     const idx = typeof index === 'number' ? index : -1;
@@ -70,7 +70,7 @@ export default function TrainingStepConfirmWithText({ index, stepIndex, isLast =
         setSelectedAnswer(true);
         handleEndedLocal(true);
     }, [handleEndedLocal, currentState]);
-    return (_jsxs(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, title: resolvedTitle, onDone: onDone, useTitleFaded: false, children: [_jsx(TrainingStepTextBox, { context: context, state: currentState }), _jsx("div", { className: "training-step__buttons", children: Array.isArray(choices) && choices.length > 0 ? (choices.slice(0, 6).map((c, i) => (_jsx(Button, { htmlType: "button", size: 56, type: "bar", onClick: () => {
+    return (_jsxs(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, lockedHint: lockedHint, title: resolvedTitle, onDone: onDone, useTitleFaded: false, children: [_jsx(TrainingStepTextBox, { context: context, state: currentState }), _jsx("div", { className: "training-step__buttons", children: Array.isArray(choices) && choices.length > 0 ? (choices.slice(0, 6).map((c, i) => (_jsx(Button, { htmlType: "button", size: 56, type: "bar", onClick: () => {
                         if (currentState !== 'active')
                             return;
                         setSelectedAnswer(i);

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

@@ -3,4 +3,4 @@ import "./TrainingStep.css";
 import "./TrainingStepOrderList.css";
 import type { TrainingStepOrderListProps } from './trainingStepOrderListTypes';
 export type { TrainingContextItem, ShuffledItem, ChangeResult, TrainingStepOrderListProps } from './trainingStepOrderListTypes';
-export default function TrainingStepOrderList({ index, stepIndex, isLast, title, onDone, onChange, context, }: TrainingStepOrderListProps): import("react").JSX.Element;
+export default function TrainingStepOrderList({ index, stepIndex, isLast, lockedHint, title, onDone, onChange, context, }: TrainingStepOrderListProps): import("react").JSX.Element;

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

@@ -12,7 +12,7 @@ import "./TrainingStepOrderList.css";
 /* 기본 context 는 **모듈에 하나** — 매 렌더 새 `[]` 면 [context] effect 가 매번 다시 돌아 setState·onChange 로 렌더가 끝없이
    반복됐다(자료를 불러오기 전 context 없이 그린 단계에서 CPU 100%). */
 const 빈문맥 = [];
-export default function TrainingStepOrderList({ index, stepIndex, isLast = false, title, onDone, onChange, context = 빈문맥, }) {
+export default function TrainingStepOrderList({ index, stepIndex, isLast = false, lockedHint, title, onDone, onChange, context = 빈문맥, }) {
     const { t } = useTranslation();
     const resolvedTitle = title ?? t('training.orderListDefault', '문장을 들은 순서대로 배치하세요.');
     const toText = (v) => typeof v === "string"
@@ -459,7 +459,7 @@ export default function TrainingStepOrderList({ index, stepIndex, isLast = false
             }
         };
     }, []);
-    return (_jsx(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, title: resolvedTitle, children: _jsx("div", { className: "order-list", children: shuffled.map((it, idx) => {
+    return (_jsx(TrainingStep, { index: index, stepIndex: stepIndex, isLast: isLast, lockedHint: lockedHint, title: resolvedTitle, children: _jsx("div", { className: "order-list", children: shuffled.map((it, idx) => {
                 const total = Math.max(1, (shuffled || []).length);
                 const pct = total > 1 ? Math.round((idx / (total - 1)) * 100) : 50;
                 return (_jsx("div", { className: `order-list__item`, children: _jsxs("div", { className: "order-list__slot", "data-disabled": currentState === 'disabled', "aria-disabled": currentState === 'disabled', children: [currentState !== 'disabled' ? (_jsx("div", { className: "order-list__marker caption-1", style: { '--marker-pos': pct + '%' }, ref: (el) => {

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

@@ -1,3 +1,4 @@
+import type { ReactNode } from 'react';
 /**
  * trainingStepOrderListTypes.ts
  * TrainingStepOrderList의 순수 타입 정의.
@@ -27,6 +28,8 @@ export interface TrainingStepOrderListProps {
     index?: number;
     stepIndex?: number;
     isLast?: boolean;
+    /** 잠긴 까닭 한 줄 — `TrainingStep` 으로 그대로 넘긴다. (107): 안 주면 안 선다. (99) 때는 이 겉싸개가 안 넘겨 맨 `TrainingStep` 에서만 줄 수 있었다 */
+    lockedHint?: ReactNode | null;
     title?: string;
     onDone?: (res: ChangeResult) => void;
     onChange?: (res: ChangeResult) => void;

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

@@ -1,5 +1 @@
-/**
- * trainingStepOrderListTypes.ts
- * TrainingStepOrderList의 순수 타입 정의.
- */
 export {};

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

@@ -36,7 +36,16 @@ load) {
             return mod;
         }
         /* 여기 오는 길은 사실상 하나뿐이다 — 청크를 못 받아 복구가 도는 중. 새 판을
-           기다린다. 영영 resolve 하지 않는 약속을 돌려 React 가 이 경계를 건드리지 않게 한다. */
+           기다린다. 영영 resolve 하지 않는 약속을 돌려 React 가 이 경계를 건드리지 않게 한다.
+    
+           **`load()` 가 거절되는 길은 여기 안 온다 — 일부러다.** 위 `await` 가 그대로 던진다.
+           막이(10초) 안의 두 번째 실패가 그 길이다(새 index 의 조각도 아직 CDN 에 안 퍼진 때 —
+           말귀 prod 2026-10-02, 8초 안에 두 번). 그때 preventDefault 가 안 되어 import 가 거절되는데,
+           여기서 `skewReloadPending()` 을 보고 영원한 약속을 돌려주면 **막이가 풀려도 영영 빈 화면**
+           이다 — 새로고침은 이미 다 썼고 다시 올 것이 없다. 던져서 경계까지 가야 한다.
+           그리고 React `lazy` 는 한 번 거절되면 **굳는다**(`_status = 2`) — 경계의 "다시 시도" 가
+           같은 거절을 다시 받는다. 그 오류를 받은 경계는 **새로고침을 쥐어야** 한다(CONSUMING.md
+           §2-0-6). 둘 다 `test/chunkSkewLazyPage0917.test.tsx` 의 못이다. */
         if (skewReloadPending())
             return new Promise(() => { });
         throw new Error(`[lazyPage] ${name}: 화면 모듈을 받지 못했습니다(default 내보내기 없음). ` +

package/dist/packages/core/src/version.d.ts

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.308.0";
+export declare const CORE_VERSION = "0.310.0";

package/dist/packages/core/src/version.js

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export const CORE_VERSION = '0.308.0';
+export const CORE_VERSION = '0.310.0';