sellmate-design-system-react 9.0.0-beta.24 → 9.0.0-beta.25

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.
@@ -34,7 +34,7 @@
34
34
 
35
35
  | 분류 | 컴포넌트 |
36
36
  | --- | --- |
37
- | **버튼·링크** | `SButton` `SGhostButton` `SDropdownButton` `STextLink` `SSwitch` `SToggle` |
37
+ | **버튼·링크** | `SButton` `SGhostButton` `SDropdownButton` `SSystemActionButton` `STextLink` `SSwitch` `SToggle` |
38
38
  | **입력 (폼)** | `SForm` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SEditor` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
39
39
  | **날짜·시간** | `SCalendar` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
40
40
  | **표·목록** | `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SListItem` `SExpansionList` `SDraggableList` `SDraggableItem` `STree` |
@@ -160,7 +160,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
160
160
  | --- | --- | --- |
161
161
  | **셸** | 앱 전체 뼈대. 페이지가 바뀌어도 남는다 | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) |
162
162
  | **블록** | `SPage` 의 직계 자식. 페이지를 세로로 쌓는 단위 | `SSectionHeaderCard` `SCard` `SForm` `SSplitter` `SScrollArea` `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SExpansionList` `SDraggableList` `STree` `SCallout` `STabs` `SStepper` `SPagination` `SDivider` |
163
- | **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `SButton` `SGhostButton` `SDropdownButton` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SEditor` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SSwitch` `SToggle` `SChipInput` `SBarcodeInput` `SFilePicker` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` `SCalendar` `SListItem` `SExpansionItem` `SDraggableItem` `SImage` `SLinearProgress` `SCircleProgress` |
163
+ | **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `SButton` `SGhostButton` `SDropdownButton` `SSystemActionButton` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SEditor` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SSwitch` `SToggle` `SChipInput` `SBarcodeInput` `SFilePicker` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` `SCalendar` `SListItem` `SExpansionItem` `SDraggableItem` `SImage` `SLinearProgress` `SCircleProgress` |
164
164
  | **인라인** | 텍스트 흐름·셀·라벨 안에 섞인다. 혼자 블록이 되지 않는다 | `STag` `SBadge` `SIcon` `STextLink` `SChip` |
165
165
  | **레이어** | 문서 흐름 **밖**에 떠서 그려진다. 어느 층에서 띄우든 레이아웃에 영향이 없다 | `SModal` `SActionModal` `SConfirmModal` `SPopup` `SDrawer` `SPopover` `STooltip` `SPortal` `SToast` `SLoadingModal` `SLoadingContainer` `SGuide` |
166
166
 
@@ -531,6 +531,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
531
531
  | 라벨이 있는 일반 액션을 준다 | `SButton` | §3-5 |
532
532
  | 아이콘 하나로 뜻이 통하는 부가 조작을 준다 | `SGhostButton` | §3-5-5 |
533
533
  | 한 버튼에 여러 선택지를 매단다 | `SDropdownButton` | §3-5-4 |
534
+ | GNB system 패널에서 한 줄짜리 행 액션을 준다 | `SSystemActionButton` | §3-5-7 |
534
535
 
535
536
  #### D. 화면을 담고 나눈다
536
537
 
@@ -1020,6 +1021,7 @@ const columns: STableColumn[] = [
1020
1021
  | **아이콘 하나로 뜻이 통하는 부가 조작** | **`SGhostButton`** — 라벨이 없는 아이콘 전용 버튼 (아래 3-5-5) |
1021
1022
  | 본문 속 이동 링크 | `STextLink` |
1022
1023
  | 메인 액션 + 부가 메뉴 | `SDropdownButton` |
1024
+ | **GNB system 패널의 한 줄 액션** | **`SSystemActionButton`** — 행 전체가 버튼인 표면형 (아래 3-5-7) |
1023
1025
 
1024
1026
  #### 3-5-1. 채움 버튼은 페이지당 개수 제한이 있다
1025
1027
 
@@ -1152,6 +1154,34 @@ const columns: STableColumn[] = [
1152
1154
  </div>
1153
1155
  ```
1154
1156
 
