sellmate-design-system-react 9.0.0-beta.0 → 9.0.0-beta.10

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 (59) hide show
  1. package/AGENTS.md +153 -45
  2. package/README.md +63 -0
  3. package/dist/components/SChipFilter/README.md +2 -1
  4. package/dist/components/SChipFilter/SChipFilter.d.ts +13 -6
  5. package/dist/components/SCircleProgress/README.md +3 -0
  6. package/dist/components/SCircleProgress/SCircleProgress.d.ts +7 -1
  7. package/dist/components/SDatePicker/README.md +41 -3
  8. package/dist/components/SDatePicker/SDatePicker.d.ts +36 -3
  9. package/dist/components/SDatePicker/index.d.ts +1 -1
  10. package/dist/components/SField/README.md +3 -0
  11. package/dist/components/SField/SField.d.ts +12 -0
  12. package/dist/components/SGhostButton/README.md +2 -0
  13. package/dist/components/SGnb/gnb.config.d.ts +2 -0
  14. package/dist/components/SIcon/README.md +4 -0
  15. package/dist/components/SImage/README.md +44 -0
  16. package/dist/components/SImage/SImage.d.ts +41 -0
  17. package/dist/components/SImage/index.d.ts +1 -0
  18. package/dist/components/SKeyValueTable/README.md +1 -0
  19. package/dist/components/SKeyValueTable/SKeyValueTable.d.ts +8 -1
  20. package/dist/components/SList/README.md +0 -1
  21. package/dist/components/SList/SList.d.ts +0 -2
  22. package/dist/components/SPage/README.md +2 -0
  23. package/dist/components/SPage/SPage.d.ts +17 -1
  24. package/dist/components/SPage/index.d.ts +1 -1
  25. package/dist/components/SPage/page.config.d.ts +8 -0
  26. package/dist/components/SSearchInput/README.md +48 -0
  27. package/dist/components/SSearchInput/SSearchInput.d.ts +46 -0
  28. package/dist/components/SSearchInput/index.d.ts +1 -0
  29. package/dist/components/SSectionHeaderCard/README.md +10 -23
  30. package/dist/components/SSectionHeaderCard/SSectionHeaderCard.d.ts +21 -14
  31. package/dist/components/SSectionHeaderCard/index.d.ts +1 -1
  32. package/dist/components/SSelect/README.md +2 -0
  33. package/dist/components/STable/README.md +1 -0
  34. package/dist/components/STable/STable.d.ts +20 -0
  35. package/dist/components/STabs/README.md +0 -1
  36. package/dist/components/STabs/STabs.d.ts +2 -4
  37. package/dist/components/STabs/index.d.ts +1 -1
  38. package/dist/components/STabs/tabs.config.d.ts +3 -4
  39. package/dist/components/STimePicker/timepicker.config.d.ts +5 -0
  40. package/dist/components/SToggle/README.md +1 -0
  41. package/dist/components/SToggle/SToggle.d.ts +4 -1
  42. package/dist/components/STree/README.md +3 -0
  43. package/dist/components/STree/STree.d.ts +8 -0
  44. package/dist/components/STree/index.d.ts +1 -1
  45. package/dist/index.cjs +1545 -359
  46. package/dist/index.cjs.map +1 -1
  47. package/dist/index.d.ts +2 -0
  48. package/dist/index.js +1540 -360
  49. package/dist/index.js.map +1 -1
  50. package/dist/lib/truncated-value-tooltip.d.ts +18 -0
  51. package/dist/llms-full.txt +300 -69
  52. package/dist/llms.txt +157 -48
  53. package/dist/styles.css +201 -32
  54. package/dist/theme.css +34 -11
  55. package/eslint/index.mjs +5 -0
  56. package/eslint/rules/field-width-grade.d.mts +41 -0
  57. package/eslint/rules/field-width-grade.mjs +294 -0
  58. package/eslint/scale.gen.mjs +1 -1
  59. package/package.json +1 -1
@@ -35,12 +35,12 @@
35
35
  | 분류 | 컴포넌트 |
36
36
  | --- | --- |
37
37
  | **버튼·링크** | `SButton` `SGhostButton` `SDropdownButton` `STextLink` `SSwitch` `SToggle` |
38
- | **입력 (폼)** | `SForm` `SField` `SInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
39
- | **날짜·시간** | `SCalendar` `SDatePicker` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
38
+ | **입력 (폼)** | `SForm` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
39
+ | **날짜·시간** | `SCalendar` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
40
40
  | **표·목록** | `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SListItem` `SExpansionList` `SDraggableList` `SDraggableItem` `STree` |
41
41
  | **레이아웃** | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) `SSectionHeaderCard` `SCard` `SDivider` `SSplitter` `SScrollArea` `SExpansionItem` |
42
42
  | **내비게이션** | `STabs` `SPagination` `SStepper` |
43
- | **표시·상태** | `STag` `SBadge` `SIcon` `SCallout` `SGuide` |
43
+ | **표시·상태** | `STag` `SBadge` `SIcon` `SImage` `SCallout` `SGuide` |
44
44
  | **진행·로딩** | `SLinearProgress` `SCircleProgress` `SLoadingContainer` `SLoadingModal` |
45
45
  | **오버레이** | `STooltip` `SPopover` `SPopup` `SDrawer` `SPortal` |
46
46
  | **모달** | `SModal.confirm()` `SModal.create()` + `SActionModal` `SConfirmModal` `SModalOutlet`(앱 루트 1회) |
@@ -68,6 +68,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
68
68
  | --- | --- |
69
69
  | `<button>` | `SButton`, `SGhostButton`, `SDropdownButton`, `STextLink` |
70
70
  | `<input type="text/password/...">` | `SInput` |
71
+ | `<input type="search">` | `SSearchInput` |
71
72
  | `<input type="number">` | `SNumberInput` |
72
73
  | `<input type="checkbox">` | `SCheckbox`, `SToggle`, `SSwitch` |
73
74
  | `<input type="radio">` | `SRadio`, `SRadioButton` |
@@ -80,7 +81,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
80
81
  | `alert()`, `confirm()` | `SToast`, `SModal.confirm(...)` |
81
82
  | 직접 만든 탭/페이지네이션/스텝퍼 | `STabs`, `SPagination`, `SStepper` |
82
83
  | `<ul>`/`<li>` 로 만든 목록 UI | `SList` + `SListItem` (드래그 정렬은 `SDraggableItem`) |
83
- | 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard` + `.Header` / `.Body` |
84
+ | 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard` 의 `title` / `padding` props |
84
85
  | `<svg>` 직접 삽입, 이모지 아이콘 | `SIcon` |
85
86
  | `<hr>` | `SDivider` |
86
87
  | `<details>` / `<summary>` | `SExpansionItem` |
@@ -146,7 +147,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
146
147
  | --- | --- | --- |
147
148
  | **셸** | 앱 전체 뼈대. 페이지가 바뀌어도 남는다 | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) |
148
149
  | **블록** | `SPage` 의 직계 자식. 페이지를 세로로 쌓는 단위 | `SSectionHeaderCard` `SCard` `SForm` `SSplitter` `SScrollArea` `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SExpansionList` `SDraggableList` `STree` `SCallout` `STabs` `SStepper` `SPagination` `SDivider` |
149
- | **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `SButton` `SGhostButton` `SDropdownButton` `SField` `SInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SSwitch` `SToggle` `SChipInput` `SBarcodeInput` `SFilePicker` `SDatePicker` `SDateRangePicker` `STimePicker` `STimeRangePicker` `SCalendar` `SListItem` `SExpansionItem` `SDraggableItem` `SLinearProgress` `SCircleProgress` |
150
+ | **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `SButton` `SGhostButton` `SDropdownButton` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SSwitch` `SToggle` `SChipInput` `SBarcodeInput` `SFilePicker` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` `SCalendar` `SListItem` `SExpansionItem` `SDraggableItem` `SImage` `SLinearProgress` `SCircleProgress` |
150
151
  | **인라인** | 텍스트 흐름·셀·라벨 안에 섞인다. 혼자 블록이 되지 않는다 | `STag` `SBadge` `SIcon` `STextLink` `SChip` |
151
152
  | **레이어** | 문서 흐름 **밖**에 떠서 그려진다. 어느 층에서 띄우든 레이아웃에 영향이 없다 | `SModal` `SActionModal` `SConfirmModal` `SPopup` `SDrawer` `SPopover` `STooltip` `SPortal` `SToast` `SLoadingModal` `SLoadingContainer` `SGuide` |
152
153
 
@@ -166,7 +167,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
166
167
  | 담는 것 | 올 수 있는 것 | 오면 안 되는 것 |
167
168
  | --- | --- | --- |
168
169
  | `SPage` | **블록만** | **요소를 직접** — 버튼 하나도 블록에 담아 놓는다 |
169
- | `SSectionHeaderCard.Body` | 그리는 블록 · 요소 | `SSectionHeaderCard` · `SCard` (카드 겹침, §3-7-8) |
170
+ | `SSectionHeaderCard` 의 `children` | 그리는 블록 · 요소 | `SSectionHeaderCard` · `SCard` (카드 겹침, §3-7-8) |
170
171
  | `SCard` | 그리는 블록 · 요소 | `SCard` · `SSectionHeaderCard` |
171
172
  | `SForm` | 블록 (보통 `SKeyValueTable` + 하단 액션) | — |
172
173
  | `SSplitter.Before` / `.After` | 블록 | — |
@@ -230,7 +231,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
230
231
 
231
232
  페이지 제목만 18px 로 크게 두고 그 아래는 14 / 12 로 촘촘하게 간다. 중간 크기(16px)는 기본 골격에서 쓰지 않는다.
232
233
 
233
- - **페이지·섹션 제목의 타이포를 직접 주지 않는다.** `SPage` 의 `header.title`, `SSectionHeaderCard.Header` 의 `title` 이 이미 넣는다 — 그 위에 `typo-heading-lg`/`typo-heading-sm` 을 또 씌우지 않는다.
234
+ - **페이지·섹션 제목의 타이포를 직접 주지 않는다.** `SPage` 의 `header.title`, `SSectionHeaderCard` 의 `header.title` 이 이미 넣는다 — 그 위에 `typo-heading-lg`/`typo-heading-sm` 을 또 씌우지 않는다.
234
235
  - **하위 제목이 필요하면 먼저 섹션을 나눌 수 없는지 본다.** 한 섹션 안에서 제목이 두 단으로 갈린다는 것은 대개 섹션이 둘이라는 뜻이다 (§3-7-8).
235
236
  - 본문 안에서 한 단어를 강조할 때는 `typo-body-sm-medium` 을 쓴다. `typo-body-sm-bold` 는 제목 성격의 짧은 라벨에만 쓴다. <!-- TODO(디자인): 강조 굵기 기준 확정 -->
236
237
 
@@ -300,7 +301,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
300
301
 
301
302
  **페이지 프레임은 예외 없이 `SPage` 가 넣는다.** 아래 규칙은 그 안의 **섹션·패널 레벨에만** 적용된다.
302
303
 
303
- **컴포넌트가 자체 여백을 가지면 컴포넌트 기준이 우선한다.** `SKeyValueTable`·`STable` 처럼 자기 여백을 토큰으로 갖고 있는 컴포넌트에는 이 판정을 적용하지 않는다 — 손댈 것이 없다. 아래 판정이 필요한 자리는 **직접 만든 컨테이너**와 **`SSectionHeaderCard.Body`** 두 곳뿐이다.
304
+ **컴포넌트가 자체 여백을 가지면 컴포넌트 기준이 우선한다.** `SKeyValueTable`·`STable` 처럼 자기 여백을 토큰으로 갖고 있는 컴포넌트에는 이 판정을 적용하지 않는다 — 손댈 것이 없다. 아래 판정이 필요한 자리는 **직접 만든 컨테이너**와 **`SSectionHeaderCard` 의 `padding`** 두 곳뿐이다.
304
305
 
305
306
  판정은 **그 영역이 담고 있는 콘텐츠 덩어리의 종류 수**로 한다.
306
307
 
@@ -335,14 +336,47 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
335
336
 
336
337
  **중첩되면 안쪽 여백을 주지 않는다.** 24 영역 안에 또 여백을 주면 가장자리가 40 으로 벌어져 한 면적처럼 읽힌다. 안쪽 카드·목록이 **배경색이 다르거나 테두리가 있어** 경계가 스스로 보이는 경우에만 자기 여백을 유지한다.
337
338
 
338
- `SSectionHeaderCard.Body` 는 이 규칙을 **prop 으로 받는다** — 직접 `p-sd-*` 를 주지 않는다.
339
+ `SSectionHeaderCard` 는 이 규칙을 **`padding` prop 으로 받는다** — 직접 `p-sd-*` 를 주지 않는다.
339
340
 
340
341
  ```tsx
