@ihabdevteam/core 0.443.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.
Files changed (43) hide show
  1. package/CHANGELOG.md +43 -0
  2. package/dist/components.cjs.js +187 -182
  3. package/dist/components.esm.css +1 -1
  4. package/dist/hooks.cjs.js +5 -5
  5. package/dist/i18n.cjs.js +3 -3
  6. package/dist/ihabdevteam-core.cjs.js +192 -187
  7. package/dist/ihabdevteam-core.d.ts +108 -2
  8. package/dist/packages/core/src/components/DatePicker.css +8 -0
  9. package/dist/packages/core/src/components/DatePicker.js +13 -1
  10. package/dist/packages/core/src/components/FolderAddPopup.d.ts +25 -0
  11. package/dist/packages/core/src/components/FolderAddPopup.js +21 -0
  12. package/dist/packages/core/src/components/FolderList.css +18 -0
  13. package/dist/packages/core/src/components/FolderList.d.ts +28 -0
  14. package/dist/packages/core/src/components/FolderList.js +23 -0
  15. package/dist/packages/core/src/components/PagePopup.d.ts +10 -1
  16. package/dist/packages/core/src/components/PagePopup.js +7 -1
  17. package/dist/packages/core/src/components/Popup/Popup.css +14 -0
  18. package/dist/packages/core/src/components/Popup/Popup.d.ts +9 -0
  19. package/dist/packages/core/src/components/Popup/Popup.js +21 -3
  20. package/dist/packages/core/src/components/TextField.css +20 -0
  21. package/dist/packages/core/src/components/TextField.d.ts +17 -0
  22. package/dist/packages/core/src/components/TextField.js +19 -4
  23. package/dist/packages/core/src/components/Training/TrainingBlockGrid.js +25 -1
  24. package/dist/packages/core/src/components.d.ts +4 -0
  25. package/dist/packages/core/src/components.js +2 -0
  26. package/dist/packages/core/src/hooks/useBackClosable.d.ts +8 -0
  27. package/dist/packages/core/src/hooks/useBackClosable.js +97 -0
  28. package/dist/packages/core/src/hooks.d.ts +1 -0
  29. package/dist/packages/core/src/hooks.js +1 -0
  30. package/dist/packages/core/src/i18n/enReadback.json +47 -0
  31. package/dist/packages/core/src/i18n/index.d.ts +6 -0
  32. package/dist/packages/core/src/i18n/index.js +71 -2
  33. package/dist/packages/core/src/i18n/locales/en.json +10 -3
  34. package/dist/packages/core/src/i18n/locales/ko.json +10 -3
  35. package/dist/packages/core/src/utils/jamoSpeech.d.ts +19 -0
  36. package/dist/packages/core/src/utils/jamoSpeech.js +53 -0
  37. package/dist/packages/core/src/utils/lucideIconSet.js +2 -0
  38. package/dist/packages/core/src/utils/wordTrainingGenerators.d.ts +1 -6
  39. package/dist/packages/core/src/utils/wordTrainingGenerators.js +3 -45
  40. package/dist/packages/core/src/version.d.ts +1 -1
  41. package/dist/packages/core/src/version.js +1 -1
  42. package/dist/utils.cjs.js +173 -168
  43. package/package.json +1 -1