1157
+ #### 3-5-7. `SSystemActionButton` — GNB system 패널의 한 줄 액션
1158
+
1159
+ **행 전체가 하나의 버튼**인 표면형 컨트롤이다. 아이콘 프레임 + 라벨 + 우측 액션이 한 줄에 붙고, hover 하면 표면색이 한 단계 바뀐다.
1160
+
1161
+ | 상황 | 사용 |
1162
+ | --- | --- |
1163
+ | 페이지·모달의 일반 액션 | `SButton` — 라벨 폭만큼만 차지한다 |
1164
+ | 목록에서 항목 하나를 고르게 한다 | `SListItem` · `STree` (§3-7-6·§3-7-7) |
1165
+ | 좌측 내비게이션의 메뉴 | `SGnb` 의 `menus` (§4-1) |
1166
+ | **GNB system 패널에서 설정·연결 상태를 한 줄씩 쌓고, 그 줄을 눌러 들어가게 한다** | **`SSystemActionButton`** |
1167
+
1168
+ **무엇이 그려지는지는 `type` 이 정한다.** 타입마다 다른 값만 `option` 으로 받으므로, 타입에 맞지 않는 `option` 은 타입 에러가 된다.
1169
+
1170
+ | `type` | 선행 아이콘 | 라벨 | 우측 | 언제 |
1171
+ | --- | --- | --- | --- | --- |
1172
+ | `account` | `user` 고정 | `label` | 없음 | 로그인한 계정을 보여주고 계정 화면으로 보낼 때 |
1173
+ | `select` | `option.icon` (필수) | `label` | 화살표 | 눌러서 하위 화면으로 들어갈 때 |
1174
+ | `switch` | `option.icon` (필수) | `label` | `option.text` + 새로고침 | 지금 붙어 있는 대상을 갈아 끼울 때 |
1175
+ | `subSelect` | `option.icon` (필수) | `label` | `option.text` + 화살표 | 지금 선택돼 있는 값을 함께 보여줄 때 |
1176
+ | `status` | 없음 | 상태 태그(`option.color`·`option.label`) | 화살표 | 라벨 대신 상태 자체가 제목일 때 |
1177
+
1178
+ - **`SPage` 본문에 직접 놓지 않는다.** 폭을 가득 채우는 행이라 페이지에 바로 놓으면 표처럼 보인다. GNB system 패널·`SDrawer`·`SPopover` 처럼 **좁은 폭이 정해진 자리**에 쌓는다. 행 사이 간격은 `--cmp-gnb-system-panel-gap` 이다.
1179
+ - **`color` 는 놓이는 표면을 따라간다** — 흰 면이면 `light`, 오션블루 면이면 `dark`, 네이비 면이면 `darker`. 배경과 다른 색을 고르면 버튼만 떠 보인다.
1180
+ - **상태는 default·hover 둘뿐이다.** 토큰에 selected 가 없으므로 "지금 열려 있는 항목"을 이 버튼으로 표시하지 않는다. 선택 상태가 필요한 자리면 `SGnb` 메뉴나 `SListItem`(§3-7-6) 이다.
1181
+ - **선행 아이콘이 비는 행은 없다.** `account` 는 `user` 고정, `status` 는 태그가 자리를 차지하고, 나머지는 `option.icon` 이 필수다.
1182
+ - **우측 아이콘은 `type` 이 정하므로 밖에서 바꾸지 않는다.** 화살표가 필요한데 문구가 없으면 `select`, 문구가 함께 필요하면 `subSelect` 다.
1183
+ - 높이·라운드·아이콘 크기·좌우 여백은 전부 토큰이 넣는다. 직접 주지 않는다.
1184
+
1155
1185
  ### 3-6. 영역 나누기 — SDivider vs SSplitter
1156
1186
 
1157
1187
  | 상황 | 사용 |
@@ -2049,6 +2079,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2049
2079
  | typo-body-xs-default | 11px | 400 | 18px |
2050
2080
  | typo-body-sm-default | 12px | 400 | 20px |
2051
2081
  | typo-body-sm-medium | 12px | 500 | 20px |
2082
+ | typo-body-sm-semibold | 12px | 600 | 20px |
2052
2083
  | typo-body-sm-bold | 12px | 700 | 20px |
2053
2084
  | typo-body-md-default | 14px | 400 | 24px |
2054
2085
  | typo-body-md-medium | 14px | 500 | 24px |
@@ -2171,6 +2202,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2171
2202
  --sys-color-lightblue-subtle
2172
2203
  --sys-color-link-accent
2173
2204
  --sys-color-navigation-gnb-bg-dark
2205
+ --sys-color-navigation-gnb-bg-system
2174
2206
 
2175
2207
  ## 3. 컴포넌트 카탈로그 (Props / Events / Methods / Types)
2176
2208
 
@@ -4532,6 +4564,7 @@ export type SGuideMessage = string | SGuideMessage[];
4532
4564
  - [SSectionHeaderCard](../SSectionHeaderCard)
4533
4565
  - [SSelect](../SSelect)
4534
4566
  - [SStepper](../SStepper)
4567
+ - [SSystemActionButton](../SSystemActionButton)
4535
4568
  - [STable](../STable)
4536
4569
  - [STag](../STag)
4537
4570
  - [STextLink](../STextLink)
@@ -6266,6 +6299,131 @@ export const STEPPER_SIZES = ['sm', 'lg'] as const;
6266
6299
 
6267
6300
  ---
6268
6301
 