341
- <SSectionHeaderCard.Body>…</SSectionHeaderCard.Body> {/* 기본 = 16 */}
342
- <SSectionHeaderCard.Body padding="wide">…</SSectionHeaderCard.Body> {/* 3종류 이상 */}
343
- <SSectionHeaderCard.Body padding="none">…</SSectionHeaderCard.Body> {/* 표를 가장자리까지 */}
342
+ <SSectionHeaderCard title="기본 정보">…</SSectionHeaderCard> {/* 기본 = 16 */}
343
+ <SSectionHeaderCard title="기본 정보" padding="wide">…</SSectionHeaderCard> {/* 3종류 이상 */}
344
+ <SSectionHeaderCard title="기본 정보" padding="none">…</SSectionHeaderCard> {/* 표를 가장자리까지 */}
344
345
  ```
345
346
 
347
+ ##### 카드 가장자리까지 채우는 표는 자기 테두리를 끈다
348
+
349
+ 여기서 "표"는 **`STable` 과 `SKeyValueTable` 둘 다**다. 두 컴포넌트 모두 자기 바깥 테두리를 그리는데, 카드도 바깥 테두리를 그린다. `padding="none"` 으로 붙이면 **1px 두 개가 나란히 놓여 그 변만 2px** 로 보인다(카드의 다른 변은 1px 그대로라 굵기가 어긋난다).
350
+
351
+ ```tsx
352
+ <SSectionHeaderCard title="발주 내역" padding="none">
353
+ <SKeyValueTable fields={…} bordered={false} radius="useTop" />
354
+ <STable columns={…} rows={…} bordered={false} radius="useTop" />
355
+ </SSectionHeaderCard>
356
+ ```
357
+
358
+ - **`bordered={false}`** 로 표의 테두리를 끈다. 카드가 이미 그린다.
359
+ - **`radius="useTop"`** 으로 위쪽 모서리를 죽인다. 아래쪽 라운드는 카드가 처리한다.
360
+ - `STable` 은 **페이지네이션 바의 테두리와 `-mt-px` 겹침도 함께 꺼진다** — 본문 테두리가 없으면 겹칠 대상이 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다.
361
+
362
+ #### 본문 바탕 눌러앉히기 (선택)
363
+
364
+ `SSectionHeaderCard` 는 **`background="neutral"`** 로 본문 바탕을 한 단계 눌러앉힐 수 있다. 흰 면 덩어리(표·리스트)가 여럿일 때 그 덩어리들이 **"면 위에 놓인 객체"로 읽혀 묶음이 더 강하게 보인다.**
365
+
366
+ ```tsx
367
+ <SSectionHeaderCard title="발주 상세" background="neutral">…흰 면 표 여럿…</SSectionHeaderCard>
368
+ ```
369
+
370
+ **기본값(`frame`, 흰 면)이 틀린 것이 아니다.** 이 저장소의 표·리스트는 테두리·라운드·헤더 줄과 `gap-sd-12` 를 이미 갖고 있어 흰 바탕에서도 경계가 읽힌다. 위계를 한 단계 더 주고 싶을 때 고르는 수단이지, 덩어리가 둘 이상이면 반드시 깔아야 하는 규칙이 아니다.
371
+
372
+ 깔아도 **효과가 없는** 자리는 있다.
373
+
374
+ - **덩어리가 가장자리까지 차는 경우** — `padding="none"` 으로 표를 채우면 깐 바탕이 표에 완전히 가려 보이지 않는다.
375
+ - **덩어리에 회색 면이 섞인 경우** — 그 덩어리가 바탕과 같은 색이 되어 묻힌다.
376
+ - **맨 텍스트·폼 컨트롤만 있는 본문** — 떠오를 흰 면이 없다.
377
+
378
+ 바탕을 깐 경우, 표 사이 구분선(`SDivider`)은 대개 불필요해진다 — 색이 이미 경계를 만든다.
379
+
346
380
  #### 스크롤 영역의 하단 여백
347
381
 
348
382
  스크롤을 끝까지 내렸을 때 마지막 항목이 화면 경계에 붙으면 **목록이 끝난 것인지 더 있는 것인지** 읽히지 않는다. 그래서 스크롤 영역은 **하단만** 넓게 둔다. 나머지 세 방향은 위 16 / 24 규칙 그대로다.
@@ -352,7 +386,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
352
386
  | **패널 자체 스크롤** (좌측 목록, 중앙 대화 등) | 그 패널 안쪽 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` — `SPage` 와 같은 토큰이라 값이 바뀌어도 함께 따라간다 |
353
387
  | **페이지 단위 스크롤** | **`SPage` 가 넣는다. 직접 주지 않는다** |
354
388
 
355
- `SPage` 는 기본으로 넣으므로 **아무것도 하지 않으면 맞다.** 끄는 경우는 하나뿐이다 — **페이지네이션이 붙은 테이블.** 페이지네이션이 이미 "여기서 끝"을 알려주므로 `scrollEndSpacing={false}` 로 끈다 (§4-2 목록 페이지).
389
+ `SPage` 는 기본으로 넣으므로 **아무것도 하지 않으면 맞다.** 직접 끌 일은 없다 — **페이지네이션이 붙은 테이블**은 `contentHeight="fill"` 을 쓰고, 이 모드에서는 페이지가 스크롤하지 않아 스크롤 끝 여백이 **자동으로 무시**된다 (§4-2 목록 페이지).
356
390
 
357
391
  ### 2-3. 색상
358
392
 
@@ -414,6 +448,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
414
448
  | --- | --- | --- |
415
449
  | 한 줄 텍스트를 받는다 | `SInput` | §3-7-1 |
416
450
  | 여러 줄 텍스트를 받는다 | `STextarea` | §3-7-1 |
451
+ | 목록·결과를 검색어로 좁힌다 | `SSearchInput` | §3-7-1 |
417
452
  | 숫자(수량·금액)를 받는다 | `SNumberInput` | |
418
453
  | 바코드를 스캔해 받는다 | `SBarcodeInput` | |
419
454
  | 목록에서 하나 고르게 한다 | `SSelect` | §3-7-2 |
@@ -427,6 +462,8 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
427
462
  | 입력된 값 하나를 지우거나 고치게 한다 | `SChip` | §3-1 |
428
463
  | 파일을 받는다 | `SFilePicker` | |
429
464
  | 날짜 하나를 받는다 | `SDatePicker` | §3-7-4 |
465
+ | 연도 선택 리스트만 커스텀 조합에 넣는다 | `SDatePickerYearListbox` | §3-7-4 |
466
+ | 연도+월 선택 리스트만 커스텀 조합에 넣는다 | `SDatePickerMonthListbox` | §3-7-4 |
430
467
  | 날짜 기간을 받는다 | `SDateRangePicker` | §3-7-4 |
431
468
  | 시각 하나를 받는다 | `STimePicker` | |
432
469
  | 시각 범위를 받는다 | `STimeRangePicker` | |
@@ -450,6 +487,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
450
487
  | 상태·분류를 라벨로 찍는다 | `STag` | §3-1 |
451
488
  | 색 점만으로 상태를 찍는다 | `SBadge` | §3-1 |
