@ihabdevteam/core 0.246.0 → 0.248.0

package/CHANGELOG.md

@@ -7,6 +7,78 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.248.0
+
+### 안내 한 줄이 칸과 **이어진다** — `PanelRow` `helperText` (말귀 요청 (60)①)
+
+`PanelRow variant="input"` 은 `error` 와 `helperText` 를 다 받는데, **같은 가림막이 내는 두
+말이 전혀 다르게 갔다.** `error` 는 `TextField` 로 내려가 `role="alert"` 과
+`aria-describedby` 를 얻고, `helperText` 는 `PanelRow` 가 제 자리에 `<div>` 로 그리고 **아무
+데도 안 걸었다** — "이 낱말을 내면 제안이 아니라 투표가 된다" 는 안내가 눈에만 보였다.
+
+이제 안내에 id 가 붙고 칸의 `aria-describedby` 에 걸린다. 꼴도 `string` → `ReactNode` 로
+넓혔다 — 값에 따라 바뀌는 안내는 앱이 `<span role="status">` 로 감싸 그 자리에서 알릴 수 있다
+(`aria-describedby` 는 **초점이 올 때만** 읽힌다).
+
+> **`error` 로 보내면 될 일이 아니었다.** `error` 는 `aria-invalid` 까지 세워 "틀린 값" 이라고
+> 말한다. 안내는 틀렸다는 말이 아니다 — 그래서 안내인 채로 이었다.
+
+함께 `TextField` 에 `ariaDescribedBy` 가 생겼다. 안의 것(`helperText`·`error`)을 **덮지 않고
+잇는다** — 덮으면 오류가 뜬 순간 바깥 안내가 사라지거나, 반대로 오류가 안 읽힌다.
+
+### 방문 이름표가 **어느 날**인지 말한다 — `Calendar` (말귀 요청 (60)②)
+
+이름표 `aria-label` 이 "12시 55분 지한 예약" 이었다. 그 글은 안의 글자를 **대신하므로** 칸
+왼쪽 위의 날 번호는 낭독기에 같이 가지 않는다 — 한 달에 스무 건이 서면 스무 번 똑같이
+들렸다. 날을 이름 맨 앞에 적는다. 좁은 칸에서 이름표 대신 서는 **건수 표시("방문 2건")도
+같은 자리**라 함께 고쳤다.
+
+> 달 칸을 `role="gridcell"` 로 세워 날을 함께 읽히는 길도 있다. 그러나 `grid` 는 화살표로
+> 칸을 옮기는 것까지 약속하는 역할이라(ARIA APG), 그 약속 없이 이름만 바꾸면 더 어긋난다.
+> 말귀도 그쪽은 요청하지 않았다.
+
+### 막대·링이 제목 급을 넘긴다 — `BarChart` · `RingChart` `titleLevel` (말귀 요청 (60)③)
+
+(51) 에서 `ChartSection` 에 급을 뚫었는데, 앱이 실제로 부르는 것은 **`BarChart`·`RingChart`**
+다. 둘이 `titleLevel` 을 안 받으니 부르는 쪽은 급을 정할 길이 없고 늘 기본 3 이 나갔다 —
+대시보드 제목이 `h1` 이면 층이 h1 → h3 로 한 급 비어 읽힌다. **문은 열렸는데 손잡이가 안
+달려 있던 꼴**이다.
+
+> 새 시험이 `<ChartSection` 을 그리는 **파일 수를 센다.** 감싸는 것이 하나 더 생기면 그쪽에도
+> 급을 달아야 하는데, 안 달면 또 조용히 기본 3 이 나간다 — `headingFamily` 와 같은 셈이다.
+
+## 0.247.0
+
+### 단추 안의 단추가 **다른 이름**을 갖는다 — `CategoryIcon` (말귀 요청 (58))
+
+`TrainingBlockButton` 은 그 자체가 `role="button"` 이고(갈래를 **고른다**), 그 안의
+`CategoryIcon` 도 `role="button"` 이다(갈래 **설명을 편다**). **하는 일이 다른데 이름이
+같았다** — 말귀 실측(단어훈련 만들기): 속에 조작이 든 단추 열아홉, 그중 이름까지 같은 것
+**열아홉, 전부**. 낭독기로 `같은 소리 단어 고르기, 단추` 가 잇따라 두 번 읽혔다.
+
+이름이 툴팁 문구를 그대로 쓰고 있었는데, 그 문구가 감싼 단추의 이름과 같은 자리였다.
+이제 **무엇을 여는지**를 적는다 — `같은 소리 단어 고르기 설명`.
+
+> **겹침 자체는 안 풀렸다.** `role="button"` 안에 초점 받는 것이 또 있는 것은 그대로다 —
+> 그건 아이콘을 블록 단추 **밖 형제로** 내야 풀리고(그쪽이 (58)②), 자리 잡기가 바뀌는
+> 일이라 겪어 보고 정한다. **읽히는 쪽만 먼저 폈다.**
+>
+> 안쪽이 초점을 받는 것 자체는 옳다 — 그 까닭이 조각 안에 적혀 있다(읽어 준 대로 눌러도
+> 아무 일이 없던 자리를 고친 것).
+
+### `Panel` 의 제목 급을 고를 수 있다 — **한 판이 다른 판의 전제를 바꿨다** (말귀 요청 (59))
+
+0.242.0 에서 창 제목을 `<h2>` 로 세웠다. 그러자 제목 있는 `Panel` 을 품은 창마다 둘이
+**같은 급**으로 서게 됐다(말귀 실측: 훈련 묶음 추가 창에 창 제목 말고 `h2` 가 **둘**).
+머리글로 훑으면 판이 창의 **아래가 아니라 옆**으로 읽힌다.
+
+**기본 2 는 어제까지 맞던 값이다.** 창 제목이 머리글이 아니던 때는 창 안 첫 머리글이 `h2` 인
+것이 옳았다 — 고친 쪽이 틀린 것이 아니라, **고치면서 그 전제를 쓰던 자리를 안 센 것**이다.
+
+> **세운 문이 바로 이것을 잡았다.** `Panel` 을 열자 `test/headingFamily.test.ts` 가 "박혀
+> 있는 자리가 달라졌다" 고 울었고, 목록을 옮기며 **`FilterPanel` 도 어제 옮겨 놓고 목록에
+> 안 적은 것**이 함께 드러났다. 손으로 세던 것을 문이 센 첫날이다.
+
 ## 0.246.0
 
 ### `FilterPanel` 의 제목도 **머리글·지역**이 된다 (말귀 요청 (57))