@ihabdevteam/core 0.111.0 → 0.113.0

package/dist/ihabdevteam-core.d.ts

@@ -1333,7 +1333,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.111.0";
+export declare const CORE_VERSION = "0.113.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -2983,6 +2983,15 @@ export declare interface NoiseSettingsStore {
     load: () => Promise<Partial<CoreNoiseSettings> | null>;
     /** 현재 훈련 대상의 소음설정을 저장(fire-and-forget). */
     save: (settings: CoreNoiseSettings) => Promise<void> | void;
+    /**
+     * **판에 실제로 걸린 설정**이 정해지거나 바뀔 때마다 부른다 — 저장 병합 직후,
+     * `noiseOverride` 적용 직후, 판 중 변경마다. 선택.
+     *
+     * `save` 와 따로 두는 까닭: `noiseOverride` 가 걸린 판은 저장을 건너뛴다. 앱이 결과마다
+     * 그 판의 소음 조건을 함께 기록한다면 `save` 로는 그 값을 못 받는다 — 저장값으로
+     * 기록해 조건이 틀리게 남는다. 이 콜백은 저장 여부와 무관하게 늘 걸린 값을 준다.
+     */
+    applied?: (settings: CoreNoiseSettings) => void;
 }
 
 /**
@@ -4455,6 +4464,12 @@ export declare function removeItem<T>(draft: readonly DraftItem<T>[], key: strin
 /** @public 배열에서 from 위치 요소를 to 위치로 옮긴 새 배열을 반환한다(원본 불변). 드래그 재정렬 등에 사용. */
 export declare function reorderArray<T>(arr: readonly T[], from: number, to: number): T[];
 