452
489
  | 아이콘을 넣는다 | `SIcon` | |
490
+ | 사진·썸네일을 보여준다 (로딩·실패 상태 포함) | `SImage` | §3-7-12 |
453
491
  | 문장 안에서 다른 화면으로 보낸다 | `STextLink` | §3-5-6 |
454
492
 
455
493
  #### C. 동작을 실행시킨다
@@ -557,9 +595,26 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
557
595
  | | 무엇인가 | 크기 |
558
596
  | --- | --- | --- |
559
597
  | **SPopup** | **별도 브라우저 창** (`window.open` 으로 여는 전용 라우트) | 창 크기 = 콘텐츠 크기 |
560
- | **SActionModal** | 같은 창 위 오버레이 카드 | `width` / `height` prop |
598
+ | **SActionModal** | 같은 창 위 오버레이 카드 | `width` prop. **높이는 주지 않는다** (아래) |
561
599
  | **SModal.confirm** (`SConfirmModal`) | 같은 창 위 확인창 | 고정 |
562
600
 
601
+ ##### 모달 높이는 내용이 정하고, 상한은 시스템이 건다
602
+
603
+ **`height` 를 주지 않는다.** 높이는 내용이 정하고, 카드는 **뷰포트의 85%** 에서 멈춘다(시스템이 모든 모달에 건다). 데이터가 적으면 내용만큼 작아지고, 많으면 85% 에서 멈춘다.
604
+
605
+ 가로는 좌우 24px 씩을 뺀 값으로 클램핑하는데 **세로만 비율**인 이유는, 모달이 화면을 거의 다 덮으면 뒤 맥락이 사라져 "떠 있는 것"으로 읽히지 않기 때문이다.
606
+
607
+ **상한에 닿았을 때 스크롤되어야 하는 것은 모달 본문이 아니라 표다.**
608
+
609
+ ```tsx
610
+ <SActionModal modalTitle="발주 검토" button={{ label: '확정', onClick: submit }}>
611
+ {/* 표가 남은 높이를 먹고 자기 안에서 스크롤한다 — 헤더·합계·푸터는 늘 보인다 */}
612
+ <STable className="min-h-0 flex-1" columns={columns} rows={rows} />
613
+ </SActionModal>
614
+ ```
615
+
616
+ 본문(`overflow-auto` 영역)이 통째로 스크롤되면 표 헤더와 합계 줄이 위로 밀려 사라진다. `SActionModal` 의 본문은 이미 `min-h-0 flex-1` 이므로, 표에 `min-h-0 flex-1` 을 주면 세로 축이 이어져 표만 스크롤한다 (§4-2 목록 페이지와 같은 사슬이다).
617
+
563
618
  **성격이 먼저 둘로 갈린다.**
564
619
 
565
620
  | 성격 | 정의 | 컴포넌트 |
