@ihabdevteam/core 0.425.0 → 0.428.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 (63) hide show
  1. package/CHANGELOG.md +1080 -0
  2. package/dist/components.cjs.js +178 -173
  3. package/dist/components.esm.css +2 -2
  4. package/dist/hooks.cjs.js +5 -5
  5. package/dist/i18n.cjs.js +3 -3
  6. package/dist/ihabdevteam-core-tokens.css +1 -1
  7. package/dist/ihabdevteam-core.cjs.js +194 -189
  8. package/dist/ihabdevteam-core.css +1 -1
  9. package/dist/ihabdevteam-core.d.ts +111 -8
  10. package/dist/packages/core/src/components/BarChart.css +13 -0
  11. package/dist/packages/core/src/components/BarChart.js +21 -1
  12. package/dist/packages/core/src/components/BulkBar.css +6 -2
  13. package/dist/packages/core/src/components/DatePicker.d.ts +17 -1
  14. package/dist/packages/core/src/components/DatePicker.js +9 -2
  15. package/dist/packages/core/src/components/Dropdown.js +32 -8
  16. package/dist/packages/core/src/components/FileUpload.js +1 -1
  17. package/dist/packages/core/src/components/Landing/Landing.css +8 -2
  18. package/dist/packages/core/src/components/Landing/LandingCard.js +1 -1
  19. package/dist/packages/core/src/components/PanelRow.d.ts +8 -0
  20. package/dist/packages/core/src/components/PanelRow.js +2 -2
  21. package/dist/packages/core/src/components/PassCard/PassCardBgIHAB.js +6 -2
  22. package/dist/packages/core/src/components/PassCard/PassCardBgLeftColorGrid.js +3 -0
  23. package/dist/packages/core/src/components/PassCard/PassCardBgSoundLine.js +2 -2
  24. package/dist/packages/core/src/components/PassCard/PassCardBgSoundLineV1.js +3 -0
  25. package/dist/packages/core/src/components/PassCard/PassCardBgSoundMove.js +1 -1
  26. package/dist/packages/core/src/components/PassCard/PassCardBgSoundMoveV1.js +3 -0
  27. package/dist/packages/core/src/components/PassCard/PassCardBgTalk.js +1 -1
  28. package/dist/packages/core/src/components/PassCard/PassCardBgTalkV1.js +1 -1
  29. package/dist/packages/core/src/components/PassCard/PassCardBgTwoCircle.js +1 -1
  30. package/dist/packages/core/src/components/PaymentPlan.d.ts +15 -0
  31. package/dist/packages/core/src/components/PaymentPlan.js +4 -2
  32. package/dist/packages/core/src/components/Popup/DeviceSideTable.js +25 -1
  33. package/dist/packages/core/src/components/Popup/WordDataUpdatePopup.css +11 -3
  34. package/dist/packages/core/src/components/Report/ReportInfoPanel.css +12 -1
  35. package/dist/packages/core/src/components/SideNav.css +44 -0
  36. package/dist/packages/core/src/components/SoundCompass.js +18 -1
  37. package/dist/packages/core/src/components/Table.js +30 -1
  38. package/dist/packages/core/src/components/Tabs.js +1 -1
  39. package/dist/packages/core/src/components/TextField.js +25 -6
  40. package/dist/packages/core/src/components/Tooltip/WordImageTooltip.js +14 -5
  41. package/dist/packages/core/src/components/Training/CategoryIcon.js +8 -1
  42. package/dist/packages/core/src/components/Training/TrainingWordCard.js +15 -1
  43. package/dist/packages/core/src/components/UpdateAlert.css +11 -5
  44. package/dist/packages/core/src/components/Word/WordSearchResultBlock.css +5 -0
  45. package/dist/packages/core/src/hooks/useWordAttributeFilter.d.ts +22 -1
  46. package/dist/packages/core/src/hooks/useWordAttributeFilter.js +65 -1
  47. package/dist/packages/core/src/hooks/useWordTrainingFilter.d.ts +6 -0
  48. package/dist/packages/core/src/hooks/useWordTrainingFilter.js +6 -2
  49. package/dist/packages/core/src/hooks/wordTrainingFilterSections.d.ts +3 -0
  50. package/dist/packages/core/src/hooks/wordTrainingFilterSections.js +9 -3
  51. package/dist/packages/core/src/i18n/locales/en.json +8 -1
  52. package/dist/packages/core/src/i18n/locales/ko.json +7 -0
  53. package/dist/packages/core/src/tokens.css +9 -1
  54. package/dist/packages/core/src/utils/lucideIconSet.js +6 -0
  55. package/dist/packages/core/src/utils/phonemePairSearch.d.ts +2 -0
  56. package/dist/packages/core/src/utils/phonemePairSearch.js +13 -4
  57. package/dist/packages/core/src/utils/phonemePairSearchTypes.d.ts +5 -6
  58. package/dist/packages/core/src/utils/wordAttributeFilterCodes.d.ts +79 -3
  59. package/dist/packages/core/src/utils/wordAttributeFilterCodes.js +238 -33
  60. package/dist/packages/core/src/version.d.ts +1 -1
  61. package/dist/packages/core/src/version.js +1 -1
  62. package/dist/utils.cjs.js +167 -162
  63. package/package.json +1 -1