@@ -49,9 +49,33 @@ export default function TrainingBlockGrid({ gap = 10, count, className, children
49
49
  measure();
50
50
  if (typeof ResizeObserver === 'undefined')
51
51
  return;
52
+ /* **자기만 보면 묶인 뒤에 못 깬다**(말귀 청 (439), 2026-11-14). `--measured` 의 `max-width` 로 스스로 묶인 뒤에는
53
+ 부모가 넓어져도 이 상자는 그대로라 다시 안 잰다 — ① 내용에 맞춰 줄어드는 부모 안에서 먼저 재면 타일 셋이
54
+ 둘+하나로 접혀 410 에 묶이고 창이 660 이 돼도 그대로였다. ② 폰을 돌려 카드가 293 → 190 이 돼도 그리드는 1열에
55
+ 머물렀다. 그래서 **첫 카드**와 **위로 세 칸까지의 조상**도 보고, 창 크기 바뀜(돌리기)에도 잰다. 잰 값이 같으면
56
+ 상태를 안 바꾸므로(위 `prev`) 더 봐도 다시 그리지 않는다. */
52
57
  const ro = new ResizeObserver(measure);
53
58
  ro.observe(el);
54
- return () => ro.disconnect();
59
+ const first = el.firstElementChild;
60
+ if (first)
61
+ ro.observe(first);
62
+ let up = el.parentElement;
63
+ for (let i = 0; i < 3 && up && up !== document.body; i++, up = up.parentElement)
64
+ ro.observe(up);
65
+ /* 창 크기 바뀜은 잦다 — 틀에 한 번으로 모은다 */
66
+ let rafId = null;
67
+ const onResize = () => {
68
+ if (rafId !== null)
69
+ return;
70
+ rafId = requestAnimationFrame(() => { rafId = null; measure(); });
71
+ };
72
+ window.addEventListener('resize', onResize);
73
+ return () => {
74
+ ro.disconnect();
75
+ window.removeEventListener('resize', onResize);
76
+ if (rafId !== null)
77
+ cancelAnimationFrame(rafId);
78
+ };
55
79
  }, [itemCount, gap]);
56
80
  const cardWidth = measured.card > 0 ? measured.card : 0;
57
81
  const perRow = cardWidth > 0 ? columnsFitting(measured.width, cardWidth, gap) : 0;
@@ -107,6 +107,10 @@ export { default as FolderHead } from './components/FolderHead';
107
107
  export type { FolderHeadProps } from './components/FolderHead';
108
108
  export { default as FolderGrid } from './components/FolderGrid';
109
109
  export type { FolderGridProps, FolderEntry } from './components/FolderGrid';
110
+ export { default as FolderList } from './components/FolderList';
111
+ export type { FolderListProps } from './components/FolderList';
112
+ export { default as FolderAddPopup } from './components/FolderAddPopup';
113
+ export type { FolderAddPopupProps } from './components/FolderAddPopup';
110
114
  export { default as CardSection } from './components/CardSection';
111
115
  export type { CardSectionProps } from './components/CardSection';
112
116
  export { default as FolderSearchSections } from './components/FolderSearchSections';
@@ -74,6 +74,8 @@ export { default as Breadcrumb } from './components/Breadcrumb';
74
74
  /* 폴더로 보는 화면 — 구조 단추 · 길 · 폴더 칸(말귀 청 (435), 2026-11-13). 길 셈은 `utils` 의 `folder*` 다 */
75
75
  export { default as FolderHead } from './components/FolderHead';
76
76
  export { default as FolderGrid } from './components/FolderGrid';
77
+ export { default as FolderList } from './components/FolderList';
78
+ export { default as FolderAddPopup } from './components/FolderAddPopup';
77
79
  /* 폴더 화면의 남은 조각(말귀 청 (437) ㉮, 2026-11-13) — 카드가 서는 자리 · 찾는 중 폴더마다 나눠 세우기 */
78
80
  export { default as CardSection } from './components/CardSection';
79
81
  export { default as FolderSearchSections } from './components/FolderSearchSections';
