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
package/dist/llms.txt CHANGED
@@ -36,12 +36,12 @@
36
36
  | 분류 | 컴포넌트 |
37
37
  | --- | --- |
38
38
  | **버튼·링크** | `SButton` `SGhostButton` `SDropdownButton` `STextLink` `SSwitch` `SToggle` |
39
- | **입력 (폼)** | `SForm` `SField` `SInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
40
- | **날짜·시간** | `SCalendar` `SDatePicker` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
39
+ | **입력 (폼)** | `SForm` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
40
+ | **날짜·시간** | `SCalendar` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
41
41
  | **표·목록** | `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SListItem` `SExpansionList` `SDraggableList` `SDraggableItem` `STree` |
42
42
  | **레이아웃** | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) `SSectionHeaderCard` `SCard` `SDivider` `SSplitter` `SScrollArea` `SExpansionItem` |
43
43
  | **내비게이션** | `STabs` `SPagination` `SStepper` |
44
- | **표시·상태** | `STag` `SBadge` `SIcon` `SCallout` `SGuide` |
44
+ | **표시·상태** | `STag` `SBadge` `SIcon` `SImage` `SCallout` `SGuide` |
45
45
  | **진행·로딩** | `SLinearProgress` `SCircleProgress` `SLoadingContainer` `SLoadingModal` |
46
46
  | **오버레이** | `STooltip` `SPopover` `SPopup` `SDrawer` `SPortal` |
47
47
  | **모달** | `SModal.confirm()` `SModal.create()` + `SActionModal` `SConfirmModal` `SModalOutlet`(앱 루트 1회) |
@@ -69,6 +69,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
69
69
  | --- | --- |
70
70
  | `<button>` | `SButton`, `SGhostButton`, `SDropdownButton`, `STextLink` |
71
71
  | `<input type="text/password/...">` | `SInput` |
72
+ | `<input type="search">` | `SSearchInput` |
72
73
  | `<input type="number">` | `SNumberInput` |
73
74
  | `<input type="checkbox">` | `SCheckbox`, `SToggle`, `SSwitch` |
74
75
  | `<input type="radio">` | `SRadio`, `SRadioButton` |
@@ -81,7 +82,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
81
82
  | `alert()`, `confirm()` | `SToast`, `SModal.confirm(...)` |
82
83
  | 직접 만든 탭/페이지네이션/스텝퍼 | `STabs`, `SPagination`, `SStepper` |
83
84
  | `<ul>`/`<li>` 로 만든 목록 UI | `SList` + `SListItem` (드래그 정렬은 `SDraggableItem`) |
84
- | 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard` + `.Header` / `.Body` |
85
+ | 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard` 의 `title` / `padding` props |
85
86
  | `<svg>` 직접 삽입, 이모지 아이콘 | `SIcon` |
86
87
  | `<hr>` | `SDivider` |
87
88
  | `<details>` / `<summary>` | `SExpansionItem` |
@@ -147,7 +148,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
147
148
  | --- | --- | --- |
148
149
  | **셸** | 앱 전체 뼈대. 페이지가 바뀌어도 남는다 | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) |
149
150
  | **블록** | `SPage` 의 직계 자식. 페이지를 세로로 쌓는 단위 | `SSectionHeaderCard` `SCard` `SForm` `SSplitter` `SScrollArea` `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SExpansionList` `SDraggableList` `STree` `SCallout` `STabs` `SStepper` `SPagination` `SDivider` |
150
- | **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `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` |
151
+ | **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `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` |
151
152
  | **인라인** | 텍스트 흐름·셀·라벨 안에 섞인다. 혼자 블록이 되지 않는다 | `STag` `SBadge` `SIcon` `STextLink` `SChip` |
152
153
  | **레이어** | 문서 흐름 **밖**에 떠서 그려진다. 어느 층에서 띄우든 레이아웃에 영향이 없다 | `SModal` `SActionModal` `SConfirmModal` `SPopup` `SDrawer` `SPopover` `STooltip` `SPortal` `SToast` `SLoadingModal` `SLoadingContainer` `SGuide` |
153
154
 
@@ -167,7 +168,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
167
168
  | 담는 것 | 올 수 있는 것 | 오면 안 되는 것 |
168
169
  | --- | --- | --- |
169
170
  | `SPage` | **블록만** | **요소를 직접** — 버튼 하나도 블록에 담아 놓는다 |
170
- | `SSectionHeaderCard.Body` | 그리는 블록 · 요소 | `SSectionHeaderCard` · `SCard` (카드 겹침, §3-7-8) |
171
+ | `SSectionHeaderCard` 의 `children` | 그리는 블록 · 요소 | `SSectionHeaderCard` · `SCard` (카드 겹침, §3-7-8) |
171
172
  | `SCard` | 그리는 블록 · 요소 | `SCard` · `SSectionHeaderCard` |
172
173
  | `SForm` | 블록 (보통 `SKeyValueTable` + 하단 액션) | — |
173
174
  | `SSplitter.Before` / `.After` | 블록 | — |
@@ -231,7 +232,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
231
232
 
232
233
  페이지 제목만 18px 로 크게 두고 그 아래는 14 / 12 로 촘촘하게 간다. 중간 크기(16px)는 기본 골격에서 쓰지 않는다.
233
234
 
234
- - **페이지·섹션 제목의 타이포를 직접 주지 않는다.** `SPage` 의 `header.title`, `SSectionHeaderCard.Header` 의 `title` 이 이미 넣는다 — 그 위에 `typo-heading-lg`/`typo-heading-sm` 을 또 씌우지 않는다.
235
+ - **페이지·섹션 제목의 타이포를 직접 주지 않는다.** `SPage` 의 `header.title`, `SSectionHeaderCard` 의 `header.title` 이 이미 넣는다 — 그 위에 `typo-heading-lg`/`typo-heading-sm` 을 또 씌우지 않는다.
235
236
  - **하위 제목이 필요하면 먼저 섹션을 나눌 수 없는지 본다.** 한 섹션 안에서 제목이 두 단으로 갈린다는 것은 대개 섹션이 둘이라는 뜻이다 (§3-7-8).
236
237
  - 본문 안에서 한 단어를 강조할 때는 `typo-body-sm-medium` 을 쓴다. `typo-body-sm-bold` 는 제목 성격의 짧은 라벨에만 쓴다. <!-- TODO(디자인): 강조 굵기 기준 확정 -->
237
238
 
@@ -301,7 +302,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
301
302
 
302
303
  **페이지 프레임은 예외 없이 `SPage` 가 넣는다.** 아래 규칙은 그 안의 **섹션·패널 레벨에만** 적용된다.
303
304
 
304
- **컴포넌트가 자체 여백을 가지면 컴포넌트 기준이 우선한다.** `SKeyValueTable`·`STable` 처럼 자기 여백을 토큰으로 갖고 있는 컴포넌트에는 이 판정을 적용하지 않는다 — 손댈 것이 없다. 아래 판정이 필요한 자리는 **직접 만든 컨테이너**와 **`SSectionHeaderCard.Body`** 두 곳뿐이다.
305
+ **컴포넌트가 자체 여백을 가지면 컴포넌트 기준이 우선한다.** `SKeyValueTable`·`STable` 처럼 자기 여백을 토큰으로 갖고 있는 컴포넌트에는 이 판정을 적용하지 않는다 — 손댈 것이 없다. 아래 판정이 필요한 자리는 **직접 만든 컨테이너**와 **`SSectionHeaderCard` 의 `padding`** 두 곳뿐이다.
305
306
 
306
307
  판정은 **그 영역이 담고 있는 콘텐츠 덩어리의 종류 수**로 한다.
307
308
 
@@ -336,14 +337,47 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
336
337
 
337
338
  **중첩되면 안쪽 여백을 주지 않는다.** 24 영역 안에 또 여백을 주면 가장자리가 40 으로 벌어져 한 면적처럼 읽힌다. 안쪽 카드·목록이 **배경색이 다르거나 테두리가 있어** 경계가 스스로 보이는 경우에만 자기 여백을 유지한다.
338
339
 
339
- `SSectionHeaderCard.Body` 는 이 규칙을 **prop 으로 받는다** — 직접 `p-sd-*` 를 주지 않는다.
340
+ `SSectionHeaderCard` 는 이 규칙을 **`padding` prop 으로 받는다** — 직접 `p-sd-*` 를 주지 않는다.
340
341
 
341
342
  ```tsx
