@ihabdevteam/core 0.212.0 → 0.214.0

package/CHANGELOG.md

@@ -7,6 +7,107 @@ All notable changes to this project will be documented in this file.
 > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
 > 제 이야기를 못 찾는다.
 
+## 0.214.0
+
+### 달라짐 — 종이 띠를 손보고, 표 설정에서 켜고 끈다
+
+0.213.0 의 머리·바닥 띠를 화면에서 보며 고친 것들이다(사용자 지시 2026-09-30).
+
+**우상단은 `표 제목 · 기관 이름 · 표 번호`** 다. 표 번호는 그 기관(말귀매니저) 안에서만
+고유하므로 이름과 함께여야 어느 곳의 몇 번인지 정해진다. 없는 조각은 가운뎃점도 안 찍는다.
+좁아지면 **표 제목이 먼저** 줄고 기관 이름·번호는 안 줄인다 — 번호가 잘리면 확인 글자가
+사라져 뜻이 없다. `brand.title` · `brand.owner` 가 새로 있다.
+
+**글씨는 위 11px · 아래 8px, 둘 다 `--color-gray`.** 토큰(caption-1/2)을 쓰다가 손으로 적은
+값으로 내렸다 — 종이 전용 값이라 그렇다. 번호만 진하게 두던 것도 걷었다: 머리 줄 전체가
+종이를 식별하는 잔글이라 한 무게로 읽히는 편이 낫다.
+
+**말귀 로고는 컬러 28px, ihab 로고는 17px 이고 글자색을 입는다.** ihab 은 흰 판 SVG 를
+**마스크로 오려** 그 자리를 `currentColor` 로 칠한다 — 파일에 `fill` 이 박혀 있어 `<img>`
+로는 색을 못 바꾼다. 마스크 주소는 **CSS 가 제 곁의 파일을 직접 가리킨다**(인쇄 문서는
+스타일시트를 통째로 베껴 가므로 함께 간다).
+
+**표 설정에 `상단 정보`·`하단 정보` 세그먼트가 섰다.** 한쪽씩 끌 수 있고, 끄면 비우는 여백도
+함께 사라진다(`brand.top`·`brand.bottom`). 띠를 쓰는 화면에서만 세운다 —
+`useWordTableDisplaySettings(items, { paperBands: true })` · `TableFilterPanel` 의
+`showPaperBands`.
+
+**`페이지 번호` 자리 고르개는 걷었다.** 쪽 번호가 바닥 띠 오른쪽에 고정으로 서므로 고를
+자리가 없다. `pageNumberPosition` 프롭은 남아 있어 띠를 안 쓰는 화면은 전처럼 자리를 정한다.
+
+**쪽 번호는 하단 정보에 딸린 것이다** — '하단 정보'를 끄면 **쪽 번호도 함께 사라진다.**
+옛 자리로 돌려보내지 않는다: 그 자리는 띠가 없던 시절의 것이고, 끈 사람은 그 줄을 안
+보겠다고 한 것이다. 띠를 아예 안 쓰는 표는 전과 똑같다.
+
+**표 번호와 공유 링크는 다른 것이다.** 놀이터 예시가 `…/t/1043-E` 라 번호에서 주소가
+나오는 것처럼 보였다 — `…/s/9f3k2p` 로 고치고, 둘이 나오는 데가 다름을 프롭 글과 시험에
+적었다.
+
+### 손본 것 — 속성 사이의 주석이 `style` 을 삼켰다
+
+ihab 로고에 마스크를 인라인으로 주면서 **JSX 속성 사이에 블록 주석**을 끼웠더니 묶개(oxc)가
+뒤따르는 `style` 을 통째로 흘렸다. 타입 검사는 통과해 한참 뒤에야 알았고, 그 사이 화면에는
+마스크 없는 회색 막대가 떠 있었다. 설명은 마디 **밖**에 적는다. 지금은 마스크를 CSS 가 쥐어
+인라인 자체가 없다.
+
+## 0.213.0
+
+### 더해짐 — 종이 위·아래 띠 (`brand`)
+
+인쇄한 단어표에 **누구 것이고 어디로 가면 되는지**를 담는다(사용자 지시 2026-09-30).
+네 자리다 —
+
+| 자리 | 담는 것 |
+|---|---|
+| 위 왼쪽 | 말귀 로고 |
+| 위 오른쪽 | 표 번호(`code`) |
+| 아래 왼쪽 | ihab 로고 · 저작권 |
+| 아래 오른쪽 | 주소(`brand.link`) · 쪽 번호 |
+
+**안 주면 종이가 한 픽셀도 안 바뀐다.** 띠는 격자 위아래를 비워 만드는 것이라(쪽 번호가
+쓰던 수를 넓혔다) 칸이 그만큼 낮아진다 — 안 쓰는 표까지 낮아지면 안 된다. 비우는 만큼은
+띠 높이에 딱 붙인다(위 32px · 아래 24px, 남는 틈 4px) — 헐거우면 로고와 칸 사이가 벌어져
+종이가 성기어 보인다.
+절취선 바탕과 외곽선은 칸이 있는 데까지만 두른다(비운 띠가 선 색으로 차거나, 로고가
+표 안에 든 것처럼 보이지 않게).
+
+**띠를 격자 안에 둔다.** 인쇄는 `.word-table-block__content` **하나만** 복사해 간다
+(`contentRef` → `printWordTableElements`). 종이(`.word-table`) 바로 아래에 두면
+**화면에서는 멀쩡하고 종이에서만 사라진다** — 아무 데서도 안 터지고 뽑아 보기 전에는
+모른다. 자리는 절대 배치로 잡는다(격자가 이미 `position: relative` 라 외곽선을 안 쓰는
+표에서도 제자리다). 시험이 이것을 못 박는다 — 띠를 격자 밖으로 옮겨 심으면 셋이 빨개진다.
+
+인쇄 문서는 `document.styleSheets` 를 통째로 베껴 가므로 이 규칙들이 따라간다. 로고는
+`Footer` 가 하듯 곧장 들여온다 — 주소가 `data:` 이거나 `/assets/…` 라 손으로 지은 그
+문서에서도 풀리고, 그림이 다 받아진 뒤 인쇄하는 것은 `wordTablePrint` 가 이미 한다.
+
+**쪽 번호는 띠를 쓰면 바닥 띠가 자리를 겸한다** — 옛 자리(`pageNumberPosition`)에 두 번
+찍지 않는다. 띠를 안 쓰면 전과 똑같다.
+
+**띠는 표와 함께 줄지 않는다.** 종이는 미리보기 상자에 맞춰 통째로 줄어드는데(`scale`),
+그러면 로고와 글씨가 상자 폭마다 달라 보인다. 띠 안의 치수를 배율로 나눠(`--wt-unscale`)
+화면 크기를 한결같이 둔다 — 비우는 여백도 같이 나눠야 띠가 칸을 안 침범한다.
+
+그 값은 **인라인으로 격자에 박히므로 종이에서 꺼야 한다.** 안 끄면 미리보기가 좁았을수록
+그 배수만큼 커져 찍힌다(0.5 로 보고 있었으면 두 배). 화면을 그대로 찍는 `@media print` 는
+`--wt-unscale: 1 !important` 로, 새 창·내려받기는 복사할 때 인라인 값을 지워서 끈다 —
+**두 인쇄 길에 각각 손을 대야 한다.**
+
+띠 글씨는 **body-3 급**이다. 손으로 적은 13px 을 쓰다가 디자인 시스템 값으로 바꿨다
+(`--text-body-3-size`) — 클래스를 그냥 붙이면 크기가 고정돼 위 되돌림이 안 먹으므로 같은
+토큰에 되돌림만 곱한다. 그 토큰은 보는 사람 쪽 설정(좁은 화면 · 큰 글씨)을 타므로 종이
+글씨도 그만큼 달라진다 — 화면과 종이를 한 급으로 맞추기로 한 값이다.
+
+말귀 로고는 **컬러 판**이라 `print-color-adjust: exact` 를 준다(브라우저 인쇄 기본값이
+색을 빼면 흐려지거나 사라진다). 표 번호·주소·저작권은 **다른 글꼴을 안 쓴다** — 고정폭으로
+찍어 봤더니 한 장 안에 글꼴이 둘 섞여 보였다. 목록 카드(`WordTableButton`)의 번호는 청한
+대로 고정폭 그대로라, 그 둘은 갈린다.
+
+### 더해짐 — `WordTable` 의 `code`
+
+`WordTableButton` 의 같은 이름 프롭(0.212.0, 말귀 요청 ㉚)과 짝이다. 목록 카드에서 번호로
+찾고, 종이에서도 같은 번호를 본다. 고정폭(`--font-mono`)으로 찍는 것도 같다.
+
 ## 0.212.0
 
 ### 더해짐 — `WordTableButton` 에 짧은 식별 글 (말귀 요청 ㉚)