@ihabdevteam/core 0.8.0

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

@@ -0,0 +1,102 @@
+/**
+ * 단어훈련 필터의 **모형(model)** — 글자↔발음 선택 값과 음절 수를 다루는 순수 계층.
+ *
+ * useWordTrainingFilter.ts 가 680줄까지 불어 있었다. 훅 이름을 달고 있지만 실은 두
+ * 가지가 한 파일에 있었다 — (1) 자모·음소 클러스터와 그 사이 변환(React 를 전혀
+ * 쓰지 않는다), (2) 그 위에 얹힌 상태 훅과 화면 구역 만들기. 앞의 것만 여기로 옮겼다.
+ *
+ * **글자 그대로 옮겼다.** 한 줄도 고치지 않았고, 공개하던 이름은 훅 파일에서 그대로
+ * 다시 내보내므로 가져다 쓰는 쪽은 아무것도 바뀌지 않는다.
+ *
+ * 이 층이 하는 일은 하나다. 선택은 **글자(자모)** 기준으로 다루되 사람은 **발음**
+ * 기준으로도 고르므로, 두 표현 사이를 오갈 때 고른 것이 조용히 다른 글자로 바뀌지
+ * 않게 지키는 것이다(pronToCharValue 의 preferredJamo 주석 참고).
+ */
+import { CHOSEONG, JUNGSEONG, JONGSEONG } from '../utils/koreanSyllable';
+import { finalToPhoneme } from '../utils/phonemeConvert';
+import { PHONEME_GROUPS } from '../utils/phonemeGroups';
+// ─── 상수 ────────────────────────────────────────────────────────────────────
+// 글자 선택(char): 전체 자모를 표준(유니코드) 순서로 개별 노출 — 자모 정확 매칭(경음·겹받침 구분).
+// 표준 순서는 koreanSyllable의 CHOSEONG/JUNGSEONG/JONGSEONG를 단일 출처로 삼아 모든 페이지와 통일한다.
+export const FULL_CHOSEONG = [...CHOSEONG];
+export const FULL_JUNGSEONG = [...JUNGSEONG];
+export const FULL_JONGSEONG = JONGSEONG.filter(j => j !== '');
+/** 선택 값(자모 문자열, 병합 버튼은 다자모)을 실제 매칭 자모 배열로 분해. NO_CODA는 빈 배열. */
+export const valueToJamos = (v) => v === NO_CODA ? [] : Array.from(v);
+/** 종성 '제외'(받침 없는 단어만) 선택을 나타내는 센티넬 값 */
+export const NO_CODA = '__NO_CODA__';
+/** 음절 수 필터 — 정확 매칭 버튼 */
+export const SYLLABLE_COUNTS = [1, 2, 3, 4];
+/** '{{n}}음절 이상' catch-all 의 기준값. composition.syllable === SYLLABLE_MIN 이면 "N음절 이상" 의미 */
+export const SYLLABLE_MIN = 5;
+/** catch-all(≥SYLLABLE_MIN)을 실제 필터 배열로 확장할 때의 상한 */
+export const SYLLABLE_MAX = 12;
+/** 음절 수 버튼 value 접두어 (단일 문자 dot 스타일 회피 + 숫자 파싱용) */
+export const SYLLABLE_PREFIX = 'SYL_';
+export const syllableValue = (n) => `${SYLLABLE_PREFIX}${n}`;
+export const parseSyllableValue = (v) => Number(v.slice(SYLLABLE_PREFIX.length));
+/** composition.syllable 선택값을 실제 매칭용 음절 수 배열로 변환 (SYLLABLE_MIN 이상은 범위로 확장) */
+export function syllableToFilter(syllable) {
+    return syllable >= SYLLABLE_MIN
+        ? Array.from({ length: SYLLABLE_MAX - SYLLABLE_MIN + 1 }, (_, i) => SYLLABLE_MIN + i)
+        : [syllable];
+}
+/** 글자 입력 — 구성요소 종류별 전체 자모 목록(사전순) */
+export const PART_JAMOS = {
+    cho: FULL_CHOSEONG,
+    jung: FULL_JUNGSEONG,
+    jong: FULL_JONGSEONG,
+};
+export const toPronRows = (rows) => rows.map(row => row.map(({ jamos, tooltip }) => ({ v: jamos.join(''), tooltip })));
+export const PHONEME_CLUSTERS = {
+    cho: toPronRows(PHONEME_GROUPS.cho),
+    jung: toPronRows(PHONEME_GROUPS.jung),
+    jong: toPronRows(PHONEME_GROUPS.jong),
+};
+// ─── 글자↔발음 선택 매핑 ──────────────────────────────────────────────────────
+// 선택은 글자(자모) 기준으로 다루되, 모드 전환 시 상대 모드의 적절한 버튼으로 매핑한다.
+// 모음 자모 → 발음 버튼 값(병합 포함). PHONEME_CLUSTERS.jung 역인덱스.
+export const JUNG_CHAR_TO_PRON = {};
+PHONEME_CLUSTERS.jung.flat().forEach(({ v }) => { for (const j of valueToJamos(v))
+    JUNG_CHAR_TO_PRON[j] = v; });
+// 발음 초성 버튼에 존재하는 자모(초성은 개별 버튼이라 char와 동일, ㅇ만 없음)
+export const CHO_PRON_SET = new Set(PHONEME_CLUSTERS.cho.flat().map(o => o.v));
+/** 글자→발음: 자모를 해당 발음 버튼 값으로. 대응 버튼이 없으면 null(선택 해제). */
+export function charToPronValue(part, jamo) {
+    if (part === 'cho')
+        return CHO_PRON_SET.has(jamo) ? jamo : null;
+    if (part === 'jung')
+        return JUNG_CHAR_TO_PRON[jamo] ?? jamo;
+    return finalToPhoneme(jamo);
+}
+/**
+ * 발음→글자: 병합 버튼(예: 'ㅔㅐ')은 여러 자모를 하나로 묶으므로 되돌릴 대표 자모가 모호하다.
+ * preferredJamo(전환 직전 글자 모드에서 실제 선택돼 있던 자모)가 병합 그룹에 포함되면 그걸
+ * 그대로 복원하고, 없으면(예: 발음 모드에서 새로 선택한 경우) 첫 자모로 대체한다.
+ * 이걸 생략하면 ㅐ 선택 → 발음 전환('ㅔㅐ') → 글자 전환 시 항상 ㅔ로 바뀌는(자모가 조용히
+ * 다른 글자로 뒤바뀌는) 문제가 생긴다.
+ */
+export function pronToCharValue(part, value, preferredJamo) {
+    if (part === 'jung') {
+        const jamos = valueToJamos(value);
+        if (preferredJamo && jamos.includes(preferredJamo))
+            return preferredJamo;
+        return jamos[0] ?? value;
+    }
+    return value;
+}
+/** 모드 전환 시 composition의 초성/모음/종성을 대상 모드 값으로 변환. 종성 '없음'(NO_CODA)은 유지. */
+export function convertComposition(c, to, preferredCharJung) {
+    const conv = (part, v) => {
+        if (!v)
+            return null;
+        if (part === 'jong' && v === NO_CODA)
+            return NO_CODA;
+        if (to === 'pron')
+            return charToPronValue(part, v);
+        return pronToCharValue(part, v, part === 'jung' ? preferredCharJung : null);
+    };
+    return { ...c, cho: conv('cho', c.cho), jung: conv('jung', c.jung), jong: conv('jong', c.jong) };
+}
+/** @public 아무것도 안 고른 상태 — 시험이 기준값으로 쓴다. */
+export const EMPTY_COMPOSITION = { cho: null, jung: null, jong: null, syllable: null };

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