6302
+ # SSystemActionButton
6303
+
6304
+ > 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
6305
+
6306
+ ### SSystemActionButtonAccount
6307
+
6308
+ #### Props
6309
+
6310
+ | Prop | Type | Default | Description |
6311
+ |------|------|---------|-------------|
6312
+ | `type` | `'account'` | — | 계정 행 |
6313
+ | `label?` | `string` | — | 라벨 텍스트 |
6314
+ | `option?` | `never` | — | 아이콘이 `user` 로 고정이라 받을 것이 없다 |
6315
+
6316
+ ### SSystemActionButtonBase
6317
+
6318
+ #### Props
6319
+
6320
+ | Prop | Type | Default | Description |
6321
+ |------|------|---------|-------------|
6322
+ | `color?` | `SSystemActionButtonColor` | — | 색상(놓이는 표면). light = 흰 면, dark = 오션블루 면, darker = 네이비 면. 기본 `'light'` |
6323
+ | `disabled?` | `boolean` | — | 비활성 여부. 기본 `false` |
6324
+
6325
+ ### SSystemActionButtonSelect
6326
+
6327
+ #### Props
6328
+
6329
+ | Prop | Type | Default | Description |
6330
+ |------|------|---------|-------------|
6331
+ | `type` | `'select'` | — | 화살표만 붙는 행 |
6332
+ | `label?` | `string` | — | 라벨 텍스트 |
6333
+ | `option` | `SSystemActionButtonIconOption` | — | 선행 아이콘 |
6334
+
6335
+ ### SSystemActionButtonStatus
6336
+
6337
+ #### Props
6338
+
6339
+ | Prop | Type | Default | Description |
6340
+ |------|------|---------|-------------|
6341
+ | `type` | `'status'` | — | 라벨 자리에 상태 태그가 들어가는 행 |
6342
+ | `label?` | `never` | — | 태그가 라벨 자리를 차지하므로 받지 않는다 |
6343
+ | `option?` | `SSystemActionButtonStatusOption` | — | 상태 태그 |
6344
+
6345
+ ### SSystemActionButtonText
6346
+
6347
+ #### Props
6348
+
6349
+ | Prop | Type | Default | Description |
6350
+ |------|------|---------|-------------|
6351
+ | `type` | `'switch' \| 'subSelect'` | — | 우측에 문구가 붙는 행. switch = 보조 조작 문구, subSelect = 지금 선택된 값 |
6352
+ | `label?` | `string` | — | 라벨 텍스트 |
6353
+ | `option` | `SSystemActionButtonTextOption` | — | 선행 아이콘 + 우측 액션 텍스트 |
6354
+
6355
+ ## Types
6356
+
6357
+ ### SSystemActionButtonColor
6358
+
6359
+ ```ts
6360
+ export type SSystemActionButtonColor = (typeof SYSTEM_ACTION_BUTTON_COLORS)[number];
6361
+ ```
6362
+
6363
+ ### SSystemActionButtonIconOption
6364
+
6365
+ ```ts
6366
+ /** 선행 아이콘만 받는 타입(`select`)의 option */
6367
+ export interface SSystemActionButtonIconOption {
6368
+ /** 선행 아이콘명 */
6369
+ icon: SIconName;
6370
+ }
6371
+ ```
6372
+
6373
+ ### SSystemActionButtonStatusOption
6374
+
6375
+ ```ts
6376
+ /** `status` 타입의 option — 라벨 자리에 들어가는 상태 태그 */
6377
+ export interface SSystemActionButtonStatusOption {
6378
+ /** 상태 태그 색 */
6379
+ color?: STagColor;
6380
+ /** 상태 태그 텍스트 */
6381
+ label?: string;
6382
+ }
6383
+ ```
6384
+
6385
+ ### SSystemActionButtonTextOption
6386
+
6387
+ ```ts
6388
+ /** 우측 액션 텍스트까지 받는 타입(`switch` · `subSelect`)의 option */
6389
+ export interface SSystemActionButtonTextOption extends SSystemActionButtonIconOption {
6390
+ /** 우측 액션 텍스트 */
6391
+ text?: string;
6392
+ }
6393
+ ```
6394
+
6395
+ ### SYSTEM_ACTION_BUTTON_COLORS
6396
+
6397
+ ```ts
6398
+ /**
6399
+ * SSystemActionButton 설정.
6400
+ *
6401
+ * 토큰은 GNB system 패널 한 벌(`--cmp-gnb-system-*`)을 그대로 쓴다.
6402
+ * 행 공통(높이·라운드·아이콘 프레임·라벨) → --cmp-gnb-system-item-*
6403
+ * 색(color 축) light / dark / darker → --cmp-gnb-system-item-<color>-*
6404
+ * 우측 액션(패딩·간격·아이콘·텍스트색) → --cmp-gnb-system-actionButton-*
6405
+ *
6406
+ * 타이포그래피는 CSS 변수가 아니라 `.typo-*` 프리셋으로 나온다.
6407
+ * item.label → typo-body-sm-semibold (12/600/20)
6408
+ * actionButton.switch → typo-field-sm-default (12/400/20)
6409
+ * actionButton.selectData → typo-control-xs-medium (12/500/20)
6410
+ */
6411
+
6412
+ /** 색상(표면). light = 흰 면, dark = 오션블루 면, darker = 네이비 면 */
6413
+ export const SYSTEM_ACTION_BUTTON_COLORS = ['light', 'dark', 'darker'] as const;
6414
+ ```
6415
+
6416
+ ## Dependencies
6417
+
6418
+ ### Depends on
6419
+
6420
+ - [SIcon](../SIcon)
6421
+ - [STag](../STag)
6422
+
6423
+ ### Graph
6424
+
6425
+ ---
6426
+
6269
6427
  # STable
6270
6428
 
6271
6429
  > 자동 생성 문서 — `npm run docs:gen`. 소스: 각 컴포넌트의 Props/Handle 인터페이스 + import 의존성.