+/**
+ * @public 판에 걸린 소음설정을 앱에 알린다(`NoiseSettingsStore.applied`). 없으면 아무 일도 안 한다.
+ * 알림이 실패해도 훈련은 이어진다 — `saveNoiseSettings` 와 같은 결로 삼킨다.
+ */
+export declare function reportAppliedNoiseSettings(settings: CoreNoiseSettings): void;
+
 /** @public */
 export declare interface ReportBlock {
     /** 블록을 가리키는 값. 같은 목록 안에서 겹치지 않아야 한다. */
@@ -5859,6 +5874,12 @@ export declare type TableHeaderGroup = {
     className?: string;
 };
 
+/** `useTablePaging` 의 셋째 인자. @public */
+export declare interface TablePagingOptions {
+    /** 처음 개수 보기 — `VAP_PAGE_SIZE_OPTIONS` 의 값('10'·'25'·'50'·'100'). 없거나 목록 밖이면 '25'. 마운트 때만 읽는다. */
+    initialPageSize?: string;
+}
+
 /** @public */
 export declare type TableProps<T extends {
     id?: string | number;
@@ -6938,6 +6959,17 @@ export declare type TrainingPagePopupProps = {
     dailyTotal?: number;
     /** 완료 정본의 항목 식별자(item_ref) — 기기 간 완료표시 동기화 */
     itemRef?: string;
+    /**
+     * **이 판에만** 거는 소음 설정 — 저장하지 않는다.
+     *
+     * 저장된 설정(`loadNoiseSettings`)을 불러와 병합한 **뒤에** 그 위에 덮는다. 함수로 주면
+     * 병합된 저장값을 받아 계산한다(저장된 `mainVolume` 에 맞춰 소음을 정할 때).
+     * 이 prop 이 있는 판에서는 판 중 툴팁으로 바꾼 것까지 **저장을 건너뛴다** — 고객의
+     * 저장된 설정을 말없이 고치지 않도록. 마운트 때 한 번만 읽는다.
+     *
+     * 판에 실제로 걸린 값은 `NoiseSettingsStore.applied` 로 받는다.
+     */
+    noiseOverride?: Partial<CoreNoiseSettings> | ((saved: CoreNoiseSettings) => Partial<CoreNoiseSettings>);
     /** 훈련 결과 팝업 렌더러 — 없으면 결과 팝업을 표시하지 않음 */
     renderResultPopup?: (props: {
         score?: number | null;
@@ -7747,9 +7779,14 @@ export declare interface UseSoundCompassExamOptions {
  *     섞여, 2쪽의 더 이른 날짜가 1쪽으로 올라오지 않는다. 이 훅은 **이미 정렬된 줄**을
  *     받는다 — 차례를 거꾸로 쓰기 어렵게 만든 것이다.
  *
+ * 처음 개수는 `opts.initialPageSize` 로 준다(기본 '25'). **마운트 때만 읽는다** — 뒤에
+ * 바뀌어도 사용자가 고른 개수를 덮지 않는다. 마운트 뒤 `onChange('10')` 으로 맞추면
+ * 25줄이 한 번 그려졌다가 줄어드는 것이 보인다 — 그래서 처음 값으로 받는다.
+ * 옵션 목록에 없는 값이면 '25' 로 — 드롭다운이 빈 칸을 보이지 않게.
+ *
  * @public
  */
-export declare function useTablePaging<T>(rows: readonly T[], resetOn?: unknown): {
+export declare function useTablePaging<T>(rows: readonly T[], resetOn?: unknown, opts?: TablePagingOptions): {
     pageRows: T[];
     /** Toolbar 의 pageSize 자리에 그대로 넣는다 */
     pageSizeProps: {

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

@@ -1,5 +1,6 @@
 import { type ReactNode, type FC, type CSSProperties, type RefObject, type Dispatch, type SetStateAction } from "react";
 import './TrainingPagePopup.css';
+import { type CoreNoiseSettings } from './NoisePlayerContext';
 import { Page, ListenStep, ConfirmStep, ConfirmWithTextStep, OrderListStep, CardStep, CardOrderStep } from './TrainingStepComponents';
 /** @public */
 export type { ScenarioPage, ScenarioStep, FlowState } from './trainingScenario';
@@ -66,6 +67,17 @@ export type TrainingPagePopupProps = {
     dailyTotal?: number;
     /** 완료 정본의 항목 식별자(item_ref) — 기기 간 완료표시 동기화 */
     itemRef?: string;
+    /**
+     * **이 판에만** 거는 소음 설정 — 저장하지 않는다.
+     *
+     * 저장된 설정(`loadNoiseSettings`)을 불러와 병합한 **뒤에** 그 위에 덮는다. 함수로 주면
+     * 병합된 저장값을 받아 계산한다(저장된 `mainVolume` 에 맞춰 소음을 정할 때).
+     * 이 prop 이 있는 판에서는 판 중 툴팁으로 바꾼 것까지 **저장을 건너뛴다** — 고객의
+     * 저장된 설정을 말없이 고치지 않도록. 마운트 때 한 번만 읽는다.
+     *
+     * 판에 실제로 걸린 값은 `NoiseSettingsStore.applied` 로 받는다.
+     */
+    noiseOverride?: Partial<CoreNoiseSettings> | ((saved: CoreNoiseSettings) => Partial<CoreNoiseSettings>);
     /** 훈련 결과 팝업 렌더러 — 없으면 결과 팝업을 표시하지 않음 */
     renderResultPopup?: (props: {
         score?: number | null;

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

@@ -23,14 +23,14 @@ import TrainingResultPopup from '../Popup/TrainingResultPopup';
 import useTrainingSessionLog from '../../hooks/useTrainingSessionLog';
 import { logTrainingCompletion } from '../../utils/trainingLogger';
 import { toItemResults } from '../../utils/trainingItemResults';
-import { loadNoiseSettings, saveNoiseSettings } from '../../utils/noiseSettingsStore';
+import { loadNoiseSettings, saveNoiseSettings, reportAppliedNoiseSettings } from '../../utils/noiseSettingsStore';
 // 문장 4종은 각 PagePopup 래퍼에서 useTrainingSessionLog로 이미 기록 → 베이스에서 중복 방지
 const SENTENCE_TIME_LOGGED_TYPES = new Set(['LISTEN_IN_NOISE', 'SHORT_STORY', 'LONG_STORY', 'ORDERING_SENTENCE']);
 // renderResultPopup 미지정 시 기본 결과 팝업 — 모든 훈련 타입 공통 폴백
 const defaultRenderResult = (p) => _jsx(TrainingResultPopup, { score: p.score, contextsLength: p.contextsLength, results: p.results, onReplay: p.onReplay, onClose: p.onClose });
 import { getScenarioPageId, getScenarioStepKey, createScenarioFlowState, resolveScenarioStepProps, } from './trainingScenario';
 function TrainingPagePopupInner(props) {
-    const { scenario, title, subTitle, depth, icon, wrapperStyle, iconTooltip, pageIndex, pageCount, stepIndex, stepCount, onBack, onComplete, onNext, onSettings, useNoiseSetting = true, children, ariaLabel, label, buildResults, onResult: externalOnResultProp, typeKey, entryPoint, dailyTotal, itemRef, renderResultPopup, } = props;
+    const { scenario, title, subTitle, depth, icon, wrapperStyle, iconTooltip, pageIndex, pageCount, stepIndex, stepCount, onBack, onComplete, onNext, onSettings, useNoiseSetting = true, children, ariaLabel, label, buildResults, onResult: externalOnResultProp, typeKey, entryPoint, dailyTotal, itemRef, renderResultPopup, noiseOverride, } = props;
     // 시간 기록 — 문장 4종은 각 래퍼(useTrainingSessionLog)에서 기록하므로 제외, 그 외(단어 등) 공통 기록
     useTrainingSessionLog(typeKey && !SENTENCE_TIME_LOGGED_TYPES.has(typeKey) ? typeKey : '');
     // 팝업 진입 시각 — 완료 정본의 소요 시간 계산 (마운트 시 1회만 effect에서 초기화)
@@ -119,6 +119,9 @@ function TrainingPagePopupInner(props) {
     // 최신 설정 미러(setSettings에서 머지·저장 시 참조 — 상태 업데이터 내 부수효과 회피)
     const noiseSettingsRef = useRef(noiseSettings);
     useEffect(() => { noiseSettingsRef.current = noiseSettings; }, [noiseSettings]);
+    // 이 판에만 거는 설정 — 마운트 때 한 번 붙잡는다(부모가 매 렌더 새 함수를 넘겨도 다시 걸지 않게).
+    // 있으면 이 판은 저장을 건너뛴다(mergeAndSaveSettings 참고).
+    const noiseOverrideRef = useRef(noiseOverride);
     // 계정/고객 저장소에서 초기값 로드 (앱이 configureNoiseSettingsStore로 주입)
     useEffect(() => {
         let cancelled = false;
@@ -129,6 +132,16 @@ function TrainingPagePopupInner(props) {
             const merged = saved ? { ...noiseSettingsRef.current, ...saved } : { ...DEFAULT_NOISE_SETTINGS };
             noiseSettingsRef.current = merged;
             setNoisePart(merged);
+            reportAppliedNoiseSettings(merged);
+            // override 는 병합이 끝난 **뒤에** 덮는다 — 로드가 늦게 와도 override 가 이긴다.
+            const override = noiseOverrideRef.current;
+            if (override) {
+                const patch = typeof override === 'function' ? override(merged) : override;
+                const applied = { ...merged, ...patch };
+                noiseSettingsRef.current = applied;
+                setNoisePart(applied);
+                reportAppliedNoiseSettings(applied);
+            }
         });
         return () => { cancelled = true; };
     }, []);
@@ -146,7 +159,10 @@ function TrainingPagePopupInner(props) {
         const merged = { ...noiseSettingsRef.current, ...next };
         noiseSettingsRef.current = merged;
         setNoisePart(merged);
-        saveNoiseSettings(merged);
+        // noiseOverride 판은 저장하지 않는다 — 판 중에 바꾼 것도 이 판에만.
+        if (!noiseOverrideRef.current)
+            saveNoiseSettings(merged);
+        reportAppliedNoiseSettings(merged);
     }, []);
     // 문장(메인) 재생 컨트롤 — 툴팁(하단 설정)과 오디오 플레이어가 공유. 계정 설정("훈련" 패널)의
     // 기본값과 동일한 noiseSettings(mainVolume/mainSpeed)에 함께 영속화된다.

package/dist/packages/core/src/hooks/useTablePaging.d.ts

@@ -1,3 +1,8 @@
+/** `useTablePaging` 의 셋째 인자. @public */
+export interface TablePagingOptions {
+    /** 처음 개수 보기 — `VAP_PAGE_SIZE_OPTIONS` 의 값('10'·'25'·'50'·'100'). 없거나 목록 밖이면 '25'. 마운트 때만 읽는다. */
+    initialPageSize?: string;
+}
 /**
  * 표의 쪽넘김 — 개수 보기 · 쪽 · 이번 쪽 줄.
  *
@@ -11,9 +16,14 @@
  *     섞여, 2쪽의 더 이른 날짜가 1쪽으로 올라오지 않는다. 이 훅은 **이미 정렬된 줄**을
  *     받는다 — 차례를 거꾸로 쓰기 어렵게 만든 것이다.
  *
+ * 처음 개수는 `opts.initialPageSize` 로 준다(기본 '25'). **마운트 때만 읽는다** — 뒤에
+ * 바뀌어도 사용자가 고른 개수를 덮지 않는다. 마운트 뒤 `onChange('10')` 으로 맞추면
+ * 25줄이 한 번 그려졌다가 줄어드는 것이 보인다 — 그래서 처음 값으로 받는다.
+ * 옵션 목록에 없는 값이면 '25' 로 — 드롭다운이 빈 칸을 보이지 않게.
+ *
  * @public
  */
-export declare function useTablePaging<T>(rows: readonly T[], resetOn?: unknown): {
+export declare function useTablePaging<T>(rows: readonly T[], resetOn?: unknown, opts?: TablePagingOptions): {
     pageRows: T[];
     /** Toolbar 의 pageSize 자리에 그대로 넣는다 */
     pageSizeProps: {

package/dist/packages/core/src/hooks/useTablePaging.js

@@ -15,11 +15,19 @@ import { VAP_PAGE_SIZE_OPTIONS } from './useVisitAllPanel';
  *     섞여, 2쪽의 더 이른 날짜가 1쪽으로 올라오지 않는다. 이 훅은 **이미 정렬된 줄**을
  *     받는다 — 차례를 거꾸로 쓰기 어렵게 만든 것이다.
  *
+ * 처음 개수는 `opts.initialPageSize` 로 준다(기본 '25'). **마운트 때만 읽는다** — 뒤에
+ * 바뀌어도 사용자가 고른 개수를 덮지 않는다. 마운트 뒤 `onChange('10')` 으로 맞추면
+ * 25줄이 한 번 그려졌다가 줄어드는 것이 보인다 — 그래서 처음 값으로 받는다.
+ * 옵션 목록에 없는 값이면 '25' 로 — 드롭다운이 빈 칸을 보이지 않게.
+ *
  * @public
  */
-export function useTablePaging(rows, resetOn) {
+export function useTablePaging(rows, resetOn, opts) {
     const { t } = useTranslation();
-    const [pageSize, setPageSizeRaw] = useState('25');
+    const [pageSize, setPageSizeRaw] = useState(() => {
+        const 처음 = opts?.initialPageSize;
+        return 처음 && VAP_PAGE_SIZE_OPTIONS.some(o => o.value === 처음) ? 처음 : '25';
+    });
     const [page, setPage] = useState(1);
     /* 늘어놓는 차례가 바뀌면 첫 쪽으로 — 3쪽을 보던 중에 정렬하면 무엇이 위로 왔는지
        못 본다. 렌더 중에 되돌린다(저장소의 다른 곳들과 같은 꼴: 값이 바뀐 그 렌더에서

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

@@ -13,6 +13,15 @@ export interface NoiseSettingsStore {
     load: () => Promise<Partial<CoreNoiseSettings> | null>;
     /** 현재 훈련 대상의 소음설정을 저장(fire-and-forget). */
     save: (settings: CoreNoiseSettings) => Promise<void> | void;
+    /**
+     * **판에 실제로 걸린 설정**이 정해지거나 바뀔 때마다 부른다 — 저장 병합 직후,
+     * `noiseOverride` 적용 직후, 판 중 변경마다. 선택.
+     *
+     * `save` 와 따로 두는 까닭: `noiseOverride` 가 걸린 판은 저장을 건너뛴다. 앱이 결과마다
+     * 그 판의 소음 조건을 함께 기록한다면 `save` 로는 그 값을 못 받는다 — 저장값으로
+     * 기록해 조건이 틀리게 남는다. 이 콜백은 저장 여부와 무관하게 늘 걸린 값을 준다.
+     */
+    applied?: (settings: CoreNoiseSettings) => void;
 }
 /** @public */
 export declare function configureNoiseSettingsStore(store: NoiseSettingsStore | null): void;
@@ -20,3 +29,8 @@ export declare function configureNoiseSettingsStore(store: NoiseSettingsStore |
 export declare function loadNoiseSettings(): Promise<Partial<CoreNoiseSettings> | null>;
 /** @public 소음설정 저장(fire-and-forget). */
 export declare function saveNoiseSettings(settings: CoreNoiseSettings): void;
+/**
+ * @public 판에 걸린 소음설정을 앱에 알린다(`NoiseSettingsStore.applied`). 없으면 아무 일도 안 한다.
+ * 알림이 실패해도 훈련은 이어진다 — `saveNoiseSettings` 와 같은 결로 삼킨다.
+ */
+export declare function reportAppliedNoiseSettings(settings: CoreNoiseSettings): void;

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

@@ -34,3 +34,16 @@ export function saveNoiseSettings(settings) {
         warn(e);
     }
 }
+/**
+ * @public 판에 걸린 소음설정을 앱에 알린다(`NoiseSettingsStore.applied`). 없으면 아무 일도 안 한다.
+ * 알림이 실패해도 훈련은 이어진다 — `saveNoiseSettings` 와 같은 결로 삼킨다.
+ */
+export function reportAppliedNoiseSettings(settings) {
+    try {
+        g.__ihabNoiseSettingsStore?.applied?.(settings);
+    }
+    catch (e) {
+        if (import.meta.env?.DEV)
+            console.warn('[noiseSettingsStore] applied', e);
+    }
+}

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

@@ -29,7 +29,7 @@ export type { TrainingItemResult } from './utils/trainingItemResults';
 export type { TrainingTimeLogEntry, CrosswordLogEntry, TrainingCompletionEntry } from './utils/trainingLogger';
 export { setGameScoreSubmitter, setGameRanksLoader, setGameLeaderboardLoader, submitGameScore, loadMyGameRanks, loadGameLeaderboard } from './utils/gameScoreLogger';
 export type { LeaderboardRow } from './utils/gameScoreLogger';
-export { configureNoiseSettingsStore, loadNoiseSettings, saveNoiseSettings } from './utils/noiseSettingsStore';
+export { configureNoiseSettingsStore, loadNoiseSettings, saveNoiseSettings, reportAppliedNoiseSettings } from './utils/noiseSettingsStore';
 export type { NoiseSettingsStore } from './utils/noiseSettingsStore';
 export type { TTSConfig } from './utils/ttsConfig';
 export { createTTSUrlResolver } from './utils/ttsResolver';

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

@@ -21,7 +21,7 @@ export { setTrainingTimeLogger, logTrainingTime, setCrosswordLogger, logCrosswor
 /* 문항별 결과 — 앱(useCoreLoggers)이 이걸 서버에 남긴다. 배럴에 없으면 코어 밖에서 못 쓴다 */
 export { toItemResults, wrongItems, itemCorrectness } from './utils/trainingItemResults';
 export { setGameScoreSubmitter, setGameRanksLoader, setGameLeaderboardLoader, submitGameScore, loadMyGameRanks, loadGameLeaderboard } from './utils/gameScoreLogger';
-export { configureNoiseSettingsStore, loadNoiseSettings, saveNoiseSettings } from './utils/noiseSettingsStore';
+export { configureNoiseSettingsStore, loadNoiseSettings, saveNoiseSettings, reportAppliedNoiseSettings } from './utils/noiseSettingsStore';
 export { createTTSUrlResolver } from './utils/ttsResolver';
 export { toStorageName, toBase64UrlSafe, officialSoundPath } from './utils/encoding';
 export { copyText } from './utils/clipboard';

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

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

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

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