@@ -0,0 +1,27 @@
+export { default as useFontScale } from './hooks/useFontScale';
+export { default as useMediaQuery } from './hooks/useMediaQuery';
+export * from './hooks/useFontScale';
+export * from './hooks/useMediaQuery';
+export * from './hooks/useWindowEvent';
+export * from './hooks/useDocumentTitle';
+export * from './hooks/useRelativeDay';
+export * from './hooks/usePasswordChange';
+export * from './hooks/useCacheManagement';
+export * from './hooks/useWordDataStats';
+export * from './hooks/useVisitHistory';
+export * from './hooks/useVisitSchedule';
+export * from './hooks/useVisitAllPanel';
+export * from './hooks/useTablePaging';
+export * from './hooks/useDeviceManagement';
+export type { DeviceForm } from './types/device';
+export * from './hooks/useWordTrainingFilter';
+export * from './hooks/useWordAttributeFilter';
+export * from './hooks/useWordTrainingDataGeneration';
+export * from './hooks/useDailyTrainingSelection';
+export { default as useEscToClose } from './hooks/useEscToClose';
+export * from './hooks/useEscToClose';
+export * from './hooks/useWordMeanings';
+export * from './hooks/useHoverAnchor';
+export * from './hooks/usePagedList';
+export * from './hooks/useToastState';
+export { useTrainingTypeLabels } from './hooks/useTrainingTypeLabels';

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

