@ihabdevteam/core 0.257.0 → 0.259.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.257.0";
+export declare const CORE_VERSION = "0.259.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -8654,6 +8654,23 @@ export declare interface TrainingItemResult {
     selected: string | null;
     /** 맞았나. 정오답 개념이 없는 유형이면 null */
     correct: boolean | null;
+    /**
+     * 이 문항이 **보이거나 들리기 시작한 때**(ISO 8601) — 소리 문항이면 재생 시작. 모르면 `null`.
+     *
+     * **반응 시간을 잴 길이 없었다**(말귀 요청 (68), 2026-10-02). 앱은 판이 끝날 때 문항을
+     * 한꺼번에 적으므로 행의 `answered_at` 은 **"적은 때"** 다 — 말귀 실측(19행): 한 판 안 두
+     * 문항의 차가 중앙값 **0.049초**, 최대 0.216초. 푼 간격이 아니라 **줄을 쓴 간격**이다.
+     *
+     * 찍는 것은 **화면의 몫**이다 — 코어는 `buildResults` 가 돌려준 것을 추릴 뿐이고, 한 쪽이
+     * 곧 한 문항도 아니다(쪽 하나에 문항이 여럿 설 수 있다). 코어가 할 일은 **버리지 않는
+     * 것**이었다: 이 칸이 없던 때는 화면이 찍어 넣어도 `toItemResults` 가 조용히 떨어뜨렸다.
+     *
+     * 다시 듣기를 눌러도 **처음 보인 때로 둔다** — 반응 시간에 다시 듣기 노력이 들어가는 쪽이
+     * 실제에 가깝다(말귀와 같은 판단).
+     */
+    shownAt: string | null;
+    /** 답을 고른(확정한) 때(ISO 8601). 안 골랐으면 `null`. 위 `shownAt` 머리글 참고 */
+    answeredAt: string | null;
 }
 
 /** @public */
@@ -10183,6 +10200,25 @@ export declare function withEuRo(text: string): string;
 /** text 뒤에 문맥에 맞는 이/가를 붙여 반환한다. */
 export declare function withIga(text: string): string;
 
+/**
+ * @public 스텝 payload 에 **때 둘을 얹는다** — 보인 때 · 답한 때(말귀 요청 (68) 후속, 2026-10-02).
+ *
+ * `TrainingPagePopup` 의 저장 길목(`setScenarioAnswer`)이 부른다. **셈을 조각 밖으로 뺀 것은
+ * 실제 값으로 잴 수 있게 하려는 것이다** — 조각 안에 두면 "소스에 그 글자가 있나" 로밖에
+ * 못 묻는데, 그런 시험은 셈이 틀려도 초록이다.
+ *
+ * - `answeredAt` 은 `__ts`(스텝이 고른 **바로 그 순간**)를 쓴다. 저장이 끝난 뒤 다시 재면
+ *   답이 state 에 앉는 데 걸린 시간이 섞인다 — 말귀가 잰 0.049초가 그런 값이었다.
+ * - `shownAt` 은 부르는 쪽이 적어 둔 것을 받는다. 답이 놓이는 순간에는 이미 사람이 다
+ *   고른 뒤라 보인 때를 알 수 없다.
+ * - **이미 들어 있는 때는 안 덮는다.** 스텝이 제 때를 찍어 보냈으면 그쪽이 더 정확하다.
+ * - **객체가 아닌 payload 는 그대로 둔다** — 없던 칸을 지어 붙이지 않는다.
+ *
+ * 글자꼴은 `Z` 다. 여기서 짓는 때는 **epoch 하나**라 지킬 지역 시계가 없다 — 앱이 *글자로*
+ * 보낸 때를 안 고치는 것(`utils/trainingItemResults` 의 `때`)과는 다른 자리다.
+ */
+export declare function withStepTimes(payload: unknown, shownAt?: string, answeredTs?: number): unknown;
+
 /** text 뒤에 와/과를 붙여 반환한다. */
 export declare function withWaGwa(text: string): string;
 

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

@@ -16,7 +16,7 @@ import TrainingStepConfirm from './TrainingStepConfirm';
 import TrainingStepConfirmWithText from './TrainingStepConfirmWithText';
 import TrainingStepListen from './TrainingStepListen';
 import TrainingStepOrderList from './TrainingStepOrderList';
