@ihabdevteam/core 0.367.0 → 0.369.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,147 @@ All notable changes to this project will be documented in this file.
7
7
  > 적은 글이라, 지금 이름으로 고쳐 놓으면 그 시절에 그 이름으로 받은 사람이
8
8
  > 제 이야기를 못 찾는다.
9
9
 
10
+ ## 0.369.0 — 접으면 **넓혀 둔 폭을 푼다** (0.368.0 의 빈틈)
11
+
12
+ 사장님이 화면에서 짚으셨다 — *"접었다 펼 때 흔들리는 거 같은데?"*.
13
+
14
+ 0.368.0 에서 *"열이 넘치면 안쪽 상자를 열 폭만큼 넓힌다"* 를 넣으면서 **머리줄이 있을
15
+ 때만** 손대게 했다. 그런데 **접으면 머리줄이 사라진다** — 그래서 넓혀 둔 폭이 그대로
16
+ 남았다. 제목 한 줄만 남은 표가 1170px 을 쥔 채 가로 스크롤을 달고, 머리의 단추가 그릇
17
+ 밖으로 밀려난다(실측: 그릇 721 · 접힌 머리 **1170** → 고친 뒤 **778**).
18
+
19
+ 머리줄이 없으면 **비운 채로 둔다**. 한 줄이다.
20
+
21
+ > 조건을 좁힐 때는 **그 조건이 거짓이 되는 때**를 함께 본다.
22
+
23
+ **재다가 내 도구가 화면을 깨뜨렸다** — 호출 횟수를 세려고 `CSSStyleDeclaration.prototype`
24
+ 의 접근자를 바꿨는데 그 속성이 그 자리에 없어 **되돌리기가 실패**했고, 그 뒤 모든 표가
25
+ `Cannot read properties of undefined` 로 죽었다. 콘솔의 그 오류를 제품 흠으로 읽을 뻔했다.
26
+ 새 탭(새 realm)을 열어 가렸다 — **재는 쪽이 재는 자리를 망가뜨릴 수 있다.**
27
+
28
+ ## 0.368.0 — 표 열 정의에 **폭·맞춤·정렬**을 담는다
29
+
30
+ 사장님 지시 — *"table field 개선좀 하자"*, 이어서 *"useTableSort 기본값을 true 로"*.
31
+
32
+ 세 가지가 열 정의(`fields`) **밖**에 있었다.
33
+
34
+ ### ① 열 폭을 `fields` 에서 적는다
35
+
36
+ 전에는 `Table` 의 `gridTemplateColumns` 문자열 하나로만 적었다. **열 정의와 폭이 따로
37
+ 떨어져 있어서** 열을 하나 넣고 빼면 두 곳을 같이 고쳐야 했고, 개수가 어긋나도 조용히
38
+ 어긋난 채 그려졌다. 이 저장소가 늘 싫어하던 *한 결정이 두 곳에 적히는* 꼴이다.
39
+
40
+ ```tsx
41
+ fields={[{ label: '이름', width: 'minmax(120px, 1.4fr)' }, { label: '점수', width: 88 }]}
42
+ ```
43
+
44
+ 숫자는 `px` 로 읽는다. **모든 열에 적어야 쓰인다** — 반만 적힌 폭으로 격자를 지으면
45
+ 나머지가 어떤 폭일지 아무도 모른다. 반만 적었거나 `gridTemplateColumns` 와 함께 줬으면
46
+ 개발 모드에서 알려 준다(둘 다면 `gridTemplateColumns` 가 이긴다 — 예전 코드가 안 깨지게).
47
+
48
+ ### ② 맞춤(`align`)이 머리와 본문에 **함께** 걸린다
49
+
50
+ 전에는 숫자 열을 오른쪽으로 보내려면 소비처가 `className` 으로 CSS 를 붙였고, **머리에만
51
+ 붙이고 본문을 빠뜨리기 쉬웠다**(그러면 머리와 값이 서로 다른 쪽에 붙는다). 이제 열에
52
+ `align: 'right'` 하나면 둘 다 걸린다.
53
+
54
+ ### ③ 정렬을 `Table` 이 엮는다
55
+
56
+ `useTableSort` 는 이미 코어에 있었다 — 없던 것은 **연결**이다. 전에는 열마다
57
+ `field('이름','name')` 을 불러 `sortDir`·`onClick` 을 손으로 엮어야 했다.
58
+
59
+ ```tsx
60
+ const { sort, field, sortRows } = useTableSort<'name' | 'score'>({ defaultKey: 'name' })
61
+ <Table sort={{ sort, field }} fields={[{ label: '이름', sortKey: 'name' }]} items={rows} … />
62
+ ```
63
+
64
+ `sortDir` 를 직접 준 열은 그쪽이 이긴다 — 정렬을 제 손으로 쥔 표가 안 깨진다.
65
+ **데이터를 세우는 것은 여전히 부르는 쪽**이다(`sortRows`). 서버가 세워 주는 표도 있다.
66
+
67
+ ### `useTableSort({ defaultKey })` — 처음부터 정렬돼 있게
68
+
69
+ 전에는 표가 뜰 때 정렬이 꺼져 있고 사람이 머리를 눌러야 켜졌다. 받은 차례가 곧 뜻인
70
+ 표에는 그 꼴이 맞지만, 이름 차례로 보여야 하는 표는 **한 번 눌러 줘야** 제 모습이 됐다.
71
+
72
+ 처음 값은 `useState` 의 게으른 꼴로 **한 번만** 짓는다 — 매 렌더마다 새 객체를 지으면
73
+ `useTablePaging` 의 `resetOn` 이 그것을 열쇠로 보아 **늘 첫 쪽으로** 돌아간다. 못으로 박았다.
74
+
75
+ ### 정렬(`sortable`)도 **기본으로 켜진다**
76
+
77
+ 사장님 지시 — *"sort 기능도 기본값을 true 로"*. `resizable` 과 같은 결이다. 전에는
78
+ `useTableSort` 를 불러 `sort` 를 넘겨야 머리가 눌렸다. 이제 **아무것도 안 넘겨도** 코어가
79
+ 제 안에서 차례를 쥐고 줄까지 세운다.
80
+
81
+ 값은 `sortValue` → `sortKey` → **칸에 그려진 값** 차례로 찾는다. 셋 다 없는 열(배지·단추
82
+ 같은 마디만 있는 칸)은 **조용히 빠진다** — 정렬 못 하는 것에 화살표를 띄우면 눌러도 아무
83
+ 일이 없다.
84
+
85
+ **한 열이라도 `sortDir`·`onClick` 을 직접 받았으면 코어가 통째로 빠진다.** 안 그러면 한
86
+ 표에서 어떤 열은 부르는 쪽이 세우고 어떤 열은 코어가 세운다 — 눌러 보기 전에는 어느
87
+ 쪽인지도 모른다. `sort`(= `useTableSort()`)를 넘기는 표도 전과 같다: 코어는 화살표만
88
+ 그리고 줄은 부르는 쪽이 세운다(서버가 세워 주는 표·쪽넘김과 엮인 표가 그 자리다).
89
+
90
+ ### 끌 때는 **적어 둔 최소값 밑으로도 간다**
91
+
92
+ 사장님이 짚으셨다 — *"조절 핸들을 왼쪽으로 당길 때 안 간다"*. 어드민 회원 표가
93
+ `minmax(260px, 2fr)` 이라 왼쪽으로 아무리 당겨도 **260 에서 멈췄다**(실측: 260 → 끌어도
94
+ 260, 150 → 끌어도 150). 오른쪽으로는 늘어나니 **한쪽만 고장난 것처럼** 보였다.
95
+
96
+ 적어 둔 최소값은 **자리가 모자랄 때 코어가 지켜 주는 수**다. 사람이 손으로 당기는 것은
97
+ *"나는 이만큼으로 보고 싶다"* 는 뜻이라 그 보호가 오히려 길을 막는다. **끌 때의 바닥은
98
+ `MIN_COL_W`(48) 하나**로 하고, 되돌리기·자동맞춤은 적어 둔 값을 그대로 지킨다.
99
+
100
+ 실측(어드민과 같은 설정): 260 → 180 → 60 → **48에서 멈춤** → 초기화하면 260 복귀.
101
+
102
+ 옛 계약을 박고 있던 시험 하나가 울어서 새 계약으로 고쳤다 — *끌 때는 밑값 밑으로도
103
+ 간다* 와 *그래도 48 밑으로는 안 간다* 둘로 갈라 센다.
104
+
105
+ ### 열 폭 조절(`resizable`)이 **기본으로 켜진다**
106
+
107
+ 사장님 지시 — *"resizable 을 core 역할로 하고 기본값을 true 로"*. 전에는 꺼짐이 기본이라
108
+ 폭을 조절하고 싶은 표마다 `resizable` 을 적어야 했다. 표는 열 폭이 화면마다 아쉬운
109
+ 물건이라 **켜 두는 쪽이 맞는 기본값**이고, 이제 **끌 표에만** `false` 를 적는다.
110
+
111
+ 좁은 화면(767px 이하)에서는 전과 같이 **늘 꺼진다** — 손가락으로 경계선을 끄는 일이
112
+ 없고, 끌 자리가 칸을 누르는 것과 겹친다. 폭을 **기억**하려면 `resizeStorageKey` 를
113
+ 함께 주는 것도 전과 같다.
114
+
115
+ 놀이터 표 **열넷이 전부** 조절 가능해졌다(실측). 옛 계약을 박고 있던 못 하나가 울어서
116
+ 새 계약으로 고쳤다 — *안 적으면 꺼짐* 에서 *안 적으면 켜짐* 으로.
117
+
118
+ ### 열이 넘칠 때 **되돌리기 단추가 열 머리 위에 뜨던 것**
119
+
120
+ 사장님이 말귀 어드민 '회원 관리' 화면으로 짚으셨다 — 초기화 아이콘(`<·>`)이 '권한' 머리와
121
+ 겹쳐 찍히고 마지막 열이 오른쪽에서 잘렸다.
122
+
123
+ `.table` 은 `width: 100%` 라 **그릇 폭에서 멈추는데** 열(grid 트랙)은 그 밖까지 뻗는다
124
+ (재현 실측: 그릇 721px · 열 합 1130px). 그러면 셋이 어긋난다 —
125
+
126
+ · 되돌리기 단추는 `.table-fields-strip`(= 그릇 폭) 오른쪽 끝에 붙으므로, 거기 걸쳐 있는
127
+ **열 머리 위**에 뜬다.
128
+ · 머리·본문에 비워 둔 40px 빈자리가 열에 **덮여** 없어진다.
129
+ · 본문 줄의 구분선·바탕이 그릇 폭에서 끊긴다.
130
+
131
+ 안쪽 상자 `min-width` 를 `열 폭 합 + 빈자리` 로 주면 셋이 한 번에 풀린다. 이미 있는
132
+ `measureOverflow`(통 보개가 부르는 그 함수)에 얹었다 — 보개를 하나 더 세우면 0.237.0 의
133
+ 그 경합을 다시 들인다.
134
+
135
+ **재기 전에 반드시 비운다.** 안 비우면 옛 값이 제 폭을 붙들어 그릇이 넓어져도 영영 안
136
+ 줄어든다. 그 자리를 못으로 박았다.
137
+
138
+ 단추도 `right: 2px` → `0` 으로 옮겼다. 40px 단추가 42px 을 차지해 마지막 머리의 안쪽 여백을
139
+ **2px 물고** 있었다(실측: 단추 1482~1522, 마지막 머리 끝 1484). 눈에는 안 띄지만 비워 둔
140
+ 수와 어긋난다. 빈자리 수(40)는 이제 `--table-reset-gutter` 한 곳에서 나온다 — 전에는
141
+ JS 와 CSS 두 곳에 적혀 있었다.
142
+
143
+ 놀이터에 **어드민 회원 표와 같은 설정**(minmax 일곱 열 · 최소 합 1130px · 좁은 그릇)을
144
+ 세웠다 — 이 꼴이 플레이그라운드에 없어서 여태 안 보였다.
145
+
146
+ ### `Table` 이 `readonly` 배열을 받는다
147
+
148
+ `sortRows` 가 읽기 전용 배열을 주는데 `items` 가 안 받아, 부르는 쪽마다 `[...rows]` 로
149
+ 베껴야 했다. 그 복사는 다시 그릴 때마다 새 배열이라 쓸데없는 다시 그리기를 부른다.
150
+
10
151
  ## 0.367.0 — 툴팁이 **열 때 잰 자리**를 쓴다 (321)① · 0.365.0 의 고침을 바꾼다
11
152
 
12
153
  0.365.0 에서 *"같은 값이 두 프레임 이어지면 안정된 것으로 보고 멈춘다"* 로 고쳤는데,