@ihabdevteam/core 0.366.0 → 0.368.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.
@@ -1770,7 +1770,7 @@ export declare function copyText(text: string): Promise<boolean>;
1770
1770
  *
1771
1771
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
1772
1772
  */
1773
- export declare const CORE_VERSION = "0.366.0";
1773
+ export declare const CORE_VERSION = "0.368.0";
1774
1774
 
1775
1775
  /** @public */
1776
1776
  declare const coreDefault: Record<string, unknown>;
@@ -7789,7 +7789,7 @@ export declare type TabItem = {
7789
7789
  /** @public */
7790
7790
  export declare function Table<T extends {
7791
7791
  id?: string | number;
7792
- }>({ fields, headerGroups, items, renderRow, onRowClick, isRowClickable, onRowMouseEnter, onRowMouseLeave, onRowDragStart, onRowDragEnd, draggingId, gridTemplateColumns, mobileGridTemplateColumns, resizable, resizeMode, resizeStorageKey, size, title, icon, count, collapsed, onToggleCollapse, headerActions, empty, loading, dragOver, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }: TableProps<T>): JSX.Element;
7792
+ }>({ fields: rawFields, sort: sortBinding, sortable, headerGroups, items: rawItems, renderRow, onRowClick, isRowClickable, onRowMouseEnter, onRowMouseLeave, onRowDragStart, onRowDragEnd, draggingId, gridTemplateColumns, mobileGridTemplateColumns, resizable, resizeMode, resizeStorageKey, size, title, icon, count, collapsed, onToggleCollapse, headerActions, empty, loading, dragOver, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }: TableProps<T>): JSX.Element;
7793
7793
 
