@ihabdevteam/core 0.444.0 → 0.445.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2227,7 +2227,7 @@ export declare function copyText(text: string): Promise<boolean>;
2227
2227
  *
2228
2228
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
2229
2229
  */
2230
- export declare const CORE_VERSION = "0.444.0";
2230
+ export declare const CORE_VERSION = "0.445.0";
2231
2231
 
2232
2232
  /** @public */
2233
2233
  declare const coreDefault: Record<string, unknown>;
@@ -5138,6 +5138,13 @@ declare type LoadFn = () => Promise<Record<string, {
5138
5138
  */
5139
5139
  export declare function loadGameLeaderboard(gameKey: string, limit?: number): Promise<LeaderboardRow[] | null>;
5140
5140
 
5141
+ /**
5142
+ * 그 언어의 코어 사전을 **받아 둔다**(이미 왔으면 바로 끝난다). 언어는 안 바꾼다.
5143
+ * 첫 그리기 전에 영어 사전이 꼭 있어야 하는 앱이 기다린다. `changeLanguage` 는 이것을 스스로 기다린다.
5144
+ * @public
5145
+ */
5146
+ export declare function loadLocale(code: string): Promise<void>;
5147
+
5141
5148
  export declare function loadMyGameRanks(): Promise<Record<string, {
5142
5149
  bestScore: number;
5143
5150
  rank: number;
@@ -0,0 +1,47 @@
1
+ {
2
+ "wordSearch": {
3
+ "filter": {
4
+ "positionAny": "Any",
5
+ "positionHead": "Start",
6
+ "positionMid": "Middle",
7
+ "positionTail": "End",
8
+ "difficulty": "Difficulty",
9
+ "grade": "Grade {{n}}",
10
+ "age": "Age {{n}}",
11
+ "agePlus": "Age {{n}}+",
12
+ "ageRange": "Age {{from}}–{{to}}",
13
+ "difficultyInfoAge": "Age 3–7: the easiest words (grade 1), split by age.",
14
+ "difficultyInfoGrade": "Grades 2–4: harder words, not split by age.",
15
+ "difficultyInfoNone": "None: words with no difficulty assigned.",
16
+ "difficultyInfoBandAge": "{{ages}}: {{grade}} words, split by age.",
17
+ "difficultyInfoBandAgeOne": "{{ages}}: {{grade}} words.",
18
+ "difficultyInfoBandGrade": "{{grade}}: words for {{ages}}.",
19
+ "difficultyInfoBandAgeNamed": "{{ages}}: words split by age.",
20
+ "gradeNone": "None",
21
+ "syllables": "Syllables",
22
+ "syllable": "{{n}} Syll.",
23
+ "syllable5plus": "5+ Syllables",
24
+ "partOfSpeech": "Part of Speech",
25
+ "pos": {
26
+ "noun": "Noun/Numeral",
27
+ "verb": "Verb/Adjective",
28
+ "modifier": "Adverb/Determiner"
29
+ },
30
+ "wordType": "Word Type",
31
+ "field": "Semantic Category",
32
+ "type": {
33
+ "native": "Native Korean",
34
+ "sino": "Sino-Korean",
35
+ "foreign": "Loanword",
36
+ "mixed": "Hybrid"
37
+ },
38
+ "exclude": "Exclude",
39
+ "excludeNoImage": "No Image"
40
+ }
41
+ },
42
+ "wordPairs": {
43
+ "filter": {
44
+ "onlyHighUsage": "High-use words only"
45
+ }
46
+ }
47
+ }
@@ -27,6 +27,12 @@ export declare const LOCALE_STORAGE_KEY = "ihab_display_language";
27
27
  * `test/versionOnEverySubpath.test.ts` 가 갈래마다 이것이 있는지 센다.
28
28
  */
29
29
  export { CORE_VERSION } from '../version';
30
+ /**
31
+ * 그 언어의 코어 사전을 **받아 둔다**(이미 왔으면 바로 끝난다). 언어는 안 바꾼다.
32
+ * 첫 그리기 전에 영어 사전이 꼭 있어야 하는 앱이 기다린다. `changeLanguage` 는 이것을 스스로 기다린다.
33
+ * @public
34
+ */
35
+ export declare function loadLocale(code: string): Promise<void>;
30
36
  /** 언어 코드를 localStorage에 저장한다. */
31
37
  export declare function saveLocale(code: string): void;
32
38
  export default i18n;
@@ -12,7 +12,7 @@
12
12
  import i18n from 'i18next';
13
13
  import { initReactI18next } from 'react-i18next';
14
14
  import ko from './locales/ko.json' with { type: 'json' };
15
- import en from './locales/en.json' with { type: 'json' };
15
+ import enReadback from './enReadback.json' with { type: 'json' };
16
16
  /** 지원 언어 목록 — 새 언어 추가 시 여기에도 추가 */
17
17
  export const SUPPORTED_LOCALES = [
18
18
  { code: 'ko', label: '한국어' },
@@ -31,6 +31,45 @@ export const LOCALE_STORAGE_KEY = 'ihab_display_language';
31
31
  * `test/versionOnEverySubpath.test.ts` 가 갈래마다 이것이 있는지 센다.
32
32
  */
33
33
  export { CORE_VERSION } from '../version';
34
+ /**
35
+ * **영어 사전은 쓸 때 받는다**(말귀 청 (438) ㉳ⓐ, 2026-11-14).
36
+ *
37
+ * 전에는 `en.json`(압축 전 29kB)을 정적으로 들여, 한국어로 보는 사람도 첫 조각에서 영어 사전을 받았다.
38
+ * 이제 한국어(기본 · 대체 언어)만 실어 두고, 다른 언어는 **처음 바꿀 때** 동적 `import()` 로 받는다.
39
+ *
40
+ * · `i18n.changeLanguage('en')` 은 **사전이 다 온 뒤에** 언어를 바꾸고 약속을 푼다 — 바꾸는 사이에 영어 열쇠가
41
+ * 한국어로 새는 틈이 없다. 바꾼 뒤를 보는 쪽은 그 약속을 기다린다(코어 시험은 이미 모두 기다린다).
42
+ * · 저장된 언어가 영어로 **처음 열면** 사전이 오기 전 한 박자는 한국어(대체 언어)로 선다. 그 틈이 싫은 앱은
43
+ * `loadLocale('en')` 을 첫 그리기 전에 기다리거나, `@ihabdevteam/core/i18n/locales/en.json` 을 정적으로
44
+ * 들여 `i18n.addResourceBundle('en', 'translation', en, true, true)` 하면 전과 같다.
45
+ * · 앱 사전을 `addResourceBundle` 로 얹는 길은 그대로다 — 받아 온 코어 사전은 **깊게 합쳐** 앱이 얹은 열쇠를 안 지운다.
46
+ */
47
+ const LOCALE_LOADERS = {
48
+ en: () => import('./locales/en.json', { with: { type: 'json' } }),
49
+ };
50
+ /* **코어 사전이 왔는가**는 따로 센다 — 창고에 그 언어 묶음이 있는지로 보면 안 된다. 앱이 제 영어 사전을
51
+ `addResourceBundle` 로 먼저 얹으면 묶음은 "있다" 가 되어 코어 영어가 영영 안 온다(i18next 의 backend 길이 그렇게 건너뛴다). */
52
+ const coreLoaded = new Set(['ko']);
53
+ const pending = {};
54
+ /** 'en-US' → 'en' — 받을 사전은 언어 앞마디로 고른다 */
55
+ const baseOf = (code) => code.split('-')[0];
56
+ /**
57
+ * 그 언어의 코어 사전을 **받아 둔다**(이미 왔으면 바로 끝난다). 언어는 안 바꾼다.
58
+ * 첫 그리기 전에 영어 사전이 꼭 있어야 하는 앱이 기다린다. `changeLanguage` 는 이것을 스스로 기다린다.
59
+ * @public
60
+ */
61
+ export function loadLocale(code) {
62
+ const base = baseOf(code);
63
+ const load = LOCALE_LOADERS[base];
64
+ if (!load || coreLoaded.has(base))
65
+ return Promise.resolve();
66
+ return (pending[base] ??= load().then((mod) => {
67
+ const bundle = (mod.default ?? mod);
68
+ /* 깊게 합치되 **있는 열쇠는 안 덮는다** — 앱이 먼저 얹은 사전이 이긴다 */
69
+ i18n.addResourceBundle(base, 'translation', bundle, true, false);
70
+ coreLoaded.add(base);
71
+ }, (err) => { pending[base] = undefined; throw err; }));
72
+ }
34
73
  /**
35
74
  * localStorage에서 저장된 언어 코드를 읽어온다. 없거나 지원하지 않는 코드면 기본값 반환.
36
75
  *
@@ -68,12 +107,20 @@ function syncHtmlLang(code) {
68
107
  i18n.on('languageChanged', syncHtmlLang);
69
108
  // 새로고침 직후 등, i18next 초기화가 비동기로 완료되기 전에도 저장된 언어를 즉시 반영
70
109
  syncHtmlLang(getSavedLocale());
110
+ const rawChangeLanguage = (i18n.__ihabRawChangeLanguage ??= i18n.changeLanguage);
111
+ i18n.changeLanguage = rawChangeLanguage;
71
112
  i18n
72
113
  .use(initReactI18next)
73
114
  .init({
115
+ /* 한국어만 싣는다 — 나머지는 바꿀 때 받는다(위 `loadLocale`) */
74
116
  resources: {
75
117
  ko: { translation: ko },
76
- en: { translation: en },
118
+ /* **영어 중 '읽어 돌리기' 몫만은 늘 싣는다**(1.5kB). 저장된 필터의 절 · 값 이름을 **어느 언어로 적었든** 읽어
119
+ 코드로 돌리는 자리(`wordAttributeFilterCodes` · `useWordTrainingFilter`)가 한국어 화면에서도 영어 이름을 알아야
120
+ 한다 — 영어로 보던 사람이 저장한 표를 한국어로 열면 `Semantic Category` · `Grade 1` 이 온다. 이 조각은
121
+ `en.json` 의 같은 자리와 **글자 하나까지 같아야 한다**(`test/lazyEnglishLocale1114` 가 잰다). 열쇠 길:
122
+ `wordSearch.filter.*` · `wordPairs.filter.onlyHighUsage`. */
123
+ en: { translation: enReadback },
77
124
  },
78
125
  lng: getSavedLocale(), // 새로고침 후에도 저장된 언어 유지
79
126
  fallbackLng: DEFAULT_LOCALE,
@@ -84,4 +131,26 @@ i18n
84
131
  useSuspense: false,
85
132
  },
86
133
  });
