@ihabdevteam/core 0.307.0 → 0.309.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.307.0";
+export declare const CORE_VERSION = "0.309.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -1915,13 +1915,17 @@ export declare function dateToDb(app: string | null | undefined): string | undef
 export declare function DebugResultLauncher({ enabled, renderResultPopup }?: {
     /** 켜야 단추가 보인다. 기본은 꺼짐 — 배포 화면에 실수로 남지 않게. */
     enabled?: boolean;
-    renderResultPopup?: (props: {
-        score?: number | null;
-        contextsLength?: number | null;
-        results?: unknown[];
-        onReplay?: () => void;
-        onClose?: () => void;
-    }) => ReactNode;
+    /**
+     * 결과 창을 그리는 함수 — **훈련 창이 쓰는 것과 같은 모양**을 가리킨다.
+     *
+     * 전에는 여기에 모양을 **손수 베껴** 두었고 `pending`(결과를 아직 세는 중) 한 칸이
+     * 빠져 있었다. 그 칸이 없어도 아무것도 안 깨진다 — 있어도 되는 칸이라 **조용하다.**
+     * 다만 창에 칸이 늘 때 이 자리만 옛 모양으로 남는다. (104) 를 세며 찾은 **셋째 자리**다.
+     *
+     * 이 단추는 다 만들어진 자료를 바로 띄우니 `pending` 을 안 넘긴다 — 없어도 되는 칸이라
+     * 넘기지 않는 것이 맞다.
+     */
+    renderResultPopup?: TrainingPagePopupProps['renderResultPopup'];
 }): JSX.Element | null;
 
 declare type Decomp = (ReturnType<typeof parseSyllable>)[];
@@ -8281,6 +8285,18 @@ export declare interface TrainingBlockButtonPopupProps {
      * 못은 `test/roundFinishedResultShape.test-d.ts` 가 **두 쪽을 맞대어** 센다.
      */
     onRoundFinished?: (result: TrainingCompleteResult) => void;
+    /**
+     * 결과창을 손수 그린다 — **없으면 기본 결과 창**(`TrainingResultPopup`). `TrainingPagePopup`
+     * 으로 그대로 전달된다(말귀 요청 (104), 0.308.0).
+     *
+     * **값은 `...rest` 로 흘러 이미 가고 있었고 타입에만 없었다** — `onRoundFinished` 가
+     * 0.300.0 에 겪은 것과 **같은 꼴, 다른 칸**이다(그쪽은 *돌려주는* 덩이, 이쪽은 *넘겨주는*
+     * 꾸러미). 쓰는 쪽 셋이 전부 같은 `as Parameters<typeof defaultPopupRenderer>[0]` 로
+     * 눌러 왔다(말귀 실측: 셋을 걷으니 셋이 함께 `TS2353`).
+     *
+     * 모양을 **베끼지 않고** 창의 것을 그대로 가리킨다 — 창에 칸이 늘면 여기도 같이 는다.
+     */
+    renderResultPopup?: TrainingPagePopupProps['renderResultPopup'];
     popupTitle: string;
     popupSubTitle?: string;
     depth?: string;

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/Tooltip/DebugTooltip.d.ts

@@ -1,5 +1,5 @@
-import { type ReactNode } from 'react';
 import './DebugTooltip.css';
+import type { TrainingPagePopupProps } from '../Training/TrainingPagePopup';
 /**
  * 결과 팝업을 실제 훈련 없이 열어보는 개발용 단추 넷.
  *
@@ -13,11 +13,15 @@ import './DebugTooltip.css';
 export default function DebugResultLauncher({ enabled, renderResultPopup }?: {
     /** 켜야 단추가 보인다. 기본은 꺼짐 — 배포 화면에 실수로 남지 않게. */
     enabled?: boolean;
-    renderResultPopup?: (props: {
-        score?: number | null;
-        contextsLength?: number | null;
-        results?: unknown[];
-        onReplay?: () => void;
-        onClose?: () => void;
-    }) => ReactNode;
+    /**
+     * 결과 창을 그리는 함수 — **훈련 창이 쓰는 것과 같은 모양**을 가리킨다.
+     *
+     * 전에는 여기에 모양을 **손수 베껴** 두었고 `pending`(결과를 아직 세는 중) 한 칸이
+     * 빠져 있었다. 그 칸이 없어도 아무것도 안 깨진다 — 있어도 되는 칸이라 **조용하다.**
+     * 다만 창에 칸이 늘 때 이 자리만 옛 모양으로 남는다. (104) 를 세며 찾은 **셋째 자리**다.
+     *
+     * 이 단추는 다 만들어진 자료를 바로 띄우니 `pending` 을 안 넘긴다 — 없어도 되는 칸이라
+     * 넘기지 않는 것이 맞다.
+     */
+    renderResultPopup?: TrainingPagePopupProps['renderResultPopup'];
 }): import("react").JSX.Element | 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/trainingBlockButtonTypes.d.ts

@@ -1,6 +1,6 @@
 import type { CSSProperties, ReactNode } from 'react';
 import type { TrainingItem } from '../../types/training';
-import type { TrainingCompleteResult } from './TrainingPagePopup';
+import type { TrainingCompleteResult, TrainingPagePopupProps } from './TrainingPagePopup';
 /** @public */
 export interface TrainingBlockButtonPopupProps {
     trainingData: TrainingItem | null;
@@ -28,6 +28,18 @@ export interface TrainingBlockButtonPopupProps {
      * 못은 `test/roundFinishedResultShape.test-d.ts` 가 **두 쪽을 맞대어** 센다.
      */
     onRoundFinished?: (result: TrainingCompleteResult) => void;
+    /**
+     * 결과창을 손수 그린다 — **없으면 기본 결과 창**(`TrainingResultPopup`). `TrainingPagePopup`
+     * 으로 그대로 전달된다(말귀 요청 (104), 0.308.0).
+     *
+     * **값은 `...rest` 로 흘러 이미 가고 있었고 타입에만 없었다** — `onRoundFinished` 가
+     * 0.300.0 에 겪은 것과 **같은 꼴, 다른 칸**이다(그쪽은 *돌려주는* 덩이, 이쪽은 *넘겨주는*
+     * 꾸러미). 쓰는 쪽 셋이 전부 같은 `as Parameters<typeof defaultPopupRenderer>[0]` 로
+     * 눌러 왔다(말귀 실측: 셋을 걷으니 셋이 함께 `TS2353`).
+     *
+     * 모양을 **베끼지 않고** 창의 것을 그대로 가리킨다 — 창에 칸이 늘면 여기도 같이 는다.
+     */
+    renderResultPopup?: TrainingPagePopupProps['renderResultPopup'];
     popupTitle: string;
     popupSubTitle?: string;
     depth?: string;

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.307.0";
+export declare const CORE_VERSION = "0.309.0";

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

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