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,584 +1,584 @@
1
- import * as React from "react"
2
- import { cva } from "class-variance-authority"
3
-
4
- import { cn } from "@/lib/utils"
5
- import { useResolvedDirection } from "@/hooks/use-direction"
6
- import {
7
- inputControl,
8
- inputRoot,
9
- inputSurface,
10
- type InputSize,
11
- type InputVariant,
12
- type InputVisualState,
13
- } from "./input"
14
-
15
- type InputOTPState = InputVisualState
16
-
17
- type InputOTPNativeProps = Omit<
18
- React.ComponentProps<"input">,
19
- | "children"
20
- | "className"
21
- | "defaultValue"
22
- | "dir"
23
- | "disabled"
24
- | "maxLength"
25
- | "name"
26
- | "onChange"
27
- | "readOnly"
28
- | "size"
29
- | "type"
30
- | "value"
31
- >
32
-
33
- type InputOTPProps = InputOTPNativeProps & {
34
- className?: string
35
- controlClassName?: string
36
- defaultValue?: string
37
- dir?: "ltr" | "rtl" | "auto"
38
- disabled?: boolean
39
- errorMessage?: React.ReactNode
40
- groupClassName?: string
41
- groupSize?: number
42
- hasHelperText?: boolean
43
- hasLabel?: boolean
44
- isOptional?: boolean
45
- isRequired?: boolean
46
- label?: React.ReactNode
47
- labelClassName?: string
48
- length?: number
49
- mask?: boolean
50
- message?: React.ReactNode
51
- name?: string
52
- onComplete?: (value: string) => void
53
- onValueChange?: (value: string) => void
54
- optionalText?: React.ReactNode
55
- readOnly?: boolean
56
- separator?: React.ReactNode
57
- size?: InputSize
58
- slotClassName?: string
59
- state?: InputOTPState
60
- value?: string
61
- variant?: InputVariant
62
- }
63
-
64
- const inputOtpGroup = cva(
65
- "flex w-[var(--bh-input-otp-width)] max-w-full flex-wrap items-center gap-[var(--bh-input-otp-group-gap)]"
66
- )
67
-
68
- const inputOtpSlotGroup = cva(
69
- "flex min-w-0 items-center gap-[var(--bh-input-otp-slot-gap)]"
70
- )
71
-
72
- const inputOtpSlot = cva("shrink-0", {
73
- variants: {
74
- size: {
75
- comfortable: "w-[var(--bh-input-otp-slot-comfortable-width)]",
76
- md: "w-[var(--bh-input-otp-slot-md-width)]",
77
- lg: "w-[var(--bh-input-otp-slot-lg-width)]",
78
- },
79
- },
80
- defaultVariants: {
81
- size: "lg",
82
- },
83
- })
84
-
85
- const inputOtpControl = cva(
86
- [
87
- "h-full w-full flex-none min-w-[var(--bh-space-none)] p-[var(--bh-space-none)] text-center",
88
- "font-[var(--bh-text-body-md-medium-font-weight)] caret-[var(--bh-content-default)]",
89
- "selection:bg-[var(--bh-bg-brand-soft)]",
90
- ]
91
- )
92
-
93
- const inputOtpSeparator = cva(
94
- "flex h-[var(--bh-input-lg-height)] w-[var(--bh-input-otp-separator-width)] shrink-0 items-center justify-center text-[var(--bh-content-muted)]"
95
- )
96
-
97
- const inputOtpSeparatorMark = cva(
98
- "block h-[var(--bh-input-otp-separator-height)] w-full rounded-[var(--bh-radius-full)] bg-[var(--bh-border-default)]"
99
- )
100
-
101
- const InputOTP = React.forwardRef<HTMLInputElement, InputOTPProps>(
102
- (
103
- {
104
- "aria-describedby": ariaDescribedBy,
105
- "aria-label": ariaLabel,
106
- autoComplete = "one-time-code",
107
- className,
108
- controlClassName,
109
- defaultValue,
110
- dir,
111
- disabled,
112
- errorMessage,
113
- groupClassName,
114
- groupSize = 3,
115
- hasHelperText,
116
- hasLabel,
117
- id,
118
- inputMode = "numeric",
119
- isOptional = false,
120
- isRequired = false,
121
- label,
122
- labelClassName,
123
- length = 6,
124
- mask = false,
125
- message,
126
- name,
127
- onBlur,
128
- onComplete,
129
- onFocus,
130
- onKeyDown,
131
- onPaste,
132
- onValueChange,
133
- optionalText,
134
- pattern = "[0-9]*",
135
- placeholder,
136
- readOnly,
137
- required,
138
- separator = <InputOTPSeparator />,
139
- size = "lg",
140
- slotClassName,
141
- state = "default",
142
- value,
143
- variant = "default",
144
- ...slotProps
145
- },
146
- ref
147
- ) => {
148
- const generatedId = React.useId()
149
- const inputId = id || generatedId
150
- const labelId = `${inputId}-label`
151
- const helperId = `${inputId}-helper`
152
- const slotCount = normalizeCount(length, 6)
153
- const normalizedGroupSize = normalizeCount(groupSize, slotCount)
154
- const isControlled = value !== undefined
155
- const [internalValue, setInternalValue] = React.useState(
156
- normalizeValue(defaultValue, slotCount)
157
- )
158
- const slotRefs = React.useRef<Array<HTMLInputElement | null>>([])
159
- const rootRef = React.useRef<HTMLDivElement | null>(null)
160
- const resolvedDirection = useResolvedDirection(
161
- dir === "ltr" || dir === "rtl" ? dir : undefined,
162
- rootRef
163
- )
164
- const currentValue = normalizeValue(
165
- isControlled ? value : internalValue,
166
- slotCount
167
- )
168
- const valueChars = valueToSlots(currentValue, slotCount)
169
- const visualState = disabled ? "disabled" : state
170
- const isDisabled = visualState === "disabled"
171
- const isInvalid = visualState === "error" && !isDisabled
172
- const isComplete = valueChars.every(Boolean)
173
- const shouldRenderLabel = hasLabel ?? hasRenderableContent(label)
174
- const helperText = isInvalid ? errorMessage : message
175
- const shouldRenderHelperText =
176
- hasHelperText ?? hasRenderableContent(helperText)
177
- const describedBy = [ariaDescribedBy, shouldRenderHelperText ? helperId : ""]
178
- .filter(Boolean)
179
- .join(" ") || undefined
180
- const groups = groupSlots(slotCount, normalizedGroupSize)
181
- const slotPlaceholder = getFirstCharacter(placeholder)
182
-
183
- function commitSlots(nextSlots: string[], focusIndex?: number) {
184
- const nextValue = slotsToValue(nextSlots, slotCount)
185
-
186
- if (!isControlled) {
187
- setInternalValue(nextValue)
188
- }
189
-
190
- onValueChange?.(nextValue)
191
-
192
- if (nextValue.length === slotCount) {
193
- onComplete?.(nextValue)
194
- }
195
-
196
- if (focusIndex !== undefined) {
197
- focusSlot(focusIndex)
198
- }
199
- }
200
-
201
- function focusSlot(index: number) {
202
- const nextIndex = Math.max(0, Math.min(slotCount - 1, index))
203
-
204
- window.requestAnimationFrame(() => {
205
- const slot = slotRefs.current[nextIndex]
206
- slot?.focus()
207
- slot?.select()
208
- })
209
- }
210
-
211
- function setSlotRef(index: number, node: HTMLInputElement | null) {
212
- slotRefs.current[index] = node
213
-
214
- if (index === 0) {
215
- assignRef(ref, node)
216
- }
217
- }
218
-
219
- function updateSlot(index: number, nextInputValue: string) {
220
- if (isDisabled || readOnly) return
221
-
222
- const nextCharacters = toCharacters(nextInputValue, slotCount - index)
223
- const nextSlots = [...valueChars]
224
-
225
- if (nextCharacters.length === 0) {
226
- nextSlots[index] = ""
227
- commitSlots(nextSlots, index)
228
- return
229
- }
230
-
231
- for (let offset = 0; offset < nextCharacters.length; offset += 1) {
232
- nextSlots[index + offset] = nextCharacters[offset]
233
- }
234
-
235
- commitSlots(nextSlots, index + nextCharacters.length)
236
- }
237
-
238
- function handleSlotKeyDown(
239
- event: React.KeyboardEvent<HTMLInputElement>,
240
- index: number
241
- ) {
242
- onKeyDown?.(event)
243
- if (event.defaultPrevented) return
244
-
245
- const previousKey =
246
- resolvedDirection === "rtl" ? "ArrowRight" : "ArrowLeft"
247
- const nextKey =
248
- resolvedDirection === "rtl" ? "ArrowLeft" : "ArrowRight"
249
-
250
- if (event.key === previousKey) {
251
- event.preventDefault()
252
- focusSlot(index - 1)
253
- return
254
- }
255
-
256
- if (event.key === nextKey) {
257
- event.preventDefault()
258
- focusSlot(index + 1)
259
- return
260
- }
261
-
262
- if (event.key === "Home") {
263
- event.preventDefault()
264
- focusSlot(0)
265
- return
266
- }
267
-
268
- if (event.key === "End") {
269
- event.preventDefault()
270
- focusSlot(slotCount - 1)
271
- return
272
- }
273
-
274
- if (event.key !== "Backspace" || readOnly || isDisabled) {
275
- return
276
- }
277
-
278
- event.preventDefault()
279
-
280
- if (valueChars[index]) {
281
- const nextSlots = [...valueChars]
282
- nextSlots[index] = ""
283
- commitSlots(nextSlots, index)
284
- return
285
- }
286
-
287
- if (index > 0) {
288
- const nextSlots = [...valueChars]
289
- nextSlots[index - 1] = ""
290
- commitSlots(nextSlots, index - 1)
291
- }
292
- }
293
-
294
- function handleSlotPaste(
295
- event: React.ClipboardEvent<HTMLInputElement>,
296
- index: number
297
- ) {
298
- onPaste?.(event)
299
- if (event.defaultPrevented || readOnly || isDisabled) return
300
-
301
- event.preventDefault()
302
- updateSlot(index, event.clipboardData.getData("text"))
303
- }
304
-
305
- return (
306
- <div
307
- aria-label={shouldRenderLabel ? undefined : ariaLabel}
308
- aria-labelledby={shouldRenderLabel ? labelId : undefined}
309
- data-complete={isComplete ? "true" : undefined}
310
- data-size={size}
311
- data-slot="input-otp-root"
312
- data-state={visualState}
313
- data-variant={variant}
314
- dir={dir === "auto" ? "auto" : resolvedDirection}
315
- ref={rootRef}
316
- role="group"
317
- className={cn(
318
- inputRoot(),
319
- "[--bh-input-width:var(--bh-input-otp-width)]",
320
- className
321
- )}
322
- >
323
- {shouldRenderLabel ? (
324
- <InputOTPLabel
325
- className={labelClassName}
326
- htmlFor={`${inputId}-0`}
327
- id={labelId}
328
- isOptional={isOptional}
329
- isRequired={isRequired || Boolean(required)}
330
- label={label}
331
- optionalText={optionalText}
332
- />
333
- ) : null}
334
-
335
- <div
336
- data-slot="input-otp-body"
337
- className={cn(
338
- "grid",
339
- shouldRenderLabel && "mt-[var(--bh-input-label-gap)]",
340
- "gap-[var(--bh-input-helper-gap)]"
341
- )}
342
- >
343
- <div data-slot="input-otp-group" className={cn(inputOtpGroup(), groupClassName)}>
344
- {groups.map((group, groupIndex) => (
345
- <React.Fragment key={`group-${group[0]}`}>
346
- {groupIndex > 0 && separator ? separator : null}
347
- <div data-slot="input-otp-slot-group" className={cn(inputOtpSlotGroup())}>
348
- {group.map((slotIndex) => (
349
- <span
350
- aria-disabled={isDisabled || undefined}
351
- data-filled={valueChars[slotIndex] ? "true" : undefined}
352
- data-slot="input-otp-slot"
353
- data-state={visualState}
354
- key={slotIndex}
355
- className={cn(
356
- inputSurface({ size, state: visualState, variant }),
357
- inputOtpSlot({ size }),
358
- slotClassName
359
- )}
360
- onClick={() => focusSlot(slotIndex)}
361
- >
362
- <input
363
- aria-describedby={describedBy}
364
- aria-invalid={isInvalid || undefined}
365
- aria-label={getSlotAriaLabel(slotIndex, slotCount)}
366
- autoComplete={slotIndex === 0 ? autoComplete : "off"}
367
- data-slot="input-otp-control"
368
- data-state={visualState}
369
- disabled={isDisabled}
370
- id={`${inputId}-${slotIndex}`}
371
- inputMode={inputMode}
372
- maxLength={1}
373
- pattern={pattern}
374
- placeholder={slotPlaceholder}
375
- readOnly={readOnly}
376
- ref={(node) => setSlotRef(slotIndex, node)}
377
- required={required}
378
- type={mask ? "password" : "text"}
379
- value={valueChars[slotIndex] || ""}
380
- className={cn(inputControl(), inputOtpControl(), controlClassName)}
381
- onBlur={onBlur}
382
- onChange={(event) => updateSlot(slotIndex, event.currentTarget.value)}
383
- onFocus={(event) => {
384
- onFocus?.(event)
385
- event.currentTarget.select()
386
- }}
387
- onKeyDown={(event) => handleSlotKeyDown(event, slotIndex)}
388
- onPaste={(event) => handleSlotPaste(event, slotIndex)}
389
- {...slotProps}
390
- />
391
- </span>
392
- ))}
393
- </div>
394
- </React.Fragment>
395
- ))}
396
- </div>
397
-
398
- {name ? (
399
- <input
400
- data-slot="input-otp-hidden-control"
401
- disabled={isDisabled}
402
- name={name}
403
- type="hidden"
404
- value={currentValue}
405
- />
406
- ) : null}
407
-
408
- {shouldRenderHelperText ? (
409
- <InputOTPHelperText
410
- id={helperId}
411
- invalid={isInvalid}
412
- >
413
- {helperText}
414
- </InputOTPHelperText>
415
- ) : null}
416
- </div>
417
- </div>
418
- )
419
- }
420
- )
421
- InputOTP.displayName = "InputOTP"
422
-
423
- function InputOTPSeparator({ className }: { className?: string }) {
424
- return (
425
- <span
426
- aria-hidden="true"
427
- data-slot="input-otp-separator"
428
- className={cn(inputOtpSeparator(), className)}
429
- >
430
- <span data-slot="input-otp-separator-mark" className={cn(inputOtpSeparatorMark())} />
431
- </span>
432
- )
433
- }
434
-
435
- function InputOTPLabel({
436
- className,
437
- htmlFor,
438
- id,
439
- isOptional,
440
- isRequired,
441
- label,
442
- optionalText,
443
- }: {
444
- className?: string
445
- htmlFor: string
446
- id: string
447
- isOptional: boolean
448
- isRequired: boolean
449
- label: React.ReactNode
450
- optionalText: React.ReactNode
451
- }) {
452
- return (
453
- <label
454
- data-slot="input-otp-label"
455
- htmlFor={htmlFor}
456
- id={id}
457
- className={cn(
458
- "flex w-full items-center gap-[var(--bh-input-inline-gap)] text-start",
459
- className
460
- )}
461
- >
462
- <span
463
- data-slot="input-otp-label-text"
464
- dir="auto"
465
- className="min-w-0 shrink-0 whitespace-nowrap text-[length:var(--bh-text-body-sm-medium-font-size)] font-[var(--bh-text-body-sm-medium-font-weight)] leading-[var(--bh-text-body-sm-medium-line-height)] tracking-[var(--bh-text-body-sm-medium-letter-spacing)] text-[var(--bh-content-default)]"
466
- >
467
- {label}
468
- </span>
469
- {isRequired ? (
470
- <span
471
- aria-hidden="true"
472
- data-slot="input-otp-label-required"
473
- className="shrink-0 whitespace-nowrap text-[length:var(--bh-text-body-xs-regular-font-size)] font-[var(--bh-text-body-xs-regular-font-weight)] leading-[var(--bh-text-body-xs-regular-line-height)] tracking-[var(--bh-text-body-xs-regular-letter-spacing)] text-[var(--bh-content-danger-default)]"
474
- >
475
- *
476
- </span>
477
- ) : null}
478
- {isOptional && hasRenderableContent(optionalText) ? (
479
- <span
480
- data-slot="input-otp-label-optional"
481
- dir="auto"
482
- className="min-w-0 shrink-0 whitespace-nowrap text-[length:var(--bh-text-body-xs-regular-font-size)] font-[var(--bh-text-body-xs-regular-font-weight)] leading-[var(--bh-text-body-xs-regular-line-height)] tracking-[var(--bh-text-body-xs-regular-letter-spacing)] text-[var(--bh-content-subtle)]"
483
- >
484
- {optionalText}
485
- </span>
486
- ) : null}
487
- </label>
488
- )
489
- }
490
-
491
- function InputOTPHelperText({
492
- children,
493
- id,
494
- invalid,
495
- }: {
496
- children: React.ReactNode
497
- id: string
498
- invalid: boolean
499
- }) {
500
- return (
501
- <p
502
- data-slot="input-otp-helper-text"
503
- id={id}
504
- className={cn(
505
- "m-0 w-full text-start text-[length:var(--bh-text-body-xs-regular-font-size)]",
506
- "font-[var(--bh-text-body-xs-regular-font-weight)]",
507
- "leading-[var(--bh-text-body-xs-regular-line-height)]",
508
- "tracking-[var(--bh-text-body-xs-regular-letter-spacing)]",
509
- invalid ? "text-[var(--bh-content-danger-default)]" : "text-[var(--bh-content-subtle)]"
510
- )}
511
- >
512
- <span data-slot="input-otp-helper-label" dir="auto" className="min-w-0">
513
- {children}
514
- </span>
515
- </p>
516
- )
517
- }
518
-
519
- function assignRef<T>(ref: React.ForwardedRef<T>, value: T | null) {
520
- if (typeof ref === "function") {
521
- ref(value)
522
- } else if (ref) {
523
- ref.current = value
524
- }
525
- }
526
-
527
- function getFirstCharacter(value?: string) {
528
- return value ? Array.from(value)[0] : undefined
529
- }
530
-
531
- function getSlotAriaLabel(index: number, total: number) {
532
- return `One-time code character ${index + 1} of ${total}`
533
- }
534
-
535
- function groupSlots(slotCount: number, groupSize: number) {
536
- const groups: number[][] = []
537
-
538
- for (let index = 0; index < slotCount; index += groupSize) {
539
- groups.push(
540
- Array.from(
541
- { length: Math.min(groupSize, slotCount - index) },
542
- (_, offset) => index + offset
543
- )
544
- )
545
- }
546
-
547
- return groups
548
- }
549
-
550
- function hasRenderableContent(content: React.ReactNode) {
551
- return (
552
- content !== undefined &&
553
- content !== null &&
554
- content !== false &&
555
- content !== ""
556
- )
557
- }
558
-
559
- function normalizeCount(value: number | undefined, fallback: number) {
560
- if (!Number.isFinite(value)) return fallback
561
-
562
- return Math.max(1, Math.floor(value || fallback))
563
- }
564
-
565
- function normalizeValue(value: string | undefined, maxLength: number) {
566
- return toCharacters(value || "", maxLength).join("")
567
- }
568
-
569
- function slotsToValue(slots: string[], maxLength: number) {
570
- return slots.slice(0, maxLength).join("")
571
- }
572
-
573
- function toCharacters(value: string, maxLength: number) {
574
- return Array.from(value.replace(/\s/g, "")).slice(0, maxLength)
575
- }
576
-
577
- function valueToSlots(value: string, slotCount: number) {
578
- const characters = toCharacters(value, slotCount)
579
-
580
- return Array.from({ length: slotCount }, (_, index) => characters[index] || "")
581
- }
582
-
583
- export { InputOTP, InputOTPSeparator }
584
- export type { InputOTPProps, InputOTPState }
1
+ import * as React from "react"
2
+ import { cva } from "class-variance-authority"
3
+
4
+ import { cn } from "@/lib/utils"
5
+ import { useResolvedDirection } from "@/hooks/use-direction"
6
+ import {
7
+ inputControl,
8
+ inputRoot,
9
+ inputSurface,
10
+ type InputSize,
11
+ type InputVariant,
12
+ type InputVisualState,
13
+ } from "./input"
14
+
15
+ type InputOTPState = InputVisualState
16
+
17
+ type InputOTPNativeProps = Omit<
18
+ React.ComponentProps<"input">,
19
+ | "children"
20
+ | "className"
21
+ | "defaultValue"
22
+ | "dir"
23
+ | "disabled"
24
+ | "maxLength"
25
+ | "name"
26
+ | "onChange"
27
+ | "readOnly"
28
+ | "size"
29
+ | "type"
30
+ | "value"
31
+ >
32
+
33
+ type InputOTPProps = InputOTPNativeProps & {
34
+ className?: string
35
+ controlClassName?: string
36
+ defaultValue?: string
37
+ dir?: "ltr" | "rtl" | "auto"
38
+ disabled?: boolean
39
+ errorMessage?: React.ReactNode
40
+ groupClassName?: string
41
+ groupSize?: number
42
+ hasHelperText?: boolean
43
+ hasLabel?: boolean
44
+ isOptional?: boolean
45
+ isRequired?: boolean
46
+ label?: React.ReactNode
47
+ labelClassName?: string
48
+ length?: number
49
+ mask?: boolean
50
+ message?: React.ReactNode
51
+ name?: string
52
+ onComplete?: (value: string) => void
53
+ onValueChange?: (value: string) => void
54
+ optionalText?: React.ReactNode
55
+ readOnly?: boolean
56
+ separator?: React.ReactNode
57
+ size?: InputSize
58
+ slotClassName?: string
59
+ state?: InputOTPState
60
+ value?: string
61
+ variant?: InputVariant
62
+ }
63
+
64
+ const inputOtpGroup = cva(
65
+ "flex w-[var(--bh-input-otp-width)] max-w-full flex-wrap items-center gap-[var(--bh-input-otp-group-gap)]"
66
+ )
67
+
68
+ const inputOtpSlotGroup = cva(
69
+ "flex min-w-0 items-center gap-[var(--bh-input-otp-slot-gap)]"
70
+ )
71
+
72
+ const inputOtpSlot = cva("shrink-0", {
73
+ variants: {
74
+ size: {
75
+ comfortable: "w-[var(--bh-input-otp-slot-comfortable-width)]",
76
+ md: "w-[var(--bh-input-otp-slot-md-width)]",
77
+ lg: "w-[var(--bh-input-otp-slot-lg-width)]",
78
+ },
79
+ },
80
+ defaultVariants: {
81
+ size: "lg",
82
+ },
83
+ })
84
+
85
+ const inputOtpControl = cva(
86
+ [
87
+ "h-full w-full flex-none min-w-[var(--bh-space-none)] p-[var(--bh-space-none)] text-center",
88
+ "font-[var(--bh-text-body-md-medium-font-weight)] caret-[var(--bh-content-default)]",
89
+ "selection:bg-[var(--bh-bg-brand-soft)]",
90
+ ]
91
+ )
92
+
93
+ const inputOtpSeparator = cva(
94
+ "flex h-[var(--bh-input-lg-height)] w-[var(--bh-input-otp-separator-width)] shrink-0 items-center justify-center text-[var(--bh-content-muted)]"
95
+ )
96
+
97
+ const inputOtpSeparatorMark = cva(
98
+ "block h-[var(--bh-input-otp-separator-height)] w-full rounded-[var(--bh-radius-full)] bg-[var(--bh-border-default)]"
99
+ )
100
+
101
+ const InputOTP = React.forwardRef<HTMLInputElement, InputOTPProps>(
102
+ (
103
+ {
104
+ "aria-describedby": ariaDescribedBy,
105
+ "aria-label": ariaLabel,
106
+ autoComplete = "one-time-code",
107
+ className,
108
+ controlClassName,
109
+ defaultValue,
110
+ dir,
111
+ disabled,
112
+ errorMessage,
113
+ groupClassName,
114
+ groupSize = 3,
115
+ hasHelperText,
116
+ hasLabel,
117
+ id,
118
+ inputMode = "numeric",
119
+ isOptional = false,
120
+ isRequired = false,
121
+ label,
122
+ labelClassName,
123
+ length = 6,
124
+ mask = false,
125
+ message,
126
+ name,
127
+ onBlur,
128
+ onComplete,
129
+ onFocus,
130
+ onKeyDown,
131
+ onPaste,
132
+ onValueChange,
133
+ optionalText,
134
+ pattern = "[0-9]*",
135
+ placeholder,
136
+ readOnly,
137
+ required,
138
+ separator = <InputOTPSeparator />,
139
+ size = "lg",
140
+ slotClassName,
141
+ state = "default",
142
+ value,
143
+ variant = "default",
144
+ ...slotProps
145
+ },
146
+ ref
147
+ ) => {
148
+ const generatedId = React.useId()
149
+ const inputId = id || generatedId
150
+ const labelId = `${inputId}-label`
151
+ const helperId = `${inputId}-helper`
152
+ const slotCount = normalizeCount(length, 6)
153
+ const normalizedGroupSize = normalizeCount(groupSize, slotCount)
154
+ const isControlled = value !== undefined
155
+ const [internalValue, setInternalValue] = React.useState(
156
+ normalizeValue(defaultValue, slotCount)
157
+ )
158
+ const slotRefs = React.useRef<Array<HTMLInputElement | null>>([])
159
+ const rootRef = React.useRef<HTMLDivElement | null>(null)
160
+ const resolvedDirection = useResolvedDirection(
161
+ dir === "ltr" || dir === "rtl" ? dir : undefined,
162
+ rootRef
163
+ )
164
+ const currentValue = normalizeValue(
165
+ isControlled ? value : internalValue,
166
+ slotCount
167
+ )
168
+ const valueChars = valueToSlots(currentValue, slotCount)
169
+ const visualState = disabled ? "disabled" : state
170
+ const isDisabled = visualState === "disabled"
171
+ const isInvalid = visualState === "error" && !isDisabled
172
+ const isComplete = valueChars.every(Boolean)
173
+ const shouldRenderLabel = hasLabel ?? hasRenderableContent(label)
174
+ const helperText = isInvalid ? errorMessage : message
175
+ const shouldRenderHelperText =
176
+ hasHelperText ?? hasRenderableContent(helperText)
177
+ const describedBy = [ariaDescribedBy, shouldRenderHelperText ? helperId : ""]
178
+ .filter(Boolean)
179
+ .join(" ") || undefined
180
+ const groups = groupSlots(slotCount, normalizedGroupSize)
181
+ const slotPlaceholder = getFirstCharacter(placeholder)
182
+
183
+ function commitSlots(nextSlots: string[], focusIndex?: number) {
184
+ const nextValue = slotsToValue(nextSlots, slotCount)
185
+
186
+ if (!isControlled) {
187
+ setInternalValue(nextValue)
188
+ }
189
+
190
+ onValueChange?.(nextValue)
191
+
192
+ if (nextValue.length === slotCount) {
193
+ onComplete?.(nextValue)
194
+ }
195
+
196
+ if (focusIndex !== undefined) {
197
+ focusSlot(focusIndex)
198
+ }
199
+ }
200
+
201
+ function focusSlot(index: number) {
202
+ const nextIndex = Math.max(0, Math.min(slotCount - 1, index))
203
+
204
+ window.requestAnimationFrame(() => {
205
+ const slot = slotRefs.current[nextIndex]
206
+ slot?.focus()
207
+ slot?.select()
208
+ })
209
+ }
210
+
211
+ function setSlotRef(index: number, node: HTMLInputElement | null) {
212
+ slotRefs.current[index] = node
213
+
214
+ if (index === 0) {
215
+ assignRef(ref, node)
216
+ }
217
+ }
218
+
219
+ function updateSlot(index: number, nextInputValue: string) {
220
+ if (isDisabled || readOnly) return
221
+
222
+ const nextCharacters = toCharacters(nextInputValue, slotCount - index)
223
+ const nextSlots = [...valueChars]
224
+
225
+ if (nextCharacters.length === 0) {
226
+ nextSlots[index] = ""
227
+ commitSlots(nextSlots, index)
228
+ return
229
+ }
230
+
231
+ for (let offset = 0; offset < nextCharacters.length; offset += 1) {
232
+ nextSlots[index + offset] = nextCharacters[offset]
233
+ }
234
+
235
+ commitSlots(nextSlots, index + nextCharacters.length)
236
+ }
237
+
238
+ function handleSlotKeyDown(
239
+ event: React.KeyboardEvent<HTMLInputElement>,
240
+ index: number
241
+ ) {
242
+ onKeyDown?.(event)
243
+ if (event.defaultPrevented) return
244
+
245
+ const previousKey =
246
+ resolvedDirection === "rtl" ? "ArrowRight" : "ArrowLeft"
247
+ const nextKey =
248
+ resolvedDirection === "rtl" ? "ArrowLeft" : "ArrowRight"
249
+
250
+ if (event.key === previousKey) {
251
+ event.preventDefault()
252
+ focusSlot(index - 1)
253
+ return
254
+ }
255
+
256
+ if (event.key === nextKey) {
257
+ event.preventDefault()
258
+ focusSlot(index + 1)
259
+ return
260
+ }
261
+
262
+ if (event.key === "Home") {
263
+ event.preventDefault()
264
+ focusSlot(0)
265
+ return
266
+ }
267
+
268
+ if (event.key === "End") {
269
+ event.preventDefault()
270
+ focusSlot(slotCount - 1)
271
+ return
272
+ }
273
+
274
+ if (event.key !== "Backspace" || readOnly || isDisabled) {
275
+ return
276
+ }
277
+
278
+ event.preventDefault()
279
+
280
+ if (valueChars[index]) {
281
+ const nextSlots = [...valueChars]
282
+ nextSlots[index] = ""
283
+ commitSlots(nextSlots, index)
284
+ return
285
+ }
286
+
287
+ if (index > 0) {
288
+ const nextSlots = [...valueChars]
289
+ nextSlots[index - 1] = ""
290
+ commitSlots(nextSlots, index - 1)
291
+ }
292
+ }
293
+
294
+ function handleSlotPaste(
295
+ event: React.ClipboardEvent<HTMLInputElement>,
296
+ index: number
297
+ ) {
298
+ onPaste?.(event)
299
+ if (event.defaultPrevented || readOnly || isDisabled) return
300
+
301
+ event.preventDefault()
302
+ updateSlot(index, event.clipboardData.getData("text"))
303
+ }
304
+
305
+ return (
306
+ <div
307
+ aria-label={shouldRenderLabel ? undefined : ariaLabel}
308
+ aria-labelledby={shouldRenderLabel ? labelId : undefined}
309
+ data-complete={isComplete ? "true" : undefined}
310
+ data-size={size}
311
+ data-slot="input-otp-root"
312
+ data-state={visualState}
313
+ data-variant={variant}
314
+ dir={dir === "auto" ? "auto" : resolvedDirection}
315
+ ref={rootRef}
316
+ role="group"
317
+ className={cn(
318
+ inputRoot(),
319
+ "[--bh-input-width:var(--bh-input-otp-width)]",
320
+ className
321
+ )}
322
+ >
323
+ {shouldRenderLabel ? (
324
+ <InputOTPLabel
325
+ className={labelClassName}
326
+ htmlFor={`${inputId}-0`}
327
+ id={labelId}
328
+ isOptional={isOptional}
329
+ isRequired={isRequired || Boolean(required)}
330
+ label={label}
331
+ optionalText={optionalText}
332
+ />
333
+ ) : null}
334
+
335
+ <div
336
+ data-slot="input-otp-body"
337
+ className={cn(
338
+ "grid",
339
+ shouldRenderLabel && "mt-[var(--bh-input-label-gap)]",
340
+ "gap-[var(--bh-input-helper-gap)]"
341
+ )}
342
+ >
343
+ <div data-slot="input-otp-group" className={cn(inputOtpGroup(), groupClassName)}>
344
+ {groups.map((group, groupIndex) => (
345
+ <React.Fragment key={`group-${group[0]}`}>
346
+ {groupIndex > 0 && separator ? separator : null}
347
+ <div data-slot="input-otp-slot-group" className={cn(inputOtpSlotGroup())}>
348
+ {group.map((slotIndex) => (
349
+ <span
350
+ aria-disabled={isDisabled || undefined}
351
+ data-filled={valueChars[slotIndex] ? "true" : undefined}
352
+ data-slot="input-otp-slot"
353
+ data-state={visualState}
354
+ key={slotIndex}
355
+ className={cn(
356
+ inputSurface({ size, state: visualState, variant }),
357
+ inputOtpSlot({ size }),
358
+ slotClassName
359
+ )}
360
+ onClick={() => focusSlot(slotIndex)}
361
+ >
362
+ <input
363
+ aria-describedby={describedBy}
364
+ aria-invalid={isInvalid || undefined}
365
+ aria-label={getSlotAriaLabel(slotIndex, slotCount)}
366
+ autoComplete={slotIndex === 0 ? autoComplete : "off"}
367
+ data-slot="input-otp-control"
368
+ data-state={visualState}
369
+ disabled={isDisabled}
370
+ id={`${inputId}-${slotIndex}`}
371
+ inputMode={inputMode}
372
+ maxLength={1}
373
+ pattern={pattern}
374
+ placeholder={slotPlaceholder}
375
+ readOnly={readOnly}
376
+ ref={(node) => setSlotRef(slotIndex, node)}
377
+ required={required}
378
+ type={mask ? "password" : "text"}
379
+ value={valueChars[slotIndex] || ""}
380
+ className={cn(inputControl(), inputOtpControl(), controlClassName)}
381
+ onBlur={onBlur}
382
+ onChange={(event) => updateSlot(slotIndex, event.currentTarget.value)}
383
+ onFocus={(event) => {
384
+ onFocus?.(event)
385
+ event.currentTarget.select()
386
+ }}
387
+ onKeyDown={(event) => handleSlotKeyDown(event, slotIndex)}
388
+ onPaste={(event) => handleSlotPaste(event, slotIndex)}
389
+ {...slotProps}
390
+ />
391
+ </span>
392
+ ))}
393
+ </div>
394
+ </React.Fragment>
395
+ ))}
396
+ </div>
397
+
398
+ {name ? (
399
+ <input
400
+ data-slot="input-otp-hidden-control"
401
+ disabled={isDisabled}
402
+ name={name}
403
+ type="hidden"
404
+ value={currentValue}
405
+ />
406
+ ) : null}
407
+
408
+ {shouldRenderHelperText ? (
409
+ <InputOTPHelperText
410
+ id={helperId}
411
+ invalid={isInvalid}
412
+ >
413
+ {helperText}
414
+ </InputOTPHelperText>
415
+ ) : null}
416
+ </div>
417
+ </div>
418
+ )
419
+ }
420
+ )
421
+ InputOTP.displayName = "InputOTP"
422
+
423
+ function InputOTPSeparator({ className }: { className?: string }) {
424
+ return (
425
+ <span
426
+ aria-hidden="true"
427
+ data-slot="input-otp-separator"
428
+ className={cn(inputOtpSeparator(), className)}
429
+ >
430
+ <span data-slot="input-otp-separator-mark" className={cn(inputOtpSeparatorMark())} />
431
+ </span>
432
+ )
433
+ }
434
+
435
+ function InputOTPLabel({
436
+ className,
437
+ htmlFor,
438
+ id,
439
+ isOptional,
440
+ isRequired,
441
+ label,
442
+ optionalText,
443
+ }: {
444
+ className?: string
445
+ htmlFor: string
446
+ id: string
447
+ isOptional: boolean
448
+ isRequired: boolean
449
+ label: React.ReactNode
450
+ optionalText: React.ReactNode
451
+ }) {
452
+ return (
453
+ <label
454
+ data-slot="input-otp-label"
455
+ htmlFor={htmlFor}
456
+ id={id}
457
+ className={cn(
458
+ "flex w-full items-center gap-[var(--bh-input-inline-gap)] text-start",
459
+ className
460
+ )}
461
+ >
462
+ <span
463
+ data-slot="input-otp-label-text"
464
+ dir="auto"
465
+ className="min-w-0 shrink-0 whitespace-nowrap text-[length:var(--bh-text-body-sm-medium-font-size)] font-[var(--bh-text-body-sm-medium-font-weight)] leading-[var(--bh-text-body-sm-medium-line-height)] tracking-[var(--bh-text-body-sm-medium-letter-spacing)] text-[var(--bh-content-default)]"
466
+ >
467
+ {label}
468
+ </span>
469
+ {isRequired ? (
470
+ <span
471
+ aria-hidden="true"
472
+ data-slot="input-otp-label-required"
473
+ className="shrink-0 whitespace-nowrap text-[length:var(--bh-text-body-xs-regular-font-size)] font-[var(--bh-text-body-xs-regular-font-weight)] leading-[var(--bh-text-body-xs-regular-line-height)] tracking-[var(--bh-text-body-xs-regular-letter-spacing)] text-[var(--bh-content-danger-default)]"
474
+ >
475
+ *
476
+ </span>
477
+ ) : null}
478
+ {isOptional && hasRenderableContent(optionalText) ? (
479
+ <span
480
+ data-slot="input-otp-label-optional"
481
+ dir="auto"
482
+ className="min-w-0 shrink-0 whitespace-nowrap text-[length:var(--bh-text-body-xs-regular-font-size)] font-[var(--bh-text-body-xs-regular-font-weight)] leading-[var(--bh-text-body-xs-regular-line-height)] tracking-[var(--bh-text-body-xs-regular-letter-spacing)] text-[var(--bh-content-subtle)]"
483
+ >
484
+ {optionalText}
485
+ </span>
486
+ ) : null}
487
+ </label>
488
+ )
489
+ }
490
+
491
+ function InputOTPHelperText({
492
+ children,
493
+ id,
494
+ invalid,
495
+ }: {
496
+ children: React.ReactNode
497
+ id: string
498
+ invalid: boolean
499
+ }) {
500
+ return (
501
+ <p
502
+ data-slot="input-otp-helper-text"
503
+ id={id}
504
+ className={cn(
505
+ "m-0 w-full text-start text-[length:var(--bh-text-body-xs-regular-font-size)]",
506
+ "font-[var(--bh-text-body-xs-regular-font-weight)]",
507
+ "leading-[var(--bh-text-body-xs-regular-line-height)]",
508
+ "tracking-[var(--bh-text-body-xs-regular-letter-spacing)]",
509
+ invalid ? "text-[var(--bh-content-danger-default)]" : "text-[var(--bh-content-subtle)]"
510
+ )}
511
+ >
512
+ <span data-slot="input-otp-helper-label" dir="auto" className="min-w-0">
513
+ {children}
514
+ </span>
515
+ </p>
516
+ )
517
+ }
518
+
519
+ function assignRef<T>(ref: React.ForwardedRef<T>, value: T | null) {
520
+ if (typeof ref === "function") {
521
+ ref(value)
522
+ } else if (ref) {
523
+ ref.current = value
524
+ }
525
+ }
526
+
527
+ function getFirstCharacter(value?: string) {
528
+ return value ? Array.from(value)[0] : undefined
529
+ }
530
+
531
+ function getSlotAriaLabel(index: number, total: number) {
532
+ return `One-time code character ${index + 1} of ${total}`
533
+ }
534
+
535
+ function groupSlots(slotCount: number, groupSize: number) {
536
+ const groups: number[][] = []
537
+
538
+ for (let index = 0; index < slotCount; index += groupSize) {
539
+ groups.push(
540
+ Array.from(
541
+ { length: Math.min(groupSize, slotCount - index) },
542
+ (_, offset) => index + offset
543
+ )
544
+ )
545
+ }
546
+
547
+ return groups
548
+ }
549
+
550
+ function hasRenderableContent(content: React.ReactNode) {
551
+ return (
552
+ content !== undefined &&
553
+ content !== null &&
554
+ content !== false &&
555
+ content !== ""
556
+ )
557
+ }
558
+
559
+ function normalizeCount(value: number | undefined, fallback: number) {
560
+ if (!Number.isFinite(value)) return fallback
561
+
562
+ return Math.max(1, Math.floor(value || fallback))
563
+ }
564
+
565
+ function normalizeValue(value: string | undefined, maxLength: number) {
566
+ return toCharacters(value || "", maxLength).join("")
567
+ }
568
+
569
+ function slotsToValue(slots: string[], maxLength: number) {
570
+ return slots.slice(0, maxLength).join("")
571
+ }
572
+
573
+ function toCharacters(value: string, maxLength: number) {
574
+ return Array.from(value.replace(/\s/g, "")).slice(0, maxLength)
575
+ }
576
+
577
+ function valueToSlots(value: string, slotCount: number) {
578
+ const characters = toCharacters(value, slotCount)
579
+
580
+ return Array.from({ length: slotCount }, (_, index) => characters[index] || "")
581
+ }
582
+
583
+ export { InputOTP, InputOTPSeparator }
584
+ export type { InputOTPProps, InputOTPState }