7794
7794
  /**
7795
7795
  * **다음에 쓸 표를 고른다.**
@@ -7809,7 +7809,6 @@ export declare interface TableCandidate {
7809
7809
  cellLabels: readonly string[];
7810
7810
  }
7811
7811
 
7812
- /** @public */
7813
7812
  export declare type TableFieldDef = {
7814
7813
  label?: ReactNode;
7815
7814
  onClick?: (ev?: unknown) => void;
@@ -7817,6 +7816,45 @@ export declare type TableFieldDef = {
7817
7816
  sortDir?: 'asc' | 'desc' | null;
7818
7817
  /** 테이블 전체가 resizable이어도 이 컬럼만 폭 조절을 끄고 싶을 때(예: 체크박스 컬럼) false로 지정 */
7819
7818
  resizable?: boolean;
7819
+ /**
7820
+ * **이 열의 폭** — 2026-10-26.
7821
+ *
7822
+ * 전에는 폭을 `Table` 의 `gridTemplateColumns` 문자열 하나로만 적었다. 열 정의(`fields`)와
7823
+ * 폭이 **따로 떨어져 있어서**, 열을 하나 넣고 빼면 두 곳을 같이 고쳐야 하고 개수가
7824
+ * 어긋나도 조용히 어긋난 채 그려졌다. 여기 적으면 한 곳에서 관리된다.
7825
+ *
7826
+ * 숫자는 `px` 로 읽는다(`120` → `120px`). 문자열은 그대로 쓴다(`'minmax(80px, 1fr)'`).
7827
+ *
7828
+ * **모든 열에 적어야 쓰인다** — 하나라도 빠지면 그 표는 `gridTemplateColumns` 를 쓴다
7829
+ * (반만 적힌 폭으로 격자를 지으면 나머지가 어떤 폭일지 아무도 모른다). 개발 모드에서
7830
+ * 알려 준다. `gridTemplateColumns` 를 함께 주면 **그쪽이 이긴다**(예전 코드가 안 깨지게).
7831
+ */
7832
+ width?: string | number;
7833
+ /**
7834
+ * **이 열의 글 맞춤** — 머리 칸과 본문 칸에 함께 걸린다. 안 주면 왼쪽이다.
7835
+ *
7836
+ * 전에는 숫자 열을 오른쪽으로 보내려면 소비처가 `className` 으로 CSS 를 각자 붙여야 했다.
7837
+ */
7838
+ align?: 'left' | 'center' | 'right';
7839
+ /**
7840
+ * **이 열로 정렬한다** — `Table` 의 `sort` 와 짝이다(2026-10-26).
7841
+ *
7842
+ * 전에는 열마다 `useTableSort` 의 `field('이름','name')` 을 불러 `sortDir`·`onClick` 을
7843
+ * 손으로 엮어야 했다. 여기 열쇠만 적고 `Table` 에 `sort` 를 넘기면 `Table` 이 엮는다.
7844
+ *
7845
+ * `sortDir` 를 직접 준 열은 그쪽이 이긴다 — 정렬을 제 손으로 쥐는 표가 안 깨진다.
7846
+ */
7847
+ sortKey?: string;
7848
+ /**
7849
+ * 이 열을 눌러 정렬할 수 있나. **기본은 켜짐**이다(2026-10-26).
7850
+ *
7851
+ * 값을 어디서 읽을지는 `sortValue` → `sortKey` → **칸에 그려진 값** 차례로 찾는다.
7852
+ * 셋 다 없으면(칸이 배지·단추 같은 마디라 글자가 아니면) 그 열은 조용히 빠진다 —
7853
+ * 정렬할 수 없는 것에 화살표를 띄우면 눌러도 아무 일이 없다.
7854
+ */
7855
+ sortable?: boolean;
7856
+ /** 이 열의 정렬 값을 직접 꺼낸다 — `sortKey` 로 못 집는 자리(합계·가공값)에 쓴다 */
7857
+ sortValue?: (item: never) => unknown;
7820
7858
  };
7821
7859
 
7822
7860
  /**
@@ -7912,13 +7950,37 @@ export declare type TableProps<T extends {
7912
7950
  id?: string | number;
7913
7951
  }> = {
7914
7952
  fields?: TableFieldDef[];
7953
+ /**
7954
+ * **정렬을 `Table` 이 엮는다**(2026-10-26) — `useTableSort()` 가 돌려준 것을 그대로 넘긴다.
7955
+ *
7956
+ * `fields[].sortKey` 가 있는 열에 화살표와 누르기가 붙는다. 데이터를 세우는 것은
7957
+ * 여전히 부르는 쪽이다(`sortRows`) — 서버가 세워 주는 표도 있기 때문이다.
7958
+ *
7959
+ * ```tsx
7960
+ * const { sort, field, sortRows } = useTableSort<'name' | 'joined'>()
7961
+ * const rows = useMemo(() => sortRows(items, (r, k) => r[k]), [items, sortRows])
7962
+ * <Table sort={{ sort, field }} fields={[{ label: '이름', sortKey: 'name' }]} items={rows} … />
7963
+ * ```
7964
+ */
7965
+ sort?: TableSortBinding;
7966
+ /**
7967
+ * 머리를 눌러 정렬. **기본이 켜짐**이다(사장님 지시 2026-10-26).
7968
+ *
7969
+ * 아무것도 안 넘겨도 코어가 **제 안에서** 차례를 쥐고 줄을 세운다 — 값은 열의
7970
+ * `sortValue` → `sortKey` → **칸에 그려진 값** 차례로 찾는다. 글자·수가 아닌 칸만
7971
+ * 있는 열은 빠진다.
7972
+ *
7973
+ * 차례를 **밖에서 쥐려면** `sort`(= `useTableSort()` 가 주는 것)를 넘긴다. 서버가
7974
+ * 세워 주는 표나 쪽넘김과 엮인 표가 그 자리다 — 그때는 코어가 줄을 안 세운다.
7975
+ */
7976
+ sortable?: boolean;
7915
7977
  /**
7916
7978
  * 필드 위에 얹는 그룹 헤더 행. 각 그룹이 span 개의 하위 컬럼을 덮는다
7917
7979
  * (예: L·R 두 컬럼 위에 "AFG(8dB)"). 지정하면 필드 행 위에 한 줄이 더 생기며,
7918
7980
  * span 합계가 fields 개수와 같아야 열이 맞는다.
7919
7981
  */
7920
7982
  headerGroups?: TableHeaderGroup[];
7921
- items?: T[];
7983
+ items?: readonly T[];
7922
7984
  /**
7923
7985
  * 줄 하나를 칸 배열로 그린다.
7924
7986
  *
@@ -7966,7 +8028,18 @@ export declare type TableProps<T extends {
7966
8028
  * 숨길 칸은 `renderRow` 의 `className`·`fields[].className` 으로 앱이 가린다.
7967
8029
  */
7968
8030
  mobileGridTemplateColumns?: string;
7969
- /** true면 헤더 경계선을 드래그해 컬럼 폭 조절 가능 */
8031
+ /**
8032
+ * 헤더 경계선을 드래그해 컬럼 폭 조절. **기본이 켜짐**이다(사장님 지시 2026-10-26).
8033
+ *
8034
+ * 전에는 꺼짐이 기본이라, 폭을 조절하고 싶은 표마다 `resizable` 을 적어야 했다. 표는
8035
+ * 열 폭이 화면마다 아쉬운 물건이라 **켜 두는 쪽이 맞는 기본값**이다. 끌 표에만 `false` 를 적는다.
8036
+ *
8037
+ * 좁은 화면(767px 이하)에서는 이 값과 무관하게 **늘 꺼진다** — 손가락으로 경계선을
8038
+ * 끄는 일이 없고, 끌 자리가 칸을 누르는 것과 겹친다.
8039
+ *
8040
+ * 폭을 **기억**하려면 `resizeStorageKey` 를 함께 준다. 안 주면 그 자리에서만 조절되고
8041
+ * 다시 열면 처음 폭이다.
8042
+ */
7970
8043
  resizable?: boolean;
7971
8044
  /**
7972
8045
  * 폭 조절 방식. 기본 'grow'.
@@ -8027,6 +8100,23 @@ declare interface TableSettingsSetters {
8027
8100
  setShowBottomInfo?: (v: boolean) => void;
8028
8101
  }
8029
8102
 
8103
+ /** @public */
8104
+ /**
8105
+ * `useTableSort()` 가 돌려주는 것 중 `Table` 이 쓰는 부분.
8106
+ * @public
8107
+ */
8108
+ export declare type TableSortBinding = {
8109
+ sort: {
8110
+ key: string;
8111
+ asc: boolean;
8112
+ } | null;
8113
+ field: (label: string, key: never) => {
8114
+ label: string;
8115
+ sortDir: 'asc' | 'desc' | null;
8116
+ onClick: () => void;
8117
+ };
8118
+ };
8119
+
8030
8120
  /** `useTableSort` 의 선택 인자. @public */
8031
8121
  export declare interface TableSortOptions<K extends string> {
8032
8122
  /** 머리를 눌러 정렬이 바뀔 때 바뀐 정렬로 불린다 — 쪽을 따로 들고 있는 표가 첫 쪽으로 돌아가는 자리 등. */
@@ -8034,6 +8124,18 @@ export declare interface TableSortOptions<K extends string> {
8034
8124
  key: K;
8035
8125
  asc: boolean;
8036
8126
  }) => void;
8127
+ /**
8128
+ * **처음부터 이 열로 정렬해 둔다**(사장님 지시 2026-10-26).
8129
+ *
8130
+ * 안 주면 전과 같다 — 표가 뜰 때는 정렬이 꺼져 있고(`sort` 가 `null`), 머리를 눌러야
8131
+ * 켜진다. 그 꼴이 맞는 표도 있다(받은 차례가 곧 뜻인 표: 최근 순으로 서버가 보낸 목록).
8132
+ *
8133
+ * 열쇠를 적으면 그 열로 **오름차순**부터 시작한다(`defaultAsc` 로 뒤집는다). 머리에
8134
+ * 화살표도 처음부터 선다 — 지금 무엇으로 서 있는지가 화면에 보여야 하기 때문이다.
8135
+ */
8136
+ defaultKey?: K;
8137
+ /** `defaultKey` 를 줬을 때의 첫 방향. 기본은 오름차순이다. */
8138
+ defaultAsc?: boolean;
8037
8139
  }