@@ -0,0 +1,28 @@
+export { default as useFontScale } from './hooks/useFontScale';
+export { default as useMediaQuery } from './hooks/useMediaQuery';
+export * from './hooks/useFontScale';
+export * from './hooks/useMediaQuery';
+export * from './hooks/useWindowEvent';
+export * from './hooks/useDocumentTitle';
+export * from './hooks/useRelativeDay';
+export * from './hooks/usePasswordChange';
+export * from './hooks/useCacheManagement';
+export * from './hooks/useWordDataStats';
+export * from './hooks/useVisitHistory';
+export * from './hooks/useVisitSchedule';
+export * from './hooks/useVisitAllPanel';
+export * from './hooks/useTablePaging';
+export * from './hooks/useDeviceManagement';
+export * from './hooks/useWordTrainingFilter';
+export * from './hooks/useWordAttributeFilter';
+export * from './hooks/useWordTrainingDataGeneration';
+export * from './hooks/useDailyTrainingSelection';
+export { default as useEscToClose } from './hooks/useEscToClose';
+export * from './hooks/useEscToClose';
+export * from './hooks/useWordMeanings';
+export * from './hooks/useHoverAnchor';
+export * from './hooks/usePagedList';
+// 토스트 상태(문구 + 종류 + 재실행 번호). 회원 앱의 useToast 가 이 위에 얹혀 있다 —
+// 같은 관용구를 두 벌로 두지 않으려면 패키지 밖에서도 보여야 한다.
+export * from './hooks/useToastState';
+export { useTrainingTypeLabels } from './hooks/useTrainingTypeLabels';

package/dist/packages/core/src/i18n/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * i18n 설정
+ *
+ * 새 언어 추가 방법:
+ *   1. src/i18n/locales/<code>.json 파일 생성 (ko.json 참고)
+ *   2. LOCALE_MAP에 { code, label } 추가
+ *   3. addResourceBundle 한 줄 추가
+ *
+ * @public
+ */
+import i18n from 'i18next';
+/** 지원 언어 목록 — 새 언어 추가 시 여기에도 추가 */
+export declare const SUPPORTED_LOCALES: {
+    code: string;
+    label: string;
+}[];
+export declare const DEFAULT_LOCALE = "ko";
+export declare const LOCALE_STORAGE_KEY = "ihab_display_language";
+/** 언어 코드를 localStorage에 저장한다. */
+export declare function saveLocale(code: string): void;
+export default i18n;

package/dist/packages/core/src/i18n/index.js

@@ -0,0 +1,68 @@
+'use client';
+/**
+ * i18n 설정
+ *
+ * 새 언어 추가 방법:
+ *   1. src/i18n/locales/<code>.json 파일 생성 (ko.json 참고)
+ *   2. LOCALE_MAP에 { code, label } 추가
+ *   3. addResourceBundle 한 줄 추가
+ *
+ * @public
+ */
+import i18n from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import ko from './locales/ko.json';
+import en from './locales/en.json';
+/** 지원 언어 목록 — 새 언어 추가 시 여기에도 추가 */
+export const SUPPORTED_LOCALES = [
+    { code: 'ko', label: '한국어' },
+    { code: 'en', label: 'English' },
+];
+export const DEFAULT_LOCALE = 'ko';
+export const LOCALE_STORAGE_KEY = 'ihab_display_language';
+/** localStorage에서 저장된 언어 코드를 읽어온다. 없거나 지원하지 않는 코드면 기본값 반환. */
+function getSavedLocale() {
+    try {
+        const saved = localStorage.getItem(LOCALE_STORAGE_KEY);
+        if (saved && SUPPORTED_LOCALES.some(l => l.code === saved))
+            return saved;
+    }
+    catch { /* SSR or private browsing */ }
+    return DEFAULT_LOCALE;
+}
+/** 언어 코드를 localStorage에 저장한다. */
+export function saveLocale(code) {
+    try {
+        localStorage.setItem(LOCALE_STORAGE_KEY, code);
+    }
+    catch { /* ignore */ }
+}
+/** <html lang="..."> 을 현재 언어와 동기화한다 (스크린리더가 올바른 발음 규칙을 적용하도록). */
+function syncHtmlLang(code) {
+    try {
+        document.documentElement.lang = code;
+    }
+    catch { /* SSR */ }
+}
+// 언어 변경(i18n.changeLanguage) 시마다 <html lang>을 동기화 — init() 호출 전에 등록해
+// 초기 로드 시점의 changeLanguage 호출도 놓치지 않는다.
+i18n.on('languageChanged', syncHtmlLang);
+// 새로고침 직후 등, i18next 초기화가 비동기로 완료되기 전에도 저장된 언어를 즉시 반영
+syncHtmlLang(getSavedLocale());
+i18n
+    .use(initReactI18next)
+    .init({
+    resources: {
+        ko: { translation: ko },
+        en: { translation: en },
+    },
+    lng: getSavedLocale(), // 새로고침 후에도 저장된 언어 유지
+    fallbackLng: DEFAULT_LOCALE,
+    interpolation: {
+        escapeValue: false,
+    },
+    react: {
+        useSuspense: false,
+    },
+});
+export default i18n;