@ihabdevteam/core 0.322.0 → 0.324.0

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

@@ -417,12 +417,12 @@ async function _buildUsablePool(opts) {
     let posContrastMap = null;
     if (posContrast) {
         const mapKey = _posContrastCacheKey(opts);
-        const 이미지집합 = excludeNoImage ? getImageOkWordSet() : null;
-        const 전 = _posContrastCache.get(mapKey);
-        posContrastMap = 전 && 전.이미지집합 === 이미지집합
-            ? 전.map
+        const imageOkSet = excludeNoImage ? getImageOkWordSet() : null;
+        const cached = _posContrastCache.get(mapKey);
+        posContrastMap = cached && cached.imageOkSet === imageOkSet
+            ? cached.map
             : buildMultiPartPosContrast(composition, allOkArr, decompOf, sameStructureOnly, phonemeView, pronOfWord);
-        _posContrastCache.set(mapKey, { 이미지집합, map: posContrastMap });
+        _posContrastCache.set(mapKey, { imageOkSet, map: posContrastMap });
     }
     // candidates 크기 제한 — 이미지 필터 이후이므로 okCandidates 기반
     const RANDOM_CAND_CAP = 500; // random: classifyPairDifficulty 없으나 루프 자체 제한
@@ -471,28 +471,28 @@ async function _buildUsablePool(opts) {
         else if (useRandomPool) {
             // 'random' 또는 null(difficulty:false 타입): 음운론적 제약은 없지만,
             // 정답과 오답의 음절수는 같아야 한다(단어 길이만으로 정답을 짐작하지 못하도록) — 본 단어와 다른 단어 + 음절수(글자수) 동일
-            const 쓸수있음 = (other) => other !== w.w && other.length === w.w.length && pronOfWord(other) !== wPron;
+            const canUse = (other) => other !== w.w && other.length === w.w.length && pronOfWord(other) !== wPron;
             /* 셈(fullCount — 가능 단어 수 안내)은 **서로 소리가 다른 오답이 보기 수 − 1 개** 있는지까지만 본다(countUsableWords 가 그
                기준으로 센다). 2.2만 후보마다 600개를 끝까지 걸러 칩 한 번에 300ms 넘게 멈췄다. */
             if (opts.fullCount) {
                 const need = Math.max(1, (opts.choicesPerItem ?? 3) - 1);
-                const 고름 = [];
-                const 소리 = new Set();
+                const picked = [];
+                const prons = new Set();
                 for (const other of distractorPool) {
-                    if (!쓸수있음(other))
+                    if (!canUse(other))
                         continue;
                     const p = pronOfWord(other);
-                    if (소리.has(p))
+                    if (prons.has(p))
                         continue;
-                    소리.add(p);
-                    고름.push(other);
-                    if (고름.length >= need)
+                    prons.add(p);
+                    picked.push(other);
+                    if (picked.length >= need)
                         break;
                 }
-                usable = 고름;
+                usable = picked;
             }
             else
-                usable = distractorPool.filter(쓸수있음);
+                usable = distractorPool.filter(canUse);
         }
         else {
             // cho/jung/jong: 발음 기반 pairIndex에서 해당 종류 대립쌍 조회(공용 엔진). 구조 필터는 후처리에서 일괄.

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

@@ -73,10 +73,10 @@ async function genIncluded(opts) {
         const syllables = [...pron]; // 한 글자 = 한 음절
         /* 음소를 골랐으면 **그 음소를 가진 음절**을 들려준다 — 전에는 아무 음절이나 골라 초성 ㄱ 을 골라도 '가방' 의 '방' 을
            들려주었다(고른 음소와 무관한 훈련). 들리는 음절(발음)에 그 음소가 없으면 전처럼 아무 음절. */
-        const 고른음절 = comp && primarySelPart(comp)
+        const pickedPart = comp && primarySelPart(comp)
             ? syllables.filter(s => { const p = parseSyllable(s); return !!p && syllMatchesComp(p, comp); })
             : [];
-        const targetSyllable = pickOne(고른음절.length ? 고른음절 : syllables);
+        const targetSyllable = pickOne(pickedPart.length ? pickedPart : syllables);
         if (!targetSyllable)
             continue;
         // 오답: targetSyllable이 발음에 포함되지 않고, 정답과 음절수(글자수)가 같으며, 발음이 다른 단어.
@@ -357,7 +357,7 @@ async function genMerge3Syll(opts) {
 }
 /* 탈락 문제의 '실단어' 집합 — '이미지 있는 단어만' 이면 이미지 있는 낱말로. 전에는 늘 전체 낱말이라, 이미지만 켠(앱 기본) 탈락 카드의
    정답·오답이 이미지 없는 낱말(관상 → 상·땅·탕)로 나와 글자를 숨긴 카드가 빈칸이 됐다. 음절 바꾸기와 같은 방식. */
-function 탈락낱말집합(opts) {
+function droppedWordSet(opts) {
     const all = MVP.map(w => w.w);
     return opts.excludeNoImage ? filterByCachedImage(all) : new Set(all);
 }
@@ -368,7 +368,7 @@ async function genDrop1From2Syll(opts) {
     // 편집기와 동일한 대립쌍 오답을 item에 심는다(공유 코어 buildDropContrastProblem).
     // 러너(WordManipulationTrainingPagePopup)가 preset distractors를 그대로 쓰므로 자동생성도 편집기 품질이 된다.
     const pronMap = getPronMap();
-    const wordSet = 탈락낱말집합(opts);
+    const wordSet = droppedWordSet(opts);
     const phonemeView = opts.phonemeView ?? 'char';
     const out = [];
     for (const e of shuffle(pool)) {
@@ -398,7 +398,7 @@ async function genDrop1From3Syll(opts) {
     const pool = (await buildUsablePool({ ...opts })).filter(e => e.word.s === 3);
     // 편집기와 동일한 대립쌍 오답을 item에 심는다(공유 코어 buildDropContrast3Problem).
     const pronMap = getPronMap();
-    const wordSet = 탈락낱말집합(opts);
+    const wordSet = droppedWordSet(opts);
     const phonemeView = opts.phonemeView ?? 'char';
     const out = [];
     for (const e of shuffle(pool)) {
@@ -436,7 +436,7 @@ async function genDropCompound(opts) {
     // 2음절 낱말은 1음절 조각 둘로만 나뉘어 합성어가 될 수 없다(buildDropCompoundProblem) — 3음절부터
     const pool = (await buildUsablePool({ ...opts })).filter(e => e.word.s >= 3);
     const pronMap = getPronMap();
-    const wordSet = 탈락낱말집합(opts);
+    const wordSet = droppedWordSet(opts);
     const phonemeView = opts.phonemeView ?? 'char';
     const out = [];
     for (const e of shuffle(pool)) {

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

@@ -4,7 +4,7 @@
  * 타입은 문자열이지만 서버에서는 **월·일이 null 로 오기도 한다**(연도만 적은 옛 기록). 그대로 끼우면 화면에
  * `2026.null.null` 이 찍혔고, 정렬 열쇠를 만들 때는 `null.padStart` 에서 표가 통째로 터졌다. 빈 값은 '' 로 다룬다.
  */
-type 칸값 = string | number | null | undefined;
+type CellValue = string | number | null | undefined;
 /**
  * 화면에 적을 착용일.
  *
@@ -18,7 +18,7 @@ type 칸값 = string | number | null | undefined;
  * `lang` 을 안 주면 **예전 그대로** 점 꼴이다(`2026.09.09`) — 부르는 자리가 말을 모르는 곳도 있을
  * 수 있어 깨지지 않게 둔다. 화면에 그리는 자리는 주는 쪽이 맞다.
  */
-export declare function formatWornDate(year: 칸값, month: 칸값, day: 칸값, lang?: string): string;
+export declare function formatWornDate(year: CellValue, month: CellValue, day: CellValue, lang?: string): string;
 /** 착용일 정렬 열쇠 — 자리수를 채워(`2026-05-02`) 글자 비교가 날짜 차례와 같게. 연도가 없으면 ''. */
-export declare function wornDateSortKey(year: 칸값, month: 칸값, day: 칸값): string;
+export declare function wornDateSortKey(year: CellValue, month: CellValue, day: CellValue): string;
 export {};

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

@@ -1,5 +1,5 @@
 import { formatDateLocale } from './date';
-const 글자 = (v) => (v == null ? '' : String(v).trim());
+const text = (v) => (v == null ? '' : String(v).trim());
 /**
  * 화면에 적을 착용일.
  *
@@ -14,7 +14,7 @@ const 글자 = (v) => (v == null ? '' : String(v).trim());
  * 수 있어 깨지지 않게 둔다. 화면에 그리는 자리는 주는 쪽이 맞다.
  */
 export function formatWornDate(year, month, day, lang) {
-    const y = 글자(year), m = 글자(month), d = 글자(day);
+    const y = text(year), m = text(month), d = text(day);
     if (lang && y && m && d) {
         /* 자리수를 채워 ISO 로 만든다 — `formatDateLocale` 이 읽는 꼴. */
         const iso = `${y.padStart(4, '0')}-${m.padStart(2, '0')}-${d.padStart(2, '0')}`;
@@ -28,23 +28,23 @@ export function formatWornDate(year, month, day, lang) {
          * *이 가름은 못이 안 울어서 찾았다* — `&& m && d` 조건만 깨뜨려 봤을 때는 조용했다(그때는
          * `2026-00-00` 이 **못 읽는 날짜**라 저절로 떨어졌다). 못이 안 울면 **무엇이 막고 있나**를 묻는다.
          */
-        const 날 = new Date(iso);
-        const 되돌아옴 = !Number.isNaN(날.getTime()) && 날.toISOString().slice(0, 10) === iso;
-        if (되돌아옴) {
-            const 말대로 = formatDateLocale(iso, lang);
-            if (말대로)
-                return 말대로;
+        const date = new Date(iso);
+        const roundTrips = !Number.isNaN(date.getTime()) && date.toISOString().slice(0, 10) === iso;
+        if (roundTrips) {
+            const localized = formatDateLocale(iso, lang);
+            if (localized)
+                return localized;
         }
     }
-    const 조각 = [y, m, d];
-    while (조각.length > 0 && 조각[조각.length - 1] === '')
-        조각.pop();
-    return 조각.join('.');
+    const parts = [y, m, d];
+    while (parts.length > 0 && parts[parts.length - 1] === '')
+        parts.pop();
+    return parts.join('.');
 }
 /** 착용일 정렬 열쇠 — 자리수를 채워(`2026-05-02`) 글자 비교가 날짜 차례와 같게. 연도가 없으면 ''. */
 export function wornDateSortKey(year, month, day) {
-    const y = 글자(year);
+    const y = text(year);
     if (!y)
         return '';
-    return `${y}-${글자(month).padStart(2, '0')}-${글자(day).padStart(2, '0')}`;
+    return `${y}-${text(month).padStart(2, '0')}-${text(day).padStart(2, '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.322.0";
+export declare const CORE_VERSION = "0.324.0";

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

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