8038
8140
 
8039
8141
  /** 표 한 개에 대한 흐름 — 같은 표를 여러 번 돌렸을 때 나아지고 있는가. */
@@ -90,11 +90,14 @@
90
90
  `min-width: 0` 을 얹어도 안 풀렸다). 담은 상자에 주면 둘 다 같은 만큼
91
91
  좁아져 정렬이 지켜진다. */
92
92
  .table-wrap--resizable .table-fields,
93
- .table-wrap--resizable .table-row { padding-right: 40px; }
93
+ .table-wrap--resizable .table-row { padding-right: var(--table-reset-gutter, 40px); }
94
94
 
95
95
  .table-fields__reset {
96
96
  position: absolute;
97
- right: 2px;
97
+ /* **빈자리(40px)에 딱 맞춘다** — `right: 2px` 이던 때는 40px 단추가 42px 을 차지해 마지막
98
+ 머리의 안쪽 여백을 2px 물고 있었다(2026-10-26 실측: 단추 1482~1522, 마지막 머리 끝 1484).
99
+ 눈에는 안 띄는 겹침이지만 머리·본문에 비운 자리와 수가 어긋난다. */
100
+ right: 0;
98
101
  top: 50%;
99
102
  transform: translateY(-50%);
100
103
  }
@@ -2,7 +2,6 @@ import './Table.css';
2
2
  import './TableCell.css';
3
3
  import './TableField.css';
4
4
  import type { ReactNode, CSSProperties, MouseEvent, DragEvent } from 'react';