@@ -6,7 +6,8 @@
6
6
  * 영어 열쇠('Part of Speech')로는 한국어 값이 안 읽혀 **필터가 풀리거나**, 품사 값이 posMap 에 없어 **모든 단어가 떨어졌다**.
7
7
  * 여기서 섹션·값을 언어와 무관한 코드로 읽는다 — 코드, 지금 언어·ko·en 라벨, 옛 라벨('난이도 등급'·'체언(명사,수사)') 모두.
8
8
  *
9
- * 코드: 섹션 `grade`·`syllables`·`pos`·`wordType`, 값 등급 `'1'`~`'4'`·`'none'` · 음절 `'1'`~`'4'`·`'5+'` ·
9
+ * 코드: 섹션 `grade`·`syllables`·`pos`·`wordType`, 값 등급 `'1'`~`'5'`·나이 `'age1'`~`'age99'`·
10
+ * 열린 나이 `'age{n}plus'`·`'none'` · 음절 `'1'`~`'4'`·`'5+'` ·
10
11
  * 품사 `noun`·`verb`·`modifier` · 어종 `native`·`sino`·`foreign`·`mixed`.
11
12
  * (useWordTrainingFilter 의 POS_CODES·toAttrCodes 와 같은 코드다.)
12
13
  */
@@ -46,9 +47,18 @@ export const GRADE_NONE = 'none';
46
47
  export function isBlankGrade(grade) {
47
48
  return grade == null || String(grade).trim() === '';
48
49
  }
49
- /** 등급 코드인가 — `'1'`~`'4'`·`'none'`. 저장된 값을 되읽을 때 **아닌 것은 버린다**(한때 `''` 가 저장됐다). */
50
+ /**
51
+ * 등급 코드인가 — `'1'`~`'5'`·`'none'`·`'age1'`~`'age99'`·`'age{n}plus'`. 저장된 값을 되읽을 때
52
+ * **아닌 것은 버린다**(한때 `''` 가 저장됐다).
53
+ *
54
+ * **목록이 아니라 꼴로 본다**(청 (389)). 나이 칩이 묶음을 따라 1세~99세 어디에든 설 수 있어
55
+ * 미리 셀 수가 없다. 단어훈련이 저장한 고름을 되읽을 때 이것으로 거르므로, 여기서 못 알아보는
56
+ * 코드는 **조용히 버려진다** — 고른 칩이 다음에 열면 풀려 있는 꼴이다.
57
+ */
50
58
  export function isGradeCode(v) {
51
- return typeof v === 'string' && gradeValues.includes(v);
59
+ if (typeof v !== 'string')
60
+ return false;
61
+ return GRADE_LEVELS.includes(v) || v === GRADE_NONE || AGE_CODE.test(v) || AGE_PLUS_CODE.test(v);
52
62
  }
53
63
  /**
54
64
  * **등급 코드 집합으로 단어 하나를 거른다 — 이 결정은 여기 하나다.**
@@ -63,7 +73,7 @@ export function isGradeCode(v) {
63
73
  */
