@ceed/ads 1.35.1 → 1.37.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 (124) hide show
  1. package/README.md +85 -95
  2. package/dist/components/Accordions/Accordions.d.ts +1 -0
  3. package/dist/components/Alert/Alert.d.ts +5 -5
  4. package/dist/components/Autocomplete/Autocomplete.d.ts +2 -2
  5. package/dist/components/Avatar/Avatar.d.ts +7 -17
  6. package/dist/components/Box/Box.d.ts +1 -0
  7. package/dist/components/Breadcrumbs/Breadcrumbs.d.ts +6 -5
  8. package/dist/components/Button/Button.d.ts +3 -2
  9. package/dist/components/Calendar/Calendar.d.ts +1 -0
  10. package/dist/components/Card/Card.d.ts +1 -0
  11. package/dist/components/Checkbox/Checkbox.d.ts +1 -0
  12. package/dist/components/Chip/Chip.d.ts +1 -0
  13. package/dist/components/Container/Container.d.ts +6 -1
  14. package/dist/components/DialogActions/DialogActions.d.ts +1 -0
  15. package/dist/components/DialogContent/DialogContent.d.ts +1 -0
  16. package/dist/components/DialogFrame/DialogFrame.d.ts +1 -1
  17. package/dist/components/DialogTitle/DialogTitle.d.ts +1 -0
  18. package/dist/components/Divider/Divider.d.ts +1 -0
  19. package/dist/components/Dropdown/Dropdown.d.ts +28 -1
  20. package/dist/components/FilterMenu/components/MonthRange.d.ts +11 -0
  21. package/dist/components/FilterMenu/types.d.ts +5 -1
  22. package/dist/components/FilterableCheckboxGroup/FilterableCheckboxGroup.d.ts +1 -1
  23. package/dist/components/FormControl/FormControl.d.ts +1 -0
  24. package/dist/components/FormHelperText/FormHelperText.d.ts +1 -0
  25. package/dist/components/FormLabel/FormLabel.d.ts +1 -0
  26. package/dist/components/Grid/Grid.d.ts +1 -0
  27. package/dist/components/IconButton/IconButton.d.ts +3 -2
  28. package/dist/components/IconMenuButton/IconMenuButton.d.ts +7 -6
  29. package/dist/components/InfoSign/InfoSign.d.ts +3 -2
  30. package/dist/components/Input/Input.d.ts +8 -22
  31. package/dist/components/InsetDrawer/InsetDrawer.d.ts +1 -0
  32. package/dist/components/Markdown/Markdown.d.ts +9 -24
  33. package/dist/components/Menu/Menu.d.ts +2 -1
  34. package/dist/components/MenuButton/MenuButton.d.ts +10 -8
  35. package/dist/components/Modal/Modal.d.ts +4 -2
  36. package/dist/components/NavigationGroup/NavigationGroup.d.ts +3 -2
  37. package/dist/components/NavigationItem/NavigationItem.d.ts +3 -2
  38. package/dist/components/Navigator/Navigator.d.ts +5 -4
  39. package/dist/components/Pagination/Pagination.d.ts +2 -2
  40. package/dist/components/ProfileMenu/ProfileMenu.d.ts +3 -3
  41. package/dist/components/Radio/Radio.d.ts +1 -0
  42. package/dist/components/RadioList/RadioList.d.ts +3 -2
  43. package/dist/components/Select/Select.d.ts +12 -10
  44. package/dist/components/Sheet/Sheet.d.ts +1 -0
  45. package/dist/components/Stack/Stack.d.ts +1 -0
  46. package/dist/components/Stepper/Stepper.d.ts +2 -1
  47. package/dist/components/Switch/Switch.d.ts +1 -0
  48. package/dist/components/Table/Table.d.ts +7 -5
  49. package/dist/components/Tabs/Tabs.d.ts +1 -0
  50. package/dist/components/Textarea/Textarea.d.ts +8 -20
  51. package/dist/components/ThemeProvider/ThemeProvider.d.ts +24 -2
  52. package/dist/components/Tooltip/Tooltip.d.ts +1 -0
  53. package/dist/components/Typography/Typography.d.ts +1 -0
  54. package/dist/components/Uploader/Uploader.d.ts +18 -17
  55. package/dist/components/data-display/Avatar.md +61 -73
  56. package/dist/components/data-display/Badge.md +198 -182
  57. package/dist/components/data-display/Chip.md +165 -143
  58. package/dist/components/data-display/DataTable.md +843 -338
  59. package/dist/components/data-display/InfoSign.md +1 -3
  60. package/dist/components/data-display/Markdown.md +93 -125
  61. package/dist/components/data-display/Table.md +1454 -1008
  62. package/dist/components/data-display/Tooltip.md +1 -1
  63. package/dist/components/data-display/Typography.md +101 -104
  64. package/dist/components/feedback/Alert.md +81 -87
  65. package/dist/components/feedback/CircularProgress.md +34 -38
  66. package/dist/components/feedback/Dialog.md +25 -17
  67. package/dist/components/feedback/Modal.md +297 -266
  68. package/dist/components/feedback/Skeleton.md +125 -89
  69. package/dist/components/index.d.ts +60 -1
  70. package/dist/components/inputs/Autocomplete.md +192 -96
  71. package/dist/components/inputs/Button.md +85 -85
  72. package/dist/components/inputs/ButtonGroup.md +197 -187
  73. package/dist/components/inputs/Calendar.md +25 -28
  74. package/dist/components/inputs/Checkbox.md +13 -31
  75. package/dist/components/inputs/CurrencyInput.md +6 -6
  76. package/dist/components/inputs/DatePicker.md +229 -110
  77. package/dist/components/inputs/DateRangePicker.md +248 -137
  78. package/dist/components/inputs/FilterMenu.md +138 -8
  79. package/dist/components/inputs/FilterableCheckboxGroup.md +116 -56
  80. package/dist/components/inputs/FormControl.md +76 -70
  81. package/dist/components/inputs/IconButton.md +231 -207
  82. package/dist/components/inputs/Input.md +133 -100
  83. package/dist/components/inputs/MonthPicker.md +186 -84
  84. package/dist/components/inputs/MonthRangePicker.md +73 -49
  85. package/dist/components/inputs/PercentageInput.md +17 -33
  86. package/dist/components/inputs/RadioButton.md +322 -258
  87. package/dist/components/inputs/RadioList.md +68 -52
  88. package/dist/components/inputs/RadioTileGroup.md +287 -170
  89. package/dist/components/inputs/SearchBar.md +82 -60
  90. package/dist/components/inputs/Select.md +108 -97
  91. package/dist/components/inputs/Slider.md +155 -104
  92. package/dist/components/inputs/Switch.md +194 -139
  93. package/dist/components/inputs/Textarea.md +17 -22
  94. package/dist/components/inputs/Uploader/Uploader.md +69 -40
  95. package/dist/components/layout/Box.md +841 -662
  96. package/dist/components/layout/Container.md +3 -11
  97. package/dist/components/layout/Grid.md +480 -394
  98. package/dist/components/layout/Stack.md +739 -566
  99. package/dist/components/navigation/Breadcrumbs.md +182 -116
  100. package/dist/components/navigation/Dropdown.md +732 -391
  101. package/dist/components/navigation/IconMenuButton.md +15 -7
  102. package/dist/components/navigation/InsetDrawer.md +550 -378
  103. package/dist/components/navigation/Link.md +104 -94
  104. package/dist/components/navigation/Menu.md +624 -503
  105. package/dist/components/navigation/MenuButton.md +19 -11
  106. package/dist/components/navigation/NavigationGroup.md +19 -50
  107. package/dist/components/navigation/NavigationItem.md +6 -6
  108. package/dist/components/navigation/Navigator.md +26 -28
  109. package/dist/components/navigation/Pagination.md +87 -76
  110. package/dist/components/navigation/ProfileMenu.md +67 -45
  111. package/dist/components/navigation/Stepper.md +2 -12
  112. package/dist/components/navigation/Tabs.md +210 -184
  113. package/dist/components/surfaces/Accordions.md +90 -173
  114. package/dist/components/surfaces/Card.md +1096 -711
  115. package/dist/components/surfaces/Divider.md +562 -412
  116. package/dist/components/surfaces/Sheet.md +700 -518
  117. package/dist/guides/ThemeProvider.md +65 -40
  118. package/dist/index.browser.js +5 -5
  119. package/dist/index.browser.js.map +4 -4
  120. package/dist/index.cjs +1906 -1690
  121. package/dist/index.d.ts +1 -1
  122. package/dist/index.js +1404 -1180
  123. package/framer/index.js +1 -1
  124. package/package.json +34 -36
