@ihabdevteam/core 0.134.0 → 0.136.0

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

@@ -43,6 +43,10 @@ export function useTablePaging(rows, resetOn, opts) {
        대부분의 경우 빈 표가 된다 */
     const setPageSize = useCallback((v) => { setPageSizeRaw(v); setPage(1); }, []);
     const total = Math.max(1, Math.ceil(rows.length / Number(pageSize)));
+    /* 행이 줄어 범위를 넘으면 **상태도** 끝 쪽으로 맞춘다 — 보이는 쪽만 조이고 상태를 두면, 필터로 줄었다가 다시 늘 때 예전
+       5쪽으로 튀었다. 렌더 중에 맞춘다(위 resetOn 과 같은 꼴). */
+    if (page > total)
+        setPage(total);
     const 이쪽 = Math.min(page, total);
     const pageRows = useMemo(() => rows.slice((이쪽 - 1) * Number(pageSize), 이쪽 * Number(pageSize)), [rows, 이쪽, pageSize]);
     return {

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

@@ -1,5 +1,5 @@
 import { useState } from 'react';
-import { useEditableList } from './useEditableList';
+import { useEditableList, isSameEditableItem } from './useEditableList';
 /**
  * @public
  */
@@ -24,7 +24,7 @@ export function useVisitHistory(initialHistory = []) {
         closeSubPopup?.();
     };
     const handleVisitEditSave = () => {
-        commitEdit(prev => prev.map(v => v === selectedVisit ? editVisitForm : v), editVisitForm);
+        commitEdit(prev => prev.map(v => (selectedVisit != null && isSameEditableItem(v, selectedVisit)) ? editVisitForm : v), editVisitForm);
     };
     /** 외부(스케줄 훅 등)에서 방문이력에 항목을 추가할 때 사용 */
     const addVisit = (item) => {

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

@@ -1,7 +1,7 @@
 'use client';
 import { useCallback, useMemo, useState } from 'react';
 import { today } from './useVisitHistory';
-import { useEditableList } from './useEditableList';
+import { useEditableList, isSameEditableItem } from './useEditableList';
 /**
  * 차례를 정하는 열쇠 — **가까운 것이 위**.
  *
@@ -48,17 +48,18 @@ initialSchedule = []) {
         closeSubPopup?.();
     };
     const handleScheduleEditSave = () => {
-        commitEdit(prev => sortByDate(prev.map(v => v === selectedSchedule ? editScheduleForm : v)), editScheduleForm);
+        commitEdit(prev => sortByDate(prev.map(v => (selectedSchedule != null && isSameEditableItem(v, selectedSchedule)) ? editScheduleForm : v)), editScheduleForm);
     };
     const handleScheduleDelete = useCallback((item) => {
         remove(item);
     }, [remove]);
     const handleScheduleToVisit = useCallback((item) => {
-        addVisit({ year: item.year, month: item.month, day: item.day, hour: item.hour, minute: item.minute, memo: item.memo });
+        // id 도 넘긴다 — 빠지면 그 방문을 이어서 수정할 때 합성 키로 넘어가 서버가 행을 못 찾았다
+        addVisit({ year: item.year, month: item.month, day: item.day, hour: item.hour, minute: item.minute, memo: item.memo, ...(item.id != null ? { id: item.id } : {}) });
         remove(item);
     }, [addVisit, remove]);
     const handleScheduleNoVisit = useCallback((item) => {
-        setScheduleList(prev => prev.filter(v => v !== item));
+        setScheduleList(prev => prev.filter(v => !isSameEditableItem(v, item)));
         setNoShowList(prev => [item, ...prev]);
         setSelectedSchedule(null);
     }, [setScheduleList, setSelectedSchedule]);

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

@@ -23,26 +23,35 @@ import { useState, useEffect, useMemo } from 'react';
 export const meaningKey = (word, homonum) => `${word}:${homonum ?? 1}`;
 // 세션 동안 유지되는 메모리 캐시 — 페이지를 오가도 재조회하지 않는다
 const memCache = new Map();
+/* 받아 봤는데 뜻이 없던 열쇠 — 다시 묻지 않는다. 전에는 뜻 없는 낱말이 캐시에 안 남아 표를 다시 정렬하거나 쪽을
+   넘길 때마다 같은 낱말을 또 조회했다. (조회가 실패한 것은 여기 넣지 않는다 — 다음에 다시 받는다.) */
+const noMeaning = new Set();
 export function useWordMeanings(rows, fetchMeanings) {
     /* 캐시는 모듈 스코프 Map 이라 갱신이 렌더에 자동 반영되지 않는다 — 조회가 끝나면 이 값을
        올려 아래 스냅샷을 다시 계산시킨다(캐시 히트만으로 리렌더가 연쇄되지 않도록 분리). */
     const [fetched, setFetched] = useState(0);
     // rows 는 매 렌더 새 배열이라 의존성으로 쓸 수 없다 — 조회 키만 뽑아 문자열로 비교한다
-    const wantedKey = rows.map(r => meaningKey(r.word, r.homonum)).join('|');
+    // 차례는 조회와 무관하다 — 정렬해 두어야 같은 낱말들을 다시 정렬만 해도 새 조회로 보지 않는다
+    const wantedKey = Array.from(new Set(rows.map(r => meaningKey(r.word, r.homonum)))).sort().join('|');
     useEffect(() => {
         const wanted = wantedKey ? wantedKey.split('|') : [];
-        const missing = wanted.filter(k => !memCache.has(k));
+        const missing = wanted.filter(k => !memCache.has(k) && !noMeaning.has(k));
         if (missing.length === 0)
             return; // 전부 캐시에 있음 — 네트워크·상태 갱신 불필요
         let cancelled = false;
         const words = Array.from(new Set(missing.map(k => k.slice(0, k.lastIndexOf(':')))));
         void fetchMeanings(words).then(got => {
-            if (cancelled || got.length === 0)
-                return;
+            /* 받은 것은 **취소됐어도 캐시에 담는다** — 쪽을 빨리 넘기면 앞 조회가 취소되며 받은 결과까지 버려, 돌아오면 또
+               조회했다. 화면 갱신(setFetched)만 취소된 쪽에서 건너뛴다. */
             for (const row of got) {
                 if (row.Meaning)
                     memCache.set(meaningKey(row.Word, row.Homonum ?? undefined), row.Meaning);
             }
+            for (const k of missing)
+                if (!memCache.has(k))
+                    noMeaning.add(k);
+            if (cancelled || got.length === 0)
+                return;
             setFetched(v => v + 1);
         }).catch(() => {
             // 조회 함수가 약속을 어기고 거절해도(망 끊김 등) 처리되지 않은 거절로 새지 않게 삼킨다 —

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

@@ -376,6 +376,7 @@
         "listenButton": "Listen",
         "playSound": "Play Sound",
         "playAll": "Play All",
+        "selectInOrder": "Select the cards in the order you heard.",
         "stop": "Stop",
         "preview": "Preview",
         "next": "Next",
@@ -742,7 +743,8 @@
             "descriptionPlaceholder": "Enter a description for this word table.",
             "duplicateName": "This name is already in use.",
             "nameRequired": "Please enter a table name.",
-            "autoFillHint": " (Press Tab or Space to autofill)"
+            "autoFillHint": " (Press Tab or Space to autofill)",
+            "copyName": "{{name}} (copy)"
         },
         "loadTable": {
             "title": "Load Saved Word Table",

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

@@ -374,6 +374,7 @@
         "listenButton": "문장 듣기",
         "playSound": "소리 듣기",
         "playAll": "모두 듣기",
+        "selectInOrder": "들은 순서대로 카드를 선택하세요.",
         "stop": "정지",
         "preview": "미리 듣기",
         "next": "다음",
@@ -740,7 +741,8 @@
             "descriptionPlaceholder": "이 단어표에 대한 설명을 입력하세요.",
             "duplicateName": "이미 사용 중인 이름입니다.",
             "nameRequired": "표 이름을 입력해 주세요.",
-            "autoFillHint": " (Tab 또는 space 입력시 자동 입력)"
+            "autoFillHint": " (Tab 또는 space 입력시 자동 입력)",
+            "copyName": "{{name}} (복사)"
         },
         "loadTable": {
             "title": "저장된 단어 표 불러오기",

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

@@ -16,12 +16,24 @@
  * 영어로 보더라도 가리키는 날은 같아야 한다.
  */
 const KST = 'Asia/Seoul';
+/* 못 읽는 값(빈 문자열·깨진 날짜)이면 null — 아래 형식 함수들이 화면에 "Invalid Date" 를 그대로 내던 것을 빈 글자로 막는다
+   (같은 파일의 toKstYmd·formatYmd 는 이미 막고 있었다) */
+const 읽은날 = (iso) => {
+    const d = new Date(iso);
+    return Number.isNaN(d.getTime()) ? null : d;
+};
 export function formatDateKo(iso) {
-    return new Date(iso).toLocaleDateString('ko-KR', { timeZone: KST, year: 'numeric', month: 'short', day: 'numeric' });
+    const d = 읽은날(iso);
+    if (!d)
+        return '';
+    return d.toLocaleDateString('ko-KR', { timeZone: KST, year: 'numeric', month: 'short', day: 'numeric' });
 }
 /** "2024년 1월 15일 오후 03:30" (long month + time) */
 export function formatDateLongKo(iso) {
-    return new Date(iso).toLocaleString('ko-KR', {
+    const d = 읽은날(iso);
+    if (!d)
+        return '';
+    return d.toLocaleString('ko-KR', {
         timeZone: KST,
         year: 'numeric', month: 'long', day: 'numeric',
         hour: '2-digit', minute: '2-digit',
@@ -35,12 +47,18 @@ export function formatDateLongKo(iso) {
  */
 export function formatDateLocale(iso, lang) {
     const locale = lang.startsWith('ko') ? 'ko-KR' : 'en-US';
-    return new Date(iso).toLocaleDateString(locale, { timeZone: KST, year: 'numeric', month: 'short', day: 'numeric' });
+    const d = 읽은날(iso);
+    if (!d)
+        return '';
+    return d.toLocaleDateString(locale, { timeZone: KST, year: 'numeric', month: 'short', day: 'numeric' });
 }
 /** formatDateLongKo의 로케일 인식 버전 — en: "January 15, 2024, 03:30 PM" */
 export function formatDateLongLocale(iso, lang) {
     const locale = lang.startsWith('ko') ? 'ko-KR' : 'en-US';
-    return new Date(iso).toLocaleString(locale, {
+    const d = 읽은날(iso);
+    if (!d)
+        return '';
+    return d.toLocaleString(locale, {
         timeZone: KST,
         year: 'numeric', month: 'long', day: 'numeric',
         hour: '2-digit', minute: '2-digit',
@@ -48,7 +66,10 @@ export function formatDateLongLocale(iso, lang) {
 }
 /** "2024. 01. 15. 오후 03:30" (2-digit month + time) */
 export function formatDatetimeKo(iso) {
-    return new Date(iso).toLocaleString('ko-KR', {
+    const d = 읽은날(iso);
+    if (!d)
+        return '';
+    return d.toLocaleString('ko-KR', {
         timeZone: KST,
         year: 'numeric', month: '2-digit', day: '2-digit',
         hour: '2-digit', minute: '2-digit',

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

@@ -104,6 +104,9 @@ export async function loadTrainingData() {
             catch (e) { }
             return;
         }
+        /* 다 읽은 뒤에 한꺼번에 넣는다 — 도중에 형식 오류로 멈추면 이미 넣은 것이 남은 채 재시도가 또 넣어, 부를 때마다 풀에
+           중복이 쌓였다(하루 선택이 중복 문항을 뽑고 기기마다 세트가 달라짐). */
+        const 받음 = { noise: [], short: [], long: [], order: [] };
         try {
             for (const key of Object.keys(map || {})) {
                 const groups = map[key] || [];
@@ -115,16 +118,16 @@ export async function loadTrainingData() {
                     // 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);
+                        받음.noise.push(groupObj);
                     }
                     else if (t === 'SHORT_STORY') {
-                        SHORT_STORIES.push(groupObj);
+                        받음.short.push(groupObj);
                     }
                     else if (t === 'LONG_STORY') {
-                        LONG_STORIES.push(groupObj);
+                        받음.long.push(groupObj);
                     }
                     else if (t === 'ORDERING_SENTENCE') {
-                        ORDER_SETS.push(groupObj);
+                        받음.order.push(groupObj);
                     }
                 }
             }
@@ -142,6 +145,10 @@ export async function loadTrainingData() {
             catch { /* SSR 등 */ }
             return;
         }
+        NOISE_DATAS.push(...받음.noise);
+        SHORT_STORIES.push(...받음.short);
+        LONG_STORIES.push(...받음.long);
+        ORDER_SETS.push(...받음.order);
         try {
             window.dispatchEvent(new Event('speechear.data.updated'));
         }

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

@@ -60,13 +60,16 @@ export async function checkImageExists(word, homonum) {
         return false;
     // 타임아웃 없으면 HEAD 요청 하나가 응답 없이 걸릴 때 이 확인을 기다리는
     // 검색 버튼(이미지 있음 필터)이 영구 비활성화된다
+    /* **확인이 안 된 것은 캐시하지 않는다.** 망 끊김·타임아웃·5xx 까지 '이미지 없음' 으로 영구 저장해, 한 번 끊긴 단어는 망이
+       돌아와도 '이미지 있음' 필터에서 계속 빠졌다(ttsConfig.checkAudioExists 와 같게). 있음(2xx)·없음(4xx)만 담는다. */
     const p = fetch(url, { method: 'HEAD', signal: AbortSignal.timeout(8000) })
-        .then(res => res.ok)
-        .catch(() => false)
+        .then(res => (res.status >= 500 ? null : res.ok), () => null)
         .then(ok => {
+        inflight.delete(k);
+        if (ok === null)
+            return false;
         map[k] = ok;
         scheduleSave();
-        inflight.delete(k);
         return ok;
     });
     inflight.set(k, p);

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

@@ -1,3 +1,12 @@
+/* 목소리 목록을 기다리는 말 — 하나만 둔다. 전에는 기다리는 리스너가 부를 때마다 줄을 서고 stopSpeaking 이 치우지 못해,
+   `speak('하나'); speak('둘'); stopSpeaking()` 뒤 목소리가 뜨는 순간 멈췄던 말이 모두 나왔다. */
+let 기다림 = null;
+/** voiceschanged 가 끝내 안 오는 환경(목소리 없음)에서도 말은 건다 — 안 그러면 onEnd 가 영영 안 불렸다 */
+const 목소리기다림MS = 1500;
+function 기다림치우기() {
+    기다림?.치우기();
+    기다림 = null;
+}
 /** @public */
 export function speak(text, { onEnd, rate = 0.9 } = {}) {
     if (typeof window === 'undefined' || typeof SpeechSynthesisUtterance === 'undefined' || !('speechSynthesis' in window)) {
@@ -5,7 +14,9 @@ export function speak(text, { onEnd, rate = 0.9 } = {}) {
         return;
     }
     const synth = window.speechSynthesis;
+    기다림치우기();
     const doSpeak = () => {
+        기다림치우기();
         synth.cancel();
         const u = new SpeechSynthesisUtterance(text);
         const voices = synth.getVoices();
@@ -23,13 +34,22 @@ export function speak(text, { onEnd, rate = 0.9 } = {}) {
             : null;
         synth.speak(u);
     };
-    if (synth.getVoices().length > 0)
+    if (synth.getVoices().length > 0) {
         doSpeak();
-    else
-        synth.addEventListener('voiceschanged', doSpeak, { once: true });
+        return;
+    }
+    const 시계 = setTimeout(doSpeak, 목소리기다림MS);
+    synth.addEventListener('voiceschanged', doSpeak, { once: true });
+    기다림 = {
+        치우기: () => {
+            clearTimeout(시계);
+            synth.removeEventListener('voiceschanged', doSpeak);
+        },
+    };
 }
 /** @public */
 export function stopSpeaking() {
+    기다림치우기();
     if (typeof window !== 'undefined' && 'speechSynthesis' in window)
         window.speechSynthesis.cancel();
 }

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

@@ -33,6 +33,17 @@ export function 한글순(a, b) {
  * `?? ''` 로 채워 넘기던 것과 같은 뜻이다.
  */
 const 숫자글자 = /^-?\d+(\.\d+)?$/;
+/* 칸의 글자 비교는 **안의 숫자도 수로** 본다 — 숫자 칸끼리는 수로, 섞인 칸은 글자로 견주면 '9'<'10'(수)·'10'<'10분'(글자)·
+   '10분'<'9'(글자) 로 돌고 돌아, 같은 행을 들어온 차례만 바꿔도 정렬 결과가 달랐다. 수를 수로 읽는 콜레이터는
+   숫자끼리의 차례와 같은 쪽을 낸다. */
+const 칸콜레이터 = (() => {
+    let 것 = null;
+    return () => {
+        if (!것)
+            것 = new Intl.Collator('ko', { numeric: true });
+        return 것;
+    };
+})();
 export function 칸순(a, b) {
     /* NaN 은 숫자가 아닌 것으로 — a - b 가 NaN 이면 정렬 비교가 어긋나 줄이 뒤섞였다. 글자로 온 숫자('10'·'9')도
        둘 다 온전한 숫자면 숫자로 견준다(전에는 '10' 이 '9' 앞에 섰다). */
@@ -40,5 +51,5 @@ export function 칸순(a, b) {
     const na = 수(a), nb = 수(b);
     if (na !== null && nb !== null)
         return na - nb;
-    return 한글순(a == null ? '' : String(a), b == null ? '' : String(b));
+    return 칸콜레이터().compare(a == null ? '' : String(a), b == null ? '' : String(b));
 }

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

@@ -75,15 +75,17 @@ export async function checkAudioExists(word) {
         return audioExistsCache.get(url);
     // 타임아웃 없으면 HEAD 요청 하나가 응답 없이 걸릴 때 이 확인을 기다리는
     // 검색 버튼(음성 있음 필터)이 영구 비활성화된다
-    // 서버가 답을 준 경우(200/404)만 캐시에 남긴다. 네트워크 실패·타임아웃까지 캐시하면
-    // 한 번의 통신 끊김이 그 단어를 세션 내내 '음성 없음'으로 고정해, '음성 있음' 필터에서
-    // 통째로 빠진다. 실패는 지워서 다음 호출이 다시 물어보게 한다.
-    const promise = fetch(url, { method: 'HEAD', signal: AbortSignal.timeout(8000) })
-        .then(res => res.ok)
-        .catch(() => {
-        audioExistsCache.delete(url);
+    // 서버가 답을 준 경우(2xx/4xx)만 캐시에 남긴다. 네트워크 실패·타임아웃·5xx 까지 캐시하면
+    // 한 번의 통신 끊김·서버 장애가 그 단어를 세션 내내 '음성 없음'으로 고정해, '음성 있음' 필터에서
+    // 통째로 빠진다. 실패는 지워서 다음 호출이 다시 물어보게 한다 — 단 **이 요청이 담은 칸일 때만**:
+    // clearAudioExistsCache() 뒤 새로 담긴 확인을 늦게 끝난 옛 요청이 지우면 같은 주소를 또 묻는다.
+    const 확인안됨 = () => {
+        if (audioExistsCache.get(url) === promise)
+            audioExistsCache.delete(url);
         return false;
-    });
+    };
+    const promise = fetch(url, { method: 'HEAD', signal: AbortSignal.timeout(8000) })
+        .then(res => (res.status >= 500 ? 확인안됨() : res.ok), 확인안됨);
     audioExistsCache.set(url, promise);
     return promise;
 }

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

@@ -9,7 +9,7 @@ export declare function generateRuntimeItems(typeKey: WordTrainingTypeKey, opts?
  * 공통 조합을 백그라운드에서 사전 계산해 결과 캐시를 미리 채운다.
  * 이후 동일 조합으로 generateRuntimeItems 호출 시 즉시(<5ms) 반환.
  * fire-and-forget — 완료 여부에 관계없이 UI 블로킹 없음.
- * UI가 실제로 쓰는 difficulty(cap.difficulty→'count', 그 외 null)만 예열한다.
+ * UI가 실제로 쓰는 열쇠(count 5 · 난이도 'random'/'count' · 필터 기본값)로 예열한다.
  * (과거 대립종류 cho/jung/jong 예열은 UI 미사용이고 정작 count는 누락돼 첫 생성이 느렸음)
  */
 export declare function precomputeCommonCombinations(excludeNoImage: boolean): Promise<void>;

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

@@ -599,11 +599,14 @@ async function _generateRuntimeItems(typeKey, opts = {}) {
  * 공통 조합을 백그라운드에서 사전 계산해 결과 캐시를 미리 채운다.
  * 이후 동일 조합으로 generateRuntimeItems 호출 시 즉시(<5ms) 반환.
  * fire-and-forget — 완료 여부에 관계없이 UI 블로킹 없음.
- * UI가 실제로 쓰는 difficulty(cap.difficulty→'count', 그 외 null)만 예열한다.
+ * UI가 실제로 쓰는 열쇠(count 5 · 난이도 'random'/'count' · 필터 기본값)로 예열한다.
  * (과거 대립종류 cho/jung/jong 예열은 UI 미사용이고 정작 count는 누락돼 첫 생성이 느렸음)
  */
 export async function precomputeCommonCombinations(excludeNoImage) {
-    const difficulties = [null, 'count'];
+    /* **화면이 실제로 부르는 열쇠와 똑같이** 예열한다. 전에는 count:10 · 난이도 null/'count' 로 돌았는데 화면
+       (useWordTrainingDataGeneration)은 count:5 · 필터 기본 난이도 'random'(음소를 고르면 'count')으로 불러 캐시 열쇠가
+       달랐다 — 예열 계산을 전부 버리고 첫 생성이 다시 계산했다. */
+    const difficulties = ['random', 'count'];
     const types = Object.keys(CAPABILITY);
     let tick = 0;
     for (const diff of difficulties) {
@@ -611,9 +614,13 @@ export async function precomputeCommonCombinations(excludeNoImage) {
             const cap = CAPABILITY[t];
             generateRuntimeItems(t, {
                 difficulty: cap.difficulty ? diff : null,
-                choseong: null,
-                count: 10,
+                contrastCount: 1,
+                composition: null,
+                count: 5,
                 excludeNoImage,
+                sameStructureOnly: true,
+                phonemeView: 'char',
+                grade: null,
             }).catch(() => { });
             // 6 타입마다 마이크로태스크 양보 → 메인 스레드 프레임 블로킹 방지
             if (++tick % 6 === 0)

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

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

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

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