sellmate-design-system-react 9.0.0-beta.71 → 9.0.0-beta.73
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.
- package/AGENTS.md +48 -25
- package/dist/components/SGnb/README.md +12 -1
- package/dist/components/SGnb/SGnb.d.ts +18 -1
- package/dist/components/SLauncherListBox/README.md +10 -9
- package/dist/components/SLauncherListBox/SLauncherListBox.d.ts +14 -1
- package/dist/components/SLauncherListBox/index.d.ts +1 -1
- package/dist/components/SLauncherListBox/launcherListBox.config.d.ts +54 -18
- package/dist/components/SLoginCard/README.md +1 -1
- package/dist/components/SLoginCard/SLoginCard.d.ts +8 -4
- package/dist/components/SLogo/README.md +53 -5
- package/dist/components/SLogo/SLogo.d.ts +41 -16
- package/dist/components/SLogo/index.d.ts +1 -1
- package/dist/components/SLogo/logo.config.d.ts +17 -2
- package/dist/components/SLogo/logos.d.ts +16 -0
- package/dist/components/STextLink/README.md +2 -0
- package/dist/index.cjs +611 -160
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +607 -160
- package/dist/index.js.map +1 -1
- package/dist/llms-full.txt +124 -41
- package/dist/llms.txt +48 -25
- package/dist/styles.css +40 -9
- package/package.json +1 -1
- package/dist/components/SLogo/sellmate-wordmark.d.ts +0 -20
package/dist/llms-full.txt
CHANGED
|
@@ -54,7 +54,7 @@
|
|
|
54
54
|
| **레이아웃** | `SLayout` `SGnb` `SGnbSystem` `SSystemActionButton`(GNB system 패널에 한 줄씩 쌓는 액션 행 — 버튼 고르기는 §3-5) `SAccountListBox`(계정 행을 눌러 뜨는 계정 패널) `SLauncherListBox`(런처 버튼을 눌러 뜨는 서비스 목록) `SPage` `SPageHeader`(페이지 제목 영역 — `SLayout` 안에서 `SPage` 앞에 둔다) `SSectionHeaderCard` `SCard` `SLoginCard`(통합 계정 로그인 화면의 카드) `SDivider` `SSplitter` `SScrollArea` `SExpansionItem` |
|
|
55
55
|
| **내비게이션** | `STabs` `SPagination` `SStepper` |
|
|
56
56
|
| **차트** | `SBarChart`(막대 그래프 — 항목끼리 크기를 견준다. `stacked` 로 항목 안의 구성까지) `SLineChart`(꺾은선 그래프 — 순서가 있는 항목의 추이를 본다. `area` 로 크기까지, `stacked` 로 구성까지) `SPieChart`(원그래프 — 한 시점의 전체를 몇 개의 몫으로 나눈다) `SDonutChart`(도넛 그래프 — 가운데가 빈 원그래프. 구멍에 글자를 두지 않는다) |
|
|
57
|
-
| **표시·상태** | `STag` `SBadge` `SIcon` `SLogo`(
|
|
57
|
+
| **표시·상태** | `STag` `SBadge` `SIcon` `SLogo`(셀메이트·서비스 로고를 아이콘처럼 — name 으로 서비스, mode 로 배경, direction 으로 가로·세로, size 는 높이다 — `"auto"` 면 부모 폭을 채운다) `SImage` `SCallout` `SContextAlert`(한 줄짜리 맥락 알림 — 오른쪽에 후속 동작 버튼) `SGuide` |
|
|
58
58
|
| **진행·로딩** | `SLinearProgress` `SCircleProgress` `SLoadingContainer` `SLoadingModal` |
|
|
59
59
|
| **오버레이** | `STooltip` `SPopover` `SPopup` `SDrawer` `SPortal` |
|
|
60
60
|
| **모달** | `SModal.confirm()` `SModal.create()` + `SActionModal` `SConfirmModal` `SModalOutlet`(앱 루트 1회) |
|
|
@@ -97,7 +97,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
|
|
|
97
97
|
| 직접 만든 탭/페이지네이션/스텝퍼 | `STabs`, `SPagination`, `SStepper` |
|
|
98
98
|
| `<ul>`/`<li>` 로 만든 목록 UI | `SList` + `SListItem` (드래그 정렬은 `SDraggableItem`) |
|
|
99
99
|
| 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard` 의 `title` / `padding` props |
|
|
100
|
-
| `<svg>` 직접 삽입, 이모지 아이콘 | `SIcon` (
|
|
100
|
+
| `<svg>` 직접 삽입, 이모지 아이콘 | `SIcon` (셀메이트·서비스 로고는 `SLogo`) |
|
|
101
101
|
| `<hr>` | `SDivider` |
|
|
102
102
|
| `<details>` / `<summary>` | `SExpansionItem` |
|
|
103
103
|
| `<progress>` | `SLinearProgress`, `SCircleProgress` |
|
|
@@ -585,7 +585,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
585
585
|
| 상태·분류를 라벨로 찍는다 | `STag` | §3-1 |
|
|
586
586
|
| 색 점만으로 상태를 찍는다 | `SBadge` | §3-1 |
|
|
587
587
|
| 아이콘을 넣는다 | `SIcon` | |
|
|
588
|
-
|
|
|
588
|
+
| 셀메이트·서비스 로고를 넣는다 | `SLogo` (`name` 에 서비스, 어두운 면이면 `mode="dark"`, 표기를 아래에 두려면 `direction="vertical"`. `size` 는 **높이**이고(`"auto"` 면 부모 폭을 채운다), 색을 주지 않으면 브랜드 색이다) | §3-7-14 |
|
|
589
589
|
| 사진·썸네일을 보여준다 (로딩·실패 상태 포함) | `SImage` | §3-7-12 |
|
|
590
590
|
| 작은 썸네일을 호버해서 크게 확인하게 한다 | `SImage previewOnHover` | 툴팁·팝오버로 직접 만들지 않는다 — 미리보기는 마우스를 통과시키고 원본의 로딩·실패도 스스로 표현한다. §3-7-12 |
|
|
591
591
|
| 문장 안에서 다른 화면으로 보낸다 | `STextLink` | §3-5-6 |
|
|
@@ -1569,7 +1569,7 @@ tableRef.current.scrollToRow(row); // 복원
|
|
|
1569
1569
|
|
|
1570
1570
|
**직접 띄우지 않는다.** 런처 버튼에 붙여 여는 것은 `SGnb` 의 `launcher` 가 맡는다 — 목록만 넘기면 버튼 아래로 · 버튼 왼쪽 끝에 맞춰 뜨고, 서비스를 고르거나 바깥을 누르면 닫힌다. 고른 서비스는 **새 탭에서 열린다** — 이동도 앱이 만들지 않는다.
|
|
1571
1571
|
|
|
1572
|
-
**앱이 넘기는 것은 서비스 키와 갈
|
|
1572
|
+
**앱이 넘기는 것은 서비스 키와 갈 주소, 그리고 셀메이트 콘솔 주소뿐이다.** 로고·서비스 표기·이름·상태 태그와 콘솔 줄의 문구·아이콘은 디자인 시스템이 정해 두므로 앱이 만들지 않는다.
|
|
1573
1573
|
|
|
1574
1574
|
```tsx
|
|
1575
1575
|
<SGnb
|
|
@@ -1582,12 +1582,13 @@ tableRef.current.scrollToRow(row); // 복원
|
|
|
1582
1582
|
{ service: 'account', href: env.ACCOUNT_URL },
|
|
1583
1583
|
{ service: 'crm', href: env.CRM_URL },
|
|
1584
1584
|
],
|
|
1585
|
+
consoleHref: env.CONSOLE_URL, // 필수 — 목록 아래 "셀메이트 콘솔로 이동" 링크
|
|
1585
1586
|
}}
|
|
1586
1587
|
/>
|
|
1587
1588
|
```
|
|
1588
1589
|
|
|
1589
1590
|
- **`launcher` 를 주지 않으면 런처 버튼 자체가 렌더되지 않는다.** 옮겨 갈 서비스가 없는 앱은 이 슬롯을 비워 둔다 — 눌러도 아무것도 없는 버튼을 상단바에 남기지 않는다.
|
|
1590
|
-
- **서비스는 키(`service`)로 고른다 — 보이는 것은 아무것도 넘기지 않는다.** 쓸 수 있는 키는 `'sellmate' | 'wms' | 'account' | 'crm'`
|
|
1591
|
+
- **서비스는 키(`service`)로 고른다 — 보이는 것은 아무것도 넘기지 않는다.** 쓸 수 있는 키는 `SLogo` 가 로고를 가진 서비스 전부(`'sellmate' | 'wms' | 'chat' | 'plm' | 'account' | 'people' | 'crm' | 'work' | 'pos'` — `SLauncherService`)이고, 서비스 로고(워드마크와 `WMS`·`Account`·`CRM` … 표기가 한 덩어리인 브랜드 로고)·아래 줄 한글 이름·상태 태그(`NEW`·`출시예정`)·출시 여부를 카탈로그(`LAUNCHER_SERVICE_CATALOG`)가 그 키로 정한다. 앱이 넘기게 하면 같은 서비스가 앱마다 다른 이름·색·문구로 선다. **서비스가 늘거나 이름·상태가 바뀌면 디자인 시스템 릴리스로 따라온다** — 앱은 고칠 것이 없다.
|
|
1591
1592
|
|
|
1592
1593
|
```tsx
|
|
1593
1594
|
✅ { service: 'wms', href: env.WMS_URL }
|
|
@@ -1605,6 +1606,13 @@ tableRef.current.scrollToRow(row); // 복원
|
|
|
1605
1606
|
```
|
|
1606
1607
|
- **갈 수 없는 서비스도 목록에서 빼지 않는다.** 그 서비스가 있다는 사실과 지금은 못 간다는 사실을 함께 알리는 것이 런처의 일이다. 지금 보고 있는 서비스를 빼면 사용자가 지금 어디에 있는지가 런처에서 사라진다.
|
|
1607
1608
|
- **출시 전인 서비스는 앱이 할 일이 없다.** 카탈로그가 `출시예정` 태그와 함께 막아 두므로 주소를 줘도 열리지 않고, 열리는 날 디자인 시스템 릴리스 하나로 모든 앱에서 함께 열린다. **앱이 앞질러 열 수단은 없다.**
|
|
1609
|
+
- **셀메이트 콘솔 주소 `launcher.consoleHref` 는 필수다.** 목록 아래 구분선 밑에 `셀메이트 콘솔로 이동` 글자 링크(`STextLink`)가 **늘 서고**, 누르면 그 주소가 새 탭에서 열린다. 끄는 prop 은 없다 — 어느 서비스의 런처든 콘솔로 가는 길은 있어야 하고, 같은 곳을 같은 말로 안내해야 해서 문구·아이콘도 컴포넌트가 정한다. **`launcher.onConsoleClick` 도 이동을 하지 않는다**(`onSelect` 와 같다) — 누르면 목록은 스스로 닫힌다.
|
|
1610
|
+
|
|
1611
|
+
```tsx
|
|
1612
|
+
✅ launcher={{ items: SERVICES, consoleHref: env.CONSOLE_URL }}
|
|
1613
|
+
❌ launcher={{ items: [...SERVICES, { service: 'console', href: … }] }} // 콘솔은 서비스가 아니다
|
|
1614
|
+
❌ <SLauncherListBox …/><STextLink label="콘솔로 이동" … /> // 링크를 손으로 붙이지 않는다
|
|
1615
|
+
```
|
|
1608
1616
|
- **목록 순서를 앱이 정하지 않는다.** 넘긴 순서가 아니라 카탈로그 순서(`LAUNCHER_SERVICES`)로 선다 — 같은 런처가 앱마다 다른 순서로 뜨면 사용자가 매번 다시 찾는다. 정렬해서 넘기려 애쓰지 않는다.
|
|
1609
1617
|
- **줄에 얹으면 "여기서 나간다"는 것이 드러난다** — 배경이 옅은 파랑으로 물들고 이름이 한 단계 진해지며, 오른쪽 끝에 페이지 이동 아이콘이 떠오른다. **앱이 켜고 끄는 prop 이 없다** — 다른 서비스로 넘어가는 자리라는 신호는 화면마다 달라지면 안 된다. 갈 수 없는 줄은 얹어도 반응하지 않는다.
|
|
1610
1618
|
- **폭을 늘리지 않는다.** 로고 길이에 따라 패널이 출렁이지 않도록 고정 폭이다.
|
|
@@ -2044,25 +2052,33 @@ const [selectedId, setSelectedId] = useState<string>();
|
|
|
2044
2052
|
|
|
2045
2053
|
#### 3-7-14. 로고 — SLogo
|
|
2046
2054
|
|
|
2047
|
-
|
|
2055
|
+
셀메이트·서비스 로고는 `<svg>` 를 직접 붙이지 않고 `SLogo` 를 쓴다. **`SIcon` 과 같은 손맛(`name`·`size`·`color`)이지만 두 가지가 다르다.**
|
|
2048
2056
|
|
|
2049
|
-
- **`
|
|
2050
|
-
-
|
|
2051
|
-
-
|
|
2057
|
+
- **`name` 에 서비스를 넣으면 그 서비스 로고가 나온다**(`sellmate` · `wms` · `chat` · `plm` · `account` · `people` · `crm` · `work` · `pos` · `console` — `SLogoName`). [셀메이트 워드마크 + 서비스 표기]가 한 덩어리다. **워드마크 옆에 표기를 앱이 따로 잇지 않는다** — 표기의 서체·자간·색이 원본과 어긋난다.
|
|
2058
|
+
- **배경에 맞춰 `mode` 를 준다.** 밝은 면은 `light`(기본), 어두운 면(dark GNB 등)은 `dark`. 워드마크 색과 서비스 표기 색을 모드가 정하므로 색을 직접 주지 않는다.
|
|
2059
|
+
- **표기를 워드마크 아래에 두려면 `direction="vertical"` 을 준다**(로그인 카드처럼 폭이 좁고 로고가 가운데 서는 자리). 워드마크 아래에 표기를 앱이 따로 쌓지 않는다. 모든 서비스 로고가 세로를 가진다(`sellmate` 는 표기가 없어 어느 쪽이든 같다). 세로의 표기 색도 원본이 정하므로 색을 직접 맞추지 않는다.
|
|
2060
|
+
- **`size` 는 높이다.** 로고는 가로로 길어 정사각으로 그리면 찌그러진다 — 폭은 비율에서 저절로 나오므로 주지 않는다. `vertical` 에서는 두 줄 전체의 높이라, 같은 `size` 면 워드마크가 가로보다 작다.
|
|
2061
|
+
- **로고 자리의 폭이 정해져 있으면 `size="auto"` 로 그 폭을 채운다**(`SGnb` `header="fix"` 의 로고 칸). 높이는 비율에서 나온다. 폭을 채우려고 `className`·`style` 로 svg 를 덮지 않는다. **부모에 폭이 없는 자리에는 쓰지 않는다** — 기준을 잃어 브라우저 기본 크기(300px)로 그려진다. `header="full"` 의 로고 칸(140px 고정)에서도 쓰지 않는다 — 거기서는 높이로 주고 칸 안에 들어가는 크기를 고른다.
|
|
2062
|
+
- **색을 주지 않으면 브랜드 색이다.** `SIcon` 과 달리 currentColor 를 상속하지 않는다 — 로고가 주변 글자색을 따라 물들면 브랜드 색이 화면마다 달라진다. **비활성처럼 물러나야 하는 자리에서만** `color` 를 준다. 주면 워드마크와 서비스 표기가 모두 그 한 색이 된다(`mode` 보다 우선한다).
|
|
2052
2063
|
- **`label` 은 로고가 그 자리의 유일한 이름일 때만 준다**(로그인 화면·상단바). 옆이나 아래에 서비스 이름이 이미 적혀 있으면(런처 목록의 한 줄) 주지 않는다 — 같은 이름이 두 번 읽힌다.
|
|
2053
2064
|
|
|
2054
2065
|
```tsx
|
|
2055
|
-
✅ <SLogo size={20} /> {/* 상단바 로고 —
|
|
2066
|
+
✅ <SLogo size={20} /> {/* 상단바 로고 — 브랜드 색 */}
|
|
2067
|
+
✅ <SLogo name="wms" size={20} /> {/* 서비스 로고 */}
|
|
2068
|
+
✅ <SLogo name="wms" mode="dark" size={20} /> {/* 어두운 면 위 */}
|
|
2069
|
+
✅ <SLogo name="wms" direction="vertical" size={48} /> {/* 워드마크 아래에 표기 — 로그인 카드 */}
|
|
2056
2070
|
✅ <SLogo size={32} label="Sellmate" /> {/* 로고가 그 자리의 유일한 이름일 때 */}
|
|
2057
|
-
✅ <
|
|
2058
|
-
|
|
2059
|
-
<span className="typo-body-xs-default text-(--sys-color-fg-success)">WMS</span>
|
|
2060
|
-
</span>
|
|
2061
|
-
✅ <SLogo size={12} color="grey_45" /> {/* 아직 못 쓰는 서비스 */}
|
|
2071
|
+
✅ <SGnb header="fix" logo={<SLogo name="account" mode="dark" size="auto" />} … /> {/* fix 로고 칸을 채운다 */}
|
|
2072
|
+
✅ <SLogo name="crm" size={12} color="grey_45" /> {/* 아직 못 쓰는 서비스 — 로고 전체가 한 색 */}
|
|
2062
2073
|
|
|
2063
|
-
❌ <
|
|
2074
|
+
❌ <span><SLogo /><span>WMS</span></span> {/* 표기를 잇지 않는다 — name="wms" */}
|
|
2075
|
+
❌ <div><SLogo /><div>WMS</div></div> {/* 아래로 쌓지도 않는다 — direction="vertical" */}
|
|
2076
|
+
❌ <SLogo name="wms" color="white" /> {/* 어두운 면이면 mode="dark" — 표기 색까지 흰색이 된다 */}
|
|
2077
|
+
❌ <svg viewBox="0 0 347 50">…</svg> {/* 로고를 손으로 붙이지 않는다 */}
|
|
2064
2078
|
❌ <SLogo size={24} style={{ width: 120 }} /> {/* 폭은 비율이 정한다 — 찌그러진다 */}
|
|
2065
|
-
❌ <SLogo
|
|
2079
|
+
❌ <SLogo className="w-full [&>svg]:w-full!" /> {/* 폭을 채우려면 size="auto" */}
|
|
2080
|
+
❌ <SGnb header="full" logo={<SLogo size="auto" />} … /> {/* full 로고 칸(140px)에서는 높이로 준다 */}
|
|
2081
|
+
❌ <SLogo color="grey_45" /> {/* 물러날 이유가 없으면 브랜드 색 그대로 둔다 */}
|
|
2066
2082
|
```
|
|
2067
2083
|
|
|
2068
2084
|
#### 3-7-13. 숫자 — SNumberInput 의 min·max 는 검증 경계다
|
|
@@ -2247,15 +2263,16 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
2247
2263
|
|
|
2248
2264
|
| `header` | 상단바 배치 | 로고 폭 | `topContent` |
|
|
2249
2265
|
| --- | --- | --- | --- |
|
|
2250
|
-
| `"fix"` (기본) | `[런처 · 로고 … 폴드]` — 상단바가 GNB 컬럼 안에 있고 폴드가 컬럼 오른쪽 끝 |
|
|
2266
|
+
| `"fix"` (기본) | `[런처 · 로고 … 폴드]` — 상단바가 GNB 컬럼 안에 있고 폴드가 컬럼 오른쪽 끝 | 런처와 폴드 사이 남은 폭 (메뉴 폭을 따른다) | **렌더되지 않는다** (놓을 자리가 없다) |
|
|
2251
2267
|
| `"full"` | `[런처 · 폴드 · 로고 · topContent … system]` — 상단바가 화면 전폭이고 `system` 은 오른쪽 끝 | **140px 고정** (런처 없으면 172px) | 로고 오른쪽 남는 폭 전체 |
|
|
2252
2268
|
|
|
2253
2269
|
- `topContent` 는 상단바 로고 오른쪽 슬롯이다. 전역 검색처럼 **모든 페이지에 공통인 것만** 넣는다. 페이지별 액션은 여기가 아니라 §4-2 의 `STableBar` 로 간다.
|
|
2254
2270
|
- **계정·알림·설정·도메인·서비스 전환은 `topContent` 에 손으로 만들지 않는다.** `header="full"` 이면 `system` 슬롯의 조각들이 상단바 오른쪽 끝으로 올라오므로, 그것들은 전부 `SGnbSystem` 이 그린다 (바로 아래 절).
|
|
2255
2271
|
- 슬롯이 남는 폭을 통째로 받으므로 **정렬은 안에서 직접 잡는다** (좌측 정렬 + 우측은 `ml-auto`).
|
|
2256
|
-
- `header="
|
|
2272
|
+
- `header="fix"` 에서 로고 자리는 런처와 폴드 버튼 사이의 남은 폭이다. **`SLogo size="auto"` 를 넣으면 그 폭을 채운다** — 메뉴 폭을 바꾸거나 로고 종류가 바뀌어도 폭에 맞춰진다. 높이(`size`)로 준 로고가 그보다 넓으면 잘린다.
|
|
2273
|
+
- `header="full"` 에서 로고 자리는 140px 로 고정된다 — 로고 내용이 바뀌어도 `topContent` 시작점이 흔들리지 않게 하기 위함이다. 로고가 그보다 넓으면 잘리므로 이 폭에 맞춰 준비한다. **여기서는 `SLogo size="auto"` 를 쓰지 않는다** — 높이(`size`)로 주고 140px 안에 들어가는 크기를 고른다.
|
|
2257
2274
|
- `launcher` 를 주지 않으면 런처가 렌더되지 않고, 그 자리(버튼 + 간격)를 로고 슬롯이 이어받아 172px 가 된다. `topContent` 시작점은 런처 유무와 관계없이 같은 자리다.
|
|
2258
|
-
- **런처 버튼은 서비스 목록의 트리거다.** `launcher.items` 에 옮겨 갈 서비스를 **키와 주소로** 넘기면 버튼 아래로 목록이 뜨고, 고른 서비스가 새 탭에서
|
|
2275
|
+
- **런처 버튼은 서비스 목록의 트리거다.** `launcher.items` 에 옮겨 갈 서비스를 **키와 주소로** 넘기면 버튼 아래로 목록이 뜨고, 고른 서비스가 새 탭에서 열린다. 셀메이트 콘솔로 가는 줄은 `launcher.consoleHref` 로 붙는다 — 팝오버도 이동도 손으로 만들지 않는다 (§3-5-9).
|
|
2259
2276
|
|
|
2260
2277
|
```tsx
|
|
2261
2278
|
<SLayout type="box" header="full">
|
|
@@ -2949,9 +2966,10 @@ export default function LoginPage() {
|
|
|
2949
2966
|
// 여백은 카드가 최소 폭을 지킬 수 있는 값으로 둔다 — 카드 폭은 className 으로 박지 않는다
|
|
2950
2967
|
<div className="flex h-screen items-stretch justify-center bg-bg-neutralLight p-sd-24">
|
|
2951
2968
|
<SLoginCard
|
|
2952
|
-
|
|
2953
|
-
|
|
2954
|
-
|
|
2969
|
+
// 제품은 서비스 키로 고른다 — 카드가 그 서비스의 세로 로고를 그린다. 제품명을 글자로 넘기지 않는다
|
|
2970
|
+
service="account"
|
|
2971
|
+
title="쇼핑몰 대표님을 위한 정부·세무 도우미입니다."
|
|
2972
|
+
description="(세금 신고 일정과 지원사업 소식을 한곳에서 챙겨 드립니다.)"
|
|
2955
2973
|
// 로그인 버튼은 카드가 그린다 — 동작만 넘긴다
|
|
2956
2974
|
onLogin={() => navigate('/auth/sso')}
|
|
2957
2975
|
footerNote="계정이 없다면 담당자에게 문의를 요청해 주세요."
|
|
@@ -2979,7 +2997,7 @@ export default function LoginPage() {
|
|
|
2979
2997
|
|
|
2980
2998
|
| Prop | 용도 |
|
|
2981
2999
|
| --- | --- |
|
|
2982
|
-
| `
|
|
3000
|
+
| `service` | 제품 — `SLogo` 의 로고명(`account` · `wms` · `chat` …, `SLogoName`). 카드 맨 위에 그 서비스의 세로 로고가 선다 |
|
|
2983
3001
|
| `title` | 제품을 한 줄로 소개하는 문장 |
|
|
2984
3002
|
| `description` | 소개 바로 아래 붙는 보조 설명. 소개와 한 문단으로 읽힌다 — 없으면 생략한다 |
|
|
2985
3003
|
| `onLogin` | 로그인 버튼을 눌렀을 때. **버튼은 카드가 그리므로 동작만 넘긴다** — 문구·색·크기는 세 제품에서 같아야 한다 |
|
|
@@ -2992,7 +3010,12 @@ export default function LoginPage() {
|
|
|
2992
3010
|
|
|
2993
3011
|
**크기는 부모가 정한다 — `className` 으로 폭을 박지 않는다.** 카드는 폭을 368~640px 사이에서 부모에 맞추고 높이도 부모가 준 만큼 채운다. 밖에서 고정하면 상하한이 무의미해져, 좁은 화면에서 함께 좁아져야 할 카드가 그대로 남아 넘친다. 좁게 세워야 하면 카드가 아니라 바깥 한 겹을 좁힌다.
|
|
2994
3012
|
|
|
2995
|
-
|
|
3013
|
+
**로고와 로그인 버튼은 카드가 직접 그린다.** 로고는 `service` 키로 고르면 카드가 그 서비스의 세로 로고(`SLogo direction="vertical"`)를 크기·접근성 이름까지 정해 세운다 — **제품명을 글자로 넘기거나 로고를 따로 얹지 않는다.** 표기의 서체·자간·색은 원본 로고가 정한다. 버튼은 모든 제품이 같은 문구(`통합 계정으로 로그인`)로 서므로 넘길 것이 없다. 앱이 주는 것은 서비스 키·문구·`onLogin` 동작뿐이다.
|
|
3014
|
+
|
|
3015
|
+
```tsx
|
|
3016
|
+
✅ <SLoginCard service="account" title="…" onLogin={login} />
|
|
3017
|
+
❌ <SLoginCard service="sellmate" title={<><b>Account</b> …</>} /> {/* 제품명을 글자로 잇지 않는다 — service="account" */}
|
|
3018
|
+
```
|
|
2996
3019
|
|
|
2997
3020
|
**로그인 카드 옆에 다른 블록을 두지 않는다.** 이 화면에서 할 일은 로그인 하나이고, 옆에 공지·배너가 붙는 순간 그 뜻이 깨진다. 안내가 필요하면 `description` 이나 `footerNote` 로 넣는다.
|
|
2998
3021
|
|
|
@@ -6470,7 +6493,7 @@ export type SGhostButtonIntent = 'default' | 'danger' | 'action' | 'subAction' |
|
|
|
6470
6493
|
| `value?` | `string` | `''` | 현재 선택된 아이템 value |
|
|
6471
6494
|
| `folded?` | `boolean` | — | 접힘(레일) 상태. 미지정 시 SLayout 의 folded 를 따른다. |
|
|
6472
6495
|
| `launcher?` | `SGnbLauncher` | — | 앱런처(그리드) 버튼. 미지정 시 런처 버튼을 렌더하지 않는다. 접힘 레일(fix)에는 폴드 버튼만 남으므로 표시되지 않는다. |
|
|
6473
|
-
| `logo?` | `ReactNode` | — | 상단바 로고 영역 (slot). header="full"
|
|
6496
|
+
| `logo?` | `ReactNode` | — | 상단바 로고 영역 (slot). - `header="fix"` : 런처와 폴드 버튼 사이의 남은 폭이 로고 칸이다. `SLogo size="auto"` 를 넣으면 그 폭을 채운다(메뉴 폭을 바꿔도 따라온다). 넘치는 로고는 잘린다. - `header="full"` : 폭이 140px 로 고정된다. 여기서는 `size="auto"` 를 쓰지 않는다 — 높이(`size`)로 주고 140px 안에 들어가는 크기를 고른다. |
|
|
6474
6497
|
| `topContent?` | `ReactNode` | — | 상단바 로고 오른쪽 슬롯 (검색·액션 등). 로고와 16px 띄고 남는 폭을 모두 차지하므로 안에서 자유롭게 정렬한다. 상단바가 전폭인 header="full" 에서만 렌더된다 (fix 는 상단바가 좁은 GNB 컬럼 안이라 놓을 자리가 없다). |
|
|
6475
6498
|
| `railTop?` | `ReactNode` | — | 레일 상단 고정 슬롯. 레일 아이템이 많아 넘치면 아이템 목록(ul)만 스크롤되고 이 슬롯은 레일 상단(상단바 바로 아래)에 붙어 고정된다. showRail 일 때만 렌더된다. |
|
|
6476
6499
|
| `railFooter?` | `ReactNode` | — | 레일 하단 고정 슬롯. 레일 아이템이 많아 넘치면 아이템 목록(ul)만 스크롤되고 이 슬롯은 레일 하단에 붙어 고정된다. showRail 일 때만 렌더된다. |
|
|
@@ -6562,6 +6585,17 @@ export interface SGnbLauncher {
|
|
|
6562
6585
|
* 닫힌다(`onOpenChange(false)` 도 함께 온다).
|
|
6563
6586
|
*/
|
|
6564
6587
|
onSelect?: (service: SLauncherService) => void;
|
|
6588
|
+
/**
|
|
6589
|
+
* 셀메이트 콘솔 주소. 목록 아래에 **늘 서는** "셀메이트 콘솔로 이동" 글자 링크가 누르면 이 주소를
|
|
6590
|
+
* 새 탭에서 연다(`SLauncherListBox` 의 `consoleHref`). **필수다** — 콘솔로 가는 길은 어느
|
|
6591
|
+
* 서비스의 런처에나 있어야 한다. 목록(`items`)이 비면 목록째 뜨지 않으므로 이 링크도 뜨지 않는다.
|
|
6592
|
+
*/
|
|
6593
|
+
consoleHref: string;
|
|
6594
|
+
/**
|
|
6595
|
+
* 콘솔 링크를 누름. `onSelect` 와 같이 **화면을 옮기지 않는다** — 컴포넌트가 새 탭으로 이미 연다.
|
|
6596
|
+
* 누르면 목록은 스스로 닫힌다.
|
|
6597
|
+
*/
|
|
6598
|
+
onConsoleClick?: () => void;
|
|
6565
6599
|
/**
|
|
6566
6600
|
* 목록이 열리고 닫힐 때. 여닫는 것은 런처 버튼이 스스로 하므로 **그 사실을 알아야 할 때만** 준다
|
|
6567
6601
|
* (연 김에 목록을 다시 불러오거나, 열려 있는 동안 다른 층을 접어 두는 화면).
|
|
@@ -7153,6 +7187,7 @@ export type SKeyValueFieldValue = string | number | boolean | string[];
|
|
|
7153
7187
|
| Prop | Type | Default | Description |
|
|
7154
7188
|
|------|------|---------|-------------|
|
|
7155
7189
|
| `items?` | `SLauncherListBoxItem[]` | — | 목록에 세울 서비스. 비어 있으면 아무것도 렌더하지 않는다. **순서는 넘긴 대로가 아니라 카탈로그 순서다**(`LAUNCHER_SERVICES`) — 같은 런처가 앱마다 다른 순서로 뜨면 사용자가 매번 다시 찾는다. 같은 서비스를 두 번 넘기면 처음 것만 선다. |
|
|
7190
|
+
| `consoleHref` | `string` | — | 셀메이트 콘솔 주소. 목록 아래에 **늘 서는** "셀메이트 콘솔로 이동" 글자 링크(`STextLink`)가 누르면 이 주소를 새 탭에서 연다. **필수다** — 어느 서비스의 런처든 콘솔로 가는 길은 있어야 한다. 문구·아이콘은 컴포넌트가 정한다 — 어느 서비스의 런처든 같은 곳을 같은 말로 안내해야 한다. 주소는 서비스 줄의 `href` 처럼 앱마다 QA·실서버가 달라 앱이 넘긴다. |
|
|
7156
7191
|
| `ariaLabel?` | `string` | — | 목록(ul)의 접근성 레이블 |
|
|
7157
7192
|
|
|
7158
7193
|
#### Events
|
|
@@ -7160,6 +7195,7 @@ export type SKeyValueFieldValue = string | number | boolean | string[];
|
|
|
7160
7195
|
| Event | Type | Description |
|
|
7161
7196
|
|-------|------|-------------|
|
|
7162
7197
|
| `onSelect` | `(service: SLauncherService) => void` | 서비스를 고름. **가는 것은 이 콜백이 하지 않는다** — 줄이 링크라 브라우저가 `href` 를 새 탭으로 연다. 고른 것을 앱이 알아야 할 때만(기록·목록 닫기) 준다. 갈 수 없는 줄(주소가 없거나 카탈로그가 아직 출시 전으로 든 서비스)은 눌리지 않으므로 여기로 오지 않는다. |
|
|
7198
|
+
| `onConsoleClick` | `() => void` | 콘솔 링크를 누름. **가는 것은 이 콜백이 하지 않는다** — 컴포넌트가 `consoleHref` 를 새 탭으로 이미 연다. 누른 것을 앱이 알아야 할 때만(기록·목록 닫기) 준다. |
|
|
7163
7199
|
|
|
7164
7200
|
## Types
|
|
7165
7201
|
|
|
@@ -7187,18 +7223,15 @@ export interface SLauncherListBoxItem {
|
|
|
7187
7223
|
|
|
7188
7224
|
### SLauncherService
|
|
7189
7225
|
|
|
7190
|
-
```ts
|
|
7191
|
-
export type SLauncherService = (typeof LAUNCHER_SERVICES)[number];
|
|
7192
|
-
```
|
|
7193
|
-
|
|
7194
|
-
### LAUNCHER_SERVICES
|
|
7195
|
-
|
|
7196
7226
|
```ts
|
|
7197
7227
|
/**
|
|
7198
|
-
* 런처에 설 수 있는 서비스 —
|
|
7199
|
-
*
|
|
7228
|
+
* 런처에 설 수 있는 서비스 키 — **`SLogo` 가 로고를 가진 서비스 전부다(통합 콘솔 제외).**
|
|
7229
|
+
*
|
|
7230
|
+
* 문서에서 바로 읽히도록 키를 풀어 쓴다(`Exclude<SLogoName, …>` 로 두면 README·Storybook 에 무엇이
|
|
7231
|
+
* 있는지 보이지 않는다). 대신 아래 `LOGO_COVERAGE` 가 로고 목록과 어긋나지 않는지 타입으로 지킨다.
|
|
7200
7232
|
*/
|
|
7201
|
-
export
|
|
7233
|
+
export type SLauncherService =
|
|
7234
|
+
'sellmate' | 'wms' | 'chat' | 'plm' | 'account' | 'people' | 'crm' | 'work' | 'pos';
|
|
7202
7235
|
```
|
|
7203
7236
|
|
|
7204
7237
|
## Dependencies
|
|
@@ -7212,6 +7245,7 @@ export const LAUNCHER_SERVICES = ['sellmate', 'wms', 'account', 'crm'] as const;
|
|
|
7212
7245
|
- [SIcon](../SIcon)
|
|
7213
7246
|
- [SLogo](../SLogo)
|
|
7214
7247
|
- [STag](../STag)
|
|
7248
|
+
- [STextLink](../STextLink)
|
|
7215
7249
|
|
|
7216
7250
|
### Graph
|
|
7217
7251
|
|
|
@@ -7643,7 +7677,7 @@ export type SLoadingModalState = 'loading' | 'error';
|
|
|
7643
7677
|
|
|
7644
7678
|
| Prop | Type | Default | Description |
|
|
7645
7679
|
|------|------|---------|-------------|
|
|
7646
|
-
| `
|
|
7680
|
+
| `service` | `SLogoName` | — | 제품 — 그 서비스의 **세로 로고**([셀메이트 워드마크 + 서비스 표기])가 카드 맨 위에 선다. 제품명을 글자로 넘기지 않는다 — 표기의 서체·자간·색은 원본 로고가 정한다. |
|
|
7647
7681
|
| `title` | `ReactNode` | — | 제품을 한 줄로 소개하는 문장 |
|
|
7648
7682
|
| `description?` | `ReactNode` | — | 소개 문장 바로 아래 붙는 보조 설명. 소개와 한 덩어리로 읽힌다 |
|
|
7649
7683
|
| `footerNote?` | `ReactNode` | — | 버튼 아래 안내 문구 (예: 계정 발급 문의 안내) |
|
|
@@ -7676,9 +7710,11 @@ export type SLoadingModalState = 'loading' | 'error';
|
|
|
7676
7710
|
|
|
7677
7711
|
| Prop | Type | Default | Description |
|
|
7678
7712
|
|------|------|---------|-------------|
|
|
7679
|
-
| `name?` | `SLogoName` | `'sellmate'` | 로고명 |
|
|
7680
|
-
| `
|
|
7681
|
-
| `
|
|
7713
|
+
| `name?` | `SLogoName` | `'sellmate'` | 로고명 — 셀메이트 본체(`sellmate`) 또는 서비스(`wms` · `account` · `crm` …). 서비스 로고는 [셀메이트 워드마크 + 서비스 표기]가 한 덩어리로 나온다 — 앱이 표기를 잇지 않는다. |
|
|
7714
|
+
| `mode?` | `SLogoMode` | `'light'` | 로고가 서는 배경. 밝은 면에는 `light`(남색 워드마크), 어두운 면에는 `dark`(흰 워드마크). 서비스 표기 색도 원본이 모드마다 정한 값으로 바뀐다. |
|
|
7715
|
+
| `direction?` | `SLogoDirection` | `'horizontal'` | 배치. `horizontal` 은 워드마크 오른쪽에 서비스 표기, `vertical` 은 워드마크 아래 가운데에 표기 (로그인 카드처럼 폭이 좁고 로고가 가운데 서는 자리). `sellmate` 는 표기가 없어 어느 쪽이든 같다. 표기 색이 가로와 다른 로고도 있다(POS 세로는 light 에서도 `#4886FF`) — 원본을 따른다. |
|
|
7716
|
+
| `size?` | `number \| 'auto' \| (string & {})` | `LOGO_DEFAULT_SIZE` | **높이**(px 또는 CSS 길이). 폭은 주지 않는다 — 로고 비율에서 저절로 나온다. `SIcon` 의 `size` 와 달리 정사각이 아니다(로고는 가로로 길다). `vertical` 은 두 줄 전체의 높이다 — 같은 `size` 면 워드마크가 가로보다 작게 선다. `'auto'` 면 높이를 정하지 않는다 — **부모 폭을 꽉 채우고 높이는 비율로 따라온다.** 로고 자리의 폭이 정해진 곳(`SGnb` `header="fix"` 의 로고 칸)에서 쓴다. 부모에 폭이 없으면 기준을 잃어 브라우저 기본 크기(300px)로 그려진다. |
|
|
7717
|
+
| `color?` | `SColor` | — | 색. 팔레트 키(`grey_45`, `red_95` …) 또는 임의 CSS 색상. **워드마크와 서비스 표기가 모두 이 한 색이 된다.** 미지정 시 **브랜드 색**(`mode` 가 정한 워드마크 색 + 서비스 색)이다 — `SIcon` 과 달리 currentColor 를 상속하지 않는다. 로고가 주변 글자색을 따라 물들면 브랜드 색이 화면마다 달라지기 때문이다. 비활성처럼 물러나야 하는 자리에서만 색을 준다. |
|
|
7682
7718
|
| `label?` | `string` | — | 접근성 라벨. 없으면 `aria-hidden` 이다 — 로고 옆에 서비스 이름이 이미 적혀 있는 자리 (런처 목록의 한 줄 등)에서는 이름이 두 번 읽히지 않도록 그대로 둔다. 로고가 그 자리의 유일한 이름이면(로그인 화면·상단바) 브랜드명을 넘긴다. |
|
|
7683
7719
|
| `className?` | `string` | — | |
|
|
7684
7720
|
| `style?` | `CSSProperties` | — | |
|
|
@@ -7691,6 +7727,18 @@ export type SLoadingModalState = 'loading' | 'error';
|
|
|
7691
7727
|
export type SLogoName = (typeof LOGO_NAMES)[number];
|
|
7692
7728
|
```
|
|
7693
7729
|
|
|
7730
|
+
### SLogoMode
|
|
7731
|
+
|
|
7732
|
+
```ts
|
|
7733
|
+
export type SLogoMode = (typeof LOGO_MODES)[number];
|
|
7734
|
+
```
|
|
7735
|
+
|
|
7736
|
+
### SLogoDirection
|
|
7737
|
+
|
|
7738
|
+
```ts
|
|
7739
|
+
export type SLogoDirection = (typeof LOGO_DIRECTIONS)[number];
|
|
7740
|
+
```
|
|
7741
|
+
|
|
7694
7742
|
### LOGO_NAMES
|
|
7695
7743
|
|
|
7696
7744
|
```ts
|
|
@@ -7701,8 +7749,42 @@ export type SLogoName = (typeof LOGO_NAMES)[number];
|
|
|
7701
7749
|
* 하고, 워드마크의 비율은 자산 자체가 정한다. 그래서 이 파일의 값은 토큰 참조가 아니다.
|
|
7702
7750
|
*/
|
|
7703
7751
|
|
|
7704
|
-
/**
|
|
7705
|
-
|
|
7752
|
+
/**
|
|
7753
|
+
* 담고 있는 로고 — 셀메이트 본체와 서비스들, 그리고 통합 콘솔. 로고 한 벌은 [셀메이트 워드마크 + 표기]다.
|
|
7754
|
+
* 늘어나면 여기와 `logos.tsx` 의 맵에 함께 추가한다.
|
|
7755
|
+
*/
|
|
7756
|
+
export const LOGO_NAMES = [
|
|
7757
|
+
'sellmate',
|
|
7758
|
+
'wms',
|
|
7759
|
+
'chat',
|
|
7760
|
+
'plm',
|
|
7761
|
+
'account',
|
|
7762
|
+
'people',
|
|
7763
|
+
'crm',
|
|
7764
|
+
'work',
|
|
7765
|
+
'pos',
|
|
7766
|
+
'console',
|
|
7767
|
+
] as const;
|
|
7768
|
+
```
|
|
7769
|
+
|
|
7770
|
+
### LOGO_MODES
|
|
7771
|
+
|
|
7772
|
+
```ts
|
|
7773
|
+
/**
|
|
7774
|
+
* 로고가 서는 배경. 밝은 면에는 `light`(남색 워드마크), 어두운 면에는 `dark`(흰 워드마크).
|
|
7775
|
+
* 서비스 표기 색도 모드마다 원본이 정한 값으로 바뀐다(Account·POS 는 dark 에서 더 밝다).
|
|
7776
|
+
*/
|
|
7777
|
+
export const LOGO_MODES = ['light', 'dark'] as const;
|
|
7778
|
+
```
|
|
7779
|
+
|
|
7780
|
+
### LOGO_DIRECTIONS
|
|
7781
|
+
|
|
7782
|
+
```ts
|
|
7783
|
+
/**
|
|
7784
|
+
* 로고의 배치. `horizontal` 은 워드마크 오른쪽에 서비스 표기, `vertical` 은 워드마크 아래 가운데에 표기.
|
|
7785
|
+
* 모든 서비스 로고가 세로 원본을 갖는다. 셀메이트 본체는 표기가 없어 세로여도 모양이 같다.
|
|
7786
|
+
*/
|
|
7787
|
+
export const LOGO_DIRECTIONS = ['horizontal', 'vertical'] as const;
|
|
7706
7788
|
```
|
|
7707
7789
|
|
|
7708
7790
|
## Dependencies
|
|
@@ -9886,6 +9968,7 @@ export type STextLinkSize = 'sm' | 'md' | 'lg';
|
|
|
9886
9968
|
|
|
9887
9969
|
- [SChipFilter](../SChipFilter)
|
|
9888
9970
|
- [SChipInput](../SChipInput)
|
|
9971
|
+
- [SLauncherListBox](../SLauncherListBox)
|
|
9889
9972
|
- [SPopover](../SPopover)
|
|
9890
9973
|
- [STable](../STable)
|
|
9891
9974
|
|
package/dist/llms.txt
CHANGED
|
@@ -55,7 +55,7 @@
|
|
|
55
55
|
| **레이아웃** | `SLayout` `SGnb` `SGnbSystem` `SSystemActionButton`(GNB system 패널에 한 줄씩 쌓는 액션 행 — 버튼 고르기는 §3-5) `SAccountListBox`(계정 행을 눌러 뜨는 계정 패널) `SLauncherListBox`(런처 버튼을 눌러 뜨는 서비스 목록) `SPage` `SPageHeader`(페이지 제목 영역 — `SLayout` 안에서 `SPage` 앞에 둔다) `SSectionHeaderCard` `SCard` `SLoginCard`(통합 계정 로그인 화면의 카드) `SDivider` `SSplitter` `SScrollArea` `SExpansionItem` |
|
|
56
56
|
| **내비게이션** | `STabs` `SPagination` `SStepper` |
|
|
57
57
|
| **차트** | `SBarChart`(막대 그래프 — 항목끼리 크기를 견준다. `stacked` 로 항목 안의 구성까지) `SLineChart`(꺾은선 그래프 — 순서가 있는 항목의 추이를 본다. `area` 로 크기까지, `stacked` 로 구성까지) `SPieChart`(원그래프 — 한 시점의 전체를 몇 개의 몫으로 나눈다) `SDonutChart`(도넛 그래프 — 가운데가 빈 원그래프. 구멍에 글자를 두지 않는다) |
|
|
58
|
-
| **표시·상태** | `STag` `SBadge` `SIcon` `SLogo`(
|
|
58
|
+
| **표시·상태** | `STag` `SBadge` `SIcon` `SLogo`(셀메이트·서비스 로고를 아이콘처럼 — name 으로 서비스, mode 로 배경, direction 으로 가로·세로, size 는 높이다 — `"auto"` 면 부모 폭을 채운다) `SImage` `SCallout` `SContextAlert`(한 줄짜리 맥락 알림 — 오른쪽에 후속 동작 버튼) `SGuide` |
|
|
59
59
|
| **진행·로딩** | `SLinearProgress` `SCircleProgress` `SLoadingContainer` `SLoadingModal` |
|
|
60
60
|
| **오버레이** | `STooltip` `SPopover` `SPopup` `SDrawer` `SPortal` |
|
|
61
61
|
| **모달** | `SModal.confirm()` `SModal.create()` + `SActionModal` `SConfirmModal` `SModalOutlet`(앱 루트 1회) |
|
|
@@ -98,7 +98,7 @@ AI 에이전트는 코드를 생성하기 전에 이 목록을 반드시 지킨
|
|
|
98
98
|
| 직접 만든 탭/페이지네이션/스텝퍼 | `STabs`, `SPagination`, `SStepper` |
|
|
99
99
|
| `<ul>`/`<li>` 로 만든 목록 UI | `SList` + `SListItem` (드래그 정렬은 `SDraggableItem`) |
|
|
100
100
|
| 직접 만든 섹션 카드(제목 바 + 본문 박스) | `SSectionHeaderCard` 의 `title` / `padding` props |
|
|
101
|
-
| `<svg>` 직접 삽입, 이모지 아이콘 | `SIcon` (
|
|
101
|
+
| `<svg>` 직접 삽입, 이모지 아이콘 | `SIcon` (셀메이트·서비스 로고는 `SLogo`) |
|
|
102
102
|
| `<hr>` | `SDivider` |
|
|
103
103
|
| `<details>` / `<summary>` | `SExpansionItem` |
|
|
104
104
|
| `<progress>` | `SLinearProgress`, `SCircleProgress` |
|
|
@@ -586,7 +586,7 @@ Tailwind 유틸리티는 **토큰 스케일에 있는 값만** 사용한다.
|
|
|
586
586
|
| 상태·분류를 라벨로 찍는다 | `STag` | §3-1 |
|
|
587
587
|
| 색 점만으로 상태를 찍는다 | `SBadge` | §3-1 |
|
|
588
588
|
| 아이콘을 넣는다 | `SIcon` | |
|
|
589
|
-
|
|
|
589
|
+
| 셀메이트·서비스 로고를 넣는다 | `SLogo` (`name` 에 서비스, 어두운 면이면 `mode="dark"`, 표기를 아래에 두려면 `direction="vertical"`. `size` 는 **높이**이고(`"auto"` 면 부모 폭을 채운다), 색을 주지 않으면 브랜드 색이다) | §3-7-14 |
|
|
590
590
|
| 사진·썸네일을 보여준다 (로딩·실패 상태 포함) | `SImage` | §3-7-12 |
|
|
591
591
|
| 작은 썸네일을 호버해서 크게 확인하게 한다 | `SImage previewOnHover` | 툴팁·팝오버로 직접 만들지 않는다 — 미리보기는 마우스를 통과시키고 원본의 로딩·실패도 스스로 표현한다. §3-7-12 |
|
|
592
592
|
| 문장 안에서 다른 화면으로 보낸다 | `STextLink` | §3-5-6 |
|
|
@@ -1570,7 +1570,7 @@ tableRef.current.scrollToRow(row); // 복원
|
|
|
1570
1570
|
|
|
1571
1571
|
**직접 띄우지 않는다.** 런처 버튼에 붙여 여는 것은 `SGnb` 의 `launcher` 가 맡는다 — 목록만 넘기면 버튼 아래로 · 버튼 왼쪽 끝에 맞춰 뜨고, 서비스를 고르거나 바깥을 누르면 닫힌다. 고른 서비스는 **새 탭에서 열린다** — 이동도 앱이 만들지 않는다.
|
|
1572
1572
|
|
|
1573
|
-
**앱이 넘기는 것은 서비스 키와 갈
|
|
1573
|
+
**앱이 넘기는 것은 서비스 키와 갈 주소, 그리고 셀메이트 콘솔 주소뿐이다.** 로고·서비스 표기·이름·상태 태그와 콘솔 줄의 문구·아이콘은 디자인 시스템이 정해 두므로 앱이 만들지 않는다.
|
|
1574
1574
|
|
|
1575
1575
|
```tsx
|
|
1576
1576
|
<SGnb
|
|
@@ -1583,12 +1583,13 @@ tableRef.current.scrollToRow(row); // 복원
|
|
|
1583
1583
|
{ service: 'account', href: env.ACCOUNT_URL },
|
|
1584
1584
|
{ service: 'crm', href: env.CRM_URL },
|
|
1585
1585
|
],
|
|
1586
|
+
consoleHref: env.CONSOLE_URL, // 필수 — 목록 아래 "셀메이트 콘솔로 이동" 링크
|
|
1586
1587
|
}}
|
|
1587
1588
|
/>
|
|
1588
1589
|
```
|
|
1589
1590
|
|
|
1590
1591
|
- **`launcher` 를 주지 않으면 런처 버튼 자체가 렌더되지 않는다.** 옮겨 갈 서비스가 없는 앱은 이 슬롯을 비워 둔다 — 눌러도 아무것도 없는 버튼을 상단바에 남기지 않는다.
|
|
1591
|
-
- **서비스는 키(`service`)로 고른다 — 보이는 것은 아무것도 넘기지 않는다.** 쓸 수 있는 키는 `'sellmate' | 'wms' | 'account' | 'crm'`
|
|
1592
|
+
- **서비스는 키(`service`)로 고른다 — 보이는 것은 아무것도 넘기지 않는다.** 쓸 수 있는 키는 `SLogo` 가 로고를 가진 서비스 전부(`'sellmate' | 'wms' | 'chat' | 'plm' | 'account' | 'people' | 'crm' | 'work' | 'pos'` — `SLauncherService`)이고, 서비스 로고(워드마크와 `WMS`·`Account`·`CRM` … 표기가 한 덩어리인 브랜드 로고)·아래 줄 한글 이름·상태 태그(`NEW`·`출시예정`)·출시 여부를 카탈로그(`LAUNCHER_SERVICE_CATALOG`)가 그 키로 정한다. 앱이 넘기게 하면 같은 서비스가 앱마다 다른 이름·색·문구로 선다. **서비스가 늘거나 이름·상태가 바뀌면 디자인 시스템 릴리스로 따라온다** — 앱은 고칠 것이 없다.
|
|
1592
1593
|
|
|
1593
1594
|
```tsx
|
|
1594
1595
|
✅ { service: 'wms', href: env.WMS_URL }
|
|
@@ -1606,6 +1607,13 @@ tableRef.current.scrollToRow(row); // 복원
|
|
|
1606
1607
|
```
|
|
1607
1608
|
- **갈 수 없는 서비스도 목록에서 빼지 않는다.** 그 서비스가 있다는 사실과 지금은 못 간다는 사실을 함께 알리는 것이 런처의 일이다. 지금 보고 있는 서비스를 빼면 사용자가 지금 어디에 있는지가 런처에서 사라진다.
|
|
1608
1609
|
- **출시 전인 서비스는 앱이 할 일이 없다.** 카탈로그가 `출시예정` 태그와 함께 막아 두므로 주소를 줘도 열리지 않고, 열리는 날 디자인 시스템 릴리스 하나로 모든 앱에서 함께 열린다. **앱이 앞질러 열 수단은 없다.**
|
|
1610
|
+
- **셀메이트 콘솔 주소 `launcher.consoleHref` 는 필수다.** 목록 아래 구분선 밑에 `셀메이트 콘솔로 이동` 글자 링크(`STextLink`)가 **늘 서고**, 누르면 그 주소가 새 탭에서 열린다. 끄는 prop 은 없다 — 어느 서비스의 런처든 콘솔로 가는 길은 있어야 하고, 같은 곳을 같은 말로 안내해야 해서 문구·아이콘도 컴포넌트가 정한다. **`launcher.onConsoleClick` 도 이동을 하지 않는다**(`onSelect` 와 같다) — 누르면 목록은 스스로 닫힌다.
|
|
1611
|
+
|
|
1612
|
+
```tsx
|
|
1613
|
+
✅ launcher={{ items: SERVICES, consoleHref: env.CONSOLE_URL }}
|
|
1614
|
+
❌ launcher={{ items: [...SERVICES, { service: 'console', href: … }] }} // 콘솔은 서비스가 아니다
|
|
1615
|
+
❌ <SLauncherListBox …/><STextLink label="콘솔로 이동" … /> // 링크를 손으로 붙이지 않는다
|
|
1616
|
+
```
|
|
1609
1617
|
- **목록 순서를 앱이 정하지 않는다.** 넘긴 순서가 아니라 카탈로그 순서(`LAUNCHER_SERVICES`)로 선다 — 같은 런처가 앱마다 다른 순서로 뜨면 사용자가 매번 다시 찾는다. 정렬해서 넘기려 애쓰지 않는다.
|
|
1610
1618
|
- **줄에 얹으면 "여기서 나간다"는 것이 드러난다** — 배경이 옅은 파랑으로 물들고 이름이 한 단계 진해지며, 오른쪽 끝에 페이지 이동 아이콘이 떠오른다. **앱이 켜고 끄는 prop 이 없다** — 다른 서비스로 넘어가는 자리라는 신호는 화면마다 달라지면 안 된다. 갈 수 없는 줄은 얹어도 반응하지 않는다.
|
|
1611
1619
|
- **폭을 늘리지 않는다.** 로고 길이에 따라 패널이 출렁이지 않도록 고정 폭이다.
|
|
@@ -2045,25 +2053,33 @@ const [selectedId, setSelectedId] = useState<string>();
|
|
|
2045
2053
|
|
|
2046
2054
|
#### 3-7-14. 로고 — SLogo
|
|
2047
2055
|
|
|
2048
|
-
|
|
2056
|
+
셀메이트·서비스 로고는 `<svg>` 를 직접 붙이지 않고 `SLogo` 를 쓴다. **`SIcon` 과 같은 손맛(`name`·`size`·`color`)이지만 두 가지가 다르다.**
|
|
2049
2057
|
|
|
2050
|
-
- **`
|
|
2051
|
-
-
|
|
2052
|
-
-
|
|
2058
|
+
- **`name` 에 서비스를 넣으면 그 서비스 로고가 나온다**(`sellmate` · `wms` · `chat` · `plm` · `account` · `people` · `crm` · `work` · `pos` · `console` — `SLogoName`). [셀메이트 워드마크 + 서비스 표기]가 한 덩어리다. **워드마크 옆에 표기를 앱이 따로 잇지 않는다** — 표기의 서체·자간·색이 원본과 어긋난다.
|
|
2059
|
+
- **배경에 맞춰 `mode` 를 준다.** 밝은 면은 `light`(기본), 어두운 면(dark GNB 등)은 `dark`. 워드마크 색과 서비스 표기 색을 모드가 정하므로 색을 직접 주지 않는다.
|
|
2060
|
+
- **표기를 워드마크 아래에 두려면 `direction="vertical"` 을 준다**(로그인 카드처럼 폭이 좁고 로고가 가운데 서는 자리). 워드마크 아래에 표기를 앱이 따로 쌓지 않는다. 모든 서비스 로고가 세로를 가진다(`sellmate` 는 표기가 없어 어느 쪽이든 같다). 세로의 표기 색도 원본이 정하므로 색을 직접 맞추지 않는다.
|
|
2061
|
+
- **`size` 는 높이다.** 로고는 가로로 길어 정사각으로 그리면 찌그러진다 — 폭은 비율에서 저절로 나오므로 주지 않는다. `vertical` 에서는 두 줄 전체의 높이라, 같은 `size` 면 워드마크가 가로보다 작다.
|
|
2062
|
+
- **로고 자리의 폭이 정해져 있으면 `size="auto"` 로 그 폭을 채운다**(`SGnb` `header="fix"` 의 로고 칸). 높이는 비율에서 나온다. 폭을 채우려고 `className`·`style` 로 svg 를 덮지 않는다. **부모에 폭이 없는 자리에는 쓰지 않는다** — 기준을 잃어 브라우저 기본 크기(300px)로 그려진다. `header="full"` 의 로고 칸(140px 고정)에서도 쓰지 않는다 — 거기서는 높이로 주고 칸 안에 들어가는 크기를 고른다.
|
|
2063
|
+
- **색을 주지 않으면 브랜드 색이다.** `SIcon` 과 달리 currentColor 를 상속하지 않는다 — 로고가 주변 글자색을 따라 물들면 브랜드 색이 화면마다 달라진다. **비활성처럼 물러나야 하는 자리에서만** `color` 를 준다. 주면 워드마크와 서비스 표기가 모두 그 한 색이 된다(`mode` 보다 우선한다).
|
|
2053
2064
|
- **`label` 은 로고가 그 자리의 유일한 이름일 때만 준다**(로그인 화면·상단바). 옆이나 아래에 서비스 이름이 이미 적혀 있으면(런처 목록의 한 줄) 주지 않는다 — 같은 이름이 두 번 읽힌다.
|
|
2054
2065
|
|
|
2055
2066
|
```tsx
|
|
2056
|
-
✅ <SLogo size={20} /> {/* 상단바 로고 —
|
|
2067
|
+
✅ <SLogo size={20} /> {/* 상단바 로고 — 브랜드 색 */}
|
|
2068
|
+
✅ <SLogo name="wms" size={20} /> {/* 서비스 로고 */}
|
|
2069
|
+
✅ <SLogo name="wms" mode="dark" size={20} /> {/* 어두운 면 위 */}
|
|
2070
|
+
✅ <SLogo name="wms" direction="vertical" size={48} /> {/* 워드마크 아래에 표기 — 로그인 카드 */}
|
|
2057
2071
|
✅ <SLogo size={32} label="Sellmate" /> {/* 로고가 그 자리의 유일한 이름일 때 */}
|
|
2058
|
-
✅ <
|
|
2059
|
-
|
|
2060
|
-
<span className="typo-body-xs-default text-(--sys-color-fg-success)">WMS</span>
|
|
2061
|
-
</span>
|
|
2062
|
-
✅ <SLogo size={12} color="grey_45" /> {/* 아직 못 쓰는 서비스 */}
|
|
2072
|
+
✅ <SGnb header="fix" logo={<SLogo name="account" mode="dark" size="auto" />} … /> {/* fix 로고 칸을 채운다 */}
|
|
2073
|
+
✅ <SLogo name="crm" size={12} color="grey_45" /> {/* 아직 못 쓰는 서비스 — 로고 전체가 한 색 */}
|
|
2063
2074
|
|
|
2064
|
-
❌ <
|
|
2075
|
+
❌ <span><SLogo /><span>WMS</span></span> {/* 표기를 잇지 않는다 — name="wms" */}
|
|
2076
|
+
❌ <div><SLogo /><div>WMS</div></div> {/* 아래로 쌓지도 않는다 — direction="vertical" */}
|
|
2077
|
+
❌ <SLogo name="wms" color="white" /> {/* 어두운 면이면 mode="dark" — 표기 색까지 흰색이 된다 */}
|
|
2078
|
+
❌ <svg viewBox="0 0 347 50">…</svg> {/* 로고를 손으로 붙이지 않는다 */}
|
|
2065
2079
|
❌ <SLogo size={24} style={{ width: 120 }} /> {/* 폭은 비율이 정한다 — 찌그러진다 */}
|
|
2066
|
-
❌ <SLogo
|
|
2080
|
+
❌ <SLogo className="w-full [&>svg]:w-full!" /> {/* 폭을 채우려면 size="auto" */}
|
|
2081
|
+
❌ <SGnb header="full" logo={<SLogo size="auto" />} … /> {/* full 로고 칸(140px)에서는 높이로 준다 */}
|
|
2082
|
+
❌ <SLogo color="grey_45" /> {/* 물러날 이유가 없으면 브랜드 색 그대로 둔다 */}
|
|
2067
2083
|
```
|
|
2068
2084
|
|
|
2069
2085
|
#### 3-7-13. 숫자 — SNumberInput 의 min·max 는 검증 경계다
|
|
@@ -2248,15 +2264,16 @@ import { SModalOutlet } from 'sellmate-design-system-react';
|
|
|
2248
2264
|
|
|
2249
2265
|
| `header` | 상단바 배치 | 로고 폭 | `topContent` |
|
|
2250
2266
|
| --- | --- | --- | --- |
|
|
2251
|
-
| `"fix"` (기본) | `[런처 · 로고 … 폴드]` — 상단바가 GNB 컬럼 안에 있고 폴드가 컬럼 오른쪽 끝 |
|
|
2267
|
+
| `"fix"` (기본) | `[런처 · 로고 … 폴드]` — 상단바가 GNB 컬럼 안에 있고 폴드가 컬럼 오른쪽 끝 | 런처와 폴드 사이 남은 폭 (메뉴 폭을 따른다) | **렌더되지 않는다** (놓을 자리가 없다) |
|
|
2252
2268
|
| `"full"` | `[런처 · 폴드 · 로고 · topContent … system]` — 상단바가 화면 전폭이고 `system` 은 오른쪽 끝 | **140px 고정** (런처 없으면 172px) | 로고 오른쪽 남는 폭 전체 |
|
|
2253
2269
|
|
|
2254
2270
|
- `topContent` 는 상단바 로고 오른쪽 슬롯이다. 전역 검색처럼 **모든 페이지에 공통인 것만** 넣는다. 페이지별 액션은 여기가 아니라 §4-2 의 `STableBar` 로 간다.
|
|
2255
2271
|
- **계정·알림·설정·도메인·서비스 전환은 `topContent` 에 손으로 만들지 않는다.** `header="full"` 이면 `system` 슬롯의 조각들이 상단바 오른쪽 끝으로 올라오므로, 그것들은 전부 `SGnbSystem` 이 그린다 (바로 아래 절).
|
|
2256
2272
|
- 슬롯이 남는 폭을 통째로 받으므로 **정렬은 안에서 직접 잡는다** (좌측 정렬 + 우측은 `ml-auto`).
|
|
2257
|
-
- `header="
|
|
2273
|
+
- `header="fix"` 에서 로고 자리는 런처와 폴드 버튼 사이의 남은 폭이다. **`SLogo size="auto"` 를 넣으면 그 폭을 채운다** — 메뉴 폭을 바꾸거나 로고 종류가 바뀌어도 폭에 맞춰진다. 높이(`size`)로 준 로고가 그보다 넓으면 잘린다.
|
|
2274
|
+
- `header="full"` 에서 로고 자리는 140px 로 고정된다 — 로고 내용이 바뀌어도 `topContent` 시작점이 흔들리지 않게 하기 위함이다. 로고가 그보다 넓으면 잘리므로 이 폭에 맞춰 준비한다. **여기서는 `SLogo size="auto"` 를 쓰지 않는다** — 높이(`size`)로 주고 140px 안에 들어가는 크기를 고른다.
|
|
2258
2275
|
- `launcher` 를 주지 않으면 런처가 렌더되지 않고, 그 자리(버튼 + 간격)를 로고 슬롯이 이어받아 172px 가 된다. `topContent` 시작점은 런처 유무와 관계없이 같은 자리다.
|
|
2259
|
-
- **런처 버튼은 서비스 목록의 트리거다.** `launcher.items` 에 옮겨 갈 서비스를 **키와 주소로** 넘기면 버튼 아래로 목록이 뜨고, 고른 서비스가 새 탭에서
|
|
2276
|
+
- **런처 버튼은 서비스 목록의 트리거다.** `launcher.items` 에 옮겨 갈 서비스를 **키와 주소로** 넘기면 버튼 아래로 목록이 뜨고, 고른 서비스가 새 탭에서 열린다. 셀메이트 콘솔로 가는 줄은 `launcher.consoleHref` 로 붙는다 — 팝오버도 이동도 손으로 만들지 않는다 (§3-5-9).
|
|
2260
2277
|
|
|
2261
2278
|
```tsx
|
|
2262
2279
|
<SLayout type="box" header="full">
|
|
@@ -2950,9 +2967,10 @@ export default function LoginPage() {
|
|
|
2950
2967
|
// 여백은 카드가 최소 폭을 지킬 수 있는 값으로 둔다 — 카드 폭은 className 으로 박지 않는다
|
|
2951
2968
|
<div className="flex h-screen items-stretch justify-center bg-bg-neutralLight p-sd-24">
|
|
2952
2969
|
<SLoginCard
|
|
2953
|
-
|
|
2954
|
-
|
|
2955
|
-
|
|
2970
|
+
// 제품은 서비스 키로 고른다 — 카드가 그 서비스의 세로 로고를 그린다. 제품명을 글자로 넘기지 않는다
|
|
2971
|
+
service="account"
|
|
2972
|
+
title="쇼핑몰 대표님을 위한 정부·세무 도우미입니다."
|
|
2973
|
+
description="(세금 신고 일정과 지원사업 소식을 한곳에서 챙겨 드립니다.)"
|
|
2956
2974
|
// 로그인 버튼은 카드가 그린다 — 동작만 넘긴다
|
|
2957
2975
|
onLogin={() => navigate('/auth/sso')}
|
|
2958
2976
|
footerNote="계정이 없다면 담당자에게 문의를 요청해 주세요."
|
|
@@ -2980,7 +2998,7 @@ export default function LoginPage() {
|
|
|
2980
2998
|
|
|
2981
2999
|
| Prop | 용도 |
|
|
2982
3000
|
| --- | --- |
|
|
2983
|
-
| `
|
|
3001
|
+
| `service` | 제품 — `SLogo` 의 로고명(`account` · `wms` · `chat` …, `SLogoName`). 카드 맨 위에 그 서비스의 세로 로고가 선다 |
|
|
2984
3002
|
| `title` | 제품을 한 줄로 소개하는 문장 |
|
|
2985
3003
|
| `description` | 소개 바로 아래 붙는 보조 설명. 소개와 한 문단으로 읽힌다 — 없으면 생략한다 |
|
|
2986
3004
|
| `onLogin` | 로그인 버튼을 눌렀을 때. **버튼은 카드가 그리므로 동작만 넘긴다** — 문구·색·크기는 세 제품에서 같아야 한다 |
|
|
@@ -2993,7 +3011,12 @@ export default function LoginPage() {
|
|
|
2993
3011
|
|
|
2994
3012
|
**크기는 부모가 정한다 — `className` 으로 폭을 박지 않는다.** 카드는 폭을 368~640px 사이에서 부모에 맞추고 높이도 부모가 준 만큼 채운다. 밖에서 고정하면 상하한이 무의미해져, 좁은 화면에서 함께 좁아져야 할 카드가 그대로 남아 넘친다. 좁게 세워야 하면 카드가 아니라 바깥 한 겹을 좁힌다.
|
|
2995
3013
|
|
|
2996
|
-
|
|
3014
|
+
**로고와 로그인 버튼은 카드가 직접 그린다.** 로고는 `service` 키로 고르면 카드가 그 서비스의 세로 로고(`SLogo direction="vertical"`)를 크기·접근성 이름까지 정해 세운다 — **제품명을 글자로 넘기거나 로고를 따로 얹지 않는다.** 표기의 서체·자간·색은 원본 로고가 정한다. 버튼은 모든 제품이 같은 문구(`통합 계정으로 로그인`)로 서므로 넘길 것이 없다. 앱이 주는 것은 서비스 키·문구·`onLogin` 동작뿐이다.
|
|
3015
|
+
|
|
3016
|
+
```tsx
|
|
3017
|
+
✅ <SLoginCard service="account" title="…" onLogin={login} />
|
|
3018
|
+
❌ <SLoginCard service="sellmate" title={<><b>Account</b> …</>} /> {/* 제품명을 글자로 잇지 않는다 — service="account" */}
|
|
3019
|
+
```
|
|
2997
3020
|
|
|
2998
3021
|
**로그인 카드 옆에 다른 블록을 두지 않는다.** 이 화면에서 할 일은 로그인 하나이고, 옆에 공지·배너가 붙는 순간 그 뜻이 깨진다. 안내가 필요하면 `description` 이나 `footerNote` 로 넣는다.
|
|
2999
3022
|
|