64
74
  export function matchesGradeCodes(codes, grade,
65
75
  /**
66
- * 낱말의 나이(`WordEntry.age`) — `age3`~`age7` 을 고른 때에만 본다(청 (342)).
76
+ * 낱말의 나이(`WordEntry.age`) — 나이 칩(`ageN` · `ageNplus`)을 고른 때에만 본다.
67
77
  *
68
78
  * **안 넘기면 나이 칩이 한 낱말도 안 건진다.** 그러면 거르개는 멀쩡히 켜져 보이는데 결과가
69
79
  * 0 이다 — `없음` 이 밟았던 그 꼴이다. 부르는 자리가 셋뿐이라 셋 다 넘기게 했고,
@@ -75,37 +85,183 @@ age) {
75
85
  const set = codes instanceof Set ? codes : new Set(codes);
76
86
  if (set.size === 0)
77
87
  return true;
88
+ /* **나이 칩은 등급을 안 본다**(청 (389), 사장님 지시 2026-11-10) — `age7` 은 `age === 7`,
89
+ `age13plus` 는 `age >= 13` 이다.
90
+
91
+ 전에는 `grade === '1' && age === n` 이었다(청 (342)). 그때는 나이가 1등급 낱말에만 적혀
92
+ 있었으니 맞았다. 이제는 **모든 낱말에 나이가 있고 등급은 DB 가 나이 묶음으로 매긴다** —
93
+ 7세는 2등급이라 옛 식으로는 `7세` 칩이 **한 낱말도 안 건졌다**(말귀 라이브 실측). 거르개는
94
+ 멀쩡히 켜져 보이는데 0건인, `없음` 이 밟았던 그 꼴이다.
95
+
96
+ 나이를 먼저 보는 까닭 — 나이 칩과 등급 칩이 한 줄에 섞여 서므로(`1세`…`6세` · `2등급`…)
97
+ 어느 쪽에 걸려도 건진다. 저장된 설정 148줄 중 나이 칩을 쥔 줄은 0 이었다(말귀 실측
98
+ 2026-11-10) — 뜻을 바꿔도 열리던 표가 달리 걸리는 일이 없다. */
99
+ if (age != null) {
100
+ if (set.has(`age${age}`))
101
+ return true;
102
+ for (const code of set) {
103
+ const from = agePlusOfGradeCode(code);
104
+ if (from != null && age >= from)
105
+ return true;
106
+ }
107
+ }
78
108
  if (isBlankGrade(grade))
79
109
  return set.has(GRADE_NONE);
80
- const g = String(grade);
81
- if (set.has(g))
82
- return true;
83
- /* **나이 칩은 1등급 안을 가른다** — `age5` 는 `grade === '1' && age === 5` 다.
84
- 2~4등급에는 나이가 없으므로 위 `set.has(g)` 에서 이미 갈린다. */
85
- if (g !== '1' || age == null)
86
- return false;
87
- return set.has(`age${age}`);
110
+ return set.has(String(grade));
88
111
  }
89
112
  const sectionCodes = ['grade', 'syllables', 'pos', 'wordType', 'field'];
90
113
  /**
91
- * 난이도 코드 — `'none'` 은 **등급이 빈 단어**다(값이 아니라 **빔**이다. GRADE_NONE 주석을 볼 것).
114
+ * 난이도 **등급** 코드 — `'1'`~`'5'`. **5등급은 2026-11-10 에 생겼다**(청 (389): 13세 이상).
92
115
  *
93
- * **`'1'` 은 화면에서 빠졌지만 여기 남는다**(말귀 청 (342), 2026-10-28). 1등급을 나이
94
- * 다섯(`age3`~`age7`)으로 가르면서 칩에서는 뺐는데, **저장된 표 열셋이 그 코드를 쥐고 있다**
95
- * (말귀 실측 2026-10-28). 읽을 줄 모르면 그 열셋이 안 열린다 — 읽을 줄은 알되 새로 고르게만
96
- * 안 한다. 그래서 **마이그레이션이 필요 없다.**
116
+ * **`'1'` 은 묶음에 따라 화면에서 빠지지만 늘 읽는다**(청 (342) 때부터). 1등급이 나이로 보이면
117
+ * `1등급` 칩은 안 서는데, **저장된 표 열셋이 그 코드를 쥐고 있다**(말귀 실측) — 읽을 줄 모르면
118
+ * 그 열셋이 안 열린다. 읽을 줄은 알되 새로 고르게만 안 한다. 그래서 마이그레이션이 필요 없다.
97
119
  */
