@ihabdevteam/core 0.247.0 → 0.248.0

package/CHANGELOG.md

@@ -7,6 +7,46 @@ 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))