@@ -747,6 +802,7 @@ const columns: STableColumn[] = [
747
802
 
748
803
  컬럼 폭은 `width` 로 **고정**되고, `<td>` 는 그 폭을 넘는 내용을 잘라낸다(`overflow: hidden`). 텍스트라면 말줄임으로 끝나지만, 셀에 `STag` · `SButton` · `SGhostButton` · `SSelect` · `SInput` · `SNumberInput` 처럼 **자기 폭을 가진 요소**를 넣으면 요소 자체가 잘려 **누르거나 읽거나 입력할 수 없게 된다.** `width` 를 생략해도 내용에 맞춰 늘어나지 않고 `STable` 의 기본 폭이 될 뿐이므로, 컨트롤이 들어가는 컬럼은 폭을 직접 판단해서 준다.
749
804
 
805
+ - **컨트롤이 들어가는 컬럼에는 `contentType: 'control'` 을 함께 준다.** 좌우 패딩이 텍스트용(넓게)에서 컨트롤용(좁게)으로 바뀌어, 같은 컬럼 폭에서도 요소가 쓸 폭이 넓어진다. 기본값은 `text` 다.
750
806
  - 기준은 **요소가 온전히 보이는 폭 + 셀 좌우 패딩**이다. 좌우 패딩은 `STable` 이 토큰으로 넣으므로(직접 주지 않는다) 그만큼을 뺀 나머지가 요소 몫이라는 점을 계산에 넣는다.
751
807
  - 요소가 둘 이상이면 요소 폭의 합에 **`gap` 까지** 더한다 (행 내부 인라인 액션 간격은 `gap-sd-4` 고정, §3-5-5).
752
808
  - 값에 따라 폭이 달라지는 요소(`STag` 라벨, 라벨 있는 버튼)는 **가장 긴 값** 기준으로 잡는다. `판매중` 에 맞춰두면 `판매중지 요청` 에서 잘린다.
@@ -754,6 +810,13 @@ const columns: STableColumn[] = [
754
810
  - 폭을 넉넉히 줄 수 없는 자리는 폭을 줄이는 게 아니라 **요소를 바꾼다** — 라벨 버튼 대신 아이콘만 있는 `SGhostButton`, `size="xs"` (§3-5-2, §3-5-5).
755
811
  - **`autoWidth` 는 해법이 아니다.** 내용에 맞춰 늘어나는 게 아니라 고정폭 컬럼들이 가져가고 **남은 폭을 나눠 갖는 것**이라, 테이블이 좁으면 역시 잘린다. 컨트롤 컬럼은 `width` 로 직접 확보한다.
756
812
 
813
+ ```tsx
814
+ { name: 'normal', label: '정상', field: 'normal', width: '96px',
815
+ align: 'center', contentType: 'control', render: row => <SNumberInput … /> },
816
+ ```
817
+
818
+ **셀 좌우 여백은 내용이 정한다.** 텍스트는 넓게, 컨트롤은 좁게다 — `SKeyValueTable` 은 `field.type` 으로 이 판정을 스스로 하지만, `STable` 의 셀은 소비 앱이 넘긴 임의의 `render` 결과라 컴포넌트가 알 수 없다. 그래서 `contentType` 으로 알려준다. 여백 값 자체는 토큰이 정하므로 `tdClass` 로 패딩을 직접 덮어쓰지 않는다.
819
+
757
820
  **`resizable` 테이블이면 `minWidth` 를 함께 준다.** resize 하한 기본값은 어떤 컨트롤도 담지 못할 만큼 작아, 사용자가 끝까지 끌면 그대로 잘린다. `width` 를 정한 근거와 같은 값을 하한으로 둔다 — 텍스트 컬럼과 달리 여기서는 더 줄일 여지가 없다.
758
821
 
759
822
  ```tsx
@@ -966,16 +1029,19 @@ const columns: STableColumn[] = [
966
1029
 
967
1030
  > §3-0 라우팅에서 이 절을 가리키는 자리들이다. <!-- TODO(디자인): 전체 검수·확정 -->
968
1031
 
969
- #### 3-7-1. SInput vs STextarea
1032
+ #### 3-7-1. SInput vs STextarea vs SSearchInput
970
1033
 
971
- **줄 수가 아니라 값의 성격으로 고른다.** 값의 길이를 미리 알 수 있으면 `SInput`, 없으면 `STextarea` 다.
1034
+ **먼저 "그 값이 저장되는가"를 본다.** 저장되면 폼 필드(`SInput`·`STextarea`), 화면을 좁히기만 하고 사라지면 `SSearchInput` 이다.
972
1035
 
973
1036
  | 값 | 사용 |
974
1037
  | --- | --- |
975
1038
  | 이름·코드·전화번호·URL 처럼 형식이 정해진 값 | `SInput` |
976
1039
  | 메모·사유·설명처럼 길이가 예측되지 않는 문장 | `STextarea` |
1040
+ | 지금 보이는 목록·결과를 좁히는 검색어 | `SSearchInput` |
1041
+
1042
+ 폼 필드 둘은 **줄 수가 아니라 값의 성격으로** 갈린다. 값이 길어질 수 있는데 `SInput` 을 쓰면 사용자가 자기가 쓴 것을 다시 읽지 못한다 — 한 줄 안에서 좌우로 스크롤해야 하기 때문이다. 반대로 짧은 값에 `STextarea` 를 쓰면 빈 공간이 남아 입력량을 잘못 기대하게 한다.
977
1043
 
978
- 값이 길어질 수 있는데 `SInput` 을 쓰면 사용자가 자기가 쓴 것을 다시 읽지 못한다 — 한 줄 안에서 좌우로 스크롤해야 하기 때문이다. 반대로 짧은 값에 `STextarea` 를 쓰면 빈 공간이 남아 입력량을 잘못 기대하게 한다.
1044
+ `SSearchInput` 은 폼 필드가 아니다 — 라벨·힌트·유효성 규칙·에러 메시지를 받지 않고, `SForm` 의 제출 검증 대상에도 들어가지 않는다. 돋보기 아이콘이 항상 앞에 붙어 "여기는 검색"임을 스스로 밝히므로 라벨을 따로 붙이지 않는다. 검색 실행은 `onSearch`(Enter) 로 받고, 값이 바뀔 때마다 좁히는 실시간 필터라면 `onValueChange` 만 쓴다. 반대로 검색어를 **저장하거나 검증해야 한다면** 그것은 폼 값이므로 `SInput` 이다.
979
1045
 
980
1046
  #### 3-7-2. 하나를 고르게 하는 다섯 — SSelect vs SRadioGroup vs SRadioButton vs STabs vs SRadio
981
1047
 
@@ -1012,11 +1078,25 @@ const columns: STableColumn[] = [
1012
1078
  | 판별 | 사용 |
1013
1079
  | --- | --- |
1014
1080
  | 날짜 **하나**를 값으로 받는다 | `SDatePicker` |
1081
+ | 연도 선택 리스트만 필요하다 (트리거·팝오버는 직접 조합) | `SDatePickerYearListbox` |
1082
+ | 연도+월 선택 리스트만 필요하다 (트리거·팝오버는 직접 조합) | `SDatePickerMonthListbox` |
1015
1083
  | **시작~종료** 를 값으로 받는다 | `SDateRangePicker` |
1016
1084
  | 달력 격자 **자체가 화면 콘텐츠** 다 (일정·이벤트 보기) | `SCalendar` |
1017
1085
 
1018
1086
  - **기간을 `SDatePicker` 두 개로 만들지 않는다.** 시작이 종료보다 뒤인 입력을 막는 검증과 한쪽만 고른 중간 상태 처리가 `SDateRangePicker` 안에 이미 있다. 두 개로 쪼개면 그게 전부 앱 몫이 된다.
1019
1087
  - `SDatePicker`·`SDateRangePicker` 는 내부적으로 `SCalendar` 를 팝오버로 띄운다. 값을 받는 자리에 `SCalendar` 를 직접 쓰지 않는다.
1088
+ - `SDatePickerYearListbox`·`SDatePickerMonthListbox` 는 `SDatePicker` 의 mode listbox 조각만 떼어낸 컴포넌트다. 일반 폼 입력에는 `SDatePicker mode="year" | "month"` 를 우선 쓰고, 다른 트리거·팝오버 안에 리스트만 끼워 넣을 때만 직접 쓴다.
1089
+
1090
+ **날짜·시간 피커는 폭 상한을 스스로 갖는다 — `width` 를 주지 않는다.** 값 길이가 `YYYY-MM-DD` 처럼 정해져 있어 컴포넌트가 사이즈별 상한을 안다. `SKeyValueTable` 이 모든 컨트롤에 `width="100%"` 를 넘기지만, 이 상한 덕분에 행 전체로 늘어나지 않고 제 폭에서 멈춘다.
1091
+
1092
+ | 컴포넌트 | `size="sm"` | `size="md"` |
1093
+ | --- | --- | --- |
1094
+ | `SDatePicker` | md | lg |
1095
+ | `SDateRangePicker` | lg | xl |
1096
+ | `STimePicker` | md | lg |
1097
+ | `STimeRangePicker` | md | lg (오전/오후 표시는 두 사이즈 모두 lg) |
1098
+
1099
+ `SDateRangePicker` 가 한 등급씩 위인 것은 값이 `YYYY-MM-DD ~ YYYY-MM-DD` 로 두 배가 넘기 때문이다. 같은 이유로 `STimeRangePicker` 의 오전/오후 모드도 sm 에서 한 등급 위를 쓴다 — 그 모드의 최소 폭이 md 등급을 이미 넘어, 그대로 두면 하한이 상한을 넘어 상한이 무력해진다.
1020
1100
 
1021
1101
  #### 3-7-5. SField 를 직접 쓰는 경우
1022
1102
 
@@ -1064,7 +1144,7 @@ const columns: STableColumn[] = [
1064
1144
 
1065
1145
  - 페이지 골격에서 콘텐츠를 묶는 섹션은 **사실상 전부 `SSectionHeaderCard`** 다 (§4-4·§4-5). 제목·필수 표시·도움말·헤더 우측 액션이 전부 여기 붙는다.
1066
1146
  - **카드 안에 카드를 겹치지 않는다.** 섹션 안을 더 나눠야 하면 `SDivider` 로 끊거나(§3-6) 섹션을 둘로 분리한다.
1067
- - 안쪽 여백은 `SSectionHeaderCard.Body` 의 `padding` prop 으로 준다 — `p-sd-*` 를 직접 주지 않는다 (§2-2).
1147
+ - 안쪽 여백은 `SSectionHeaderCard` 의 `padding` prop 으로 준다 — `p-sd-*` 를 직접 주지 않는다 (§2-2).
1068
1148
 
1069
1149
  #### 3-7-9. SLinearProgress vs SCircleProgress
1070
1150
 
@@ -1093,6 +1173,23 @@ const columns: STableColumn[] = [
1093
1173
  - 검색 실행 시점이 다르다 — `SKeyValueTable` 필터는 앱이 검색 버튼을 직접 놓지만, `SChipFilter` 는 편집 팝오버가 닫히거나 "검색" 을 누를 때 `onSearch` 가 값 맵과 함께 호출된다. 값이 바뀌지 않았으면 호출되지 않는다.
1094
1174
  - 함께 걸어야 하는 조건(예: 기간 중 하나는 필수)이 있으면 `fields` 를 그룹으로 넘긴다. 규칙을 못 채운 동안 경고 툴팁이 떠 있고 `onSearch` 가 막힌다.
1095
1175
 
1176
+ #### 3-7-12. 이미지 — SImage
1177
+
1178
+ 사진·썸네일은 `<img>` 를 직접 쓰지 않고 `SImage` 를 쓴다. **로딩·실패 상태를 컴포넌트가 이미 처리하기 때문이다.**
1179
+
1180
+ - **로딩 스피너와 실패 표시를 앱이 만들지 않는다.** `src` 가 없거나 로드에 실패하면 빈 이미지 아이콘이, 로딩 중에는 스피너가 자동으로 놓인다. 크기는 상자 높이에 비례하므로 썸네일이든 큰 미리보기든 따로 맞출 것이 없다.
1181
+ - **크기는 `ratio` 와 너비로 준다.** `ratio` 기본값이 `1`(정사각형)이라 너비만 주면 정사각형이 된다. `className`/`style` 로 높이를 직접 주면 그쪽이 이기고 `ratio` 는 무시된다.
1182
+ - 상자를 채우는 방식은 `fit`(기본 `cover`), 붙는 위치는 `position` 이다. 안쪽 `<img>` 에 네이티브 속성이 필요하면 `imgProps` 로 넘긴다 — 목록에서 고스트 드래그를 막는 `imgProps={{ draggable: false }}` 가 대표적이다.
1183
+ - 썸네일이 많은 목록에서는 `loadingShowDelay` 를 준다. 캐시된 이미지가 즉시 로드될 때 스피너가 한 프레임 번쩍이는 것을 막는다.
1184
+
1185
+ ```tsx
1186
+ ✅ <SImage src={item.thumbnailUrl} alt={item.name} style={{ width: 64 }} /> {/* 정사각 썸네일 */}
1187
+ ✅ <SImage src={banner} ratio={16 / 9} className="w-full" /> {/* 가로형 배너 */}
1188
+
1189
+ ❌ <img src={item.thumbnailUrl} /> {/* 로딩·실패 상태가 없다 */}
1190
+ ❌ {loading ? <SCircleProgress indeterminate /> : <SImage src={url} />} {/* SImage 가 이미 한다 */}
1191
+ ```
1192
+
1096
1193
  ---
1097
1194
 
1098
1195
  ## 4. 페이지 레시피 — 표준 골격
@@ -1119,15 +1216,27 @@ export default function AppShell({
1119
1216
  children,
1120
1217
  header,
1121
1218
  scrollEndSpacing,
1122
- }: { children: React.ReactNode; header?: SPageHeaderProps; scrollEndSpacing?: boolean }) {
1219
+ contentHeight,
1220
+ }: {
1221
+ children: React.ReactNode;
1222
+ header?: SPageHeaderProps;
1223
+ scrollEndSpacing?: boolean;
1224
+ contentHeight?: SPageContentHeight;
1225
+ }) {
1123
1226
  return (
1124
1227
  <SLayout type="box" header="fix">
1125
1228
  {/* type/header/folded 는 SLayout 에만 준다 — SGnb 는 context 에서 읽는다 */}
1126
1229
  <SGnb items={MENU} value={current} onValueChange={navigate} logo={<Logo />} />
1127
1230
  {/* 콘텐츠 패딩은 SPage 가 토큰으로 넣는다 — p-sd-* 로 덮어쓰지 않는다 */}
1128
1231
  {/* 스크롤 끝 여백도 SPage 가 넣는다. 끄는 건 페이지네이션 있는 목록뿐이라 페이지가 정한다 */}
1232
+ {/* 본문이 남은 높이를 채우는 목록 페이지는 contentHeight="fill" 을 넘긴다 (§4-2) */}
1129
1233
  {/* header 는 페이지마다 달라 AppShell 이 그대로 받아 넘긴다 — 페이지 제목은 여기서 만들지 않는다 */}
1130
- <SPage background="frame" scrollEndSpacing={scrollEndSpacing} header={header}>
1234
+ <SPage
1235
+ background="frame"
1236
+ scrollEndSpacing={scrollEndSpacing}
1237
+ contentHeight={contentHeight}
1238
+ header={header}
1239
+ >
1131
1240
  {children}
1132
1241
  </SPage>
1133
1242
  </SLayout>
@@ -1169,7 +1278,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
1169
1278
 
1170
1279
  **최소 너비는 `SLayout` 이 보장한다 — 앱이 `min-w-*` 를 직접 주지 않는다.** 창이 최소 너비(`SLAYOUT_MIN_WIDTH`, GNB 포함한 전체 기준)보다 좁아지면 GNB·상단바는 제자리에 남고 **`SPage` 안에만 가로 스크롤이 생긴다.** 문서(브라우저 창)에는 가로 스크롤이 생기지 않는다. 그래서 셸을 감싸는 요소에 `min-width` 나 `overflow-x` 를 걸지 않는다 — 걸면 창 전체가 스크롤되어 GNB 가 화면 밖으로 밀린다.
1171
1280
 
1172
- **셸의 `SPage` 는 모든 페이지가 공유하므로, 스크롤 끝 여백을 끄려면 페이지가 셸에 알려야 한다.** 위처럼 프레임 컴포넌트가 `scrollEndSpacing` 을 받아 그대로 넘기고, 페이지네이션이 있는 목록 페이지만 `false` 를 준다 (§4-2). 나머지 페이지는 넘기지 않으면 기본값(켬)이 적용된다.
1281
+ **셸의 `SPage` 는 모든 페이지가 공유하므로, 페이지마다 달라지는 것은 페이지가 셸에 알려야 한다.** 위처럼 프레임 컴포넌트가 `scrollEndSpacing` · `contentHeight` 를 받아 그대로 넘기고, 페이지네이션이 있는 목록 페이지만 `contentHeight="fill"` 을 준다 (§4-2). 나머지 페이지는 넘기지 않으면 기본값(`auto`, 스크롤 끝 여백 켬)이 적용된다.
1173
1282
 
1174
1283
  **상단바 배치는 `header` 가 정한다.** 요소 순서가 달라지므로 슬롯을 채우기 전에 어느 쪽인지부터 정한다.
1175
1284
 
@@ -1191,7 +1300,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
1191
1300
  topContent={
1192
1301
  /* 남는 폭 전체를 받는다 — 왼쪽은 그대로, 오른쪽 끝은 ml-auto */
1193
1302
  <div className="flex w-full items-center gap-sd-8">
1194
- <SInput value={keyword} onValueChange={setKeyword} placeholder="통합 검색" />
1303
+ <SSearchInput value={keyword} onValueChange={setKeyword} onSearch={runSearch} placeholder="통합 검색" />
1195
1304
  <SButton size="sm" color="neutral" outline label="내 계정" className="ml-auto" onClick={openAccount} />
1196
1305
  </div>
1197
1306
  }
@@ -1208,7 +1317,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
1208
1317
  {/* 접히면 menuTop·menuFooter 가 함께 빠지므로, 폴드 레일에 남길 것만 foldedTop 으로 따로 준다 */}
1209
1318
  <SGnb
1210
1319
  items={MENU} value={current} onValueChange={navigate} useRail
1211
- menuTop={<SInput value={keyword} onValueChange={setKeyword} placeholder="메뉴 검색" />}
1320
+ menuTop={<SSearchInput value={keyword} onValueChange={setKeyword} placeholder="메뉴 검색" />}
1212
1321
  menuFooter={<AccountRow />}
1213
1322
  foldedTop={<SGhostButton icon="search" size="sm" ariaLabel="메뉴 검색" onClick={openSearch} />}
1214
1323
  />
@@ -1227,7 +1336,9 @@ import { SModalOutlet } from 'sellmate-design-system-react';
1227
1336
  - **페이지 제목 줄에는 이 페이지의 주요 액션을 두지 않는다.** 부가적인 것만 `header.slot` 에 `SButton size="sm"` 으로 온다 (§4-1 "페이지 헤더 사용 규칙").
1228
1337
  - **주요 액션(등록 등)은 `STableBar` 의 `rightActions`** 에 둔다.
1229
1338
  - **선택 상태 액션(선택 삭제 등)은 `STableBar` 의 `actions`** 에 둔다. `actions` 슬롯은 건수 요약이 있으면 앞에 구분선(`SDivider`)을 **자동으로** 넣으므로 직접 구분선을 만들지 않는다.
1230
- - **페이지네이션이 있으면 스크롤 끝 여백을 끈다** — `AppShell` 에 `scrollEndSpacing={false}` 를 넘긴다 (§2-2). 페이지네이션이 이미 "여기서 끝"을 알려준다.
1339
+ - **페이지네이션이 있으면 본문이 남은 높이를 채우게 한다** — `AppShell` 에 `contentHeight="fill"` 을 넘긴다. 페이지가 통째로 스크롤되면 페이지네이션이 화면 밖으로 밀려 "여기서 끝"이 읽히지 않는다. `fill` 이면 **표만 자기 안에서 스크롤하고 페이지네이션은 하단에 고정**된다.
1340
+ - 본문 루트에 `h-full min-h-0` 으로 세로 축을 잇고, 남은 높이를 먹을 `STable` 에 `min-h-0 flex-1` 을 준다. 이 사슬이 하나라도 끊기면 표가 높이를 못 잡는다.
1341
+ - `fill` 에서는 페이지가 스크롤하지 않으므로 **`scrollEndSpacing` 은 무시된다** — 따로 끄지 않는다 (§2-2).
1231
1342
 
1232
1343
  ```tsx
1233
1344
  import {
@@ -1275,9 +1386,10 @@ export default function ProductListPage() {
1275
1386
  // 이 페이지의 주요 액션이 아니라 부가 액션 — slot 은 sm 버튼으로만 채운다
1276
1387
  slot: <SButton size="sm" color="neutral" outline label="이용 가이드" onClick={openGuide} />,
1277
1388
  }}
1278
- scrollEndSpacing={false} // 페이지네이션이 있으므로 끈다
1389
+ contentHeight="fill" // 표가 남은 높이를 채우고 페이지네이션이 하단에 고정된다
1279
1390
  >
1280
- <div className="flex flex-col gap-sd-12">
1391
+ {/* h-full min-h-0 → STable 의 min-h-0 flex-1 로 세로 축이 이어진다 */}
1392
+ <div className="flex h-full min-h-0 flex-col gap-sd-12">
1281
1393
  {/* 필터 — search 를 켜면 우측에 검색 패널이 붙는다 */}
1282
1394
  <SKeyValueTable
1283
1395
  fields={filterFields}
@@ -1302,7 +1414,9 @@ export default function ProductListPage() {
1302
1414
  }
1303
1415
  />
1304
1416
 
1417
+ {/* 남은 높이를 채우고 본문만 스크롤한다 — 페이지네이션 바는 표 안에서 하단 고정 */}
1305
1418
  <STable
1419
+ className="min-h-0 flex-1"
1306
1420
  columns={columns}
1307
1421
  rows={rows}
1308
1422
  rowKey="id"
@@ -1388,7 +1502,7 @@ export default function ProductCreatePage() {
1388
1502
 
1389
1503
  - 조회 값은 `type: 'text'` 행으로 표시한다. **상태·분류 태그도 별도 영역이 아니라 표의 한 행**으로 넣는다 (`render` 에 `STag`).
1390
1504
  - 행이 많아지면 **유형별로 섹션을 나누고, 각 섹션을 `SSectionHeaderCard` 로 감싼다.**
1391
- 합성 컴포넌트라 `SSectionHeaderCard.Header` / `SSectionHeaderCard.Body` 를 자식으로 쓴다.
1505
+ 섹션 제목은 `title` prop 으로, 바디 여백은 `padding` prop 으로 준다.
1392
1506
  - **수정·삭제 버튼은 하단에 둔다.** 내용이 짧아 우측 상단에 두는 변형도 있으나 기본은 하단이다.
1393
1507
 
1394
1508
  ```tsx
@@ -1421,24 +1535,18 @@ export default function ProductDetailPage() {
1421
1535
  // 목록에서 들어온 상세 페이지 — onBack 으로 뒤로가기를 준다
1422
1536
  <AppShell header={{ fix: true, title: '클래식 셔츠', onBack: goList }}>
1423
1537
  <div className="flex flex-col gap-sd-12">
1424
- <SSectionHeaderCard>
1425
- <SSectionHeaderCard.Header title="기본 정보" marker thickness="accent" />
1426
- <SSectionHeaderCard.Body>
1427
- <SKeyValueTable fields={basicFields} values={product} />
1428
- </SSectionHeaderCard.Body>
1538
+ <SSectionHeaderCard title="기본 정보" marker thickness="accent">
1539
+ <SKeyValueTable fields={basicFields} values={product} />
1429
1540
  </SSectionHeaderCard>
1430
1541
 
1431
- <SSectionHeaderCard>
1432
- {/* 헤더 우측에 액션이 필요하면 slot 을 쓴다 */}
1433
- <SSectionHeaderCard.Header
1434
- title="가격 정보"
1435
- marker
1436
- helpText={['부가세 포함 금액입니다.']}
1437
- slot={<SButton size="sm" color="secondary" label="이력" onClick={openHistory} />}
1438
- />
1439
- <SSectionHeaderCard.Body>
1440
- <SKeyValueTable fields={priceFields} values={product} />
1441
- </SSectionHeaderCard.Body>
1542
+ {/* 헤더 우측에 액션이 필요하면 slot 을 쓴다 */}
1543
+ <SSectionHeaderCard
1544
+ title="가격 정보"
1545
+ marker
1546
+ helpText={['부가세 포함 금액입니다.']}
1547
+ slot={<SButton size="sm" color="secondary" label="이력" onClick={openHistory} />}
1548
+ >
1549
+ <SKeyValueTable fields={priceFields} values={product} />
1442
1550
  </SSectionHeaderCard>
1443
1551
 
1444
1552
  {/* 액션은 하단 — 목록(되돌리기)은 왼쪽 끝, 실행 액션은 오른쪽 끝 */}
@@ -1487,8 +1595,8 @@ export default function ProductDetailPage() {
1487
1595
  - [ ] 텍스트 회색 위계를 순차 적용했는가 (기본 → `text-fg-secondary` → `text-fg-tertiary`, 단계 건너뛰기 ❌)
1488
1596
  - [ ] `SPage`·`SPopup` 의 기본 패딩을 `p-sd-*` 로 덮어쓰지 않았는가, 블록·섹션 **간격**이 `gap-sd-12` 인가 (`gap-sd-16`/`gap-sd-24` ❌ — 24 는 안쪽 여백에만 열린다)
1489
1597
  - [ ] 섹션·패널의 안쪽 **여백**이 §2-2 판정과 맞는가 (덩어리 두 종류 → 16 / 세 종류 이상 → 24, 서면 16)
1490
- - [ ] `SSectionHeaderCard.Body` 의 여백을 `p-sd-*` 가 아니라 `padding` prop 으로 줬는가
1491
- - [ ] 자체 스크롤하는 패널의 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` 이 있는가, 페이지네이션 있는 목록에서 `scrollEndSpacing={false}` 를 넘겼는가
1598
+ - [ ] `SSectionHeaderCard` 의 여백을 `p-sd-*` 가 아니라 `padding` prop 으로 줬는가
1599
+ - [ ] 자체 스크롤하는 패널의 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` 이 있는가, 페이지네이션 있는 목록에서 `contentHeight="fill"` 을 넘기고 `h-full min-h-0` → `STable` 의 `min-h-0 flex-1` 사슬을 이었는가
1492
1600
  - [ ] 같은 컴포넌트를 나열할 때 §2-2 그룹 간격을 썼는가 (체크박스 가로 `gap-sd-24` 등)
1493
1601
  - [ ] 페이지가 §4의 표준 골격에서 시작했는가
1494
1602
  - [ ] `header.fix` 가 프로젝트 전체와 같은 값인가 (다른 페이지와 다르게 섞어 쓰지 않았는가, §4-1)
@@ -1575,7 +1683,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
1575
1683
  - oceanblue: 15 25 50 60 65 70 75 80 85 90 95 99
1576
1684
  - brilliantblue: 10 20 25 40 50 60 70 75 80 85 90 95 99 05
1577
1685
  - bg: screen frame brand subtle accent accentLight accentBright accentFaint deep danger dangerLight warning caution progress success successLight neutralLight neutralBright tableHeader
1578
- - fg: primary secondary tertiary quaternary brand subtleWarm subtleCool deep success dangerLight accent accentLight danger warning inverse
1686
+ - fg: primary secondary tertiary quaternary brand subtleWarm subtleCool deep success successLight dangerLight accent accentLight danger warning inverse
1579
1687
  - border: default strong bold accent accentLight danger warning success
1580
1688
  - disabled: bg text icon border
1581
1689
  - link: accent
@@ -1701,6 +1809,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
1701
1809
  --sys-color-fg-subtleCool
1702
1810
  --sys-color-fg-subtleWarm
1703
1811
  --sys-color-fg-success
1812
+ --sys-color-fg-successLight
1704
1813
  --sys-color-fg-tertiary
1705
1814
  --sys-color-fg-warning
1706
1815
  --sys-color-field-bg-default
@@ -2068,7 +2177,6 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2068
2177
  | `activeKeys?` | `string[]` | — | 노출 필터 key 목록. 지정하면 제어 컴포넌트로 동작 — "필터 추가"로 고른 필드를 이 배열에 직접 넣어줘야 칩이 나타난다(onActiveKeysChange에서 받은 keys로 갱신). 지정하지 않으면 필드별 defaultActive 값을 기준으로 컴포넌트가 내부 상태로 관리하는 비제어 방식으로 동작한다 |
2069
2178
  | `label?` | `string` | `'검색 필터'` | 좌측 태그 텍스트 |
2070
2179
  | `showLabel?` | `boolean` | `false` | 좌측 태그(label)·구분선 표시 여부 |
2071
- | `showAddButton?` | `boolean` | `true` | 필터 추가 버튼 표시 여부 |
2072
2180
  | `showReset?` | `boolean` | `true` | 검색 초기화 링크 표시 여부 |
2073
2181
  | `disabled?` | `boolean` | `false` | 바 비활성 상태 |
2074
2182
  | `className?` | `string` | — | |
@@ -2103,6 +2211,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2103
2211
  - [SIcon](../SIcon)
2104
2212
  - [SRadio](../SRadio)
2105
2213
  - [SRadioButton](../SRadioButton)
2214
+ - [SSelect](../SSelect)
2106
2215
  - [STag](../STag)
2107
2216
  - [STextLink](../STextLink)
2108
2217
  - [STooltip](../STooltip)
@@ -2194,6 +2303,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2194
2303
  | `value?` | `number` | `0` | 진행률 (0–100) |
2195
2304
  | `type?` | `SCircleProgressType` | `'primary'` | 색상 테마 |
2196
2305
  | `indeterminate?` | `boolean` | `false` | 불확정(스피너) 모드 — value 무시 |
2306
+ | `size?` | `number \| string` | `DEFAULT_SIZE` | 링의 지름. 숫자는 px 로 해석한다. 부모 크기에 비례시키려면 컨테이너 쿼리 단위(`'45cqh'`)를 쓴다 — 퍼센트는 부모가 inline-flex 라 기준 폭이 정해지지 않아 해석되지 않는다. |
2197
2307
  | `label?` | `string` | — | 하단 레이블 |
2198
2308
  | `innerValue?` | `boolean` | `false` | true면 퍼센트를 원 아래가 아닌 원 가운데에 표시 |
2199
2309
  | `className?` | `string` | — | |
@@ -2203,6 +2313,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2203
2313
 
2204
2314
  ### Used by
2205
2315
 
2316
+ - [SImage](../SImage)
2206
2317
  - [SLoadingContainer](../SLoadingContainer)
2207
2318
  - [SLoadingModal](../SLoadingModal)
2208
2319
  - [STable](../STable)
@@ -2270,15 +2381,35 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2270
2381
 
2271
2382
  > 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
2272
2383
 
2384
+ ### SDatePickerMonthListbox
2385
+
2386
+ #### Props
2387
+
2388
+ | Prop | Type | Default | Description |
2389
+ |------|------|---------|-------------|
2390
+ | `value?` | `string \| null` | — | 선택 월 (YYYY-MM) |
2391
+ | `anchorYear?` | `number` | — | 연도 리스트가 처음 열릴 때 중앙에 둘 연도. 기본값은 올해 |
2392
+ | `selectable?` | `[string, string]` | — | 선택 가능 범위 [시작, 종료] |
2393
+ | `className?` | `string` | — | |
2394
+ | `style?` | `CSSProperties` | — | |
2395
+
2396
+ #### Events
2397
+
2398
+ | Event | Type | Description |
2399
+ |-------|------|-------------|
2400
+ | `onValueChange` | `(value: string) => void` | |
2401
+ | `onMonthSelect` | `(value: string) => void` | 월 컬럼에서 월을 선택했을 때 호출 |
2402
+
2273
2403
  ### SDatePicker
2274
2404
 
2275
2405
  #### Props
2276
2406
 
2277
2407
  | Prop | Type | Default | Description |
2278
2408
  |------|------|---------|-------------|
2279
- | `value?` | `string \| null` | — | 선택 날짜 (YYYY-MM-DD) |
2409
+ | `value?` | `string \| null` | — | 선택 값 (date: YYYY-MM-DD, month: YYYY-MM, year: YYYY) |
2410
+ | `mode?` | `SDatePickerMode` | `'date'` | 선택 모드 |
2280
2411
  | `size?` | `SDatePickerSize` | `'sm'` | |
2281
- | `placeholder?` | `string` | `'YYYY-MM-DD'` | |
2412
+ | `placeholder?` | `string` | — | |
2282
2413
  | `selectable?` | `[string, string]` | — | 선택 가능 범위 [시작, 종료] |
2283
2414
  | `disabled?` | `boolean` | `false` | |
2284
2415
  | `width?` | `number \| string` | — | |
@@ -2303,9 +2434,27 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2303
2434
 
2304
2435
  | Event | Type | Description |
2305
2436
  |-------|------|-------------|
2306
- | `onValueChange` | `(date: string) => void` | 선택 변경 (sdUpdate) |
2437
+ | `onValueChange` | `(value: string) => void` | 선택 변경 (sdUpdate) |
2307
2438
  | `onViewChange` | `(view: { year: number; month: number }) => void` | 보이는 연·월 변경 (sdViewChange) |
2308
2439
 
2440
+ ### SDatePickerYearListbox
2441
+
2442
+ #### Props
2443
+
2444
+ | Prop | Type | Default | Description |
2445
+ |------|------|---------|-------------|
2446
+ | `value?` | `string \| null` | — | 선택 연도 (YYYY) |
2447
+ | `anchorYear?` | `number` | — | 리스트가 처음 열릴 때 중앙에 둘 연도. 기본값은 올해 |
2448
+ | `selectable?` | `[string, string]` | — | 선택 가능 범위 [시작, 종료] |
2449
+ | `className?` | `string` | — | |
2450
+ | `style?` | `CSSProperties` | — | |
2451
+
2452
+ #### Events
2453
+
2454
+ | Event | Type | Description |
2455
+ |-------|------|-------------|
2456
+ | `onValueChange` | `(year: string) => void` | |
2457
+
2309
2458
  ## Dependencies
2310
2459
 
2311
2460
  ### Used by
@@ -2704,6 +2853,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2704
2853
  | `readOnly?` | `boolean` | `false` | 읽기 전용 (회색 배경) |
2705
2854
  | `width?` | `number \| string` | — | 컨트롤 너비 (숫자=px). 지정하면 필드가 부모 폭을 다 먹지 않고 (레이블 + width) 만큼만 차지한다. 다른 요소와 나란히 놓으려면 부모를 flex 로 두면 된다. |
2706
2855
  | `minWidth?` | `number \| string` | — | 컨트롤 최소 너비 (숫자=px). 하한선만 지정하며 필드는 계속 부모 폭을 채운다 |
2856
+ | `maxWidth?` | `number \| string` | — | 컨트롤 최대 너비 (숫자=px). 상한선만 지정하며 필드는 그 아래에서 부모 폭을 채운다. `width` 와 달리 hug 로 전환하지 않는다 — 부모가 좁으면 같이 좁아지고, 넓어도 여기서 멈춘다. 값 길이가 정해진 컨트롤(날짜·시간)이 `width="100%"` 를 받아 행 전체로 늘어나는 것을 막는 데 쓴다. **라벨은 상한에 들어가지 않는다** — 라벨은 컨트롤의 형제라 이 상한 밖이다. `addonLabel` 은 테두리 박스 안이라 상한을 나눠 먹으므로, `labelWidth`(= addon 폭)만큼 상한을 자동으로 늘린다. addon 이 있는데 `labelWidth` 가 없으면 폭을 알 수 없어 상한을 걸지 않는다 — 컨트롤이 잘리는 것보다 넓은 편이 낫다. |
2707
2857
  | `multiline?` | `boolean` | `false` | 멀티라인(textarea) — 컨트롤 높이를 고정하지 않고 min-height만 적용 |
2708
2858
  | `borderless?` | `boolean` | `false` | 테두리 박스 제거 (inline 컨트롤용) — border/배경/hover·focus 강조만 사라지고 label·hint·errorMessage 등 나머지 필드 구성은 그대로 동작한다. |
2709
2859
  | `children?` | `ReactNode` | — | 실제 컨트롤 (input/select 등) — 테두리 없이 렌더, 테두리는 SField가 제공 |
@@ -2734,6 +2884,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2734
2884
  - [SFilePicker](../SFilePicker)
2735
2885
  - [SInput](../SInput)
2736
2886
  - [SNumberInput](../SNumberInput)
2887
+ - [SSearchInput](../SSearchInput)
2737
2888
  - [SSelect](../SSelect)
2738
2889
  - [STextarea](../STextarea)
2739
2890
  - [STimePicker](../STimePicker)
@@ -2926,6 +3077,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2926
3077
  - [SOverlayHeader](../SOverlayHeader)
2927
3078
  - [SPage](../SPage)
2928
3079
  - [SPopover](../SPopover)
3080
+ - [SSearchInput](../SSearchInput)
2929
3081
  - [SSelect](../SSelect)
2930
3082
  - [STimePicker](../STimePicker)
2931
3083
  - [STimeRangePicker](../STimeRangePicker)
@@ -3063,12 +3215,14 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
3063
3215
  - [SGhostButton](../SGhostButton)
3064
3216
  - [SGnb](../SGnb)
3065
3217
  - [SGuide](../SGuide)
3218
+ - [SImage](../SImage)
3066
3219
  - [SKeyValueTable](../SKeyValueTable)
3067
3220
  - [SListItem](../SListItem)
3068
3221
  - [SLoadingModal](../SLoadingModal)
3069
3222
  - [SNumberInput](../SNumberInput)
3070
3223
  - [SPagination](../SPagination)
3071
3224
  - [SPopover](../SPopover)
3225
+ - [SSearchInput](../SSearchInput)
3072
3226
  - [SSectionHeaderCard](../SSectionHeaderCard)
3073
3227
  - [SSelect](../SSelect)
3074
3228
  - [SStepper](../SStepper)
@@ -3084,6 +3238,46 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
3084
3238
 
3085
3239
  ---
3086
3240
 
3241
+ # SImage
3242
+
3243
+ > 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
3244
+
3245
+ ### SImage
3246
+
3247
+ #### Props
3248
+
3249
+ | Prop | Type | Default | Description |
3250
+ |------|------|---------|-------------|
3251
+ | `src?` | `string` | — | 이미지 경로. 없으면 빈 이미지 아이콘이 나온다 |
3252
+ | `alt?` | `string` | `''` | 대체 텍스트 |
3253
+ | `ratio?` | `number` | `1` | 가로세로 비율. 소비자가 높이를 직접 주면 그쪽이 이긴다 |
3254
+ | `fit?` | `SImageFit` | `'cover'` | 이미지가 상자를 채우는 방식 (object-fit) |
3255
+ | `position?` | `string` | `'50% 50%'` | 이미지 정렬 위치 (object-position) |
3256
+ | `loading?` | `'lazy' \| 'eager'` | `'lazy'` | 브라우저 로딩 방식 |
3257
+ | `loadingShowDelay?` | `number` | `0` | 스피너를 띄우기까지 기다리는 시간(ms). 이 시간 안에 로드되면 스피너를 아예 그리지 않는다 — 캐시된 이미지에서 스피너가 한 프레임 번쩍이는 것을 막는다. |
3258
+ | `noSpinner?` | `boolean` | `false` | 로딩 중에도 스피너를 그리지 않는다 |
3259
+ | `loadingSlot?` | `ReactNode` | — | 로딩 중 표시를 직접 지정한다 (기본: 스피너) |
3260
+ | `errorSlot?` | `ReactNode` | — | 실패·빈 상태 표시를 직접 지정한다 (기본: 빈 이미지 아이콘) |
3261
+ | `imgProps?` | `ImgHTMLAttributes<HTMLImageElement>` | — | 안쪽 `<img>` 로 넘길 네이티브 속성 (srcSet · sizes · crossOrigin · draggable 등) |
3262
+
3263
+ #### Events
3264
+
3265
+ | Event | Type | Description |
3266
+ |-------|------|-------------|
3267
+ | `onLoad` | `(src: string) => void` | 로드 완료. 로드된 src 를 넘긴다 |
3268
+ | `onError` | `(event: SyntheticEvent<HTMLImageElement>) => void` | 로드 실패 |
3269
+
3270
+ ## Dependencies
3271
+
3272
+ ### Depends on
3273
+
3274
+ - [SCircleProgress](../SCircleProgress)
3275
+ - [SIcon](../SIcon)
3276
+
3277
+ ### Graph
3278
+
3279
+ ---
3280
+
3087
3281
  # SInput
3088
3282
 
3089
3283
  > 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
@@ -3159,6 +3353,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
3159
3353
  | `values?` | `Record<string, unknown>` | `{}` | field name을 key로 하는 값 객체 (`{ [name]: value }`). 지정 시 해당 field의 값으로 사용되며, field별 `options.value`보다 우선합니다. `onChange`의 `detail.values`와 함께 controlled 패턴으로 사용합니다. |
3160
3354
  | `search?` | `boolean` | `false` | 우측 검색 패널 |
3161
3355
  | `radius?` | `'default' \| 'useTop' \| 'full'` | `'default'` | border-radius 제어 |
3356
+ | `bordered?` | `boolean` | `true` | 바깥 테두리. 기본은 `true`. `SSectionHeaderCard` 의 `padding="none"` 안에 넣어 카드 가장자리까지 채울 때 `false` 로 끈다 — 카드가 이미 바깥 테두리를 그리므로, 켜 두면 1px 두 개가 나란히 놓여 그 변만 2px 로 보인다. |
3162
3357
  | `className?` | `string` | — | |
3163
3358
  | `style?` | `CSSProperties` | — | |
3164
3359
 
@@ -3255,7 +3450,6 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
3255
3450
  | `children?` | `ReactNode` | — | 리스트 컨테이너 내부에 렌더링할 내용 |
3256
3451
  | `useGap?` | `boolean` | `false` | 리스트 아이템 사이 gap 토큰 적용 여부 |
3257
3452
  | `usePadding?` | `boolean` | `false` | 리스트 컨테이너 padding 토큰 적용 여부 |
3258
- | `separator?` | `boolean` | `false` | 아이템 하단 구분선 표시 여부. 테두리를 가진 아이템(`bordered`)에는 쓰지 않는다 |
3259
3453
 
3260
3454
  ## Dependencies
3261
3455
 
@@ -3790,6 +3984,8 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
3790
3984
  |------|------|---------|-------------|
3791
3985
  | `background?` | `SPageBackground` | `'frame'` | 페이지 배경 표면. frame=흰 콘텐츠 면, neutral=옅은 회색 면, screen=앱 바탕. 스크롤바 처리도 여기 묶여 있다 — 셋 다 구분선+트랙 배경이고, 트랙 색만 neutral 에서 흰색이 된다. |
3792
3986
  | `scrollEndSpacing?` | `boolean` | `true` | 스크롤 끝 여백. 마지막 항목이 창 하단에 붙어 "여기서 끝"이 안 읽히는 것을 막는다. 기본으로 켜져 있고, 페이지네이션처럼 끝을 알려주는 것이 이미 있으면 끈다(목록 페이지). |
3987
+ | `overlayScrollbar?` | `boolean` | `false` | true면 네이티브 스크롤바를 숨기고 SPage 위에 오버레이 스크롤바를 얹는다. 스크롤바가 레이아웃 폭을 차지하지 않아 내부 콘텐츠 폭이 줄어들지 않는다. |
3988
+ | `contentHeight?` | `SPageContentHeight` | `'auto'` | 본문 높이 모드. 기본은 `auto` — 콘텐츠가 흐르고 넘치면 페이지가 스크롤한다. `fill` 은 본문이 남은 높이를 정확히 채우고 페이지는 스크롤하지 않는다. 표가 자기 안에서 스크롤하고 페이지네이션이 하단에 고정되는 목록 화면용이다. 본문 루트에 `h-full` 이 먹으므로 `<div className="flex h-full min-h-0 flex-col">` + `<STable className="min-h-0 flex-1" />` 구성이 성립한다. `fill` 에서는 페이지가 스크롤하지 않으므로 `scrollEndSpacing` 이 무시된다. |
3793
3989
  | `header?` | `SPageHeaderProps` | — | 페이지 타이틀 영역(pageHeader 포팅). 주면 스크롤·페이지 패딩 밖으로 빼내 상단에 고정 배치한다. `children` 은 항상 본문이다 — header 유무와 무관하게 같은 자리에 같은 뜻으로 들어간다. |
3794
3990
 
3795
3991
  ## Dependencies
@@ -4077,33 +4273,52 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
4077
4273
 
4078
4274
  ---
4079
4275
 
4080
- # SSectionHeaderCard
4276
+ # SSearchInput
4081
4277
 
4082
4278
  > 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
4083
4279
 
4084
- ### SSectionHeaderCardBody
4280
+ ### SSearchInput
4085
4281
 
4086
4282
  #### Props
4087
4283
 
4088
4284
  | Prop | Type | Default | Description |
4089
4285
  |------|------|---------|-------------|
4090
- | `children?` | `SSectionHeaderCardBodyChildren` | — | 바디 슬롯. 특정 컴포넌트 타입으로 제한하지 않습니다. |
4091
- | `padding?` | `SSectionHeaderCardBodyPadding` | `'default'` | 안쪽 여백. 기본은 `default`. 성격이 다른 요소가 세 종류 이상 섞인 영역에만 `wide`, 표를 가장자리까지 채울 때만 `none`. |
4286
+ | `value?` | `string \| number` | — | 값 (제어) |
4287
+ | `size?` | `SSearchInputSize` | `'sm'` | 크기 |
4288
+ | `placeholder?` | `string` | `'결과 내 검색'` | 플레이스홀더 |
4289
+ | `clearable?` | `boolean` | `false` | 지우기 버튼 — 값이 있을 때만 나타난다 |
4290
+ | `disabled?` | `boolean` | `false` | 비활성 |
4291
+ | `width?` | `number \| string` | — | 컨트롤 너비 (숫자=px). 미지정 시 부모 폭을 채운다 |
4292
+ | `focused?` | `boolean` | — | 포커스 상태 (제어/반영) |
4293
+ | `hovered?` | `boolean` | — | 호버 상태 (제어/반영) |
4294
+ | `inputClass?` | `string` | — | 내부 input 요소 className |
4295
+ | `inputStyle?` | `CSSProperties` | — | 내부 input 요소 style |
4296
+ | `className?` | `string` | — | |
4297
+ | `style?` | `CSSProperties` | — | |
4092
4298
 
4093
- ### SSectionHeaderCardHeader
4299
+ #### Events
4094
4300
 
4095
- #### Props
4301
+ | Event | Type | Description |
4302
+ |-------|------|-------------|
4303
+ | `onValueChange` | `(value: string) => void` | 값 변경 — 문자열 전달 |
4304
+ | `onChange` | `InputHTMLAttributes<HTMLInputElement>['onChange']` | 네이티브 onChange (form-agnostic 연동용, RHF 등) |
4305
+ | `onSearch` | `(value: string) => void` | 검색 실행 — Enter 키에서 현재 값과 함께 호출된다. 한글 조합 중의 Enter(IME 확정)는 검색으로 치지 않는다. |
4096
4306
 
4097
- | Prop | Type | Default | Description |
4098
- |------|------|---------|-------------|
4099
- | `title` | `ReactNode` | — | 헤더 제목 |
4100
- | `titleSize?` | `SSectionHeaderCardTitleSize` | `'xs'` | 제목 크기 |
4101
- | `marker?` | `boolean` | `false` | 제목 앞 점 표시 여부 |
4102
- | `required?` | `boolean` | `false` | 제목 뒤 필수 별 표시 여부 |
4103
- | `helpText?` | `string[]` | — | 도움말 툴팁 메시지 |
4104
- | `subtitle?` | `ReactNode` | — | 부제 |
4105
- | `slot?` | `ReactNode` | — | 헤더 우측 슬롯 |
4106
- | `thickness?` | `SSectionHeaderCardThickness` | `false` | 상단 border 색상 타입. false면 표시하지 않습니다. |
4307
+ ## Dependencies
4308
+
4309
+ ### Depends on
4310
+
4311
+ - [SField](../SField)
4312
+ - [SGhostButton](../SGhostButton)
4313
+ - [SIcon](../SIcon)
4314
+
4315
+ ### Graph
4316
+
4317
+ ---
4318
+
4319
+ # SSectionHeaderCard
4320
+
4321
+ > 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
4107
4322
 
4108
4323
  ### SSectionHeaderCard
4109
4324
 
@@ -4111,7 +4326,18 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
4111
4326
 
4112
4327
  | Prop | Type | Default | Description |
4113
4328
  |------|------|---------|-------------|
4114
- | `children?` | `SSectionHeaderCardChildren` | — | SSectionHeaderCard 슬롯. 특정 컴포넌트 타입으로 제한하지 않습니다. |
4329
+ | `title?` | `ReactNode` | — | 헤더 제목 |
4330
+ | `titleSize?` | `SSectionHeaderCardTitleSize` | — | 제목 크기 |
4331
+ | `marker?` | `boolean` | — | 제목 앞 점 표시 여부 |
4332
+ | `required?` | `boolean` | — | 제목 뒤 필수 별 표시 여부 |
4333
+ | `helpText?` | `string[]` | — | 도움말 툴팁 메시지 |
4334
+ | `subtitle?` | `ReactNode` | — | 부제 |
4335
+ | `slot?` | `ReactNode` | — | 헤더 우측 슬롯 |
4336
+ | `thickness?` | `SSectionHeaderCardThickness` | — | 상단 border 색상 타입. false면 표시하지 않습니다. |
4337
+ | `headerClassName?` | `string` | — | 헤더 영역 클래스 |
4338
+ | `padding?` | `SSectionHeaderCardBodyPadding` | — | 바디 안쪽 여백. 기본은 `default`. 성격이 다른 요소가 세 종류 이상 섞인 영역에만 `wide`, 표를 가장자리까지 채울 때만 `none`. |
4339
+ | `background?` | `SSectionHeaderCardBodyBackground` | — | 본문 배경. 기본은 `frame` — 카드가 깐 흰 면을 그대로 쓴다. `neutral` 은 바탕을 한 단계 눌러앉혀, 흰 면 덩어리(표·리스트)가 여럿일 때 그것들이 **"면 위에 놓인 객체"로 읽히게** 한다. 위계를 한 단계 더 주고 싶을 때 고르는 선택지이며, **기본값이 틀린 것은 아니다** — 표·리스트는 테두리·라운드·헤더 줄과 간격을 이미 갖고 있어 흰 바탕에서도 경계가 읽힌다. 깔아도 **효과가 없는** 자리가 있다 — 덩어리가 가장자리까지 차는 경우(`padding="none"` 으로 표를 채우면 바탕이 완전히 가려진다), 덩어리에 회색 면이 섞인 경우(그 덩어리가 바탕에 묻힌다), 맨 텍스트나 폼 컨트롤만 있는 본문(떠오를 흰 면이 없다). |
4340
+ | `children?` | `SSectionHeaderCardChildren` | — | 바디 콘텐츠. 특정 컴포넌트 타입으로 제한하지 않습니다. |
4115
4341
 
4116
4342
  ## Dependencies
4117
4343
 
@@ -4182,6 +4408,7 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
4182
4408
 
4183
4409
  ### Used by
4184
4410
 
4411
+ - [SChipFilter](../SChipFilter)
4185
4412
  - [SKeyValueTable](../SKeyValueTable)
4186
4413
  - [STable](../STable)
4187
4414
 
@@ -4315,6 +4542,7 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
4315
4542
  | `stickyHeader?` | `boolean` | — | |
4316
4543
  | `stickyColumn?` | `STableStickyColumn` | — | 고정할 좌/우 컬럼 수 |
4317
4544
  | `radius?` | `'default' \| 'useTop' \| 'full'` | `'default'` | border-radius 제어 |
4545
+ | `bordered?` | `boolean` | `true` | 바깥 테두리. 기본은 `true`. `SSectionHeaderCard` 의 `padding="none"` 안에 넣어 카드 가장자리까지 채울 때 `false` 로 끈다 — 카드가 이미 바깥 테두리를 그리므로, 켜 두면 1px 두 개가 나란히 놓여 그 변만 2px 로 보인다. 페이지네이션 바의 테두리와 1px 겹침(`-mt-px`)도 함께 꺼진다. 본문 테두리가 없으면 겹칠 대상이 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다. |
4318
4546
  | `noDataLabel?` | `string` | `'데이터가 없습니다.'` | |
4319
4547
  | `noDataSlot?` | `ReactNode` | — | 데이터가 없을 때 body 영역 전체를 대체하는 슬롯. 지정하면 `noDataLabel` 대신 이 콘텐츠가 헤더 아래 영역을 채우며, 버튼 등 인터랙션도 동작한다. |
4320
4548
  | `isLoading?` | `boolean` | `false` | |
@@ -4406,7 +4634,6 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
4406
4634
  |------|------|---------|-------------|
4407
4635
  | `value` | `string` | — | 현재 선택된 탭 value |
4408
4636
  | `tabs` | `STabOption[]` | — | 탭 옵션 목록 |
4409
- | `size?` | `STabSize` | `'md'` | 탭 크기 (main 전용) |
4410
4637
  | `isSub?` | `boolean` | `false` | 서브 탭(밑줄형) 스타일 |
4411
4638
  | `vertical?` | `boolean` | `false` | 세로 배치 (sub 전용 — main 폴더형은 항상 가로) |
4412
4639
  | `className?` | `string` | — | |
@@ -4758,6 +4985,7 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
4758
4985
  | `value?` | `boolean` | `false` | 선택(on/off) 상태 |
4759
4986
  | `label?` | `string` | `''` | 라벨 |
4760
4987
  | `disabled?` | `boolean` | `false` | 비활성 |
4988
+ | `size?` | `SToggleSize` | `'sm'` | 크기 |
4761
4989
  | `className?` | `string` | — | |
4762
4990
  | `style?` | `CSSProperties` | — | |
4763
4991
 
@@ -4850,6 +5078,7 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
4850
5078
  | `border?` | `boolean` | `true` | 아이템 하단 border 표시 여부 |
4851
5079
  | `indeterminate?` | `boolean` | `false` | 일부 선택 상태 |
4852
5080
  | `selectable?` | `boolean` | `true` | 체크박스 표시 여부 |
5081
+ | `size?` | `STreeSize` | `'sm'` | 타이포그래피 크기 |
4853
5082
  | `leading?` | `ReactNode \| ((state: STreeItemRenderState) => ReactNode)` | — | 사용자 지정 leading 콘텐츠 |
4854
5083
  | `trailing?` | `ReactNode \| ((state: STreeItemRenderState) => ReactNode)` | — | 사용자 지정 trailing 콘텐츠 |
4855
5084
 
@@ -4872,6 +5101,8 @@ function OrderModal({ open, onOpenChange, onClose, modalRef, orderId }: OrderMod
4872
5101
  | `expandedIds?` | `string[]` | — | 펼쳐진 노드 ID 목록 |
4873
5102
  | `defaultExpandedIds?` | `string[]` | — | 비제어 펼침 초기값 |
4874
5103
  | `selectable?` | `boolean` | `true` | 체크박스 표시 여부 |
5104
+ | `size?` | `STreeSize` | `'sm'` | 타이포그래피 크기 |
5105
+ | `useAll?` | `boolean` | `false` | 체크박스 사용 시 최상단 전체 선택 아이템 표시 여부 |
4875
5106
  | `guideline?` | `boolean` | `true` | depth 연결선 표시 여부 |
4876
5107
  | `border?` | `boolean` | `true` | 아이템 하단 border 표시 여부 |
4877
5108
  | `cascadeSelection?` | `boolean` | `true` | 부모 선택 시 하위 노드까지 함께 토글 |