@@ -0,0 +1,8 @@
1
+ /**
2
+ * 열려 있는 동안 폰 '뒤로' 로 닫히게 한다.
3
+ *
4
+ * @param open 열려 있는가. 거짓이면 아무것도 안 한다.
5
+ * @param onBack 뒤로가 왔을 때 부른다 — 닫는다. **`false` 를 돌려주면 안 닫은 것**으로 보고 칸을 도로 쌓는다.
6
+ * @public
7
+ */
8
+ export declare function useBackClosable(open: boolean, onBack: () => boolean | void): void;
@@ -0,0 +1,97 @@
1
+ 'use client';
2
+ import { useEffect, useRef } from 'react';
3
+ const STATE_KEY = '__ihabBackClosable';
4
+ const stack = [];
5
+ let ignorePops = 0;
6
+ let listening = false;
7
+ let nextId = 1;
8
+ function topState() {
9
+ try {
10
+ const s = window.history.state;
11
+ const v = s?.[STATE_KEY];
12
+ return typeof v === 'number' ? v : undefined;
13
+ }
14
+ catch {
15
+ return undefined;
16
+ }
17
+ }
18
+ function pushMark(id) {
19
+ try {
20
+ /* 라우터가 쓰는 표(react-router 의 `idx` · `key`, Next 의 `__NA` 등)를 지우지 않게 지금 표에 얹는다 */
21
+ const prev = (window.history.state ?? {});
22
+ window.history.pushState({ ...prev, [STATE_KEY]: id }, '');
23
+ }
24
+ catch { /* 못 쌓으면 뒤로가 창을 못 닫을 뿐이다 */ }
25
+ }
26
+ function onPop() {
27
+ if (ignorePops > 0) {
28
+ ignorePops--;
29
+ return;
30
+ }
31
+ const top = stack[stack.length - 1];
32
+ if (!top)
33
+ return;
34
+ /* 앞으로(forward)로 우리 칸에 되돌아온 것 — 닫을 일이 아니다 */
35
+ if (topState() === top.id)
36
+ return;
37
+ if (top.onBack() === false) {
38
+ pushMark(top.id);
39
+ return;
40
+ }
41
+ /* 닫혔다 — 칸은 이미 걷혔으니 떠날 때 되돌리지 않게 스택에서 먼저 뺀다 */
42
+ stack.pop();
43
+ }
44
+ function listen() {
45
+ if (listening || typeof window === 'undefined')
46
+ return;
47
+ window.addEventListener('popstate', onPop);
48
+ listening = true;
49
+ }
50
+ /**
51
+ * 열려 있는 동안 폰 '뒤로' 로 닫히게 한다.
52
+ *
53
+ * @param open 열려 있는가. 거짓이면 아무것도 안 한다.
54
+ * @param onBack 뒤로가 왔을 때 부른다 — 닫는다. **`false` 를 돌려주면 안 닫은 것**으로 보고 칸을 도로 쌓는다.
55
+ * @public
56
+ */
57
+ export function useBackClosable(open, onBack) {
58
+ const onBackRef = useRef(onBack);
59
+ useEffect(() => { onBackRef.current = onBack; });
60
+ const idRef = useRef(null);
61
+ useEffect(() => {
62
+ if (!open || typeof window === 'undefined')
63
+ return;
64
+ listen();
65
+ /* 엄격 모드로 다시 걸릴 때는 같은 번호를 쓰고, 칸이 아직 맨 위면 또 쌓지 않는다 */
66
+ const id = idRef.current ?? (idRef.current = nextId++);
67
+ const entry = { id, onBack: () => onBackRef.current() };
68
+ stack.push(entry);
69
+ if (topState() !== id)
70
+ pushMark(id);
71
+ return () => {
72
+ const i = stack.indexOf(entry);
73
+ /* 뒤로로 닫혔으면 onPop 이 이미 뺐다 — 칸도 걷혀 있다 */
74
+ if (i < 0) {
75
+ idRef.current = null;
76
+ return;
77
+ }
78
+ stack.splice(i, 1);
79
+ setTimeout(() => {
80
+ /* 다시 걸렸으면(엄격 모드) 그대로 둔다 */
81
+ if (stack.some(e => e.id === id))
82
+ return;
83
+ if (idRef.current === id)
84
+ idRef.current = null;
85
+ if (topState() !== id)
86
+ return;
87
+ ignorePops++;
88
+ try {
89
+ window.history.back();
90
+ }
91
+ catch {
92
+ ignorePops--;
93
+ }
94
+ }, 0);
95
+ };
96
+ }, [open]);
97
+ }
@@ -40,4 +40,5 @@ export * from './hooks/useSaveOnHide';
40
40
  export * from './hooks/useScreenWakeLock';
