@ihabdevteam/core 0.344.0 → 0.346.0

package/CHANGELOG.md

@@ -7,6 +7,109 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.346.0 — 기다리는 동안 글을 안 띄운다 · 묶음 이름이 뜬다 · 옛 짝을 걷었다
+
+### (305) 개발자의 말이 화면에 안 뜬다 — 그런데 전제가 달랐다
+
+말귀가 *"사람 말이 2ms 뒤에 개발자 말로 덮인다"* 고 청했다. 재어 보니 **그 글은 저장소를
+처음 만들 때부터 `display: none` 이었다** — 코어에서 화면에 뜬 적이 없다. 대신 더 나쁜 것이
+있었다: `display: none` 은 **접근성 나무에서도 빼서**, 위의 `role="status"`·`aria-live` 가
+**헛돌고 기다리는 동안 아무 말도 안 읽혔다.**
+
+사장님이 **(다)** 로 정하셨다(2026-10-19) — *"글은 아예 안 띄운다"*. 미뤄 둔 길 (가)(사람 말
+한 마디로 묶기)가 아니다: 깜박이는 글은 한 마디로 묶어도 읽을 틈이 없다.
+
+- 눈에는 **동그라미만**. 감추는 길을 `display: none` → 이 저장소의 규약
+  (`clip-path: inset(50%)`)으로 바꿨다 — 보이지 않지만 **읽힌다.**
+- 낭독기에는 걸음에 안 매인 **한 마디**: `소리를 준비하고 있습니다…` / `Preparing sound…`
+  (새 열쇠 `training.audioStatus.preparing`).
+- 걸음 이름과 그 글(`STATUS_MESSAGES`)은 **안 지웠다** — 개발 판의 자취와 색이 쓴다.
+
+`test/audioStatusAnnounce.test.tsx` 가 **뒤집혔다**: 2026-10-05 의 (나) 를 못 박던 시험이
+이제 *"걸음마다 다른 글을 그리지 않는다"* 와 *"감추는 길이 `display: none`·`visibility: hidden`
+이 아니다"* 를 센다. 세 가지로 깨 보고 셋 다 붉어졌다.
+
+### (308) 묶음 이름이 안 그려졌다
+
+`groups` 를 주면 묶음 `div` 는 섰지만 **받은 `label` 이 `key` 로만 쓰이고 사라졌다** —
+그리는 줄이 `group.items` 만 펴고 `group.label` 을 안 썼다. 그릴 뜻이었던 것은 분명하다
+(윗줄 주석이 *"그룹 헤더 유지"*).
+
+말귀 실측(0.343.0 · 음소 대립 1,159쌍): 묶음 넷을 넘겼는데 `__group` 이 **1 개**,
+이름 글자 **0 건**. 보는 사람은 어느 자리가 갈린 쌍인지 모른 채 한 덩어리로 봤다.
+
+이름을 머리로 그린다. `role="group"` + `aria-labelledby`(`IconGridMenu` 의 규약) — `role="group"`
+은 **이름이 없으면 낭독기가 묶음을 아예 안 알린다**. 쪽 경계에서 나뉘면 나뉜 쪽에도 다시 선다
+(`pagedGroups` 가 이미 쪽마다 다시 묶는다).
+
+> 세우다 **없는 CSS 토큰**(`--font-label-m`)을 적었다. 없는 변수는 조용히 아무 꼴도 안 내서
+> 깨진 줄 몰랐다 — 찾다가 발견한 "선례" 가 제가 방금 적은 줄이었다. 이 저장소의 규약은
+> `styles.css` 의 공용 클래스(`caption-1b`)다. 못이 그 자리도 센다.
+
+### `diffSection` 을 걷었다 (공개 타입에서 빠짐)
+
+갈린 자리를 **옛 한글 이름**(`'초성'`·`'모음'`…)으로도 가리키던 짝이다 — 한 결정이 두 자리에.
+`@deprecated` 글에 *"소비자가 옮긴 뒤 걷는다"* 고 적어 두었고, 말귀가 옮겼다고 알려 와
+**직접 셌다**: 말귀 앱·어드민 **0**(한 건은 그쪽 시험 재료) · 소리방향성 **0** · kscan **0**.
+
+`diffSectionCode`(`'onset'`·`'vowel'`·`'coda'`·`'glide'`)가 정본이다. 이 값을 읽는 곳이
+있으면 그것으로 옮겨라.
+
+## 0.345.0 — 캐시 열쇠가 섞이고, 샘플 밖 초성이 사라지던 자리
+
+0.344.0 과 같은 자리에서 온 것(다른 세션이 10분마다 훑어 고친 것)을 받아 검토하고 냈다.
+알맹이 9파일 · 시험 11파일. **아직 그 루프가 돌고 있어 "지금 든 것" 만 묶었다**(사장님
+지시) — 뒤에 쌓이는 것은 다음 판이다.
+
+### 캐시 열쇠가 서로 다른 조건을 같은 칸에 담던 것
+
+- **`choseong: []` 과 미지정이 같은 열쇠였다**(`_poolCacheKey`). 빈 배열은 *후보를 전부
+  제외* 인데 *무제약* 과 같은 칸에 담겨, **먼저 계산한 쪽의 결과가 다른 조건에 그대로
+  재사용**됐다. 빈 배열을 `'[]'` 로 따로 센다.
+- **이미지 집합이 바뀌어도 풀 캐시가 안 비워졌다**(`buildUsablePool`·
+  `generateRuntimeItems`). `prewarm`·일괄 주입이 결과를 바꾸는데 풀 참조는 그대로라
+  옛 문항이 남았다. `getImageOkWordSet()` 의 참조를 무효화 기준에 넣는다.
+- **늦게 끝난 셈이 비워진 캐시를 되채웠다**(`_resultCacheEpoch`). 계산 중에 풀이 바뀌면
+  그 결과를 새 캐시에 안 넣는다.
+- **중복 행이 있으면 입력 순서가 바뀌어도 같은 지문이었다**(`computeSig`). 색인은
+  *첫 유효 행* 을 쓰므로 순서가 결과를 바꾼다 — 지문에 순서를 넣어 낡은 색인을 안 쓴다.
+
+### 샘플 캡이 고를 수 있는 것을 숨기던 것
+
+**`getViableChoseongs` 가 생성용 샘플(기본 1500)로 셌다.** 그래서 샘플 밖의 드문 초성이
+실제로 가능해도 **고를 수 있는 것에서 빠졌다.** `fullCount: true` 로 전체 후보를 본다
+(열쇠에 `F` 로 들어 있어 생성용 풀과 섞이지 않는다).
+
+> **지금 그 손잡이를 부르는 자리는 없다**(꾸러미를 받아 세었다 — 묶음 셋에 그 이름 0,
+> 공개 `d.ts` 에 0, 코어 안에서 부르는 곳은 시험 둘뿐). 거르개(`useWordTrainingFilter`)는
+> `getViableComposition`·`countUsableWords` 를 쓴다. **그러니 이 고침은 화면에서 지금
+> 달라지는 것이 없고**, 서브패스 `utils/wordTrainingRuntime` 로 그 손잡이를 쓰는 쪽이
+> 생길 때 값을 한다. 처음 이 자리에 *"단추에서 사라졌다"* 고 적어 지금 나는 일처럼
+> 읽히게 했다 — 0.345.0 꾸러미에는 그 글이 실려 나갔다.
+
+### 없는 날짜를 실제 날짜처럼 보여 주던 것
+
+`Date.parse` 는 `2026-02-30` 을 **3월 2일**로 굴린다. `toInstant` 가 날짜 부분을 먼저
+확인해 안 맞으면 `null` 을 준다(`todayYmdOr`·`trainingItemResults.timeOf` 도 같은 자를 쓴다).
+새 export: `isValidDateValue`(`utils/date`). 같은 종류를 `formatWornDate` 에서 이미 막았다.
+
+### 그 밖
+
+- **동음어가 먼저 뽑히면 문제를 포기했다**(`genStartsWithSame`). 같은 첫소리 묶음에서
+  **소리가 다른** 짝을 찾아 쓴다 — 변별 과제가 성립하는 짝이 있는데 버리던 것.
+- **이미지 캐시가 바뀌면 거르개가 다시 센다**(`IMAGE_EXISTENCE_CACHE_UPDATED`).
+  200ms 로 모아 알린다 — 대량 사전 확인 중에 수천 번 재계산되지 않게. 이 이름은
+  `utils` 통로에 **안 넣었다**(서브패스 `utils/imageConfig` 로만 닿는다, 안에서 쓰는 신호다).
+- `resolveSelection` 이 시계를 **한 번만** 읽는다 — 두 번 읽는 사이 자정이 오면
+  오늘과 어제가 같아졌다.
+
+### 내가 고친 것 둘
+
+- `{ 가문: '가면' }` 의 열쇠에 따옴표를 둘렀다 — 자료 열쇠인데 없으면
+  `identifiersAreEnglish1013` 이 **영어 아닌 이름**으로 센다.
+- `afterEach(() => vi.restoreAllMocks())` 를 중괄호 꼴로 바꿨다(두 자리). 간결한 꼴은
+  `VitestUtils` 를 돌려주어 `Awaitable<void>` 와 안 맞아 `tsconfig.test` 가 TS2322 로 막았다.
+
 ## 0.344.0 — 조용히 틀리던 자리 스무 곳
 
 **다른 세션이 10분마다 훑어 찾아 고친 것을 받아 검토하고 냈다.** 알맹이 23파일 · 시험