@ihabdevteam/core 0.258.0 → 0.260.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.258.0";
+export declare const CORE_VERSION = "0.260.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -10200,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/TrainingCard.css

@@ -179,3 +179,15 @@
   align-items: center;
   gap: 4px;
 }
+
+/* 누를 일이 없을 때의 게시자 이름 — 글자다((69), 2026-10-02).
+   생김새(색·크기·말줄임)는 그대로 두고 **누를 수 있다는 거짓 신호만** 거둔다.
+   `cursor: pointer` 는 iOS 가 "누를 수 있는 것" 을 가리는 데도 쓰므로 함께 거둔다
+   (`test/touchInteractions0915.test.tsx` 머리글 참고). */
+.training-card__publisher--static {
+  cursor: default;
+}
+.training-card__publisher--static:hover {
+  color: var(--color-gray);
+  text-decoration: none;
+}

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/Word/WordTableButton.js

@@ -27,5 +27,7 @@ export default function WordTableButton({ items, name, description, createdAt, c
     return (_jsxs("div", { className: cx('word-table-button', selected ? 'word-table-button--selected' : '', !hasStoreFooter ? 'word-table-button--no-footer' : '', className), role: "button", tabIndex: 0, "aria-label": code ? `${name} (${code})` : name, onClick: renaming ? undefined : onClick, onKeyDown: handleKey, children: [isNew && _jsx("span", { className: "word-table-button__new-dot", "aria-label": t('myWordTable.newBadge', '새로 만든 표') }), _jsx(WordTableThumbnail, { items: items, className: "word-table-button__thumb" }), _jsxs("div", { className: "word-table-button__info", children: [_jsxs("div", { className: "word-table-button__info-text", children: [titleNode ?? _jsx("div", { className: "word-table-button__title h4", children: name }), description && _jsx("div", { className: "word-table-button__desc body-3", children: description })] }), onMore && !renaming && (_jsx(Button, { htmlType: "button", className: "word-table-button__more", size: 32, type: "dot", variant: "transparent-gray", useBorder: false, icon: "ellipsis", 
                         /* 하드코딩 '더보기'였다(영어 화면에서도 한국어로 남았다). 목록에 표가
                            여러 개면 이름이 같은 버튼이 여러 개이기도 해서 이름을 함께 넣는다. */
-                        ariaLabel: t('common.moreFor', { name }), onClick: (e) => { e.stopPropagation(); onMore(e); } }))] }), (code || createdAt || published || shared) && (_jsxs("div", { className: "word-table-button__meta-row", children: [_jsx("span", { className: "word-table-button__meta-left", children: _jsx("span", { className: "word-table-button__meta caption-1", children: createdAt ? formatRelativeTime(createdAt, t) : '' }) }), _jsxs("span", { className: "word-table-button__meta-right", children: [(published || shared) && (_jsxs("span", { className: "word-table-button__badges", children: [published && (_jsx(Badge, { className: "word-table-button__badge", size: "small", variant: "main", fill: "soft", iconLeft: "book-marked", label: publishedLabel ?? t('myWordTable.publishedBadge', '발행됨') })), shared && (_jsx(Badge, { className: "word-table-button__badge", size: "small", fill: "soft", iconLeft: "link", label: sharedLabel ?? t('myWordTable.sharedBadge', '공유 중') }))] })), code && _jsx("span", { className: "word-table-button__code caption-1", children: code })] })] })), hasStoreFooter && (_jsxs("div", { className: "word-table-button__footer", children: [_jsxs("span", { className: "word-table-button__store-by", children: [publisherName && (_jsx("button", { className: "training-card__publisher body-4", type: "button", onClick: (e) => { e.stopPropagation(); onPublisherClick?.(); }, children: publisherName })), publishedAt && _jsx("span", { className: "training-card__date body-4", children: formatRelativeTime(publishedAt, t) })] }), _jsxs("span", { className: "word-table-button__store-stats", children: [likeCount != null && (_jsx(Badge, { size: "small", fill: "soft", variant: "like", iconLeft: "heart", label: String(likeCount), "aria-label": t('common.likeCount', { count: likeCount, defaultValue: `좋아요 ${likeCount}` }) })), downloadCount != null && (_jsx(Badge, { size: "small", fill: "soft", variant: "main", iconLeft: "download", label: String(downloadCount), "aria-label": t('common.downloadCount', { count: downloadCount, defaultValue: `가져간 수 ${downloadCount}` }) }))] })] }))] }));
+                        ariaLabel: t('common.moreFor', { name }), onClick: (e) => { e.stopPropagation(); onMore(e); } }))] }), (code || createdAt || published || shared) && (_jsxs("div", { className: "word-table-button__meta-row", children: [_jsx("span", { className: "word-table-button__meta-left", children: _jsx("span", { className: "word-table-button__meta caption-1", children: createdAt ? formatRelativeTime(createdAt, t) : '' }) }), _jsxs("span", { className: "word-table-button__meta-right", children: [(published || shared) && (_jsxs("span", { className: "word-table-button__badges", children: [published && (_jsx(Badge, { className: "word-table-button__badge", size: "small", variant: "main", fill: "soft", iconLeft: "book-marked", label: publishedLabel ?? t('myWordTable.publishedBadge', '발행됨') })), shared && (_jsx(Badge, { className: "word-table-button__badge", size: "small", fill: "soft", iconLeft: "link", label: sharedLabel ?? t('myWordTable.sharedBadge', '공유 중') }))] })), code && _jsx("span", { className: "word-table-button__code caption-1", children: code })] })] })), hasStoreFooter && (_jsxs("div", { className: "word-table-button__footer", children: [_jsxs("span", { className: "word-table-button__store-by", children: [publisherName && (onPublisherClick
+                                ? (_jsx("button", { className: "training-card__publisher body-4", type: "button", "aria-label": t('wordTable.publisherFilter', { name: publisherName, defaultValue: '{{name}} 게시한 것만 보기' }), onClick: (e) => { e.stopPropagation(); onPublisherClick(); }, children: publisherName }))
+                                : _jsx("span", { className: "training-card__publisher training-card__publisher--static body-4", children: publisherName })), publishedAt && _jsx("span", { className: "training-card__date body-4", children: formatRelativeTime(publishedAt, t) })] }), _jsxs("span", { className: "word-table-button__store-stats", children: [likeCount != null && (_jsx(Badge, { size: "small", fill: "soft", variant: "like", iconLeft: "heart", label: String(likeCount), "aria-label": t('common.likeCount', { count: likeCount, defaultValue: `좋아요 ${likeCount}` }) })), downloadCount != null && (_jsx(Badge, { size: "small", fill: "soft", variant: "main", iconLeft: "download", label: String(downloadCount), "aria-label": t('common.downloadCount', { count: downloadCount, defaultValue: `가져간 수 ${downloadCount}` }) }))] })] }))] }));
 }

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/i18n/locales/en.json

@@ -801,6 +801,7 @@
                 "list": "List View"
             }
         },
+        "publisherFilter": "Show only tables by {{name}}",
         "groupDeleteMessage": "Word tables in this group will be moved to 'No Group'.",
         "groupNamePlaceholder": "Group name",
         "store": {

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

@@ -799,6 +799,7 @@
                 "list": "리스트로 보기"
             }
         },
+        "publisherFilter": "{{name}} 게시한 것만 보기",
         "groupDeleteMessage": "그룹 내 단어표는 '그룹 없음'으로 이동합니다.",
         "groupNamePlaceholder": "그룹 이름",
         "store": {

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

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

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

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