@ihabdevteam/core 0.322.0 → 0.323.0

package/CHANGELOG.md

@@ -7,6 +7,523 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.323.0 — 칸 너비 자동맞춤은 **상태**다, 그리고 안쪽 이름을 끝까지 영어로
+
+### `scripts`·`test`·빌드 설정의 이름도 영어로 — **싣는 것은 한 바이트도 안 바뀐다**
+
+사장님 지시(2026-10-14). `scripts/` 548선언(1,973자리) · 시험 6 · 놀이터 5 ·
+`postcss.config.cjs` 2 를 옮겼다. 글로 긁지 않고 **TypeScript 의 rename** 으로 집었다.
+
+**배포물은 안 바뀐다.** `src` 를 한 줄도 안 건드렸고, `postcss.config.cjs` 는 빌드 설정이라
+나오는 CSS 가 달라질 수 있어 **옛 설정과 새 설정으로 각각 뽑아 견주었다 — 바이트까지 같다.**
+
+> **못이 이미 있었는데 내가 두 번째를 달 뻔했다.** `test/identifiersAreEnglish1013.test.ts`
+> 가 어제 세워져 있었는데 `.md` 만 뒤지고 *"못이 없다"* 고 적었다. 그 문이 내내 초록이던
+> 까닭은 **훑는 자리를 손으로 골랐기** 때문이다(`src`·`test`·`playground/src` 에 `.tsx?` 만)
+> — 그래서 `scripts/` 1,973곳과 `postcss.config.cjs` 둘이 **한 번도 안 보였다.**
+> 그 문을 **뿌리에서 훑게** 넓히고(`.mjs/.cjs/.js` 까지), `walked > 900` 을 `> 1100` 으로
+> 올려 **자리를 좁히면 먼저 울게** 했다. 내가 만든 쪽은 걷었다.
+
+> 연장도 둘 넓혔다 — `fix-leftover-property-reads.mjs` 가 `.tsx?` 만 훑어 스크립트의 남은
+> 성질 읽기를 **하나도 안 집고 "0곳" 으로 조용히** 지나갔다(32곳이 나왔다). 그리고
+> `scripts/` 가 어느 tsconfig 에도 없어 `tsconfig.scripts.json` 을 세웠다.
+
+### 소비자 표를 실측으로 되돌렸다
+
+`audit:consumers` 가 빨갰다. 소리방향성·kscan 이 `^0.211.0` 으로 적혀 있는데 실물은
+`^0.183.2` 다(두 저장소 다 나무가 깨끗하고 9/21 이후 안 바뀌었으며 `0.211.0` 이라는 글자가
+**어디에도 없다**). 그리고 *"센 것이 없는데 초록"* 을 글이 아니라 **셈으로** 막았다 —
+한 줄이라도 쟀으면 지나가고 **하나도 못 쟀으면 막는다**(워크트리에서 돌린 관문이 그 틈으로
+틀린 표를 실었다).
+
+### 칸 너비 '자동맞춤' 은 한 번 누르는 일이 아니라 **상태**다
+
+사장님 지시(2026-10-13, 말귀 청). 바라는 결 한 줄: **손으로 조절한 적이 없는 표는 늘
+자동맞춤으로 서고, 조절하면 그 값을 쓰고, '칸 너비 초기화' 를 누르면 다시 자동맞춤 상태로
+돌아간다.**
+
+전 꼴의 흠은 **초기화가 재서 그 숫자를 저장**한 것이다. 손으로 끈 것과 구별이 없어지고,
+무엇보다 그때 화면에 있던 줄로 잰 **'한 순간의 사진'** 으로 굳어 그 뒤 창을 넓히거나 긴
+글자가 든 줄이 들어와도 안 따라왔다.
+
+| 자리 | 전 | 후 |
+|---|---|---|
+| 한 번도 안 건드린 표 | 만든 사람의 `gridTemplateColumns` | **자동맞춤** |
+| 손으로 끈 표 | 저장값 | 그대로 |
+| 초기화 단추 | 재서 **저장**(손 모드로 굳는다) | 저장값을 **지우고 자동으로** |
+| 자동일 때 저장 | — | **안 한다**(저장하면 되돌아갈 길이 사라진다) |
+| 줄이 없을 때 | — | 재지 않는다(먼저 선 격자를 그대로 둔다) |
+| 좁은 화면 | — | 아무것도 안 한다(폭 조절을 통째로 끄는 기존 규칙 안) |
+
+**다시 재는 계기는 넷이다 — '줄 바뀜' 은 없다.**
+
+```
+잰다:     줄이 **처음** 들어왔을 때 · 통 폭이 바뀔 때 · 칸 수가 바뀔 때 · 초기화를 눌렀을 때
+안 잰다:  줄이 바뀌었을 뿐일 때(걸렀다 · 쪽을 넘겼다 · 새로 받았다)
+```
+
+처음에는 "줄이 바뀔 때마다" 재게 두었다(청의 ①이 그렇게 적혀 있었다). **말귀가 제 앱을 재어
+그 청을 스스로 물렸다**: 저장열쇠가 있는 표 스물여덟 중 **열아홉**이 찾는 칸이나 쪽 나누기를
+갖고 있다 — 걸러도, 쪽을 넘겨도 줄이 갈리고 그때마다 칸이 다시 선다. 예외가 아니라 대다수다.
+쪽 넘기기가 더 눈에 띈다: 치는 것은 내가 하는 일이라 움직임이 내 탓으로 읽히지만, 쪽 넘기기는
+"같은 표의 다음 장" 이라 **같은 표가 다른 모습**으로 보인다.
+
+첫 묶음으로 잰 폭이 뒤 쪽의 긴 글자에 안 맞을 수 있다. 그런데 그것은 **사람이 손으로 끌어 둔
+표와 똑같은 흠**이다 — 끌어 둔 폭도 다음 쪽 글자에 안 맞는다. 안 맞으면 초기화를 누르면 되고
+그 단추가 바로 그 자리에 있다. **들쭉날쭉한 맞음보다 가만한 안 맞음이 낫다.** ('늦추기' 는 안
+썼다 — 움직임을 늦출 뿐 없애지 못하고, 치다 멈춘 뒤 한 박자 있다 칸이 움직이면 내가 한 일과
+끊겨 보여 더 뜻 모를 움직임이 된다.)
+
+**줄이 없을 때 잰 폭을 `null` 로 되돌리지 않는다.** 되돌리면 걸러서 0건이 될 때 만든 사람의
+틀로 튀고, 줄이 돌아올 때 **다시 재어** 또 튄다(실측: `200px 400px` → `120px 480px`). 그래서
+"이미 이 조건에서 쟀다" 를 걸쇠로 기억한다 — 그 조건에 **저장 열쇠도 든다**(열쇠가 갈리면 다른
+표이므로, 안 넣으면 새 열쇠의 표가 옛 표의 잼을 물려받는다).
+
+### 줄이 0개일 때도 쥔 폭을 쓴다 — 뜻을 잃은 막음을 걷었다
+
+`canApplyWidths` 에 `(resizeMode === 'fit' || items.length > 0)` 가 붙어 있었다. `grow` 에서
+줄이 없으면 쥔 폭을 버리고 만든 사람의 틀로 되돌리는 조건이다. 처음에는 **까닭을 모르는 채
+걷지 않겠다**고 두고 말귀에 넘겼는데, 말귀가 캐 와서(그리고 내가 다시 확인해서) 까닭이
+`741e4a61` 이 아니라 **그 앞**에 있고 지워진 주석에 남아 있는 것을 알았다:
+
+> 항목이 0개일 때(로딩/빈 상태)는 저장된 절대 px 폭 합이 현재 컨테이너 폭보다 커서
+> 불필요한 가로 스크롤이 생길 수 있어, 이때는 기본(fr 단위) grid로 되돌린다.
+
+**그 막음은 뜻을 잃었다.** `grow` 는 끈 만큼 넓어져 **줄이 있을 때 이미** 그 가로 스크롤이
+서는 모드다 — 그것이 `fit` 과 갈리는 점이고 `741e4a61` 머리말이 그렇게 적고 있다. 저장된 px
+합이 통보다 크다는 것은 그 사람이 그만큼 넓혀 두었다는 뜻이다. 그러니 이 조건이 없앤 것은
+가로 스크롤이 아니라 **빈 상태만 다르게 보이는 것**이었다.
+
+어긋남은 두 자리에서 보였다 — ① **화면에 들어갈 때마다**(`loading` 이면 소비처가 보통
+`items=[]` 를 준다) 만든 사람의 틀로 머리가 섰다가 자료가 오면 쥔 폭으로 **튀었다**,
+② 걸러서 0건이 되면 또 튀었다. 말귀 실측: 저장열쇠 있는 표 서른셋 중 `grow` 가 스물하나,
+그중 0건이 날 수 있는 것(찾기나 쪽이 있다)이 열일곱.
+
+**그리고 자동맞춤이 이것을 모두의 일로 바꿨다** — 전에는 `colWidths` 가 끌어 본 사람에게만
+있어 이 튐도 그 사람에게만 났는데, 이제는 아무도 안 끌어도 찬다. 그래서 이 판의 몫이다.
+
+**한 자리는 바로잡는다.** 말귀는 이것이 ①도 "모두의 일" 이 된다고 보았는데, **자동 모드의
+①은 걷어도 안 바뀐다** — 받는 중에는 잴 줄이 없으니 쥘 폭도 없다(틀 → 잰 폭은 남는다).
+걷어서 사라지는 것은 **손 모드의 ①**(마운트 때 저장값이 이미 있는데 눌려 있었다)과 **두
+모드의 ②**다.
+
+빈 줄(`.table-row--empty`)은 격자 줄이 아니라 `display: flex` 라 칸 폭을 안 쓴다 — 걷어도
+움직이는 것은 **머리뿐**이다. 말귀가 '혹시 거슬리면' 으로 내놓은 길(빈 줄을 통 폭으로)이
+이미 그렇게 되어 있다.
+
+**치르는 값은 솔직히 적는다** — 빈 상태의 가로 스크롤은 **아무것도 안 보여 준다**(밀어도 빈
+자리다). 줄이 있을 때의 스크롤은 내용을 보여 주니 그와 같지 않다. 그 값을 치르고 **머리를
+가만히** 두는 거래다. 사람이 읽는 것은 머리다.
+
+**그 조건을 지키는 시험이 있었다** — `Table.test.tsx` 의 *"항목이 없으면 저장된 px 폭 대신
+기본 폭으로 되돌린다"*. 말귀도 나도 못 보고 있었고 **관문이 울려서 알았다**(걷은 뒤 두 판에서
+울었다). 읽어 보니 까닭을 그 주석에 다시 적어 둔 것이라 위 셈이 그대로 들어맞았고, 뜻을
+뒤집어 고쳐 적었다 — 치르는 값까지 함께.
+
+되살려 심으면 셋이 운다(0건 튐 · 받는 중 튐 · 그 시험).
+
+**새 prop 을 두지 않았다 — 저장소의 없음 = 자동.** 그래서 이미 끌어 둔 사람의 폭은 판이
+올라도 그대로 손 모드로 읽힌다(**옛 값을 밀지 않는다**). 앱에서 고칠 것은 없다.
+
+**모습이 바뀌는 범위를 세었다.** 말귀·어드민의 `resizable` 표 서른둘 중 서른이 저장열쇠를
+가졌다. 한 번도 끌지 않은 사람에게는 그 서른이 자동맞춤으로 선다 — 청의 내용이 그것이다.
+저장열쇠가 없는 둘(`SentenceAnalysisNotes`·`PhonemeMissPopup`)은 열 때마다 자동이다.
+
+**자동은 `resizeStorageKey` 가 있는 표만 돈다.** 열쇠가 없으면 '손으로 조절했다' 를 기억할
+자리가 없어 영영 자동이 되는데, 열쇠 없는 `resizable` 표는 이 저장소에서 **전부 치면서
+걸러 보는 창**이다 — `ListPopup` 을 거치는 일곱 자리(말귀 셋·훈련 현황·어드민 셋)와
+`SentenceAnalysisNotes`·`PhonemeMissPopup`.
+
+처음에는 그 창들도 자동으로 두었다. 지시의 **글자**("조절한 적이 없으면 자동")에는 맞았다 —
+열쇠가 없으면 영영 '조절한 적 없음' 이다. **말귀가 그 창들을 열어 재어 반박했고, 그 말이
+맞았다**(2026-10-13): 거기서는 글자를 칠 때마다 결과 줄이 갈리고, "줄이 바뀌면 다시 잰다" 가
+**보는 사람 눈앞에서 칸을 움직인다.** 폭을 기억하지 않는 것과 폭이 매 글자마다 바뀌는 것은
+다른 일이고 뒤쪽이 더 거슬린다. 그 창들의 칸 틀에도 까닭이 적혀 있다 — `minmax` 바닥은 좁은
+창에서 유동 칸이 0px 로 눌려 낱말과 '걸린 소리' 가 포개지는 것을 막고(2026-10-02 실측),
+백분율은 걸러도 비율이 안 흔들리게 한다. 자동맞춤은 유동 칸을 내용 크기로 바꾸므로 그 결을
+매번 덮는다.
+
+`ListPopup` 머리말(*"창은 열 때마다 새로 짓는 것이라 폭이 따라다니면 엉뚱하다"*)이 정한 것은
+**'기억하지 않는다'** 까지이고 **'누가 칸을 정하나'** 는 아니었다 — 그것을 "그러니 대신
+자동맞춤" 으로 읽은 것이 내 잘못이었다. 나중에 그 창들도 자동으로 서는 게 낫다면 **그 표에
+저장 열쇠를 주면** 된다. 그러면 처음엔 자동, 끌면 기억, 초기화하면 다시 자동으로 지시가
+통째로 들어맞는다.
+
+**열쇠가 없어도 초기화 단추는 산다** — 눌렀을 때 그 자리에서 재어 쓴다(저장만 안 한다).
+신호만 올리면 그 표에는 자동 모드가 없어 **단추가 죽는다**(심어서 확인했다).
+
+**내 셈이 틀렸던 것도 적어 둔다.** 열쇠 없는 `resizable` 표를 둘로 세었는데, `<Table
+resizable>` 을 직접 쓴 자리만 훑어서 **`ListPopup` 을 거쳐 서는 일곱**을 놓쳤다. 창을 거치는
+표는 그 문법으로 안 걸린다.
+
+**보개(`ResizeObserver`)는 건드리지 않았다.** 통이 넓어질 때 따라가려면 신호가 필요한데, 통을
+보는 보개가 이미 `measureOverflow` 를 부른다 — 그 함수 **안에만** 통 폭을 적었다. 보개를 하나
+더 세우거나 `observe` 의 꼴을 건드리면 0.237.0 의 그 경합(`ref` 콜백과 effect 뒷정리의 차례)을
+다시 들인다.
+
+### 심어서 확인한 것 여섯 — 그중 하나는 눈먼 시험이었다
+
+① 자동이 저장하게, ② 초기화가 재서 저장하게, ③ 받는 중에도 재게, ④ 좁은 화면에서도 재게,
+⑤ 끌기가 손 모드로 안 넘기게, ⑥ 통 폭 신호를 안 적게 했을 때 — 처음에는 **④가 안 잡혔다**
+(열아홉이 다 초록이었다). 좁은 화면에서는 모바일 격자가 `colWidths` 와 상관없이 이기므로
+"격자가 모바일 틀인가" 로는 자동이 돌았는지를 **볼 수 없었다.** 재는 동안의
+`--table-grid-cols: max-content` 쓰기를 엿보는 꼴로 바꾸고, **그 엿봄이 넓은 화면에서는
+반드시 걸리는지**를 함께 재는 시험을 나란히 두었다(안 걸리면 0건은 "안 돌았다" 가 아니라
+"못 본다" 는 뜻이다).
+
+그 과정에 `vi.stubGlobal` 이 `restoreAllMocks` 로 **안 걷히는** 것도 드러났다 — 좁은 화면
+흉내가 뒤 시험으로 새고 있었다.
+
+**옛 시험 셋은 뜻이 바뀌어 다시 적었다** — 초기화가 저장한다고 적은 것, "누르기 전과 달라야
+한다" 로 잰 것(이제는 마운트 때 이미 자동으로 서 있어 같은 것이 맞다), 못 쓸 저장값이 만든
+사람의 틀로 떨어진다고 적은 것. 셋 다 **지키던 것은 그대로 지키게** 고쳐 적었다.
+
+
+### 기기 종류를 **영어 코드로** 받는다 — 이름표 두 벌은 한 자리로
+
+말귀 요청(2026-10-13). 앱이 `managed_device.type` 을 `'보청기'` → `'hearingAid'` 로 옮긴다.
+코어가 안 받으면 **터지지 않고 조용히 틀린다** — 배지에 `hearingAid` 가 날것으로 뜨고
+(`defaultValue` 로 떨어진다), 색이 둘 다 무채색이 되어 종류를 색으로 가르던 것이 사라진다.
+눈으로만 잡히는 꼴이라 앱이 판을 돌리기 **전에** 넣는다.
+
+| 저장값 | 배지 이름 | 배지 색 |
+|---|---|---|
+| `'hearingAid'` · `'보청기'` | `device.type.hearingAid` | `main` |
+| `'cochlearImplant'` · `'인공와우'` | `device.type.cochlearImplant` | `sub` |
+| `'other'` · `'기타'` | `device.type.other` **(새로 둔다)** | `default` |
+| 그 밖 | 저장된 그대로 | `default` |
+
+**모르는 값을 `'other'` 로 접지 않는다.** 기타는 "기타" 라고 고른 값이고, 모르는 값은 아직
+뜻을 모르는 것이다. 둘을 섞으면 새 종류가 생긴 날 조용히 '기타' 로 보인다. 모르는 값은
+**저장된 그대로** 보인다 — 화면에 날것이 보이면 자료에 무엇이 들어 있는지 알 수 있고,
+빈칸이면 아무것도 알 수 없다.
+
+**그리고 이름표가 두 벌이었다.** `deviceTypeKeys`·`deviceTypeLabel` 이 `DeviceSideTable` 과
+`PanelRow` 에 **주석까지 똑같이** 있었다(말귀가 짚었다). 색은 `deviceKind.ts` 에 모여 있었는데
+이름은 아니었다 — 색에 적어 둔 그 까닭이 이름에도 그대로 들어맞는 자리다. 그 둘을
+`deviceKind.ts` 로 모으고 `deviceKindLabel`·`deviceKindOf` 를 더했다.
+
+시험은 **심어서 확인했다** — ① 영어 코드를 안 받게, ② 사전에서 `other` 를 빼고, ③ 모르는
+값을 '기타' 로 접게, ④ 컴포넌트가 날것을 그리게 했을 때 넷 다 울었고 울음말이 까닭을
+그대로 말했다.
+
+남은 두 자리는 이 판에 없다 — `direction` 은 사장님이 "코어는 깔끔하게만" 으로 정하신 자리라
+`'left'|'right'` 만 받는다(말귀가 옮긴 뒤 쓴다), `style` 은 코어가 가르지 않고 지나보낸다.
+
+
+### `TrainingCard` 설명 줄도 한 급 흐리게 — 같은 판단을 같은 자리에
+
+사장님 지시(2026-10-13, 말귀_2 청). `WordTableButton` 설명 줄과 **같은 일**이다 — 카드 안의
+읽는 차례.
+
+| | 전 | 후 |
+|---|---|---|
+| `.training-card__description` | `--color-gray` #64748b | **`--color-lightGray`** #96a4b8 |
+
+제목이 `--color-darkGray`(#434d56)인데 설명이 #64748b 로 **두 급 차이가 한 급도 안 됐다** —
+제목과 설명이 한 덩어리로 읽혔다.
+
+**소비처가 열 몇이라 한 번 더 세었다.** 숙제 카드·훈련 묶음·플랜 카드·말귀자료실이 이 카드를
+쓴다. 그런데 **이 색이 닿는 것은 "문자열 한 줄로 거드는 설명" 뿐이다** —
+
+```tsx
+typeof description === 'string'
+  ? <p className="training-card__description body-3">{description}</p>
+  : description                    // ← 본문이 필요한 자리는 노드를 넘긴다. 이 클래스가 안 붙는다
+```
+
+본문을 쓰는 자리는 **구조적으로 이 색을 안 받는다.** 그래서 소비처가 열 몇이어도 무게는
+단어표 카드와 같다. 그 셈을 사장님께 올리고 기본값으로 정하셨다.
+
+> **흰 바탕 2.53:1 로 본문 기준(4.5)에 못 미치는 것을 알고 그렇게 둔다.** 되돌릴 때 볼 것도
+> 적어 뒀다 — `--color-gray`(4.8:1)가 그때의 기본이다. **코어에는 대비를 세는 못이 없다.**
+
+같은 회색을 쓰던 다른 셋(게시자·날짜·그 밖)은 **안 건드렸다** — 자리를 가려 설명 줄만 바꿨다.
+
+### 음소 자리 열쇠를 **코드로** — `'초성'` → `'onset'` (저장된 표는 안 민다)
+
+사장님 지시("동작에 한글이 끼지 말라"). 말귀 두 세션도 같은 자리를 청해 왔다.
+
+**그 열쇠는 저장된다** — 단어표의 `searchConfig.phonemeSelected` 가 `{ 초성: 'ㄴ' }` 꼴이고
+공개 함수(`searchPairs`·`searchWordsByPhonemes`·`convertToPhoneme`)가 그것을 그대로 받는다.
+그래서 **값을 바꾸지 않고 읽는 쪽을 너그럽게** 했다 — 표준의 *lenient reader · strict writer*.
+
+    쓰는 쪽은 코드만 낸다. 읽는 쪽은 둘 다 받는다. 저장된 표는 안 밀어도 된다.
+
+| | |
+|---|---|
+| 안쪽 어휘 | `'onset' \| 'vowel' \| 'coda' \| 'glide'` — **훈련 필터가 이미 쓰던 것**과 같게 뒀다(같은 뜻에 어휘가 둘이었다) |
+| 빔 | `'없음'` → `'none'` |
+| 값(자모 `'ㄴ'`) | **그대로** — 한국어 글자 그 자체다 |
+| `diffSection` | **옛 한글 이름 그대로** 내보낸다 + `diffSectionCode` 를 나란히 |
+
+`diffSection` 을 혼자 바꾸면 **말귀 대립쌍 화면의 묶음 넷이 조용히 빈다**(`GROUP_ORDER =
+['초성','모음','활음','종성']` 로 가른다 — 두 세션이 따로 세어 같은 자리를 짚었다). 결과 수는
+세는데 묶음에는 안 보이는 꼴이라 **터지지 않고 눈으로만 잡힌다.** 소비자가 옮긴 뒤 걷는다.
+
+### 밟은 함정 둘
+
+**① 돌림 import 로 시험 338 꾸러미가 무너졌다.** 가름을 `phonemePairSearch` 에 뒀는데 그쪽도
+`phonemeConvert` 를 들여온다. **두 쪽이 함께 쓰는 것은 어느 한쪽이 아니라 그 아래**에 둔다
+(`phonemeSectionCodes.ts`).
+
+**② 옮기기에 거르는 줄을 끼워 넣어 뜻이 바뀌었다.** `!value` 로 빈 값을 걸렀는데
+`{ 종성: '' }` 은 **"받침 없음을 골랐다" 는 뜻 있는 고름**이다 — `받침 있음↔없음` 검색이
+빈손이 됐다. 시험이 잡았다. *옮기는 함수는 옮기기만 한다.*
+
+문을 뒀다(`phonemeLegacyKeysRead1013`) — **옛 꼴과 새 꼴이 같은 결과**인지 재고, 둘 다 빈손이면
+"같다" 가 아무 말도 안 하므로 **센 것이 0 보다 큰지**까지 본다.
+
+### 겸해서 — 만든 것을 치운다
+
+저장소 폴더가 **600MB** 였다. `pack:check` 가 판마다 만든 tarball **59개·97MB** 와 그것을 풀어
+본 `package/` **9.8MB** 가 9월 3일부터 쌓여 있었다. **둘 다 `.gitignore` 에 있어 `git status`
+가 조용했다** — 무시 목록은 "커밋하지 말라" 는 뜻이지 "없다" 는 뜻이 아니다. 지우고(600→494MB),
+`pack:check` 가 `trap … EXIT INT TERM` 으로 **스스로 치우게** 했다.
+
+### `WordTableButton` 카드 — 읽는 차례를 세 겹으로 (말귀_2 청)
+
+사장님 지시(2026-10-13). 말귀_2 가 앱 CSS 로 덮어 두고 **껐다 켜 보기로 코어가 그 값을 안
+쥔 것**을 확인해 청해 왔다(§3-7 이 요구하는 꼴이다).
+
+| 자리 | 전 | 후 | 까닭 |
+|---|---|---|---|
+| `.word-table-button` | `width: 240px` | **280px** | 대립쌍표는 한 칸에 낱말이 둘('가게 / 마개') 들어가 240 에서 글자가 칸에 꽉 찼다. 320 은 한 줄에 드는 카드가 줄어 280 |
+| `.word-table-thumb__word` | `--color-black` #111 | **`--color-darkGray`** #434d56 | 제목과 **둘 다 #111** 이라 같은 무게로 섰다. 썸네일은 알아보는 그림이지 읽는 글이 아니다. 9.1:1 |
+| `.word-table-button__desc` | `--color-gray` #64748b | **`--color-lightGray`** #96a4b8 | 제목과 충분히 안 갈려 **한 덩어리로 읽혔다**. 2.53:1 — 아래를 본다 |
+
+셋이 한 가지 일이다 — **카드 안에 읽는 차례를 만드는 것**. 제목 #111 · 썸네일 #434d56 ·
+설명 #96a4b8 으로 세 겹이 된다.
+
+**폭은 손잡이를 내지 않았다.** 이 카드를 쓰는 화면이 셋인데(나의 단어표·말귀자료실·고객 채점
+담기) 셋이 같은 카드로 같은 일을 한다. 한 화면만 280 이면 *같은 카드가 화면마다 다른 폭*이
+되고, 나중에 그 까닭을 아무도 설명하지 못한다. 손잡이는 **폭이 다를 까닭이 자리마다 있을 때**
+내는 것이고, 280 은 자리의 사정이 아니라 **카드 자체의 값**이다.
+
+> **설명 줄은 흰 바탕 2.53:1 로 본문 기준(4.5)에 못 미치는 것을 알고 그렇게 뒀다.** 무엇인지는
+> 제목과 썸네일이 이미 말해 주고 이 줄은 곁들이는 설명이다. 손잡이(`descTone`)와 기본값을
+> 나란히 놓고 그 수를 보신 뒤 사장님이 **기본값**으로 정하셨다. **코어에는 대비를 세는 못이
+> 없다** — 막아 줄 것이 없는 자리라 사람이 정했고, 그 판단을 CSS 주석에 함께 적었다.
+
+색을 바꾼 자리에는 **되돌릴 때 볼 것**을 적어 뒀다 — 이 줄을 본문으로 승격하거나 옮길 일이
+생기면 `--color-gray`(4.8:1)가 그때의 기본이다.
+
+말귀_2 는 받으면 `MyWordTablePage.css` 세 줄과 `colorContrast` 예외 한 줄을 **통째로** 지운다
+(`height: 100%` 만 남긴다 — 그건 그 화면 격자와 짝인 줄이라 성격이 다르다).
+
+### ㉠ 단어표 설정 값을 **코드로** — `'단어'` → `'word'`
+
+사장님 지시("㉠ 가라"). **실측이 가름을 바꿨다 — 내가 "DB 를 미는 일" 이라 한 것이 틀렸다.**
+
+| 물음 | 답 |
+|---|---|
+| 저장되나? | **아니오** — `SavedWordTable` 에 그 값이 없고, 설정은 `useState` 뿐이다(`localStorage` 쓰기 자리 없음) |
+| 소비자가 그 값을 **적나**? | **아니오** — 말귀의 세 줄은 `contentTypes={settings.contentTypes}` 처럼 **코어 훅이 준 값을 되넘기는** 것뿐 |
+| `WordTableContentType`·`WordTableCutLine`·`PAGE_NUM_POSITION_VALUE` 등 여섯 이름 | 소비자 넷에서 **모두 0줄** |
+
+그래서 `DeviceSide` 와 성격이 다르다 — **코어가 만들고 코어가 읽는 값**이다. 받침도,
+마이그레이션도, 기다릴 결정도 없어 그냥 옮겼다. *무엇을 옮길 수 있나는 **어디에 저장되나**로
+갈린다 — 공개 타입이라는 것만으로는 못 가른다.*
+
+| 전 | 후 |
+|---|---|
+| `WordTableContentType = '단어' \| '이미지' \| '표준 발음' \| '구어체 발음'` | `'word' \| 'image' \| 'standardPron' \| 'colloquialPron'` |
+| `WordTableCutLine = '표시' \| '점선' \| '코너' \| '미표시'` | `'show' \| 'dashed' \| 'corner' \| 'hide'` |
+| 켜고 끄는 절의 값 `'표시'`·`'미표시'` | `SHOW`·`HIDE`(= `'show'`·`'hide'`) — 절 여섯이 같은 짝을 쓰므로 한 자리에 뒀다 |
+| 용지 방향 `value: '가로'` | `value: 'landscape'` — 타입(`WordTableOrientation`)이 이미 영어였다 |
+| 쪽 번호 `value: '왼쪽'` | `value: 'left'` |
+
+보일 글은 전부 사전이 쥔다 — `displayLabel: t('wordTable.filter.image', '이미지')`. 사전은
+한 줄도 안 바꿨다. **FilterPanel 이 `value` 로 가리고 `displayLabel` 로 그리기 때문**에
+값만 바꾸면 화면은 그대로다.
+
+### 옮기는 표가 **사라졌다**
+
+```
+전:  PAGE_NUM_POSITION_VALUE = { left: '왼쪽', … }        ← 코드 → 한글
+     parsePageNumberPosition: value === '왼쪽' ? 'left' …  ← 한글 → 코드
+후:  parsePageNumberPosition: value === 'left' ? value … ← 모르는 값만 'none' 으로
+```
+
+변환표와 파서가 **둘 다** 있던 까닭이 "값이 한글" 이었다. 값을 코드로 돌리니 표가 항등식이
+되어 걷혔다. *옮기는 표가 사라지는 것이 옳게 옮긴 표시다.*
+
+### tsc 가 **같은 값을 두 자리에 적은 것**을 잡았다
+
+`WordTableBlock` 이 공개 타입과 **같은 값을 따로** 적고 있었다(`type ContentType = '단어' | …`).
+한쪽만 고치면 조용히 갈리는 자리다 — 공개 타입을 가리키게 모았다.
+
+### 문을 뒀다 — `test/publicTypeValuesAreCodes1013.test.ts`
+
+**내보내는 타입의 글자 값**에 한글이 없는지 센다. 글자가 곧 자료인 타입(조사·한글 자모·음소
+열쇠)은 자리와 까닭을 적어 허락한다. 심어서 잡히는 것도 봤다.
+
+### ㉣ 말에 따라 글귀를 고르는 가름을 **사전으로** — `KO_ORD` → `weekLabel`
+
+사장님 지시("모두 표준으로 맞춰라")로 **동작에 끼는 한글 값 87개·190자리**를 세어 네 몫으로 갈랐다.
+㉣(코드에 박힌 화면 글귀)를 먼저 했다.
+
+**열어 보니 셋은 이미 표준이었다 — 내 앞 분류가 과장이었다.** 등급 설명 5줄과 요일 배열은
+`t(…, { defaultValue })` **되돌이값**이고 사전(ko·en)에 둘 다 있다. 결과 판정
+(`['ok','true','맞음','정답']`)은 **서버가 주는 값을 너그럽게 읽는 길목**이라 표준이 오히려
+권하는 꼴이다. 그래서 ㉣ 는 18자리가 아니라 **한 자리**였다.
+
+| 전 | 후 |
+|---|---|
+| `export const KO_ORD = ['첫째', …]` + 쓰는 쪽마다 `lang.startsWith('ko') ? …주 : Week …` | `weekLabel(t, week)` — 사전이 쥔다 |
+
+**같은 가름이 세 자리에 흩어져 있었다** — 코어 둘(`BarChart`·`useBarChartControl`)과 **말귀 하나**
+(`periodLabel.ts`, 깊은 길로 `KO_ORD` 를 들여온다). 말이 하나 늘면 세 자리를 다 고쳐야 하고,
+한 자리만 안 고치면 화면에서 갈린다.
+
+사전으로 옮기니 **가름이 한 자리로 모이고, 그 자리로 흘러들던 인자까지 사라졌다** —
+`barsFromControl(…, lang?)` 의 `lang`, `BarChart` 와 `useBarChartControl` 의 `i18n`. 셋 다
+쓰이지 않게 되어 걷었다. *가름을 옮기면 그 가름을 먹이던 길도 함께 걷힌다.*
+
+### 지킴이가 가르친 것 — 열쇠도 보간 변수도 **짝**이어야 한다
+
+처음엔 ko 에만 `weekOrdinal` 을 두고 `{{ord}}`(ko)·`{{n}}`(en) 으로 갈랐다. 사전 지킴이 셋이
+울었다 — **ko 에 있는 열쇠는 en 에도**(없으면 영어 화면에 한국어가 뜬다), **보간 변수도 같아야**
+(로케일을 바꾸면 `{{변수}}` 가 그대로 보이거나 값이 빈다). 변수 하나(`ord`)로 모으고 en 에는
+숫자 표(`['1','2',…]`)를 두어 `Week {{ord}}` 가 같은 변수로 맞게 했다.
+
+### 문을 뒀다 — `test/langBranchInDict1013.test.ts`
+
+`src` 에서 **말을 보고 가르는 자리**를 센다. 넷이 걸렸고 **넷 다 글귀 고르기가 아니었다** —
+로케일을 고르거나(`'ko-KR'`·`'en-US'` → Intl), 읽어 줄 목소리를 고르거나, **조사를 붙인다**
+(붙일 조사가 그때 그 낱말의 받침에 달려 있어 사전이 못 한다). 자리마다 까닭을 적어 허락했다.
+
+그 문도 한 번 틀렸다 — 주석을 걷은 뒤의 줄 번호를 적어 **자리가 밀렸다**(엉뚱한 줄을 가리켰다).
+줄바꿈만 남기고 지운다.
+
+### 소비자 쪽
+
+**말귀의 `periodLabel.ts` 는 `KO_ORD` 를 깊은 길로 들여온다** — 이 판을 받으면 그 import 가
+깨진다. `weekLabel(t, week)` 로 옮기면 그쪽 `lang` 가름도 함께 사라진다. 알렸다.
+
+### 옛 한글 이름 셋을 걷었다 — `칸순` · `정렬` · `칸`
+
+아침에 영어 이름 옆에 `@deprecated` 로 남겼던 셋을 그날 걷었다(사장님 지시). **걷기 전에
+소비자 넷을 직접 셌다** — 전해 들은 말로 걷지 않았다:
+
+| 저장소 | 코어 `useTableSort` 자리 | `칸순` 들여오는 줄 |
+|---|---|---|
+| speechear-v2 | **열 자리, 전부 `{ sort, field }`** (남은 한글은 주석뿐) | **0** |
+| speechear-v2/admin | 제 훅이다(`useTableSort(rows, pick)` → `{ sorted, sortField }`) | 0 |
+| kscan · sound-localization-system · speechear-fe | 0 | 0 |
+
+**이것은 공개 API 를 걷는 변경이다.** 다음 판을 받는 소비자가 그 이름을 쓰고 있으면 깨진다 —
+위 표가 그 수가 0 임을 센 근거다.
+
+두 지킴이의 표에서도 그 셋을 지웠다 — **걷었으면 표에서도 지운다**(`identifiersAreEnglish1013`
+의 셋째 조항이 그것을 센다). `publicApiEnglishNames1013` 은 꼴을 뒤집어, 이제 **걷은 이름이
+돌아오지 않았나**를 센다.
+
+**그 자리에서 못 둘을 또 고쳤다.** dist 곁셈이 `length > 1000` 으로 세고 있었는데, 옛 이름 한
+줄을 걷자 956 이 되어 빨개졌다 — **재려던 것과 아무 관계 없는 숫자**였다(`declare function
+compare` 가 있는지로 바꿨다). 그리고 그 곁셈이 아직 `칸순` 을 찾고 있었다.
+
+**이제 저장소에 이름으로 남은 한글은 하나도 없다.** 남은 한글 식별자 42자리는 전부 **값**이다
+(음소 열쇠·필터 절 이름·낱말로 찍는 열쇠).
+
+### 놀이터가 **쓸이를 건너뛰었다** — `tsconfig.test.json` 이 안 싣는다
+
+앞 꼭지에서 `test`·`playground` 를 쓸었다고 적었는데, **놀이터는 손도 안 댔다.**
+쓸이가 `tsconfig.test.json` 으로 프로그램을 짓는데 그 설정에 **놀이터 파일이 0개**다.
+`지도에없음: 0` 이 떴고 관문 열여섯이 다 초록이었다 — **안 들른 것을 아무도 안 셌다.**
+
+    설정이 싣는 것만 훑으면, 설정이 빼먹은 것은 **조용히 통과한다.**
+
+새로 세운 지킴이(`test/identifiersAreEnglish1013.test.ts`)가 그것을 잡았다. 그 문은 설정이
+아니라 **파일을 직접 훑는다.** 그래서 이번에 놀이터를 따로 돌렸다 — 선언 **640자리·2,182처·95파일**.
+
+**저장소에서 한글로 남은 이름은 45자리뿐이고, 자리마다 까닭을 적었다.** 셋은 소비자가 옮기는
+동안 남긴 옛 이름(`칸순`·`정렬`·`칸`)이고 나머지는 **이름이 아니라 값**이다 — `sel['초성']`
+처럼 자료 열쇠이거나(`DeviceSide` 와 같은 몫), 필터 절 이름, 낱말로 찍는 열쇠다.
+
+### 놀이터에서 더 밟은 함정 둘
+
+- **JSX 태그 둘**(`여백재기`·`차례로듣기`)이 소문자가 되어 HTML 요소로 읽혔다 — 못이 막았다.
+- **가림 여섯** — `비` → `ratio`, `정렬` → `sort` 처럼 안쪽·바깥 묶음에 그 이름이 이미 있었다.
+
+`setX` 꼴 **81개**는 밑이름에서 만들었다(`set접힘` → `setCollapsed`) — 손으로 적으면 어긋난다.
+
+### 안쪽 식별자를 영어로 — `test`·`playground` 3,278자리
+
+앞 꼭지가 `src` 였고 이번이 나머지다. **선언 3,278자리·21,460처·504파일.** 남은 한글 선언은 **0**.
+저장소 전체에서 한글로 남은 이름은 `칸순`(옛 공개 이름)과 음소 자료 열쇠뿐이다.
+
+`src` 와 같은 연장을 썼고(`scripts/rename-identifiers.mjs`), 이름은 잦은 것부터 사전으로 지었다
+(`scripts/identifier-map.test.json`, 1,585개). 시험 쪽 이름은 결이 고르다 — `표`·`글`·`줄`·`칸`.
+
+### 이번에 새로 밟은 함정 다섯 — 넷은 `tsc` 가 못 본다
+
+| 함정 | 무엇이 깨졌나 | 어떻게 막았나 |
+|---|---|---|
+| **예약어** | `경우` → `case` 로 적어 그 파일이 통째로 문법 오류가 됐다 | 연장이 예약어를 거부한다 |
+| **JSX 태그는 대문자** | `<화면 />` 을 `<page />` 로 만들자 React 가 **HTML 요소**로 읽었다(22자리) | JSX 태그로 서는 이름은 대문자인지 본다 |
+| **React 가 가로채는 prop** | `열쇠` → `key` 로 보냈더니 **컴포넌트가 그 값을 못 받는다** — 쪽 되돌리기가 조용히 죽었다 | 그 자리는 `resetKey` 로 |
+| **나를 가리는 안쪽 이름** | `뿌리` → `root` 가 안쪽 콜백의 postcss `root` 에 가려 `root.length` 가 엉뚱한 것을 가리켰다 | 가림 셈이 **안쪽 묶음**도 본다(아홉을 더 잡았다) |
+| **자료 열쇠** | `{ 가: … }` 의 `가` 는 낱말 `'가'` 다 — 영어로 바꾸자 대립쌍 조회가 빈손이 됐다 | 성질 열쇠 중 **그 글자가 같은 파일의 문자열로도 쓰이는 것**은 값으로 보고 둔다 |
+
+**그 가름은 자리별이 아니라 파일·이름 단위여야 했다.** 처음엔 줄 단위로 갈랐는데, 그러면 타입의
+성질은 한글로 남고 객체 리터럴만 영어가 되어 **반만 바뀐다**(두 파일이 그랬다). 한 파일에서 한
+이름은 **모두 바꾸거나 모두 둔다.**
+
+**셈을 돌리는 자리도 한 번 틀렸다** — 자료 열쇠를 세는 스크립트가 **이미 바뀐 작업본**을 읽어
+한글 열쇠를 못 찾았다. 셈은 `git show HEAD:` 로 읽는다.
+
+### 안쪽 식별자를 영어로 — `src` 966자리 (사장님 지시 "코어도 전부 영어로")
+
+사장님 지시(2026-10-13 *"코어도 전부 영어로 — 한 번에"*). 말귀가 제 저장소에서 같은 일을 하며
+코어도 같은 결로 가는 게 좋겠다고 짚어 왔고, 사장님이 범위를 정하셨다.
+
+**`src` 안의 한글 식별자 966 선언·3,801처·161파일을 옮겼다.** 공개 API 는 이미 0.322.0 에서
+영어로 갔으니, 이 판은 **소비자에게 아무 영향이 없다** — 안쪽 이름뿐이다.
+
+**정규식으로 하지 않았다.** 한글은 `\w` 가 아니라 `\b` 로 경계를 못 잡고, 주석·문자열에 같은
+글자가 널려 있다. TypeScript 구문으로 선언 마디를 집고 `findRenameLocations` 로 **그 자리들만**
+고쳤다(`scripts/rename-identifiers.mjs`). 이름은 자리마다 뜻을 보고 손으로 골랐다 — `칸` 하나가
+열·셀·슬롯 셋으로 쓰이고 있어 전역 치환은 애초에 쓸 수 없었다(`scripts/identifier-map.src.json`).
+
+**남긴 것은 다섯이다 — 넷은 이름이 아니라 값이다.**
+
+| 남긴 이름 | 까닭 |
+|---|---|
+| `칸순` | 옛 공개 이름(`@deprecated`) — 소비자가 다 옮긴 뒤 걷는다 |
+| `초성`·`모음`·`종성`·`활음` | `SectionKey` 의 **값**이고 `sel['초성']` 으로 객체를 찍는다 — `phonemeConvert` · `PhonemeSelectBlock` 이 그 글자로 견준다. `DeviceSide` 와 같은 몫으로, 바꾸려면 저장된 자료와 함께 간다 |
+
+### 이번에 잡은 것 — **`tsc` 가 못 보는 가림**
+
+쓸어내다 이런 것이 나왔다:
+
+```
+before:  if (끌었다 && 자리 != null && 자리 !== index) 옮기기(index, 자리)
+after:   if (didDrag && index != null && index !== index) move(index, index)
+```
+
+`자리` 를 `index` 로 옮겼더니 **바깥 인자 `index` 를 가렸다.** `index !== index` 는 늘 거짓이고
+`tsc` 는 0, 단어표 끌어 옮기기가 **조용히 죽었다.** 행동 시험 하나가 잡았다.
+
+그래서 **옮기기 전에 가림을 세는 문**을 뒀다(`scripts/check-name-shadowing.mjs`) — 선언을 품은
+**바깥 묶음들**에 새 이름이 있나 본다. 아홉이 걸려 그중 넷이 참이었고(다섯은 성질 이름 — 성질은
+묶음을 안 탄다) 넷을 다른 이름으로 돌렸다. 같은 파일에 **이미 있던** 이름과 겹치나도 따로 센다
+(`scripts/check-name-clash.mjs`) — 같은 묶음이면 `tsc` 가 잡지만 안쪽 묶음이면 조용하다.
+
+### 공개 멤버 둘이 줄임 꼴에 휩쓸렸다 — 또박또박 적는다
+
+`return { …, 정렬, 칸 }` 의 **줄임 꼴**이 지역 이름을 따라가 `정렬`·`칸` 두 공개 멤버가
+사라졌다. 이제 `정렬: sortState` · `칸: fieldHead` 로 적는다 — 지역 이름이 무엇으로 바뀌어도
+공개 이름은 그대로다. **그리고 내 지킴이가 그것을 못 잡았다**(아래).
+
+### 못 셋을 고쳤다
+
+| 못 | 무엇을 헛봤나 |
+|---|---|
+| `publicApiEnglishNames1013` | `toContain('정렬')` — 그 글자가 **화면 글귀 문자열**에 있어 멤버가 사라진 뒤에도 초록이었다. 이제 `정렬\s*:\s*sortState` 처럼 **그 꼴**을 본다 |
+| 같은 못 | **기본값 있는 인자**(`= false`)를 안 봤다 — 그래서 `computePeaksFromUrl(…, 앞무음건너뛰기 = false)` 가 0.322.0 의 `audioPeaks.d.ts` 에 `앞무음건너뛰기?: boolean` 로 나갔다. 못을 고치니 바로 그 하나를 잡았고, 이 판에서 `skipLeadingSilence` 로 옮겼다 |
+| `audioPlayerPadWiring` | 소스를 `search(…) + 40` 으로 끊고 있었다 — **그 숫자가 옛 이름 길이에 매여** 있어, 이름이 길어지자 재려던 `'lead'` 가 잘려 `921 < -1` 을 견주었다. 줄 끝으로 끊는다 |
+
 ## 0.322.0 — 공개 API 를 영어로
 
 ### 공개 API 의 이름을 영어로 — **값은 그대로**(그날 아침)