@ihabdevteam/core 0.300.0 → 0.302.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.300.0";
+export declare const CORE_VERSION = "0.302.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -8264,6 +8264,21 @@ export declare interface TrainingBlockButtonPopupProps {
         correct: number | null;
         total: number | null;
     }) => void;
+    /**
+     * **판이 끝난 그 순간** 호출 — 닫기와 무관하다(`TrainingPagePopup` 으로 그대로 전달).
+     *
+     * `onComplete` 는 **닫을 때** 불린다. 숙제처럼 *"이 문항 풀었다"* 를 세는 쪽은 닫기를
+     * 기다릴 수 없다 — 다 풀고 안 닫고 떠나면 통째로 날아갔다(말귀 요청 (100), 0.300.0).
+     *
+     * **값은 `...rest` 로 흘러 이미 갔는데 타입만 빠져 있었다**(0.300.0). 쓰는 쪽은 통과시킬
+     * 길이 없어 `as` 로 덮어야 했다 — (74) 가 앱까지 안 닿았던 것과 **같은 꼴**이다:
+     * 가운데 한 겹이 안 따라갔다.
+     */
+    onRoundFinished?: (result: {
+        correct: number | null;
+        total: number | null;
+        attempt?: number;
+    }) => void;
     popupTitle: string;
     popupSubTitle?: string;
     depth?: string;
@@ -8937,7 +8952,7 @@ export declare type TrainingScenario = {
 };
 
 /** @public */
-declare function TrainingStep_2({ index, stepIndex, isLast, title, titleProps, children, className, onDone, useTitleFaded }: TrainingStepProps): JSX.Element;
+declare function TrainingStep_2({ index, stepIndex, isLast, title, titleProps, children, className, onDone, useTitleFaded, lockedHint }: TrainingStepProps): JSX.Element;
 export { TrainingStep_2 as TrainingStep }
 
 /** @public */
@@ -9148,6 +9163,14 @@ export declare type TrainingStepProps = {
     className?: string;
     onDone?: (payload?: unknown) => void;
     useTitleFaded?: boolean;
+    /**
+     * **왜 아직 못 누르는지 알리는 한 줄** — 잠긴 단계 **바로 다음 차례**에만 선다
+     * (말귀 요청 (99), 2026-10-08).
+     *
+     * 안 주면 *"다 들으면 고를 수 있어요."* 다 — 이 저장소의 단계는 앞이 늘 **듣는 단계**다.
+     * 기다리는 것이 다른 단계면 그 말을 주고, **`null` 을 주면 안 세운다.**
+     */
+    lockedHint?: ReactNode | null;
 };
 
 /** @public */

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

@@ -30,7 +30,7 @@ function Item({ title, body, open = false, onToggle, avatar, titleClassName = 'b
                             /* **접기 손잡이의 말은 저장소 전체가 하나다**(사용자 지시 "전체 통일해", 2026-10-07).
                                열쇠는 `accordion.*` 로 따로 남는다(소비자가 아코디언만 달리 부르고 싶을 수 있다) —
                                대신 **값이 갈라지지 않는지**를 못이 센다(`filterPanelCollapseAffordance`). */
-                            label: open ? t('accordion.collapse', '접기') : t('accordion.expand', '열기'), className: "accordion-item__chevron-icon", imgClassName: "accordion-item__chevron-image" }) })] }), open && (_jsx("div", { className: `accordion-item__body ${bodyClassName}`, children: typeof body === 'string' ? _jsx("p", { children: body }) : body }))] }));
+                            label: open ? t('accordion.collapse', '접기') : t('accordion.expand', '펼치기'), className: "accordion-item__chevron-icon", imgClassName: "accordion-item__chevron-image" }) })] }), open && (_jsx("div", { className: `accordion-item__body ${bodyClassName}`, children: typeof body === 'string' ? _jsx("p", { children: body }) : body }))] }));
 }
 // ── Accordion ─────────────────────────────────────────────────────────────
 /** @public */

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

