@ihabdevteam/core 0.8.0

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

@@ -0,0 +1,33 @@
+/**
+ * 문자열을 UTF-8 바이트로 인코딩 후 소문자 hex 문자열로 반환.
+ * 스토리지 파일명에 사용 — hex는 단일 케이스(0-9a-f)라 대소문자를 구분하지 않는
+ * 파일시스템(macOS APFS 등)에서도 절대 충돌하지 않는다.
+ *   가  →  eab080
+ * @public
+ */
+export function toStorageName(text) {
+    const bytes = new TextEncoder().encode(String(text));
+    let hex = '';
+    bytes.forEach(b => { hex += b.toString(16).padStart(2, '0'); });
+    return hex;
+}
+/**
+ * @deprecated 대소문자 충돌 위험으로 사용 중단. 스토리지 파일명은 {@link toStorageName}(hex) 사용.
+ * 외부 호환을 위해 별칭만 유지한다.
+ * @public
+ */
+export const toBase64UrlSafe = toStorageName;
+/**
+ * @public 정식 음원이 저장소에 놓이는 자리.
+ *
+ * `{목소리}/{표준발음을 hex 로}.mp3` — 어드민(검수 화면)과 회원 앱(재생)이 **같은 자리를
+ * 가리켜야 한다**. 다르면 어드민에서는 "있다"고 보이는데 회원 앱에서는 안 나오는(또는 그
+ * 반대) 상태가 되고, 그건 파일이 없는 것과 구별되지 않는다.
+ *
+ * 실시간 합성이 만들어 두는 `{목소리}/auto/…` 캐시는 여기 해당하지 않는다 — 그건
+ * '아직 없어서 임시로 만든 것'이라, 정식 음원과 같은 자리로 세면 채워야 할 낱말이
+ * 채워진 것처럼 보인다.
+ */
+export function officialSoundPath(voiceType, pronunciation) {
+    return `${voiceType}/${toStorageName(pronunciation)}.mp3`;
+}

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

@@ -0,0 +1,44 @@
+/**
+ * 잡은 값에서 **사람이 읽을 수 있는 원인**을 꺼낸다.
+ *
+ * 이 앱이 잡는 오류의 대부분은 `Error` 가 **아니다**. supabase-js 는
+ * `{ message, code, details, hint }` 꼴의 평범한 객체를 주고, 훅들은 그것을
+ * `if (error) throw error` 로 그대로 던진다(라이브에 잘못된 키로 요청해 실증:
+ * `{ message: 'Invalid API key', hint: … }` 가 왔고 `instanceof Error` 는 false 였다).
+ *
+ * 그래서 `e instanceof Error ? e.message : String(e)` 라고 적으면 원인 자리에
+ * **`[object Object]`** 가 찍힌다. 화면에도, 운영 오류 기록에도. 그 관용구가 저장소
+ * 곳곳에 흩어져 있어 여기 한 벌로 모은다.
+ *
+ * 문자열도 그대로 쓴다 — `throw '문구'` 로 던지는 자리가 있다. 끝내 못 읽는
+ * 값(숫자·null·빈 객체·빈 문구)일 때만 fallback 을 쓴다.
+ *
+ * 회원 앱은 `src/libs/errorUtils.ts` 가 이것을 다시 내보낸다 — 한 벌만 둔다.
+ * @public
+ */
+export declare function getErrorMessage(e: unknown, fallback?: string): string;
+/**
+ * 사용자에게 보여줄 네트워크 실패 안내.
+ *
+ * 같은 문구가 회원 앱(`src/libs/errorUtils.ts`)과 어드민(`admin/src/libs/rpc.ts`)에
+ * 한 벌씩 따로 적혀 있었다 — 어드민 주석이 "본 앱은 libs/errorUtils.toUserErrorMessage
+ * 로 같은 처리를 한다"고 스스로 적어 둘 만큼 대놓고 겹쳤다. 여기 한 벌만 둔다.
+ * @public
+ */
+export declare const NETWORK_ERROR_MESSAGE = "\uB124\uD2B8\uC6CC\uD06C \uC5F0\uACB0\uC774 \uBD88\uC548\uC815\uD569\uB2C8\uB2E4. \uC5F0\uACB0 \uC0C1\uD0DC\uB97C \uD655\uC778\uD55C \uB4A4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694.";
+/**
+ * supabase-js 가 감싼 네트워크 실패 메시지인지 판별.
+ *
+ * supabase-js 는 fetch 거부를 **던지지 않고** `{ error: { message: 'TypeError: Failed
+ * to fetch' } }` 로 돌려준다. 그대로 화면에 내보내면 사용자가 영문 예외 이름을 본다.
+ * 브라우저마다 문구가 달라 함께 매칭한다(Chrome "Failed to fetch", Safari "Load failed",
+ * Firefox "NetworkError when attempting to fetch").
+ * @public
+ */
+export declare function isNetworkErrorMessage(msg: string | null | undefined): boolean;
+/**
+ * 네트워크 실패면 사용자 문구로, 아니면 원문 그대로.
+ * 서버가 준 안내(한도 초과 등)는 살린다.
+ * @public
+ */
+export declare function toUserErrorMessage(msg: string): string;

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