342
- <SSectionHeaderCard.Body>…</SSectionHeaderCard.Body> {/* 기본 = 16 */}
343
- <SSectionHeaderCard.Body padding="wide">…</SSectionHeaderCard.Body> {/* 3종류 이상 */}
344
- <SSectionHeaderCard.Body padding="none">…</SSectionHeaderCard.Body> {/* 표를 가장자리까지 */}
343
+ <SSectionHeaderCard title="기본 정보">…</SSectionHeaderCard> {/* 기본 = 16 */}
344
+ <SSectionHeaderCard title="기본 정보" padding="wide">…</SSectionHeaderCard> {/* 3종류 이상 */}
345
+ <SSectionHeaderCard title="기본 정보" padding="none">…</SSectionHeaderCard> {/* 표를 가장자리까지 */}
345
346
  ```
346
347
 
348
+ ##### 카드 가장자리까지 채우는 표는 자기 테두리를 끈다
349
+
350
+ 여기서 "표"는 **`STable` 과 `SKeyValueTable` 둘 다**다. 두 컴포넌트 모두 자기 바깥 테두리를 그리는데, 카드도 바깥 테두리를 그린다. `padding="none"` 으로 붙이면 **1px 두 개가 나란히 놓여 그 변만 2px** 로 보인다(카드의 다른 변은 1px 그대로라 굵기가 어긋난다).
351
+
352
+ ```tsx
353
+ <SSectionHeaderCard title="발주 내역" padding="none">
354
+ <SKeyValueTable fields={…} bordered={false} radius="useTop" />
355
+ <STable columns={…} rows={…} bordered={false} radius="useTop" />
356
+ </SSectionHeaderCard>
357
+ ```
358
+
359
+ - **`bordered={false}`** 로 표의 테두리를 끈다. 카드가 이미 그린다.
360
+ - **`radius="useTop"`** 으로 위쪽 모서리를 죽인다. 아래쪽 라운드는 카드가 처리한다.
361
+ - `STable` 은 **페이지네이션 바의 테두리와 `-mt-px` 겹침도 함께 꺼진다** — 본문 테두리가 없으면 겹칠 대상이 없어, 그대로 두면 페이지네이션만 테두리를 갖고 1px 어긋난다.
362
+
363
+ #### 본문 바탕 눌러앉히기 (선택)
364
+
365
+ `SSectionHeaderCard` 는 **`background="neutral"`** 로 본문 바탕을 한 단계 눌러앉힐 수 있다. 흰 면 덩어리(표·리스트)가 여럿일 때 그 덩어리들이 **"면 위에 놓인 객체"로 읽혀 묶음이 더 강하게 보인다.**
366
+
367
+ ```tsx
368
+ <SSectionHeaderCard title="발주 상세" background="neutral">…흰 면 표 여럿…</SSectionHeaderCard>
369
+ ```
370
+
371
+ **기본값(`frame`, 흰 면)이 틀린 것이 아니다.** 이 저장소의 표·리스트는 테두리·라운드·헤더 줄과 `gap-sd-12` 를 이미 갖고 있어 흰 바탕에서도 경계가 읽힌다. 위계를 한 단계 더 주고 싶을 때 고르는 수단이지, 덩어리가 둘 이상이면 반드시 깔아야 하는 규칙이 아니다.
372
+
373
+ 깔아도 **효과가 없는** 자리는 있다.
374
+
375
+ - **덩어리가 가장자리까지 차는 경우** — `padding="none"` 으로 표를 채우면 깐 바탕이 표에 완전히 가려 보이지 않는다.
376
+ - **덩어리에 회색 면이 섞인 경우** — 그 덩어리가 바탕과 같은 색이 되어 묻힌다.
377
+ - **맨 텍스트·폼 컨트롤만 있는 본문** — 떠오를 흰 면이 없다.
378
+
379
+ 바탕을 깐 경우, 표 사이 구분선(`SDivider`)은 대개 불필요해진다 — 색이 이미 경계를 만든다.
380
+
347
381
  #### 스크롤 영역의 하단 여백
348
382
 
349
383
  스크롤을 끝까지 내렸을 때 마지막 항목이 화면 경계에 붙으면 **목록이 끝난 것인지 더 있는 것인지** 읽히지 않는다. 그래서 스크롤 영역은 **하단만** 넓게 둔다. 나머지 세 방향은 위 16 / 24 규칙 그대로다.
@@ -353,7 +387,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
353
387
  | **패널 자체 스크롤** (좌측 목록, 중앙 대화 등) | 그 패널 안쪽 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` — `SPage` 와 같은 토큰이라 값이 바뀌어도 함께 따라간다 |
