@ihabdevteam/core 0.435.0 → 0.436.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.
Files changed (44) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/dist/components.cjs.js +180 -180
  3. package/dist/components.esm.css +1 -1
  4. package/dist/hooks.cjs.js +1 -1
  5. package/dist/i18n.cjs.js +1 -1
  6. package/dist/ihabdevteam-core.cjs.js +185 -185
  7. package/dist/ihabdevteam-core.d.ts +21 -17
  8. package/dist/packages/core/src/components/Badge.css +7 -1
  9. package/dist/packages/core/src/components/Badge.d.ts +10 -0
  10. package/dist/packages/core/src/components/Badge.js +2 -2
  11. package/dist/packages/core/src/components/BulkBar.js +4 -1
  12. package/dist/packages/core/src/components/Button.js +6 -1
  13. package/dist/packages/core/src/components/ColorPicker.d.ts +1 -1
  14. package/dist/packages/core/src/components/ColorPicker.js +5 -1
  15. package/dist/packages/core/src/components/ConsentRecordPopup.js +1 -1
  16. package/dist/packages/core/src/components/DatePicker.d.ts +1 -1
  17. package/dist/packages/core/src/components/DatePicker.js +5 -1
  18. package/dist/packages/core/src/components/Dropdown.d.ts +1 -1
  19. package/dist/packages/core/src/components/Dropdown.js +5 -1
  20. package/dist/packages/core/src/components/FilterPanel.js +5 -2
  21. package/dist/packages/core/src/components/Panel.css +14 -12
  22. package/dist/packages/core/src/components/Panel.d.ts +5 -8
  23. package/dist/packages/core/src/components/Panel.js +16 -6
  24. package/dist/packages/core/src/components/PanelRow.js +10 -6
  25. package/dist/packages/core/src/components/Popup/ListPopup.js +1 -1
  26. package/dist/packages/core/src/components/Popup/SaveTablePopup.js +1 -1
  27. package/dist/packages/core/src/components/SegmentedControl.js +5 -1
  28. package/dist/packages/core/src/components/Table.css +12 -15
  29. package/dist/packages/core/src/components/Table.d.ts +1 -3
  30. package/dist/packages/core/src/components/Table.js +77 -73
  31. package/dist/packages/core/src/components/Tabs.d.ts +1 -1
  32. package/dist/packages/core/src/components/Tabs.js +5 -1
  33. package/dist/packages/core/src/components/TextField.js +5 -1
  34. package/dist/packages/core/src/components/Toolbar.js +5 -2
  35. package/dist/packages/core/src/components/Word/WordSearchResultBlock.js +4 -1
  36. package/dist/packages/core/src/components/Word/WordTableBlock.js +1 -1
  37. package/dist/packages/core/src/components/controlSize.d.ts +13 -0
  38. package/dist/packages/core/src/components/controlSize.js +13 -0
  39. package/dist/packages/core/src/components/controlSizeContext.d.ts +17 -0
  40. package/dist/packages/core/src/components/controlSizeContext.js +8 -0
  41. package/dist/packages/core/src/version.d.ts +1 -1
  42. package/dist/packages/core/src/version.js +1 -1
  43. package/dist/utils.cjs.js +1 -1
  44. package/package.json +1 -1
@@ -6,6 +6,7 @@ import { useEffect, useId, useRef } from 'react';
6
6
  import { useTranslation } from 'react-i18next';
7
7
  import Button from './Button';
8
8
  import { devWarnOnce, isDev } from '../utils/devWarn';
9
+ import { useControlSize } from './controlSizeContext';
9
10
  import { CONTROL_SIZE } from './controlSize';
10
11
  /**
11
12
  * **이름을 안 준 고르개들** — 개발 중에 서로 부딪히는지 세기 위한 자리다(운영에서는 비어 있다).
@@ -25,7 +26,10 @@ export default function SegmentedControl(props) {
25
26
  const { t } = useTranslation();
26
27
  const { options = [],
27
28
  // 안 주면 **켜진** 첫 칸 — 꺼진 첫 칸이 골라져 있었다(Tabs 와 같게)
28
- value = options.find((o) => !o.disabled)?.key ?? options[0]?.key, onChange = (_v) => { }, className = '', size = CONTROL_SIZE, shape = 'pill', useBG = true, fullWidth = false, minButtonWidth, ariaLabel, } = props || {};
29
+ value = options.find((o) => !o.disabled)?.key ?? options[0]?.key, onChange = (_v) => { }, className = '', size: sizeProp, shape = 'pill', useBG = true, fullWidth = false, minButtonWidth, ariaLabel, } = props || {};
30
+ // 안 주면 가장 가까운 판 · 표의 값(청 (419)) — 그 밖이면 공용 수 `CONTROL_SIZE`(40)
31
+ const inheritedSize = useControlSize();
32
+ const size = sizeProp ?? inheritedSize ?? CONTROL_SIZE;
29
33
  /* **라디오 무리는 Tab 자리 하나 + 화살표**가 ARIA 규칙이다.
30
34
  `role="radiogroup"`·`role="radio"` 만 붙여 놓고 키를 안 만들면 **안 붙인 것보다
31
35
  나쁘다** — 낭독기가 "라디오 그룹, 3 중 2" 라고 읽어 주니 사람은 화살표를 누르는데
@@ -191,15 +191,16 @@
191
191
  }
192
192
 
193
193
  /* 높이 스케일 — Panel과 공유. header·fields·row 모두 적용. small 48 / medium 56 / large 64 */
194
- .table-wrap--small .table-header,
195
- .table-wrap--small .table-fields,
196
- .table-wrap--small .table-row { min-height: 48px; }
197
- .table-wrap--medium .table-header,
198
- .table-wrap--medium .table-fields,
199
- .table-wrap--medium .table-row { min-height: 56px; }
200
- .table-wrap--large .table-header,
201
- .table-wrap--large .table-fields,
202
- .table-wrap--large .table-row { min-height: 64px; }
194
+ /* 높이는 **한 급뿐이다 — 안쪽 56, 밑선은 그 밖에 1**(사장님 지시 2026-11-12: *"모두 medium 하나로
195
+ 정리. size prop 제거"* · *"선까지 56이면 내부가 55인데 홀수가 되버리잖아"*). `Panel` 과 같은 셈이다.
196
+ 전에는 small 48(기본) · medium 56 · large 64 였다.
197
+ - 행: 밑선이 바깥 `.table-row-wrap` 에 있어 행 자신이 56 이면 된다.
198
+ - 머리 · 칸 이름 줄: 밑선을 제 상자 안(`border-box`)에 쥐므로 57 = 안쪽 56 + 선 1.
199
+ 머리가 접혀 밑선이 없을 때는 56. */
200
+ .table-wrap .table-row { min-height: 56px; }
201
+ .table-wrap .table-header,
202
+ .table-wrap .table-fields { min-height: 57px; }
203
+ .table-wrap--collapsed .table-header { min-height: 56px; }
203
204
 