98
- const gradeValues = ['1', '2', '3', '4', 'none', 'age3', 'age4', 'age5', 'age6', 'age7'];
99
- /** 나이 코드인가 — `age3`~`age7`. 맞다면 그 숫자를, 아니면 `null`. */
120
+ const GRADE_LEVELS = ['1', '2', '3', '4', '5'];
121
+ /** 나이 칩이 셀 수 있는 가장 많은 나이 — 자료의 `Age` 가 1~99 다(청 (389)) */
122
+ const MAX_AGE = 99;
123
+ /* `age1`~`age99` · `age1plus`~`age99plus`. `0` 으로 시작하는 꼴(`age05`)은 안 받는다 —
124
+ 같은 나이가 두 코드로 저장되면 하나는 안 맞는다 */
125
+ const AGE_CODE = /^age([1-9]\d?)$/;
126
+ const AGE_PLUS_CODE = /^age([1-9]\d?)plus$/;
127
+ /** 나이 코드인가 — `age1`~`age99`. 맞다면 그 숫자를, 아니면 `null`. 열린 칩(`age13plus`)은 `null` 이다. */
100
128
  export function ageOfGradeCode(code) {
101
- const m = /^age([3-7])$/.exec(code);
129
+ const m = AGE_CODE.exec(code);
130
+ return m ? Number(m[1]) : null;
131
+ }
132
+ /** 열린 나이 코드인가 — `age13plus` → `13`(그 나이 **이상**). 아니면 `null`. */
133
+ export function agePlusOfGradeCode(code) {
134
+ const m = AGE_PLUS_CODE.exec(code);
102
135
  return m ? Number(m[1]) : null;
103
136
  }