@@ -0,0 +1,63 @@
+/**
+ * 잡은 값에서 **사람이 읽을 수 있는 원인**을 꺼낸다.
+ *
+ * 이 앱이 잡는 오류의 대부분은 `Error` 가 **아니다**. supabase-js 는
+ * `{ message, code, details, hint }` 꼴의 평범한 객체를 주고, 훅들은 그것을
+ * `if (error) throw error` 로 그대로 던진다(라이브에 잘못된 키로 요청해 실증:
+ * `{ message: 'Invalid API key', hint: … }` 가 왔고 `instanceof Error` 는 false 였다).
+ *
+ * 그래서 `e instanceof Error ? e.message : String(e)` 라고 적으면 원인 자리에
+ * **`[object Object]`** 가 찍힌다. 화면에도, 운영 오류 기록에도. 그 관용구가 저장소
+ * 곳곳에 흩어져 있어 여기 한 벌로 모은다.
+ *
+ * 문자열도 그대로 쓴다 — `throw '문구'` 로 던지는 자리가 있다. 끝내 못 읽는
+ * 값(숫자·null·빈 객체·빈 문구)일 때만 fallback 을 쓴다.
+ *
+ * 회원 앱은 `src/libs/errorUtils.ts` 가 이것을 다시 내보낸다 — 한 벌만 둔다.
+ * @public
+ */
+export function getErrorMessage(e, fallback = '알 수 없는 오류') {
+    if (e instanceof Error)
+        return e.message || fallback;
+    if (typeof e === 'string')
+        return e || fallback;
+    if (e && typeof e === 'object') {
+        const o = e;
+        for (const v of [o.message, o.error_description, o.error]) {
+            if (typeof v === 'string' && v)
+                return v;
+        }
+    }
+    return fallback;
+}
+/**
+ * 사용자에게 보여줄 네트워크 실패 안내.
+ *
+ * 같은 문구가 회원 앱(`src/libs/errorUtils.ts`)과 어드민(`admin/src/libs/rpc.ts`)에
+ * 한 벌씩 따로 적혀 있었다 — 어드민 주석이 "본 앱은 libs/errorUtils.toUserErrorMessage
+ * 로 같은 처리를 한다"고 스스로 적어 둘 만큼 대놓고 겹쳤다. 여기 한 벌만 둔다.
+ * @public
+ */
+export const NETWORK_ERROR_MESSAGE = '네트워크 연결이 불안정합니다. 연결 상태를 확인한 뒤 다시 시도해 주세요.';
+/**
+ * supabase-js 가 감싼 네트워크 실패 메시지인지 판별.
+ *
+ * supabase-js 는 fetch 거부를 **던지지 않고** `{ error: { message: 'TypeError: Failed
+ * to fetch' } }` 로 돌려준다. 그대로 화면에 내보내면 사용자가 영문 예외 이름을 본다.
+ * 브라우저마다 문구가 달라 함께 매칭한다(Chrome "Failed to fetch", Safari "Load failed",
+ * Firefox "NetworkError when attempting to fetch").
+ * @public
+ */
+export function isNetworkErrorMessage(msg) {
+    if (!msg)
+        return false;
+    return /failed to fetch|load failed|networkerror|network request failed|fetcherror/i.test(msg);
+}
+/**
+ * 네트워크 실패면 사용자 문구로, 아니면 원문 그대로.
+ * 서버가 준 안내(한도 초과 등)는 살린다.
+ * @public
+ */
+export function toUserErrorMessage(msg) {
+    return isNetworkErrorMessage(msg) ? NETWORK_ERROR_MESSAGE : msg;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * 글자 크기(앱 전체) 유틸리티
+ * - 'medium' | 'large1' | 'large2' | 'large3'
+ * - localStorage 키: 'ihab_font_scale'
+ * - 적용: <html data-font-scale="medium|large1|large2|large3">
+ */
+export type FontScale = 'medium' | 'large1' | 'large2' | 'large3';
+export declare function getSavedFontScale(): FontScale;
+export declare function applyFontScale(scale: FontScale): void;
+export declare function initFontScale(): void;

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

@@ -0,0 +1,28 @@
+/**
+ * 글자 크기(앱 전체) 유틸리티
+ * - 'medium' | 'large1' | 'large2' | 'large3'
+ * - localStorage 키: 'ihab_font_scale'
+ * - 적용: <html data-font-scale="medium|large1|large2|large3">
+ */
+const STORAGE_KEY = 'ihab_font_scale';
+const DEFAULT = 'medium';
+const VALID = ['medium', 'large1', 'large2', 'large3'];
+export function getSavedFontScale() {
+    try {
+        const saved = localStorage.getItem(STORAGE_KEY);
+        if (VALID.includes(saved))
+            return saved;
+    }
+    catch { }
+    return DEFAULT;
+}
+export function applyFontScale(scale) {
+    try {
+        document.documentElement.setAttribute('data-font-scale', scale);
+        localStorage.setItem(STORAGE_KEY, scale);
+    }
+    catch { }
+}
+export function initFontScale() {
+    applyFontScale(getSavedFontScale());
+}

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

@@ -0,0 +1,48 @@
+/**
+ * 한국 연락처를 010-1234-5678 형식으로 정규화.
+ * 입력에 대시가 있든 없든, 어떤 포맷이든 처리.
+ */
+export declare function formatPhone(raw: string): string;
+/**
+ * 날짜를 앱 표준 형식 YYYY.MM.DD 로 정규화.
+ * 지원 입력: YYYYMMDD / YYYY-MM-DD / YYYY.MM.DD / ISO datetime 문자열
+ *
+ * **시각이 붙은 값(ISO datetime)은 KST 달력 날짜로 옮긴다.** 예전에는 앞 열 글자를
+ * 그대로 잘랐는데(`2026-08-19T16:00:00Z` → `2026.08.19`), 그건 UTC 날짜라 KST 자정~
+ * 아침 아홉 시 사이의 값이 전부 하루 전으로 보였다. 이 함수를 쓰는 곳이 전부 그랬다 —
+ * 회원의 문의 등록일, 고객 등록일. 날짜만 있는 값(YYYY-MM-DD)은 시각이 없으니
+ * 옮길 것도 없어 그대로 둔다.
+ */
+export declare function normalizeDate(input: string | null | undefined): string | undefined;
+/**
+ * 앱 표준 YYYY.MM.DD → DB용 YYYY-MM-DD 로 역변환.
+ * native date 컬럼에 쓸 때만 사용; text 컬럼은 그대로 저장 가능.
+ */
+export declare function dateToDb(app: string | null | undefined): string | undefined;
+/**
+ * 가격 표기 통일: 끝의 '원'을 앞 '₩'로 변환.
+ * 이미 ₩/$ 등 통화기호로 시작하면 그대로 둠. 숫자 표기는 손대지 않음.
+ * 예) "7,500원" → "₩7,500", "₩7,500" → "₩7,500"
+ */
+export declare function toWonSymbol(s?: string): string | undefined;
+/**
+ * "HH:MM" 시간 문자열을 로케일 라벨로 변환.
+ * ko: "9시 30분" (정각이면 "9시"), en: "09:30" — i18n 키 date.timeHM / date.timeH 사용.
+ * t 함수는 (key, params) => string 형태면 어떤 것이든 허용.
+ */
+export declare function formatTimeHM(time: string | null | undefined, t: (key: string, params?: Record<string, unknown>) => string): string;
+/**
+ * 숫자에 자릿수 구분을 넣는다 — 1234567 → "1,234,567".
+ *
+ * 인자 없는 `toLocaleString()` 은 **보는 사람의 브라우저 지역 설정**을 따른다. 한국·미국
+ * 설정에서는 우연히 같아서(둘 다 세 자리 콤마) 눈치채기 어렵지만, 인도 설정에서는
+ * "12,34,567" 로, 독일 설정에서는 "1.234.567" 로 나온다. 화면 문구는 우리가 정한
+ * 언어(ko/en)를 따르는데 숫자만 OS 설정을 따르면 한 화면 안에서 어긋난다.
+ *
+ * 'ko-KR' 로 못박는다. ko 와 en 은 자릿수 묶는 방식이 같아 두 언어 모두 옳게 나온다.
+ * (어드민은 libs/format.ts 의 formatNumber 가 같은 이유로 이미 그렇게 하고 있었다 —
+ *  코어에만 빠져 있었다.)
+ *
+ * 통화 기호나 단위는 붙이지 않는다. 부르는 쪽이 ₩·개·명 등을 알아서 붙인다.
+ */
+export declare function formatCount(n: number | null | undefined): string;

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

@@ -0,0 +1,122 @@
+/**
+ * 앱 경계 정규화 유틸
+ * DB → 앱 state: normalizeDate / formatPhone
+ * 앱 state → DB: dateToDb
+ */
+import { toKstYmd } from './date';
+/**
+ * 한국 연락처를 010-1234-5678 형식으로 정규화.
+ * 입력에 대시가 있든 없든, 어떤 포맷이든 처리.
+ */
+export function formatPhone(raw) {
+    const d = raw.replace(/\D/g, '').slice(0, 11);
+    if (d.startsWith('02')) {
+        if (d.length <= 2)
+            return d;
+        if (d.length <= 6)
+            return `${d.slice(0, 2)}-${d.slice(2)}`;
+        // 마지막 그룹은 항상 4자리로 고정하고 중간 그룹이 나머지를 흡수해야 한다.
+        // 중간을 항상 4자리(slice(2,6))로 고정하면 9자리 번호(02-XXX-XXXX)가
+        // 2-4-3(예: "02-1234-567")로 잘못 쪼개져 validatePhone의 끝 \d{4} 요건에서 탈락한다.
+        return `${d.slice(0, 2)}-${d.slice(2, d.length - 4)}-${d.slice(d.length - 4)}`;
+    }
+    if (d.length <= 3)
+        return d;
+    if (d.length <= 7)
+        return `${d.slice(0, 3)}-${d.slice(3)}`;
+    // 위 02 분기와 동일한 이유로, 10자리 구형 번호(011-XXX-XXXX 등)가
+    // 3-4-3(예: "011-2345-678")로 잘못 쪼개져 검증에서 탈락하지 않도록
+    // 끝 4자리를 먼저 고정하고 중간 그룹을 나머지 길이로 계산한다.
+    return `${d.slice(0, 3)}-${d.slice(3, d.length - 4)}-${d.slice(d.length - 4)}`;
+}
+/**
+ * 날짜를 앱 표준 형식 YYYY.MM.DD 로 정규화.
+ * 지원 입력: YYYYMMDD / YYYY-MM-DD / YYYY.MM.DD / ISO datetime 문자열
+ *
+ * **시각이 붙은 값(ISO datetime)은 KST 달력 날짜로 옮긴다.** 예전에는 앞 열 글자를
+ * 그대로 잘랐는데(`2026-08-19T16:00:00Z` → `2026.08.19`), 그건 UTC 날짜라 KST 자정~
+ * 아침 아홉 시 사이의 값이 전부 하루 전으로 보였다. 이 함수를 쓰는 곳이 전부 그랬다 —
+ * 회원의 문의 등록일, 고객 등록일. 날짜만 있는 값(YYYY-MM-DD)은 시각이 없으니
+ * 옮길 것도 없어 그대로 둔다.
+ */
+export function normalizeDate(input) {
+    if (!input)
+        return undefined;
+    if (/^\d{4}\.\d{2}\.\d{2}$/.test(input))
+        return input;
+    if (/^\d{8}$/.test(input))
+        return `${input.slice(0, 4)}.${input.slice(4, 6)}.${input.slice(6, 8)}`;
+    if (/^\d{4}-\d{2}-\d{2}$/.test(input))
+        return input.replace(/-/g, '.');
+    if (/^\d{4}-\d{2}-\d{2}T/.test(input)) {
+        const d = new Date(input);
+        if (isNaN(d.getTime()))
+            return undefined;
+        /* KST 날짜 만들기는 date.ts 의 toKstYmd 한 벌만 쓴다 — 같은 Intl 조합이 저장소
+           다섯 곳에 각자 적혀 있었고, 타임존이나 로케일을 고치는 날 한 곳만 고쳐 놓고
+           나머지가 옛 규칙으로 남는다. */
+        return toKstYmd(d).replace(/-/g, '.');
+    }
+    return undefined;
+}
+/**
+ * 앱 표준 YYYY.MM.DD → DB용 YYYY-MM-DD 로 역변환.
+ * native date 컬럼에 쓸 때만 사용; text 컬럼은 그대로 저장 가능.
+ */
+export function dateToDb(app) {
+    if (!app)
+        return undefined;
+    if (/^\d{4}\.\d{2}\.\d{2}$/.test(app))
+        return app.replace(/\./g, '-');
+    return app;
+}
+/**
+ * 가격 표기 통일: 끝의 '원'을 앞 '₩'로 변환.
+ * 이미 ₩/$ 등 통화기호로 시작하면 그대로 둠. 숫자 표기는 손대지 않음.
+ * 예) "7,500원" → "₩7,500", "₩7,500" → "₩7,500"
+ */
+export function toWonSymbol(s) {
+    if (!s)
+        return s;
+    const t = s.trim();
+    if (/^[₩$]/.test(t))
+        return t;
+    if (/원\s*$/.test(t))
+        return '₩' + t.replace(/\s*원\s*$/, '').trim();
+    return t;
+}
+/**
+ * "HH:MM" 시간 문자열을 로케일 라벨로 변환.
+ * ko: "9시 30분" (정각이면 "9시"), en: "09:30" — i18n 키 date.timeHM / date.timeH 사용.
+ * t 함수는 (key, params) => string 형태면 어떤 것이든 허용.
+ */
+export function formatTimeHM(time, t) {
+    if (!time)
+        return '-';
+    const m = /^(\d{1,2}):(\d{2})$/.exec(time.trim());
+    if (!m)
+        return time;
+    const h = Number(m[1]);
+    const min = Number(m[2]);
+    const hh = m[1].padStart(2, '0');
+    if (min === 0)
+        return t('date.timeH', { h, hh, mm: m[2] });
+    return t('date.timeHM', { h, hh, m: min, mm: m[2] });
+}
+/**
+ * 숫자에 자릿수 구분을 넣는다 — 1234567 → "1,234,567".
+ *
+ * 인자 없는 `toLocaleString()` 은 **보는 사람의 브라우저 지역 설정**을 따른다. 한국·미국
+ * 설정에서는 우연히 같아서(둘 다 세 자리 콤마) 눈치채기 어렵지만, 인도 설정에서는
+ * "12,34,567" 로, 독일 설정에서는 "1.234.567" 로 나온다. 화면 문구는 우리가 정한
+ * 언어(ko/en)를 따르는데 숫자만 OS 설정을 따르면 한 화면 안에서 어긋난다.
+ *
+ * 'ko-KR' 로 못박는다. ko 와 en 은 자릿수 묶는 방식이 같아 두 언어 모두 옳게 나온다.
+ * (어드민은 libs/format.ts 의 formatNumber 가 같은 이유로 이미 그렇게 하고 있었다 —
+ *  코어에만 빠져 있었다.)
+ *
+ * 통화 기호나 단위는 붙이지 않는다. 부르는 쪽이 ₩·개·명 등을 알아서 붙인다.
+ */
+export function formatCount(n) {
+    return (n ?? 0).toLocaleString('ko-KR');
+}

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

@@ -0,0 +1,48 @@
+/**
+ * 게임 점수 제출·순위 조회 — trainingLogger.ts 와 동일한 전역 주입 패턴.
+ * 앱(src)에서 set*Fn 으로 Supabase RPC 콜백을 등록하면
+ * core 컴포넌트들이 fire-and-forget 으로 호출합니다.
+ */
+type SubmitFn = (gameKey: string, score: number) => Promise<{
+    rank: number;
+    bestScore: number;
+} | null>;
+type LoadFn = () => Promise<Record<string, {
+    bestScore: number;
+    rank: number;
+}> | null>;
+/**
+ * 리더보드 한 줄.
+ *
+ * `displayName` 은 서버가 가린 표시명이다 — 이름이 있으면 `김*준`, 없으면 이메일
+ * 아이디로 `gi***`. 전체 이름도 이메일도 user_id 도 오지 않는다.
+ * 내 줄은 이름 없이 `isMe` 만 온다(화면에서 "나"로 갈아 끼운다).
+ * @public
+ */
+export interface LeaderboardRow {
+    rank: number;
+    displayName: string | null;
+    score: number;
+    isMe: boolean;
+}
+type LeaderboardFn = (gameKey: string, limit?: number) => Promise<LeaderboardRow[] | null>;
+/** @public */
+export declare function setGameScoreSubmitter(fn: SubmitFn): void;
+/** @public */
+export declare function setGameRanksLoader(fn: LoadFn): void;
+/** @public */
+export declare function setGameLeaderboardLoader(fn: LeaderboardFn): void;
+export declare function submitGameScore(gameKey: string, score: number): Promise<{
+    rank: number;
+    bestScore: number;
+} | null>;
+export declare function loadMyGameRanks(): Promise<Record<string, {
+    bestScore: number;
+    rank: number;
+}> | null>;
+/**
+ * 게임별 순위표. 주입되지 않았거나(앱 밖에서 렌더될 때) 실패하면 null —
+ * 화면은 순위표 없이 게임만 그대로 돌아간다.
+ */
+export declare function loadGameLeaderboard(gameKey: string, limit?: number): Promise<LeaderboardRow[] | null>;
+export {};

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

@@ -0,0 +1,42 @@
+/**
+ * 게임 점수 제출·순위 조회 — trainingLogger.ts 와 동일한 전역 주입 패턴.
+ * 앱(src)에서 set*Fn 으로 Supabase RPC 콜백을 등록하면
+ * core 컴포넌트들이 fire-and-forget 으로 호출합니다.
+ */
+let _submit = null;
+let _load = null;
+let _board = null;
+/** @public */
+export function setGameScoreSubmitter(fn) { _submit = fn; }
+/** @public */
+export function setGameRanksLoader(fn) { _load = fn; }
+/** @public */
+export function setGameLeaderboardLoader(fn) { _board = fn; }
+export async function submitGameScore(gameKey, score) {
+    try {
+        return await _submit?.(gameKey, score) ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function loadMyGameRanks() {
+    try {
+        return await _load?.() ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 게임별 순위표. 주입되지 않았거나(앱 밖에서 렌더될 때) 실패하면 null —
+ * 화면은 순위표 없이 게임만 그대로 돌아간다.
+ */
+export async function loadGameLeaderboard(gameKey, limit) {
+    try {
+        return await _board?.(gameKey, limit) ?? null;
+    }
+    catch {
+        return null;
+    }
+}

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

@@ -0,0 +1,61 @@
+/** @public */
+export declare const NOISE_DATAS: unknown[];
+/** @public */
+export declare const SHORT_STORIES: unknown[];
+/** @public */
+export declare const LONG_STORIES: unknown[];
+/** @public */
+export declare const ORDER_SETS: unknown[];
+/** @public */
+export declare const TODAY_SETS: {
+    [k: string]: unknown[];
+};
+/** @public */
+export declare const YESTERDAY_SETS: {
+    [k: string]: unknown[];
+};
+/** @public */
+export type TrainingCounts = {
+    LISTEN_IN_NOISE?: number;
+    SHORT_STORY?: number;
+    LONG_STORY?: number;
+    ORDERING_SENTENCE?: number;
+};
+/** @public */
+export type ComputeDailySelectionOptions = {
+    counts?: TrainingCounts;
+    forceRefresh?: boolean;
+};
+/** @public */
+export declare function computeDailySelection({ counts, forceRefresh }?: ComputeDailySelectionOptions): {
+    today: {
+        [k: string]: unknown[];
+    };
+    yesterday: {
+        [k: string]: unknown[];
+    };
+};
+/** @public */
+export declare function getDailySelection(): {
+    today: {
+        [k: string]: unknown[];
+    };
+    yesterday: {
+        [k: string]: unknown[];
+    };
+};
+/** @public — 훈련 유형별 데이터 풀 매핑 반환 (반복 리터럴 방지용) */
+export declare function getTrainingPools(): Record<string, unknown[]>;
+export declare function loadTrainingData(): Promise<void>;
+/** @public */
+export declare function isTrainingDataLoaded(): boolean;
+export declare function ensureTrainingDataLoaded(timeout?: number): Promise<unknown>;
+declare const _default: {
+    NOISE_DATAS: unknown[];
+    SHORT_STORIES: unknown[];
+    LONG_STORIES: unknown[];
+    ORDER_SETS: unknown[];
+    loadTrainingData: typeof loadTrainingData;
+    ensureTrainingDataLoaded: typeof ensureTrainingDataLoaded;
+};
+export default _default;

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

@@ -0,0 +1,156 @@
+// Loader for allTrainingData.json — populates module-level arrays and dispatches update event
+import { sample as sampleArray } from './array';
+import { getTodayKst, toKstYmd } from './date';
+/** @public */
+export const NOISE_DATAS = [];
+/** @public */
+export const SHORT_STORIES = [];
+/** @public */
+export const LONG_STORIES = [];
+/** @public */
+export const ORDER_SETS = [];
+/** @public */
+export const TODAY_SETS = { LISTEN_IN_NOISE: [], SHORT_STORY: [], LONG_STORY: [], ORDERING_SENTENCE: [] };
+/** @public */
+export const YESTERDAY_SETS = { LISTEN_IN_NOISE: [], SHORT_STORY: [], LONG_STORY: [], ORDERING_SENTENCE: [] };
+const DEFAULT_TRAINING_COUNTS = { LISTEN_IN_NOISE: 3, SHORT_STORY: 2, LONG_STORY: 1, ORDERING_SENTENCE: 2 };
+// Module-level cache: avoid using a specific localStorage key. Compare only date and counts.
+let _cachedCountsKey = null;
+let _cachedTodayDate = null;
+let _cachedSelection = null;
+/** @public */
+export function computeDailySelection({ counts, forceRefresh } = {}) {
+    const c = Object.assign({}, DEFAULT_TRAINING_COUNTS, counts || {});
+    // 오늘의 훈련은 KST 자정에 바뀌어야 한다 — UTC 날짜를 쓰면 오전 9시에 바뀐다
+    const today = getTodayKst();
+    const yesterday = toKstYmd(new Date(`${today}T00:00:00+09:00`).getTime() - 86400000);
+    const countsKey = JSON.stringify(c);
+    // Use in-memory cache: if cached date and countsKey match, return cached selection
+    if (!forceRefresh && _cachedTodayDate === today && _cachedCountsKey === countsKey && _cachedSelection) {
+        Object.assign(TODAY_SETS, _cachedSelection.today);
+        Object.assign(YESTERDAY_SETS, _cachedSelection.yesterday?.selection || { LISTEN_IN_NOISE: [], SHORT_STORY: [], LONG_STORY: [], ORDERING_SENTENCE: [] });
+        return { today: TODAY_SETS, yesterday: YESTERDAY_SETS };
+    }
+    const selectionToday = {
+        LISTEN_IN_NOISE: sampleArray(NOISE_DATAS, Math.max(0, Number(c.LISTEN_IN_NOISE) || 0)),
+        SHORT_STORY: sampleArray(SHORT_STORIES, Math.max(0, Number(c.SHORT_STORY) || 0)),
+        LONG_STORY: sampleArray(LONG_STORIES, Math.max(0, Number(c.LONG_STORY) || 0)),
+        ORDERING_SENTENCE: sampleArray(ORDER_SETS, Math.max(0, Number(c.ORDERING_SENTENCE) || 0)),
+    };
+    let selectionYesterday = null;
+    // We only compare dates+counts; if module cache has yesterday for same countsKey and yesterday date, reuse it
+    if (_cachedSelection && _cachedCountsKey === countsKey && _cachedSelection.yesterday && _cachedSelection.yesterday.date === yesterday) {
+        selectionYesterday = _cachedSelection.yesterday.selection;
+    }
+    if (!selectionYesterday)
+        selectionYesterday = {
+            LISTEN_IN_NOISE: sampleArray(NOISE_DATAS, Math.max(0, Number(c.LISTEN_IN_NOISE) || 0)),
+            SHORT_STORY: sampleArray(SHORT_STORIES, Math.max(0, Number(c.SHORT_STORY) || 0)),
+            LONG_STORY: sampleArray(LONG_STORIES, Math.max(0, Number(c.LONG_STORY) || 0)),
+            ORDERING_SENTENCE: sampleArray(ORDER_SETS, Math.max(0, Number(c.ORDERING_SENTENCE) || 0)),
+        };
+    Object.assign(TODAY_SETS, selectionToday);
+    Object.assign(YESTERDAY_SETS, selectionYesterday);
+    // update module-level cache (compare only date and countsKey)
+    _cachedTodayDate = today;
+    _cachedCountsKey = countsKey;
+    _cachedSelection = { today: selectionToday, yesterday: { date: yesterday, countsKey, selection: selectionYesterday } };
+    return { today: TODAY_SETS, yesterday: YESTERDAY_SETS };
+}
+/** @public */
+export function getDailySelection() { return { today: TODAY_SETS, yesterday: YESTERDAY_SETS }; }
+/** @public — 훈련 유형별 데이터 풀 매핑 반환 (반복 리터럴 방지용) */
+export function getTrainingPools() {
+    return {
+        LISTEN_IN_NOISE: NOISE_DATAS,
+        SHORT_STORY: SHORT_STORIES,
+        LONG_STORY: LONG_STORIES,
+        ORDERING_SENTENCE: ORDER_SETS,
+    };
+}
+let _loaded = false;
+let _loading = null;
+async function _fetchMap() {
+    try {
+        const base = (import.meta && import.meta.env && import.meta.env.BASE_URL) || '/';
+        const res = await fetch(`${base}data/allTrainingData.json`);
+        if (!res.ok)
+            return null;
+        return await res.json();
+    }
+    catch (e) {
+        return null;
+    }
+}
+export async function loadTrainingData() {
+    if (_loaded)
+        return;
+    if (_loading)
+        return _loading;
+    _loading = (async () => {
+        const map = await _fetchMap();
+        if (!map) {
+            _loading = null; // allow retry on next call
+            try {
+                window.dispatchEvent(new Event('speechear.data.error'));
+            }
+            catch (e) { }
+            return;
+        }
+        try {
+            for (const key of Object.keys(map || {})) {
+                const groups = map[key] || [];
+                for (const g of groups) {
+                    const gr = g;
+                    const t = String(gr.training_type || key);
+                    const cat0 = String(gr.category_main_code || gr.category_main || gr.category_0 || '');
+                    const cat1 = String(gr.category_sub_code || gr.category_sub || gr.category_1 || '');
+                    // Preserve original group structure from allTrainingData.json
+                    const groupObj = Object.assign({}, gr, { training_type: t, category_0: cat0, category_1: cat1 });
+                    if (t === 'LISTEN_IN_NOISE') {
+                        NOISE_DATAS.push(groupObj);
+                    }
+                    else if (t === 'SHORT_STORY') {
+                        SHORT_STORIES.push(groupObj);
+                    }
+                    else if (t === 'LONG_STORY') {
+                        LONG_STORIES.push(groupObj);
+                    }
+                    else if (t === 'ORDERING_SENTENCE') {
+                        ORDER_SETS.push(groupObj);
+                    }
+                }
+            }
+        }
+        catch (e) {
+            // 형식이 예상과 다르면(배포 사고·캐시 오염 등) 여기로 온다. 그냥 넘어가면 훈련
+            // 목록이 빈 채로 _loaded=true 가 되어 다시 시도하지도, 아래 error 이벤트를 쏘지도
+            // 않는다 — 폴백 UI 가 뜰 기회조차 없이 사용자는 빈 화면만 본다
+            // (실측: 구조가 다른 JSON 에서 isLoaded=true, errorEvent=false).
+            // fetch 실패와 같은 처리를 받게 한다: 재시도 허용 + error 이벤트.
+            _loading = null;
+            try {
+                window.dispatchEvent(new Event('speechear.data.error'));
+            }
+            catch { /* SSR 등 */ }
+            return;
+        }
+        try {
+            window.dispatchEvent(new Event('speechear.data.updated'));
+        }
+        catch (e) { }
+        try {
+            computeDailySelection();
+        }
+        catch (e) { }
+        _loaded = true;
+    })();
+    return _loading;
+}
+/** @public */
+export function isTrainingDataLoaded() { return _loaded; }
+export async function ensureTrainingDataLoaded(timeout = 3000) {
+    const p = loadTrainingData();
+    return Promise.race([p, new Promise((res) => setTimeout(res, timeout))]);
+}
+export default { NOISE_DATAS, SHORT_STORIES, LONG_STORIES, ORDER_SETS, loadTrainingData, ensureTrainingDataLoaded };