204
205
  /* 그룹 헤더 행(headerGroups)은 라벨만 담으므로 필드 행 높이(48/56/64)를 다
205
206
  쓰지 않아도 된다 — 낮춰 2줄 머리행이 과하게 높아 보이지 않게 한다. */
@@ -233,9 +234,5 @@
233
234
  /* **기다리는 줄과 빈 줄은 같은 키다** — 한 자리를 두 꼴이 번갈아 쓰기 때문이다(말귀 실측 2026-09-30).
234
235
  전에는 빈 줄에만 키를 주어, '불러오는 중'(스피너 28px)에서 '없음'(48px 이상)으로 넘어갈 때 표가 들썩였다.
235
236
  두 이름을 한 규칙에 묶어 둔 것은 다시 갈라지지 않게 하기 위해서다(`test/tableLoadingHeight0930` 이 그것을 본다). */
236
- .table-wrap--small .table-row--empty,
237
- .table-wrap--small .table-row--loading { min-height: 48px; }
238
- .table-wrap--medium .table-row--empty,
239
- .table-wrap--medium .table-row--loading { min-height: 56px; }
240
- .table-wrap--large .table-row--empty,
241
- .table-wrap--large .table-row--loading { min-height: 64px; }
237
+ .table-wrap .table-row--empty,
238
+ .table-wrap .table-row--loading { min-height: 56px; }
@@ -228,8 +228,6 @@ export type TableProps<T extends {
228
228
  * 한 번에 다 오면 *왔나 안 왔나*(`? 1 : 0`)로 족하다.
229
229
  */
230
230
  refitOn?: string | number;
231
- /** 높이 스케일 — Panel과 공유 (small 48 / medium 56 / large 64). header·row 모두 적용. 기본 small */
232
- size?: 'small' | 'medium' | 'large';
233
231
  /** 테이블 상단 그룹 헤더 제목. 지정하면 .table-header 영역이 렌더됩니다. */
234
232
  title?: ReactNode;
235
233
  /**
@@ -264,4 +262,4 @@ export type TableProps<T extends {
264
262
  /** @public */
265
263
  export default function Table<T extends {
266
264
  id?: string | number;
267
- }>({ fields: rawFields, sort: sortBinding, sortable, headerGroups, items: rawItems, renderRow, onRowClick, isRowClickable, onRowMouseEnter, onRowMouseLeave, onRowDragStart, onRowDragEnd, draggingId, gridTemplateColumns, mobileGridTemplateColumns, resizable, resizeMode, resizeStorageKey, refitOn, size, title, icon, count, collapsed, onToggleCollapse, headerActions, empty, loading, dragOver, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }: TableProps<T>): import("react").JSX.Element;
265
+ }>({ fields: rawFields, sort: sortBinding, sortable, headerGroups, items: rawItems, renderRow, onRowClick, isRowClickable, onRowMouseEnter, onRowMouseLeave, onRowDragStart, onRowDragEnd, draggingId, gridTemplateColumns, mobileGridTemplateColumns, resizable, resizeMode, resizeStorageKey, refitOn, title, icon, count, collapsed, onToggleCollapse, headerActions, empty, loading, dragOver, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }: TableProps<T>): import("react").JSX.Element;
@@ -21,6 +21,7 @@ import ChevronDown from 'lucide-react/dist/esm/icons/chevron-down.mjs';
21
21
  import Button from './Button';
22
22
  import Icon from './Icon';
23
23
  import Loader from './Loader';
24
+ import { ControlSizeContext } from './controlSizeContext';
24
25
  import { CONTROL_SIZE } from './controlSize';
25
26
  import useMediaQuery from '../hooks/useMediaQuery';
26
27
  /**
@@ -140,7 +141,10 @@ function alignClass(align) {
140
141
  return align && align !== 'left' ? `table-col--${align}` : undefined;
141
142
  }
142
143
  /** @public */
