@ihabdevteam/core 0.330.0 → 0.332.0

package/CHANGELOG.md

@@ -7,6 +7,129 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.332.0 — 달 열쇠를 `"2026-10"` 으로 — 자리표와 이름표를 가른다
+
+사장님이 바꾸라고 하셨다. 0.329.0 에서 **꼴을 아는 자리를 하나로 모아 둔** 덕에 코어 쪽은
+`barChartMonthKey.ts` 한 파일이면 됐다.
+
+```
+달 열쇠   "2026년 10월"   → "2026-10"
+주 값     "2026년 10월#2" → "2026-10#2"
+```
+
+### 왜 바꾸나 — 한국어처럼 생긴 **자리표**라 이름표와 섞였다
+
+0.325.0 의 결함이 바로 그 섞임이었다. 달 드롭다운에 열쇠 글자가 그대로 떴고, **한국어
+화면에서는 그럴듯해 보여** 영어 화면에서만 티가 났다. `"2026-10"` 은 누가 봐도 이름표가
+아니다. 보이는 글은 `yearMonthLabel` 이 Intl 로 짓는다 — 그쪽은 **안 바뀐다.**
+
+**달은 두 자리로 채운다**(`2026-01`). 안 채우면 글자 차례가 달 차례와 어긋난다(`2026-10` 이
+`2026-9` 앞에 선다). `parseMonthKey` 는 **안 채운 것도, `2026-13` 도 거절한다** — 받아 주면
+짓는 쪽과 뜯는 쪽이 어긋나도 조용하고, 그 조용함이 바로 열쇠가 안 맞는 결함이다.
+
+### 소비자와 **맞춰서** 했다
+
+말귀_1 이 먼저 그쪽 자리를 느슨하게 하고, 그 뒤에 코어가 바꿨다. **담아 두는 자리는 양쪽 다
+없다**(`localStorage` 등) — 옛 열쇠가 남아 빈 칸이 되는 길은 없다. 양쪽이 따로 훑어 셌다.
+
+> **주 값은 코어가 뜯지 않는다.** `getControlDateRange` 는 `weekRanges.find(o => o.value ===
+> weekRange)` 로 맞춰 보고 구조화된 `year`·`month`·`week` 만 읽는다. 앱이 제 꼴을 써도 된다.
+
+### 세는 자리도 함께 — **셈을 두 번 틀렸다**
+
+- **소비자 자리를 열일곱이라 셌는데 열하나였다.** 여섯은 **이름표**였다(창 제목·날 이름표).
+  `'2026년 9월'` 이라는 글자만 보고 세어, 이 저장소가 늘 경계하던 섞임을 제 셈에서 저질렀다.
+  말귀_1 이 바로잡아 주었다.
+- **코어 시험 73 군데를 바꾸며 한 자리를 잘못 바꿨다.** `dateBoundaryFixes0915` 의 한 줄이
+  DatePicker 가 **보여 주는** 달 이름표였는데 열쇠인 줄 알고 바꿨다 — 못이 울어 되돌렸다.
+  이름표 쪽 파일 셋은 처음부터 손대지 않았다.
+
+### 못이 제 몫을 했다
+
+`barChartMonthKey` 하나만 고쳤는데 **닻**(`test/monthKeyOneDecision.test.ts`)이 *"주인 파일에
+그 꼴이 없다"* 고 울어, 못의 꼴도 함께 고쳐야 한다는 것을 그 자리에서 말했다.
+
+못을 고치며 한 가지를 바꿨다 — 옛 꼴(`…년 …월`)은 글자가 뚜렷해 저장소 전체에서 세도
+헛걸림이 없었는데, 새 꼴은 `${…}-${…}` 라 **저장소에 서른넷이 걸린다**(날짜·전화·아이디…).
+그래서 **짓는 쪽은 막대판 식구 안에서만** 세고, 뜯는 쪽(정규식)은 전체에서 센다. 틀은
+**두 토막으로 끝나는 것**만 집는다 — 안 그러면 같은 식구의 ISO 날짜 한 줄이 헛으로 걸린다
+(실제로 걸렸다).
+
+### **내보낸다** — 안 그러면 꼴을 아는 자리가 저장소를 건넌다
+
+`monthKeyOf` · `monthKeyOfDate` · `parseMonthKey` · `weekValueOf` 를 공개했다.
+
+`buildMonthChartData` 가 돌려주는 꾸러미를 소비자가 **열쇠로 찾아야** 하는데, 꼴을 알 길이
+없으면 제 손으로 짓는다 — 실제로 오늘 소비자 쪽에 `monthKeyShape.ts` 가 생길 뻔했다.
+그러면 꼴을 아는 자리가 **저장소를 건너 둘**이 되고, 이 파일이 막으려던 바로 그 결함이
+더 먼 자리에서, 더 늦게 난다. 짓는 것도 뜯는 것도 코어 것을 쓰게 한다.
+
+### 걷은 덫 — 열쇠를 이름표 자리에 넣어 두었다
+
+`genMonthOptions` 가 `label: v` 로 **열쇠를 그대로** 이름표에 넣고 있었다. 아무도 안 읽어
+조용했지만, 읽는 날 화면에 자리표가 그대로 뜬다 — 0.325.0 이 그 꼴이었다. 뗐다.
+
+### 곁다리 — 시험 하나가 **여유 37ms** 로 서 있었다
+
+`dailySelectionHasData` 가 훅의 포기(10초)를 15초 시한으로 기다렸다. 재 보니 실제로는
+**14,963ms** 다 — `40 × 250ms = 10초` 는 **틱 사이 일을 안 센 값**이고, 매 틱의 다시 그림과
+2초마다의 받기 기다림이 얹힌다. 기계가 조금만 바빠도 울었다. 게다가 그 줄의 주석은
+*"시간을 앞당긴다"* 고 적혀 있었는데 **가짜 타이머가 없었다** — 글이 하는 일과 달랐다.
+시한을 넉넉히 주고 **잰 값을 적었다.**
+
+## 0.331.0 — (307) 다시 듣기 셋 — 사장님 지적 · 말귀_1 실측
+
+### ① 줄을 **가운데**로 맞춘다 — `baseline` 이 아니다
+
+`baseline` 이면 `display:flex` 인 단추의 **제 안 아이콘 바닥**이 기준선이 된다. 그래서 32px
+단추가 줄 높이를 정하고 26px 낱말이 위로 밀렸다. 브라우저 실측(놀이터 1280px, 한 줄짜리
+여섯 줄): `baseline` → **3.5px** 어긋남, `center` → **0**. 말귀_1 이 앱에서 3px 로 같은 것을 쟀다.
+
+> 0.328.0 에서 단추에만 `align-self: center` 를 건 것은 **아무 일도 안 했다** — 단추가 이미
+> 줄을 꽉 채우니 제 안에서 가운데로 가도 그대로다. 줄을 맞춰야 한다. 그 글이 남아 있으면
+> 다음 사람이 또 그 길로 가므로 함께 걷었다.
+
+### ② 단추가 **변형을 받지 않는다** — 기본이다
+
+사장님이 화면에서 두 번 짚으셨다. 앱은 이 자리를 못 바꾼다 — 코어가 넘기는 prop 이고,
+앱 CSS 로 코어를 겨누지 않는 것이 이 집 규약이다. 그래서 코어가 뗀다.
+
+### ③ **코어가 그 문항을 읽을 때 쓴 길을 그대로 탄다**
+
+0.328.0 은 부르는 쪽이 넘긴 주소 하나만 봤다. 그래서 **정식 음원이 없는 낱말에는 단추가
+아예 안 섰다** — 말귀_1 실측으로 다섯 줄 중 둘(다른 판에서는 다섯 중 셋)이 그랬다.
+그런데 **훈련 중에는 다 들렸다**: 코어가 리졸버와 합성으로 읽어 주고 있었다. 다시 듣기만
+반쪽을 보고 있었던 것이다.
+
+길은 넷이다 — ① 넘긴 날 주소 ② `urlResolver`(저장소의 정식 음원) ③ `fallbackUrlResolver`
+(그때 합성) ④ 브라우저 `speechSynthesis`. 이 차례가 `TrainingWordCard` 와
+`TrainingStepAudioPlayer` 에 **두 벌**로 적혀 있었고, 팝업에 세 벌째를 쓰지 않으려고
+`src/components/Training/questionSoundRoute.ts` 하나로 모았다. **재생과 임자(자물쇠)는 거기서
+안 다룬다** — 부르는 쪽마다 쥐는 법이 다르고 그 다름이 각자의 내력에 적혀 있다.
+
+이제 단추가 서는 조건은 "주소를 받았나" 가 아니라 **"코어가 이것을 읽을 길이 있나"** 다.
+앱이 주소를 지어 넘기지 않아도 된다.
+
+**날 주소는 누름 그 자리에서 튼다.** 차례를 다 모은 뒤에 틀도록 짰더니 `await` 가 하나
+끼었고, 그러면 자동재생 막음이 `play()` 를 거절할 수 있다 — 누름의 표가 `await` 를 못 넘는
+브라우저가 있다. 시험 셋이 그 바뀜을 잡았다.
+
+**임자 셈으로 "못 틀었다" 와 "사람이 멈췄다" 를 가른다.** `done` 은 둘 다 거짓이다. 그것만
+보고 다음 주소로 넘어가면 **멈추라고 누른 사람이 다음 소리를 듣는다.**
+
+브라우저 끝까지 실측(놀이터, 주소가 하나도 없는 여섯 줄): 단추 6/6 · 누르니
+`speechSynthesis.speaking === true` · 이름표가 `1번 듣기 멈춤` · 다시 누르니 멈춤 · 오류 0.
+
+### 옛 결정 하나를 **고쳐 적는다**
+
+(303) 때 *"못 찾으면 단추를 안 그린다 — 안 넘기는 쪽은 지금과 똑같아야 한다"* 로 적어 둔
+것이 반쪽이었다. 그 글을 시험 머리말에서 고치고, 길이 **하나도 없을 때만** 안 선다로 바꿨다.
+그 둘을 세던 못도 다시 적었다 — jsdom 에 말소리가 없어 **우연히** 초록이던 자리다.
+
+못 일곱을 더 세우고 **다섯 가지로 깨 봤다**(단추 조건을 옛 꼴로 · 폴백을 길에서 빼기 ·
+임자 셈 빼기 · `baseline` 되돌리기 · 변형 되살리기). 임자 셈 깨기는 **처음에 안 울렸다** —
+고리 머리의 검사가 남아 반만 뺀 것이었다. 제대로 빼니 울었다.
+
 ## 0.330.0 — (304) 문턱이 **헛돌았다** — 말귀_1 실측 (0.328.0 회귀)
 
 말귀_1 이 앱에서 쟀다: 375×812 채점지에서 그려진 재생 단추가 **9.5px** 인데