137
+ /**
138
+ * 묶음 목록을 나이 범위로 편다. **꼴이 어긋나면 `null`** — 부르는 쪽은 묶음이 없는 것처럼 간다.
139
+ *
140
+ * 맞는 꼴은 말귀 서버 검사(`admin_set_word_grade_bands`)와 같다 — 등급이 1 부터 차례로,
141
+ * `maxAge` 가 늘어나는 정수, 마지막만 `null`. 다만 **꼭 다섯일 것은 요구하지 않는다**(코어가
142
+ * 아는 등급 코드가 다섯이라 그보다 많으면 안 받는다 — 여섯째 등급의 칩은 읽을 수 없다).
143
+ *
144
+ * **고쳐 쓰지 않고 통째로 버리는 까닭** — 묶음 하나를 건너뛰고 나머지를 이어 쓰면 칩의 나이와
145
+ * DB 가 매긴 등급이 어긋난다. 그러면 `5세` 칩이 2등급 낱말을 건지는 꼴이 되는데 화면에는 아무
146
+ * 표시가 없다. 엉뚱하게 보이느니 아는 꼴(묶음 없음)로 서는 편이 낫다.
147
+ */
148
+ export function resolveGradeBands(bands) {
149
+ if (!Array.isArray(bands) || bands.length === 0 || bands.length > GRADE_LEVELS.length)
150
+ return null;
151
+ const out = [];
152
+ let minAge = 1;
153
+ for (let i = 0; i < bands.length; i++) {
154
+ const band = bands[i];
155
+ if (!band || band.grade !== i + 1 || typeof band.showAge !== 'boolean')
156
+ return null;
157
+ const label = band.showAge ? undefined : bandLabelOf(band.label);
158
+ if (label === null)
159
+ return null;
160
+ const resolved = { grade: band.grade, minAge, maxAge: null, showAge: band.showAge };
161
+ if (label)
162
+ resolved.label = label;
163
+ if (i === bands.length - 1) {
164
+ if (band.maxAge !== null)
165
+ return null;
166
+ out.push(resolved);
167
+ break;
168
+ }
169
+ const max = band.maxAge;
170
+ if (typeof max !== 'number' || !Number.isInteger(max) || max < minAge || max >= MAX_AGE)
171
+ return null;
172
+ resolved.maxAge = max;
173
+ out.push(resolved);
174
+ minAge = max + 1;
175
+ }
176
+ /* 이름표끼리 같으면 하나로 되읽혀 다른 칩을 켠다 */
177
+ const labels = out.flatMap(b => (b.label ? [b.label] : []));
178
+ if (new Set(labels).size !== labels.length)
179
+ return null;
180
+ rememberBandLabels(out);
181
+ return out;
182
+ }
183
+ /**
184
+ * 묶음 이름 하나를 본다 — 안 줬거나 빈 글자면 `undefined`(이름 없음), **쓸 수 없는 이름이면 `null`**
185
+ * (묶음 전체가 꼴 어긋남).
186
+ *
187
+ * 쓸 수 없는 이름은 **다른 칩의 글자와 겹치는 것**이다 — `3세`·`2등급`·`없음`·`'4'` 같은 것.
188
+ * 이름표가 곧 열쇠라 겹치면 되읽을 때 엉뚱한 코드가 나온다. 나이 꼴(`10세 이상`)도 막는다.
189
+ */
190
+ function bandLabelOf(raw) {
191
+ if (raw === undefined || raw === null)
192
+ return undefined;
193
+ if (typeof raw !== 'string')
194
+ return null;
195
+ const label = raw.trim();
196
+ if (!label)
197
+ return undefined;
198
+ if (isGradeCode(label) || AGE_LIKE.test(label))
199
+ return null;
200
+ for (const lng of languages())
201
+ if (dictFor(lng).reverse.grade.has(label))
202
+ return null;
203
+ return label;
204
+ }
205
+ /**
206
+ * **지금 묶음의 이름표** — 코드 ↔ 이름(청 (389)+, 사장님 지시 2026-11-10).
207
+ *
208
+ * 이름표 → 코드 되읽기(`wordAttributeValueCodeOf`)와 코드 → 이름표(`wordAttributeValueLabelOf`·
209
+ * `wordAttributeFilterFromCodes`)는 **묶음을 안 받는다** — 부르는 자리가 많고(낱말 2만여 개마다
210
+ * 불리는 `matchesFilters` 까지) 다 묶음을 넘기게 바꿀 수 없다. 그래서 `resolveGradeBands` 가
211
+ * **꼴이 맞는 묶음을 볼 때마다 여기를 갈아 끼운다.** 묶음은 앱에 하나(`app_config`)라 화면끼리
212
+ * 다툴 일이 없다.
213
+ *
214
+ * 묶음이 없거나 어긋날 때는 **비우지 않는다** — 묶음을 안 넘기는 화면 하나가 다른 화면의 이름표를
215
+ * 지우면, 그 화면의 켜진 칩이 되읽히지 않는다(켜져 보이는데 0건). 이름 없는 칩(`2등급`)은 사전이
216
+ * 늘 읽으므로 남은 이름표가 해를 끼치지 않는다.
217
+ */
218
+ const bandLabelByCode = new Map();
219
+ const bandCodeByLabel = new Map();
220
+ function rememberBandLabels(bands) {
221
+ /* **코드 → 이름은 갈아 끼우고, 이름 → 코드는 쌓는다.** 앱이 지금 언어의 사전 이름을 label 로
222
+ 붙여 넘기므로(말귀, 2026-11-10 사장님: *"이거 번역도 되어야 하잖아"*) 언어를 바꾸면 이름이
223
+ 바뀐다. 이름 → 코드까지 갈아 끼우면 바꾸기 전에 켜 둔 `초등 저학년` 이 `Early elementary`
224
+ 화면에서 안 읽혀 **켜져 보이는데 0건**이 된다(재 봤다). 사전이 지금 언어·ko·en 을 다 읽는
225
+ 것과 같은 까닭이다. 쌓인 옛 이름은 제 코드로만 읽히고, 같은 이름이 다른 코드로 오면 새 것이
226
+ 이긴다. */
227
+ bandLabelByCode.clear();
228
+ for (const band of bands) {
229
+ if (!band.label)
230
+ continue;
231
+ bandLabelByCode.set(String(band.grade), band.label);
232
+ bandCodeByLabel.set(band.label, String(band.grade));
233
+ }
234
+ }
235
+ /**
236
+ * 편 묶음 → 난이도 칩 **코드**(그 차례대로). `없음` 은 넣지 않는다 — 부르는 쪽이 맨 끝에 둔다.
237
+ *
238
+ * 나이로 보이는 묶음은 그 나이 하나하나가 칩이고(`age1`…`age6`), 위가 열린 묶음이면
239
+ * `age13plus` 하나다. 등급으로 보이는 묶음은 `'2'` 하나다.
240
+ */
241
+ export function gradeBandCodes(bands) {
242
+ const out = [];
243
+ for (const band of bands) {
244
+ if (!band.showAge) {
245
+ out.push(String(band.grade));
246
+ continue;
247
+ }
248
+ if (band.maxAge == null) {
249
+ out.push(`age${band.minAge}plus`);
250
+ continue;
251
+ }
252
+ for (let n = band.minAge; n <= band.maxAge; n++)
253
+ out.push(`age${n}`);
254
+ }
255
+ return out;
256
+ }
104
257
  const syllableValues = ['1', '2', '3', '4', '5+'];
