@ceed/cds 1.28.1 → 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.
Files changed (63) hide show
  1. package/dist/components/CurrencyInput/CurrencyInput.d.ts +1 -1
  2. package/dist/components/CurrencyInput/hooks/use-currency-setting.d.ts +2 -2
  3. package/dist/components/SearchBar/SearchBar.d.ts +21 -0
  4. package/dist/components/SearchBar/index.d.ts +3 -0
  5. package/dist/components/data-display/DataTable.md +1 -1
  6. package/dist/components/data-display/InfoSign.md +91 -74
  7. package/dist/components/data-display/Typography.md +94 -411
  8. package/dist/components/feedback/Dialog.md +62 -76
  9. package/dist/components/feedback/Modal.md +138 -430
  10. package/dist/components/feedback/llms.txt +0 -2
  11. package/dist/components/index.d.ts +2 -1
  12. package/dist/components/inputs/Autocomplete.md +107 -356
  13. package/dist/components/inputs/ButtonGroup.md +104 -115
  14. package/dist/components/inputs/CurrencyInput.md +5 -183
  15. package/dist/components/inputs/DatePicker.md +431 -108
  16. package/dist/components/inputs/DateRangePicker.md +492 -131
  17. package/dist/components/inputs/FilterableCheckboxGroup.md +19 -145
  18. package/dist/components/inputs/IconButton.md +88 -137
  19. package/dist/components/inputs/Input.md +73 -204
  20. package/dist/components/inputs/MonthPicker.md +422 -95
  21. package/dist/components/inputs/MonthRangePicker.md +466 -89
  22. package/dist/components/inputs/PercentageInput.md +16 -185
  23. package/dist/components/inputs/RadioButton.md +35 -163
  24. package/dist/components/inputs/SearchBar.md +44 -0
  25. package/dist/components/inputs/Select.md +326 -222
  26. package/dist/components/inputs/Switch.md +376 -143
  27. package/dist/components/inputs/Textarea.md +10 -213
  28. package/dist/components/inputs/Uploader/Uploader.md +66 -145
  29. package/dist/components/inputs/llms.txt +1 -4
  30. package/dist/components/navigation/Breadcrumbs.md +308 -57
  31. package/dist/components/navigation/Drawer.md +0 -180
  32. package/dist/components/navigation/Dropdown.md +215 -98
  33. package/dist/components/navigation/IconMenuButton.md +502 -40
  34. package/dist/components/navigation/InsetDrawer.md +650 -281
  35. package/dist/components/navigation/Link.md +348 -31
  36. package/dist/components/navigation/Menu.md +285 -92
  37. package/dist/components/navigation/MenuButton.md +448 -55
  38. package/dist/components/navigation/Pagination.md +338 -47
  39. package/dist/components/navigation/Stepper.md +28 -160
  40. package/dist/components/navigation/Tabs.md +316 -57
  41. package/dist/components/surfaces/Accordions.md +804 -49
  42. package/dist/components/surfaces/Card.md +157 -97
  43. package/dist/components/surfaces/Divider.md +234 -83
  44. package/dist/components/surfaces/Sheet.md +328 -153
  45. package/dist/index.cjs +411 -574
  46. package/dist/index.d.ts +1 -1
  47. package/dist/index.js +400 -507
  48. package/dist/llms.txt +1 -9
  49. package/framer/index.js +1 -1
  50. package/package.json +17 -22
  51. package/dist/chunks/rehype-accent-FZRUD7VI.js +0 -39
  52. package/dist/components/RadioTileGroup/RadioTileGroup.d.ts +0 -56
  53. package/dist/components/RadioTileGroup/index.d.ts +0 -3
  54. package/dist/components/feedback/CircularProgress.md +0 -257
  55. package/dist/components/feedback/Skeleton.md +0 -280
  56. package/dist/components/inputs/FormControl.md +0 -361
  57. package/dist/components/inputs/RadioList.md +0 -241
  58. package/dist/components/inputs/RadioTileGroup.md +0 -507
  59. package/dist/components/inputs/Slider.md +0 -334
  60. package/dist/guides/ThemeProvider.md +0 -89
  61. package/dist/guides/llms.txt +0 -9
  62. package/dist/index.browser.js +0 -224
  63. 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' | 'CAD';
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" | "CAD" | undefined;
2
+ currency?: "USD" | "KRW" | "BHD" | undefined;
3
3
  placeholder?: string | undefined;
