banhaten 0.5.0 → 0.6.0

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 (290) hide show
  1. package/CHANGELOG.md +177 -139
  2. package/CONTRIBUTING.md +46 -46
  3. package/README.md +192 -192
  4. package/SECURITY.md +15 -15
  5. package/banhaten.config.example.json +11 -11
  6. package/docs/design-spacing.md +13 -13
  7. package/docs/design-system/README.md +22 -22
  8. package/docs/design-system/adoption-quality-remediation.md +87 -87
  9. package/docs/design-system/agent-usage.md +13 -13
  10. package/docs/design-system/appearance-presets.md +189 -189
  11. package/docs/design-system/appearances/default.md +94 -94
  12. package/docs/design-system/appearances/rounded.md +95 -95
  13. package/docs/design-system/appearances/sharp.md +95 -95
  14. package/docs/design-system/component-docs-pattern.md +81 -81
  15. package/docs/design-system/component-implementation-ownership-audit.md +245 -245
  16. package/docs/design-system/component-quality-audit-2026-08-20.md +225 -225
  17. package/docs/design-system/component-showcase-consistency-report.md +219 -219
  18. package/docs/design-system/component-token-consistency-audit.md +173 -173
  19. package/docs/design-system/components/README.md +91 -90
  20. package/docs/design-system/components/accordion.md +52 -52
  21. package/docs/design-system/components/activity-feed.md +93 -93
  22. package/docs/design-system/components/activity-heatmap.md +56 -56
  23. package/docs/design-system/components/alert-dialog.md +71 -71
  24. package/docs/design-system/components/alert.md +103 -97
  25. package/docs/design-system/components/app-header.md +97 -0
  26. package/docs/design-system/components/aspect-ratio.md +45 -45
  27. package/docs/design-system/components/attribute.md +101 -89
  28. package/docs/design-system/components/autocomplete.md +75 -75
  29. package/docs/design-system/components/avatar.md +53 -53
  30. package/docs/design-system/components/badge.md +55 -55
  31. package/docs/design-system/components/banner.md +86 -86
  32. package/docs/design-system/components/breadcrumbs.md +181 -177
  33. package/docs/design-system/components/button-group.md +97 -97
  34. package/docs/design-system/components/button.md +80 -80
  35. package/docs/design-system/components/card.md +102 -88
  36. package/docs/design-system/components/carousel.md +46 -46
  37. package/docs/design-system/components/catalog-components.md +46 -46
  38. package/docs/design-system/components/checkbox.md +53 -53
  39. package/docs/design-system/components/collapsible.md +63 -63
  40. package/docs/design-system/components/command.md +61 -61
  41. package/docs/design-system/components/context-menu.md +45 -45
  42. package/docs/design-system/components/date-picker.md +80 -80
  43. package/docs/design-system/components/divider.md +102 -102
  44. package/docs/design-system/components/empty-state.md +56 -56
  45. package/docs/design-system/components/field.md +70 -70
  46. package/docs/design-system/components/file-upload.md +186 -186
  47. package/docs/design-system/components/hover-card.md +47 -47
  48. package/docs/design-system/components/icons.md +48 -48
  49. package/docs/design-system/components/input-group.md +57 -57
  50. package/docs/design-system/components/input-otp.md +56 -56
  51. package/docs/design-system/components/input.md +111 -109
  52. package/docs/design-system/components/item.md +58 -58
  53. package/docs/design-system/components/kbd.md +49 -49
  54. package/docs/design-system/components/label.md +49 -49
  55. package/docs/design-system/components/menu.md +94 -73
  56. package/docs/design-system/components/menubar.md +46 -46
  57. package/docs/design-system/components/modal.md +104 -104
  58. package/docs/design-system/components/native-select.md +53 -53
  59. package/docs/design-system/components/navigation-menu.md +49 -49
  60. package/docs/design-system/components/onboarding-step-list-item.md +81 -81
  61. package/docs/design-system/components/page-header.md +127 -93
  62. package/docs/design-system/components/pagination.md +56 -56
  63. package/docs/design-system/components/popover.md +59 -59
  64. package/docs/design-system/components/progress-slider.md +49 -49
  65. package/docs/design-system/components/progress.md +76 -76
  66. package/docs/design-system/components/radio-card.md +50 -50
  67. package/docs/design-system/components/radio-group.md +56 -56
  68. package/docs/design-system/components/resizable.md +43 -43
  69. package/docs/design-system/components/scroll-area.md +50 -50
  70. package/docs/design-system/components/segmented-control.md +54 -54
  71. package/docs/design-system/components/select.md +68 -64
  72. package/docs/design-system/components/sheet.md +66 -66
  73. package/docs/design-system/components/sidebar.md +167 -111
  74. package/docs/design-system/components/skeleton.md +74 -74
  75. package/docs/design-system/components/slideout.md +64 -64
  76. package/docs/design-system/components/slider.md +62 -62
  77. package/docs/design-system/components/social-button.md +49 -49
  78. package/docs/design-system/components/spinner.md +62 -62
  79. package/docs/design-system/components/steps.md +65 -65
  80. package/docs/design-system/components/table.md +499 -422
  81. package/docs/design-system/components/tabs.md +74 -59
  82. package/docs/design-system/components/tag.md +79 -79
  83. package/docs/design-system/components/textarea.md +49 -49
  84. package/docs/design-system/components/timeline.md +82 -82
  85. package/docs/design-system/components/toast.md +57 -57
  86. package/docs/design-system/components/toggle.md +80 -80
  87. package/docs/design-system/components/toolbar.md +89 -89
  88. package/docs/design-system/components/tooltip.md +92 -92
  89. package/docs/design-system/components/typography.md +18 -18
  90. package/docs/design-system/density-and-elevation.md +65 -65
  91. package/docs/design-system/design-system-test-missing-items.md +368 -368
  92. package/docs/design-system/direction-and-localization.md +23 -23
  93. package/docs/design-system/form-recipes.md +73 -73
  94. package/docs/design-system/gap-promotion-policy.md +21 -21
  95. package/docs/design-system/icons.md +74 -74
  96. package/docs/design-system/installation.md +70 -70
  97. package/docs/design-system/launch-comparison-shadcn.md +98 -98
  98. package/docs/design-system/registry-and-cli.md +64 -64
  99. package/docs/design-system/release-policy.md +30 -30
  100. package/docs/design-system/roadmap.md +14 -14
  101. package/docs/design-system/support-matrix.md +23 -23
  102. package/docs/design-system/tabs.md +54 -54
  103. package/docs/design-system/template-gap-audit.md +32 -32
  104. package/docs/design-system/templates.md +59 -59
  105. package/docs/design-system/token-governance.md +72 -72
  106. package/package.json +98 -98
  107. package/registry/component-contract.json +40 -40
  108. package/registry/components/accordion.tsx +155 -155
  109. package/registry/components/alert-dialog.tsx +297 -297
  110. package/registry/components/alert.tsx +309 -293
  111. package/registry/components/app-header.tsx +151 -0
  112. package/registry/components/aspect-ratio.tsx +30 -30
  113. package/registry/components/attribute.tsx +489 -454
  114. package/registry/components/autocomplete.tsx +598 -598
  115. package/registry/components/avatar.tsx +385 -385
  116. package/registry/components/badge.tsx +630 -629
  117. package/registry/components/button-group.tsx +565 -565
  118. package/registry/components/button.tsx +128 -127
  119. package/registry/components/card.tsx +651 -638
  120. package/registry/components/carousel.tsx +296 -296
  121. package/registry/components/chart.tsx +203 -203
  122. package/registry/components/checkbox.tsx +247 -247
  123. package/registry/components/collapsible.tsx +109 -109
  124. package/registry/components/command.tsx +208 -208
  125. package/registry/components/context-menu.tsx +236 -236
  126. package/registry/components/date-picker.tsx +1289 -1289
  127. package/registry/components/expanded/ActivityFeed.tsx +227 -227
  128. package/registry/components/expanded/ActivityHeatmap.tsx +64 -64
  129. package/registry/components/expanded/Banner.tsx +179 -179
  130. package/registry/components/expanded/Breadcrumbs.tsx +135 -131
  131. package/registry/components/expanded/CatalogComponentsShowcase.tsx +205 -205
  132. package/registry/components/expanded/CatalogDivider.tsx +49 -49
  133. package/registry/components/expanded/EmptyState.tsx +155 -155
  134. package/registry/components/expanded/FileUpload.tsx +543 -543
  135. package/registry/components/expanded/OnboardingStepListItem.tsx +60 -60
  136. package/registry/components/expanded/PageHeader.tsx +209 -179
  137. package/registry/components/expanded/Slideout.tsx +108 -108
  138. package/registry/components/expanded/Steps.tsx +402 -402
  139. package/registry/components/expanded/Table.tsx +1109 -1092
  140. package/registry/components/expanded/Timeline.tsx +203 -203
  141. package/registry/components/expanded/activityFeed.css +248 -248
  142. package/registry/components/expanded/activityHeatmap.css +66 -66
  143. package/registry/components/expanded/banner.css +260 -260
  144. package/registry/components/expanded/breadcrumbs.css +157 -140
  145. package/registry/components/expanded/catalogComponentsShowcase.css +87 -87
  146. package/registry/components/expanded/divider.css +75 -75
  147. package/registry/components/expanded/emptyState.css +111 -111
  148. package/registry/components/expanded/fileUpload.css +457 -457
  149. package/registry/components/expanded/onboardingStepListItem.css +135 -135
  150. package/registry/components/expanded/pageHeader.css +284 -248
  151. package/registry/components/expanded/slideout.css +276 -276
  152. package/registry/components/expanded/steps.css +356 -356
  153. package/registry/components/expanded/table.css +655 -606
  154. package/registry/components/expanded/timeline.css +286 -286
  155. package/registry/components/field.tsx +283 -283
  156. package/registry/components/hover-card.tsx +48 -48
  157. package/registry/components/input-content.ts +107 -107
  158. package/registry/components/input-group.tsx +130 -130
  159. package/registry/components/input-otp.tsx +584 -584
  160. package/registry/components/input.tsx +992 -990
  161. package/registry/components/item.tsx +189 -189
  162. package/registry/components/kbd.tsx +246 -246
  163. package/registry/components/label.tsx +78 -78
  164. package/registry/components/menu.tsx +1091 -978
  165. package/registry/components/menubar.tsx +226 -226
  166. package/registry/components/modal.tsx +872 -872
  167. package/registry/components/native-select.tsx +205 -205
  168. package/registry/components/navigation-menu.tsx +171 -171
  169. package/registry/components/pagination.css +36 -36
  170. package/registry/components/pagination.tsx +560 -560
  171. package/registry/components/popover.tsx +338 -338
  172. package/registry/components/progress-slider.tsx +216 -216
  173. package/registry/components/radio-card.tsx +676 -676
  174. package/registry/components/radio-group.tsx +570 -570
  175. package/registry/components/resizable.tsx +108 -108
  176. package/registry/components/scroll-area.tsx +91 -91
  177. package/registry/components/segmented-control.tsx +87 -87
  178. package/registry/components/select-content.tsx +218 -218
  179. package/registry/components/select.tsx +937 -937
  180. package/registry/components/sheet.tsx +305 -305
  181. package/registry/components/sidebar.tsx +1535 -1433
  182. package/registry/components/skeleton.css +54 -54
  183. package/registry/components/skeleton.tsx +482 -482
  184. package/registry/components/slider.tsx +380 -380
  185. package/registry/components/social-button.tsx +387 -387
  186. package/registry/components/spinner.tsx +78 -78
  187. package/registry/components/table-elements.tsx +287 -128
  188. package/registry/components/tabs.css +246 -222
  189. package/registry/components/tabs.tsx +245 -241
  190. package/registry/components/tag.tsx +423 -423
  191. package/registry/components/textarea.tsx +610 -610
  192. package/registry/components/toast.tsx +136 -136
  193. package/registry/components/toggle.tsx +256 -256
  194. package/registry/components/toolbar.tsx +539 -539
  195. package/registry/components/tooltip.tsx +433 -433
  196. package/registry/examples/alert-demo.tsx +34 -34
  197. package/registry/examples/alert-dialog-demo.tsx +42 -42
  198. package/registry/examples/app-header-demo.tsx +40 -0
  199. package/registry/examples/aspect-ratio-demo.tsx +11 -11
  200. package/registry/examples/attribute-demo.tsx +65 -65
  201. package/registry/examples/autocomplete-demo.tsx +109 -109
  202. package/registry/examples/avatar-demo.tsx +132 -132
  203. package/registry/examples/badge-demo.tsx +69 -69
  204. package/registry/examples/button-demo.tsx +86 -86
  205. package/registry/examples/button-group-demo.tsx +63 -63
  206. package/registry/examples/card-demo.tsx +86 -86
  207. package/registry/examples/carousel-demo.tsx +43 -43
  208. package/registry/examples/chart-demo.tsx +18 -18
  209. package/registry/examples/checkbox-demo.tsx +62 -62
  210. package/registry/examples/collapsible-demo.tsx +16 -16
  211. package/registry/examples/collection-filter-bar-demo.tsx +135 -135
  212. package/registry/examples/command-demo.tsx +42 -42
  213. package/registry/examples/command-palette-demo.tsx +235 -235
  214. package/registry/examples/context-menu-demo.tsx +29 -29
  215. package/registry/examples/control-density-contract-demo.tsx +65 -65
  216. package/registry/examples/date-picker-demo.tsx +127 -127
  217. package/registry/examples/divider-demo.tsx +17 -17
  218. package/registry/examples/expanded/activity-heatmap-demo.tsx +29 -29
  219. package/registry/examples/expanded/banner-demo.tsx +48 -48
  220. package/registry/examples/expanded/breadcrumbs-demo.tsx +59 -59
  221. package/registry/examples/expanded/empty-state-demo.tsx +39 -39
  222. package/registry/examples/expanded/file-upload-demo.tsx +60 -60
  223. package/registry/examples/expanded/onboarding-step-demo.tsx +11 -11
  224. package/registry/examples/expanded/slideout-demo.tsx +15 -15
  225. package/registry/examples/expanded/steps-demo.tsx +29 -29
  226. package/registry/examples/expanded/tabs-demo.tsx +13 -13
  227. package/registry/examples/expanded/timeline-demo.tsx +18 -18
  228. package/registry/examples/field-demo.tsx +51 -51
  229. package/registry/examples/hover-card-demo.tsx +23 -23
  230. package/registry/examples/input-actions-demo.tsx +36 -36
  231. package/registry/examples/input-demo.tsx +87 -87
  232. package/registry/examples/input-group-demo.tsx +16 -16
  233. package/registry/examples/input-otp-demo.tsx +72 -72
  234. package/registry/examples/item-demo.tsx +46 -46
  235. package/registry/examples/kbd-demo.tsx +12 -12
  236. package/registry/examples/label-demo.tsx +20 -20
  237. package/registry/examples/menu-demo.tsx +122 -122
  238. package/registry/examples/menubar-demo.tsx +34 -34
  239. package/registry/examples/modal-demo.tsx +74 -74
  240. package/registry/examples/native-select-demo.tsx +16 -16
  241. package/registry/examples/navigation-menu-demo.tsx +29 -29
  242. package/registry/examples/pagination-demo.tsx +20 -20
  243. package/registry/examples/popover-demo.tsx +547 -547
  244. package/registry/examples/progress-demo.tsx +37 -37
  245. package/registry/examples/progress-slider-demo.tsx +29 -29
  246. package/registry/examples/radio-card-demo.tsx +51 -51
  247. package/registry/examples/radio-group-demo.tsx +62 -62
  248. package/registry/examples/resizable-demo.tsx +22 -22
  249. package/registry/examples/results-toolbar-demo.tsx +44 -44
  250. package/registry/examples/scroll-area-demo.tsx +15 -15
  251. package/registry/examples/segmented-control-demo.tsx +39 -39
  252. package/registry/examples/select-demo.tsx +87 -87
  253. package/registry/examples/sheet-demo.tsx +47 -47
  254. package/registry/examples/sidebar-demo.tsx +101 -101
  255. package/registry/examples/slider-demo.tsx +31 -31
  256. package/registry/examples/social-button-demo.tsx +61 -61
  257. package/registry/examples/spinner-demo.tsx +59 -59
  258. package/registry/examples/tabs-demo.tsx +13 -13
  259. package/registry/examples/tag-demo.tsx +29 -29
  260. package/registry/examples/textarea-demo.tsx +79 -79
  261. package/registry/examples/toast-demo.tsx +35 -35
  262. package/registry/examples/toggle-demo.tsx +59 -59
  263. package/registry/examples/tooltip-demo.tsx +115 -115
  264. package/registry/guidance/USAGE.md +27 -27
  265. package/registry/hooks/use-direction.ts +207 -207
  266. package/registry/index.json +387 -17
  267. package/registry/styles/globals.css +46 -0
  268. package/registry.json +24 -2
  269. package/schema/config.schema.json +51 -51
  270. package/schema/registry.schema.json +194 -194
  271. package/schema/tokens.schema.json +167 -167
  272. package/src/cli/command-line.js +194 -194
  273. package/src/cli/config-editors.js +9 -9
  274. package/src/cli/doctor.js +399 -399
  275. package/src/cli/file-transaction.js +302 -302
  276. package/src/cli/global-css.js +153 -153
  277. package/src/cli/index.js +1002 -1002
  278. package/src/cli/install-plan.js +592 -592
  279. package/src/cli/install-receipt.js +171 -171
  280. package/src/cli/jsonc.js +203 -203
  281. package/src/cli/package-install-state.js +254 -254
  282. package/src/cli/package-manager.js +238 -238
  283. package/src/cli/package-plan.js +185 -185
  284. package/src/cli/package-version.js +97 -97
  285. package/src/cli/registry-query.js +207 -207
  286. package/src/cli/reporting.js +55 -55
  287. package/src/cli/schema-validation.js +19 -19
  288. package/src/cli/source-scanner.js +686 -686
  289. package/src/cli/vite-config.js +478 -478
  290. package/tokens/banhaten.tokens.json +184 -0