105
258
  const posValues = ['noun', 'verb', 'modifier'];
106
259
  const wordTypeValues = ['native', 'sino', 'foreign', 'mixed'];
107
260
  /* `field` 는 값이 자유라 셀 목록이 없다 — `FREE_VALUE_SECTIONS` 를 볼 것 */
108
- const valuesBySection = { grade: gradeValues, syllables: syllableValues, pos: posValues, wordType: wordTypeValues, field: [] };
261
+ /* 등급은 목록이 아니라 꼴로 본다(`isGradeCode`) — 여기 `grade` 는 안 쓰인다 */
262
+ const valuesBySection = { grade: [], syllables: syllableValues, pos: posValues, wordType: wordTypeValues, field: [] };
263
+ /** 이 절의 **코드 자신**인가 */
264
+ const isSectionValueCode = (section, value) => section === 'grade' ? isGradeCode(value) : valuesBySection[section].includes(value);
109
265
  /** 품사 코드 → 사전 품사 약자(단어의 pos 에 들어 있는지 본다) · 어종 코드 → 사전 어종 값 */
110
266
  export const POS_CODE_TARGETS = { noun: ['명', '수'], verb: ['동', '형'], modifier: ['부', '관'] };
111
267
  export const WORD_TYPE_CODE_VALUES = { native: '고유', sino: '한자', foreign: '외래', mixed: '혼종' };
@@ -139,11 +295,13 @@ function dictFor(lng) {
139
295
  },
140
296
  value: {
141
297
  grade: {
142
- /* 등급 칩 — `'1'` 은 화면에서 빠졌지만 **읽을 줄은 안다**(저장된 표가 쥐고 있다) */
143
- ...Object.fromEntries(['1', '2', '3', '4'].map((n) => [n, t('wordSearch.filter.grade', { n: Number(n), defaultValue: `${n}등급` })])),
144
- /* 나이 칩 — 1등급 안을 가른다(청 (342)). 숫자 틀이 등급과 **달라야 한다**:
298
+ /* 등급 칩 — `'1'` 은 묶음에 따라 화면에서 빠지지만 **읽을 줄은 안다**(저장된 표가 쥐고 있다) */
299
+ ...Object.fromEntries(GRADE_LEVELS.map((n) => [n, t('wordSearch.filter.grade', { n: Number(n), defaultValue: `${n}등급` })])),
300
+ /* 나이 칩 — 묶음을 따라 1세~99세 어디에든 선다(청 (389)). 숫자 틀이 등급과 **달라야 한다**:
145
301
  `3세` 를 `3등급` 과 같은 틀로 지으면 둘이 같은 글자가 되어 서로를 덮는다. */
146
- ...Object.fromEntries([3, 4, 5, 6, 7].map((n) => [`age${n}`, t('wordSearch.filter.age', { n, defaultValue: `${n}세` })])),
302
+ ...Object.fromEntries(AGES.map((n) => [`age${n}`, t('wordSearch.filter.age', { n, defaultValue: `${n}세` })])),
303
+ /* 열린 나이 칩 — 위가 열린 묶음이 나이로 보일 때 하나만 선다(`13세 이상`) */
304
+ ...Object.fromEntries(AGES.map((n) => [`age${n}plus`, t('wordSearch.filter.agePlus', { n, defaultValue: `${n}세 이상` })])),
147
305
  /* **`없음` 은 숫자 틀을 안 쓴다** — `t('…grade', { n: Number('none') })` 은 `NaN등급` 이 된다 */
148
306
  [GRADE_NONE]: t('wordSearch.filter.gradeNone', '없음'),
149
307
  },
@@ -166,10 +324,39 @@ function dictFor(lng) {
166
324
  field: {},
167
325
  },
168
326
  };