5
- /** @public */
6
5
  export type TableFieldDef = {
7
6
  label?: ReactNode;
8
7
  onClick?: (ev?: unknown) => void;
@@ -10,6 +9,45 @@ export type TableFieldDef = {
10
9
  sortDir?: 'asc' | 'desc' | null;
11
10
  /** 테이블 전체가 resizable이어도 이 컬럼만 폭 조절을 끄고 싶을 때(예: 체크박스 컬럼) false로 지정 */
12
11
  resizable?: boolean;
12
+ /**
13
+ * **이 열의 폭** — 2026-10-26.
14
+ *
15
+ * 전에는 폭을 `Table` 의 `gridTemplateColumns` 문자열 하나로만 적었다. 열 정의(`fields`)와
16
+ * 폭이 **따로 떨어져 있어서**, 열을 하나 넣고 빼면 두 곳을 같이 고쳐야 하고 개수가
17
+ * 어긋나도 조용히 어긋난 채 그려졌다. 여기 적으면 한 곳에서 관리된다.
18
+ *
19
+ * 숫자는 `px` 로 읽는다(`120` → `120px`). 문자열은 그대로 쓴다(`'minmax(80px, 1fr)'`).
20
+ *
21
+ * **모든 열에 적어야 쓰인다** — 하나라도 빠지면 그 표는 `gridTemplateColumns` 를 쓴다
22
+ * (반만 적힌 폭으로 격자를 지으면 나머지가 어떤 폭일지 아무도 모른다). 개발 모드에서
23
+ * 알려 준다. `gridTemplateColumns` 를 함께 주면 **그쪽이 이긴다**(예전 코드가 안 깨지게).
24
+ */
25
+ width?: string | number;
26
+ /**
27
+ * **이 열의 글 맞춤** — 머리 칸과 본문 칸에 함께 걸린다. 안 주면 왼쪽이다.
28
+ *
29
+ * 전에는 숫자 열을 오른쪽으로 보내려면 소비처가 `className` 으로 CSS 를 각자 붙여야 했다.
30
+ */
31
+ align?: 'left' | 'center' | 'right';
32
+ /**
33
+ * **이 열로 정렬한다** — `Table` 의 `sort` 와 짝이다(2026-10-26).
34
+ *
35
+ * 전에는 열마다 `useTableSort` 의 `field('이름','name')` 을 불러 `sortDir`·`onClick` 을
36
+ * 손으로 엮어야 했다. 여기 열쇠만 적고 `Table` 에 `sort` 를 넘기면 `Table` 이 엮는다.
37
+ *
38
+ * `sortDir` 를 직접 준 열은 그쪽이 이긴다 — 정렬을 제 손으로 쥐는 표가 안 깨진다.
39
+ */
40
+ sortKey?: string;
41
+ /**
42
+ * 이 열을 눌러 정렬할 수 있나. **기본은 켜짐**이다(2026-10-26).
43
+ *
44
+ * 값을 어디서 읽을지는 `sortValue` → `sortKey` → **칸에 그려진 값** 차례로 찾는다.
45
+ * 셋 다 없으면(칸이 배지·단추 같은 마디라 글자가 아니면) 그 열은 조용히 빠진다 —
46
+ * 정렬할 수 없는 것에 화살표를 띄우면 눌러도 아무 일이 없다.
47
+ */
48
+ sortable?: boolean;
49
+ /** 이 열의 정렬 값을 직접 꺼낸다 — `sortKey` 로 못 집는 자리(합계·가공값)에 쓴다 */
50
+ sortValue?: (item: never) => unknown;
13
51
  };
14
52
  /**
15
53
  * 필드(하위 컬럼) 위에 얹는 그룹 헤더 한 칸.
@@ -23,17 +61,57 @@ export type TableHeaderGroup = {
23
61
  className?: string;
24
62
  };
25
63
  /** @public */
64
+ /**
65
+ * `useTableSort()` 가 돌려주는 것 중 `Table` 이 쓰는 부분.
66
+ * @public
67
+ */
68
+ export type TableSortBinding = {
69
+ sort: {
70
+ key: string;
71
+ asc: boolean;
72
+ } | null;
73
+ field: (label: string, key: never) => {
74
+ label: string;
75
+ sortDir: 'asc' | 'desc' | null;
76
+ onClick: () => void;
77
+ };
78
+ };
79
+ /** @public */
26
80
  export type TableProps<T extends {
27
81
  id?: string | number;
28
82
  }> = {
29
83
  fields?: TableFieldDef[];
84
+ /**
85
+ * **정렬을 `Table` 이 엮는다**(2026-10-26) — `useTableSort()` 가 돌려준 것을 그대로 넘긴다.
86
+ *
87
+ * `fields[].sortKey` 가 있는 열에 화살표와 누르기가 붙는다. 데이터를 세우는 것은
88
+ * 여전히 부르는 쪽이다(`sortRows`) — 서버가 세워 주는 표도 있기 때문이다.
89
+ *
90
+ * ```tsx
91
+ * const { sort, field, sortRows } = useTableSort<'name' | 'joined'>()
92
+ * const rows = useMemo(() => sortRows(items, (r, k) => r[k]), [items, sortRows])
93
+ * <Table sort={{ sort, field }} fields={[{ label: '이름', sortKey: 'name' }]} items={rows} … />
94
+ * ```
95
+ */
96
+ sort?: TableSortBinding;
97
+ /**
98
+ * 머리를 눌러 정렬. **기본이 켜짐**이다(사장님 지시 2026-10-26).
99
+ *
100
+ * 아무것도 안 넘겨도 코어가 **제 안에서** 차례를 쥐고 줄을 세운다 — 값은 열의
101
+ * `sortValue` → `sortKey` → **칸에 그려진 값** 차례로 찾는다. 글자·수가 아닌 칸만
102
+ * 있는 열은 빠진다.
103
+ *
104
+ * 차례를 **밖에서 쥐려면** `sort`(= `useTableSort()` 가 주는 것)를 넘긴다. 서버가
105
+ * 세워 주는 표나 쪽넘김과 엮인 표가 그 자리다 — 그때는 코어가 줄을 안 세운다.
106
+ */
107
+ sortable?: boolean;
30
108
  /**
31
109
  * 필드 위에 얹는 그룹 헤더 행. 각 그룹이 span 개의 하위 컬럼을 덮는다
32
110
  * (예: L·R 두 컬럼 위에 "AFG(8dB)"). 지정하면 필드 행 위에 한 줄이 더 생기며,
33
111
  * span 합계가 fields 개수와 같아야 열이 맞는다.
34
112
  */
35
113
  headerGroups?: TableHeaderGroup[];
36
- items?: T[];
114
+ items?: readonly T[];
37
115
  /**
38
116
  * 줄 하나를 칸 배열로 그린다.
39
117
  *
@@ -81,7 +159,18 @@ export type TableProps<T extends {
81
159
  * 숨길 칸은 `renderRow` 의 `className`·`fields[].className` 으로 앱이 가린다.
82
160
  */
83
161
  mobileGridTemplateColumns?: string;
84
- /** true면 헤더 경계선을 드래그해 컬럼 폭 조절 가능 */
162
+ /**
163
+ * 헤더 경계선을 드래그해 컬럼 폭 조절. **기본이 켜짐**이다(사장님 지시 2026-10-26).
164
+ *
165
+ * 전에는 꺼짐이 기본이라, 폭을 조절하고 싶은 표마다 `resizable` 을 적어야 했다. 표는
166
+ * 열 폭이 화면마다 아쉬운 물건이라 **켜 두는 쪽이 맞는 기본값**이다. 끌 표에만 `false` 를 적는다.
167
+ *
168
+ * 좁은 화면(767px 이하)에서는 이 값과 무관하게 **늘 꺼진다** — 손가락으로 경계선을
169
+ * 끄는 일이 없고, 끌 자리가 칸을 누르는 것과 겹친다.
170
+ *
171
+ * 폭을 **기억**하려면 `resizeStorageKey` 를 함께 준다. 안 주면 그 자리에서만 조절되고
172
+ * 다시 열면 처음 폭이다.
173
+ */
85
174
  resizable?: boolean;
86
175
  /**
87
176
  * 폭 조절 방식. 기본 'grow'.
@@ -133,4 +222,4 @@ export type TableProps<T extends {
133
222
  /** @public */
134
223
  export default function Table<T extends {
135
224
  id?: string | number;
136
- }>({ fields, headerGroups, items, renderRow, onRowClick, isRowClickable, onRowMouseEnter, onRowMouseLeave, onRowDragStart, onRowDragEnd, draggingId, gridTemplateColumns, mobileGridTemplateColumns, resizable, resizeMode, resizeStorageKey, size, title, icon, count, collapsed, onToggleCollapse, headerActions, empty, loading, dragOver, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }: TableProps<T>): import("react").JSX.Element;
225
+ }>({ fields: rawFields, sort: sortBinding, sortable, headerGroups, items: rawItems, renderRow, onRowClick, isRowClickable, onRowMouseEnter, onRowMouseLeave, onRowDragStart, onRowDragEnd, draggingId, gridTemplateColumns, mobileGridTemplateColumns, resizable, resizeMode, resizeStorageKey, size, title, icon, count, collapsed, onToggleCollapse, headerActions, empty, loading, dragOver, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }: TableProps<T>): import("react").JSX.Element;
@@ -8,11 +8,12 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
8
8
  import { cx } from '../utils/cx';
9
9
  import { splitTrackList } from './tableTrackList';
10
10
  import { devWarnOnce } from '../utils/devWarn';
11
+ import { compareCellBlankLast } from '../utils/textSort';
11
12
  import { useTranslation } from 'react-i18next';
12
13
  import './Table.css';
13
14
  import './TableCell.css';
14
15
  import './TableField.css';
15
- import { useState, useRef, useCallback, useEffect, useId } from 'react';
16
+ import { useState, useRef, useCallback, useEffect, useId, useMemo } from 'react';
16
17
  import ChevronUp from 'lucide-react/dist/esm/icons/chevron-up.mjs';
17
18
  import ChevronDown from 'lucide-react/dist/esm/icons/chevron-down.mjs';
18
19
  import Button from './Button';
@@ -109,7 +110,12 @@ function TableField({ children, onClick, className, sortDir, ariaSort, onResizeS
109
110
  : inner, onResizeStart && (_jsx("span", { className: "table-field__resizer", onPointerDown: onResizeStart, onClick: e => e.stopPropagation(), "aria-hidden": "true" }))] }));