354
388
  | **페이지 단위 스크롤** | **`SPage` 가 넣는다. 직접 주지 않는다** |
355
389
 
356
- `SPage` 는 기본으로 넣으므로 **아무것도 하지 않으면 맞다.** 끄는 경우는 하나뿐이다 — **페이지네이션이 붙은 테이블.** 페이지네이션이 이미 "여기서 끝"을 알려주므로 `scrollEndSpacing={false}` 로 끈다 (§4-2 목록 페이지).
390
+ `SPage` 는 기본으로 넣으므로 **아무것도 하지 않으면 맞다.** 직접 끌 일은 없다 — **페이지네이션이 붙은 테이블**은 `contentHeight="fill"` 을 쓰고, 이 모드에서는 페이지가 스크롤하지 않아 스크롤 끝 여백이 **자동으로 무시**된다 (§4-2 목록 페이지).
357
391
 
358
392
  ### 2-3. 색상
359
393
 
@@ -415,6 +449,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
415
449
  | --- | --- | --- |
416
450
  | 한 줄 텍스트를 받는다 | `SInput` | §3-7-1 |
417
451
  | 여러 줄 텍스트를 받는다 | `STextarea` | §3-7-1 |
452
+ | 목록·결과를 검색어로 좁힌다 | `SSearchInput` | §3-7-1 |
418
453
  | 숫자(수량·금액)를 받는다 | `SNumberInput` | |
419
454
  | 바코드를 스캔해 받는다 | `SBarcodeInput` | |
420
455
  | 목록에서 하나 고르게 한다 | `SSelect` | §3-7-2 |
@@ -428,6 +463,8 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
428
463
  | 입력된 값 하나를 지우거나 고치게 한다 | `SChip` | §3-1 |
429
464
  | 파일을 받는다 | `SFilePicker` | |
430
465
  | 날짜 하나를 받는다 | `SDatePicker` | §3-7-4 |
466
+ | 연도 선택 리스트만 커스텀 조합에 넣는다 | `SDatePickerYearListbox` | §3-7-4 |
467
+ | 연도+월 선택 리스트만 커스텀 조합에 넣는다 | `SDatePickerMonthListbox` | §3-7-4 |
431
468
  | 날짜 기간을 받는다 | `SDateRangePicker` | §3-7-4 |
432
469
  | 시각 하나를 받는다 | `STimePicker` | |
433
470
  | 시각 범위를 받는다 | `STimeRangePicker` | |
@@ -451,6 +488,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
451
488
  | 상태·분류를 라벨로 찍는다 | `STag` | §3-1 |
452
489
  | 색 점만으로 상태를 찍는다 | `SBadge` | §3-1 |
453
490
  | 아이콘을 넣는다 | `SIcon` | |
491
+ | 사진·썸네일을 보여준다 (로딩·실패 상태 포함) | `SImage` | §3-7-12 |
454
492
  | 문장 안에서 다른 화면으로 보낸다 | `STextLink` | §3-5-6 |
455
493
 
456
494
  #### C. 동작을 실행시킨다
@@ -558,9 +596,26 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
558
596
  | | 무엇인가 | 크기 |
559
597
  | --- | --- | --- |
560
598
  | **SPopup** | **별도 브라우저 창** (`window.open` 으로 여는 전용 라우트) | 창 크기 = 콘텐츠 크기 |
561
- | **SActionModal** | 같은 창 위 오버레이 카드 | `width` / `height` prop |
599
+ | **SActionModal** | 같은 창 위 오버레이 카드 | `width` prop. **높이는 주지 않는다** (아래) |
562
600
  | **SModal.confirm** (`SConfirmModal`) | 같은 창 위 확인창 | 고정 |
563
601
 
602
+ ##### 모달 높이는 내용이 정하고, 상한은 시스템이 건다
603
+
604
+ **`height` 를 주지 않는다.** 높이는 내용이 정하고, 카드는 **뷰포트의 85%** 에서 멈춘다(시스템이 모든 모달에 건다). 데이터가 적으면 내용만큼 작아지고, 많으면 85% 에서 멈춘다.
605
+
606
+ 가로는 좌우 24px 씩을 뺀 값으로 클램핑하는데 **세로만 비율**인 이유는, 모달이 화면을 거의 다 덮으면 뒤 맥락이 사라져 "떠 있는 것"으로 읽히지 않기 때문이다.
607
+
608
+ **상한에 닿았을 때 스크롤되어야 하는 것은 모달 본문이 아니라 표다.**
609
+
610
+ ```tsx
611
+ <SActionModal modalTitle="발주 검토" button={{ label: '확정', onClick: submit }}>
612
+ {/* 표가 남은 높이를 먹고 자기 안에서 스크롤한다 — 헤더·합계·푸터는 늘 보인다 */}
613
+ <STable className="min-h-0 flex-1" columns={columns} rows={rows} />
614
+ </SActionModal>
615
+ ```
616
+
617
+ 본문(`overflow-auto` 영역)이 통째로 스크롤되면 표 헤더와 합계 줄이 위로 밀려 사라진다. `SActionModal` 의 본문은 이미 `min-h-0 flex-1` 이므로, 표에 `min-h-0 flex-1` 을 주면 세로 축이 이어져 표만 스크롤한다 (§4-2 목록 페이지와 같은 사슬이다).
618
+
564
619
  **성격이 먼저 둘로 갈린다.**
565
620
 
566
621
  | 성격 | 정의 | 컴포넌트 |