327
+ /* 같은 라벨이 두 코드에 있으면 **먼저 적힌 것**이 이긴다 — 훑어 찾던 때와 같은 차례다 */
328
+ d.reverse = Object.fromEntries(sectionCodes.map((sec) => {
329
+ const map = new Map();
330
+ for (const [code, label] of Object.entries(d.value[sec]))
331
+ if (!map.has(label))
332
+ map.set(label, code);
333
+ return [sec, map];
334
+ }));
169
335
  dictCache.set(lng, d);
170
336
  return d;
171
337
  }
338
+ /** 사전이 나이 칩 라벨을 지을 나이들 — 1~99 */
339
+ const AGES = Array.from({ length: MAX_AGE }, (_, i) => i + 1);
172
340
  const languages = () => Array.from(new Set([i18n.language, 'ko', 'en'].filter((x) => !!x)));
341
+ /**
342
+ * **'활용도 높은 단어만' 칩인가** — 어느 언어로 적었든, 코드로 적었어도 읽는다(청 (345)②).
343
+ *
344
+ * 이 칩은 **속성 다섯 절(난이도·음절·품사·유형·의미범주) 밖**에 있다 — '선택' 절의 긍정형
345
+ * 토글이고, 그 절에는 비동기로 물어봐야 하는 것('이미지 있는 단어만')도 함께 산다. 그래서
346
+ * 절 코드를 하나 더 두지 않고 **값으로** 알아본다. 절 이름이 무엇이든 그 값이 켜져 있으면
347
+ * 켜진 것으로 본다 — 부르는 자리마다 절 이름을 달리 적어도(단어표 '선택' · 단어훈련
348
+ * '제외') 같은 뜻으로 읽힌다.
349
+ */
350
+ export const HIGH_USAGE_CODE = 'highUsage';
351
+ export function isHighUsageValue(value) {
352
+ if (value === HIGH_USAGE_CODE)
353
+ return true;
354
+ for (const lng of languages()) {
355
+ if (i18n.getFixedT(lng)('wordPairs.filter.onlyHighUsage', '활용도 높은 단어만') === value)
356
+ return true;
357
+ }
358
+ return false;
359
+ }
173
360
  /** 섹션 라벨(어느 언어든·옛 라벨·코드) → 섹션 코드. 속성 섹션이 아니면 null. */