110
111
  }
111
112
  /** @public */
112
- export default function Table({ fields = [], headerGroups, items = [], renderRow, onRowClick, isRowClickable, onRowMouseEnter, onRowMouseLeave, onRowDragStart, onRowDragEnd, draggingId, gridTemplateColumns, mobileGridTemplateColumns, resizable = false, resizeMode = 'grow', resizeStorageKey, size = 'small', title, icon, count, collapsed = false, onToggleCollapse, headerActions, empty, loading, dragOver = false, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }) {
113
+ /** 열 맞춤 → 반 이름. 왼쪽은 기본이라 반을 안 붙인다 */
114
+ function alignClass(align) {
115
+ return align && align !== 'left' ? `table-col--${align}` : undefined;
116
+ }
117
+ /** @public */
118
+ export default function Table({ fields: rawFields = [], sort: sortBinding, sortable = true, headerGroups, items: rawItems = [], renderRow, onRowClick, isRowClickable, onRowMouseEnter, onRowMouseLeave, onRowDragStart, onRowDragEnd, draggingId, gridTemplateColumns, mobileGridTemplateColumns, resizable = true, resizeMode = 'grow', resizeStorageKey, size = 'small', title, icon, count, collapsed = false, onToggleCollapse, headerActions, empty, loading, dragOver = false, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }) {
113
119
  const { t } = useTranslation();
114
120
  const uid = useId();
115
121
  const titleId = `table-title-${uid}`;
@@ -136,12 +142,86 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
136
142
  * 옆으로 미는 쪽을 골랐다. 그러니 담을 수 없을 만큼 좁을 때 칸을 눌러 담으려 드는 코드를
137
143
  * 다시 넣지 말 것 — 그게 위에 적은 48px 사건이었다.
138
144
  */
145
+ /* **정렬** — 밖에서 쥐면 그대로 쓰고, 아니면 코어가 제 안에서 쥔다(2026-10-26).
146
+
147
+ `sortBinding`(= `useTableSort()`)을 넘기면 전과 같다: 코어는 화살표만 그리고 줄은
148
+ 부르는 쪽이 세운다(서버가 세워 주는 표·쪽넘김과 엮인 표가 그 자리다).
149
+
150
+ 아무것도 안 넘기면 **기본으로 켜져** 코어가 차례를 쥐고 줄까지 세운다. 값은
151
+ `sortValue` → `sortKey` → **칸에 그려진 값** 차례로 찾는다 — 셋 다 없으면 그 열은
152
+ 조용히 빠진다(정렬 못 하는 것에 화살표를 띄우면 눌러도 아무 일이 없다). */
153
+ const [innerSort, setInnerSort] = useState(null);
154
+ /** 그 열의 정렬 값을 꺼낸다. 못 꺼내면 `undefined` — 그 열은 정렬에서 빠진다 */
155
+ const sortValueOf = useCallback((item, i) => {
156
+ const f = rawFields[i];
157
+ if (!f)
158
+ return undefined;
159
+ if (f.sortValue)
160
+ return f.sortValue(item);
161
+ if (f.sortKey)
162
+ return item[f.sortKey];
163
+ /* 칸에 그려진 값 — 글자·수일 때만 쓴다. 배지·단추 같은 마디는 견줄 수가 없다 */
164
+ const cell = renderRow(item)[i]?.content;
165
+ return typeof cell === 'string' || typeof cell === 'number' ? cell : undefined;
166
+ }, [rawFields, renderRow]);
167
+ /**
168
+ * **이 표의 정렬을 코어가 쥐어도 되나.**
169
+ *
170
+ * 한 열이라도 `sortDir`·`onClick` 을 직접 받았으면 **부르는 쪽이 이미 쥐고 있는 표**다.
171
+ * 거기에 코어가 나머지 열을 맡으면 **한 표에 두 방식이 섞여** — 어떤 열은 부르는 쪽이
172
+ * 세우고 어떤 열은 코어가 세운다. 눌러 보기 전에는 어느 쪽인지도 모른다. 통째로 뺀다.
173
+ */
174
+ const coreOwnsSort = !sortBinding && sortable
175
+ && !rawFields.some(f => f.sortDir !== undefined || f.onClick);
176
+ /** 코어가 쥘 때, 그 열을 누를 수 있나 — 첫 줄에서 값이 나오면 된다 */
177
+ const canSortCol = useCallback((i) => {
178
+ const f = rawFields[i];
179
+ if (!f || f.sortable === false)
180
+ return false;
181
+ if (f.sortValue || f.sortKey)
182
+ return true;
183
+ const first = rawItems[0];
184
+ return first !== undefined && sortValueOf(first, i) !== undefined;
185
+ }, [rawFields, rawItems, sortValueOf]);
186
+ const fields = useMemo(() => {
187
+ if (sortBinding) {
188
+ return rawFields.map(f => {
189
+ if (!f.sortKey || f.sortDir !== undefined)
190
+ return f;
191
+ const head = sortBinding.field(String(f.label ?? ''), f.sortKey);
192
+ return { ...f, sortDir: head.sortDir, onClick: f.onClick ?? head.onClick };
193
+ });
194
+ }
195
+ if (!coreOwnsSort)
196
+ return rawFields;
197
+ return rawFields.map((f, i) => {
198
+ if (!canSortCol(i))
199
+ return f;
200
+ return {
201
+ ...f,
202
+ sortDir: innerSort?.index === i ? (innerSort.asc ? 'asc' : 'desc') : null,
203
+ onClick: () => setInnerSort(prev => (prev?.index === i ? { index: i, asc: !prev.asc } : { index: i, asc: true })),
204
+ };
205
+ });
206
+ }, [rawFields, sortBinding, coreOwnsSort, innerSort, canSortCol]);
207
+ /* 코어가 쥘 때만 줄을 세운다 — 밖에서 쥐는 표는 이미 세워서 넘어온다 */
208
+ const items = useMemo(() => {
209
+ if (!coreOwnsSort || !innerSort)
210
+ return rawItems;
211
+ const { index, asc } = innerSort;
212
+ return [...rawItems].sort((a, b) => compareCellBlankLast(sortValueOf(a, index), sortValueOf(b, index), asc));
213
+ }, [rawItems, coreOwnsSort, innerSort, sortValueOf]);
139
214
  const isNarrow = useMediaQuery('(max-width: 767px)');
140
215
  const narrowTemplate = mobileGridTemplateColumns && isNarrow ? mobileGridTemplateColumns : null;
141
216
  const canResize = resizable && !isNarrow;
217
+ /* `measureOverflow` 는 의존성 없이 만들어 두었다(보개 경합 때문 — 위 주석). 그래서 ref 로 읽는다 */
218
+ const canResizeRef = useRef(canResize);
219
+ canResizeRef.current = canResize;
142
220
  // ── 컬럼 폭 드래그 리사이즈 (resizable) ──
143
221
  /** 만든 사람이 밑값을 안 적은 칸에 쓰는 바닥 — 이보다 좁으면 손잡이를 다시 잡을 수도 없다 */
144
222
  const MIN_COL_W = 48;
223
+ /** 되돌리기 단추가 설 빈자리(px). CSS 의 `padding-right` 도 이 수를 변수로 받는다 — 두 곳에 적지 않는다 */
224
+ const RESET_GUTTER = 40;
145
225
  /**
146
226
  * **그 칸의 가장 좁은 폭** — `minmax(130px, 0.9fr)` 의 130, 못 박은 `150px` 의 150.
147
227
  *
@@ -176,6 +256,29 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
176
256
  const el = scrollOuterRef.current;
177
257
  if (!el)
178
258
  return;
259
+ /* **열이 넘치면 안쪽 상자를 열 폭만큼 넓힌다**(2026-10-26, 말귀 어드민 회원 표).
260
+
261
+ `.table` 은 `width: 100%` 라 그릇 폭에서 멈추고, 열(grid 트랙)들은 그 밖까지 뻗는다
262
+ (실측: 그릇 721px · 열 합 1130px). 그러면 세 가지가 어긋난다 —
263
+ · 되돌리기 단추는 `.table-fields-strip`(= 721px) 오른쪽 끝에 붙어 **어느 열 머리 위**에 뜬다
264
+ (어드민에선 '권한' 머리 위에 `<·>` 로 찍혔다).
265
+ · 머리·본문의 `padding-right`(빈자리)는 721px 안에 있어 열에 **덮인다** — 빈자리가 없어진다.
266
+ · 본문 줄의 구분선·바탕이 721px 에서 끊긴다.
267
+
268
+ 안쪽 상자 `min-width` 를 `열 폭 합 + 빈자리` 로 주면 셋이 한 번에 풀린다 — 머리·본문이
269
+ 그 폭이 되고, 빈자리가 줄 끝에 생기고, 단추가 거기 선다. 넘치지 않을 때는 아무것도 안 한다.
270
+
271
+ **재기 전에 반드시 비운다.** 안 비우면 옛 값이 제 폭을 붙들어 그릇이 좁아져도 영영 안
272
+ 줄어든다(min-width 1170 → 그릇 650 이어도 1170 그대로). 비우고 재면 같은 값이 다시
273
+ 나오므로 React·ResizeObserver 가 도는 일은 없다. */
274
+ const inner = scrollInnerRef.current;
275
+ const fieldsEl = fieldsRef.current;
276
+ if (inner && fieldsEl) {
277
+ inner.style.minWidth = '';
278
+ const tracks = fieldsEl.scrollWidth;
279
+ const gutter = canResizeRef.current ? RESET_GUTTER : 0;
280
+ inner.style.minWidth = tracks > el.clientWidth + 1 ? `${tracks + gutter}px` : '';
281
+ }
179
282
  setOverflowing(el.scrollWidth > el.clientWidth + 1); // 1px 은 반올림 몫
180
283
  /* **통 폭도 여기서 적어 둔다.** 자동맞춤은 통이 넓어지면 따라가야 하는데, 통을 보는
181
284
  보개(`ResizeObserver`)가 이미 이 함수를 부른다 — 보개를 하나 더 세우거나 `observe`
@@ -309,16 +412,31 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
309
412
  return;
310
413
  {
311
414
  const copy = [...prev];
415
+ /* **끄는 동안의 바닥은 `MIN_COL_W` 다 — 적어 둔 `minmax()` 최소값이 아니다**
416
+ (사장님이 짚으셨다, 2026-10-26: *"조절 핸들을 왼쪽으로 당길 때 안 간다"*).
417
+
418
+ 전에는 `minmax(260px, 2fr)` 의 **260** 이 끌 때도 바닥이었다. 어드민 회원 표가
419
+ 그 꼴이라 왼쪽으로 아무리 당겨도 꿈쩍도 안 했다(실측: 260 → 끌어도 260,
420
+ 150 → 끌어도 150). 오른쪽으로는 늘어나니 **"왼쪽만 고장난 것처럼"** 보였다.
421
+
422
+ 적어 둔 최소값은 **자동 배치를 지키는 수**다 — 자리가 모자랄 때 칸이 글자 밑으로
423
+ 찌그러지지 말라고 만든 사람이 정해 둔 것이다. 그런데 **사람이 손으로 당기는 것**은
424
+ "나는 이만큼으로 보고 싶다" 는 뜻이라 그 보호가 오히려 길을 막는다. 끌 때의 바닥은
425
+ *칸이 사라지지 않을 만큼*(`MIN_COL_W`) 하나면 된다.
426
+
427
+ 되돌리기·자동맞춤은 그대로 적어 둔 최소값을 쓴다(`measureAndFit`) — 거기서는 사람이
428
+ 아니라 코어가 정하는 자리라 만든 사람의 수가 맞다. */
429
+ const dragFloor = () => MIN_COL_W;
312
430
  if (d.next != null && d.startWNext != null) {
313
431
  // fit — 이동량을 두 컬럼이 나눠 갖는다. 둘 다 최소폭 밑으로 내려가지 않도록
314
432
  // 이동량 자체를 먼저 자른다(한쪽만 자르면 합이 달라져 표 폭이 흔들린다).
315
433
  const raw = e.clientX - d.startX;
316
- const delta = Math.max(minWidthRef.current(d.index) - d.startW, Math.min(d.startWNext - minWidthRef.current(d.next), raw));
434
+ const delta = Math.max(dragFloor() - d.startW, Math.min(d.startWNext - dragFloor(), raw));
317
435
  copy[d.index] = d.startW + delta;
318
436
  copy[d.next] = d.startWNext - delta;
319
437
  }
320
438
  else {
321
- copy[d.index] = Math.max(minWidthRef.current(d.index), d.startW + (e.clientX - d.startX));
439
+ copy[d.index] = Math.max(dragFloor(), d.startW + (e.clientX - d.startX));
322
440
  }
323
441
  colWidthsRef.current = copy;
324
442
  setColWidths(copy);
@@ -579,7 +697,24 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
579
697
  // resizable:false인 컬럼(예: 체크박스)은 다른 컬럼 드래그 시 같이 측정·저장되어도 항상 기본 폭을 사용.
580
698
  // 항목이 0개일 때(로딩/빈 상태)는 저장된 절대 px 폭 합이 현재 컨테이너 폭보다 커서
581
699
  // 불필요한 가로 스크롤이 생길 수 있어, 이때는 기본(fr 단위) grid로 되돌린다.
582
- const defaultCols = splitTrackList(gridTemplateColumns);
700
+ /* **열 폭을 `fields` 에서 읽는다**(2026-10-26) — `gridTemplateColumns` 를 따로 적던 자리.
701
+ 모든 열에 적혔을 때만 쓴다: 반만 적힌 폭으로 격자를 지으면 나머지가 어떤 폭일지 아무도
702
+ 모른다. `gridTemplateColumns` 를 함께 주면 그쪽이 이긴다(예전 코드가 안 깨지게). */
703
+ const fieldWidths = fields.length > 0 && fields.every(f => f.width != null)
704
+ ? fields.map(f => (typeof f.width === 'number' ? `${f.width}px` : String(f.width))).join(' ')
705
+ : null;
706
+ const someWidths = fields.some(f => f.width != null);
707
+ if (someWidths && !fieldWidths) {
708
+ devWarnOnce(`table-field-width:${fields.map(f => (f.width == null ? '-' : 'w')).join('')}`, '[ihabdevteam-core] Table 의 fields 중 일부에만 width 가 있습니다. ' +
709
+ '**모든 열에 적어야** 쓰입니다 — 지금은 gridTemplateColumns 를 씁니다. ' +
710
+ '한 열만 고정하고 싶으면 나머지에 `minmax(0, 1fr)` 처럼 적어 주세요.');
711
+ }
712
+ if (fieldWidths && gridTemplateColumns) {
713
+ devWarnOnce('table-field-width-conflict', '[ihabdevteam-core] Table 에 fields[].width 와 gridTemplateColumns 가 둘 다 있습니다. ' +
714
+ 'gridTemplateColumns 가 이깁니다 — 한쪽만 두세요.');
715
+ }
716
+ const resolvedGridCols = gridTemplateColumns ?? fieldWidths ?? undefined;
717
+ const defaultCols = splitTrackList(resolvedGridCols);
583
718
  // fit 모드는 폭을 px가 아니라 비율(fr)로 내보낸다 — 측정값을 그대로 가중치로 쓰면 지금과 같은
584
719
  // 비율이 되고, 컨테이너가 좁아져도 합이 늘 컨테이너 폭이라 가로 스크롤이 생기지 않는다.
585
720
  // 그래서 grow 모드에 있던 'items가 0개면 기본 grid로 되돌린다'는 방어도 필요 없다
@@ -665,7 +800,7 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
665
800
  && !isNarrow;
666
801
  const effectiveGrid = narrowTemplate ?? (canApplyWidths
667
802
  ? fields.map((f, i) => (f.resizable === false && defaultCols[i]) ? defaultCols[i] : `${colWidths[i]}${widthUnit(i)}`).join(' ')
668
- : gridTemplateColumns);
803
+ : resolvedGridCols);
669
804
  const gridStyle = effectiveGrid
670
805
  ? { '--table-grid-cols': effectiveGrid }
671
806
  : undefined;
@@ -703,7 +838,7 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
703
838
  */
704
839
  role: "caption", children: [onToggleCollapse && (_jsx(Button, { htmlType: "button", size: 40, type: "dot", variant: "transparent-gray", useBorder: false, icon: collapsed ? 'chevron-right' : 'chevron-down', ariaLabel: collapsed ? t('common.expand', '펼치기') : t('common.collapse', '접기'),
705
840
  /* 여닫힘은 **여는 것**이 말한다 — 전에는 겉의 `div` 에 달려 있었다(위 머리글) */
706
- ariaExpanded: !collapsed, className: "table-header__chevron" })), icon && (_jsx(Icon, { icon: icon, label: typeof title === 'string' ? title : undefined, className: "table-header__icon" })), _jsx("span", { id: titleId, className: "table-header__title h5b", children: title }), count !== undefined && _jsx("span", { className: "table-header__count body-3b", children: count }), headerActions && (_jsx("span", { className: "table-header__actions", onClick: e => e.stopPropagation(), children: headerActions }))] })), !collapsed && (_jsxs(_Fragment, { children: [headerGroups && headerGroups.length > 0 && (_jsx("div", { role: "row", className: "table-fields table-fields--groups", children: headerGroups.map((g, i) => (_jsx("div", { role: "columnheader", "aria-colspan": g.span, className: cx('table-field body-3', g.className), style: { gridColumn: `span ${g.span}` }, children: g.label }, i))) })), _jsxs("div", { role: "presentation", className: cx('table-fields-strip', canResize && 'table-fields-strip--resizable'), children: [_jsx("div", { role: "row", className: "table-fields", ref: fieldsRef, children: fields.map((f, i) => (_jsx(TableField, { onClick: f.onClick, className: f.className, sortDir: f.sortDir, ariaSort: ariaSortOf(i),
841
+ ariaExpanded: !collapsed, className: "table-header__chevron" })), icon && (_jsx(Icon, { icon: icon, label: typeof title === 'string' ? title : undefined, className: "table-header__icon" })), _jsx("span", { id: titleId, className: "table-header__title h5b", children: title }), count !== undefined && _jsx("span", { className: "table-header__count body-3b", children: count }), headerActions && (_jsx("span", { className: "table-header__actions", onClick: e => e.stopPropagation(), children: headerActions }))] })), !collapsed && (_jsxs(_Fragment, { children: [headerGroups && headerGroups.length > 0 && (_jsx("div", { role: "row", className: "table-fields table-fields--groups", children: headerGroups.map((g, i) => (_jsx("div", { role: "columnheader", "aria-colspan": g.span, className: cx('table-field body-3', g.className), style: { gridColumn: `span ${g.span}` }, children: g.label }, i))) })), _jsxs("div", { role: "presentation", className: cx('table-fields-strip', canResize && 'table-fields-strip--resizable'), children: [_jsx("div", { role: "row", className: "table-fields", ref: fieldsRef, children: fields.map((f, i) => (_jsx(TableField, { onClick: f.onClick, className: cx(f.className, alignClass(f.align)), sortDir: f.sortDir, ariaSort: ariaSortOf(i),
707
842
  /* fit 모드는 오른쪽 이웃에서 폭을 덜어 오므로, 덜어 올 컬럼이 없는 자리에는
708
843
  손잡이를 두지 않는다 — 두면 그 컬럼만 grow처럼 넓어져 표가 밀린다. */
709
844
  onResizeStart: canResize && i < fields.length - 1 && f.resizable !== false
@@ -725,6 +860,9 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
725
860
  /* **줄 안에 진짜 단추가 서면 줄은 정지점에서 내린다** — 한 가지 일에
726
861
  정지점이 둘이면 자판으로 도는 사람이 같은 줄을 두 번 잡는다(0.254.0 에서
727
862
  접기 머리에 걷은 그 꼴). 설명도 그때는 필요 없다 — 단추가 제 이름으로 말한다. */
728
- rowHasButton: renderRow(item).some(c => !!c.rowLabel), describedBy: rowHintId, onMouseEnter: onRowMouseEnter ? (e) => onRowMouseEnter(item, e) : undefined, onMouseLeave: onRowMouseLeave ? (e) => onRowMouseLeave(item, e) : undefined, onDragStart: onRowDragStart ? (e) => onRowDragStart(item, e) : undefined, onDragEnd: onRowDragEnd ? (e) => onRowDragEnd(item, e) : undefined, expandedContent: isExpanded && renderExpandedRow ? renderExpandedRow(item) : undefined, children: renderRow(item).map((cell, i) => (_jsx(TableCell, { className: cell.className, style: cell.style, rowLabel: clickable ? cell.rowLabel : undefined, onRowClick: clickable ? () => onRowClick(item) : undefined, children: cell.content }, i))) }, item.id != null ? `${typeof item.id}:${item.id}` : `__idx:${idx}`));
863
+ rowHasButton: renderRow(item).some(c => !!c.rowLabel), describedBy: rowHintId, onMouseEnter: onRowMouseEnter ? (e) => onRowMouseEnter(item, e) : undefined, onMouseLeave: onRowMouseLeave ? (e) => onRowMouseLeave(item, e) : undefined, onDragStart: onRowDragStart ? (e) => onRowDragStart(item, e) : undefined, onDragEnd: onRowDragEnd ? (e) => onRowDragEnd(item, e) : undefined, expandedContent: isExpanded && renderExpandedRow ? renderExpandedRow(item) : undefined, children: renderRow(item).map((cell, i) => (
864
+ /* 열 맞춤(`fields[i].align`)은 **머리와 본문에 함께** 걸린다 —
865
+ 한쪽만 걸면 숫자 열의 머리와 값이 서로 다른 쪽으로 붙는다 */
866
+ _jsx(TableCell, { className: cx(cell.className, alignClass(fields[i]?.align)), style: cell.style, rowLabel: clickable ? cell.rowLabel : undefined, onRowClick: clickable ? () => onRowClick(item) : undefined, children: cell.content }, i))) }, item.id != null ? `${typeof item.id}:${item.id}` : `__idx:${idx}`));
729
867
  }) })] }))] })] }));
730
868
  }
@@ -95,3 +95,11 @@
95
95
  .table-field__sort-arrow {
96
96
  flex-shrink: 0;
97
97
  }
98
+
99
+ /* **열 맞춤**(`fields[].align`, 2026-10-26) — 머리 칸과 본문 칸에 같은 반이 걸린다.
100
+ 왼쪽은 기본이라 반이 없다. 전에는 숫자 열을 오른쪽으로 보내려면 소비처가 제 CSS 를
101
+ 붙여야 했고, 머리와 본문에 따로 붙이다 한쪽만 걸리는 일이 났다. */
102
+ .table-field.table-col--right { justify-content: flex-end; text-align: right; }
103
+ .table-field.table-col--center { justify-content: center; text-align: center; }
104
+ .table-cell.table-col--right { justify-content: flex-end; text-align: right; }
105
+ .table-cell.table-col--center { justify-content: center; text-align: center; }