@@ -6550,6 +6708,7 @@ export const TAG_COLORS = [
6550
6708
  - [SConfirmModal](../SConfirmModal)
6551
6709
  - [SGhostButton](../SGhostButton)
6552
6710
  - [SGnb](../SGnb)
6711
+ - [SSystemActionButton](../SSystemActionButton)
6553
6712
  - [STabs](../STabs)
6554
6713
  - [STextLink](../STextLink)
6555
6714
 
package/dist/llms.txt CHANGED
@@ -35,7 +35,7 @@
35
35
 
36
36
  | 분류 | 컴포넌트 |
37
37
  | --- | --- |
38
- | **버튼·링크** | `SButton` `SGhostButton` `SDropdownButton` `STextLink` `SSwitch` `SToggle` |
38
+ | **버튼·링크** | `SButton` `SGhostButton` `SDropdownButton` `SSystemActionButton` `STextLink` `SSwitch` `SToggle` |
39
39
  | **입력 (폼)** | `SForm` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SEditor` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SChip` `SChipInput` `SBarcodeInput` `SFilePicker` |
40
40
  | **날짜·시간** | `SCalendar` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` |
41
41
  | **표·목록** | `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SListItem` `SExpansionList` `SDraggableList` `SDraggableItem` `STree` |
@@ -161,7 +161,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
161
161
  | --- | --- | --- |
162
162
  | **셸** | 앱 전체 뼈대. 페이지가 바뀌어도 남는다 | `SLayout` `SGnb` `SPage`(제목 영역은 `header` prop) |
163
163
  | **블록** | `SPage` 의 직계 자식. 페이지를 세로로 쌓는 단위 | `SSectionHeaderCard` `SCard` `SForm` `SSplitter` `SScrollArea` `STable` `STableBar` `SChipFilter` `SKeyValueTable` `SList` `SExpansionList` `SDraggableList` `STree` `SCallout` `STabs` `SStepper` `SPagination` `SDivider` |
164
- | **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `SButton` `SGhostButton` `SDropdownButton` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SEditor` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SSwitch` `SToggle` `SChipInput` `SBarcodeInput` `SFilePicker` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` `SCalendar` `SListItem` `SExpansionItem` `SDraggableItem` `SImage` `SLinearProgress` `SCircleProgress` |
164
+ | **요소** | 블록 **안에** 놓이는 컨트롤. 혼자 페이지에 서지 않는다 | `SButton` `SGhostButton` `SDropdownButton` `SSystemActionButton` `SField` `SInput` `SSearchInput` `SNumberInput` `STextarea` `SEditor` `SSelect` `SCheckbox` `SRadio` `SRadioGroup` `SRadioButton` `SSwitch` `SToggle` `SChipInput` `SBarcodeInput` `SFilePicker` `SDatePicker` `SDatePickerYearListbox` `SDatePickerMonthListbox` `SDateRangePicker` `STimePicker` `STimeRangePicker` `SCalendar` `SListItem` `SExpansionItem` `SDraggableItem` `SImage` `SLinearProgress` `SCircleProgress` |
165
165
  | **인라인** | 텍스트 흐름·셀·라벨 안에 섞인다. 혼자 블록이 되지 않는다 | `STag` `SBadge` `SIcon` `STextLink` `SChip` |
166
166
  | **레이어** | 문서 흐름 **밖**에 떠서 그려진다. 어느 층에서 띄우든 레이아웃에 영향이 없다 | `SModal` `SActionModal` `SConfirmModal` `SPopup` `SDrawer` `SPopover` `STooltip` `SPortal` `SToast` `SLoadingModal` `SLoadingContainer` `SGuide` |
167
167
 
@@ -532,6 +532,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
532
532
  | 라벨이 있는 일반 액션을 준다 | `SButton` | §3-5 |
533
533
  | 아이콘 하나로 뜻이 통하는 부가 조작을 준다 | `SGhostButton` | §3-5-5 |
534
534
  | 한 버튼에 여러 선택지를 매단다 | `SDropdownButton` | §3-5-4 |
535
+ | GNB system 패널에서 한 줄짜리 행 액션을 준다 | `SSystemActionButton` | §3-5-7 |
535
536
 
536
537
  #### D. 화면을 담고 나눈다
537
538
 
@@ -1021,6 +1022,7 @@ const columns: STableColumn[] = [
1021
1022
  | **아이콘 하나로 뜻이 통하는 부가 조작** | **`SGhostButton`** — 라벨이 없는 아이콘 전용 버튼 (아래 3-5-5) |
1022
1023
  | 본문 속 이동 링크 | `STextLink` |
1023
1024
  | 메인 액션 + 부가 메뉴 | `SDropdownButton` |
1025
+ | **GNB system 패널의 한 줄 액션** | **`SSystemActionButton`** — 행 전체가 버튼인 표면형 (아래 3-5-7) |
1024
1026
 
1025
1027
  #### 3-5-1. 채움 버튼은 페이지당 개수 제한이 있다
1026
1028
 
@@ -1153,6 +1155,34 @@ const columns: STableColumn[] = [
1153
1155
  </div>
1154
1156
  ```
1155
1157
 
1158
+ #### 3-5-7. `SSystemActionButton` — GNB system 패널의 한 줄 액션
1159
+
1160
+ **행 전체가 하나의 버튼**인 표면형 컨트롤이다. 아이콘 프레임 + 라벨 + 우측 액션이 한 줄에 붙고, hover 하면 표면색이 한 단계 바뀐다.
1161
+
1162
+ | 상황 | 사용 |
1163
+ | --- | --- |
1164
+ | 페이지·모달의 일반 액션 | `SButton` — 라벨 폭만큼만 차지한다 |
1165
+ | 목록에서 항목 하나를 고르게 한다 | `SListItem` · `STree` (§3-7-6·§3-7-7) |
1166
+ | 좌측 내비게이션의 메뉴 | `SGnb` 의 `menus` (§4-1) |
1167
+ | **GNB system 패널에서 설정·연결 상태를 한 줄씩 쌓고, 그 줄을 눌러 들어가게 한다** | **`SSystemActionButton`** |
1168
+
1169
+ **무엇이 그려지는지는 `type` 이 정한다.** 타입마다 다른 값만 `option` 으로 받으므로, 타입에 맞지 않는 `option` 은 타입 에러가 된다.
1170
+
1171
+ | `type` | 선행 아이콘 | 라벨 | 우측 | 언제 |
1172
+ | --- | --- | --- | --- | --- |
1173
+ | `account` | `user` 고정 | `label` | 없음 | 로그인한 계정을 보여주고 계정 화면으로 보낼 때 |
1174
+ | `select` | `option.icon` (필수) | `label` | 화살표 | 눌러서 하위 화면으로 들어갈 때 |
1175
+ | `switch` | `option.icon` (필수) | `label` | `option.text` + 새로고침 | 지금 붙어 있는 대상을 갈아 끼울 때 |
1176
+ | `subSelect` | `option.icon` (필수) | `label` | `option.text` + 화살표 | 지금 선택돼 있는 값을 함께 보여줄 때 |
1177
+ | `status` | 없음 | 상태 태그(`option.color`·`option.label`) | 화살표 | 라벨 대신 상태 자체가 제목일 때 |
1178
+
1179
+ - **`SPage` 본문에 직접 놓지 않는다.** 폭을 가득 채우는 행이라 페이지에 바로 놓으면 표처럼 보인다. GNB system 패널·`SDrawer`·`SPopover` 처럼 **좁은 폭이 정해진 자리**에 쌓는다. 행 사이 간격은 `--cmp-gnb-system-panel-gap` 이다.
1180
+ - **`color` 는 놓이는 표면을 따라간다** — 흰 면이면 `light`, 오션블루 면이면 `dark`, 네이비 면이면 `darker`. 배경과 다른 색을 고르면 버튼만 떠 보인다.
1181
+ - **상태는 default·hover 둘뿐이다.** 토큰에 selected 가 없으므로 "지금 열려 있는 항목"을 이 버튼으로 표시하지 않는다. 선택 상태가 필요한 자리면 `SGnb` 메뉴나 `SListItem`(§3-7-6) 이다.
1182
+ - **선행 아이콘이 비는 행은 없다.** `account` 는 `user` 고정, `status` 는 태그가 자리를 차지하고, 나머지는 `option.icon` 이 필수다.
1183
+ - **우측 아이콘은 `type` 이 정하므로 밖에서 바꾸지 않는다.** 화살표가 필요한데 문구가 없으면 `select`, 문구가 함께 필요하면 `subSelect` 다.
1184
+ - 높이·라운드·아이콘 크기·좌우 여백은 전부 토큰이 넣는다. 직접 주지 않는다.
1185
+
1156
1186
  ### 3-6. 영역 나누기 — SDivider vs SSplitter
1157
1187
 
1158
1188
  | 상황 | 사용 |
@@ -2050,6 +2080,7 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2050
2080
  | typo-body-xs-default | 11px | 400 | 18px |
2051
2081
  | typo-body-sm-default | 12px | 400 | 20px |
2052
2082
  | typo-body-sm-medium | 12px | 500 | 20px |
2083
+ | typo-body-sm-semibold | 12px | 600 | 20px |
2053
2084
  | typo-body-sm-bold | 12px | 700 | 20px |
2054
2085
  | typo-body-md-default | 14px | 400 | 24px |
2055
2086
  | typo-body-md-medium | 14px | 500 | 24px |
@@ -2172,8 +2203,9 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2172
2203
  --sys-color-lightblue-subtle
2173
2204
  --sys-color-link-accent
2174
2205
  --sys-color-navigation-gnb-bg-dark
2206
+ --sys-color-navigation-gnb-bg-system
2175
2207
 
2176
- ## 3. 컴포넌트 인덱스 (67종)
2208
+ ## 3. 컴포넌트 인덱스 (68종)
2177
2209
 
2178
2210
  **Props 는 이 문서에 없다.** 쓸 컴포넌트를 정했으면 그 컴포넌트의 README 를 읽는다.
2179
2211
 
@@ -2182,4 +2214,4 @@ Tailwind 유틸리티는 아래 스케일에 있는 값만 사용한다. 리터
2182
2214
  예) SButton 을 쓴다면 `dist/components/SButton/README.md`.
2183
2215
  prop 을 추측해서 쓰지 말고 반드시 README 로 확인한다 (분류별 용도는 §1 의 "전체 컴포넌트 인덱스" 참조).
2184
2216
 
2185
- SActionModal · SBadge · SBarcodeInput · SButton · SCalendar · SCallout · SCard · SCheckbox · SChip · SChipFilter · SChipInput · SCircleProgress · SConfirmModal · SDatePicker · SDateRangePicker · SDivider · SDraggableItem · SDraggableList · SDrawer · SDropdownButton · SEditor · 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
2217
+ SActionModal · SBadge · SBarcodeInput · SButton · SCalendar · SCallout · SCard · SCheckbox · SChip · SChipFilter · SChipInput · SCircleProgress · SConfirmModal · SDatePicker · SDateRangePicker · SDivider · SDraggableItem · SDraggableList · SDrawer · SDropdownButton · SEditor · 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 · SSystemActionButton · STable · STableBar · STabs · STag · STextLink · STextarea · STimePicker · STimeRangePicker · SToast · SToggle · STooltip · STree
package/dist/styles.css CHANGED
@@ -248,6 +248,7 @@
248
248
  --color-field-icon-default: #888888;
249
249
  --color-control-bg-inverseHover: #0075FF;
250
250
  --color-navigation-gnb-bg-dark: #001B39;
251
+ --color-navigation-gnb-bg-system: #004177;
251
252
  --color-primary-10: #EFF6FF;
252
253
  --color-primary-20: #E6F1FF;
253
254
  --color-primary-25: #D9EAFF;
@@ -1215,6 +1216,9 @@
1215
1216
  .w-\[61px\] {
1216
1217
  width: 61px;
1217
1218
  }
1219
+ .w-\[176px\] {
1220
+ width: 176px;
1221
+ }
1218
1222
  .w-\[200px\] {
1219
1223
  width: 200px;
1220
1224
  }
@@ -1575,6 +1579,9 @@
1575
1579
  .gap-\(--cmp-field-addonLabel-gap\) {
1576
1580
  gap: var(--cmp-field-addonLabel-gap);
1577
1581
  }
1582
+ .gap-\(--cmp-gnb-system-panel-gap\) {
1583
+ gap: var(--cmp-gnb-system-panel-gap);
1584
+ }
1578
1585
  .gap-\(--cmp-list-group-gap\) {
1579
1586
  gap: var(--cmp-list-group-gap);
1580
1587
  }
@@ -2248,6 +2255,15 @@
2248
2255
  .border-transparent {
2249
2256
  border-color: transparent;
2250
2257
  }
2258
+ .bg-\(--cmp-gnb-system-item-dark-bg-default\) {
2259
+ background-color: var(--cmp-gnb-system-item-dark-bg-default);
2260
+ }
2261
+ .bg-\(--cmp-gnb-system-item-darker-bg-default\) {
2262
+ background-color: var(--cmp-gnb-system-item-darker-bg-default);
2263
+ }
2264
+ .bg-\(--cmp-gnb-system-item-light-bg-default\) {
2265
+ background-color: var(--cmp-gnb-system-item-light-bg-default);
2266
+ }
2251
2267
  .bg-\(--cmp-image-bg\) {
2252
2268
  background-color: var(--cmp-image-bg);
2253
2269
  }
@@ -2311,6 +2327,12 @@
2311
2327
  .bg-\(--cmp-tree-item-bg-default\) {
2312
2328
  background-color: var(--cmp-tree-item-bg-default);
2313
2329
  }
2330
+ .bg-\(--sab-bg\) {
2331
+ background-color: var(--sab-bg);
2332
+ }
2333
+ .bg-\(--sab-icon-bg\) {
2334
+ background-color: var(--sab-icon-bg);
2335
+ }
2314
2336
  .bg-\(--sys-color-bg-frame\) {
2315
2337
  background-color: var(--sys-color-bg-frame);
2316
2338
  }
@@ -2548,6 +2570,9 @@
2548
2570
  background-color: color-mix(in oklab, var(--color-white) 60%, transparent);
2549
2571
  }
2550
2572
  }
2573
+ .p-\(--cmp-gnb-system-panel-gap\) {
2574
+ padding: var(--cmp-gnb-system-panel-gap);
2575
+ }
2551
2576
  .p-\(--cmp-list-group-padding\) {
2552
2577
  padding: var(--cmp-list-group-padding);
2553
2578
  }
@@ -3207,6 +3232,18 @@
3207
3232
  .text-\(--color-var\) {
3208
3233
  color: var(--color-var);
3209
3234
  }
3235
+ .text-\(--sab-action-icon\) {
3236
+ color: var(--sab-action-icon);
3237
+ }
3238
+ .text-\(--sab-action-text\) {
3239
+ color: var(--sab-action-text);
3240
+ }
3241
+ .text-\(--sab-icon-glyph\) {
3242
+ color: var(--sab-icon-glyph);
3243
+ }
3244
+ .text-\(--sab-text\) {
3245
+ color: var(--sab-text);
3246
+ }
3210
3247
  .text-\(--sys-color-disabled-text\) {
3211
3248
  color: var(--sys-color-disabled-text);
3212
3249
  }
@@ -3656,6 +3693,13 @@
3656
3693
  }
3657
3694
  }
3658
3695
  }
3696
+ .group-hover\:bg-\(--sab-icon-bg-hover\) {
3697
+ &:is(:where(.group):hover *) {
3698
+ @media (hover: hover) {
3699
+ background-color: var(--sab-icon-bg-hover);
3700
+ }
3701
+ }
3702
+ }
3659
3703
  .group-hover\:font-bold {
3660
3704
  &:is(:where(.group):hover *) {
3661
3705
  @media (hover: hover) {
@@ -3664,6 +3708,13 @@
3664
3708
  }
3665
3709
  }
3666
3710
  }
3711
+ .group-hover\:text-\(--sab-icon-glyph-hover\) {
3712
+ &:is(:where(.group):hover *) {
3713
+ @media (hover: hover) {
3714
+ color: var(--sab-icon-glyph-hover);
3715
+ }
3716
+ }
3717
+ }
3667
3718
  .group-hover\/editor-tool\:opacity-5 {
3668
3719
  &:is(:where(.group\/editor-tool):hover *) {
3669
3720
  @media (hover: hover) {
@@ -4076,6 +4127,13 @@
4076
4127
  }
4077
4128
  }
4078
4129
  }
4130
+ .hover\:bg-\(--sab-bg-hover\) {
4131
+ &:hover {
4132
+ @media (hover: hover) {
4133
+ background-color: var(--sab-bg-hover);
4134
+ }
4135
+ }
4136
+ }
4079
4137
  .hover\:bg-\(--sys-color-bg-neutralBright\) {
4080
4138
  &:hover {
4081
4139
  @media (hover: hover) {
@@ -5506,6 +5564,7 @@
5506
5564
  --sys-color-field-icon-default: #888888;
5507
5565
  --sys-color-control-bg-inverseHover: #0075FF;
5508
5566
  --sys-color-navigation-gnb-bg-dark: #001B39;
5567
+ --sys-color-navigation-gnb-bg-system: #004177;
5509
5568
  --cmp-button-xs-height: 24px;
5510
5569
  --cmp-button-xs-paddingX: 8px;
5511
5570
  --cmp-button-xs-gap: 4px;
@@ -6161,7 +6220,7 @@
6161
6220
  --cmp-guide-contents-typography-color: #222222;
6162
6221
  --cmp-guide-contents-icon: #00973C;
6163
6222
  --cmp-guide-contents-radius: 8px;
6164
- --cmp-guide-contents-depth-paddingLeft: 32px;
6223
+ --cmp-guide-contents-depth-paddingLeft: 24px;
6165
6224
  --cmp-progress-linear-height: 20px;
6166
6225
  --cmp-progress-linear-radius: 9999px;
6167
6226
  --cmp-progress-linear-gap: 12px;
@@ -6320,6 +6379,86 @@
6320
6379
  --cmp-gnb-rail-item-radius: 8px;
6321
6380
  --cmp-gnb-rail-item-icon: 24px;
6322
6381
  --cmp-gnb-rail-item-width: 44px;
6382
+ --cmp-gnb-system-panel-light-bg: #FFFFFF;
6383
+ --cmp-gnb-system-panel-light-border: #E1E1E1;
6384
+ --cmp-gnb-system-panel-dark-bg: #004177;
6385
+ --cmp-gnb-system-panel-dark-border: #006AC1;
6386
+ --cmp-gnb-system-panel-gap: 8px;
6387
+ --cmp-gnb-system-panel-divider-color-light: #E1E1E1;
6388
+ --cmp-gnb-system-panel-divider-color-dark: #006AC1;
6389
+ --cmp-gnb-system-panel-divider-color-darker: #004290;
6390
+ --cmp-gnb-system-domainTag-paddingX: 12px;
6391
+ --cmp-gnb-system-domainTag-paddingY: 2px;
6392
+ --cmp-gnb-system-domainTag-radius: 6px;
6393
+ --cmp-gnb-system-domainTag-light-bg: #F6F6F6;
6394
+ --cmp-gnb-system-domainTag-light-text: #555555;
6395
+ --cmp-gnb-system-domainTag-dark-bg: #07284A;
6396
+ --cmp-gnb-system-domainTag-dark-text: #FFFFFF;
6397
+ --cmp-gnb-system-domainTag-darker-bg: #004177;
6398
+ --cmp-gnb-system-domainTag-darker-text: #FFFFFF;
6399
+ --cmp-gnb-system-item-height: 32px;
6400
+ --cmp-gnb-system-item-radius: 8px;
6401
+ --cmp-gnb-system-item-icon-frame: 24px;
6402
+ --cmp-gnb-system-item-icon-glyph: 20px;
6403
+ --cmp-gnb-system-item-icon-radius: 4px;
6404
+ --cmp-gnb-system-item-iconLabelGap: 8px;
6405
+ --cmp-gnb-system-item-light-bg-default: #FFFFFF;
6406
+ --cmp-gnb-system-item-light-bg-hover: #F6F6F6;
6407
+ --cmp-gnb-system-item-light-icon-bg: #FFFFFF;
6408
+ --cmp-gnb-system-item-light-icon-default: #888888;
6409
+ --cmp-gnb-system-item-light-text: #222222;
6410
+ --cmp-gnb-system-item-dark-bg-default: #004177;
6411
+ --cmp-gnb-system-item-dark-bg-hover: #025497;
6412
+ --cmp-gnb-system-item-dark-icon-bg-default: #004177;
6413
+ --cmp-gnb-system-item-dark-icon-bg-hover: #FFFFFF;
6414
+ --cmp-gnb-system-item-dark-text: #FFFFFF;
6415
+ --cmp-gnb-system-item-darker-bg-default: #001B39;
6416
+ --cmp-gnb-system-item-darker-bg-hover: #002B5E;
6417
+ --cmp-gnb-system-item-darker-icon-bg-default: #001B39;
6418
+ --cmp-gnb-system-item-darker-icon-bg-hover: #FFFFFF;
6419
+ --cmp-gnb-system-item-darker-text: #FFFFFF;
6420
+ --cmp-gnb-system-actionButton-paddingLeft: 4px;
6421
+ --cmp-gnb-system-actionButton-paddingRight: 6px;
6422
+ --cmp-gnb-system-actionButton-selectData-gap: 4px;
6423
+ --cmp-gnb-system-actionButton-selectData-icon: 16px;
6424
+ --cmp-gnb-system-actionButton-selectData-text-light: #005CC9;
6425
+ --cmp-gnb-system-actionButton-selectData-text-dark: #BBDAFF;
6426
+ --cmp-gnb-system-actionButton-switch-icon: 16px;
6427
+ --cmp-gnb-system-actionButton-switch-text-light: #555555;
6428
+ --cmp-gnb-system-actionButton-switch-text-dark: #FFFFFF;
6429
+ --cmp-gnb-system-actionButton-select-icon: 16px;
6430
+ --cmp-gnb-system-accountButton-paddingY: 4px;
6431
+ --cmp-gnb-system-accountButton-paddingX: 12px;
6432
+ --cmp-gnb-system-accountButton-gap: 8px;
6433
+ --cmp-gnb-system-accountButton-icon: 16px;
6434
+ --cmp-gnb-system-accountButton-bg-default: #FFFFFF;
6435
+ --cmp-gnb-system-accountButton-bg-hover: #F6F6F6;
6436
+ --cmp-gnb-system-accountButton-bg-negativeHover: #FCEFEF;
6437
+ --cmp-gnb-system-accountButton-content-default: #222222;
6438
+ --cmp-gnb-system-accountButton-content-negative: #E30000;
6439
+ --cmp-gnb-system-accountButton-selectData-gap: 4px;
6440
+ --cmp-gnb-system-accountButton-selectData-icon: 16px;
6441
+ --cmp-gnb-system-accountButton-selectData-text: #005CC9;
6442
+ --cmp-gnb-system-accountListBox-width: 240px;
6443
+ --cmp-gnb-system-accountListBox-bg: #FFFFFF;
6444
+ --cmp-gnb-system-accountListBox-radius: 4px;
6445
+ --cmp-gnb-system-accountListBox-userdata-bg: #F9F9F9;
6446
+ --cmp-gnb-system-accountListBox-userdata-paddingX: 12px;
6447
+ --cmp-gnb-system-accountListBox-userdata-paddingY: 8px;
6448
+ --cmp-gnb-system-accountListBox-userdata-email-color: #888888;
6449
+ --cmp-gnb-system-accountListBox-userdata-name-color: #555555;
6450
+ --cmp-gnb-system-accountListBox-userdata-role-color: #888888;
6451
+ --cmp-gnb-system-accountListBox-list-paddingY: 4px;
6452
+ --cmp-gnb-system-alertButton-paddingX: 4px;
6453
+ --cmp-gnb-system-alertButton-count-color-light: #0075FF;
6454
+ --cmp-gnb-system-alertButton-count-color-dark: #FFD643;
6455
+ --cmp-gnb-system-alertButton-bg-notificationHover-light: #EFF6FF;
6456
+ --cmp-gnb-system-alertButton-icon-color-notification-light: #64ABFF;
6457
+ --cmp-gnb-system-alertButton-icon-color-notification-dark: #FEE17C;
6458
+ --cmp-gnb-system-setting-paddingX: 4px;
6459
+ --cmp-gnb-system-min-padding: 8px;
6460
+ --cmp-gnb-system-project-gap: 8px;
6461
+ --cmp-gnb-system-project-padding: 8px;
6323
6462
  --cmp-list-group-gap: 8px;
6324
6463
  --cmp-list-group-padding: 16px;
6325
6464
  --cmp-listItem-paddingX: 16px;
@@ -6555,6 +6694,12 @@
6555
6694
  font-weight: 500;
6556
6695
  line-height: 20px;
6557
6696
  }
6697
+ .typo-body-sm-semibold {
6698
+ font-family: Pretendard Variable, Pretendard, -apple-system, BlinkMacSystemFont, system-ui, Segoe UI, Apple SD Gothic Neo, Noto Sans KR, Malgun Gothic, Apple Color Emoji, Segoe UI Emoji, sans-serif;
6699
+ font-size: 12px;
6700
+ font-weight: 600;
6701
+ line-height: 20px;
6702
+ }
6558
6703
  .typo-body-sm-bold {
6559
6704
  font-family: Pretendard Variable, Pretendard, -apple-system, BlinkMacSystemFont, system-ui, Segoe UI, Apple SD Gothic Neo, Noto Sans KR, Malgun Gothic, Apple Color Emoji, Segoe UI Emoji, sans-serif;
6560
6705
  font-size: 12px;