@@ -8,10 +8,10 @@ Badge supports multiple colors, variants, and sizes for flexible visual customiz
8
8
 
9
9
  ```tsx
10
10
  <Badge {...args}>
11
- <IconButton>
12
- <NotificationsIcon />
13
- </IconButton>
14
- </Badge>
11
+ <IconButton>
12
+ <NotificationsIcon />
13
+ </IconButton>
14
+ </Badge>
15
15
  ```
16
16
 
17
17
  | Field | Description | Default |
@@ -46,28 +46,30 @@ function MyComponent() {
46
46
  Basic Badge usage showing numeric counts, max overflow, and text content.
47
47
 
48
48
  ```tsx
49
- <div style={{
50
- display: 'flex',
51
- gap: '2rem'
52
- }}>
53
- <Badge badgeContent={4}>
54
- <IconButton>
55
- <NotificationsIcon />
56
- </IconButton>
57
- </Badge>
58
-
59
- <Badge badgeContent={100} max={99}>
60
- <IconButton>
61
- <EmailIcon />
62
- </IconButton>
63
- </Badge>
64
-
65
- <Badge badgeContent="NEW">
66
- <IconButton>
67
- <NotificationsIcon />
68
- </IconButton>
69
- </Badge>
70
- </div>
49
+ <div
50
+ style={{
51
+ display: "flex",
52
+ gap: "2rem"
53
+ }}
54
+ >
55
+ <Badge badgeContent={4}>
56
+ <IconButton>
57
+ <NotificationsIcon />
58
+ </IconButton>
59
+ </Badge>
60
+
61
+ <Badge badgeContent={100} max={99}>
62
+ <IconButton>
63
+ <EmailIcon />
64
+ </IconButton>
65
+ </Badge>
66
+
67
+ <Badge badgeContent="NEW">
68
+ <IconButton>
69
+ <NotificationsIcon />
70
+ </IconButton>
71
+ </Badge>
72
+ </div>
71
73
  ```
72
74
 
73
75
  ## Colors
@@ -75,40 +77,42 @@ Basic Badge usage showing numeric counts, max overflow, and text content.
75
77
  Apply semantic colors to convey the badge's meaning: `primary` for general counts, `danger` for urgent notifications, `success` for online status, and `warning` for attention items.
76
78
 
77
79
  ```tsx
78
- <div style={{
79
- display: 'flex',
80
- gap: '2rem'
81
- }}>
82
- <Badge badgeContent={4} color="primary">
83
- <IconButton>
84
- <NotificationsIcon />
85
- </IconButton>
86
- </Badge>
87
-
88
- <Badge badgeContent={4} color="neutral">
89
- <IconButton>
90
- <NotificationsIcon />
91
- </IconButton>
92
- </Badge>
93
-
94
- <Badge badgeContent={4} color="danger">
95
- <IconButton>
96
- <NotificationsIcon />
97
- </IconButton>
98
- </Badge>
99
-
100
- <Badge badgeContent={4} color="success">
101
- <IconButton>
102
- <NotificationsIcon />
103
- </IconButton>
104
- </Badge>
105
-
106
- <Badge badgeContent={4} color="warning">
107
- <IconButton>
108
- <NotificationsIcon />
109
- </IconButton>
110
- </Badge>
111
- </div>
80
+ <div
81
+ style={{
82
+ display: "flex",
83
+ gap: "2rem"
84
+ }}
85
+ >
86
+ <Badge badgeContent={4} color="primary">
87
+ <IconButton>
88
+ <NotificationsIcon />
89
+ </IconButton>
90
+ </Badge>
91
+
92
+ <Badge badgeContent={4} color="neutral">
93
+ <IconButton>
94
+ <NotificationsIcon />
95
+ </IconButton>
96
+ </Badge>
97
+
98
+ <Badge badgeContent={4} color="danger">
99
+ <IconButton>
100
+ <NotificationsIcon />
101
+ </IconButton>
102
+ </Badge>
103
+
104
+ <Badge badgeContent={4} color="success">
105
+ <IconButton>
106
+ <NotificationsIcon />
107
+ </IconButton>
108
+ </Badge>
109
+
110
+ <Badge badgeContent={4} color="warning">
111
+ <IconButton>
112
+ <NotificationsIcon />
113
+ </IconButton>
114
+ </Badge>
115
+ </div>
112
116
  ```
113
117
 
114
118
  ## Variants
@@ -116,34 +120,36 @@ Apply semantic colors to convey the badge's meaning: `primary` for general count
116
120
  Four style variants are available: `solid` (filled), `soft` (subtle background), `outlined` (border only), and `plain` (minimal).
117
121
 
118
122
  ```tsx
119
- <div style={{
120
- display: 'flex',
121
- gap: '2rem'
122
- }}>
123
- <Badge badgeContent={4} variant="solid">
124
- <IconButton>
125
- <NotificationsIcon />
126
- </IconButton>
127
- </Badge>
128
-
129
- <Badge badgeContent={4} variant="soft">
130
- <IconButton>
131
- <NotificationsIcon />
132
- </IconButton>
133
- </Badge>
134
-
135
- <Badge badgeContent={4} variant="outlined">
136
- <IconButton>
137
- <NotificationsIcon />
138
- </IconButton>
139
- </Badge>
140
-
141
- <Badge badgeContent={4} variant="plain">
142
- <IconButton>
143
- <NotificationsIcon />
144
- </IconButton>
145
- </Badge>
146
- </div>
123
+ <div
124
+ style={{
125
+ display: "flex",
126
+ gap: "2rem"
127
+ }}
128
+ >
129
+ <Badge badgeContent={4} variant="solid">
130
+ <IconButton>
131
+ <NotificationsIcon />
132
+ </IconButton>
133
+ </Badge>
134
+
135
+ <Badge badgeContent={4} variant="soft">
136
+ <IconButton>
137
+ <NotificationsIcon />
138
+ </IconButton>
139
+ </Badge>
140
+
141
+ <Badge badgeContent={4} variant="outlined">
142
+ <IconButton>
143
+ <NotificationsIcon />
144
+ </IconButton>
145
+ </Badge>
146
+
147
+ <Badge badgeContent={4} variant="plain">
148
+ <IconButton>
149
+ <NotificationsIcon />
150
+ </IconButton>
151
+ </Badge>
152
+ </div>
147
153
  ```
148
154
 
149
155
  ## Sizes
@@ -151,29 +157,31 @@ Four style variants are available: `solid` (filled), `soft` (subtle background),
151
157
  Three sizes -- `sm`, `md`, and `lg` -- allow the badge to scale proportionally with its wrapped element.
152
158
 
153
159
  ```tsx
154
- <div style={{
155
- display: 'flex',
156
- gap: '2rem',
157
- alignItems: 'center'
158
- }}>
159
- <Badge badgeContent={4} size="sm">
160
- <IconButton size="sm">
161
- <NotificationsIcon />
162
- </IconButton>
163
- </Badge>
164
-
165
- <Badge badgeContent={4} size="md">
166
- <IconButton size="md">
167
- <NotificationsIcon />
168
- </IconButton>
169
- </Badge>
170
-
171
- <Badge badgeContent={4} size="lg">
172
- <IconButton size="lg">
173
- <NotificationsIcon />
174
- </IconButton>
175
- </Badge>
176
- </div>
160
+ <div
161
+ style={{
162
+ display: "flex",
163
+ gap: "2rem",
164
+ alignItems: "center"
165
+ }}
166
+ >
167
+ <Badge badgeContent={4} size="sm">
168
+ <IconButton size="sm">
169
+ <NotificationsIcon />
170
+ </IconButton>
171
+ </Badge>
172
+
173
+ <Badge badgeContent={4} size="md">
174
+ <IconButton size="md">
175
+ <NotificationsIcon />
176
+ </IconButton>
177
+ </Badge>
178
+
179
+ <Badge badgeContent={4} size="lg">
180
+ <IconButton size="lg">
181
+ <NotificationsIcon />
182
+ </IconButton>
183
+ </Badge>
184
+ </div>
177
185
  ```
178
186
 
179
187
  ## With Avatar
@@ -181,18 +189,20 @@ Three sizes -- `sm`, `md`, and `lg` -- allow the badge to scale proportionally w
181
189
  Badge pairs naturally with Avatar to indicate user status (e.g., notification count or online indicator).
182
190
 
183
191
  ```tsx
184
- <div style={{
185
- display: 'flex',
186
- gap: '2rem'
187
- }}>
188
- <Badge badgeContent={4} color="danger">
189
- <Avatar src="https://i.pravatar.cc/40?img=1" />
190
- </Badge>
191
-
192
- <Badge badgeContent="●" color="success">
193
- <Avatar src="https://i.pravatar.cc/40?img=2" />
194
- </Badge>
195
- </div>
192
+ <div
193
+ style={{
194
+ display: "flex",
195
+ gap: "2rem"
196
+ }}
197
+ >
198
+ <Badge badgeContent={4} color="danger">
199
+ <Avatar src="https://i.pravatar.cc/40?img=1" />
200
+ </Badge>
201
+
202
+ <Badge badgeContent="●" color="success">
203
+ <Avatar src="https://i.pravatar.cc/40?img=2" />
204
+ </Badge>
205
+ </div>
196
206
  ```
197
207
 
198
208
  ## Dot Badge
@@ -200,20 +210,22 @@ Badge pairs naturally with Avatar to indicate user status (e.g., notification co
200
210
  When no `badgeContent` is provided, Badge renders as a small dot. This is useful for simple presence or status indicators without a specific count.
201
211
 
202
212
  ```tsx
203
- <div style={{
204
- display: 'flex',
205
- gap: '2rem'
206
- }}>
207
- <Badge variant="solid" color="danger">
208
- <IconButton>
209
- <NotificationsIcon />
210
- </IconButton>
211
- </Badge>
212
-
213
- <Badge variant="solid" color="success">
214
- <Avatar src="https://i.pravatar.cc/40?img=3" />
215
- </Badge>
216
- </div>
213
+ <div
214
+ style={{
215
+ display: "flex",
216
+ gap: "2rem"
217
+ }}
218
+ >
219
+ <Badge variant="solid" color="danger">
220
+ <IconButton>
221
+ <NotificationsIcon />
222
+ </IconButton>
223
+ </Badge>
224
+
225
+ <Badge variant="solid" color="success">
226
+ <Avatar src="https://i.pravatar.cc/40?img=3" />
227
+ </Badge>
228
+ </div>
217
229
  ```
218
230
 
219
231
  ## Max Count
@@ -221,28 +233,30 @@ When no `badgeContent` is provided, Badge renders as a small dot. This is useful
221
233
  Use the `max` prop to cap the displayed number. When `badgeContent` exceeds `max`, it renders as "max+" (e.g., "99+").
222
234
 
223
235
  ```tsx
224
- <div style={{
225
- display: 'flex',
226
- gap: '2rem'
227
- }}>
228
- <Badge badgeContent={99}>
229
- <IconButton>
230
- <NotificationsIcon />
231
- </IconButton>
232
- </Badge>
233
-
234
- <Badge badgeContent={100} max={99}>
235
- <IconButton>
236
- <NotificationsIcon />
237
- </IconButton>
238
- </Badge>
239
-
240
- <Badge badgeContent={1000} max={999}>
241
- <IconButton>
242
- <NotificationsIcon />
243
- </IconButton>
244
- </Badge>
245
- </div>
236
+ <div
237
+ style={{
238
+ display: "flex",
239
+ gap: "2rem"
240
+ }}
241
+ >
242
+ <Badge badgeContent={99}>
243
+ <IconButton>
244
+ <NotificationsIcon />
245
+ </IconButton>
246
+ </Badge>
247
+
248
+ <Badge badgeContent={100} max={99}>
249
+ <IconButton>
250
+ <NotificationsIcon />
251
+ </IconButton>
252
+ </Badge>
253
+
254
+ <Badge badgeContent={1000} max={999}>
255
+ <IconButton>
256
+ <NotificationsIcon />
257
+ </IconButton>
258
+ </Badge>
259
+ </div>
246
260
  ```
247
261
 
248
262
  ## Show Zero
@@ -250,28 +264,30 @@ Use the `max` prop to cap the displayed number. When `badgeContent` exceeds `max
250
264
  By default, Badge hides when `badgeContent` is `0`. Use the `showZero` prop to force it to remain visible.
251
265
 
252
266
  ```tsx
253
- <div style={{
254
- display: 'flex',
255
- gap: '2rem'
256
- }}>
257
- <div>
258
- <p>Default (0 숨김)</p>
259
- <Badge badgeContent={0}>
260
- <IconButton>
261
- <NotificationsIcon />
262
- </IconButton>
263
- </Badge>
264
- </div>
265
-
266
- <div>
267
- <p>Show zero</p>
268
- <Badge badgeContent={0} showZero>
269
- <IconButton>
270
- <NotificationsIcon />
271
- </IconButton>
272
- </Badge>
273
- </div>
274
- </div>
267
+ <div
268
+ style={{
269
+ display: "flex",
270
+ gap: "2rem"
271
+ }}
272
+ >
273
+ <div>
274
+ <p>Default (0 숨김)</p>
275
+ <Badge badgeContent={0}>
276
+ <IconButton>
277
+ <NotificationsIcon />
278
+ </IconButton>
279
+ </Badge>
280
+ </div>
281
+
282
+ <div>
283
+ <p>Show zero</p>
284
+ <Badge badgeContent={0} showZero>
285
+ <IconButton>
286
+ <NotificationsIcon />
287
+ </IconButton>
288
+ </Badge>
289
+ </div>
290
+ </div>
275
291
  ```
276
292
 
277
293
  ## Badge Notification Bell
@@ -346,7 +362,7 @@ function FeatureButton() {
346
362
  | `badgeContent` | `ReactNode` | - | Content displayed inside the badge (number, text). Omit for dot badge |
347
363
  | `children` | `ReactNode` | - | The element the badge is attached to |
348
364
  | `color` | `'primary' \| 'neutral' \| 'danger' \| 'success' \| 'warning'` | `'danger'` | Badge color |
349
- | `size` | `'sm' \| 'md' \| 'lg'` | `'md'` | Badge size |
365
+ | `size` | `'sm' \| 'md' \| 'lg'` | `'sm'` | Badge size |
350
366
  | `variant` | `'solid' \| 'soft' \| 'outlined' \| 'plain'` | `'solid'` | Visual style |
351
367
  | `max` | `number` | `99` | Maximum value before showing "N+" |
352
368
  | `invisible` | `boolean` | `false` | Hides the badge |