143
- 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, refitOn, size = 'small', title, icon, count, collapsed = false, onToggleCollapse, headerActions, empty, loading, dragOver = false, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }) {
144
+ 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, refitOn, title, icon, count, collapsed = false, onToggleCollapse, headerActions, empty, loading, dragOver = false, onDragOver, onDragLeave, onDrop, renderExpandedRow, expandedId, }) {
145
+ /* **표는 늘 40**(사장님 지시 2026-11-12) — 테두리 없는 판 안에 놓여도 48 을 물려받지 않는다.
146
+ 표 안에 부르는 쪽이 얹은 칸도 40 이 되도록 맥락을 40 으로 다시 세운다. */
147
+ const ctrlSize = CONTROL_SIZE;
144
148
  const { t } = useTranslation();
145
149
  const uid = useId();
146
150
  const titleId = `table-title-${uid}`;
@@ -1023,76 +1027,76 @@ export default function Table({ fields: rawFields = [], sort: sortBinding, sorta
1023
1027
  ? { '--table-grid-cols': effectiveGrid }
1024
1028
  : undefined;
1025
1029
  const hasHeader = title !== undefined;
1026
- return (_jsxs("div", { ref: attachOuter, className: `table-wrap table-wrap--${size}${canResize ? ' table-wrap--resizable' : ''}${dragOver ? ' table-wrap--dragover' : ''}${collapsed ? ' table-wrap--collapsed' : ''}`, style: gridStyle, onDragOver: onDragOver, onDragLeave: onDragLeave, onDrop: onDrop,
1027
- /* **넘칠 때만 초점을 받는다**(말귀 요청 ㊿, 2026-10-01).
1028
- 이 통은 `overflow-x: auto` 인데 초점을 못 받았다. 안에 초점 받을 것이 없으면
1029
- 자판만 쓰는 사람은 **오른쪽 칸을 영영 못 본다** — Tab 이 왼쪽 칸을 벗어나지
1030
- 않으니 브라우저가 굴려 줄 일이 없고, 통이 초점을 못 받으니 ←→ 로 굴릴 수도
1031
- 없다(말귀 실측: 좁은 화면의 단어 관리에서 **여덟 칸 중 여섯이 자판으로 안
1032
- 닿았다**. WCAG 2.1.1).
1033
- **안 넘치면 안 받는다** — 다 들어가는 표까지 정지점이 되면 자판 길에 빈 걸음이
1034
- 한 칸씩 는다. 그래서 `scrollWidth > clientWidth` 를 재서 켠다.
1035
- **이름 있는 `region`** 으로 둔다: 이름 없는 `region` 은 낭독기가 건너뛰고,
1036
- 초점만 받는 `div` 는 "여기서 뭘 하라는 건지" 를 말해 주지 못한다. */
1037
- tabIndex: overflowing ? 0 : undefined, role: overflowing ? 'region' : undefined, "aria-label": overflowing ? (typeof title === 'string' ? title : t('table.scrollRegion', '가로로 굴릴 수 있는 표')) : undefined, children: [!!onRowClick && _jsx("span", { id: rowHintId, className: "table-row-hint", children: t('table.rowActionHint', '줄을 누르면 자세히 봅니다') }), _jsxs("div", { ref: attachInner, role: "table", "aria-labelledby": hasHeader && typeof title === 'string' ? titleId : undefined, className: "table body-2", children: [hasHeader && (_jsxs("div", { className: cx('table-header', onToggleCollapse && 'table-header--clickable'), onClick: onToggleCollapse,
1038
- /**
1039
- * **머리는 늘 `caption` 이다 — 단추가 아니다**(사장님 지시 2026-10-02).
1040
- *
1041
- * 전에는 접을 수 있으면 이 `div` 가 `role="button"` 에 `tabIndex=0` 이었다. 그런데
1042
- * **그 안에 이미 진짜 `<button>`("접기"/"펼치기")이 있다** — 단추 안 단추이고,
1043
- * 한 가지 일에 **탭 정지점이 둘**이었다(자판으로 도는 사람은 같은 '접기' 를 두 번
1044
- * 잡는다). 게다가 `.table` 이 `role="table"` 이 된 뒤로는 그 단추가 나무에서
1045
- * **표의 바로 아래 아이**로 서서 표의 꼴까지 흐렸다.
1046
- *
1047
- * 그래서 역할·정지점·키 처리를 **안쪽 진짜 단추에 맡긴다.** 여닫힘(`aria-expanded`)도
1048
- * 그 단추로 옮겼다 — 여는 것이 그것이니 상태도 그것이 말해야 한다.
1049
- *
1050
- * **머리 아무 데나 눌러 접는 손맛은 그대로다** — `onClick` 이 그대로 있고, 안쪽
1051
- * 단추가 낸 클릭도 여기로 올라와 한 번만 불린다. 손 모양·hover 는 CSS 가
1052
- * `.table-header--clickable` 로 잡는다(전에는 `[role="button"]` 로 잡았다).
1053
- *
1054
- * 손으로 붙이던 `onKeyDown` 은 **지웠다** — 진짜 단추라 Enter·Space 는 브라우저가
1055
- * 처리하고, "머리 안 단추에서 누른 키는 그 단추 몫" 이라는 가드도 저절로 선다.
1056
- */
1057
- role: "caption", children: [onToggleCollapse && (_jsx(Button, { htmlType: "button", size: CONTROL_SIZE, type: "dot", variant: "transparent-gray", useBorder: false, icon: collapsed ? 'chevron-right' : 'chevron-down', ariaLabel: collapsed ? t('common.expand', '펼치기') : t('common.collapse', '접기'),
1058
- /* 여닫힘은 **여는 것**이 말한다 — 전에는 겉의 `div` 에 달려 있었다(위 머리글) */
1059
- 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),
1060
- /* fit 모드는 오른쪽 이웃에서 폭을 덜어 오므로, 덜어 올 컬럼이 없는 자리에는
1061
- 손잡이를 두지 않는다 — 두면 그 컬럼만 grow처럼 넓어져 표가 밀린다. */
1062
- onResizeStart: canResize && i < fields.length - 1 && f.resizable !== false
1063
- && (resizeMode !== 'fit' || fields.some((g, j) => j > i && g.resizable !== false))
1064
- ? (e) => startResize(i, e) : undefined, children: f.label }, i))) }), canResize && (
1065
- /* **보이는 오른쪽 끝에 붙박는다**(말귀 청 (216), 2026-10-28,
1066
- 사장님 *"칸 너비 초기화 버튼이 사라지면 안되지"*).
1067
-
1068
- 전에는 단추가 이 띠의 `right: 0` 에 그냥 얹혀 있었다. 띠는 `.table-wrap`
1069
- (= 가로 스크롤러) 안이고, 열이 넘칠 때는 안쪽 상자가 **열 폭만큼** 넓어지므로
1070
- (`measureOverflow`) 그 `right: 0` 은 **스크롤 끝**이다 — 오른쪽 끝까지 밀어야
1071
- 단추가 나왔다. **칸이 넘치는 그때가 바로 누르고 싶은 때**인데 그때 손이 안 닿았다.
1072
-
1073
- 그래서 자리를 안 차지하는 `sticky` 받침에 담는다. 넘치지 않을 때는 띠 끝의
1074
- 빈자리(`--table-reset-gutter`)에 그대로 서고, 넘칠 때는 보이는 오른쪽 끝에
1075
- 붙어 선다. 받침이 폭 0 이라 열 셈에는 아무것도 더하지 않는다. */
1076
- _jsx("div", { className: "table-fields__reset-dock", children: _jsx(Button, { htmlType: "button", size: CONTROL_SIZE, type: "dot", variant: "transparent-gray", useBorder: false, icon: "chevrons-left-right-ellipsis", ariaLabel: t('table.resetColumns', '칸 너비 초기화'), showTooltipInfo: t('table.resetColumns', '칸 너비 초기화'), className: "table-fields__reset", onClick: resetColumns }) }))] }), _jsx("div", { role: "rowgroup", className: "table-body", children: loading ? (_jsx(TableRow, { variant: "loading", colSpan: fields.length || undefined })) : items.length === 0 && empty ? (_jsx(TableRow, { variant: "empty", colSpan: fields.length || undefined, children: empty })) : items.map((item, idx) => {
1077
- const isDragging = draggingId != null && item.id === draggingId;
1078
- const clickable = !!onRowClick && (isRowClickable ? isRowClickable(item) : true);
1079
- /* 글자로 견준다 — URL·폼에서 온 '5' 와 자료의 5 가 같은 줄인데 `===` 로는 안 펴졌다 */
1080
- const isExpanded = expandedId != null && item.id != null && (expandedId instanceof Set
1081
- ? expandedId.has(item.id) || [...expandedId].some(x => String(x) === String(item.id))
1082
- : String(item.id) === String(expandedId));
1083
- return (_jsx(TableRow
1084
- // 타입까지 열쇠에 — id 없는 줄(idx 0)과 id:0, 1 과 '1' 이 같은 열쇠가 되어 목록을 바꾼 뒤 옛 줄이 남았다
1085
- , { className: `${clickable ? ' table-row--clickable' : ''}${onRowDragStart ? ' table-row--draggable' : ''}${isDragging ? ' table-row--dragging' : ''}`.trim(), draggable: !!onRowDragStart,
1086
- // 옆의 핸들러들처럼 있을 때만 넘긴다. 항상 함수를 만들어 넘기면
1087
- // TableRow 가 "클릭 가능"으로 보고 role="button" · tabIndex=0 을 붙여,
1088
- // 클릭 동작이 없는 표의 모든 행이 버튼으로 읽히고 탭 정지점이 된다.
1089
- onClick: clickable ? () => onRowClick(item) : undefined, colSpan: fields.length || undefined,
1090
- /* **줄 안에 진짜 단추가 서면 줄은 정지점에서 내린다** — 한 가지 일에
1091
- 정지점이 둘이면 자판으로 도는 사람이 같은 줄을 두 번 잡는다(0.254.0 에서
1092
- 접기 머리에 걷은 그 꼴). 설명도 그때는 필요 없다 — 단추가 제 이름으로 말한다. */
1093
- 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) => (
1094
- /* 열 맞춤(`fields[i].align`)은 **머리와 본문에 함께** 걸린다 —
1095
- 한쪽만 걸면 숫자 열의 머리와 값이 서로 다른 쪽으로 붙는다 */
1096
- _jsx(TableCell, { className: cx(cell.className, alignClass(fields[i]?.align)), style: cell.style, span: cell.span, rowLabel: clickable ? cell.rowLabel : undefined, onRowClick: clickable ? () => onRowClick(item) : undefined, children: cell.content }, i))) }, item.id != null ? `${typeof item.id}:${item.id}` : `__idx:${idx}`));
1097
- }) })] }))] })] }));
1030
+ return (_jsx(ControlSizeContext.Provider, { value: CONTROL_SIZE, children: _jsxs("div", { ref: attachOuter, className: `table-wrap${canResize ? ' table-wrap--resizable' : ''}${dragOver ? ' table-wrap--dragover' : ''}${collapsed ? ' table-wrap--collapsed' : ''}`, style: gridStyle, onDragOver: onDragOver, onDragLeave: onDragLeave, onDrop: onDrop,
1031
+ /* **넘칠 때만 초점을 받는다**(말귀 요청 ㊿, 2026-10-01).
1032
+ 이 통은 `overflow-x: auto` 인데 초점을 못 받았다. 안에 초점 받을 것이 없으면
1033
+ 자판만 쓰는 사람은 **오른쪽 칸을 영영 못 본다** — Tab 이 왼쪽 칸을 벗어나지
1034
+ 않으니 브라우저가 굴려 줄 일이 없고, 통이 초점을 못 받으니 ←→ 로 굴릴 수도
1035
+ 없다(말귀 실측: 좁은 화면의 단어 관리에서 **여덟 칸 중 여섯이 자판으로 안
1036
+ 닿았다**. WCAG 2.1.1).
1037
+ **안 넘치면 안 받는다** — 다 들어가는 표까지 정지점이 되면 자판 길에 빈 걸음이
1038
+ 한 칸씩 는다. 그래서 `scrollWidth > clientWidth` 를 재서 켠다.
1039
+ **이름 있는 `region`** 으로 둔다: 이름 없는 `region` 은 낭독기가 건너뛰고,
1040
+ 초점만 받는 `div` 는 "여기서 뭘 하라는 건지" 를 말해 주지 못한다. */
1041
+ tabIndex: overflowing ? 0 : undefined, role: overflowing ? 'region' : undefined, "aria-label": overflowing ? (typeof title === 'string' ? title : t('table.scrollRegion', '가로로 굴릴 수 있는 표')) : undefined, children: [!!onRowClick && _jsx("span", { id: rowHintId, className: "table-row-hint", children: t('table.rowActionHint', '줄을 누르면 자세히 봅니다') }), _jsxs("div", { ref: attachInner, role: "table", "aria-labelledby": hasHeader && typeof title === 'string' ? titleId : undefined, className: "table body-2", children: [hasHeader && (_jsxs("div", { className: cx('table-header', onToggleCollapse && 'table-header--clickable'), onClick: onToggleCollapse,
1042
+ /**
1043
+ * **머리는 늘 `caption` 이다 — 단추가 아니다**(사장님 지시 2026-10-02).
1044
+ *
1045
+ * 전에는 접을 수 있으면 이 `div` 가 `role="button"` 에 `tabIndex=0` 이었다. 그런데
1046
+ * **그 안에 이미 진짜 `<button>`("접기"/"펼치기")이 있다** — 단추 안 단추이고,
1047
+ * 한 가지 일에 **탭 정지점이 둘**이었다(자판으로 도는 사람은 같은 '접기' 를 두 번
1048
+ * 잡는다). 게다가 `.table` 이 `role="table"` 이 된 뒤로는 그 단추가 나무에서
1049
+ * **표의 바로 아래 아이**로 서서 표의 꼴까지 흐렸다.
1050
+ *
1051
+ * 그래서 역할·정지점·키 처리를 **안쪽 진짜 단추에 맡긴다.** 여닫힘(`aria-expanded`)도
1052
+ * 그 단추로 옮겼다 — 여는 것이 그것이니 상태도 그것이 말해야 한다.
1053
+ *
1054
+ * **머리 아무 데나 눌러 접는 손맛은 그대로다** — `onClick` 이 그대로 있고, 안쪽
1055
+ * 단추가 낸 클릭도 여기로 올라와 한 번만 불린다. 손 모양·hover 는 CSS 가
1056
+ * `.table-header--clickable` 로 잡는다(전에는 `[role="button"]` 로 잡았다).
1057
+ *
1058
+ * 손으로 붙이던 `onKeyDown` 은 **지웠다** — 진짜 단추라 Enter·Space 는 브라우저가
1059
+ * 처리하고, "머리 안 단추에서 누른 키는 그 단추 몫" 이라는 가드도 저절로 선다.
1060
+ */
1061
+ role: "caption", children: [onToggleCollapse && (_jsx(Button, { htmlType: "button", size: ctrlSize, type: "dot", variant: "transparent-gray", useBorder: false, icon: collapsed ? 'chevron-right' : 'chevron-down', ariaLabel: collapsed ? t('common.expand', '펼치기') : t('common.collapse', '접기'),
1062
+ /* 여닫힘은 **여는 것**이 말한다 — 전에는 겉의 `div` 에 달려 있었다(위 머리글) */
1063
+ 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),
1064
+ /* fit 모드는 오른쪽 이웃에서 폭을 덜어 오므로, 덜어 올 컬럼이 없는 자리에는
1065
+ 손잡이를 두지 않는다 — 두면 그 컬럼만 grow처럼 넓어져 표가 밀린다. */
1066
+ onResizeStart: canResize && i < fields.length - 1 && f.resizable !== false
1067
+ && (resizeMode !== 'fit' || fields.some((g, j) => j > i && g.resizable !== false))
1068
+ ? (e) => startResize(i, e) : undefined, children: f.label }, i))) }), canResize && (
1069
+ /* **보이는 오른쪽 끝에 붙박는다**(말귀 청 (216), 2026-10-28,
1070
+ 사장님 *"칸 너비 초기화 버튼이 사라지면 안되지"*).
1071
+
1072
+ 전에는 단추가 이 띠의 `right: 0` 에 그냥 얹혀 있었다. 띠는 `.table-wrap`
1073
+ (= 가로 스크롤러) 안이고, 열이 넘칠 때는 안쪽 상자가 **열 폭만큼** 넓어지므로
1074
+ (`measureOverflow`) 그 `right: 0` 은 **스크롤 끝**이다 — 오른쪽 끝까지 밀어야
1075
+ 단추가 나왔다. **칸이 넘치는 그때가 바로 누르고 싶은 때**인데 그때 손이 안 닿았다.
1076
+
1077
+ 그래서 자리를 안 차지하는 `sticky` 받침에 담는다. 넘치지 않을 때는 띠 끝의
1078
+ 빈자리(`--table-reset-gutter`)에 그대로 서고, 넘칠 때는 보이는 오른쪽 끝에
1079
+ 붙어 선다. 받침이 폭 0 이라 열 셈에는 아무것도 더하지 않는다. */
1080
+ _jsx("div", { className: "table-fields__reset-dock", children: _jsx(Button, { htmlType: "button", size: ctrlSize, type: "dot", variant: "transparent-gray", useBorder: false, icon: "chevrons-left-right-ellipsis", ariaLabel: t('table.resetColumns', '칸 너비 초기화'), showTooltipInfo: t('table.resetColumns', '칸 너비 초기화'), className: "table-fields__reset", onClick: resetColumns }) }))] }), _jsx("div", { role: "rowgroup", className: "table-body", children: loading ? (_jsx(TableRow, { variant: "loading", colSpan: fields.length || undefined })) : items.length === 0 && empty ? (_jsx(TableRow, { variant: "empty", colSpan: fields.length || undefined, children: empty })) : items.map((item, idx) => {
1081
+ const isDragging = draggingId != null && item.id === draggingId;
1082
+ const clickable = !!onRowClick && (isRowClickable ? isRowClickable(item) : true);
1083
+ /* 글자로 견준다 — URL·폼에서 온 '5' 와 자료의 5 가 같은 줄인데 `===` 로는 안 펴졌다 */
1084
+ const isExpanded = expandedId != null && item.id != null && (expandedId instanceof Set
1085
+ ? expandedId.has(item.id) || [...expandedId].some(x => String(x) === String(item.id))
1086
+ : String(item.id) === String(expandedId));
1087
+ return (_jsx(TableRow
1088
+ // 타입까지 열쇠에 — id 없는 줄(idx 0)과 id:0, 1 과 '1' 이 같은 열쇠가 되어 목록을 바꾼 뒤 옛 줄이 남았다
1089
+ , { className: `${clickable ? ' table-row--clickable' : ''}${onRowDragStart ? ' table-row--draggable' : ''}${isDragging ? ' table-row--dragging' : ''}`.trim(), draggable: !!onRowDragStart,
1090
+ // 옆의 핸들러들처럼 있을 때만 넘긴다. 항상 함수를 만들어 넘기면
1091
+ // TableRow 가 "클릭 가능"으로 보고 role="button" · tabIndex=0 을 붙여,
1092
+ // 클릭 동작이 없는 표의 모든 행이 버튼으로 읽히고 탭 정지점이 된다.
1093
+ onClick: clickable ? () => onRowClick(item) : undefined, colSpan: fields.length || undefined,
1094
+ /* **줄 안에 진짜 단추가 서면 줄은 정지점에서 내린다** — 한 가지 일에
1095
+ 정지점이 둘이면 자판으로 도는 사람이 같은 줄을 두 번 잡는다(0.254.0 에서
1096
+ 접기 머리에 걷은 그 꼴). 설명도 그때는 필요 없다 — 단추가 제 이름으로 말한다. */
1097
+ 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) => (
1098
+ /* 열 맞춤(`fields[i].align`)은 **머리와 본문에 함께** 걸린다 —
1099
+ 한쪽만 걸면 숫자 열의 머리와 값이 서로 다른 쪽으로 붙는다 */
1100
+ _jsx(TableCell, { className: cx(cell.className, alignClass(fields[i]?.align)), style: cell.style, span: cell.span, rowLabel: clickable ? cell.rowLabel : undefined, onRowClick: clickable ? () => onRowClick(item) : undefined, children: cell.content }, i))) }, item.id != null ? `${typeof item.id}:${item.id}` : `__idx:${idx}`));
1101
+ }) })] }))] })] }) }));
1098
1102
  }