41
41
  export * from './hooks/useOnline';
42
42
  export * from './hooks/useOutsideClose';
43
+ export { useBackClosable } from './hooks/useBackClosable';
43
44
  export * from './hooks/useClosingDelay';
@@ -46,4 +46,5 @@ export * from './hooks/useSaveOnHide';
46
46
  export * from './hooks/useScreenWakeLock';
47
47
  export * from './hooks/useOnline';
48
48
  export * from './hooks/useOutsideClose';
49
+ export { useBackClosable } from './hooks/useBackClosable';
49
50
  export * from './hooks/useClosingDelay';
@@ -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;
@@ -102,7 +102,8 @@
102
102
  }
103
103
  },
104
104
  "unknownError": "Unknown error",
105
- "networkError": "The network connection is unstable. Check your connection and try again."
105
+ "networkError": "The network connection is unstable. Check your connection and try again.",
106
+ "add": "Add"
106
107
  },
107
108
  "calendar": {
108
109
  "rangeSelect": "Select period",
@@ -987,7 +988,8 @@
987
988
  "imageCount": "{{done}} / {{total}} items"
988
989
  },
989
990
  "textField": {
990
- "clearAriaLabel": "Clear input"
991
+ "clearAriaLabel": "Clear input",
992
+ "showPassword": "Show password"
991
993
  },
992
994
  "segmentedControl": {
993
995
  "ariaLabel": "Select tab"
@@ -1119,7 +1121,12 @@
1119
1121
  "placeMenu": "{{name}} menu",
1120
1122
  "tree": "Show folder structure",
1121
1123
  "fold": "Collapse {{name}}",
1122
- "unfold": "Expand {{name}}"
1124
+ "unfold": "Expand {{name}}",
1125
+ "add": {
1126
+ "title": "Add Folder",
1127
+ "sub": "Enter a name for the new folder.",
1128
+ "placeholder": "Folder name"
1129
+ }
1123
1130
  },
1124
1131
  "board": {
1125
1132
  "empty": "No items yet."
@@ -98,7 +98,8 @@
98
98
  }
99
99
  },
100
100
  "unknownError": "알 수 없는 오류",
101
- "networkError": "네트워크 연결이 불안정합니다. 연결 상태를 확인한 뒤 다시 시도해 주세요."
101
+ "networkError": "네트워크 연결이 불안정합니다. 연결 상태를 확인한 뒤 다시 시도해 주세요.",
102
+ "add": "추가"
102
103
  },
103
104
  "calendar": {
104
105
  "rangeSelect": "기간 선택",
@@ -972,7 +973,8 @@
972
973
  "imageCount": "{{done}} / {{total}}개"
973
974
  },
974
975
  "textField": {
975
- "clearAriaLabel": "입력값 지우기"
976
+ "clearAriaLabel": "입력값 지우기",
977
+ "showPassword": "비밀번호 보기"
976
978
  },
977
979
  "segmentedControl": {
978
980
  "ariaLabel": "선택 탭"
@@ -1101,7 +1103,12 @@
1101
1103
  "placeMenu": "{{name}} 메뉴",
1102
1104
  "tree": "폴더 구조 보기",
1103
1105
  "fold": "{{name}} 접기",
1104
- "unfold": "{{name}} 펼치기"
1106
+ "unfold": "{{name}} 펼치기",
1107
+ "add": {
1108
+ "title": "폴더 추가",
1109
+ "sub": "새 폴더 이름을 입력하세요.",
1110
+ "placeholder": "폴더 이름"
1111
+ }
1105
1112
  },
