@ihabdevteam/core 0.423.0 → 0.425.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.
- package/CHANGELOG.md +185 -0
- package/README.md +9 -4
- package/dist/components.cjs.js +183 -183
- package/dist/components.esm.css +1 -1
- package/dist/hooks.cjs.js +5 -5
- package/dist/i18n.cjs.js +1 -1
- package/dist/ihabdevteam-core-tokens.css +1 -1
- package/dist/ihabdevteam-core.cjs.js +191 -191
- package/dist/ihabdevteam-core.css +1 -1
- package/dist/ihabdevteam-core.d.ts +138 -3
- package/dist/packages/core/src/components/HeroVisual.css +390 -0
- package/dist/packages/core/src/components/HeroVisual.d.ts +102 -0
- package/dist/packages/core/src/components/HeroVisual.js +435 -0
- package/dist/packages/core/src/components/Word/WordTableBlock.d.ts +1 -1
- package/dist/packages/core/src/components/Word/WordTableBlock.js +3 -3
- package/dist/packages/core/src/components/Word/wordTableBlockTypes.d.ts +6 -0
- package/dist/packages/core/src/components/WordTable.d.ts +18 -1
- package/dist/packages/core/src/components/WordTable.js +2 -2
- package/dist/packages/core/src/components.d.ts +2 -0
- package/dist/packages/core/src/components.js +1 -0
- package/dist/packages/core/src/hooks/useWordPoolViability.d.ts +24 -0
- package/dist/packages/core/src/hooks/useWordPoolViability.js +101 -0
- package/dist/packages/core/src/hooks/useWordTrainingFilter.d.ts +6 -42
- package/dist/packages/core/src/hooks/useWordTrainingFilter.js +16 -245
- package/dist/packages/core/src/hooks/wordTrainingFilterSections.d.ts +120 -0
- package/dist/packages/core/src/hooks/wordTrainingFilterSections.js +183 -0
- package/dist/packages/core/src/styles.css +6 -1
- package/dist/packages/core/src/tokens.css +17 -7
- package/dist/packages/core/src/version.d.ts +1 -1
- package/dist/packages/core/src/version.js +1 -1
- package/dist/utils.cjs.js +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
'use client';
|
|
2
|
+
/**
|
|
3
|
+
* **풀이 무엇을 허락하는가** — 지금 필터로 고를 수 있는 자모·음절 수와, 나올 낱말 수.
|
|
4
|
+
*
|
|
5
|
+
* `useWordTrainingFilter.ts` 에서 떼어 냈다(사용자 지시 2026-11-08 — *"모두 진행해줘"*).
|
|
6
|
+
* 그 훅이 주석 뺀 454줄이었고, 이 덩어리가 97줄이었다.
|
|
7
|
+
*
|
|
8
|
+
* **왜 여기가 솔기인가** — 이 다섯 효과는 모두 *바깥 세상을 읽어 들이는* 일이다.
|
|
9
|
+
* 낱말 꾸러미를 비동기로 묻고, 창 사건 둘(`wordpool:update` · 그림 있음 캐시)을 듣고,
|
|
10
|
+
* 언어가 바뀌면 다시 묻는다. 반면 남은 훅은 *사용자가 고른 것*을 든다. 읽어 들이는
|
|
11
|
+
* 쪽과 들고 있는 쪽이 한 파일에 섞여 있었다.
|
|
12
|
+
*
|
|
13
|
+
* **읽기만 한다 — 고른 것을 안 건드린다.** 못 고르게 된 자모의 선택을 푸는 일
|
|
14
|
+
* (`setComposition`)은 **부르는 쪽에 남겼다.** 여기서 하면 이 훅이 상태 주인을 둘로
|
|
15
|
+
* 늘리고, 되돌리는 손짓이 두 파일에 걸친다. 들어가는 값과 나오는 값만 보면 되게 둔다.
|
|
16
|
+
*
|
|
17
|
+
* **글자 그대로 옮겼다** — 효과 다섯의 속과 의존성 목록을 한 줄도 안 고쳤다.
|
|
18
|
+
* 효과끼리 순서가 얽혀 있어(풀 판 올림 → 자모 다시 묻기 → 낱말 수 다시 세기)
|
|
19
|
+
* 손대면 조용히 어긋난다.
|
|
20
|
+
*/
|
|
21
|
+
import { useEffect, useRef, useState } from 'react';
|
|
22
|
+
import { useTranslation } from 'react-i18next';
|
|
23
|
+
import { getViableComposition, countUsableWords } from '../utils/wordTrainingRuntime';
|
|
24
|
+
import { IMAGE_EXISTENCE_CACHE_UPDATED } from '../utils/imageConfig';
|
|
25
|
+
import { useWindowEvent } from './useWindowEvent';
|
|
26
|
+
import { valueToJamos, NO_CODA, syllableToFilter } from './wordTrainingFilterModel';
|
|
27
|
+
export function useWordPoolViability(args) {
|
|
28
|
+
const { caps, difficulty, contrastCount, composition, phonemeView, excludeNoImage, sameStructureOnly, gradeFilter } = args;
|
|
29
|
+
const { i18n } = useTranslation();
|
|
30
|
+
const [viable, setViable] = useState({ cho: new Set(), jung: new Set(), jong: new Set(), syllable: new Set() });
|
|
31
|
+
// viable 자모 데이터가 최초 로드되기 전에는 저장된 선택을 해제하지 않는다
|
|
32
|
+
const [viableReady, setViableReady] = useState(false);
|
|
33
|
+
// 현재 필터 조건으로 가능한 정답 단어 수 (안내 문구용). null = 계산 전
|
|
34
|
+
const [wordCount, setWordCount] = useState(null);
|
|
35
|
+
const [poolVersion, setPoolVersion] = useState(0);
|
|
36
|
+
// 단어 풀 갱신 이벤트 구독
|
|
37
|
+
useWindowEvent('wordpool:update', () => setPoolVersion(v => v + 1));
|
|
38
|
+
useWindowEvent(IMAGE_EXISTENCE_CACHE_UPDATED, () => setPoolVersion(v => v + 1));
|
|
39
|
+
// 언어 전환 시에도 poolVersion을 올려 재생성을 트리거한다.
|
|
40
|
+
// useWordTrainingDataGeneration의 batch 생성 effect는 (다른 렌더에서 매번 새 배열이 되는)
|
|
41
|
+
// types를 의존성에서 의도적으로 제외하므로, types의 label/subTitle이 바뀌는 유일한 외부
|
|
42
|
+
// 요인인 언어 전환을 poolVersion에 반영하지 않으면 perTypeData가 이전 언어로 고정된다.
|
|
43
|
+
const langRef = useRef(i18n.language);
|
|
44
|
+
useEffect(() => {
|
|
45
|
+
if (langRef.current !== i18n.language) {
|
|
46
|
+
langRef.current = i18n.language;
|
|
47
|
+
setPoolVersion(v => v + 1);
|
|
48
|
+
}
|
|
49
|
+
}, [i18n.language]);
|
|
50
|
+
// 위치별 사용 가능 자모 계산 (단어 구성 필터를 노출하는 그룹만)
|
|
51
|
+
useEffect(() => {
|
|
52
|
+
if (!caps.choseong)
|
|
53
|
+
return;
|
|
54
|
+
let cancelled = false;
|
|
55
|
+
getViableComposition({ difficulty, excludeNoImage })
|
|
56
|
+
.then(v => {
|
|
57
|
+
if (cancelled)
|
|
58
|
+
return;
|
|
59
|
+
setViable(v);
|
|
60
|
+
// 빈 결과 = 단어 풀 미로드 상태. 앞서 한 번 준비됐더라도 갱신 중엔 다시
|
|
61
|
+
// 준비 안 됨으로 돌려 저장된 음소 선택을 빈 집합으로 검증하지 않는다.
|
|
62
|
+
setViableReady(v.cho.size + v.jung.size + v.jong.size > 0);
|
|
63
|
+
})
|
|
64
|
+
.catch(() => {
|
|
65
|
+
if (!cancelled) {
|
|
66
|
+
setViable({ cho: new Set(), jung: new Set(), jong: new Set(), syllable: new Set() });
|
|
67
|
+
setViableReady(false);
|
|
68
|
+
}
|
|
69
|
+
});
|
|
70
|
+
return () => { cancelled = true; };
|
|
71
|
+
}, [caps.choseong, difficulty, excludeNoImage, poolVersion]);
|
|
72
|
+
// 현재 필터 조건으로 가능한 정답 단어 수 계산 (버튼 선택이 바뀔 때마다)
|
|
73
|
+
useEffect(() => {
|
|
74
|
+
let cancelled = false;
|
|
75
|
+
// 선택된 단어 구성 → CompositionFilter (선택 값을 자모로 분해, 종성 '제외'=jongNone, 음절수 범위 확장)
|
|
76
|
+
// 병합 버튼(예: 'ㅔㅐ')은 각 자모 OR 매칭, 단일/겹받침은 정확 매칭.
|
|
77
|
+
const c = composition;
|
|
78
|
+
const cho = c.cho ? valueToJamos(c.cho) : null;
|
|
79
|
+
const jung = c.jung ? valueToJamos(c.jung) : null;
|
|
80
|
+
const jongNone = c.jong === NO_CODA;
|
|
81
|
+
const jong = jongNone ? null : (c.jong ? valueToJamos(c.jong) : null);
|
|
82
|
+
const syllable = c.syllable != null ? syllableToFilter(c.syllable) : null;
|
|
83
|
+
const hasComp = !!(cho || jung || jong || jongNone || syllable);
|
|
84
|
+
countUsableWords({
|
|
85
|
+
difficulty: caps.difficulty ? difficulty : null,
|
|
86
|
+
contrastCount: caps.difficulty ? contrastCount : 1,
|
|
87
|
+
composition: caps.choseong && hasComp ? { cho, jung, jong, jongNone, syllable } : null,
|
|
88
|
+
excludeNoImage,
|
|
89
|
+
sameStructureOnly,
|
|
90
|
+
// 런타임 카운트는 'direct'(글자 입력=패턴)를 이해하지 못한다 — 철자 기반이므로 'char'로 취급.
|
|
91
|
+
phonemeView: phonemeView === 'pron' ? 'pron' : 'char',
|
|
92
|
+
grade: gradeFilter.length > 0 ? gradeFilter : null,
|
|
93
|
+
})
|
|
94
|
+
.then(n => { if (!cancelled)
|
|
95
|
+
setWordCount(n); })
|
|
96
|
+
.catch(() => { if (!cancelled)
|
|
97
|
+
setWordCount(null); });
|
|
98
|
+
return () => { cancelled = true; };
|
|
99
|
+
}, [caps.choseong, caps.difficulty, difficulty, contrastCount, composition, phonemeView, excludeNoImage, sameStructureOnly, poolVersion, gradeFilter]);
|
|
100
|
+
return { viable, viableReady, wordCount, poolVersion };
|
|
101
|
+
}
|
|
@@ -1,8 +1,10 @@
|
|
|
1
|
-
import type { TFunction } from 'i18next';
|
|
2
1
|
import { type FilterPanelSection } from '../types/filterPanel';
|
|
3
2
|
import { type WordComposition } from './wordTrainingFilterModel';
|
|
4
3
|
export { valueToJamos, NO_CODA, SYLLABLE_MIN, syllableToFilter, charToPronValue, pronToCharValue, convertComposition, EMPTY_COMPOSITION, } from './wordTrainingFilterModel';
|
|
5
4
|
export type { WordComposition } from './wordTrainingFilterModel';
|
|
5
|
+
import { type WordTrainingFilterCaps } from './wordTrainingFilterSections';
|
|
6
|
+
export { gradeDescriptions } from './wordTrainingFilterSections';
|
|
7
|
+
export type { WordTrainingFilterCaps } from './wordTrainingFilterSections';
|
|
6
8
|
/** 설정 팝업 취소 시 되돌릴 필터 스냅샷 */
|
|
7
9
|
export interface WordFilterSnapshot {
|
|
8
10
|
composition: WordComposition;
|
|
@@ -18,49 +20,11 @@ export interface WordFilterSnapshot {
|
|
|
18
20
|
wordTypeFilter?: string[];
|
|
19
21
|
}
|
|
20
22
|
/**
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
+
* 단어 훈련 그룹별 필터 상태.
|
|
24
|
+
* @param groupKey 그룹 식별자 (localStorage 키 및 상태 격리에 사용)
|
|
25
|
+
* @param caps 그룹이 노출할 설정 (난이도/단어구성). 제외 필터는 항상 노출.
|
|
23
26
|
* @public
|
|
24
27
|
*/
|
|
25
|
-
export interface WordTrainingFilterCaps {
|
|
26
|
-
difficulty: boolean;
|
|
27
|
-
/** 단어 구성(초성/중성/종성) 필터 노출 여부 */
|
|
28
|
-
choseong: boolean;
|
|
29
|
-
/** 품사 필터 노출 여부 — 단어표/대립쌍표와 동일 라벨(useWordAttributeFilter 공용). 기본 false. */
|
|
30
|
-
partOfSpeech?: boolean;
|
|
31
|
-
/** 어종 필터 노출 여부 — 단어표/대립쌍표와 동일 라벨(useWordAttributeFilter 공용). 기본 false. */
|
|
32
|
-
wordType?: boolean;
|
|
33
|
-
/**
|
|
34
|
-
* 한 음절을 특정해야 하는 타입(듣고 한 음절 포함 단어 맞히기 등)용.
|
|
35
|
-
* true면 초성/모음/종성의 '모두' 버튼을 없애고 항상 하나가 선택되도록 하며(재클릭 해제 안 됨),
|
|
36
|
-
* 초기값을 ㄱ+ㅏ+제외('가')로 시드해 재생할 음절이 항상 확정되게 한다.
|
|
37
|
-
*/
|
|
38
|
-
requireSyllable?: boolean;
|
|
39
|
-
/**
|
|
40
|
-
* 음절 수를 특정 값으로 고정해야 하는 타입(음절 합치기 등)용. 설정 시 '음절 수' 필터 섹션 자체를
|
|
41
|
-
* 노출하지 않고(사용자가 바꿀 수 없음) composition.syllable을 항상 이 값으로 유지한다.
|
|
42
|
-
*/
|
|
43
|
-
fixedSyllable?: number;
|
|
44
|
-
/**
|
|
45
|
-
* 종성을 '제외'(받침 없음)로 고정해야 하는 타입(음소 2개 합치기=초성+중성=CV)용.
|
|
46
|
-
* 설정 시 종성 필터는 '제외'만 활성·선택되고 나머지 자모·'모두'는 비활성화된다.
|
|
47
|
-
*/
|
|
48
|
-
fixedNoCoda?: boolean;
|
|
49
|
-
/**
|
|
50
|
-
* 종성이 반드시 있어야 하는 타입(음소 3개 합치기=초성+중성+종성=CVC)용.
|
|
51
|
-
* 설정 시 종성 '제외'(받침 없음) 버튼을 아예 노출하지 않는다.
|
|
52
|
-
*/
|
|
53
|
-
requireCoda?: boolean;
|
|
54
|
-
}
|
|
55
|
-
/**
|
|
56
|
-
* 등급 고르개의 설명 줄들 — 지금 언어로. 사전에 배열이 없으면 한국어 원문.
|
|
57
|
-
*
|
|
58
|
-
* **공개 API 가 아니다**(대응표에 `internal`) — 코어 안에서만 쓰고, 내보내는 것은 못이 읽기 때문이다.
|
|
59
|
-
* 그래도 **이름은 영어다** — `internal` 이라도 배포 `d.ts` 에는 그대로 나가 소비자 편집기에 보인다
|
|
60
|
-
* (사용자 지시 2026-10-13. 소비자 사용처 0 이라 옛 이름을 남기지 않았다 — 말귀의 같은 이름 함수는 제 지역 것이다).
|
|
61
|
-
* 앱은 제 열쇠(`wordSearch.filter.gradeInfo`)와 제 받는 함수를 따로 갖는다.
|
|
62
|
-
*/
|
|
63
|
-
export declare function gradeDescriptions(t: TFunction): string[];
|
|
64
28
|
export declare function useWordTrainingFilter(groupKey: string, caps: WordTrainingFilterCaps, opts?: {
|
|
65
29
|
resetOnMount?: boolean;
|
|
66
30
|
resetKey?: string;
|
|
@@ -1,21 +1,22 @@
|
|
|
1
1
|
'use client';
|
|
2
2
|
import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
|
|
3
3
|
import { useTranslation } from 'react-i18next';
|
|
4
|
-
import { getViableComposition, countUsableWords } from '../utils/wordTrainingRuntime';
|
|
5
|
-
import { IMAGE_EXISTENCE_CACHE_UPDATED } from '../utils/imageConfig';
|
|
6
4
|
import { FILTER_ALL_VALUE } from '../types/filterPanel';
|
|
7
|
-
import {
|
|
8
|
-
import { useWordAttributeFilterKeys
|
|
5
|
+
import { useWordPoolViability } from './useWordPoolViability';
|
|
6
|
+
import { useWordAttributeFilterKeys } from './useWordAttributeFilter';
|
|
9
7
|
import { matchesFilters } from '../utils/phonemePairSearch';
|
|
10
8
|
import { wordAttributeValueCodeOf, wordAttributeValueLabelOf, isGradeCode } from '../utils/wordAttributeFilterCodes';
|
|
11
9
|
/** 저장된 등급을 되읽을 때 코드 아닌 것은 버린다 — 0.320.0 작업본이 잠깐 `['']` 를 저장했다 */
|
|
12
10
|
const gradeCodesOnly = (v) => (Array.isArray(v) ? v.filter(isGradeCode) : []);
|
|
13
11
|
import { hasSel } from '../utils/wordContrast';
|
|
14
|
-
import { phoneticLabel } from '../utils/phonemeGroups';
|
|
15
12
|
/* 글자↔발음 변환과 음절 상수는 wordTrainingFilterModel.ts 로 옮겼다(React 없는 순수 계층).
|
|
16
13
|
**공개하던 이름은 여기서 그대로 다시 내보낸다** — 가져다 쓰는 쪽은 바뀌지 않는다. */
|
|
17
|
-
import { valueToJamos, NO_CODA, SYLLABLE_MIN, SYLLABLE_COUNTS, syllableValue, parseSyllableValue,
|
|
14
|
+
import { valueToJamos, NO_CODA, SYLLABLE_MIN, SYLLABLE_COUNTS, syllableValue, parseSyllableValue, PART_JAMOS, convertComposition, EMPTY_COMPOSITION, } from './wordTrainingFilterModel';
|
|
18
15
|
export { valueToJamos, NO_CODA, SYLLABLE_MIN, syllableToFilter, charToPronValue, pronToCharValue, convertComposition, EMPTY_COMPOSITION, } from './wordTrainingFilterModel';
|
|
16
|
+
/* 화면 구역 만들기는 wordTrainingFilterSections.ts 로 옮겼다(React 없는 순수 계층).
|
|
17
|
+
**공개하던 이름은 여기서 그대로 다시 내보낸다** — 가져다 쓰는 쪽은 바뀌지 않는다. */
|
|
18
|
+
import { buildWordTrainingFilterLabels, buildWordTrainingFilterSections, } from './wordTrainingFilterSections';
|
|
19
|
+
export { gradeDescriptions } from './wordTrainingFilterSections';
|
|
19
20
|
// ─── localStorage 지속성 ────────────────────────────────────────────────────
|
|
20
21
|
const LEGACY_STORAGE_KEY = 'wt_filter';
|
|
21
22
|
const storageKey = (groupKey) => `wt_filter_${groupKey}`;
|
|
@@ -78,26 +79,6 @@ function readComposition(saved) {
|
|
|
78
79
|
* @param caps 그룹이 노출할 설정 (난이도/단어구성). 제외 필터는 항상 노출.
|
|
79
80
|
* @public
|
|
80
81
|
*/
|
|
81
|
-
/** 사전이 배열을 안 주면 한국어 원문으로 물러선다 — 빈 줄을 띄우지 않는다((205)) */
|
|
82
|
-
const GRADE_DESCRIPTIONS_KO = [
|
|
83
|
-
'1등급 : 학령전기에 습득하여 평생에 걸쳐 일상 언어생활을 하는 데 사용되는 어휘',
|
|
84
|
-
'2등급 : 초등학교 1-2학년 난이도 어휘',
|
|
85
|
-
'3등급 : 초등학교 3-4학년 난이도 어휘',
|
|
86
|
-
'4등급 : 초등학교 5-6학년 난이도 어휘',
|
|
87
|
-
'등급없음 : 국립국어원 표준 어휘 외 고빈도 생활 어휘, 신조어 및 외래어',
|
|
88
|
-
];
|
|
89
|
-
/**
|
|
90
|
-
* 등급 고르개의 설명 줄들 — 지금 언어로. 사전에 배열이 없으면 한국어 원문.
|
|
91
|
-
*
|
|
92
|
-
* **공개 API 가 아니다**(대응표에 `internal`) — 코어 안에서만 쓰고, 내보내는 것은 못이 읽기 때문이다.
|
|
93
|
-
* 그래도 **이름은 영어다** — `internal` 이라도 배포 `d.ts` 에는 그대로 나가 소비자 편집기에 보인다
|
|
94
|
-
* (사용자 지시 2026-10-13. 소비자 사용처 0 이라 옛 이름을 남기지 않았다 — 말귀의 같은 이름 함수는 제 지역 것이다).
|
|
95
|
-
* 앱은 제 열쇠(`wordSearch.filter.gradeInfo`)와 제 받는 함수를 따로 갖는다.
|
|
96
|
-
*/
|
|
97
|
-
export function gradeDescriptions(t) {
|
|
98
|
-
const v = t('wordPairs.filter.difficultyInfo', { returnObjects: true, defaultValue: GRADE_DESCRIPTIONS_KO });
|
|
99
|
-
return Array.isArray(v) && v.length > 0 && v.every(x => typeof x === 'string') ? v : GRADE_DESCRIPTIONS_KO;
|
|
100
|
-
}
|
|
101
82
|
export function useWordTrainingFilter(groupKey, caps, opts) {
|
|
102
83
|
const { t, i18n } = useTranslation();
|
|
103
84
|
// resetOnMount(단어훈련 만들기 등): 진입 시 항상 기본값에서 시작하도록 저장값을 불러오지 않는다.
|
|
@@ -178,11 +159,6 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
|
|
|
178
159
|
const typeLabels = useMemo(() => Object.keys(attrKeys.typeMap), [attrKeys]);
|
|
179
160
|
const posFilter = useMemo(() => posCodes.map(c => posLabels[POS_CODES.indexOf(c)]).filter(Boolean), [posCodes, posLabels]);
|
|
180
161
|
const wordTypeFilter = useMemo(() => typeCodes.map(c => typeLabels[TYPE_CODES.indexOf(c)]).filter(Boolean), [typeCodes, typeLabels]);
|
|
181
|
-
const [viable, setViable] = useState({ cho: new Set(), jung: new Set(), jong: new Set(), syllable: new Set() });
|
|
182
|
-
// viable 자모 데이터가 최초 로드되기 전에는 저장된 선택을 해제하지 않는다
|
|
183
|
-
const [viableReady, setViableReady] = useState(false);
|
|
184
|
-
// 현재 필터 조건으로 가능한 정답 단어 수 (안내 문구용). null = 계산 전
|
|
185
|
-
const [wordCount, setWordCount] = useState(null);
|
|
186
162
|
// count 모드는 위치 무관 음소 차이라 1음절 단어도 2개 차이가 가능 → 음절수 제약 없음(최소 1).
|
|
187
163
|
const minSyllables = 1;
|
|
188
164
|
// 훈련할 음소를 고른 슬롯(초성/모음/종성) 수 = 정답↔오답이 달라야 하는 음소의 최소 개수.
|
|
@@ -234,71 +210,11 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
|
|
|
234
210
|
}
|
|
235
211
|
catch { }
|
|
236
212
|
}, [opts?.resetOnMount, groupKey, hydratedKey, contrastCount, composition, excludeNoImage, sameStructureOnly, phonemeView, gradeFilter, posCodes, typeCodes]);
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
// useWordTrainingDataGeneration의 batch 생성 effect는 (다른 렌더에서 매번 새 배열이 되는)
|
|
243
|
-
// types를 의존성에서 의도적으로 제외하므로, types의 label/subTitle이 바뀌는 유일한 외부
|
|
244
|
-
// 요인인 언어 전환을 poolVersion에 반영하지 않으면 perTypeData가 이전 언어로 고정된다.
|
|
245
|
-
const langRef = useRef(i18n.language);
|
|
246
|
-
useEffect(() => {
|
|
247
|
-
if (langRef.current !== i18n.language) {
|
|
248
|
-
langRef.current = i18n.language;
|
|
249
|
-
setPoolVersion(v => v + 1);
|
|
250
|
-
}
|
|
251
|
-
}, [i18n.language]);
|
|
252
|
-
// 위치별 사용 가능 자모 계산 (단어 구성 필터를 노출하는 그룹만)
|
|
253
|
-
useEffect(() => {
|
|
254
|
-
if (!caps.choseong)
|
|
255
|
-
return;
|
|
256
|
-
let cancelled = false;
|
|
257
|
-
getViableComposition({ difficulty, excludeNoImage })
|
|
258
|
-
.then(v => {
|
|
259
|
-
if (cancelled)
|
|
260
|
-
return;
|
|
261
|
-
setViable(v);
|
|
262
|
-
// 빈 결과 = 단어 풀 미로드 상태. 앞서 한 번 준비됐더라도 갱신 중엔 다시
|
|
263
|
-
// 준비 안 됨으로 돌려 저장된 음소 선택을 빈 집합으로 검증하지 않는다.
|
|
264
|
-
setViableReady(v.cho.size + v.jung.size + v.jong.size > 0);
|
|
265
|
-
})
|
|
266
|
-
.catch(() => {
|
|
267
|
-
if (!cancelled) {
|
|
268
|
-
setViable({ cho: new Set(), jung: new Set(), jong: new Set(), syllable: new Set() });
|
|
269
|
-
setViableReady(false);
|
|
270
|
-
}
|
|
271
|
-
});
|
|
272
|
-
return () => { cancelled = true; };
|
|
273
|
-
}, [caps.choseong, difficulty, excludeNoImage, poolVersion]);
|
|
274
|
-
// 현재 필터 조건으로 가능한 정답 단어 수 계산 (버튼 선택이 바뀔 때마다)
|
|
275
|
-
useEffect(() => {
|
|
276
|
-
let cancelled = false;
|
|
277
|
-
// 선택된 단어 구성 → CompositionFilter (선택 값을 자모로 분해, 종성 '제외'=jongNone, 음절수 범위 확장)
|
|
278
|
-
// 병합 버튼(예: 'ㅔㅐ')은 각 자모 OR 매칭, 단일/겹받침은 정확 매칭.
|
|
279
|
-
const c = composition;
|
|
280
|
-
const cho = c.cho ? valueToJamos(c.cho) : null;
|
|
281
|
-
const jung = c.jung ? valueToJamos(c.jung) : null;
|
|
282
|
-
const jongNone = c.jong === NO_CODA;
|
|
283
|
-
const jong = jongNone ? null : (c.jong ? valueToJamos(c.jong) : null);
|
|
284
|
-
const syllable = c.syllable != null ? syllableToFilter(c.syllable) : null;
|
|
285
|
-
const hasComp = !!(cho || jung || jong || jongNone || syllable);
|
|
286
|
-
countUsableWords({
|
|
287
|
-
difficulty: caps.difficulty ? difficulty : null,
|
|
288
|
-
contrastCount: caps.difficulty ? contrastCount : 1,
|
|
289
|
-
composition: caps.choseong && hasComp ? { cho, jung, jong, jongNone, syllable } : null,
|
|
290
|
-
excludeNoImage,
|
|
291
|
-
sameStructureOnly,
|
|
292
|
-
// 런타임 카운트는 'direct'(글자 입력=패턴)를 이해하지 못한다 — 철자 기반이므로 'char'로 취급.
|
|
293
|
-
phonemeView: phonemeView === 'pron' ? 'pron' : 'char',
|
|
294
|
-
grade: gradeFilter.length > 0 ? gradeFilter : null,
|
|
295
|
-
})
|
|
296
|
-
.then(n => { if (!cancelled)
|
|
297
|
-
setWordCount(n); })
|
|
298
|
-
.catch(() => { if (!cancelled)
|
|
299
|
-
setWordCount(null); });
|
|
300
|
-
return () => { cancelled = true; };
|
|
301
|
-
}, [caps.choseong, caps.difficulty, difficulty, contrastCount, composition, phonemeView, excludeNoImage, sameStructureOnly, poolVersion, gradeFilter]);
|
|
213
|
+
/* 풀이 무엇을 허락하는가 — 자모·음절 수와 낱말 수는 useWordPoolViability 가 센다.
|
|
214
|
+
효과 다섯(창 사건 둘 · 언어 바뀜 · 자모 묻기 · 낱말 수 세기)이 그 안에 있다. */
|
|
215
|
+
const { viable, viableReady, wordCount, poolVersion } = useWordPoolViability({
|
|
216
|
+
caps, difficulty, contrastCount, composition, phonemeView, excludeNoImage, sameStructureOnly, gradeFilter,
|
|
217
|
+
});
|
|
302
218
|
// 난이도/풀 변경 시 비활성 자모 선택 해제 (viable 로드 완료 후에만)
|
|
303
219
|
/* eslint-disable react-hooks/set-state-in-effect */
|
|
304
220
|
useEffect(() => {
|
|
@@ -352,159 +268,14 @@ export function useWordTrainingFilter(groupKey, caps, opts) {
|
|
|
352
268
|
min: [...viable.syllable].some(n => n >= SYLLABLE_MIN),
|
|
353
269
|
}), [viable]);
|
|
354
270
|
// 번역된 레이블 — 표시용. 내부 로직은 여전히 한국어 상수 키로 동작
|
|
355
|
-
const LABELS = useMemo(() => (
|
|
356
|
-
// 정답 단어 구성 — 음절수/초성/모음/종성 (정답 단어에만 적용)
|
|
357
|
-
composition: t('wordPairs.composition', '정답 단어 구성'),
|
|
358
|
-
syllableCount: t('wordPairs.syllableCount', '음절 수'),
|
|
359
|
-
onset: t('wordPairs.onset', '초성'),
|
|
360
|
-
vowel: t('wordPairs.vowel', '모음'),
|
|
361
|
-
coda: t('wordPairs.coda', '종성'),
|
|
362
|
-
// 훈련할 음소 섹션 라벨 — 대립 종류 항목(onset/vowel/coda)과 별개의 섹션 식별 키
|
|
363
|
-
phonemeGroup: t('training.filter.phonemeGroup', { defaultValue: '훈련 음절' }),
|
|
364
|
-
trainOnset: t('training.filter.trainOnset', { defaultValue: '초성' }),
|
|
365
|
-
trainVowel: t('training.filter.trainVowel', { defaultValue: '모음' }),
|
|
366
|
-
trainCoda: t('training.filter.trainCoda', { defaultValue: '종성' }),
|
|
367
|
-
random: t('training.filter.random', '무작위'),
|
|
368
|
-
exclude: t('wordSearch.filter.exclude', '제외'),
|
|
369
|
-
// '제외' 섹션의 표시 라벨(식별자는 exclude 유지, 표시만 '선택')
|
|
370
|
-
selectLabel: t('training.filter.selectSection', { defaultValue: '선택' }),
|
|
371
|
-
none: t('common.none', '없음'),
|
|
372
|
-
noImage: t('wordSearch.filter.excludeNoImage', '이미지 없음'),
|
|
373
|
-
// 선택 섹션 토글 버튼 라벨(긍정형 필터)
|
|
374
|
-
excludeImage: t('training.filter.excludeImage', { defaultValue: '이미지 있는 단어만' }),
|
|
375
|
-
sameStructure: t('training.filter.sameStructure', { defaultValue: '음소 구조 같은 단어만' }),
|
|
376
|
-
// 훈련 음소(초성/모음/종성)의 '전체' — 해당 자리를 제한하지 않음(WordSearchPage의 위치 섹션과
|
|
377
|
-
// 통일해 locale 값 '무관'이 실제 표기 — '전체/모두'는 "모든 자모가 선택된 상태"로 오해될 수 있다)
|
|
378
|
-
noLimit: t('training.filter.noLimit', { defaultValue: '무관' }),
|
|
379
|
-
// 종성 섹션의 '제외' — 받침 있는 단어를 제외(받침 없는 단어만) = NO_CODA
|
|
380
|
-
codaExclude: t('training.filter.codaExclude', { defaultValue: '제외' }),
|
|
381
|
-
gradeLabel: t('training.filter.gradeLabel', { defaultValue: '난이도 등급' }),
|
|
382
|
-
}), [t]);
|
|
271
|
+
const LABELS = useMemo(() => buildWordTrainingFilterLabels(t), [t]);
|
|
383
272
|
// 구성요소 섹션 라벨 → part 매핑
|
|
384
273
|
const partByLabel = useMemo(() => ({
|
|
385
274
|
[LABELS.trainOnset]: 'cho', [LABELS.trainVowel]: 'jung', [LABELS.trainCoda]: 'jong',
|
|
386
275
|
}), [LABELS]);
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
const selectInfoItems = useMemo(() => [
|
|
391
|
-
t('training.filter.excludeImageInfo', { defaultValue: '이미지 있는 단어만: 단어 중에 이미지가 있는 단어만 결과에 보여줍니다.' }),
|
|
392
|
-
t('training.filter.sameStructureInfo', { defaultValue: '음소 구조 같은 단어만: 정답과 오답의 음절 구조(글자 수·받침 유무 등)가 같은 결과만 남겨요.' }),
|
|
393
|
-
], [t]);
|
|
394
|
-
const filterSections = useMemo(() => {
|
|
395
|
-
const sections = [];
|
|
396
|
-
if (caps.choseong) {
|
|
397
|
-
// 초성/모음/종성 단일 선택.
|
|
398
|
-
// 글자 선택(char): 전체 자모를 사전순 버튼 나열(정확 매칭).
|
|
399
|
-
// 발음 선택(pron): 조음/음성 특성별 클러스터(groups)로 간격 구분, 동음 모음은 병합 버튼, 종성은 '없음' 포함.
|
|
400
|
-
// groupLabel(phonemeGroup)은 "훈련 음소" 패널 소속을 나타내는 파티션 태그로 사용한다.
|
|
401
|
-
// 종성 '제외' 버튼(받침 있는 단어 제외 = NO_CODA). '제한 없음' 바로 옆에 노출, 항상 활성.
|
|
402
|
-
const codaExcludeItem = { value: NO_CODA, displayLabel: LABELS.codaExclude };
|
|
403
|
-
// 종성 '제외' 고정(fixedNoCoda) — 종성 칸은 '제외'만 활성·선택하고 나머지 자모·'모두'는 비활성화한다.
|
|
404
|
-
const jongFixedExclude = caps.fixedNoCoda === true;
|
|
405
|
-
const partSection = (part, label) => {
|
|
406
|
-
const lockJong = jongFixedExclude && part === 'jong';
|
|
407
|
-
const base = {
|
|
408
|
-
label,
|
|
409
|
-
groupLabel: LABELS.phonemeGroup,
|
|
410
|
-
// 한 음절 특정 타입은 '모두' 없이 항상 하나를 고르게 한다. 종성 고정 칸은 '모두'를 비활성화.
|
|
411
|
-
allOption: !caps.requireSyllable,
|
|
412
|
-
allLabel: LABELS.noLimit,
|
|
413
|
-
allOptionDisabled: lockJong,
|
|
414
|
-
};
|
|
415
|
-
if (phonemeView === 'pron') {
|
|
416
|
-
// 클러스터별 버튼 그룹. 병합 버튼(다자모)은 자모 중 하나라도 viable 하면 활성.
|
|
417
|
-
// tooltip(조음 정보)은 버튼 hover 시 노출(대립쌍표와 동일). 글은 여기서 로케일대로 만든다.
|
|
418
|
-
const groups = PHONEME_CLUSTERS[part].map(cluster => cluster.map(({ v, phonetic }) => {
|
|
419
|
-
const jamos = valueToJamos(v);
|
|
420
|
-
const tooltip = phoneticLabel(t, phonetic);
|
|
421
|
-
const disabled = lockJong || !jamos.some(j => viable[part].has(j));
|
|
422
|
-
// 병합(다자모) 버튼은 labels 배열로 넘겨 각 자모를 개별 span으로 렌더(표준 라벨 간격).
|
|
423
|
-
return jamos.length > 1
|
|
424
|
-
? { value: v, labels: jamos, tooltip, disabled }
|
|
425
|
-
: { value: v, tooltip, disabled };
|
|
426
|
-
}));
|
|
427
|
-
// 종성 필수 타입(requireCoda)은 '제외'(받침 없음) 버튼을 노출하지 않는다.
|
|
428
|
-
if (part === 'jong' && !caps.requireCoda)
|
|
429
|
-
groups.unshift([codaExcludeItem]);
|
|
430
|
-
return { ...base, groups };
|
|
431
|
-
}
|
|
432
|
-
const items = PART_JAMOS[part].map(c => (!lockJong && partViable[part].has(c)) ? c : { value: c, disabled: true });
|
|
433
|
-
return { ...base, items: (part === 'jong' && !caps.requireCoda) ? [codaExcludeItem, ...items] : items };
|
|
434
|
-
};
|
|
435
|
-
// 훈련 음소 — 훈련 대상 음소 선택이 가장 중요한 설정이므로 제일 위에 노출.
|
|
436
|
-
sections.push(partSection('cho', LABELS.trainOnset));
|
|
437
|
-
sections.push(partSection('jung', LABELS.trainVowel));
|
|
438
|
-
// 종성: 자모 + '제외'(받침 없는 단어만) 버튼
|
|
439
|
-
sections.push(partSection('jong', LABELS.trainCoda));
|
|
440
|
-
}
|
|
441
|
-
// 난이도 등급 — 정답(후보) 단어에만 적용되는 긍정형 다중 토글. 순서: 난이도 등급 → 품사 → 어종 → 음절 수 → 선택.
|
|
442
|
-
// 라벨/항목 구성은 단어표·대립쌍표와 공용(useWordAttributeFilter) — gradeLabel은 이 그룹 전용 표시명을 쓰므로
|
|
443
|
-
// label만 오버라이드하고 나머지(items/allOption 등)는 공용 빌더 그대로 사용.
|
|
444
|
-
sections.push({
|
|
445
|
-
...buildGradeSection(t, attrKeys, {
|
|
446
|
-
/* **등급마다 무엇인지 적는다**(말귀 요청 (205), 사장님이 주신 글 — 2026-10-12). 전에는
|
|
447
|
-
*"국립국어원의 기초 어휘 등급이 결과에 반영됩니다"* 한 줄이라, 1등급이 쉬운 쪽인지
|
|
448
|
-
어려운 쪽인지도 알 수 없었다. 앱 두 화면에는 이미 이 다섯 줄이 들어가 있어
|
|
449
|
-
(앱 열쇠 `wordSearch.filter.gradeInfo`), 이 자리만 한 줄로 남아 **세 화면이 다른 말**을
|
|
450
|
-
하고 있었다 — 글자까지 같은 것을 쓴다.
|
|
451
|
-
|
|
452
|
-
**한 열쇠에 배열로 둔다**(말귀 요청, 2026-10-12). 처음엔 `difficultyInfo1`~`5` 로 나눴는데
|
|
453
|
-
그러면 ① 말귀 못(`deadI18nKeys`)이 **산 열쇠를 죽은 것으로** 센다 — 그 못은 `a.b.${x}` 처럼
|
|
454
|
-
**점 자리에서 잘린 앞머리**를 쓰는 것으로 세는데, 이것은 *마지막 마디 뒤에 숫자를 붙여*
|
|
455
|
-
안 걸린다. ② **줄 수가 다섯에 못 박힌다** — 배열이면 언어마다 줄 수가 달라도 된다.
|
|
456
|
-
③ 앱이 같은 꼴(`returnObjects`)을 이미 쓴다.
|
|
457
|
-
|
|
458
|
-
사전이 배열을 안 주면(옛 사전을 덮어쓴 소비자 등) **한국어 원문으로 물러선다** — 빈 줄을
|
|
459
|
-
띄우지 않는다. 재 보고 적는다: `returnObjects` 는 배열을 그대로 주고 `defaultValue` 도
|
|
460
|
-
배열로 물러선다(i18next 26.4.1). */
|
|
461
|
-
labelInfo: infoAction(gradeDescriptions(t)),
|
|
462
|
-
}),
|
|
463
|
-
label: LABELS.gradeLabel,
|
|
464
|
-
});
|
|
465
|
-
// 품사/어종 — 단어표·대립쌍표와 동일 라벨(공용 훅). caps로 노출 여부 결정(기본 미노출).
|
|
466
|
-
if (caps.partOfSpeech)
|
|
467
|
-
sections.push(buildPartOfSpeechSection(attrKeys));
|
|
468
|
-
if (caps.wordType)
|
|
469
|
-
sections.push(buildWordTypeSection(attrKeys));
|
|
470
|
-
// '다른 음소의 총 갯수' UI 제거 — 대립 갯수는 선택한 훈련 음소 수(minDiffCount)로 자동 결정된다.
|
|
471
|
-
// 음절 수 — 정답+오답 모든 단어가 같은 음절수여야 함(문제 공통 설정).
|
|
472
|
-
// choseong(훈련 음소) 타입뿐 아니라, fixedSyllable만 지정된 타입(음소 합치기 등 — 훈련 음소
|
|
473
|
-
// 선택 없이 음절 수만 고정)도 노출한다. fixedSyllable 타입은 그 값(예: 1음절)만 활성·선택하고
|
|
474
|
-
// 나머지 버튼('전체' 포함)은 비활성화한다 — 섹션이 갑자기 사라지는 것보다 UX가 낫다.
|
|
475
|
-
if (caps.choseong || caps.fixedSyllable != null) {
|
|
476
|
-
const fixed = caps.fixedSyllable;
|
|
477
|
-
sections.push({
|
|
478
|
-
label: LABELS.syllableCount,
|
|
479
|
-
items: [
|
|
480
|
-
...SYLLABLE_COUNTS.map(n => ({
|
|
481
|
-
value: syllableValue(n),
|
|
482
|
-
displayLabel: t('wordPairs.syllableN', { n, defaultValue: '{{n}}음절' }),
|
|
483
|
-
// fixedSyllable이면 그 값만 활성. 아니면 풀에 없거나 대립 갯수보다 음절 수가 적으면 비활성.
|
|
484
|
-
disabled: fixed != null ? n !== fixed : (!syllableViable.exact.has(n) || n < minSyllables),
|
|
485
|
-
})),
|
|
486
|
-
// 'N음절 이상' catch-all
|
|
487
|
-
{
|
|
488
|
-
value: syllableValue(SYLLABLE_MIN),
|
|
489
|
-
displayLabel: t('wordPairs.syllableNPlus', { n: SYLLABLE_MIN, defaultValue: '{{n}}음절 이상' }),
|
|
490
|
-
disabled: fixed != null ? SYLLABLE_MIN !== fixed : !syllableViable.min,
|
|
491
|
-
},
|
|
492
|
-
],
|
|
493
|
-
allOption: true,
|
|
494
|
-
// fixedSyllable이면 '전체'로 되돌릴 수 없게 비활성화(값이 강제됨)
|
|
495
|
-
allOptionDisabled: fixed != null,
|
|
496
|
-
});
|
|
497
|
-
}
|
|
498
|
-
// 선택 — choseong 타입은 긍정형 다중 토글(이미지 있는 단어만 / 음소 구조 같은 단어만),
|
|
499
|
-
// 아니면 이미지 제외만 마지막에 노출. (받침 제외는 종성 섹션의 '제외' 버튼)
|
|
500
|
-
if (caps.choseong) {
|
|
501
|
-
sections.push({ label: LABELS.exclude, displayLabel: LABELS.selectLabel, multiple: true, items: [LABELS.excludeImage, LABELS.sameStructure], labelInfo: infoAction(selectInfoItems) });
|
|
502
|
-
}
|
|
503
|
-
else {
|
|
504
|
-
sections.push({ label: LABELS.exclude, displayLabel: LABELS.selectLabel, multiple: true, items: [LABELS.excludeImage], labelInfo: infoAction([selectInfoItems[0]]) });
|
|
505
|
-
}
|
|
506
|
-
return sections;
|
|
507
|
-
}, [caps.choseong, caps.partOfSpeech, caps.wordType, caps.requireSyllable, caps.fixedSyllable, caps.fixedNoCoda, caps.requireCoda, minSyllables, partViable, viable, phonemeView, syllableViable, LABELS, t, infoAction, selectInfoItems, attrKeys]);
|
|
276
|
+
const filterSections = useMemo(() => buildWordTrainingFilterSections({
|
|
277
|
+
caps, t, attrKeys, labels: LABELS, phonemeView, viable, partViable, syllableViable, minSyllables,
|
|
278
|
+
}), [caps, t, attrKeys, LABELS, phonemeView, viable, partViable, syllableViable, minSyllables]);
|
|
508
279
|
// '다른 음소의 총 갯수' 섹션은 걷혔다 — 그 선택값·선택 처리 갈래도 함께 뺀다(대립 갯수는 파생값).
|
|
509
280
|
const filterSelected = {
|
|
510
281
|
...((caps.choseong || caps.fixedSyllable != null) && composition.syllable != null ? { [LABELS.syllableCount]: syllableValue(composition.syllable) } : {}),
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 단어훈련 필터의 **화면 구역 만들기** — `FilterPanel` 에 넘길 서술을 짓는 순수 계층.
|
|
3
|
+
*
|
|
4
|
+
* `useWordTrainingFilter.ts` 가 주석 뺀 454줄까지 불어 있었다(사용자 지시 2026-11-08 —
|
|
5
|
+
* *"모두 진행해줘"*). 그 안에서 **가장 큰 덩어리가 이것**이었다(124줄). 훅 안에 있었을
|
|
6
|
+
* 뿐 React 는 `useMemo` 한 겹뿐이고 속은 순수 계산이라, 여기로 그대로 옮긴다.
|
|
7
|
+
*
|
|
8
|
+
* **글자 그대로 옮겼다** — `wordTrainingFilterModel.ts` 때와 같은 손짓이다. 한 줄도
|
|
9
|
+
* 고치지 않았고, 공개하던 이름(`WordTrainingFilterCaps` · `gradeDescriptions`)은 훅
|
|
10
|
+
* 파일에서 그대로 다시 내보내므로 가져다 쓰는 쪽은 아무것도 안 바뀐다.
|
|
11
|
+
*
|
|
12
|
+
* **까닭** — 이 층은 React 없이 셀 수 있다. 훅을 띄우고 효과가 가라앉기를 기다리지
|
|
13
|
+
* 않아도, 들어가는 값(caps · viable · 라벨)만 주면 나오는 구역을 바로 견줄 수 있다.
|
|
14
|
+
*
|
|
15
|
+
* **타입이 여기 사는 까닭** — `WordTrainingFilterCaps` 를 훅 파일에 두고 여기서
|
|
16
|
+
* 가져오면 두 파일이 서로를 부른다(순환 import). `test/sourceStructure1108.test.ts`
|
|
17
|
+
* 가 그것을 센다. 그래서 **쓰는 쪽이 아니라 적는 쪽**에 둔다.
|
|
18
|
+
*/
|
|
19
|
+
import type { TFunction } from 'i18next';
|
|
20
|
+
import type { FilterPanelSection } from '../types/filterPanel';
|
|
21
|
+
import { type WordAttributeFilterKeys } from './useWordAttributeFilter';
|
|
22
|
+
/** 풀에서 실제로 쓸 수 있는 자모·음절 수 집합 */
|
|
23
|
+
export interface ViableComposition {
|
|
24
|
+
cho: Set<string>;
|
|
25
|
+
jung: Set<string>;
|
|
26
|
+
jong: Set<string>;
|
|
27
|
+
syllable: Set<number>;
|
|
28
|
+
}
|
|
29
|
+
/**
|
|
30
|
+
* 그룹이 노출할 설정 항목. 그룹에 속한 훈련 타입들의 CAPABILITY 합집합으로 결정.
|
|
31
|
+
* (제외/이미지 없음 필터는 모든 타입에 적용되므로 항상 노출)
|
|
32
|
+
* @public
|
|
33
|
+
*/
|
|
34
|
+
export interface WordTrainingFilterCaps {
|
|
35
|
+
difficulty: boolean;
|
|
36
|
+
/** 단어 구성(초성/중성/종성) 필터 노출 여부 */
|
|
37
|
+
choseong: boolean;
|
|
38
|
+
/** 품사 필터 노출 여부 — 단어표/대립쌍표와 동일 라벨(useWordAttributeFilter 공용). 기본 false. */
|
|
39
|
+
partOfSpeech?: boolean;
|
|
40
|
+
/** 어종 필터 노출 여부 — 단어표/대립쌍표와 동일 라벨(useWordAttributeFilter 공용). 기본 false. */
|
|
41
|
+
wordType?: boolean;
|
|
42
|
+
/**
|
|
43
|
+
* 한 음절을 특정해야 하는 타입(듣고 한 음절 포함 단어 맞히기 등)용.
|
|
44
|
+
* true면 초성/모음/종성의 '모두' 버튼을 없애고 항상 하나가 선택되도록 하며(재클릭 해제 안 됨),
|
|
45
|
+
* 초기값을 ㄱ+ㅏ+제외('가')로 시드해 재생할 음절이 항상 확정되게 한다.
|
|
46
|
+
*/
|
|
47
|
+
requireSyllable?: boolean;
|
|
48
|
+
/**
|
|
49
|
+
* 음절 수를 특정 값으로 고정해야 하는 타입(음절 합치기 등)용. 설정 시 '음절 수' 필터 섹션 자체를
|
|
50
|
+
* 노출하지 않고(사용자가 바꿀 수 없음) composition.syllable을 항상 이 값으로 유지한다.
|
|
51
|
+
*/
|
|
52
|
+
fixedSyllable?: number;
|
|
53
|
+
/**
|
|
54
|
+
* 종성을 '제외'(받침 없음)로 고정해야 하는 타입(음소 2개 합치기=초성+중성=CV)용.
|
|
55
|
+
* 설정 시 종성 필터는 '제외'만 활성·선택되고 나머지 자모·'모두'는 비활성화된다.
|
|
56
|
+
*/
|
|
57
|
+
fixedNoCoda?: boolean;
|
|
58
|
+
/**
|
|
59
|
+
* 종성이 반드시 있어야 하는 타입(음소 3개 합치기=초성+중성+종성=CVC)용.
|
|
60
|
+
* 설정 시 종성 '제외'(받침 없음) 버튼을 아예 노출하지 않는다.
|
|
61
|
+
*/
|
|
62
|
+
requireCoda?: boolean;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* 등급 고르개의 설명 줄들 — 지금 언어로. 사전에 배열이 없으면 한국어 원문.
|
|
66
|
+
*
|
|
67
|
+
* **공개 API 가 아니다**(대응표에 `internal`) — 코어 안에서만 쓰고, 내보내는 것은 못이 읽기 때문이다.
|
|
68
|
+
* 그래도 **이름은 영어다** — `internal` 이라도 배포 `d.ts` 에는 그대로 나가 소비자 편집기에 보인다
|
|
69
|
+
* (사용자 지시 2026-10-13. 소비자 사용처 0 이라 옛 이름을 남기지 않았다 — 말귀의 같은 이름 함수는 제 지역 것이다).
|
|
70
|
+
* 앱은 제 열쇠(`wordSearch.filter.gradeInfo`)와 제 받는 함수를 따로 갖는다.
|
|
71
|
+
*
|
|
72
|
+
* 사전이 배열을 안 주면 한국어 원문으로 물러선다 — 빈 줄을 띄우지 않는다((205)).
|
|
73
|
+
*/
|
|
74
|
+
export declare function gradeDescriptions(t: TFunction): string[];
|
|
75
|
+
/** 필터 판에 보일 글 — 지금 언어로. 안쪽 논리는 여전히 한국어 상수 열쇠로 돈다. */
|
|
76
|
+
export declare function buildWordTrainingFilterLabels(t: TFunction): {
|
|
77
|
+
composition: string;
|
|
78
|
+
syllableCount: string;
|
|
79
|
+
onset: string;
|
|
80
|
+
vowel: string;
|
|
81
|
+
coda: string;
|
|
82
|
+
phonemeGroup: string;
|
|
83
|
+
trainOnset: string;
|
|
84
|
+
trainVowel: string;
|
|
85
|
+
trainCoda: string;
|
|
86
|
+
random: string;
|
|
87
|
+
exclude: string;
|
|
88
|
+
selectLabel: string;
|
|
89
|
+
none: string;
|
|
90
|
+
noImage: string;
|
|
91
|
+
excludeImage: string;
|
|
92
|
+
sameStructure: string;
|
|
93
|
+
noLimit: string;
|
|
94
|
+
codaExclude: string;
|
|
95
|
+
gradeLabel: string;
|
|
96
|
+
};
|
|
97
|
+
/** `buildWordTrainingFilterLabels` 가 내놓는 글 묶음 */
|
|
98
|
+
export type WordTrainingFilterLabels = ReturnType<typeof buildWordTrainingFilterLabels>;
|
|
99
|
+
/**
|
|
100
|
+
* 필터 판에 넘길 구역 목록을 짓는다.
|
|
101
|
+
*
|
|
102
|
+
* **그리지 않는다 — 서술만 넘긴다.** 그리는 일은 `FilterPanel` 이 한다.
|
|
103
|
+
*/
|
|
104
|
+
export declare function buildWordTrainingFilterSections(args: {
|
|
105
|
+
caps: WordTrainingFilterCaps;
|
|
106
|
+
t: TFunction;
|
|
107
|
+
attrKeys: WordAttributeFilterKeys;
|
|
108
|
+
labels: WordTrainingFilterLabels;
|
|
109
|
+
phonemeView: 'char' | 'pron' | 'direct';
|
|
110
|
+
/** 풀에 실제로 있는 자모·음절 수 */
|
|
111
|
+
viable: ViableComposition;
|
|
112
|
+
/** 글자 입력에서 고를 수 있는 자모(정확 매칭) */
|
|
113
|
+
partViable: Record<'cho' | 'jung' | 'jong', Set<string>>;
|
|
114
|
+
/** 고를 수 있는 음절 수 */
|
|
115
|
+
syllableViable: {
|
|
116
|
+
exact: Set<number>;
|
|
117
|
+
min: boolean;
|
|
118
|
+
};
|
|
119
|
+
minSyllables: number;
|
|
120
|
+
}): FilterPanelSection[];
|