4
4
  }) => {
5
5
  symbol: string;
6
6
  thousandSeparator: string;
7
- decimalSeparator: string | undefined;
7
+ decimalSeparator: string;
8
8
  placeholder: string;
9
9
  fixedDecimalScale: boolean;
10
10
  decimalScale: number;
@@ -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 };
@@ -0,0 +1,3 @@
1
+ import { SearchBar } from './SearchBar';
2
+ export * from './SearchBar';
3
+ export default 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={log} level="body-xs">
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 is a compact tooltip-trigger component that displays a small question-mark icon. When users hover over or focus on the icon, a tooltip appears with supplementary information. It is designed to provide contextual help without cluttering the interface -- ideal for explaining form fields, settings options, table column headers, and complex metrics.
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
- <label>
28
- Complex Setting
29
- <InfoSign
30
- message="This setting affects overall system performance. Consult an administrator before making changes."
31
- />
32
- </label>
25
+ <div>
26
+ <label>
27
+ 복잡한 설정 항목
28
+ <InfoSign message=" 설정은 시스템 전체 성능에 영향을 있습니다. 변경하기 전에 관리자와 상의하세요." />
29
+ </label>
30
+ </div>
33
31
  );
34
32
  }
35
33
  ```
36
34
 
37
- ## Basic
35
+ ## Examples
36
+
37
+ ### Basic Usage
38
38
 
39
- The default InfoSign displays a question-mark icon that reveals a tooltip on hover or focus.
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
- import { InfoSign } from '@ceed/cds';
54
- import { FormControl, FormLabel, Input } from '@ceed/cds';
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
- function PasswordField() {
57
- return (
58
- <FormControl>
59
- <FormLabel>
60
- Password
61
- <InfoSign
62
- message="Must be at least 8 characters and include uppercase, lowercase, number, and special character."
63
- placement="top"
64
- />
65
- </FormLabel>
66
- <Input type="password" />
67
- </FormControl>
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
- ### Table Column Header
79
+ ### Complex Data Explanation
73
80
 
74
81
  ```tsx
75
- import { InfoSign } from '@ceed/cds';
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
- function TableHeader() {
78
- return (
79
- <thead>
80
- <tr>
81
- <th>
82
- User ID
83
- <InfoSign message="Auto-generated unique identifier assigned by the system." />
84
- </th>
85
- <th>
86
- Last Activity
87
- <InfoSign message="The most recent login or action timestamp for this user." />
88
- </th>
89
- <th>Status</th>
90
- </tr>
91
- </thead>
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
- ### Dashboard Metric Explanation
116
+ ## Props
117
+
118
+ ### placement
119
+
120
+ 툴팁이 나타나는 위치를 설정할 수 있습니다.
97
121
 
98
122
  ```tsx
99
- import { InfoSign, Typography, Stack } from '@ceed/cds';
123
+ <InfoSign placement="top" message="위쪽에 표시" />
124
+ <InfoSign placement="bottom" message="아래쪽에 표시" />
125
+ <InfoSign placement="left" message="왼쪽에 표시" />
126
+ <InfoSign placement="right" message="오른쪽에 표시" />
127
+ ```
100
128
 
101
- function MetricCard() {
102
- return (
103
- <Stack spacing={1}>
104
- <Typography level="title-md">
105
- Throughput
106
- <InfoSign
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
- - **Keep messages concise.** Tooltip messages should be 1-2 sentences that quickly answer "what does this mean?" Avoid paragraphs of text.
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
- - **Do not overuse InfoSign.** Adding a help icon to every single field creates visual noise and suggests the interface itself is too confusing. Reserve it for genuinely complex or ambiguous items.
141
+ 2. **적절한 배치**: 설명하려는 요소 바로 옆에 배치하여 연관성을 명확히 합니다.
126
142
 
127
- - **Choose placement that avoids overlap.** Use `placement="top"` or `placement="right"` for fields near the bottom of a viewport, and `placement="bottom"` for elements near the top.
143
+ 3. **일관된 사용**: 비슷한 성격의 정보에는 일관되게 InfoSign을 사용합니다.
128
144
 
129
- - **Use InfoSign for supplementary information only.** Critical instructions or warnings should be displayed inline (e.g., with FormHelperText or Alert), not hidden behind a tooltip.
145
+ 4. **과도한 사용 금지**: 모든 요소에 InfoSign을 붙이면 인터페이스가 복잡해집니다.
130
146
 
131
147
  ## Accessibility
132
148
 
133
- - InfoSign is keyboard-focusable, allowing users to trigger the tooltip using **Tab** navigation without requiring a mouse.
134
- - The tooltip content is announced by screen readers when the InfoSign receives focus, thanks to built-in ARIA attributes.
135
- - The question-mark icon serves as a universally recognized visual cue for "more information," making it intuitive for all users.
136
- - Ensure that the `message` text provides the same information available through other channels -- do not make the tooltip the only way to learn critical information.
149
+ - InfoSign 키보드 탐색이 가능합니다
150
+ - 스크린 리더가 메시지 내용을 읽을 있습니다
151
+ - ARIA 라벨이 자동으로 적용됩니다
152
+
153
+ InfoSign은 사용자에게 필요한 추가 정보를 제공하면서도 인터페이스를 깔끔하게 유지하는 데 도움이 되는 유용한 컴포넌트입니다.