1106
1113
  "board": {
1107
1114
  "empty": "등록된 항목이 없습니다."
@@ -0,0 +1,19 @@
1
+ /**
2
+ * **자모를 소리 내어 읽을 이름으로** — 작은 파일(말귀 청 (438) ㉳ⓑ, 2026-11-14).
3
+ *
4
+ * `wordTrainingGenerators`(25kB 남짓)에 있었는데, 말귀 앱의 첫 조각이 이 함수 하나만 쓰면서 그 파일을 통째로
5
+ * 끌고 왔다. 읽기 셈에 드는 것(낱자 이름 표 · 조사 맞추기)만 여기 둔다. `@ihabdevteam/core/utils/jamoSpeech` 로
6
+ * 바로 받거나, 예전처럼 `@ihabdevteam/core/utils` 에서 받는다.
7
+ */
8
+ /**
9
+ * 자모 → 낱자 이름(TTS가 음소를 정확히 읽도록). 자음은 명칭(ㄱ→기역), 모음은 소릿값(ㅏ→아).
10
+ * bare 자모('ㄱ')를 그대로 TTS에 넣으면 엔진이 '그/가'처럼 잘못 읽어, 음소 합치기 문장에서 이름으로 치환한다.
11
+ */
12
+ /** @internal 낱자 이름 표 — `wordTrainingGenerators` 의 합치기 문장도 이 표를 쓴다 */
13
+ export declare const JAMO_NAME: Record<string, string>;
14
+ /**
15
+ * @public TTS 전용 변환 — 문장 속 따옴표로 감싼 낱개 자모("ㄱ")를 낱자 이름("기역")으로 치환하고 뒤 조사를 맞춘다.
16
+ * 표시 텍스트는 자모 그대로 두고(교육용 표기), 합성·캐시 키에만 이 변환을 적용한다. 자음은 명칭(ㄱ→기역),
17
+ * 모음은 소릿값(ㅏ→아). 음소 합치기뿐 아니라 음소 바꾸기·자음 탈락 등 자모가 든 모든 문장에 공통 적용된다.
18
+ */
19
+ export declare function jamoToNamesForSpeech(text: string): string;
@@ -0,0 +1,53 @@
1
+ /**
2
+ * **자모를 소리 내어 읽을 이름으로** — 작은 파일(말귀 청 (438) ㉳ⓑ, 2026-11-14).
3
+ *
4
+ * `wordTrainingGenerators`(25kB 남짓)에 있었는데, 말귀 앱의 첫 조각이 이 함수 하나만 쓰면서 그 파일을 통째로
5
+ * 끌고 왔다. 읽기 셈에 드는 것(낱자 이름 표 · 조사 맞추기)만 여기 둔다. `@ihabdevteam/core/utils/jamoSpeech` 로
6
+ * 바로 받거나, 예전처럼 `@ihabdevteam/core/utils` 에서 받는다.
7
+ */
8
+ /**
9
+ * 자모 → 낱자 이름(TTS가 음소를 정확히 읽도록). 자음은 명칭(ㄱ→기역), 모음은 소릿값(ㅏ→아).
10
+ * bare 자모('ㄱ')를 그대로 TTS에 넣으면 엔진이 '그/가'처럼 잘못 읽어, 음소 합치기 문장에서 이름으로 치환한다.
11
+ */
12
+ /** @internal 낱자 이름 표 — `wordTrainingGenerators` 의 합치기 문장도 이 표를 쓴다 */
13
+ export const JAMO_NAME = {
14
+ // 자음(초성·종성 공용 낱자 이름)
15
+ 'ㄱ': '기역', 'ㄲ': '쌍기역', 'ㄴ': '니은', 'ㄷ': '디귿', 'ㄸ': '쌍디귿', 'ㄹ': '리을',
16
+ 'ㅁ': '미음', 'ㅂ': '비읍', 'ㅃ': '쌍비읍', 'ㅅ': '시옷', 'ㅆ': '쌍시옷', 'ㅇ': '이응',
17
+ 'ㅈ': '지읒', 'ㅉ': '쌍지읒', 'ㅊ': '치읓', 'ㅋ': '키읔', 'ㅌ': '티읕', 'ㅍ': '피읖', 'ㅎ': '히읗',
18
+ // 겹받침(홑받침만 쓰지만 방어적으로 포함)
19
+ 'ㄳ': '기역시옷', 'ㄵ': '니은지읒', 'ㄶ': '니은히읗', 'ㄺ': '리을기역', 'ㄻ': '리을미음',
20
+ 'ㄼ': '리을비읍', 'ㄽ': '리을시옷', 'ㄾ': '리을티읕', 'ㄿ': '리을피읖', 'ㅀ': '리을히읗', 'ㅄ': '비읍시옷',
21
+ // 모음(소릿값 = 낱자 이름)
22
+ 'ㅏ': '아', 'ㅐ': '애', 'ㅑ': '야', 'ㅒ': '얘', 'ㅓ': '어', 'ㅔ': '에', 'ㅕ': '여', 'ㅖ': '예',
23
+ 'ㅗ': '오', 'ㅘ': '와', 'ㅙ': '왜', 'ㅚ': '외', 'ㅛ': '요', 'ㅜ': '우', 'ㅝ': '워', 'ㅞ': '웨',
24
+ 'ㅟ': '위', 'ㅠ': '유', 'ㅡ': '으', 'ㅢ': '의', 'ㅣ': '이',
25
+ };
26
+ /**
27
+ * @public TTS 전용 변환 — 문장 속 따옴표로 감싼 낱개 자모("ㄱ")를 낱자 이름("기역")으로 치환하고 뒤 조사를 맞춘다.
28
+ * 표시 텍스트는 자모 그대로 두고(교육용 표기), 합성·캐시 키에만 이 변환을 적용한다. 자음은 명칭(ㄱ→기역),
29
+ * 모음은 소릿값(ㅏ→아). 음소 합치기뿐 아니라 음소 바꾸기·자음 탈락 등 자모가 든 모든 문장에 공통 적용된다.
30
+ */
31
+ export function jamoToNamesForSpeech(text) {
32
+ return text.replace(/"([ㄱ-ㅣ])"(으로|와|과|을|를|이|가|은|는|로)?/g, (m, jamo, josa) => {
33
+ const name = JAMO_NAME[jamo];
34
+ if (!name)
35
+ return m;
36
+ if (!josa)
37
+ return `"${name}"`;
38
+ const jong = (name.charCodeAt(name.length - 1) - 0xAC00) % 28;
39
+ const hasJong = jong !== 0;
40
+ let j = josa;
41
+ if (josa === '와' || josa === '과')
42
+ j = hasJong ? '과' : '와';
43
+ else if (josa === '을' || josa === '를')
44
+ j = hasJong ? '을' : '를';
45
+ else if (josa === '이' || josa === '가')
46
+ j = hasJong ? '이' : '가';
47
+ else if (josa === '은' || josa === '는')
48
+ j = hasJong ? '은' : '는';
49
+ else if (josa === '으로' || josa === '로')
50
+ j = (jong === 0 || jong === 8) ? '로' : '으로';
51
+ return `"${name}"${j}`;
52
+ });
53
+ }
@@ -64,6 +64,7 @@ import EllipsisIcon from 'lucide-react/dist/esm/icons/ellipsis.mjs';
64
64
  import EraserIcon from 'lucide-react/dist/esm/icons/eraser.mjs';
65
65
  import ExternalLinkIcon from 'lucide-react/dist/esm/icons/external-link.mjs';
66
66
  import EyeIcon from 'lucide-react/dist/esm/icons/eye.mjs';
67
+ import EyeOffIcon from 'lucide-react/dist/esm/icons/eye-off.mjs';
67
68
  import FileTextIcon from 'lucide-react/dist/esm/icons/file-text.mjs';
68
69
  import FlipHorizontalIcon from 'lucide-react/dist/esm/icons/flip-horizontal.mjs';
69
70
  import FolderIcon from 'lucide-react/dist/esm/icons/folder.mjs';
@@ -250,6 +251,7 @@ export const STATIC_LUCIDE_ICONS = {
250
251
  'eraser': EraserIcon,
251
252
  'external-link': ExternalLinkIcon,
252
253
  'eye': EyeIcon,
254
+ 'eye-off': EyeOffIcon,
253
255
  'file-text': FileTextIcon,
254
256
  'flip-horizontal': FlipHorizontalIcon,
255
257
  'folder': FolderIcon,
@@ -40,12 +40,7 @@ export declare function getDropCardTitle(typeKey: string | undefined, item: Reco
40
40
  * 문장 문구를 한 곳에 모아, 프리워밍이 만든 문장과 러너가 재생하는 문장이 항상 문자 단위로 일치하게 한다.
41
41
  */
42
42
  export declare function cardQuestionTitle(typeKey: string | undefined, item: Record<string, unknown>, parts: string[]): string;
43
- /**
44
- * @public TTS 전용 변환 — 문장 속 따옴표로 감싼 낱개 자모("ㄱ")를 낱자 이름("기역")으로 치환하고 뒤 조사를 맞춘다.
45
- * 표시 텍스트는 자모 그대로 두고(교육용 표기), 합성·캐시 키에만 이 변환을 적용한다. 자음은 명칭(ㄱ→기역),
46
- * 모음은 소릿값(ㅏ→아). 음소 합치기뿐 아니라 음소 바꾸기·자음 탈락 등 자모가 든 모든 문장에 공통 적용된다.
47
- */
48
- export declare function jamoToNamesForSpeech(text: string): string;
43
+ export { jamoToNamesForSpeech } from './jamoSpeech';
49
44
  /** 표준발음 조회 — 없으면 단어 자체(발음 데이터 없는 경우의 안전한 폴백). */
50
45
  declare function pronOf(word: string, pronMap: Map<string, string>): string;
51
46
  /**
@@ -11,6 +11,7 @@ import { finalToPhoneme } from './phonemeConvert';
11
11
  import { shuffle as shuffled } from './array';
12
12
  import { hasSel } from './wordContrast';
13
13
  import { cardGroupOf } from './wordTrainingRuntimeTypes';
14
+ import { JAMO_NAME } from './jamoSpeech';
14
15
  /** 받침 유무로 '와/과' 조사. 한글 아니면 '와'. */
15
16
  function josaWaGwa(w) {
16
17
  const code = (w.charCodeAt((w.length || 1) - 1)) || 0;
@@ -41,23 +42,6 @@ function josaIga(w) {
41
42
  return (code - 0xAC00) % 28 === 0 ? '가' : '이';
42
43
  return /[ㄱ-ㅎ]/.test(ch) ? '이' : '가';
43
44
  }
44
- /**
45
- * 자모 → 낱자 이름(TTS가 음소를 정확히 읽도록). 자음은 명칭(ㄱ→기역), 모음은 소릿값(ㅏ→아).
46
- * bare 자모('ㄱ')를 그대로 TTS에 넣으면 엔진이 '그/가'처럼 잘못 읽어, 음소 합치기 문장에서 이름으로 치환한다.
47
- */
48
- const JAMO_NAME = {
49
- // 자음(초성·종성 공용 낱자 이름)
50
- 'ㄱ': '기역', 'ㄲ': '쌍기역', 'ㄴ': '니은', 'ㄷ': '디귿', 'ㄸ': '쌍디귿', 'ㄹ': '리을',
51
- 'ㅁ': '미음', 'ㅂ': '비읍', 'ㅃ': '쌍비읍', 'ㅅ': '시옷', 'ㅆ': '쌍시옷', 'ㅇ': '이응',
52
- 'ㅈ': '지읒', 'ㅉ': '쌍지읒', 'ㅊ': '치읓', 'ㅋ': '키읔', 'ㅌ': '티읕', 'ㅍ': '피읖', 'ㅎ': '히읗',
53
- // 겹받침(홑받침만 쓰지만 방어적으로 포함)
54
- 'ㄳ': '기역시옷', 'ㄵ': '니은지읒', 'ㄶ': '니은히읗', 'ㄺ': '리을기역', 'ㄻ': '리을미음',
55
- 'ㄼ': '리을비읍', 'ㄽ': '리을시옷', 'ㄾ': '리을티읕', 'ㄿ': '리을피읖', 'ㅀ': '리을히읗', 'ㅄ': '비읍시옷',
56
- // 모음(소릿값 = 낱자 이름)
57
- 'ㅏ': '아', 'ㅐ': '애', 'ㅑ': '야', 'ㅒ': '얘', 'ㅓ': '어', 'ㅔ': '에', 'ㅕ': '여', 'ㅖ': '예',
58
- 'ㅗ': '오', 'ㅘ': '와', 'ㅙ': '왜', 'ㅚ': '외', 'ㅛ': '요', 'ㅜ': '우', 'ㅝ': '워', 'ㅞ': '웨',
59
- 'ㅟ': '위', 'ㅠ': '유', 'ㅡ': '으', 'ㅢ': '의', 'ㅣ': '이',
60
- };
61
45
  /**
62
46
  * @public 1음절 단어를 합치기용 음소(초성 자음 + 중성 모음 [+ 종성])로 분해. 음소 합치기 문제용.
63
47
  * 예: '가' → ['ㄱ','ㅏ'], '강' → ['ㄱ','ㅏ','ㅇ']. 파싱 실패 시 [word].
@@ -185,34 +169,8 @@ export function cardQuestionTitle(typeKey, item, parts) {
185
169
  default: return '';
186
170
  }
187
171
  }
188
- /**
189
- * @public TTS 전용 변환 — 문장 속 따옴표로 감싼 낱개 자모("ㄱ")를 낱자 이름("기역")으로 치환하고 뒤 조사를 맞춘다.
190
- * 표시 텍스트는 자모 그대로 두고(교육용 표기), 합성·캐시 키에만 이 변환을 적용한다. 자음은 명칭(ㄱ→기역),
191
- * 모음은 소릿값(ㅏ→아). 음소 합치기뿐 아니라 음소 바꾸기·자음 탈락 등 자모가 든 모든 문장에 공통 적용된다.
192
- */
193
- export function jamoToNamesForSpeech(text) {
194
- return text.replace(/"([ㄱ-ㅣ])"(으로|와|과|을|를|이|가|은|는|로)?/g, (m, jamo, josa) => {
195
- const name = JAMO_NAME[jamo];
196
- if (!name)
197
- return m;
198
- if (!josa)
199
- return `"${name}"`;
200
- const jong = (name.charCodeAt(name.length - 1) - 0xAC00) % 28;
201
- const hasJong = jong !== 0;
202
- let j = josa;
203
- if (josa === '와' || josa === '과')
204
- j = hasJong ? '과' : '와';
205
- else if (josa === '을' || josa === '를')
206
- j = hasJong ? '을' : '를';
207
- else if (josa === '이' || josa === '가')
208
- j = hasJong ? '이' : '가';
209
- else if (josa === '은' || josa === '는')
210
- j = hasJong ? '은' : '는';
211
- else if (josa === '으로' || josa === '로')
212
- j = (jong === 0 || jong === 8) ? '로' : '으로';
213
- return `"${name}"${j}`;
214
- });
215
- }
172
+ /* `jamoToNamesForSpeech` 는 `./jamoSpeech` 로 옮겼다(말귀 청 (438) ㉳ⓑ) — 이 파일을 통째로 안 끌고 오게. 예전 이름으로도 그대로 나간다 */
173
+ export { jamoToNamesForSpeech } from './jamoSpeech';
216
174
  /** 표준발음 조회 — 없으면 단어 자체(발음 데이터 없는 경우의 안전한 폴백). */
217
175
  function pronOf(word, pronMap) {
218
176
  return pronMap.get(word) || word;
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export declare const CORE_VERSION = "0.443.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.443.0';
49
+ export const CORE_VERSION = '0.445.0';