@@ -748,6 +803,7 @@ const columns: STableColumn[] = [
748
803
 
749
804
  컬럼 폭은 `width` 로 **고정**되고, `<td>` 는 그 폭을 넘는 내용을 잘라낸다(`overflow: hidden`). 텍스트라면 말줄임으로 끝나지만, 셀에 `STag` · `SButton` · `SGhostButton` · `SSelect` · `SInput` · `SNumberInput` 처럼 **자기 폭을 가진 요소**를 넣으면 요소 자체가 잘려 **누르거나 읽거나 입력할 수 없게 된다.** `width` 를 생략해도 내용에 맞춰 늘어나지 않고 `STable` 의 기본 폭이 될 뿐이므로, 컨트롤이 들어가는 컬럼은 폭을 직접 판단해서 준다.
750
805
 
806
+ - **컨트롤이 들어가는 컬럼에는 `contentType: 'control'` 을 함께 준다.** 좌우 패딩이 텍스트용(넓게)에서 컨트롤용(좁게)으로 바뀌어, 같은 컬럼 폭에서도 요소가 쓸 폭이 넓어진다. 기본값은 `text` 다.
751
807
  - 기준은 **요소가 온전히 보이는 폭 + 셀 좌우 패딩**이다. 좌우 패딩은 `STable` 이 토큰으로 넣으므로(직접 주지 않는다) 그만큼을 뺀 나머지가 요소 몫이라는 점을 계산에 넣는다.
752
808
  - 요소가 둘 이상이면 요소 폭의 합에 **`gap` 까지** 더한다 (행 내부 인라인 액션 간격은 `gap-sd-4` 고정, §3-5-5).
753
809
  - 값에 따라 폭이 달라지는 요소(`STag` 라벨, 라벨 있는 버튼)는 **가장 긴 값** 기준으로 잡는다. `판매중` 에 맞춰두면 `판매중지 요청` 에서 잘린다.
@@ -755,6 +811,13 @@ const columns: STableColumn[] = [
755
811
  - 폭을 넉넉히 줄 수 없는 자리는 폭을 줄이는 게 아니라 **요소를 바꾼다** — 라벨 버튼 대신 아이콘만 있는 `SGhostButton`, `size="xs"` (§3-5-2, §3-5-5).
756
812
  - **`autoWidth` 는 해법이 아니다.** 내용에 맞춰 늘어나는 게 아니라 고정폭 컬럼들이 가져가고 **남은 폭을 나눠 갖는 것**이라, 테이블이 좁으면 역시 잘린다. 컨트롤 컬럼은 `width` 로 직접 확보한다.
757
813
 
814
+ ```tsx
815
+ { name: 'normal', label: '정상', field: 'normal', width: '96px',
816
+ align: 'center', contentType: 'control', render: row => <SNumberInput … /> },
817
+ ```
818
+
819
+ **셀 좌우 여백은 내용이 정한다.** 텍스트는 넓게, 컨트롤은 좁게다 — `SKeyValueTable` 은 `field.type` 으로 이 판정을 스스로 하지만, `STable` 의 셀은 소비 앱이 넘긴 임의의 `render` 결과라 컴포넌트가 알 수 없다. 그래서 `contentType` 으로 알려준다. 여백 값 자체는 토큰이 정하므로 `tdClass` 로 패딩을 직접 덮어쓰지 않는다.
820
+
758
821
  **`resizable` 테이블이면 `minWidth` 를 함께 준다.** resize 하한 기본값은 어떤 컨트롤도 담지 못할 만큼 작아, 사용자가 끝까지 끌면 그대로 잘린다. `width` 를 정한 근거와 같은 값을 하한으로 둔다 — 텍스트 컬럼과 달리 여기서는 더 줄일 여지가 없다.
759
822
 
760
823
  ```tsx
@@ -967,16 +1030,19 @@ const columns: STableColumn[] = [
967
1030
 
968
1031
  > §3-0 라우팅에서 이 절을 가리키는 자리들이다. <!-- TODO(디자인): 전체 검수·확정 -->
969
1032
 
970
- #### 3-7-1. SInput vs STextarea
1033
+ #### 3-7-1. SInput vs STextarea vs SSearchInput
971
1034
 
972
- **줄 수가 아니라 값의 성격으로 고른다.** 값의 길이를 미리 알 수 있으면 `SInput`, 없으면 `STextarea` 다.
1035
+ **먼저 "그 값이 저장되는가"를 본다.** 저장되면 폼 필드(`SInput`·`STextarea`), 화면을 좁히기만 하고 사라지면 `SSearchInput` 이다.
973
1036
 
974
1037
  | 값 | 사용 |
975
1038
  | --- | --- |
976
1039
  | 이름·코드·전화번호·URL 처럼 형식이 정해진 값 | `SInput` |
977
1040
  | 메모·사유·설명처럼 길이가 예측되지 않는 문장 | `STextarea` |
1041
+ | 지금 보이는 목록·결과를 좁히는 검색어 | `SSearchInput` |
1042
+
1043
+ 폼 필드 둘은 **줄 수가 아니라 값의 성격으로** 갈린다. 값이 길어질 수 있는데 `SInput` 을 쓰면 사용자가 자기가 쓴 것을 다시 읽지 못한다 — 한 줄 안에서 좌우로 스크롤해야 하기 때문이다. 반대로 짧은 값에 `STextarea` 를 쓰면 빈 공간이 남아 입력량을 잘못 기대하게 한다.
978
1044
 
979
- 값이 길어질 수 있는데 `SInput` 을 쓰면 사용자가 자기가 쓴 것을 다시 읽지 못한다 — 한 줄 안에서 좌우로 스크롤해야 하기 때문이다. 반대로 짧은 값에 `STextarea` 를 쓰면 빈 공간이 남아 입력량을 잘못 기대하게 한다.
1045
+ `SSearchInput` 은 폼 필드가 아니다 — 라벨·힌트·유효성 규칙·에러 메시지를 받지 않고, `SForm` 의 제출 검증 대상에도 들어가지 않는다. 돋보기 아이콘이 항상 앞에 붙어 "여기는 검색"임을 스스로 밝히므로 라벨을 따로 붙이지 않는다. 검색 실행은 `onSearch`(Enter) 로 받고, 값이 바뀔 때마다 좁히는 실시간 필터라면 `onValueChange` 만 쓴다. 반대로 검색어를 **저장하거나 검증해야 한다면** 그것은 폼 값이므로 `SInput` 이다.
980
1046
 
981
1047
  #### 3-7-2. 하나를 고르게 하는 다섯 — SSelect vs SRadioGroup vs SRadioButton vs STabs vs SRadio
982
1048
 
@@ -1013,11 +1079,25 @@ const columns: STableColumn[] = [
1013
1079
  | 판별 | 사용 |
1014
1080
  | --- | --- |
1015
1081
  | 날짜 **하나**를 값으로 받는다 | `SDatePicker` |
1082
+ | 연도 선택 리스트만 필요하다 (트리거·팝오버는 직접 조합) | `SDatePickerYearListbox` |
1083
+ | 연도+월 선택 리스트만 필요하다 (트리거·팝오버는 직접 조합) | `SDatePickerMonthListbox` |
1016
1084
  | **시작~종료** 를 값으로 받는다 | `SDateRangePicker` |
1017
1085
  | 달력 격자 **자체가 화면 콘텐츠** 다 (일정·이벤트 보기) | `SCalendar` |
1018
1086
 
1019
1087
  - **기간을 `SDatePicker` 두 개로 만들지 않는다.** 시작이 종료보다 뒤인 입력을 막는 검증과 한쪽만 고른 중간 상태 처리가 `SDateRangePicker` 안에 이미 있다. 두 개로 쪼개면 그게 전부 앱 몫이 된다.
1020
1088
  - `SDatePicker`·`SDateRangePicker` 는 내부적으로 `SCalendar` 를 팝오버로 띄운다. 값을 받는 자리에 `SCalendar` 를 직접 쓰지 않는다.
1089
+ - `SDatePickerYearListbox`·`SDatePickerMonthListbox` 는 `SDatePicker` 의 mode listbox 조각만 떼어낸 컴포넌트다. 일반 폼 입력에는 `SDatePicker mode="year" | "month"` 를 우선 쓰고, 다른 트리거·팝오버 안에 리스트만 끼워 넣을 때만 직접 쓴다.
1090
+
1091
+ **날짜·시간 피커는 폭 상한을 스스로 갖는다 — `width` 를 주지 않는다.** 값 길이가 `YYYY-MM-DD` 처럼 정해져 있어 컴포넌트가 사이즈별 상한을 안다. `SKeyValueTable` 이 모든 컨트롤에 `width="100%"` 를 넘기지만, 이 상한 덕분에 행 전체로 늘어나지 않고 제 폭에서 멈춘다.
1092
+
1093
+ | 컴포넌트 | `size="sm"` | `size="md"` |
1094
+ | --- | --- | --- |
1095
+ | `SDatePicker` | md | lg |
1096
+ | `SDateRangePicker` | lg | xl |
1097
+ | `STimePicker` | md | lg |
1098
+ | `STimeRangePicker` | md | lg (오전/오후 표시는 두 사이즈 모두 lg) |
1099
+
1100
+ `SDateRangePicker` 가 한 등급씩 위인 것은 값이 `YYYY-MM-DD ~ YYYY-MM-DD` 로 두 배가 넘기 때문이다. 같은 이유로 `STimeRangePicker` 의 오전/오후 모드도 sm 에서 한 등급 위를 쓴다 — 그 모드의 최소 폭이 md 등급을 이미 넘어, 그대로 두면 하한이 상한을 넘어 상한이 무력해진다.
1021
1101
 
1022
1102
  #### 3-7-5. SField 를 직접 쓰는 경우
1023
1103
 
@@ -1065,7 +1145,7 @@ const columns: STableColumn[] = [
1065
1145
 
1066
1146
  - 페이지 골격에서 콘텐츠를 묶는 섹션은 **사실상 전부 `SSectionHeaderCard`** 다 (§4-4·§4-5). 제목·필수 표시·도움말·헤더 우측 액션이 전부 여기 붙는다.
1067
1147
  - **카드 안에 카드를 겹치지 않는다.** 섹션 안을 더 나눠야 하면 `SDivider` 로 끊거나(§3-6) 섹션을 둘로 분리한다.
1068
- - 안쪽 여백은 `SSectionHeaderCard.Body` 의 `padding` prop 으로 준다 — `p-sd-*` 를 직접 주지 않는다 (§2-2).
1148
+ - 안쪽 여백은 `SSectionHeaderCard` 의 `padding` prop 으로 준다 — `p-sd-*` 를 직접 주지 않는다 (§2-2).
1069
1149
 
1070
1150
  #### 3-7-9. SLinearProgress vs SCircleProgress
1071
1151
 
@@ -1094,6 +1174,23 @@ const columns: STableColumn[] = [
1094
1174
  - 검색 실행 시점이 다르다 — `SKeyValueTable` 필터는 앱이 검색 버튼을 직접 놓지만, `SChipFilter` 는 편집 팝오버가 닫히거나 "검색" 을 누를 때 `onSearch` 가 값 맵과 함께 호출된다. 값이 바뀌지 않았으면 호출되지 않는다.
1095
1175
  - 함께 걸어야 하는 조건(예: 기간 중 하나는 필수)이 있으면 `fields` 를 그룹으로 넘긴다. 규칙을 못 채운 동안 경고 툴팁이 떠 있고 `onSearch` 가 막힌다.
1096
1176
 
1177
+ #### 3-7-12. 이미지 — SImage
1178
+
1179
+ 사진·썸네일은 `<img>` 를 직접 쓰지 않고 `SImage` 를 쓴다. **로딩·실패 상태를 컴포넌트가 이미 처리하기 때문이다.**
1180
+
1181
+ - **로딩 스피너와 실패 표시를 앱이 만들지 않는다.** `src` 가 없거나 로드에 실패하면 빈 이미지 아이콘이, 로딩 중에는 스피너가 자동으로 놓인다. 크기는 상자 높이에 비례하므로 썸네일이든 큰 미리보기든 따로 맞출 것이 없다.
1182
+ - **크기는 `ratio` 와 너비로 준다.** `ratio` 기본값이 `1`(정사각형)이라 너비만 주면 정사각형이 된다. `className`/`style` 로 높이를 직접 주면 그쪽이 이기고 `ratio` 는 무시된다.
1183
+ - 상자를 채우는 방식은 `fit`(기본 `cover`), 붙는 위치는 `position` 이다. 안쪽 `<img>` 에 네이티브 속성이 필요하면 `imgProps` 로 넘긴다 — 목록에서 고스트 드래그를 막는 `imgProps={{ draggable: false }}` 가 대표적이다.
1184
+ - 썸네일이 많은 목록에서는 `loadingShowDelay` 를 준다. 캐시된 이미지가 즉시 로드될 때 스피너가 한 프레임 번쩍이는 것을 막는다.
1185
+
1186
+ ```tsx
1187
+ ✅ <SImage src={item.thumbnailUrl} alt={item.name} style={{ width: 64 }} /> {/* 정사각 썸네일 */}
1188
+ ✅ <SImage src={banner} ratio={16 / 9} className="w-full" /> {/* 가로형 배너 */}
1189
+
1190
+ ❌ <img src={item.thumbnailUrl} /> {/* 로딩·실패 상태가 없다 */}
1191
+ ❌ {loading ? <SCircleProgress indeterminate /> : <SImage src={url} />} {/* SImage 가 이미 한다 */}
1192
+ ```
1193
+
1097
1194
  ---
1098
1195
 
1099
1196
  ## 4. 페이지 레시피 — 표준 골격
@@ -1120,15 +1217,27 @@ export default function AppShell({
1120
1217
  children,
1121
1218
  header,
1122
1219
  scrollEndSpacing,
1123
- }: { children: React.ReactNode; header?: SPageHeaderProps; scrollEndSpacing?: boolean }) {
1220
+ contentHeight,
1221
+ }: {
1222
+ children: React.ReactNode;
1223
+ header?: SPageHeaderProps;
1224
+ scrollEndSpacing?: boolean;
1225
+ contentHeight?: SPageContentHeight;
1226
+ }) {
1124
1227
  return (
1125
1228
  <SLayout type="box" header="fix">
1126
1229
  {/* type/header/folded 는 SLayout 에만 준다 — SGnb 는 context 에서 읽는다 */}
1127
1230
  <SGnb items={MENU} value={current} onValueChange={navigate} logo={<Logo />} />
1128
1231
  {/* 콘텐츠 패딩은 SPage 가 토큰으로 넣는다 — p-sd-* 로 덮어쓰지 않는다 */}
1129
1232
  {/* 스크롤 끝 여백도 SPage 가 넣는다. 끄는 건 페이지네이션 있는 목록뿐이라 페이지가 정한다 */}
1233
+ {/* 본문이 남은 높이를 채우는 목록 페이지는 contentHeight="fill" 을 넘긴다 (§4-2) */}
1130
1234
  {/* header 는 페이지마다 달라 AppShell 이 그대로 받아 넘긴다 — 페이지 제목은 여기서 만들지 않는다 */}
1131
- <SPage background="frame" scrollEndSpacing={scrollEndSpacing} header={header}>
1235
+ <SPage
1236
+ background="frame"
1237
+ scrollEndSpacing={scrollEndSpacing}
1238
+ contentHeight={contentHeight}
1239
+ header={header}
1240
+ >
1132
1241
  {children}
1133
1242
  </SPage>
1134
1243
  </SLayout>
@@ -1170,7 +1279,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
1170
1279
 
1171
1280
  **최소 너비는 `SLayout` 이 보장한다 — 앱이 `min-w-*` 를 직접 주지 않는다.** 창이 최소 너비(`SLAYOUT_MIN_WIDTH`, GNB 포함한 전체 기준)보다 좁아지면 GNB·상단바는 제자리에 남고 **`SPage` 안에만 가로 스크롤이 생긴다.** 문서(브라우저 창)에는 가로 스크롤이 생기지 않는다. 그래서 셸을 감싸는 요소에 `min-width` 나 `overflow-x` 를 걸지 않는다 — 걸면 창 전체가 스크롤되어 GNB 가 화면 밖으로 밀린다.
1172
1281
 
1173
- **셸의 `SPage` 는 모든 페이지가 공유하므로, 스크롤 끝 여백을 끄려면 페이지가 셸에 알려야 한다.** 위처럼 프레임 컴포넌트가 `scrollEndSpacing` 을 받아 그대로 넘기고, 페이지네이션이 있는 목록 페이지만 `false` 를 준다 (§4-2). 나머지 페이지는 넘기지 않으면 기본값(켬)이 적용된다.
1282
+ **셸의 `SPage` 는 모든 페이지가 공유하므로, 페이지마다 달라지는 것은 페이지가 셸에 알려야 한다.** 위처럼 프레임 컴포넌트가 `scrollEndSpacing` · `contentHeight` 를 받아 그대로 넘기고, 페이지네이션이 있는 목록 페이지만 `contentHeight="fill"` 을 준다 (§4-2). 나머지 페이지는 넘기지 않으면 기본값(`auto`, 스크롤 끝 여백 켬)이 적용된다.
1174
1283
 
1175
1284
  **상단바 배치는 `header` 가 정한다.** 요소 순서가 달라지므로 슬롯을 채우기 전에 어느 쪽인지부터 정한다.
1176
1285
 
@@ -1192,7 +1301,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
1192
1301
  topContent={
1193
1302
  /* 남는 폭 전체를 받는다 — 왼쪽은 그대로, 오른쪽 끝은 ml-auto */
1194
1303
  <div className="flex w-full items-center gap-sd-8">
1195
- <SInput value={keyword} onValueChange={setKeyword} placeholder="통합 검색" />
1304
+ <SSearchInput value={keyword} onValueChange={setKeyword} onSearch={runSearch} placeholder="통합 검색" />
1196
1305
  <SButton size="sm" color="neutral" outline label="내 계정" className="ml-auto" onClick={openAccount} />
1197
1306
  </div>
1198
1307
  }
@@ -1209,7 +1318,7 @@ import { SModalOutlet } from 'sellmate-design-system-react';
1209
1318
  {/* 접히면 menuTop·menuFooter 가 함께 빠지므로, 폴드 레일에 남길 것만 foldedTop 으로 따로 준다 */}
1210
1319
  <SGnb
1211
1320
  items={MENU} value={current} onValueChange={navigate} useRail
1212
- menuTop={<SInput value={keyword} onValueChange={setKeyword} placeholder="메뉴 검색" />}
1321
+ menuTop={<SSearchInput value={keyword} onValueChange={setKeyword} placeholder="메뉴 검색" />}
1213
1322
  menuFooter={<AccountRow />}
1214
1323
  foldedTop={<SGhostButton icon="search" size="sm" ariaLabel="메뉴 검색" onClick={openSearch} />}
1215
1324
  />
@@ -1228,7 +1337,9 @@ import { SModalOutlet } from 'sellmate-design-system-react';
1228
1337
  - **페이지 제목 줄에는 이 페이지의 주요 액션을 두지 않는다.** 부가적인 것만 `header.slot` 에 `SButton size="sm"` 으로 온다 (§4-1 "페이지 헤더 사용 규칙").
1229
1338
  - **주요 액션(등록 등)은 `STableBar` 의 `rightActions`** 에 둔다.
1230
1339
  - **선택 상태 액션(선택 삭제 등)은 `STableBar` 의 `actions`** 에 둔다. `actions` 슬롯은 건수 요약이 있으면 앞에 구분선(`SDivider`)을 **자동으로** 넣으므로 직접 구분선을 만들지 않는다.
1231
- - **페이지네이션이 있으면 스크롤 끝 여백을 끈다** — `AppShell` 에 `scrollEndSpacing={false}` 를 넘긴다 (§2-2). 페이지네이션이 이미 "여기서 끝"을 알려준다.
1340
+ - **페이지네이션이 있으면 본문이 남은 높이를 채우게 한다** — `AppShell` 에 `contentHeight="fill"` 을 넘긴다. 페이지가 통째로 스크롤되면 페이지네이션이 화면 밖으로 밀려 "여기서 끝"이 읽히지 않는다. `fill` 이면 **표만 자기 안에서 스크롤하고 페이지네이션은 하단에 고정**된다.
1341
+ - 본문 루트에 `h-full min-h-0` 으로 세로 축을 잇고, 남은 높이를 먹을 `STable` 에 `min-h-0 flex-1` 을 준다. 이 사슬이 하나라도 끊기면 표가 높이를 못 잡는다.
1342
+ - `fill` 에서는 페이지가 스크롤하지 않으므로 **`scrollEndSpacing` 은 무시된다** — 따로 끄지 않는다 (§2-2).
1232
1343
 
1233
1344
  ```tsx
1234
1345
  import {
@@ -1276,9 +1387,10 @@ export default function ProductListPage() {
1276
1387
  // 이 페이지의 주요 액션이 아니라 부가 액션 — slot 은 sm 버튼으로만 채운다
1277
1388
  slot: <SButton size="sm" color="neutral" outline label="이용 가이드" onClick={openGuide} />,
1278
1389
  }}
1279
- scrollEndSpacing={false} // 페이지네이션이 있으므로 끈다
1390
+ contentHeight="fill" // 표가 남은 높이를 채우고 페이지네이션이 하단에 고정된다
1280
1391
  >
1281
- <div className="flex flex-col gap-sd-12">
1392
+ {/* h-full min-h-0 → STable 의 min-h-0 flex-1 로 세로 축이 이어진다 */}
1393
+ <div className="flex h-full min-h-0 flex-col gap-sd-12">
1282
1394
  {/* 필터 — search 를 켜면 우측에 검색 패널이 붙는다 */}
1283
1395
  <SKeyValueTable
1284
1396
  fields={filterFields}
@@ -1303,7 +1415,9 @@ export default function ProductListPage() {
1303
1415
  }
1304
1416
  />
1305
1417
 
1418
+ {/* 남은 높이를 채우고 본문만 스크롤한다 — 페이지네이션 바는 표 안에서 하단 고정 */}
1306
1419
  <STable
1420
+ className="min-h-0 flex-1"
1307
1421
  columns={columns}
1308
1422
  rows={rows}
1309
1423
  rowKey="id"
@@ -1389,7 +1503,7 @@ export default function ProductCreatePage() {
1389
1503
 
1390
1504
  - 조회 값은 `type: 'text'` 행으로 표시한다. **상태·분류 태그도 별도 영역이 아니라 표의 한 행**으로 넣는다 (`render` 에 `STag`).
1391
1505
  - 행이 많아지면 **유형별로 섹션을 나누고, 각 섹션을 `SSectionHeaderCard` 로 감싼다.**
1392
- 합성 컴포넌트라 `SSectionHeaderCard.Header` / `SSectionHeaderCard.Body` 를 자식으로 쓴다.
1506
+ 섹션 제목은 `title` prop 으로, 바디 여백은 `padding` prop 으로 준다.
1393
1507
  - **수정·삭제 버튼은 하단에 둔다.** 내용이 짧아 우측 상단에 두는 변형도 있으나 기본은 하단이다.
1394
1508
 
1395
1509
  ```tsx
@@ -1422,24 +1536,18 @@ export default function ProductDetailPage() {
1422
1536
  // 목록에서 들어온 상세 페이지 — onBack 으로 뒤로가기를 준다
1423
1537
  <AppShell header={{ fix: true, title: '클래식 셔츠', onBack: goList }}>
1424
1538
  <div className="flex flex-col gap-sd-12">
1425
- <SSectionHeaderCard>
1426
- <SSectionHeaderCard.Header title="기본 정보" marker thickness="accent" />
1427
- <SSectionHeaderCard.Body>
1428
- <SKeyValueTable fields={basicFields} values={product} />
1429
- </SSectionHeaderCard.Body>
1539
+ <SSectionHeaderCard title="기본 정보" marker thickness="accent">
1540
+ <SKeyValueTable fields={basicFields} values={product} />
1430
1541
  </SSectionHeaderCard>
1431
1542
 
1432
- <SSectionHeaderCard>
1433
- {/* 헤더 우측에 액션이 필요하면 slot 을 쓴다 */}
1434
- <SSectionHeaderCard.Header
1435
- title="가격 정보"
1436
- marker
1437
- helpText={['부가세 포함 금액입니다.']}
1438
- slot={<SButton size="sm" color="secondary" label="이력" onClick={openHistory} />}
1439
- />
1440
- <SSectionHeaderCard.Body>
1441
- <SKeyValueTable fields={priceFields} values={product} />
1442
- </SSectionHeaderCard.Body>
1543
+ {/* 헤더 우측에 액션이 필요하면 slot 을 쓴다 */}
1544
+ <SSectionHeaderCard
1545
+ title="가격 정보"
1546
+ marker
1547
+ helpText={['부가세 포함 금액입니다.']}
1548
+ slot={<SButton size="sm" color="secondary" label="이력" onClick={openHistory} />}
1549
+ >
1550
+ <SKeyValueTable fields={priceFields} values={product} />
1443
1551
  </SSectionHeaderCard>
1444
1552
 
1445
1553
  {/* 액션은 하단 — 목록(되돌리기)은 왼쪽 끝, 실행 액션은 오른쪽 끝 */}
@@ -1488,8 +1596,8 @@ export default function ProductDetailPage() {
1488
1596
  - [ ] 텍스트 회색 위계를 순차 적용했는가 (기본 → `text-fg-secondary` → `text-fg-tertiary`, 단계 건너뛰기 ❌)
1489
1597
  - [ ] `SPage`·`SPopup` 의 기본 패딩을 `p-sd-*` 로 덮어쓰지 않았는가, 블록·섹션 **간격**이 `gap-sd-12` 인가 (`gap-sd-16`/`gap-sd-24` ❌ — 24 는 안쪽 여백에만 열린다)
1490
1598
  - [ ] 섹션·패널의 안쪽 **여백**이 §2-2 판정과 맞는가 (덩어리 두 종류 → 16 / 세 종류 이상 → 24, 서면 16)
1491
- - [ ] `SSectionHeaderCard.Body` 의 여백을 `p-sd-*` 가 아니라 `padding` prop 으로 줬는가
1492
- - [ ] 자체 스크롤하는 패널의 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` 이 있는가, 페이지네이션 있는 목록에서 `scrollEndSpacing={false}` 를 넘겼는가
1599
+ - [ ] `SSectionHeaderCard` 의 여백을 `p-sd-*` 가 아니라 `padding` prop 으로 줬는가
1600
+ - [ ] 자체 스크롤하는 패널의 하단에 `pb-[var(--cmp-pageBody-padding-scrollEnd)]` 이 있는가, 페이지네이션 있는 목록에서 `contentHeight="fill"` 을 넘기고 `h-full min-h-0` → `STable` 의 `min-h-0 flex-1` 사슬을 이었는가
1493
1601
  - [ ] 같은 컴포넌트를 나열할 때 §2-2 그룹 간격을 썼는가 (체크박스 가로 `gap-sd-24` 등)
1494
1602
  - [ ] 페이지가 §4의 표준 골격에서 시작했는가
1495
1603
  - [ ] `header.fix` 가 프로젝트 전체와 같은 값인가 (다른 페이지와 다르게 섞어 쓰지 않았는가, §4-1)
@@ -1576,7 +1684,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
1576
1684
  - oceanblue: 15 25 50 60 65 70 75 80 85 90 95 99
1577
1685
  - brilliantblue: 10 20 25 40 50 60 70 75 80 85 90 95 99 05
1578
1686
  - bg: screen frame brand subtle accent accentLight accentBright accentFaint deep danger dangerLight warning caution progress success successLight neutralLight neutralBright tableHeader
1579
- - fg: primary secondary tertiary quaternary brand subtleWarm subtleCool deep success dangerLight accent accentLight danger warning inverse
1687
+ - fg: primary secondary tertiary quaternary brand subtleWarm subtleCool deep success successLight dangerLight accent accentLight danger warning inverse
1580
1688
  - border: default strong bold accent accentLight danger warning success
1581
1689
  - disabled: bg text icon border
1582
1690
  - link: accent
@@ -1702,6 +1810,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
1702
1810
  --sys-color-fg-subtleCool
1703
1811
  --sys-color-fg-subtleWarm
1704
1812
  --sys-color-fg-success
1813
+ --sys-color-fg-successLight
1705
1814
  --sys-color-fg-tertiary
1706
1815
  --sys-color-fg-warning
1707
1816
  --sys-color-field-bg-default
@@ -1723,7 +1832,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
1723
1832
  --sys-color-link-accent
1724
1833
  --sys-color-navigation-gnb-bg-dark
1725
1834
 
1726
- ## 3. 컴포넌트 인덱스 (64종)
1835
+ ## 3. 컴포넌트 인덱스 (66종)
1727
1836
 
1728
1837
  **Props 는 이 문서에 없다.** 쓸 컴포넌트를 정했으면 그 컴포넌트의 README 를 읽는다.
1729
1838
 
@@ -1732,4 +1841,4 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
1732
1841
  예) SButton 을 쓴다면 `dist/components/SButton/README.md`.
1733
1842
  prop 을 추측해서 쓰지 말고 반드시 README 로 확인한다 (분류별 용도는 §1 의 "전체 컴포넌트 인덱스" 참조).
1734
1843
 
1735
- SActionModal · SBadge · SBarcodeInput · SButton · SCalendar · SCallout · SCard · SCheckbox · SChip · SChipFilter · SChipInput · SCircleProgress · SConfirmModal · SDatePicker · SDateRangePicker · SDivider · SDraggableItem · SDraggableList · SDrawer · SDropdownButton · SExpansionItem · SExpansionList · SField · SFilePicker · SForm · SGhostButton · SGnb · SGuide · SIcon · SInput · SKeyValueTable · SLayout · SLinearProgress · SList · SListItem · SLoadingContainer · SLoadingModal · SModal · SNumberInput · SPage · SPagination · SPopover · SPopup · SPortal · SRadio · SRadioButton · SScrollArea · SSectionHeaderCard · SSelect · SSplitter · SStepper · SSwitch · STable · STableBar · STabs · STag · STextLink · STextarea · STimePicker · STimeRangePicker · SToast · SToggle · STooltip · STree
1844
+ SActionModal · SBadge · SBarcodeInput · SButton · SCalendar · SCallout · SCard · SCheckbox · SChip · SChipFilter · SChipInput · SCircleProgress · SConfirmModal · SDatePicker · SDateRangePicker · SDivider · SDraggableItem · SDraggableList · SDrawer · SDropdownButton · SExpansionItem · SExpansionList · SField · SFilePicker · SForm · SGhostButton · SGnb · SGuide · SIcon · SImage · SInput · SKeyValueTable · SLayout · SLinearProgress · SList · SListItem · SLoadingContainer · SLoadingModal · SModal · SNumberInput · SPage · SPagination · SPopover · SPopup · SPortal · SRadio · SRadioButton · SScrollArea · SSearchInput · SSectionHeaderCard · SSelect · SSplitter · SStepper · SSwitch · STable · STableBar · STabs · STag · STextLink · STextarea · STimePicker · STimeRangePicker · SToast · SToggle · STooltip · STree