@@ -1,402 +1,402 @@
1
- import type { ReactNode } from "react";
2
- import { CheckIcon } from "lucide-react";
3
- import "./steps.css";
4
-
5
- export type StepIndicator = "icon" | "number";
6
- export type StepDirection = "horizontal" | "vertical";
7
- export type StepAlignment = "leading" | "middle" | "trailing";
8
- export type StepPosition = "top" | "bottom";
9
-
10
- export type StepItem = {
11
- actions?: ReactNode;
12
- caption?: ReactNode;
13
- label?: ReactNode;
14
- number?: ReactNode;
15
- slotContent?: ReactNode;
16
- supportText?: ReactNode;
17
- };
18
-
19
- export type StepsProps = {
20
- alignment?: Exclude<StepAlignment, "middle">;
21
- className?: string;
22
- dir?: "ltr" | "rtl";
23
- direction?: StepDirection;
24
- indicator?: StepIndicator;
25
- items?: StepItem[];
26
- };
27
-
28
- export type ProgressStepState = "complete" | "active" | "todo";
29
-
30
- export type ProgressStep = {
31
- label?: ReactNode;
32
- marker?: ReactNode;
33
- state?: ProgressStepState;
34
- };
35
-
36
- export type ProgressStepsClassNames = {
37
- connector?: string;
38
- item?: string;
39
- label?: string;
40
- marker?: string;
41
- segment?: string;
42
- track?: string;
43
- };
44
-
45
- export type ProgressStepsProps = {
46
- activeIndex?: number;
47
- ariaLabel: string;
48
- className?: string;
49
- classNames?: ProgressStepsClassNames;
50
- dir?: "ltr" | "rtl";
51
- items: ProgressStep[];
52
- label?: ReactNode;
53
- variant?: "bars" | "markers";
54
- };
55
-
56
- export type HorizontalStepItemProps = {
57
- alignment?: StepAlignment;
58
- caption?: ReactNode;
59
- className?: string;
60
- hasCaption?: boolean;
61
- indicator?: StepIndicator;
62
- label?: ReactNode;
63
- number?: ReactNode;
64
- position?: StepPosition;
65
- dir?: "ltr" | "rtl";
66
- showLeadingLine?: boolean;
67
- showTrailingLine?: boolean;
68
- };
69
-
70
- export type VerticalStepItemProps = {
71
- actions?: ReactNode;
72
- alignment?: Exclude<StepAlignment, "middle">;
73
- caption?: ReactNode;
74
- className?: string;
75
- hasActionButtons?: boolean;
76
- hasCaption?: boolean;
77
- hasSlotContent?: boolean;
78
- hasSupportText?: boolean;
79
- indicator?: StepIndicator;
80
- label?: ReactNode;
81
- number?: ReactNode;
82
- dir?: "ltr" | "rtl";
83
- showBottomPadding?: boolean;
84
- showLine?: boolean;
85
- slotContent?: ReactNode;
86
- supportText?: ReactNode;
87
- };
88
-
89
- export function Steps({
90
- alignment = "leading",
91
- className = "",
92
- dir,
93
- direction = "horizontal",
94
- indicator = "icon",
95
- items,
96
- }: StepsProps) {
97
- const stepItems = items ?? [];
98
-
99
- if (direction === "vertical") {
100
- return (
101
- <div
102
- className={["ds-steps", "ds-steps--vertical", className]
103
- .filter(Boolean)
104
- .join(" ")}
105
- dir={dir}
106
- >
107
- {stepItems.map((item, index) => (
108
- <VerticalStepItem
109
- alignment={alignment}
110
- caption={item.caption}
111
- hasActionButtons={Boolean(item.actions)}
112
- hasSlotContent={Boolean(item.slotContent)}
113
- indicator={indicator}
114
- key={index}
115
- label={item.label}
116
- number={item.number ?? index + 1}
117
- dir={dir}
118
- showBottomPadding={index < stepItems.length - 1}
119
- showLine={index < stepItems.length - 1}
120
- slotContent={item.slotContent}
121
- supportText={item.supportText}
122
- >
123
- {item.actions}
124
- </VerticalStepItem>
125
- ))}
126
- </div>
127
- );
128
- }
129
-
130
- return (
131
- <div
132
- className={["ds-steps", "ds-steps--horizontal", className]
133
- .filter(Boolean)
134
- .join(" ")}
135
- dir={dir}
136
- >
137
- {stepItems.map((item, index) => (
138
- <HorizontalStepItem
139
- caption={item.caption}
140
- hasCaption={item.caption !== null && item.caption !== undefined}
141
- indicator={indicator}
142
- key={index}
143
- label={item.label}
144
- number={item.number ?? index + 1}
145
- dir={dir}
146
- />
147
- ))}
148
- </div>
149
- );
150
- }
151
-
152
- export function ProgressSteps({
153
- activeIndex = 0,
154
- ariaLabel,
155
- className = "",
156
- classNames = {},
157
- dir,
158
- items,
159
- label,
160
- variant = "markers",
161
- }: ProgressStepsProps) {
162
- const rootClassName = [
163
- "ds-progress-steps",
164
- `ds-progress-steps--${variant}`,
165
- className,
166
- ]
167
- .filter(Boolean)
168
- .join(" ");
169
-
170
- if (variant === "bars") {
171
- return (
172
- <div
173
- aria-label={ariaLabel}
174
- aria-valuemax={items.length}
175
- aria-valuemin={1}
176
- aria-valuenow={Math.min(activeIndex + 1, items.length)}
177
- className={rootClassName}
178
- dir={dir}
179
- role="progressbar"
180
- >
181
- {label ? <span data-slot="progress-steps-label">{label}</span> : null}
182
- <div
183
- aria-hidden="true"
184
- className={["ds-progress-steps__track", classNames.track]
185
- .filter(Boolean)
186
- .join(" ")}
187
- data-slot="progress-steps-track"
188
- >
189
- {items.map((item, index) => (
190
- <span
191
- className={["ds-progress-steps__segment", classNames.segment]
192
- .filter(Boolean)
193
- .join(" ")}
194
- data-active={index <= activeIndex ? "true" : "false"}
195
- data-slot="progress-steps-segment"
196
- data-state={item.state ?? (index < activeIndex ? "complete" : index === activeIndex ? "active" : "todo")}
197
- key={index}
198
- />
199
- ))}
200
- </div>
201
- </div>
202
- );
203
- }
204
-
205
- return (
206
- <ol aria-label={ariaLabel} className={rootClassName} dir={dir}>
207
- {items.map((item, index) => {
208
- const state =
209
- item.state ??
210
- (index < activeIndex
211
- ? "complete"
212
- : index === activeIndex
213
- ? "active"
214
- : "todo");
215
-
216
- return (
217
- <li
218
- className={[
219
- "ds-progress-steps__item",
220
- `is-${state}`,
221
- classNames.item,
222
- ]
223
- .filter(Boolean)
224
- .join(" ")}
225
- data-slot="progress-steps-item"
226
- data-state={state}
227
- key={index}
228
- >
229
- <span
230
- aria-hidden="true"
231
- className={["ds-progress-steps__marker", classNames.marker]
232
- .filter(Boolean)
233
- .join(" ")}
234
- data-slot="progress-steps-marker"
235
- >
236
- {item.marker ?? index + 1}
237
- </span>
238
- {item.label ? (
239
- <span
240
- className={["ds-progress-steps__label", classNames.label]
241
- .filter(Boolean)
242
- .join(" ")}
243
- data-slot="progress-steps-item-label"
244
- >
245
- {item.label}
246
- </span>
247
- ) : null}
248
- {index < items.length - 1 ? (
249
- <span
250
- aria-hidden="true"
251
- className={[
252
- "ds-progress-steps__connector",
253
- state === "complete" && "is-complete",
254
- classNames.connector,
255
- ]
256
- .filter(Boolean)
257
- .join(" ")}
258
- data-slot="progress-steps-connector"
259
- />
260
- ) : null}
261
- </li>
262
- );
263
- })}
264
- </ol>
265
- );
266
- }
267
-
268
- export function HorizontalStepItem({
269
- alignment = "leading",
270
- caption,
271
- className = "",
272
- hasCaption = true,
273
- indicator = "icon",
274
- label,
275
- number = 1,
276
- position = "top",
277
- dir,
278
- showLeadingLine = true,
279
- showTrailingLine = true,
280
- }: HorizontalStepItemProps) {
281
- const linePlacement = getHorizontalLinePlacement(alignment, showLeadingLine, showTrailingLine);
282
- const text = (
283
- <div className="ds-horizontal-step-item__text">
284
- {label && <div className="ds-horizontal-step-item__label">{label}</div>}
285
- {hasCaption && caption && <div className="ds-horizontal-step-item__caption">{caption}</div>}
286
- </div>
287
- );
288
- const track = (
289
- <div className="ds-horizontal-step-item__track" aria-hidden="true">
290
- {linePlacement.before && <span className="ds-step-line ds-step-line--horizontal" />}
291
- <StepMarker indicator={indicator} number={number} />
292
- {linePlacement.after && <span className="ds-step-line ds-step-line--horizontal" />}
293
- </div>
294
- );
295
-
296
- return (
297
- <div
298
- className={[
299
- "ds-horizontal-step-item",
300
- `ds-horizontal-step-item--${alignment}`,
301
- `ds-horizontal-step-item--${position}`,
302
- className,
303
- ]
304
- .filter(Boolean)
305
- .join(" ")}
306
- dir={dir}
307
- >
308
- {position === "bottom" ? text : track}
309
- {position === "bottom" ? track : text}
310
- </div>
311
- );
312
- }
313
-
314
- export function VerticalStepItem({
315
- actions,
316
- alignment = "leading",
317
- caption,
318
- children,
319
- className = "",
320
- hasActionButtons = true,
321
- hasCaption = true,
322
- hasSlotContent = true,
323
- hasSupportText = true,
324
- indicator = "icon",
325
- label,
326
- number = 1,
327
- dir,
328
- showBottomPadding = true,
329
- showLine = true,
330
- slotContent,
331
- supportText,
332
- }: VerticalStepItemProps & { children?: ReactNode }) {
333
- const marker = (
334
- <div className="ds-vertical-step-item__rail" aria-hidden="true">
335
- <StepMarker indicator={indicator} number={number} />
336
- {showLine && <span className="ds-step-line ds-step-line--vertical" />}
337
- </div>
338
- );
339
- const markerFirst = alignment === "leading";
340
- const renderedActions = actions ?? children;
341
- const renderedSlot = slotContent;
342
-
343
- return (
344
- <div
345
- className={[
346
- "ds-vertical-step-item",
347
- `ds-vertical-step-item--${alignment}`,
348
- className,
349
- ]
350
- .filter(Boolean)
351
- .join(" ")}
352
- dir={dir}
353
- >
354
- {markerFirst && marker}
355
- <div className="ds-vertical-step-item__content">
356
- <div className="ds-vertical-step-item__copy">
357
- <div className="ds-vertical-step-item__header">
358
- {label && <div className="ds-vertical-step-item__label">{label}</div>}
359
- {hasSupportText && supportText && <div className="ds-vertical-step-item__support">{supportText}</div>}
360
- </div>
361
- {hasCaption && caption && <div className="ds-vertical-step-item__caption">{caption}</div>}
362
- </div>
363
- {hasSlotContent && renderedSlot}
364
- {hasActionButtons && renderedActions && <div className="ds-vertical-step-item__actions">{renderedActions}</div>}
365
- {showBottomPadding && <div className="ds-vertical-step-item__bottom-padding" />}
366
- </div>
367
- {!markerFirst && marker}
368
- </div>
369
- );
370
- }
371
-
372
- function StepMarker({ indicator, number }: { indicator: StepIndicator; number: ReactNode }) {
373
- if (indicator === "number") {
374
- return (
375
- <span className="ds-step-marker ds-step-marker--number">
376
- <span>{number}</span>
377
- </span>
378
- );
379
- }
380
-
381
- return (
382
- <span className="ds-step-marker ds-step-marker--icon">
383
- <CheckIcon aria-hidden="true" focusable="false" strokeWidth="var(--bh-icon-stroke-300)" />
384
- </span>
385
- );
386
- }
387
-
388
- function getHorizontalLinePlacement(
389
- alignment: StepAlignment,
390
- showLeadingLine: boolean,
391
- showTrailingLine: boolean,
392
- ) {
393
- if (alignment === "middle") {
394
- return { before: showLeadingLine, after: showTrailingLine };
395
- }
396
-
397
- if (alignment === "leading") {
398
- return { before: false, after: showTrailingLine };
399
- }
400
-
401
- return { before: showLeadingLine, after: false };
402
- }
1
+ import type { ReactNode } from "react";
2
+ import { CheckIcon } from "lucide-react";
3
+ import "./steps.css";
4
+
5
+ export type StepIndicator = "icon" | "number";
6
+ export type StepDirection = "horizontal" | "vertical";
7
+ export type StepAlignment = "leading" | "middle" | "trailing";
8
+ export type StepPosition = "top" | "bottom";
9
+
10
+ export type StepItem = {
11
+ actions?: ReactNode;
12
+ caption?: ReactNode;
13
+ label?: ReactNode;
14
+ number?: ReactNode;
15
+ slotContent?: ReactNode;
16
+ supportText?: ReactNode;
17
+ };
18
+
19
+ export type StepsProps = {
20
+ alignment?: Exclude<StepAlignment, "middle">;
21
+ className?: string;
22
+ dir?: "ltr" | "rtl";
23
+ direction?: StepDirection;
24
+ indicator?: StepIndicator;
25
+ items?: StepItem[];
26
+ };
27
+
28
+ export type ProgressStepState = "complete" | "active" | "todo";
29
+
30
+ export type ProgressStep = {
31
+ label?: ReactNode;
32
+ marker?: ReactNode;
33
+ state?: ProgressStepState;
34
+ };
35
+
36
+ export type ProgressStepsClassNames = {
37
+ connector?: string;
38
+ item?: string;
39
+ label?: string;
40
+ marker?: string;
41
+ segment?: string;
42
+ track?: string;
43
+ };
44
+
45
+ export type ProgressStepsProps = {
46
+ activeIndex?: number;
47
+ ariaLabel: string;
48
+ className?: string;
49
+ classNames?: ProgressStepsClassNames;
50
+ dir?: "ltr" | "rtl";
51
+ items: ProgressStep[];
52
+ label?: ReactNode;
53
+ variant?: "bars" | "markers";
54
+ };
55
+
56
+ export type HorizontalStepItemProps = {
57
+ alignment?: StepAlignment;
58
+ caption?: ReactNode;
59
+ className?: string;
60
+ hasCaption?: boolean;
61
+ indicator?: StepIndicator;
62
+ label?: ReactNode;
63
+ number?: ReactNode;
64
+ position?: StepPosition;
65
+ dir?: "ltr" | "rtl";
66
+ showLeadingLine?: boolean;
67
+ showTrailingLine?: boolean;
68
+ };
69
+
70
+ export type VerticalStepItemProps = {
71
+ actions?: ReactNode;
72
+ alignment?: Exclude<StepAlignment, "middle">;
73
+ caption?: ReactNode;
74
+ className?: string;
75
+ hasActionButtons?: boolean;
76
+ hasCaption?: boolean;
77
+ hasSlotContent?: boolean;
78
+ hasSupportText?: boolean;
79
+ indicator?: StepIndicator;
80
+ label?: ReactNode;
81
+ number?: ReactNode;
82
+ dir?: "ltr" | "rtl";
83
+ showBottomPadding?: boolean;
84
+ showLine?: boolean;
85
+ slotContent?: ReactNode;
86
+ supportText?: ReactNode;
87
+ };
88
+
89
+ export function Steps({
90
+ alignment = "leading",
91
+ className = "",
92
+ dir,
93
+ direction = "horizontal",
94
+ indicator = "icon",
95
+ items,
96
+ }: StepsProps) {
97
+ const stepItems = items ?? [];
98
+
99
+ if (direction === "vertical") {
100
+ return (
101
+ <div
102
+ className={["ds-steps", "ds-steps--vertical", className]
103
+ .filter(Boolean)
104
+ .join(" ")}
105
+ dir={dir}
106
+ >
107
+ {stepItems.map((item, index) => (
108
+ <VerticalStepItem
109
+ alignment={alignment}
110
+ caption={item.caption}
111
+ hasActionButtons={Boolean(item.actions)}
112
+ hasSlotContent={Boolean(item.slotContent)}
113
+ indicator={indicator}
114
+ key={index}
115
+ label={item.label}
116
+ number={item.number ?? index + 1}
117
+ dir={dir}
118
+ showBottomPadding={index < stepItems.length - 1}
119
+ showLine={index < stepItems.length - 1}
120
+ slotContent={item.slotContent}
121
+ supportText={item.supportText}
122
+ >
123
+ {item.actions}
124
+ </VerticalStepItem>
125
+ ))}
126
+ </div>
127
+ );
128
+ }
129
+
130
+ return (
131
+ <div
132
+ className={["ds-steps", "ds-steps--horizontal", className]
133
+ .filter(Boolean)
134
+ .join(" ")}
135
+ dir={dir}
136
+ >
137
+ {stepItems.map((item, index) => (
138
+ <HorizontalStepItem
139
+ caption={item.caption}
140
+ hasCaption={item.caption !== null && item.caption !== undefined}
141
+ indicator={indicator}
142
+ key={index}
143
+ label={item.label}
144
+ number={item.number ?? index + 1}
145
+ dir={dir}
146
+ />
147
+ ))}
148
+ </div>
149
+ );
150
+ }
151
+
152
+ export function ProgressSteps({
153
+ activeIndex = 0,
154
+ ariaLabel,
155
+ className = "",
156
+ classNames = {},
157
+ dir,
158
+ items,
159
+ label,
160
+ variant = "markers",
161
+ }: ProgressStepsProps) {
162
+ const rootClassName = [
163
+ "ds-progress-steps",
164
+ `ds-progress-steps--${variant}`,
165
+ className,
166
+ ]
167
+ .filter(Boolean)
168
+ .join(" ");
169
+
170
+ if (variant === "bars") {
171
+ return (
172
+ <div
173
+ aria-label={ariaLabel}
174
+ aria-valuemax={items.length}
175
+ aria-valuemin={1}
176
+ aria-valuenow={Math.min(activeIndex + 1, items.length)}
177
+ className={rootClassName}
178
+ dir={dir}
179
+ role="progressbar"
180
+ >
181
+ {label ? <span data-slot="progress-steps-label">{label}</span> : null}
182
+ <div
183
+ aria-hidden="true"
184
+ className={["ds-progress-steps__track", classNames.track]
185
+ .filter(Boolean)
186
+ .join(" ")}
187
+ data-slot="progress-steps-track"
188
+ >
189
+ {items.map((item, index) => (
190
+ <span
191
+ className={["ds-progress-steps__segment", classNames.segment]
192
+ .filter(Boolean)
193
+ .join(" ")}
194
+ data-active={index <= activeIndex ? "true" : "false"}
195
+ data-slot="progress-steps-segment"
196
+ data-state={item.state ?? (index < activeIndex ? "complete" : index === activeIndex ? "active" : "todo")}
197
+ key={index}
198
+ />
199
+ ))}
200
+ </div>
201
+ </div>
202
+ );
203
+ }
204
+
205
+ return (
206
+ <ol aria-label={ariaLabel} className={rootClassName} dir={dir}>
207
+ {items.map((item, index) => {
208
+ const state =
209
+ item.state ??
210
+ (index < activeIndex
211
+ ? "complete"
212
+ : index === activeIndex
213
+ ? "active"
214
+ : "todo");
215
+
216
+ return (
217
+ <li
218
+ className={[
219
+ "ds-progress-steps__item",
220
+ `is-${state}`,
221
+ classNames.item,
222
+ ]
223
+ .filter(Boolean)
224
+ .join(" ")}
225
+ data-slot="progress-steps-item"
226
+ data-state={state}
227
+ key={index}
228
+ >
229
+ <span
230
+ aria-hidden="true"
231
+ className={["ds-progress-steps__marker", classNames.marker]
232
+ .filter(Boolean)
233
+ .join(" ")}
234
+ data-slot="progress-steps-marker"
235
+ >
236
+ {item.marker ?? index + 1}
237
+ </span>
238
+ {item.label ? (
239
+ <span
240
+ className={["ds-progress-steps__label", classNames.label]
241
+ .filter(Boolean)
242
+ .join(" ")}
243
+ data-slot="progress-steps-item-label"
244
+ >
245
+ {item.label}
246
+ </span>
247
+ ) : null}
248
+ {index < items.length - 1 ? (
249
+ <span
250
+ aria-hidden="true"
251
+ className={[
252
+ "ds-progress-steps__connector",
253
+ state === "complete" && "is-complete",
254
+ classNames.connector,
255
+ ]
256
+ .filter(Boolean)
257
+ .join(" ")}
258
+ data-slot="progress-steps-connector"
259
+ />
260
+ ) : null}
261
+ </li>
262
+ );
263
+ })}
264
+ </ol>
265
+ );
266
+ }
267
+
268
+ export function HorizontalStepItem({
269
+ alignment = "leading",
270
+ caption,
271
+ className = "",
272
+ hasCaption = true,
273
+ indicator = "icon",
274
+ label,
275
+ number = 1,
276
+ position = "top",
277
+ dir,
278
+ showLeadingLine = true,
279
+ showTrailingLine = true,
280
+ }: HorizontalStepItemProps) {
281
+ const linePlacement = getHorizontalLinePlacement(alignment, showLeadingLine, showTrailingLine);
282
+ const text = (
283
+ <div className="ds-horizontal-step-item__text">
284
+ {label && <div className="ds-horizontal-step-item__label">{label}</div>}
285
+ {hasCaption && caption && <div className="ds-horizontal-step-item__caption">{caption}</div>}
286
+ </div>
287
+ );
288
+ const track = (
289
+ <div className="ds-horizontal-step-item__track" aria-hidden="true">
290
+ {linePlacement.before && <span className="ds-step-line ds-step-line--horizontal" />}
291
+ <StepMarker indicator={indicator} number={number} />
292
+ {linePlacement.after && <span className="ds-step-line ds-step-line--horizontal" />}
293
+ </div>
294
+ );
295
+
296
+ return (
297
+ <div
298
+ className={[
299
+ "ds-horizontal-step-item",
300
+ `ds-horizontal-step-item--${alignment}`,
301
+ `ds-horizontal-step-item--${position}`,
302
+ className,
303
+ ]
304
+ .filter(Boolean)
305
+ .join(" ")}
306
+ dir={dir}
307
+ >
308
+ {position === "bottom" ? text : track}
309
+ {position === "bottom" ? track : text}
310
+ </div>
311
+ );
312
+ }
313
+
314
+ export function VerticalStepItem({
315
+ actions,
316
+ alignment = "leading",
317
+ caption,
318
+ children,
319
+ className = "",
320
+ hasActionButtons = true,
321
+ hasCaption = true,
322
+ hasSlotContent = true,
323
+ hasSupportText = true,
324
+ indicator = "icon",
325
+ label,
326
+ number = 1,
327
+ dir,
328
+ showBottomPadding = true,
329
+ showLine = true,
330
+ slotContent,
331
+ supportText,
332
+ }: VerticalStepItemProps & { children?: ReactNode }) {
333
+ const marker = (
334
+ <div className="ds-vertical-step-item__rail" aria-hidden="true">
335
+ <StepMarker indicator={indicator} number={number} />
336
+ {showLine && <span className="ds-step-line ds-step-line--vertical" />}
337
+ </div>
338
+ );
339
+ const markerFirst = alignment === "leading";
340
+ const renderedActions = actions ?? children;
341
+ const renderedSlot = slotContent;
342
+
343
+ return (
344
+ <div
345
+ className={[
346
+ "ds-vertical-step-item",
347
+ `ds-vertical-step-item--${alignment}`,
348
+ className,
349
+ ]
350
+ .filter(Boolean)
351
+ .join(" ")}
352
+ dir={dir}
353
+ >
354
+ {markerFirst && marker}
355
+ <div className="ds-vertical-step-item__content">
356
+ <div className="ds-vertical-step-item__copy">
357
+ <div className="ds-vertical-step-item__header">
358
+ {label && <div className="ds-vertical-step-item__label">{label}</div>}
359
+ {hasSupportText && supportText && <div className="ds-vertical-step-item__support">{supportText}</div>}
360
+ </div>
361
+ {hasCaption && caption && <div className="ds-vertical-step-item__caption">{caption}</div>}
362
+ </div>
363
+ {hasSlotContent && renderedSlot}
364
+ {hasActionButtons && renderedActions && <div className="ds-vertical-step-item__actions">{renderedActions}</div>}
365
+ {showBottomPadding && <div className="ds-vertical-step-item__bottom-padding" />}
366
+ </div>
367
+ {!markerFirst && marker}
368
+ </div>
369
+ );
370
+ }
371
+
372
+ function StepMarker({ indicator, number }: { indicator: StepIndicator; number: ReactNode }) {
373
+ if (indicator === "number") {
374
+ return (
375
+ <span className="ds-step-marker ds-step-marker--number">
376
+ <span>{number}</span>
377
+ </span>
378
+ );
379
+ }
380
+
381
+ return (
382
+ <span className="ds-step-marker ds-step-marker--icon">
383
+ <CheckIcon aria-hidden="true" focusable="false" strokeWidth="var(--bh-icon-stroke-300)" />
384
+ </span>
385
+ );
386
+ }
387
+
388
+ function getHorizontalLinePlacement(
389
+ alignment: StepAlignment,
390
+ showLeadingLine: boolean,
391
+ showTrailingLine: boolean,
392
+ ) {
393
+ if (alignment === "middle") {
394
+ return { before: showLeadingLine, after: showTrailingLine };
395
+ }
396
+
397
+ if (alignment === "leading") {
398
+ return { before: false, after: showTrailingLine };
399
+ }
400
+
401
+ return { before: showLeadingLine, after: false };
402
+ }