@ceed/cds 1.28.0 → 1.29.0-next.1
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/dist/components/CurrencyInput/CurrencyInput.d.ts +1 -1
- package/dist/components/CurrencyInput/hooks/use-currency-setting.d.ts +2 -2
- package/dist/components/DataTable/hooks.d.ts +2 -1
- package/dist/components/DataTable/utils.d.ts +1 -0
- package/dist/components/SearchBar/SearchBar.d.ts +21 -0
- package/dist/components/SearchBar/index.d.ts +3 -0
- package/dist/components/data-display/DataTable.md +1 -1
- package/dist/components/data-display/InfoSign.md +91 -74
- package/dist/components/data-display/Typography.md +94 -411
- package/dist/components/feedback/Dialog.md +62 -76
- package/dist/components/feedback/Modal.md +138 -430
- package/dist/components/feedback/llms.txt +0 -2
- package/dist/components/index.d.ts +2 -1
- package/dist/components/inputs/Autocomplete.md +107 -356
- package/dist/components/inputs/ButtonGroup.md +104 -115
- package/dist/components/inputs/CurrencyInput.md +5 -183
- package/dist/components/inputs/DatePicker.md +431 -108
- package/dist/components/inputs/DateRangePicker.md +492 -131
- package/dist/components/inputs/FilterableCheckboxGroup.md +19 -145
- package/dist/components/inputs/IconButton.md +88 -137
- package/dist/components/inputs/Input.md +73 -204
- package/dist/components/inputs/MonthPicker.md +422 -95
- package/dist/components/inputs/MonthRangePicker.md +466 -89
- package/dist/components/inputs/PercentageInput.md +16 -185
- package/dist/components/inputs/RadioButton.md +35 -163
- package/dist/components/inputs/SearchBar.md +44 -0
- package/dist/components/inputs/Select.md +326 -222
- package/dist/components/inputs/Switch.md +376 -143
- package/dist/components/inputs/Textarea.md +10 -213
- package/dist/components/inputs/Uploader/Uploader.md +66 -145
- package/dist/components/inputs/llms.txt +1 -4
- package/dist/components/navigation/Breadcrumbs.md +308 -57
- package/dist/components/navigation/Drawer.md +0 -180
- package/dist/components/navigation/Dropdown.md +215 -98
- package/dist/components/navigation/IconMenuButton.md +502 -40
- package/dist/components/navigation/InsetDrawer.md +650 -281
- package/dist/components/navigation/Link.md +348 -31
- package/dist/components/navigation/Menu.md +285 -92
- package/dist/components/navigation/MenuButton.md +448 -55
- package/dist/components/navigation/Pagination.md +338 -47
- package/dist/components/navigation/Stepper.md +28 -160
- package/dist/components/navigation/Tabs.md +316 -57
- package/dist/components/surfaces/Accordions.md +804 -49
- package/dist/components/surfaces/Card.md +157 -97
- package/dist/components/surfaces/Divider.md +234 -83
- package/dist/components/surfaces/Sheet.md +328 -153
- package/dist/index.cjs +435 -577
- package/dist/index.d.ts +1 -1
- package/dist/index.js +424 -510
- package/dist/llms.txt +1 -9
- package/framer/index.js +1 -1
- package/package.json +17 -22
- package/dist/chunks/rehype-accent-FZRUD7VI.js +0 -39
- package/dist/components/RadioTileGroup/RadioTileGroup.d.ts +0 -56
- package/dist/components/RadioTileGroup/index.d.ts +0 -3
- package/dist/components/feedback/CircularProgress.md +0 -257
- package/dist/components/feedback/Skeleton.md +0 -280
- package/dist/components/inputs/FormControl.md +0 -361
- package/dist/components/inputs/RadioList.md +0 -241
- package/dist/components/inputs/RadioTileGroup.md +0 -507
- package/dist/components/inputs/Slider.md +0 -334
- package/dist/guides/ThemeProvider.md +0 -89
- package/dist/guides/llms.txt +0 -9
- package/dist/index.browser.js +0 -224
- package/dist/index.browser.js.map +0 -7
|
@@ -2,7 +2,7 @@ import React from 'react';
|
|
|
2
2
|
import { InputProps } from '@mui/joy';
|
|
3
3
|
import { MotionProps } from 'framer-motion';
|
|
4
4
|
interface CurrencyInputProps {
|
|
5
|
-
currency?: 'USD' | 'KRW'
|
|
5
|
+
currency?: 'USD' | 'KRW';
|
|
6
6
|
max?: number;
|
|
7
7
|
value?: number;
|
|
8
8
|
defaultValue?: number;
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
export declare const useCurrencySetting: (props: {
|
|
2
|
-
currency?: "USD" | "KRW" | "BHD" |
|
|
2
|
+
currency?: "USD" | "KRW" | "BHD" | undefined;
|
|
3
3
|
placeholder?: string | undefined;
|
|
4
4
|
}) => {
|
|
5
5
|
symbol: string;
|
|
6
6
|
thousandSeparator: string;
|
|
7
|
-
decimalSeparator: string
|
|
7
|
+
decimalSeparator: string;
|
|
8
8
|
placeholder: string;
|
|
9
9
|
fixedDecimalScale: boolean;
|
|
10
10
|
decimalScale: number;
|
|
@@ -5,7 +5,7 @@ export declare function useColumnWidths<T>(columnsByField: {
|
|
|
5
5
|
headerRef: React.RefObject<HTMLTableCellElement>;
|
|
6
6
|
};
|
|
7
7
|
}): Record<string, number>;
|
|
8
|
-
export declare function useDataTableRenderer<T extends Record<PropertyKey, unknown>, GetId extends ((row: T) => any) | undefined = undefined>({ rows: _rows, columns: columnsProp, pinnedColumns, rowCount: totalRowsProp, initialState, pagination, paginationMode, paginationModel, onPaginationModelChange, sortModel: controlledSortModel, sortOrder: _sortOrder, selectionModel, onSortModelChange, onSelectionModelChange, editMode, getId: _getId, isTotalSelected: _isTotalSelected, isRowSelectable, columnGroupingModel, columnVisibilityModel, onColumnVisibilityModelChange, }: DataTableProps<T, GetId>): {
|
|
8
|
+
export declare function useDataTableRenderer<T extends Record<PropertyKey, unknown>, GetId extends ((row: T) => any) | undefined = undefined>({ rows: _rows, columns: columnsProp, pinnedColumns, rowCount: totalRowsProp, initialState, pagination, paginationMode, paginationModel, onPaginationModelChange, sortModel: controlledSortModel, sortOrder: _sortOrder, selectionModel, onSortModelChange, onSelectionModelChange, editMode, getId: _getId, isTotalSelected: _isTotalSelected, isRowSelectable, columnGroupingModel, columnVisibilityModel, onColumnVisibilityModelChange, checkboxSelection, }: DataTableProps<T, GetId>): {
|
|
9
9
|
rowCount: number;
|
|
10
10
|
selectableRowCount: number;
|
|
11
11
|
page: number;
|
|
@@ -49,6 +49,7 @@ export declare function useDataTableRenderer<T extends Record<PropertyKey, unkno
|
|
|
49
49
|
onAllCheckboxChange: () => void;
|
|
50
50
|
onCheckboxChange: (event: React.MouseEvent | React.ChangeEvent | React.KeyboardEvent, selectedModel: InferredIdType<T, GetId>) => void;
|
|
51
51
|
columns: ColumnDef<T, InferredIdType<T, GetId>>[];
|
|
52
|
+
tableMinWidth: number;
|
|
52
53
|
processedColumnGroups: {
|
|
53
54
|
groups: import("./types").ProcessedColumnGroup[][];
|
|
54
55
|
maxLevel: number;
|
|
@@ -9,6 +9,7 @@ export declare function calculateColumnGroups<T extends Record<PropertyKey, any>
|
|
|
9
9
|
maxLevel: number;
|
|
10
10
|
fieldsInGroupingModel: Set<keyof T>;
|
|
11
11
|
};
|
|
12
|
+
export declare function parsePxValue(value: string | undefined): number | null;
|
|
12
13
|
export declare function getTextAlign(props: {
|
|
13
14
|
editMode?: boolean;
|
|
14
15
|
type?: string;
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import React from 'react';
|
|
2
|
+
export interface SearchBarOption {
|
|
3
|
+
label: string;
|
|
4
|
+
value: string;
|
|
5
|
+
placeholder?: string;
|
|
6
|
+
}
|
|
7
|
+
export interface SearchBarProps {
|
|
8
|
+
hideSelect?: boolean;
|
|
9
|
+
options?: SearchBarOption[];
|
|
10
|
+
value: string;
|
|
11
|
+
onChange: (value: string) => void;
|
|
12
|
+
onSearch?: (params: {
|
|
13
|
+
selectValue?: string;
|
|
14
|
+
inputValue: string;
|
|
15
|
+
}) => void;
|
|
16
|
+
}
|
|
17
|
+
declare function SearchBar(props: SearchBarProps): React.JSX.Element;
|
|
18
|
+
declare namespace SearchBar {
|
|
19
|
+
var displayName: string;
|
|
20
|
+
}
|
|
21
|
+
export { SearchBar };
|
|
@@ -1367,7 +1367,7 @@ You can use `onCellEditStart` and `onCellEditStop` to detect when editing starts
|
|
|
1367
1367
|
</Typography>
|
|
1368
1368
|
{editLog.length === 0 ? <Typography level="body-xs" textColor="text.secondary">
|
|
1369
1369
|
No edits yet. Click on a cell to edit.
|
|
1370
|
-
</Typography> : editLog.map(log => <Typography key={
|
|
1370
|
+
</Typography> : editLog.map((log, i) => <Typography key={i} level="body-xs">
|
|
1371
1371
|
{log}
|
|
1372
1372
|
</Typography>)}
|
|
1373
1373
|
</Box>
|
|
@@ -2,9 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
## Introduction
|
|
4
4
|
|
|
5
|
-
InfoSign
|
|
6
|
-
|
|
7
|
-
The component accepts a `message` prop for the tooltip content and a `placement` prop to control where the tooltip appears relative to the icon. InfoSign keeps the main UI clean while ensuring that detailed guidance is always one interaction away.
|
|
5
|
+
InfoSign 컴포넌트는 사용자에게 추가 정보를 제공하기 위한 툴팁 아이콘입니다. 물음표 아이콘을 클릭하거나 호버할 때 상세한 설명이나 도움말을 표시할 수 있습니다. 폼 필드, 설정 항목, 복잡한 기능에 대한 설명을 제공할 때 유용합니다.
|
|
8
6
|
|
|
9
7
|
```tsx
|
|
10
8
|
<InfoSign
|
|
@@ -24,19 +22,21 @@ import { InfoSign } from '@ceed/cds';
|
|
|
24
22
|
|
|
25
23
|
function MyComponent() {
|
|
26
24
|
return (
|
|
27
|
-
<
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
message="
|
|
31
|
-
|
|
32
|
-
</
|
|
25
|
+
<div>
|
|
26
|
+
<label>
|
|
27
|
+
복잡한 설정 항목
|
|
28
|
+
<InfoSign message="이 설정은 시스템 전체 성능에 영향을 줄 수 있습니다. 변경하기 전에 관리자와 상의하세요." />
|
|
29
|
+
</label>
|
|
30
|
+
</div>
|
|
33
31
|
);
|
|
34
32
|
}
|
|
35
33
|
```
|
|
36
34
|
|
|
37
|
-
##
|
|
35
|
+
## Examples
|
|
36
|
+
|
|
37
|
+
### Basic Usage
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
가장 기본적인 InfoSign 사용법입니다.
|
|
40
40
|
|
|
41
41
|
```tsx
|
|
42
42
|
<InfoSign
|
|
@@ -50,87 +50,104 @@ The default InfoSign displays a question-mark icon that reveals a tooltip on hov
|
|
|
50
50
|
### Form Field Help
|
|
51
51
|
|
|
52
52
|
```tsx
|
|
53
|
-
|
|
54
|
-
|
|
53
|
+
<FormControl>
|
|
54
|
+
<FormLabel>
|
|
55
|
+
비밀번호 복잡도
|
|
56
|
+
<InfoSign
|
|
57
|
+
message="비밀번호는 최소 8자 이상이며, 대문자, 소문자, 숫자, 특수문자를 포함해야 합니다."
|
|
58
|
+
placement="top"
|
|
59
|
+
/>
|
|
60
|
+
</FormLabel>
|
|
61
|
+
<Input type="password" />
|
|
62
|
+
</FormControl>
|
|
63
|
+
```
|
|
55
64
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
);
|
|
69
|
-
}
|
|
65
|
+
### Settings Explanation
|
|
66
|
+
|
|
67
|
+
```tsx
|
|
68
|
+
<Stack spacing={2}>
|
|
69
|
+
<Box>
|
|
70
|
+
<Typography level="title-sm">
|
|
71
|
+
자동 저장
|
|
72
|
+
<InfoSign message="이 기능을 활성화하면 5분마다 자동으로 작업 내용이 저장됩니다." placement="right" />
|
|
73
|
+
</Typography>
|
|
74
|
+
<Switch />
|
|
75
|
+
</Box>
|
|
76
|
+
</Stack>
|
|
70
77
|
```
|
|
71
78
|
|
|
72
|
-
###
|
|
79
|
+
### Complex Data Explanation
|
|
73
80
|
|
|
74
81
|
```tsx
|
|
75
|
-
|
|
82
|
+
<Card>
|
|
83
|
+
<CardContent>
|
|
84
|
+
<Typography level="title-md">
|
|
85
|
+
처리량 지표
|
|
86
|
+
<InfoSign
|
|
87
|
+
message="처리량은 최근 24시간 동안의 평균 요청 수를 나타냅니다. 이 값이 높을수록 시스템이 더 많은 작업을 처리하고 있다는 의미입니다."
|
|
88
|
+
placement="bottom"
|
|
89
|
+
/>
|
|
90
|
+
</Typography>
|
|
91
|
+
<Typography level="h2">1,234 req/min</Typography>
|
|
92
|
+
</CardContent>
|
|
93
|
+
</Card>
|
|
94
|
+
```
|
|
76
95
|
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
<
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
<
|
|
90
|
-
</
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
96
|
+
### Table Header Help
|
|
97
|
+
|
|
98
|
+
```tsx
|
|
99
|
+
<Table>
|
|
100
|
+
<thead>
|
|
101
|
+
<tr>
|
|
102
|
+
<th>
|
|
103
|
+
사용자 ID
|
|
104
|
+
<InfoSign message="시스템에서 자동 생성된 고유 식별자입니다." />
|
|
105
|
+
</th>
|
|
106
|
+
<th>
|
|
107
|
+
마지막 활동
|
|
108
|
+
<InfoSign message="사용자가 마지막으로 로그인하거나 활동한 시간입니다." />
|
|
109
|
+
</th>
|
|
110
|
+
<th>상태</th>
|
|
111
|
+
</tr>
|
|
112
|
+
</thead>
|
|
113
|
+
</Table>
|
|
94
114
|
```
|
|
95
115
|
|
|
96
|
-
|
|
116
|
+
## Props
|
|
117
|
+
|
|
118
|
+
### placement
|
|
119
|
+
|
|
120
|
+
툴팁이 나타나는 위치를 설정할 수 있습니다.
|
|
97
121
|
|
|
98
122
|
```tsx
|
|
99
|
-
|
|
123
|
+
<InfoSign placement="top" message="위쪽에 표시" />
|
|
124
|
+
<InfoSign placement="bottom" message="아래쪽에 표시" />
|
|
125
|
+
<InfoSign placement="left" message="왼쪽에 표시" />
|
|
126
|
+
<InfoSign placement="right" message="오른쪽에 표시" />
|
|
127
|
+
```
|
|
100
128
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
message="Average requests per minute over the last 24 hours. Higher values indicate greater system load."
|
|
108
|
-
placement="right"
|
|
109
|
-
/>
|
|
110
|
-
</Typography>
|
|
111
|
-
<Typography level="h2">1,234 req/min</Typography>
|
|
112
|
-
</Stack>
|
|
113
|
-
);
|
|
114
|
-
}
|
|
129
|
+
### message
|
|
130
|
+
|
|
131
|
+
표시할 메시지 내용입니다. 긴 텍스트도 지원합니다.
|
|
132
|
+
|
|
133
|
+
```tsx
|
|
134
|
+
<InfoSign message="여러 줄로 된 긴 설명문도 표시할 수 있습니다.\n줄바꿈도 지원되므로 상세한 설명을 제공할 수 있습니다." />
|
|
115
135
|
```
|
|
116
136
|
|
|
117
137
|
## Best Practices
|
|
118
138
|
|
|
119
|
-
|
|
120
|
-
- ✔ "Maximum file size per upload. Files exceeding this limit will be rejected."
|
|
121
|
-
- ✘ A multi-paragraph explanation with examples and edge cases
|
|
122
|
-
|
|
123
|
-
- **Place InfoSign directly adjacent to the element it explains.** Position it immediately after a label or header text so users can easily associate the help icon with the relevant field.
|
|
139
|
+
1. **간결한 메시지**: 핵심 정보만 포함하여 사용자가 빠르게 이해할 수 있도록 합니다.
|
|
124
140
|
|
|
125
|
-
|
|
141
|
+
2. **적절한 배치**: 설명하려는 요소 바로 옆에 배치하여 연관성을 명확히 합니다.
|
|
126
142
|
|
|
127
|
-
|
|
143
|
+
3. **일관된 사용**: 비슷한 성격의 정보에는 일관되게 InfoSign을 사용합니다.
|
|
128
144
|
|
|
129
|
-
|
|
145
|
+
4. **과도한 사용 금지**: 모든 요소에 InfoSign을 붙이면 인터페이스가 복잡해집니다.
|
|
130
146
|
|
|
131
147
|
## Accessibility
|
|
132
148
|
|
|
133
|
-
- InfoSign
|
|
134
|
-
-
|
|
135
|
-
-
|
|
136
|
-
|
|
149
|
+
- InfoSign은 키보드 탐색이 가능합니다
|
|
150
|
+
- 스크린 리더가 메시지 내용을 읽을 수 있습니다
|
|
151
|
+
- ARIA 라벨이 자동으로 적용됩니다
|
|
152
|
+
|
|
153
|
+
InfoSign은 사용자에게 필요한 추가 정보를 제공하면서도 인터페이스를 깔끔하게 유지하는 데 도움이 되는 유용한 컴포넌트입니다.
|