@@ -73,12 +73,12 @@ export default function FilterPanel({ title, titleLevel = 2, headerAction, heade
                                    그리고 `common.close`(대화상자 닫기)와 **섞지 않는다** — 섞으면 접기 손잡이와
                                    닫기 단추가 한 결정에 묶여, 한쪽을 고칠 때 다른 쪽이 따라 움직인다.
                 
-                                   > **지금 짝이 안 맞는다 — `열기`/`접기`**(말귀 (97), 사용자 지시 2026-10-08).
-                                   > `열기`(2026-10-07)와 `접기`(2026-10-08)를 사장님이 **각각 따로** 고르셨다.
-                                   > `열기/닫기` 도 `펼치기/접기` 도 짝인데 이 둘은 섞인 꼴이다. 한쪽을 제
-                                   > 짐작으로 맞추지 않는다 — **둘 다 사장님이 고른 말**이라, 맞추는 것도
-                                   > 사장님 몫이다. 여쭤 뒀고 답이 오면 한 줄로 끝난다. */
-                                ariaLabel: collapsed ? t('common.expand', '열기') : t('common.collapse', '접기'), showTooltipInfo: collapsed ? t('common.expand', '열기') : t('common.collapse', '접기'), "aria-expanded": !collapsed, onClick: toggleCollapsed }))] })] })), !collapsed && (_jsxs(_Fragment, { children: [_jsx("div", { className: cx('filter-panel__sections', isRow ? 'filter-panel__sections--row' : ''), children: sections.map(section => {
+                                   > **짝은 `펼치기`/`접기` 다**(사용자 결정 2026-10-08). 하루 사이에 말이
+                                   > 두 번 움직였다 — `펼치기/접기`(처음) → `열기/닫기`(10-07) → `열기/접기`
+                                   > (10-08, `닫기` 만 고침) → **`펼치기/접기`**(10-08, 짝을 맞춤).
+                                   > 섞인 하루를 **제 짐작으로 안 맞춘 것**이 맞았다: 두 말 다 사장님이
+                                   > 고르신 것이라, 어느 쪽으로 모을지도 사장님이 정하실 일이었다. */
+                                ariaLabel: collapsed ? t('common.expand', '펼치기') : t('common.collapse', '접기'), showTooltipInfo: collapsed ? t('common.expand', '펼치기') : t('common.collapse', '접기'), "aria-expanded": !collapsed, onClick: toggleCollapsed }))] })] })), !collapsed && (_jsxs(_Fragment, { children: [_jsx("div", { className: cx('filter-panel__sections', isRow ? 'filter-panel__sections--row' : ''), children: sections.map(section => {
                             const sel = selected[section.label];
                             const isAllSelected = sel === undefined || (Array.isArray(sel) ? sel.length === 0 : false);
                             // section.items에 빈 항목(null/undefined)이 섞여 들어오면 item.value 접근에서

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

@@ -528,7 +528,7 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
                          * 손으로 붙이던 `onKeyDown` 은 **지웠다** — 진짜 단추라 Enter·Space 는 브라우저가
                          * 처리하고, "머리 안 단추에서 누른 키는 그 단추 몫" 이라는 가드도 저절로 선다.
                          */
-                        role: "caption", children: [onToggleCollapse && (_jsx(Button, { htmlType: "button", size: 40, type: "dot", variant: "transparent-gray", useBorder: false, icon: collapsed ? 'chevron-right' : 'chevron-down', ariaLabel: collapsed ? t('common.expand', '열기') : t('common.collapse', '접기'), 
+                        role: "caption", children: [onToggleCollapse && (_jsx(Button, { htmlType: "button", size: 40, type: "dot", variant: "transparent-gray", useBorder: false, icon: collapsed ? 'chevron-right' : 'chevron-down', ariaLabel: collapsed ? t('common.expand', '펼치기') : t('common.collapse', '접기'), 
                                 /* 여닫힘은 **여는 것**이 말한다 — 전에는 겉의 `div` 에 달려 있었다(위 머리글) */
                                 ariaExpanded: !collapsed, className: "table-header__chevron" })), icon && (_jsx(Icon, { icon: icon, label: typeof title === 'string' ? title : undefined, className: "table-header__icon" })), _jsx("span", { id: 제목id, className: "table-header__title h5b", children: title }), count !== undefined && _jsx("span", { className: "table-header__count body-3b", children: count }), headerActions && (_jsx("span", { className: "table-header__actions", onClick: e => e.stopPropagation(), children: headerActions }))] })), !collapsed && (_jsxs(_Fragment, { children: [headerGroups && headerGroups.length > 0 && (_jsx("div", { role: "row", className: "table-fields table-fields--groups", children: headerGroups.map((g, i) => (_jsx("div", { role: "columnheader", "aria-colspan": g.span, className: cx('table-field body-3', g.className), style: { gridColumn: `span ${g.span}` }, children: g.label }, i))) })), _jsxs("div", { role: "presentation", className: cx('table-fields-strip', 폭조절 && 'table-fields-strip--resizable'), children: [_jsx("div", { role: "row", className: "table-fields", ref: fieldsRef, children: fields.map((f, i) => (_jsx(TableField, { onClick: f.onClick, className: f.className, sortDir: f.sortDir, ariaSort: ariaSortOf(i), 
                                             /* fit 모드는 오른쪽 이웃에서 폭을 덜어 오므로, 덜어 올 컬럼이 없는 자리에는

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

@@ -25,7 +25,7 @@ export default function TrainingCardGroup({ title, titleLevel = 3, count, collap
                            때만 — 마디 제목이면 이름을 못 짓는다. */
                         ariaLabel: typeof title === 'string' && title
                             ? (collapsed ? t('common.expandFor', { name: title }) : t('common.collapseFor', { name: title }))
-                            : (collapsed ? t('common.expand', '열기') : t('common.collapse', '접기')), className: "training-card-group__chevron", "aria-expanded": !collapsed, onClick: onToggle })), typeof title === 'string'
+                            : (collapsed ? t('common.expand', '펼치기') : t('common.collapse', '접기')), className: "training-card-group__chevron", "aria-expanded": !collapsed, onClick: onToggle })), typeof title === 'string'
                         ? _jsx(제목태그, { id: 제목id, className: "training-card-group__title h5b", children: title })
                         : title, count !== undefined && _jsx("span", { className: "training-card-group__count body-3b", children: count }), (sort || actions != null) && (_jsxs("span", { className: "training-card-group__actions", onClick: e => e.stopPropagation(), children: [sort && (_jsx(Dropdown, { size: 40, options: sort.options, value: sort.value, placeholder: sort.placeholder, onChange: sort.onChange, 
                                 /* 접기와 같은 까닭으로 묶음 이름을 단다 — 그룹마다 `정렬` 이 하나씩 선다 */

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

@@ -10,6 +10,14 @@ export type TrainingStepProps = {
     className?: string;
     onDone?: (payload?: unknown) => void;
     useTitleFaded?: boolean;
+    /**
+     * **왜 아직 못 누르는지 알리는 한 줄** — 잠긴 단계 **바로 다음 차례**에만 선다
+     * (말귀 요청 (99), 2026-10-08).
+     *
+     * 안 주면 *"다 들으면 고를 수 있어요."* 다 — 이 저장소의 단계는 앞이 늘 **듣는 단계**다.
+     * 기다리는 것이 다른 단계면 그 말을 주고, **`null` 을 주면 안 세운다.**
+     */
+    lockedHint?: ReactNode | null;
 };
 /** @public */
-export default function TrainingStep({ index, stepIndex, isLast, title, titleProps, children, className, onDone, useTitleFaded }: TrainingStepProps): import("react").JSX.Element;
+export default function TrainingStep({ index, stepIndex, isLast, title, titleProps, children, className, onDone, useTitleFaded, lockedHint }: TrainingStepProps): import("react").JSX.Element;

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

@@ -18,7 +18,7 @@ function computeState(index, sIndex) {
     return "disabled";
 }
 /** @public */
-export default function TrainingStep({ index, stepIndex, isLast = false, title = "", titleProps = {}, children, className = "", onDone = undefined, useTitleFaded = undefined }) {
+export default function TrainingStep({ index, stepIndex, isLast = false, title = "", titleProps = {}, children, className = "", onDone = undefined, useTitleFaded = undefined, lockedHint }) {
     const { t } = useTranslation();
     const [currentState, setCurrentState] = useState(() => computeState(index, stepIndex));
     useEffect(() => {
@@ -87,5 +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 }), 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 !== 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] }));
 }

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

@@ -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 }), currentState === 'disabled' && (_jsx("p", { className: "training-step__locked-hint caption-1", role: "status", children: t('training.answerLockedHint', '다 들으면 고를 수 있어요.') })), _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, 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/trainingBlockButtonTypes.d.ts

@@ -10,6 +10,21 @@ export interface TrainingBlockButtonPopupProps {
         correct: number | null;
         total: number | null;
     }) => void;
+    /**
+     * **판이 끝난 그 순간** 호출 — 닫기와 무관하다(`TrainingPagePopup` 으로 그대로 전달).
+     *
+     * `onComplete` 는 **닫을 때** 불린다. 숙제처럼 *"이 문항 풀었다"* 를 세는 쪽은 닫기를
+     * 기다릴 수 없다 — 다 풀고 안 닫고 떠나면 통째로 날아갔다(말귀 요청 (100), 0.300.0).
+     *
+     * **값은 `...rest` 로 흘러 이미 갔는데 타입만 빠져 있었다**(0.300.0). 쓰는 쪽은 통과시킬
+     * 길이 없어 `as` 로 덮어야 했다 — (74) 가 앱까지 안 닿았던 것과 **같은 꼴**이다:
+     * 가운데 한 겹이 안 따라갔다.
+     */
+    onRoundFinished?: (result: {
+        correct: number | null;
+        total: number | null;
+        attempt?: number;
+    }) => void;
     popupTitle: string;
     popupSubTitle?: string;
     depth?: string;

package/dist/packages/core/src/i18n/locales/ko.json

@@ -40,7 +40,7 @@
         "more": "더보기",
         "moreFor": "{{name}} 더보기",
         "collapseFor": "{{name}} 접기",
-        "expandFor": "{{name}} 열기",
+        "expandFor": "{{name}} 펼치기",
         "sortFor": "{{name}} 정렬",
         "retry": "다시 시도",
         "prevPage": "이전 페이지",
@@ -63,7 +63,7 @@
         "pageSizeLabel": "{{n}}개씩 보기",
         "totalCountPrefix": "총 ",
         "totalCountSuffix": "개",
-        "expand": "열기",
+        "expand": "펼치기",
         "collapse": "접기",
         "popup": "팝업",
         "codeBlock": "코드 블록",
@@ -159,7 +159,7 @@
     },
     "accordion": {
         "collapse": "접기",
-        "expand": "열기"
+        "expand": "펼치기"
     },
     "header": {
         "biArea": "BI 영역",

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

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

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

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