-import { getPayloadTimestamp } from './trainingPopupUtils';
+import { getPayloadTimestamp, withStepTimes } from './trainingPopupUtils';
 import { TrainingPagePopupContext } from './TrainingPagePopupContext';
 import { NoisePlayerContext, DEFAULT_NOISE_SETTINGS, mergeNoiseSettings } from './NoisePlayerContext';
 import { lockBodyScrollWithPadding } from '../../hooks/bodyScrollLock';
@@ -393,6 +393,37 @@ function TrainingPagePopupInner(props) {
         : isChildrenMode
             ? effectiveChildrenPageCount
             : (typeof pageCount === 'number' ? pageCount : 0);
+    /**
+     * **지금 선 스텝이 처음 보인 때를 적어 둔다**(말귀 요청 (68) 후속, 2026-10-02).
+     *
+     * 답이 놓이는 자리(`setScenarioAnswer`)는 **답한 때**만 알고 **보인 때**는 모른다 —
+     * 그때는 이미 사람이 다 고른 뒤다. 그래서 스텝이 설 때 미리 적어 둔다.
+     *
+     * **`0 ~ 지금` 을 다 적는다**: 한 쪽에 스텝이 여럿 서는 꼴(듣기 → 고르기)에서는 앞 스텝도
+     * 이미 보였는데, 지금 것만 적으면 그 스텝의 `shownAt` 이 영영 빈다. 이미 적힌 것은 안 고친다 —
+     * 다시 듣기로 되돌아와도 **처음 보인 때**로 둔다.
+     *
+     * 쪽이 바뀌면 열쇠(`쪽\0스텝`)가 달라지므로 쪽마다 따로 쌓인다.
+     */
+    useEffect(() => {
+        if (!hasScenario && !isChildrenMode)
+            return;
+        const pageId = hasScenario
+            ? getScenarioPageId(currentScenarioPage, effectivePageIndex)
+            : (currentChildrenPage?.id || `children-page-${effectivePageIndex ?? 0}`);
+        const 지금 = new Date().toISOString();
+        for (let i = 0; i <= effectiveStepIndex; i += 1) {
+            const stepKey = hasScenario
+                ? getScenarioStepKey(currentScenarioSteps[i], i)
+                : `step-${i}`;
+            const k = 보인때열쇠(pageId, stepKey);
+            if (!스텝보인때.current.has(k))
+                스텝보인때.current.set(k, 지금);
+        }
+        /* `currentScenarioSteps` 는 그릴 때마다 새 배열이라 의존성에 넣으면 매번 돈다 —
+           쪽·스텝 번호가 바뀔 때만 돌면 되고, 그 둘이 바뀌면 스텝 목록도 함께 바뀐다. */
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [hasScenario, isChildrenMode, effectivePageIndex, effectiveStepIndex, currentChildrenPage?.id]);
     // 페이지가 앞으로 진행되면 안내 메시지를 띄우는 의도된 동기화다
     /* eslint-disable react-hooks/set-state-in-effect */
     useLayoutEffect(() => {
@@ -486,6 +517,16 @@ function TrainingPagePopupInner(props) {
         if (panelRef.current)
             panelRef.current._childOnResult = fn;
     }, []);
+    /**
+     * **스텝이 처음 보인 때** — `쪽\0스텝` 하나당 한 번만 적고 **다시 와도 안 고친다**
+     * (말귀 요청 (68) 후속, 2026-10-02). 다시 듣기를 눌러도 처음 보인 때로 둔다 —
+     * 반응 시간에 다시 듣기 노력이 들어가는 쪽이 실제에 가깝다.
+     *
+     * `state` 가 아니라 `ref` 다: 이 값은 **그릴 것을 바꾸지 않는다.** state 로 두면 스텝이
+     * 바뀔 때마다 한 번씩 더 그린다.
+     */
+    const 스텝보인때 = useRef(new Map());
+    const 보인때열쇠 = (pageId, stepKey) => `${pageId}\u0000${stepKey}`;
     const setScenarioAnswer = useCallback((pageId, stepKey, payload) => {
         setFlowState((prev) => {
             const pageAnswers = prev.answersByPage[pageId] || {};
@@ -494,13 +535,22 @@ function TrainingPagePopupInner(props) {
             const existingTs = getPayloadTimestamp(existing);
             if (existing && existingTs > incomingTs)
                 return prev;
+            /* **때를 여기서 얹는다**(말귀 요청 (68) 후속). 스텝 답은 모두 이 한 길목을 지나므로,
+               화면마다 따로 찍을 까닭이 없다.
+               - `answeredAt` 은 payload 의 `__ts` 를 쓴다 — **스텝이 고른 바로 그 순간**이라
+                 여기서 다시 재는 것보다 정확하다(state 가 앉는 데 걸린 시간이 안 섞인다).
+                 `__ts` 가 없는 payload 는 지금 잰다.
+               - `shownAt` 은 위 `스텝보인때` 에 적어 둔 것을 꺼낸다.
+               글자꼴은 `Z` 다 — **여기서 짓는 때는 epoch 하나**라 지킬 지역 시계가 없다
+               (앱이 글자로 보낸 때를 안 고치는 것과 다른 자리다, `trainingItemResults` 머리글). */
+            const 얹은payload = withStepTimes(payload, 스텝보인때.current.get(보인때열쇠(pageId, stepKey)), incomingTs);
             return {
                 ...prev,
                 answersByPage: {
                     ...prev.answersByPage,
                     [pageId]: {
                         ...pageAnswers,
-                        [stepKey]: payload,
+                        [stepKey]: 얹은payload,
                     },
                 },
             };

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

@@ -26,6 +26,24 @@ export declare function resolveTrainingPopupMeta(trainingData: Record<string, un
 };
 /** @public */
 export declare function getPayloadTimestamp(payload: unknown): number;
+/**
+ * @public 스텝 payload 에 **때 둘을 얹는다** — 보인 때 · 답한 때(말귀 요청 (68) 후속, 2026-10-02).
+ *
+ * `TrainingPagePopup` 의 저장 길목(`setScenarioAnswer`)이 부른다. **셈을 조각 밖으로 뺀 것은
+ * 실제 값으로 잴 수 있게 하려는 것이다** — 조각 안에 두면 "소스에 그 글자가 있나" 로밖에
+ * 못 묻는데, 그런 시험은 셈이 틀려도 초록이다.
+ *
+ * - `answeredAt` 은 `__ts`(스텝이 고른 **바로 그 순간**)를 쓴다. 저장이 끝난 뒤 다시 재면
+ *   답이 state 에 앉는 데 걸린 시간이 섞인다 — 말귀가 잰 0.049초가 그런 값이었다.
+ * - `shownAt` 은 부르는 쪽이 적어 둔 것을 받는다. 답이 놓이는 순간에는 이미 사람이 다
+ *   고른 뒤라 보인 때를 알 수 없다.
+ * - **이미 들어 있는 때는 안 덮는다.** 스텝이 제 때를 찍어 보냈으면 그쪽이 더 정확하다.
+ * - **객체가 아닌 payload 는 그대로 둔다** — 없던 칸을 지어 붙이지 않는다.
+ *
+ * 글자꼴은 `Z` 다. 여기서 짓는 때는 **epoch 하나**라 지킬 지역 시계가 없다 — 앱이 *글자로*
+ * 보낸 때를 안 고치는 것(`utils/trainingItemResults` 의 `때`)과는 다른 자리다.
+ */
+export declare function withStepTimes(payload: unknown, shownAt?: string, answeredTs?: number): unknown;
 /** @public */
 export declare function resolveTrainingItems(trainingData: unknown): unknown[];
 interface CreateTrainingScenarioParams {

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

@@ -83,6 +83,34 @@ export function getPayloadTimestamp(payload) {
     }
     return 0;
 }
+/**
+ * @public 스텝 payload 에 **때 둘을 얹는다** — 보인 때 · 답한 때(말귀 요청 (68) 후속, 2026-10-02).
+ *
+ * `TrainingPagePopup` 의 저장 길목(`setScenarioAnswer`)이 부른다. **셈을 조각 밖으로 뺀 것은
+ * 실제 값으로 잴 수 있게 하려는 것이다** — 조각 안에 두면 "소스에 그 글자가 있나" 로밖에
+ * 못 묻는데, 그런 시험은 셈이 틀려도 초록이다.
+ *
+ * - `answeredAt` 은 `__ts`(스텝이 고른 **바로 그 순간**)를 쓴다. 저장이 끝난 뒤 다시 재면
+ *   답이 state 에 앉는 데 걸린 시간이 섞인다 — 말귀가 잰 0.049초가 그런 값이었다.
+ * - `shownAt` 은 부르는 쪽이 적어 둔 것을 받는다. 답이 놓이는 순간에는 이미 사람이 다
+ *   고른 뒤라 보인 때를 알 수 없다.
+ * - **이미 들어 있는 때는 안 덮는다.** 스텝이 제 때를 찍어 보냈으면 그쪽이 더 정확하다.
+ * - **객체가 아닌 payload 는 그대로 둔다** — 없던 칸을 지어 붙이지 않는다.
+ *
+ * 글자꼴은 `Z` 다. 여기서 짓는 때는 **epoch 하나**라 지킬 지역 시계가 없다 — 앱이 *글자로*
+ * 보낸 때를 안 고치는 것(`utils/trainingItemResults` 의 `때`)과는 다른 자리다.
+ */
+export function withStepTimes(payload, shownAt, answeredTs) {
+    if (!payload || typeof payload !== 'object' || Array.isArray(payload))
+        return payload;
+    const p = payload;
+    const ts = typeof answeredTs === 'number' && answeredTs > 0 ? answeredTs : Date.now();
+    return {
+        ...p,
+        ...(p.shownAt === undefined && shownAt ? { shownAt } : {}),
+        ...(p.answeredAt === undefined ? { answeredAt: new Date(ts).toISOString() } : {}),
+    };
+}
 /** @public */
 export function resolveTrainingItems(trainingData) {
     const td = trainingData;

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

@@ -288,7 +288,7 @@ export * from './components/Training/TrainingStepConfirmWithText';
 export * from './components/Training/TrainingStepListen';
 export * from './components/Training/TrainingStepOrderList';
 export * from './components/Training/TrainingStepCard';
-export { closeTrainingPopup, deriveNoiseContexts, getSteppedPayload, getSelectedFromPayload, getStepPayload, getSelectedText, splitTrainingVariants, resolveTrainingPopupMeta, createTrainingScenario, toTrainingText, isSelectionCorrect, getPayloadTimestamp, resolveTrainingItems, } from './components/Training/trainingPopupUtils';
+export { closeTrainingPopup, deriveNoiseContexts, getSteppedPayload, getSelectedFromPayload, getStepPayload, getSelectedText, splitTrainingVariants, resolveTrainingPopupMeta, createTrainingScenario, toTrainingText, isSelectionCorrect, getPayloadTimestamp, withStepTimes, resolveTrainingItems, } from './components/Training/trainingPopupUtils';
 export type { AccordionProps, AccordionItem } from './components/Accordion';
 export type { NoticeBoxProps } from './components/NoticeBox';
 export type { ProgressBarProps } from './components/ProgressBar';

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

@@ -228,7 +228,7 @@ export * from './components/Training/TrainingStepConfirmWithText';
 export * from './components/Training/TrainingStepListen';
 export * from './components/Training/TrainingStepOrderList';
 export * from './components/Training/TrainingStepCard';
-export { closeTrainingPopup, deriveNoiseContexts, getSteppedPayload, getSelectedFromPayload, getStepPayload, getSelectedText, splitTrainingVariants, resolveTrainingPopupMeta, createTrainingScenario, toTrainingText, isSelectionCorrect, getPayloadTimestamp, resolveTrainingItems, } from './components/Training/trainingPopupUtils';
+export { closeTrainingPopup, deriveNoiseContexts, getSteppedPayload, getSelectedFromPayload, getStepPayload, getSelectedText, splitTrainingVariants, resolveTrainingPopupMeta, createTrainingScenario, toTrainingText, isSelectionCorrect, getPayloadTimestamp, withStepTimes, resolveTrainingItems, } from './components/Training/trainingPopupUtils';
 export { default as PageTitle } from './components/PageTitle';
 export { companyTypeLabel } from './utils/companyTypes';
 export { cx } from './utils/cx';

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

@@ -38,6 +38,23 @@ export interface TrainingItemResult {
     selected: string | null;
     /** 맞았나. 정오답 개념이 없는 유형이면 null */
     correct: boolean | null;
+    /**
+     * 이 문항이 **보이거나 들리기 시작한 때**(ISO 8601) — 소리 문항이면 재생 시작. 모르면 `null`.
+     *
+     * **반응 시간을 잴 길이 없었다**(말귀 요청 (68), 2026-10-02). 앱은 판이 끝날 때 문항을
+     * 한꺼번에 적으므로 행의 `answered_at` 은 **"적은 때"** 다 — 말귀 실측(19행): 한 판 안 두
+     * 문항의 차가 중앙값 **0.049초**, 최대 0.216초. 푼 간격이 아니라 **줄을 쓴 간격**이다.
+     *
+     * 찍는 것은 **화면의 몫**이다 — 코어는 `buildResults` 가 돌려준 것을 추릴 뿐이고, 한 쪽이
+     * 곧 한 문항도 아니다(쪽 하나에 문항이 여럿 설 수 있다). 코어가 할 일은 **버리지 않는
+     * 것**이었다: 이 칸이 없던 때는 화면이 찍어 넣어도 `toItemResults` 가 조용히 떨어뜨렸다.
+     *
+     * 다시 듣기를 눌러도 **처음 보인 때로 둔다** — 반응 시간에 다시 듣기 노력이 들어가는 쪽이
+     * 실제에 가깝다(말귀와 같은 판단).
+     */
+    shownAt: string | null;
+    /** 답을 고른(확정한) 때(ISO 8601). 안 골랐으면 `null`. 위 `shownAt` 머리글 참고 */
+    answeredAt: string | null;
 }
 /** 문항 결과 배열이 들고 있을 법한 모양 — 훈련 유형마다 조금씩 다르다 */
 type RawResult = Record<string, unknown>;

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

@@ -15,6 +15,30 @@
  * 지금 섣불리 음소를 박아 두면, 규칙이 바뀔 때 이미 쌓인 기록이 옛 규칙으로 남는다.
  * 낱말은 사실이고 음소는 해석이다 — 사실만 남긴다.
  */
+/**
+ * 때 하나 — ISO 8601 글자로 남긴다. 못 읽는 값은 `null`(없는 때를 지어내지 않는다).
+ *
+ * **글자로 온 것은 고쳐 쓰지 않는다.** `new Date(s).toISOString()` 로 다시 쓰면 `+09:00` 이
+ * `Z` 로 바뀌어 **앱이 가리킨 시계가 무엇이었는지가 지워진다.** 이 저장소는 날짜를 KST 하나로
+ * 읽기로 해 두었고(`utils/date.ts` 머리글), 그 판단은 "어느 날인가" 를 지키려는 것이다 —
+ * 여기서 멋대로 UTC 로 돌리면 그 뜻이 깎인다. 읽히는지만 보고 **그대로** 둔다.
+ * `Date`·숫자(epoch)로 오면 그때는 쓸 글자가 없으니 ISO 로 짓는다.
+ */
+function 때(v) {
+    if (typeof v === 'string') {
+        const s = v.trim();
+        if (!s)
+            return null;
+        return Number.isNaN(new Date(s).getTime()) ? null : s;
+    }
+    if (v instanceof Date)
+        return Number.isNaN(v.getTime()) ? null : v.toISOString();
+    if (typeof v === 'number' && Number.isFinite(v)) {
+        const d = new Date(v);
+        return Number.isNaN(d.getTime()) ? null : d.toISOString();
+    }
+    return null;
+}
 /** 사람이 읽을 수 있는 글자만 남긴다. 객체·빈 문자열은 없는 것으로 본다 */
 function text(v) {
     if (typeof v === 'string')
@@ -61,6 +85,10 @@ export function toItemResults(raw) {
             answer: text(r.answer),
             selected: text(r.selectedText) ?? text(r.selected),
             correct: itemCorrectness(r),
+            /* 칸 이름은 **camelCase 와 snake_case 둘 다** 본다 — 화면이 서버 꼴(`shown_at`)을 그대로
+               들고 있는 자리가 있다. 이름이 하나라고 믿었다가 조용히 떨어뜨리는 것이 이 청의 뿌리다. */
+            shownAt: 때(r.shownAt) ?? 때(r.shown_at),
+            answeredAt: 때(r.answeredAt) ?? 때(r.answered_at),
         };
     });
 }

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

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

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

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