134
+ /* **언어를 바꾸기 전에 그 사전부터 받는다.** 바꾼 뒤에 받으면 그 사이 한 박자 동안 영어 화면에 한국어가 샌다.
135
+ 받기가 실패해도(오프라인 등) 바꾸기는 한다 — 그때는 대체 언어(한국어)로 선다. init 뒤에 감싼다: init 은 제 안에서
136
+ 곧바로 언어를 정하므로(사전을 실어 둔 길) 감싸기 전 원래 손으로 돈다. */
137
+ const changeLanguageNow = rawChangeLanguage.bind(i18n);
138
+ /* **마지막으로 청한 언어만 이긴다** — 영어로 바꾸고 사전이 오기 전에 한국어로 되돌리면, 늦게 온 영어가 화면을 도로
139
+ 영어로 돌려놓았다. 사전이 왔을 때 그 사이 다른 언어를 청했으면 바꾸지 않는다. */
140
+ let lastRequested;
141
+ i18n.changeLanguage = ((lng, callback) => {
142
+ lastRequested = lng;
143
+ if (!lng || coreLoaded.has(baseOf(lng)) || !LOCALE_LOADERS[baseOf(lng)])
144
+ return changeLanguageNow(lng, callback);
145
+ const go = () => (lastRequested === lng ? changeLanguageNow(lng, callback) : Promise.resolve(i18n.t));
146
+ return loadLocale(lng).then(go, (err) => { console.error(err); return go(); });
147
+ });
148
+ /* 저장된 언어가 영어로 처음 열면 — 사전이 오면 다시 그리게 같은 언어로 한 번 더 알린다 */
149
+ {
150
+ const startLng = i18n.language;
151
+ if (startLng && !coreLoaded.has(baseOf(startLng)) && LOCALE_LOADERS[baseOf(startLng)]) {
152
+ loadLocale(startLng).then(() => { if (i18n.language === startLng && (lastRequested ?? startLng) === startLng)
153
+ void changeLanguageNow(startLng); }, (err) => console.error(err));
154
+ }
155
+ }
87
156
  export default i18n;
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export declare const CORE_VERSION = "0.444.0";
49
+ export declare const CORE_VERSION = "0.445.0";
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export const CORE_VERSION = '0.444.0';
49
+ export const CORE_VERSION = '0.445.0';