@ihabdevteam/core 0.153.0 → 0.155.0

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

@@ -5,8 +5,22 @@ import { logTrainingTime } from '../utils/trainingLogger';
  * 훈련 팝업을 **보고 있던** 시간을 기록합니다.
  * 보인 시간이 5초 미만(잘못 열었다 닫은 경우)이면 무시합니다.
  *
- * 한 팝업에 **한 줄** 만 보냅니다 — 떠날 때, 또는 페이지가 내려갈 때(pagehide: 팝업을 연 채 탭·앱을 닫음). 화면이 가려진
- * 동안(탭 전환·앱 백그라운드)의 시간은 빼고 모읍니다 — 전에는 연 채 3시간 잠가 둔 시간이 훈련 시간으로 적혔다.
+ * 화면이 가려진 동안(탭 전환·앱 백그라운드)의 시간은 빼고 모읍니다 — 전에는 연 채 3시간
+ * 잠가 둔 시간이 훈련 시간으로 적혔다.
+ *
+ * **언제 보내는가**(사용자 결정 2026-09-16):
+ * - 떠날 때(팝업을 닫아 훅이 걷힐 때) 또는 페이지가 내려갈 때(pagehide).
+ * - **숨길 때도**(visibilitychange → hidden) 아직 안 보냈으면 그때까지 모은 시간을 보낸다.
+ *   모바일에서 팝업을 연 채 앱을 스와이프로 닫으면 pagehide 가 안 오는 기기가 있어
+ *   (visibilitychange 는 온다) 그 판의 시간이 통째로 사라졌다.
+ * - 보낸 뒤 돌아와 시간이 더 쌓이면 떠날 때 **더 쌓인 만큼만** 한 줄 더 보낸다(0 이면 안 보냄).
+ *   두 줄은 시간이 겹치지 않아 서버가 합산하면 총합이 맞는다.
+ *
+ * 그래서 **숨기지 않고 그냥 닫는 평범한 흐름은 여전히 한 줄** 이다 — 보이는 구간마다 따로
+ * 보내면 서버가 줄 수를 세션 수로 세어(v_user_training_time_stats) 탭을 오갈 때마다 훈련
+ * 횟수가 늘었다(0.147 에서 고친 것). 줄이 둘 이상 나오는 건 실제로 앱이 내려갈 뻔한 판뿐이다.
+ *
+ * 말귀(소비자) 할 일: 서버가 같은 판의 여러 줄을 **합산** 하는지 확인해야 한다.
  *
  * @public
  */