174
361
  export function wordAttributeSectionOf(label) {
175
362
  if (sectionCodes.includes(label))
@@ -190,13 +377,18 @@ export function wordAttributeValueCodeOf(section, value) {
190
377
  /* 값이 자유로운 절은 **그대로 지나간다** — 코드가 따로 없다(`FREE_VALUE_SECTIONS`) */
191
378
  if (FREE_VALUE_SECTIONS.has(section))
192
379
  return value;
193
- if (valuesBySection[section].includes(value))
380
+ if (isSectionValueCode(section, value))
194
381
  return value;
382
+ /* 묶음 이름표(`초등 저학년` → `'2'`) — 사전보다 먼저. 숫자 길로 가면 `초등 3학년` 이 3등급이 된다 */
383
+ if (section === 'grade') {
384
+ const hit = bandCodeByLabel.get(value.trim());
385
+ if (hit)
386
+ return hit;
387
+ }
195
388
  for (const lng of languages()) {
196
- const table = dictFor(lng).value[section];
197
- for (const [code, label] of Object.entries(table))
198
- if (label === value)
199
- return code;
389
+ const hit = dictFor(lng).reverse[section].get(value);
390
+ if (hit)
391
+ return hit;
200
392
  }
201
393
  for (const [code, labels] of Object.entries(legacyValueLabels[section] ?? {}))
202
394
  if (labels.includes(value))
@@ -207,20 +399,33 @@ export function wordAttributeValueCodeOf(section, value) {
207
399
  **3등급으로 읽힌다** — 고른 것과 걸리는 낱말이 통째로 달라지는데 화면에는 아무 표시가
208
400
  없다. 위 사전이 ko·en 을 다 보므로 제 이름으로는 이미 읽혔고, 여기 오는 것은 사전에 없는
209
401
  꼴뿐이다. 나이 꼴이면 **읽기를 포기한다** — 엉뚱하게 읽느니 안 읽는 편이 낫다. */
210
- if (section === 'grade' && /(세|살|years?\s*old|yrs?)\s*$/i.test(value.trim()))
402
+ if (section === 'grade' && AGE_LIKE.test(value.trim()))
211
403
  return null;
212
404
  if (section === 'grade' || section === 'syllables') {
213
405
  const n = parseInt(value.replace(/\D/g, ''), 10);
214
406
  if (Number.isFinite(n) && n >= 1) {
215
407
  if (section === 'grade')
216
- return n <= 4 ? String(n) : null;
408
+ return n <= GRADE_LEVELS.length ? String(n) : null;
217
409
  return n >= 5 ? '5+' : String(n);
218
410
  }
219
411
  }
220
412
  return null;
221
413
  }
414
+ /**
415
+ * **나이 꼴인가** — 숫자만 뽑아 등급으로 읽으면 안 되는 글자. `3세` · `3살` · `3 years old` ·
416
+ * `3세 이상` · `Age 3` · `Age 3+` 꼴.
417
+ *
418
+ * `이상`·`+` 꼬리는 열린 나이 칩(청 (389))과 함께 들어왔다 — 그것 없이 `3세 이상` 이 사전 밖에서
419
+ * 오면 끝이 `이상` 이라 옛 자에 안 걸리고 숫자 길로 가서 **3등급**이 된다.
420
+ */
421
+ const AGE_LIKE = /(^age\s*\d)|((세|살|years?\s*old|yrs?)(\s*(이상|\+|or\s+(older|above|more)))?$)/i;
222
422
  /** 코드 → 지금 언어의 라벨. `'none'` 도 사전 꼴로 나온다(숫자 틀 `{{n}}등급` 에 넣으면 `NaN등급` 이 된다). 모르는 코드는 그대로. */
223
423
  export function wordAttributeValueLabelOf(section, code, lng = i18n.language) {
424
+ if (section === 'grade') {
425
+ const named = bandLabelByCode.get(code);
426
+ if (named)
427
+ return named;
428
+ }
224
429
  return dictFor(lng).value[section][code] ?? code;
225
430
  }
226
431
  const toArray = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === 'string') : typeof v === 'string' && v ? [v] : []);
@@ -253,7 +458,7 @@ export function wordAttributeFilterFromCodes(codes, lng = i18n.language) {
253
458
  const out = {};
254
459
  for (const s of sectionCodes) {
255
460
  /* 자유 절은 값이 곧 라벨이다 — 사전에 없다고 버리면 저장했다 되읽을 때 사라진다 */
256
- const labels = (codes?.[s] ?? []).map((c) => d.value[s][c] ?? (FREE_VALUE_SECTIONS.has(s) ? c : undefined)).filter((x) => !!x);
461
+ const labels = (codes?.[s] ?? []).map((c) => (s === 'grade' ? bandLabelByCode.get(c) : undefined) ?? d.value[s][c] ?? (FREE_VALUE_SECTIONS.has(s) ? c : undefined)).filter((x) => !!x);
257
462
  if (labels.length)
258
463
  out[d.section[s]] = labels;
259
464
  }
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export declare const CORE_VERSION = "0.425.0";
49
+ export declare const CORE_VERSION = "0.428.0";
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export const CORE_VERSION = '0.425.0';
49
+ export const CORE_VERSION = '0.428.0';