@@ -29,4 +29,4 @@ export interface TabsProps {
29
29
  *
30
30
  * @public
31
31
  */
32
- export default function Tabs({ items, value, onChange, className, size }: TabsProps): import("react").JSX.Element;
32
+ export default function Tabs({ items, value, onChange, className, size: sizeProp }: TabsProps): import("react").JSX.Element;
@@ -3,6 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { useId, useRef } from 'react';
4
4
  import { useTranslation } from 'react-i18next';
5
5
  import './Tabs.css';
6
+ import { useControlSize } from './controlSizeContext';
6
7
  import { CONTROL_SIZE } from './controlSize';
7
8
  /**
8
9
  * 탭 리스트 + 탭 패널 전환 컴포넌트. `role="tablist"/"tab"/"tabpanel"`,
@@ -15,7 +16,10 @@ import { CONTROL_SIZE } from './controlSize';
15
16
  *
16
17
  * @public
17
18
  */
18
- export default function Tabs({ items = [], value, onChange, className = '', size = CONTROL_SIZE }) {
19
+ export default function Tabs({ items = [], value, onChange, className = '', size: sizeProp }) {
20
+ // 안 주면 가장 가까운 판 · 표의 값(청 (419)) — 그 밖이면 공용 수 `CONTROL_SIZE`(40)
21
+ const inheritedSize = useControlSize();
22
+ const size = sizeProp ?? inheritedSize ?? CONTROL_SIZE;
19
23
  /* **판 이름표를 인스턴스마다 가른다.** 예전에는 `tabs__tab-${key}` 로 열쇠만 썼다.
20
24
  한 화면에 Tabs 가 둘 이상이고 열쇠가 겹치면(overview/usage 처럼 흔한 이름이다)
21
25
  **같은 id 가 여럿 생긴다.** 그러면 브라우저는 `aria-controls` 를 **첫 번째** 것으로
@@ -11,6 +11,7 @@ import Button from './Button';
11
11
  import { useComboboxSuggestions } from './useComboboxSuggestions';
12
12
  import { useIsoLayoutEffect } from '../hooks/useIsoLayoutEffect';
13
13
  import './TextField.css';
14
+ import { useControlSize } from './controlSizeContext';
14
15
  import { CONTROL_SIZE } from './controlSize';
15
16
  /** @public */
16
17
  export default function TextField(props) {
@@ -19,7 +20,10 @@ export default function TextField(props) {
19
20
  조작기가 40이다(세그먼트 단추·줄 옆 `Button`). 글자 칸만 48이라 수를 받는 줄이
20
21
  토글 줄보다 눈에 띄게 깊었다(실측: 그 줄 80px ↔ 토글 줄 56px → 72px 로 좁혀짐).
21
22
  48이 맞는 자리는 그 자리에 `size={48}` 을 적는다. */
22
- size = CONTROL_SIZE, variant = 'input', fullWidth = false, newline = false, multiline = false, rows = 3, leftIcon, rightIcon, clearable = false, list, showCount = true, className = '', onFocus, onBlur, onKeyDown, onEnter, inputMode, autoComplete, autoFocus, suggestions: suggestionsProp, filterSuggestions, onSelectSuggestion, autoActiveFirst, openOnFocus = false, } = props;
23
+ size: sizeProp, variant = 'input', fullWidth = false, newline = false, multiline = false, rows = 3, leftIcon, rightIcon, clearable = false, list, showCount = true, className = '', onFocus, onBlur, onKeyDown, onEnter, inputMode, autoComplete, autoFocus, suggestions: suggestionsProp, filterSuggestions, onSelectSuggestion, autoActiveFirst, openOnFocus = false, } = props;
24
+ // 안 주면 가장 가까운 판 · 표의 값(청 (419)) — 그 밖이면 공용 수 `CONTROL_SIZE`(40)
25
+ const inheritedSize = useControlSize();
26
+ const size = sizeProp ?? inheritedSize ?? CONTROL_SIZE;
23
27
  // 읽기 전용·꺼진 칸은 후보로 값을 바꾸지 못한다 — 전에는 ↓·Enter·후보 누름으로 onChange 가 나갔다
24
28
  const suggestions = readOnly || disabled ? undefined : suggestionsProp;
25
29
  const { t } = useTranslation();
@@ -6,18 +6,21 @@ import TextField from './TextField';
6
6
  import Dropdown from './Dropdown';
7
7
  import Pagination from './Pagination';
8
8
  import SegmentedControl from './SegmentedControl';
9
+ import { useControlSize } from './controlSizeContext';
9
10
  import { CONTROL_SIZE } from './controlSize';
10
11
  import './Toolbar.css';
11
12
  export default function Toolbar({ count, search, segment, filters, pageSize, pagination, actions, className, }) {
13
+ // 둘레 판이 고른 조절칸 크기(테두리 없는 판 48 · 그 밖 40) — 청 (419), 2026-11-12
14
+ const ctrlSize = useControlSize() ?? CONTROL_SIZE;
12
15
  const { t } = useTranslation();
13
16
  const countNode = count != null && (
14
17
  // 검색어를 칠 때 바뀌는 결과 수를 낭독기에 알린다(전에는 조용했다)
15
18
  _jsxs("p", { className: "toolbar__count body-1", role: "status", "aria-atomic": "true", children: [count.prefix ?? t('common.totalPrefix', '총 '), _jsx("span", { className: "toolbar__count-highlight", children: count.value }), count.unit, count.suffix] }));
16
19
  // 좌측 그룹: count → segment. 우측 그룹: search → filters(정렬 등) → pageSize → pagination → actions
17
20
  const hasRight = !!(search || filters?.length || pageSize || pagination || actions);
18
- return (_jsxs("div", { className: cx('toolbar', className), children: [_jsxs("div", { className: "toolbar__row", children: [countNode, segment && (Array.isArray(segment) ? segment : [segment]).map((seg, i) => (_jsx(SegmentedControl, { size: CONTROL_SIZE, ...seg }, seg.ariaLabel ?? i)))] }), hasRight && (_jsx("div", { className: "toolbar__row", children: _jsxs("div", { className: "toolbar__row-end", children: [search && (_jsx(TextField, { className: "toolbar__search", size: CONTROL_SIZE, value: search.value, onChange: search.onChange, placeholder: search.placeholder ?? t('common.search', '검색'),
21
+ return (_jsxs("div", { className: cx('toolbar', className), children: [_jsxs("div", { className: "toolbar__row", children: [countNode, segment && (Array.isArray(segment) ? segment : [segment]).map((seg, i) => (_jsx(SegmentedControl, { size: ctrlSize, ...seg }, seg.ariaLabel ?? i)))] }), hasRight && (_jsx("div", { className: "toolbar__row", children: _jsxs("div", { className: "toolbar__row-end", children: [search && (_jsx(TextField, { className: "toolbar__search", size: ctrlSize, value: search.value, onChange: search.onChange, placeholder: search.placeholder ?? t('common.search', '검색'),
19
22
  /* placeholder는 접근 가능한 이름이 아니다 — 입력이 시작되면 사라지고
20
23
  화면낭독기 지원도 제각각이라, 같은 문구를 aria-label로도 준다.
21
24
  (툴바 검색은 시각적 라벨이 따로 없는 자리라 이게 유일한 이름이 된다.) */
22
- ariaLabel: search.placeholder ?? t('common.search', '검색'), autoFocus: search.autoFocus, clearable: true })), filters?.map((f, i) => (_jsx(Dropdown, { size: CONTROL_SIZE, options: f.options, value: f.value, onChange: f.onChange, ariaLabel: f.ariaLabel }, i))), (pageSize || pagination) && (_jsxs("div", { className: "toolbar__pager", children: [pageSize && _jsx(Dropdown, { size: CONTROL_SIZE, options: pageSize.options, value: pageSize.value, onChange: pageSize.onChange, ariaLabel: pageSize.ariaLabel ?? t('common.pageSizeSelect', '페이지당 표시 개수') }), pagination && (_jsx(Pagination, { page: pagination.page, totalPages: pagination.total, onChange: pagination.onChange, prevLabel: pagination.prevLabel, nextLabel: pagination.nextLabel }))] })), actions] }) }))] }));
25
+ ariaLabel: search.placeholder ?? t('common.search', '검색'), autoFocus: search.autoFocus, clearable: true })), filters?.map((f, i) => (_jsx(Dropdown, { size: ctrlSize, options: f.options, value: f.value, onChange: f.onChange, ariaLabel: f.ariaLabel }, i))), (pageSize || pagination) && (_jsxs("div", { className: "toolbar__pager", children: [pageSize && _jsx(Dropdown, { size: ctrlSize, options: pageSize.options, value: pageSize.value, onChange: pageSize.onChange, ariaLabel: pageSize.ariaLabel ?? t('common.pageSizeSelect', '페이지당 표시 개수') }), pagination && (_jsx(Pagination, { page: pagination.page, totalPages: pagination.total, onChange: pagination.onChange, prevLabel: pagination.prevLabel, nextLabel: pagination.nextLabel }))] })), actions] }) }))] }));
23
26
  }
@@ -12,6 +12,7 @@ import Section from '../Section';
12
12
  import Icon from '../Icon';
13
13
  import Dropdown from '../Dropdown';
14
14
  import Pagination from '../Pagination';
15
+ import { useControlSize } from '../controlSizeContext';
15
16
  import { CONTROL_SIZE } from '../controlSize';
16
17
  import WordImageTooltip from '../Tooltip/WordImageTooltip';
17
18
  import { useHoverAnchor } from '../../hooks/useHoverAnchor';
@@ -19,6 +20,8 @@ import { makeWordQueryMatcher } from '../../utils/koreanSyllable';
19
20
  import { withIga, withEulReul } from '../../utils/josa';
20
21
  /** @public */
21
22
  export default function WordSearchResultBlock({ titleIcon, resultCount, resultUnit, searchQuery, items, groups, selected = [], onSelect, maxSelect, onClearSelection, onPrint, onPrintEmpty, className, emptyHint, showEmptyText = true, sectionType = 'page', disc, }) {
23
+ // 둘레 판이 고른 조절칸 크기(테두리 없는 판 48 · 그 밖 40) — 청 (419), 2026-11-12
24
+ const ctrlSize = useControlSize() ?? CONTROL_SIZE;
22
25
  const { t, i18n } = useTranslation();
23
26
  // 한국어에서만 조사(이/가·을/를)를 unit 말미에 붙인다 — 문구에는 조사를 고정하지 않는다.
24
27
  const ko = i18n.language?.startsWith('ko') ?? false;
@@ -151,7 +154,7 @@ export default function WordSearchResultBlock({ titleIcon, resultCount, resultUn
151
154
  // 결과가 있으면(flat/그룹 모두) 툴바(정렬·페이지크기·페이지네이션) 노출.
152
155
  // (그룹 뷰도 flat과 동일하게 페이지네이션 — 카드 4 결정 1안. 그룹은 페이지 단위로 재그룹핑되어 표시.)
153
156
  const showToolbar = totalCount > 0;
154
- const toolbar = showToolbar ? (_jsxs("div", { className: "word-search-result-block__toolbar", children: [_jsx(Dropdown, { size: CONTROL_SIZE, options: sortOptions, value: effectiveSortKey, onChange: setSortKey, ariaLabel: t('wordSearch.sort.aria', { defaultValue: '정렬' }) }), _jsx(Dropdown, { size: CONTROL_SIZE, options: pageSizeOptions, value: pageSizeStr, onChange: setPageSizeStr, ariaLabel: t('wordSearch.pageSizeAria', { defaultValue: '페이지 크기' }) }), _jsx(Pagination, { page: pageClamped, totalPages: totalPages, onChange: setPage })] })) : undefined;
157
+ const toolbar = showToolbar ? (_jsxs("div", { className: "word-search-result-block__toolbar", children: [_jsx(Dropdown, { size: ctrlSize, options: sortOptions, value: effectiveSortKey, onChange: setSortKey, ariaLabel: t('wordSearch.sort.aria', { defaultValue: '정렬' }) }), _jsx(Dropdown, { size: ctrlSize, options: pageSizeOptions, value: pageSizeStr, onChange: setPageSizeStr, ariaLabel: t('wordSearch.pageSizeAria', { defaultValue: '페이지 크기' }) }), _jsx(Pagination, { page: pageClamped, totalPages: totalPages, onChange: setPage })] })) : undefined;
155
158
  const handleClick = (id) => {
156
159
  if (!onSelect)
157
160
  return;
@@ -422,7 +422,7 @@ export default function WordTableBlock({ title, titleIcon, disc, filterTitle, fi
422
422
  자리에서는 `count === capacity` 라 둘이 같다(154~158줄). */
423
423
  addableCount: capacitySet ? count : undefined,
424
424
  /* 편집 모드에는 얹을 항목이 없다 — 칸을 손으로 채우는 꼴이다 */
425
- renderCellAction: !isEditable ? renderCellAction : undefined, brand: band, code: code, showFillerAdd: !!onAddItem, fillerAdd: fillerAdd, contentRef: contentRef })), !hideControls && !saveOnly && actionsLeftExtra != null && (_jsx("div", { className: "word-table-block__table-actions", children: actionsLeftExtra })), inlineNameFields && !hideControls && (_jsxs(Panel, { size: "medium", labelWidth: 64, useBorder: false, useRowBorder: false, className: "word-table-block__meta", children: [_jsx(PanelRow, { variant: "custom", label: t('wordTable.save.nameLabel', '이름'), required: true, align: "vertical", useFullWidth: true, children: _jsx(TextField, { required: true, value: nameValue ?? '', onChange: onNameChange, placeholder: namePlaceholder ? namePlaceholder + t('wordTable.save.autoFillHint', ' (Tab 또는 space 입력시 자동 입력)') : t('wordTable.save.placeholder', '이 단어표에 대한 제목을 입력하세요.'),
425
+ renderCellAction: !isEditable ? renderCellAction : undefined, brand: band, code: code, showFillerAdd: !!onAddItem, fillerAdd: fillerAdd, contentRef: contentRef })), !hideControls && !saveOnly && actionsLeftExtra != null && (_jsx("div", { className: "word-table-block__table-actions", children: actionsLeftExtra })), inlineNameFields && !hideControls && (_jsxs(Panel, { labelWidth: 64, useBorder: false, className: "word-table-block__meta", children: [_jsx(PanelRow, { variant: "custom", label: t('wordTable.save.nameLabel', '이름'), required: true, align: "vertical", useFullWidth: true, children: _jsx(TextField, { required: true, value: nameValue ?? '', onChange: onNameChange, placeholder: namePlaceholder ? namePlaceholder + t('wordTable.save.autoFillHint', ' (Tab 또는 space 입력시 자동 입력)') : t('wordTable.save.placeholder', '이 단어표에 대한 제목을 입력하세요.'),
426
426
  /* PanelRow의 라벨은 시각적으로만 붙어 있고 입력과 연결돼 있지 않아, 낭독기에는
427
427
  이름 없는 입력으로 읽혔다. placeholder는 자동완성 안내문("Tab 또는 space…")이
428
428
  섞여 있어 이름으로 부적절하므로 같은 라벨 문구를 넘긴다. */
@@ -99,6 +99,19 @@
99
99
  * - `WordSearchResultBlock` 툴바 — 드롭다운 둘이 40, 바로 옆 `Pagination` 이 32.
100
100
  * - `FilterPanel` 한 절 안 — 드롭다운 갈래가 40, 고르개 갈래가 32(옆 항목 단추에 맞춘
101
101
  * `size="keyboard"` 가 닻이라 이 수와 함께 움직이지 않는다).
102
+ *
103
+ * ## **테두리 없는 판만 48** (청 (417) · (419), 2026-11-12)
104
+ *
105
+ * 하루에 세 번 바뀌었다 — (417) *"줄이 많으면 40, 적으면 48"* 로 판에 `controlSize` 손잡이를 열었고,
106
+ * (419) *"48 기본, 40 변경 가능"* 으로 뒤집었다가, 화면을 보시고 사장님이 직접 정하셨다:
107
+ * ***"sizecontrol 제거하고 useborder false = 48, useborder true = 40"*** · ***"표는 늘 40"***.
108
+ *
109
+ * - 이 수(공용 수)는 **40** 그대로다. 판 밖 · 표 · 툴바 · 머리의 조절칸은 40.
110
+ * - `Panel` 이 `useBorder={false}` 면 그 안의 조절칸이 **48** — 맥락(`controlSizeContext.ts`)으로 내려간다.
111
+ * 테두리 없는 판은 팝업 안 입력 양식이고(회원앱 21 · 어드민 8), 테두리 있는 판은 카드 목록이다.
112
+ * - `Table` 은 늘 40 — 테두리 없는 판 안에 놓여도 맥락을 40 으로 다시 세운다.
113
+ * - 조절칸은 `size` 를 안 주면 가장 가까운 판의 값, 판 밖이면 이 수. 제 `size` 가 이긴다.
114
+ * - 차트 머리 32(`CHART_HEAD_SIZE`)는 이 길을 안 탄다.
102
115
  */
103
116
  export declare const CONTROL_SIZE = 40;
104
117
  /**
@@ -99,6 +99,19 @@
99
99
  * - `WordSearchResultBlock` 툴바 — 드롭다운 둘이 40, 바로 옆 `Pagination` 이 32.
100
100
  * - `FilterPanel` 한 절 안 — 드롭다운 갈래가 40, 고르개 갈래가 32(옆 항목 단추에 맞춘
101
101
  * `size="keyboard"` 가 닻이라 이 수와 함께 움직이지 않는다).
102
+ *
103
+ * ## **테두리 없는 판만 48** (청 (417) · (419), 2026-11-12)
104
+ *
105
+ * 하루에 세 번 바뀌었다 — (417) *"줄이 많으면 40, 적으면 48"* 로 판에 `controlSize` 손잡이를 열었고,
106
+ * (419) *"48 기본, 40 변경 가능"* 으로 뒤집었다가, 화면을 보시고 사장님이 직접 정하셨다:
107
+ * ***"sizecontrol 제거하고 useborder false = 48, useborder true = 40"*** · ***"표는 늘 40"***.
108
+ *
109
+ * - 이 수(공용 수)는 **40** 그대로다. 판 밖 · 표 · 툴바 · 머리의 조절칸은 40.
110
+ * - `Panel` 이 `useBorder={false}` 면 그 안의 조절칸이 **48** — 맥락(`controlSizeContext.ts`)으로 내려간다.
111
+ * 테두리 없는 판은 팝업 안 입력 양식이고(회원앱 21 · 어드민 8), 테두리 있는 판은 카드 목록이다.
112
+ * - `Table` 은 늘 40 — 테두리 없는 판 안에 놓여도 맥락을 40 으로 다시 세운다.
113
+ * - 조절칸은 `size` 를 안 주면 가장 가까운 판의 값, 판 밖이면 이 수. 제 `size` 가 이긴다.
114
+ * - 차트 머리 32(`CHART_HEAD_SIZE`)는 이 길을 안 탄다.
102
115
  */
103
116
  export const CONTROL_SIZE = 40;
104
117
  /**
@@ -0,0 +1,17 @@
1
+ /**
2
+ * **조절칸 크기를 위에서 내려 주는 자리** — 말귀 청 (419), 2026-11-12.
3
+ *
4
+ * 사장님(직접): *"sizecontrol 제거하고 useborder false = 48, useborder true = 40"* · *"표는 늘 40"*.
5
+ * `Panel` 이 테두리 여부로 48 · 40 을 싣고, `Table` 은 40 으로 다시 세운다. 맥락 밖은 공용 수(40).
6
+ *
7
+ * 조절칸(`Button` · `TextField` · `Dropdown` · `SegmentedControl` · `DatePicker` · `Tabs` · `ColorPicker`)은
8
+ * `size` 를 안 받으면 이 값을 쓴다. 그래서 판 안에 부르는 쪽이 직접 얹은 칸도 함께 따른다.
9
+ * 차례는 **제 값(`size` · `btnSize`) ?? 가장 가까운 판 · 표의 값 ?? 칸의 본래 기본값**
10
+ * (단추 48 · 나머지는 공용 수 40 — 판 밖 모습은 (419) 전과 같다).
11
+ * 차트 카드 머리(`CHART_HEAD_SIZE`, 32)는 이 길을 안 탄다.
12
+ */
13
+ export type ControlSize = 40 | 48;
14
+ /** 판 · 표 밖이면 `undefined` — 그때는 칸마다 제 본래 기본값을 쓴다(단추 48 · 나머지 공용 수 40) */
15
+ export declare const ControlSizeContext: import("react").Context<ControlSize | undefined>;
16
+ /** 가장 가까운 판 · 표가 고른 조절칸 크기 — 그 밖이면 `undefined` */
17
+ export declare function useControlSize(): ControlSize | undefined;
@@ -0,0 +1,8 @@
1
+ 'use client';
2
+ import { createContext, useContext } from 'react';
3
+ /** 판 · 표 밖이면 `undefined` — 그때는 칸마다 제 본래 기본값을 쓴다(단추 48 · 나머지 공용 수 40) */
4
+ export const ControlSizeContext = createContext(undefined);
5
+ /** 가장 가까운 판 · 표가 고른 조절칸 크기 — 그 밖이면 `undefined` */
6
+ export function useControlSize() {
7
+ return useContext(ControlSizeContext);
8
+ }
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export declare const CORE_VERSION = "0.435.0";
49
+ export declare const CORE_VERSION = "0.436.0";
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export const CORE_VERSION = '0.435.0';
49
+ export const CORE_VERSION = '0.436.0';