@@ -14,13 +28,11 @@ export default function useTrainingSessionLog(trainingType) {
     useEffect(() => {
         if (!trainingType)
             return; // 타입 미상이면 기록하지 않음
-        /* **한 팝업 = 한 줄.** 보이는 구간마다 따로 보내면 서버가 줄 수를 세션 수로 세어(v_user_training_time_stats) 탭을 오갈 때마다
-           문장 훈련 횟수가 늘었다. 보이던 시간만 모아 두었다가 떠날 때(또는 페이지가 내려갈 때) 한 번 보낸다 — 끝 시각은 처음 보인 때 + 보인 시간. */
         const 보임 = () => typeof document === 'undefined' || document.visibilityState !== 'hidden';
         let 처음보임 = null;
         let 구간시작 = null;
         let 모은ms = 0;
-        let 보냄 = false;
+        let 보낸ms = 0; // 지금까지 줄로 내보낸 누계 — 다음 줄은 여기서부터 이어 붙인다
         const 구간열기 = () => { const t = Date.now(); if (처음보임 == null)
             처음보임 = t; if (구간시작 == null)
             구간시작 = t; };
@@ -30,23 +42,34 @@ export default function useTrainingSessionLog(trainingType) {
         } };
         if (보임())
             구간열기();
+        /* 아직 안 보낸 만큼을 한 줄로. 끝 시각은 처음 보인 때 + 모은 시간, 시작 시각은 앞 줄이
+           끝난 자리 — 줄끼리 겹치지 않으니 합산해도 이중으로 세지 않는다.
+           전달은 등록된 로거(logTrainingTime)로 간다. 코어는 보낼 주소를 모르므로
+           navigator.sendBeacon 을 여기서 직접 쓸 수 없다 — 앱이 등록하는 로거의 몫이다. */
         const 보내기 = () => {
-            if (보냄)
-                return;
             구간닫기();
-            if (처음보임 == null || 모은ms < 5000)
+            if (처음보임 == null)
+                return;
+            const 남은ms = 모은ms - 보낸ms;
+            if (남은ms <= 0)
+                return;
+            // 첫 줄에만 5초 문턱을 건다(잘못 열었다 닫은 판). 한 번 보낸 판은 이미 실재하는
+            // 훈련이라, 돌아와 더 한 시간은 짧아도 버리지 않는다.
+            if (보낸ms === 0 && 모은ms < 5000)
                 return;
-            보냄 = true;
+            const 시작ms = 처음보임 + 보낸ms;
+            보낸ms = 모은ms;
             logTrainingTime({
                 trainingType,
-                startedAt: new Date(처음보임).toISOString(),
+                startedAt: new Date(시작ms).toISOString(),
                 endedAt: new Date(처음보임 + 모은ms).toISOString(),
             });
         };
+        // 숨으면 보낸다(앱이 그대로 죽을 수 있다). 다시 보이면 이어서 모은다.
         const 보임바뀜 = () => { if (보임())
             구간열기();
         else
-            구간닫기(); };
+            보내기(); };
         if (typeof document !== 'undefined')
             document.addEventListener('visibilitychange', 보임바뀜);
         // 페이지가 내려가면(탭·앱 닫기) React 정리가 안 돈다 — 그때 보낸다

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

@@ -838,6 +838,11 @@
             "pronoun": "Pronoun",
             "auxVerb": "Auxiliary verb",
             "auxAdjective": "Auxiliary adjective"
+        },
+        "reorder": {
+            "moved": "Moved to position {{n}} of {{total}}",
+            "handle": "Reorder {{word}} (Alt + arrow keys)",
+            "hint": "Alt + ← → to reorder"
         }
     },
     "wordSearch": {

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

@@ -836,6 +836,11 @@
             "pronoun": "대명사",
             "auxVerb": "보조동사",
             "auxAdjective": "보조형용사"
+        },
+        "reorder": {
+            "moved": "{{total}}칸 가운데 {{n}}번째로 옮김",
+            "handle": "{{word}} 순서 바꾸기 (Alt + 화살표)",
+            "hint": "Alt + ← → 로 순서 바꾸기"
         }
     },
     "wordSearch": {

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

@@ -72,6 +72,7 @@ import GamepadIcon from 'lucide-react/dist/esm/icons/gamepad.mjs';
 import GavelIcon from 'lucide-react/dist/esm/icons/gavel.mjs';
 import GitMergeIcon from 'lucide-react/dist/esm/icons/git-merge.mjs';
 import GlobeIcon from 'lucide-react/dist/esm/icons/globe.mjs';
+import GripVerticalIcon from 'lucide-react/dist/esm/icons/grip-vertical.mjs';
 import HeadphonesIcon from 'lucide-react/dist/esm/icons/headphones.mjs';
 import HeartIcon from 'lucide-react/dist/esm/icons/heart.mjs';
 import HomeIcon from 'lucide-react/dist/esm/icons/home.mjs';
@@ -256,6 +257,7 @@ export const STATIC_LUCIDE_ICONS = {
     'gavel': GavelIcon,
     'git-merge': GitMergeIcon,
     'globe': GlobeIcon,
+    'grip-vertical': GripVerticalIcon,
     'headphones': HeadphonesIcon,
     'heart': HeartIcon,
     'home': HomeIcon,

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

@@ -5,6 +5,15 @@ export interface PlanFeatures {
     maxCustomers: number;
     visitWord: boolean;
     visitSentence: boolean;
+    /**
+     * 숙제내주기(쿠폰) — **노출 여부만** 말한다.
+     *
+     * 하루 몇 번 보낼 수 있는지는 `PLAN_LIMITS[tier].homeworkSendDaily` 가 정본이고,
+     * 어드민 요금제 비교표의 '숙제 보내기' 칸도 그 숫자로 그린다. 이 플래그는 그 숫자가
+     * 있는 티어에서 켜져 있어야 한다 — 전에는 mgr_free·lite·standard 가 하루 1·10·30회를
+     * 받으면서도 false 라, 같은 화면이 한 칸에서는 횟수를 말하고 옆 칸에서는 ✗ 를 말했다
+     * (사용자 결정 2026-09-16). 숫자를 고칠 때는 이 플래그도 같이 본다.
+     */
     homework: boolean;
     customerStats: boolean;
     managerCustomerSplit: boolean;
@@ -32,8 +41,26 @@ export interface PlanFeatures {
     sentenceTrainingView: boolean;
 }
 export declare const PLAN_FEATURES: Record<PlanTier, PlanFeatures>;
-/** 요금제 티어 순위 (높을수록 상위 요금제) */
+/**
+ * 요금제 티어 순위 — **같은 줄 안에서 견주는 값**이다(클수록 상위 요금제).
+ *
+ * 줄마다 자리를 갈라 둔다: 개인 줄 0~9, 매니저 줄 10~19. 전에는 한 자리에 섞여 있어
+ * (personal_standard 3 < mgr_free 4) 줄이 다른 두 티어의 순위 차가 무슨 뜻인지 읽을 수
+ * 없었다(사용자 결정 2026-09-16). 줄이 같은지는 `isManagerTier` 로 본다.
+ *
+ * 줄 사이의 크기 비교(매니저 줄이 개인 줄보다 큼)는 전과 같은 방향이라, 활성 구독 중
+ * 가장 높은 티어를 고르는 코드는 그대로 동작한다 — 다만 그런 비교는 "매니저 줄이
+ * 개인 줄보다 상위"라는 뜻이지 기능 수의 많고 적음이 아니다.
+ * 레거시 라이트(낱말·문장)는 서로 대등해 같은 자리를 쓴다.
+ */
 export declare const TIER_RANK: Record<PlanTier, number>;
+/**
+ * @public 티어가 매니저 줄(말귀매니저)인지. `none` 과 개인 줄(free·personal_standard)은 false.
+ *
+ * 요금제 비교표처럼 "이 칸은 매니저 플랜에만 있다" 를 그리는 곳이 티어 목록을 손으로
+ * 들고 있지 않도록 여기서 내준다 — 티어가 늘면 그 목록만 뒤처진다.
+ */
+export declare function isManagerTier(tier: PlanTier): boolean;
 /**
  * 요금제별 수량/횟수 제한.
  *

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

@@ -27,7 +27,7 @@ export const PLAN_FEATURES = {
     },
     // ── 매니저 플랜 ─────────────────────────────────────────────────
     mgr_free: {
-        maxCustomers: 5, visitWord: true, visitSentence: true, homework: false,
+        maxCustomers: 5, visitWord: true, visitSentence: true, homework: true,
         customerStats: false, managerCustomerSplit: false, managerManagement: false,
         sentenceTrainingSetting: false, wordTrainingSetting: false, myWordList: false,
         wordListShare: false, groupTrainingSetting: false, minimalPairSearch: true,
@@ -75,7 +75,7 @@ export const PLAN_FEATURES = {
         sentenceTrainingView: true,
     },
     lite: {
-        maxCustomers: 10, visitWord: true, visitSentence: true, homework: false,
+        maxCustomers: 10, visitWord: true, visitSentence: true, homework: true,
         customerStats: false, managerCustomerSplit: false, managerManagement: false,
         sentenceTrainingSetting: false, wordTrainingSetting: false, myWordList: false,
         wordListShare: false, groupTrainingSetting: false, minimalPairSearch: true,
@@ -87,7 +87,7 @@ export const PLAN_FEATURES = {
         sentenceTrainingView: true,
     },
     standard: {
-        maxCustomers: 30, visitWord: true, visitSentence: true, homework: false,
+        maxCustomers: 30, visitWord: true, visitSentence: true, homework: true,
         customerStats: false, managerCustomerSplit: false, managerManagement: false,
         sentenceTrainingSetting: true, wordTrainingSetting: true, myWordList: true,
         wordListShare: true, groupTrainingSetting: false, minimalPairSearch: true,
@@ -123,14 +123,44 @@ export const PLAN_FEATURES = {
         sentenceTrainingView: true,
     },
 };
-/** 요금제 티어 순위 (높을수록 상위 요금제) */
+/**
+ * 요금제 티어 순위 — **같은 줄 안에서 견주는 값**이다(클수록 상위 요금제).
+ *
+ * 줄마다 자리를 갈라 둔다: 개인 줄 0~9, 매니저 줄 10~19. 전에는 한 자리에 섞여 있어
+ * (personal_standard 3 < mgr_free 4) 줄이 다른 두 티어의 순위 차가 무슨 뜻인지 읽을 수
+ * 없었다(사용자 결정 2026-09-16). 줄이 같은지는 `isManagerTier` 로 본다.
+ *
+ * 줄 사이의 크기 비교(매니저 줄이 개인 줄보다 큼)는 전과 같은 방향이라, 활성 구독 중
+ * 가장 높은 티어를 고르는 코드는 그대로 동작한다 — 다만 그런 비교는 "매니저 줄이
+ * 개인 줄보다 상위"라는 뜻이지 기능 수의 많고 적음이 아니다.
+ * 레거시 라이트(낱말·문장)는 서로 대등해 같은 자리를 쓴다.
+ */
 export const TIER_RANK = {
+    // ── 개인 줄 ──
     none: 0,
-    free: 1, personal_standard: 3,
-    mgr_free: 4,
-    lite_word: 5, lite_sentence: 5, lite: 6,
-    standard: 7, pro: 8, enterprise: 9,
+    free: 1,
+    personal_standard: 2,
+    // ── 매니저 줄 ──
+    mgr_free: 10,
+    lite_word: 11, lite_sentence: 11,
+    lite: 12,
+    standard: 13,
+    pro: 14,
+    enterprise: 15,
 };
+/** 매니저 줄(말귀매니저) 티어들 — TIER_RANK 의 10번대와 같은 집합이다. */
+const MANAGER_TIERS = new Set([
+    'mgr_free', 'lite_word', 'lite_sentence', 'lite', 'standard', 'pro', 'enterprise',
+]);
+/**
+ * @public 티어가 매니저 줄(말귀매니저)인지. `none` 과 개인 줄(free·personal_standard)은 false.
+ *
+ * 요금제 비교표처럼 "이 칸은 매니저 플랜에만 있다" 를 그리는 곳이 티어 목록을 손으로
+ * 들고 있지 않도록 여기서 내준다 — 티어가 늘면 그 목록만 뒤처진다.
+ */
+export function isManagerTier(tier) {
+    return MANAGER_TIERS.has(tier);
+}
 /** @public 요금제 티어별 제한 (표시되지 않는 레거시 티어는 생략) */
 export const PLAN_LIMITS = {
     // ── 개인 ──

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

@@ -173,6 +173,25 @@ export function _poolCacheKey(opts) {
     // 요청한 보기 수를 무시한다(공개 API 라 앱 밖 호출자가 무엇을 넘길지 알 수 없다).
     return `${opts.difficulty ?? ''}|${chStr}|${compStr}|${opts.excludeNoImage ? '1' : '0'}|${opts.count ?? ''}|x${opts.contrastCount ?? 1}|${opts.fullCount ? 'F' : ''}|s${opts.sameStructureOnly === false ? '0' : '1'}|v${opts.phonemeView === 'pron' ? 'p' : 'c'}|g${gradeStr}|t${opts.targetSyllable ?? ''}|c${opts.choicesPerItem ?? ''}`;
 }
+/**
+ * 위치 대립 맵 캐시 — 칩 한 번에 **셈(fullCount)과 생성이 같은 맵을 따로** 만들었다.
+ *
+ * 맵은 재료(이미지 필터를 지난 낱말 전체)와 고른 음소·구조 조건만으로 정해지는 결정적인
+ * 값이고, 셈과 생성은 그 둘이 똑같다(fullCount 는 후보 샘플링 캡에만 관여한다). 그래서 둘이
+ * 나눠 쓴다 — 23,000 낱말에서 칩 한 번이 256ms → 93ms(사용자 결정 2026-09-16).
+ *
+ * 열쇠는 풀 캐시 열쇠에서 **맵과 무관한 것**(문제 수·보기 수·fullCount)만 뺀 것이다. 재료를
+ * 바꾸는 것(난이도·초성·구성·등급·기준 글자·이미지 제외)은 모두 열쇠에 남아 있어야 한다 —
+ * 하나라도 빠지면 다른 설정의 답을 그대로 돌려준다.
+ *
+ * 이미지 제외를 켠 경우엔 열쇠만으로 모자란다 — '이미지 있음' 캐시는 미리 데우는 동안 풀
+ * 참조가 그대로인 채로 자란다(셈과 생성 사이에도 자랄 수 있다). 그래서 맵을 만들 때 쓴
+ * 낱말 집합을 함께 들고 있다가, 그 집합이 갈리면 다시 만든다.
+ */
+const _posContrastCache = new Map();
+function _posContrastCacheKey(opts) {
+    return _poolCacheKey({ ...opts, count: undefined, choicesPerItem: undefined, fullCount: false });
+}
 /**
  * 기준 글자/난이도/이미지 조건을 모두 통과한 (본 단어 + 유효 distractor) 풀을 만든다.
  * @returns [{ word: 본단어, usable: 이미지 OK + 난이도 매칭 distractor 배열 }]
@@ -183,6 +202,7 @@ export async function buildUsablePool(opts) {
     const idx = getPairIndex();
     if (pool !== _cachePoolRef || idx !== _cacheIdxRef) {
         _poolCache.clear();
+        _posContrastCache.clear();
         _cachePoolRef = pool;
         _cacheIdxRef = idx;
     }
@@ -392,9 +412,17 @@ async function _buildUsablePool(opts) {
     const decompOf = createDecompCache(); // 호출당 새 캐시(이 생성 함수 스코프에 한정)
     // 위치 대립: 전체 풀에서 완전 사전계산(마스킹 템플릿 인덱스). 후보당 O(1) 조회.
     // 단일/다중 파트 모두 이 경로로 처리 — pairIndex 는 겹받침 단어(예: 값)를 누락하므로 의존하지 않는다.
-    const posContrastMap = posContrast
-        ? buildMultiPartPosContrast(composition, allOkArr, decompOf, sameStructureOnly, phonemeView, pronOfWord)
-        : null;
+    // 셈(fullCount)과 생성이 같은 맵을 쓴다(_posContrastCache) — 읽기만 하므로 공유해도 안전하다.
+    let posContrastMap = null;
+    if (posContrast) {
+        const mapKey = _posContrastCacheKey(opts);
+        const 이미지집합 = excludeNoImage ? getImageOkWordSet() : null;
+        const 전 = _posContrastCache.get(mapKey);
+        posContrastMap = 전 && 전.이미지집합 === 이미지집합
+            ? 전.map
+            : buildMultiPartPosContrast(composition, allOkArr, decompOf, sameStructureOnly, phonemeView, pronOfWord);
+        _posContrastCache.set(mapKey, { 이미지집합, map: posContrastMap });
+    }
     // candidates 크기 제한 — 이미지 필터 이후이므로 okCandidates 기반
     const RANDOM_CAND_CAP = 500; // random: classifyPairDifficulty 없으나 루프 자체 제한
     const OTHER_CAND_CAP = 1500; // cho/jung/jong: classifyPairDifficulty 호출이 있으므로 더 엄격히

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

@@ -53,6 +53,6 @@ export type { WordEntry } from './utils/phonemePairSearch';
 export { CAPABILITY, isValidQuestionWord, hasQuestionWordConstraint, isManualOnlyType } from './utils/wordTrainingRuntime';
 export { wordContainsChoseong, wordContainsJungseong, wordContainsJongseong, wordHasNoCoda, wordHasSyllableMatching, syllableLength } from './utils/koreanSyllable';
 export { isSyllablePattern, matchesSyllablePattern, validateSyllableSearchInput, patternToComposition, matchesWordQuery, searchAndRankWords } from './utils/koreanSyllable';
-export { PLAN_FEATURES, PLAN_LIMITS, TIER_RANK, getPlanTier, type PlanTier, type DataLevel, type PlanFeatures, type PlanLimits, } from './utils/planFeatures';
+export { PLAN_FEATURES, PLAN_LIMITS, TIER_RANK, getPlanTier, isManagerTier, type PlanTier, type DataLevel, type PlanFeatures, type PlanLimits, } from './utils/planFeatures';
 export { WORD_SUGGESTION_WEEKLY_QUOTA, WORD_SUGGESTION_ACCOUNT_LIMIT, WORD_SUGGESTION_EXISTING_ERROR, isThisWeekPick, } from './utils/wordSuggestionPolicy';
 export { CORE_VERSION } from './version';

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

@@ -39,7 +39,7 @@ export { isSyllablePattern, matchesSyllablePattern, validateSyllableSearchInput,
 /* 요금제 정의 — 회원앱과 말귀어드민이 둘 다 본다. 예전에는 회원앱(src/libs) 안에 있었고
    어드민이 '@app/libs/planFeatures' 로 끌어다 썼는데, 그 한 줄 때문에 어드민이 회원앱
    폴더 없이는 빌드되지 않았다. 값과 타입뿐이라 코어에 두는 게 맞다. */
-export { PLAN_FEATURES, PLAN_LIMITS, TIER_RANK, getPlanTier, } from './utils/planFeatures';
+export { PLAN_FEATURES, PLAN_LIMITS, TIER_RANK, getPlanTier, isManagerTier, } from './utils/planFeatures';
 /* 단어 제안 정책 — 요금제와 똑같은 까닭으로 여기 있다. 회원앱(단어 제안)과
    말귀어드민(단어 제안 관리)이 같은 숫자를 봐야 하는데, 한쪽 화면 폴더에 두면
    다른 쪽이 그 폴더 없이는 빌드되지 않는다. 값과 순수 함수뿐이다. */

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

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

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

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