@wallarm-org/design-system 4.8.0-rc-feat-parser.1 → 4.8.0-rc-fix-claude-code.2

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 (176) hide show
  1. package/README.md +4 -2
  2. package/dist/components/BulkBar/index.d.ts +5 -0
  3. package/dist/components/Drawer/classes.js +1 -1
  4. package/dist/components/DropdownMenu/DropdownMenu.d.ts +0 -2
  5. package/dist/components/DropdownMenu/DropdownMenu.js +71 -84
  6. package/dist/components/DropdownMenu/DropdownMenuItemDescription.js +1 -1
  7. package/dist/components/FilterInput/hooks/useFilterInputAutocomplete/useFilterInputAutocomplete.js +1 -1
  8. package/dist/components/NotificationCenter/NotificationCenter.d.ts +20 -0
  9. package/dist/components/NotificationCenter/NotificationCenter.js +65 -0
  10. package/dist/components/NotificationCenter/NotificationCenterBody.d.ts +18 -0
  11. package/dist/components/NotificationCenter/NotificationCenterBody.js +202 -0
  12. package/dist/components/NotificationCenter/NotificationCenterContent.d.ts +5 -0
  13. package/dist/components/NotificationCenter/NotificationCenterContent.js +42 -0
  14. package/dist/components/NotificationCenter/NotificationCenterHeader.d.ts +20 -0
  15. package/dist/components/NotificationCenter/NotificationCenterHeader.js +202 -0
  16. package/dist/components/NotificationCenter/NotificationCenterItem.d.ts +26 -0
  17. package/dist/components/NotificationCenter/NotificationCenterItem.js +211 -0
  18. package/dist/components/NotificationCenter/NotificationCenterItemTime.d.ts +9 -0
  19. package/dist/components/NotificationCenter/NotificationCenterItemTime.js +148 -0
  20. package/dist/components/NotificationCenter/NotificationCenterItemTitle.d.ts +14 -0
  21. package/dist/components/NotificationCenter/NotificationCenterItemTitle.js +115 -0
  22. package/dist/components/NotificationCenter/NotificationCenterTabs.d.ts +10 -0
  23. package/dist/components/NotificationCenter/NotificationCenterTabs.js +77 -0
  24. package/dist/components/NotificationCenter/NotificationCenterTrigger.d.ts +13 -0
  25. package/dist/components/NotificationCenter/NotificationCenterTrigger.js +138 -0
  26. package/dist/components/NotificationCenter/index.d.ts +9 -0
  27. package/dist/components/NotificationCenter/index.js +9 -0
  28. package/dist/components/Overlay/Overlay.js +1 -1
  29. package/dist/components/SearchInput/SearchInput.d.ts +7 -5
  30. package/dist/components/SearchInput/SearchInput.js +119 -101
  31. package/dist/components/Select/SelectSearchInput.d.ts +1 -1
  32. package/dist/components/Table/types.d.ts +1 -1
  33. package/dist/components/Tabs/Tabs.d.ts +1 -0
  34. package/dist/components/Tabs/Tabs.js +30 -28
  35. package/dist/components/Tabs/TabsList/index.d.ts +1 -1
  36. package/dist/components/Tabs/index.d.ts +2 -2
  37. package/dist/components/Tour/TourPositioner.d.ts +3 -0
  38. package/dist/components/Tour/TourPositioner.js +4 -4
  39. package/dist/guidelines/foundations/color.md +157 -0
  40. package/dist/guidelines/foundations/focus.md +122 -0
  41. package/dist/guidelines/foundations/layering.md +131 -0
  42. package/dist/guidelines/foundations/radius-elevation.md +111 -0
  43. package/dist/guidelines/foundations/spacing.md +117 -0
  44. package/dist/guidelines/foundations/typography.md +114 -0
  45. package/dist/guidelines/patterns/app-layout.md +1567 -0
  46. package/dist/guidelines/patterns/auth-page.md +668 -0
  47. package/dist/guidelines/patterns/confirmation-dialogs.md +605 -0
  48. package/dist/guidelines/patterns/create-edit-forms.md +768 -0
  49. package/dist/guidelines/patterns/detail-drawer.md +868 -0
  50. package/dist/guidelines/patterns/empty-states.md +461 -0
  51. package/dist/guidelines/patterns/entity-table.md +533 -0
  52. package/dist/guidelines/patterns/feedback-toasts.md +493 -0
  53. package/dist/guidelines/patterns/filtering.md +630 -0
  54. package/dist/guidelines/patterns/resource-list-page.md +558 -0
  55. package/dist/guidelines/patterns/settings-page.md +752 -0
  56. package/dist/guidelines/rules.md +25 -0
  57. package/dist/index.d.ts +2 -3
  58. package/dist/index.js +1 -2
  59. package/dist/metadata/components.json +12431 -9208
  60. package/dist/metadata/guidelines.json +1705 -0
  61. package/dist/theme/typography.css +5 -0
  62. package/dist/utils/formatDateTime.d.ts +6 -0
  63. package/dist/utils/formatDateTime.js +13 -1
  64. package/package.json +6 -4
  65. package/dist/components/Rules/PointSelector/KeyboardShortcutsDialog.d.ts +0 -14
  66. package/dist/components/Rules/PointSelector/KeyboardShortcutsDialog.js +0 -209
  67. package/dist/components/Rules/PointSelector/MatchStep.d.ts +0 -15
  68. package/dist/components/Rules/PointSelector/MatchStep.js +0 -186
  69. package/dist/components/Rules/PointSelector/MenuFooterHints.d.ts +0 -16
  70. package/dist/components/Rules/PointSelector/MenuFooterHints.js +0 -177
  71. package/dist/components/Rules/PointSelector/PointPreview.d.ts +0 -10
  72. package/dist/components/Rules/PointSelector/PointPreview.js +0 -88
  73. package/dist/components/Rules/PointSelector/PointSelector.d.ts +0 -17
  74. package/dist/components/Rules/PointSelector/PointSelector.js +0 -937
  75. package/dist/components/Rules/PointSelector/PointSelectorEmptyState.d.ts +0 -12
  76. package/dist/components/Rules/PointSelector/PointSelectorEmptyState.js +0 -173
  77. package/dist/components/Rules/PointSelector/PointSelectorError.d.ts +0 -31
  78. package/dist/components/Rules/PointSelector/PointSelectorError.js +0 -275
  79. package/dist/components/Rules/PointSelector/PointSelectorInput.d.ts +0 -20
  80. package/dist/components/Rules/PointSelector/PointSelectorInput.js +0 -130
  81. package/dist/components/Rules/PointSelector/PointSelectorMenu.d.ts +0 -31
  82. package/dist/components/Rules/PointSelector/PointSelectorMenu.js +0 -317
  83. package/dist/components/Rules/PointSelector/PointSelectorSkeleton.d.ts +0 -8
  84. package/dist/components/Rules/PointSelector/PointSelectorSkeleton.js +0 -73
  85. package/dist/components/Rules/PointSelector/SampleRequest.d.ts +0 -14
  86. package/dist/components/Rules/PointSelector/SampleRequest.js +0 -116
  87. package/dist/components/Rules/PointSelector/StepMenu.d.ts +0 -40
  88. package/dist/components/Rules/PointSelector/StepMenu.js +0 -210
  89. package/dist/components/Rules/PointSelector/VersionWarning.d.ts +0 -26
  90. package/dist/components/Rules/PointSelector/VersionWarning.js +0 -231
  91. package/dist/components/Rules/PointSelector/WhereBar.d.ts +0 -48
  92. package/dist/components/Rules/PointSelector/WhereBar.js +0 -263
  93. package/dist/components/Rules/PointSelector/classes.d.ts +0 -28
  94. package/dist/components/Rules/PointSelector/classes.js +0 -22
  95. package/dist/components/Rules/PointSelector/index.d.ts +0 -20
  96. package/dist/components/Rules/PointSelector/index.js +0 -18
  97. package/dist/components/Rules/PointSelector/liftLayer.d.ts +0 -8
  98. package/dist/components/Rules/PointSelector/liftLayer.js +0 -4
  99. package/dist/components/Rules/PointSelector/sampleValue.d.ts +0 -6
  100. package/dist/components/Rules/PointSelector/sampleValue.js +0 -51
  101. package/dist/components/Rules/PointSelector/sdkBridge.d.ts +0 -508
  102. package/dist/components/Rules/PointSelector/sdkBridge.js +0 -339
  103. package/dist/components/Rules/PointSelector/types.d.ts +0 -304
  104. package/dist/components/Rules/PointSelector/types.js +0 -0
  105. package/dist/components/Rules/PointSelector/usePointSelector.d.ts +0 -161
  106. package/dist/components/Rules/PointSelector/usePointSelector.js +0 -1088
  107. package/dist/components/Rules/RuleBuilder/ActionEditor/ActionEditor.d.ts +0 -28
  108. package/dist/components/Rules/RuleBuilder/ActionEditor/ActionEditor.js +0 -208
  109. package/dist/components/Rules/RuleBuilder/ActionEditor/ActionFields.d.ts +0 -23
  110. package/dist/components/Rules/RuleBuilder/ActionEditor/ActionFields.js +0 -950
  111. package/dist/components/Rules/RuleBuilder/ActionEditor/ActionTargetPicker.d.ts +0 -21
  112. package/dist/components/Rules/RuleBuilder/ActionEditor/ActionTargetPicker.js +0 -110
  113. package/dist/components/Rules/RuleBuilder/ActionEditor/ActionTypeSelect.d.ts +0 -20
  114. package/dist/components/Rules/RuleBuilder/ActionEditor/ActionTypeSelect.js +0 -31
  115. package/dist/components/Rules/RuleBuilder/ActionEditor/AttackTypeField.d.ts +0 -23
  116. package/dist/components/Rules/RuleBuilder/ActionEditor/AttackTypeField.js +0 -131
  117. package/dist/components/Rules/RuleBuilder/ActionEditor/classes.d.ts +0 -17
  118. package/dist/components/Rules/RuleBuilder/ActionEditor/classes.js +0 -14
  119. package/dist/components/Rules/RuleBuilder/ActionEditor/index.d.ts +0 -6
  120. package/dist/components/Rules/RuleBuilder/ActionEditor/index.js +0 -6
  121. package/dist/components/Rules/RuleBuilder/ConditionTree/AddConditionMenu.d.ts +0 -24
  122. package/dist/components/Rules/RuleBuilder/ConditionTree/AddConditionMenu.js +0 -245
  123. package/dist/components/Rules/RuleBuilder/ConditionTree/AttackCondition.d.ts +0 -15
  124. package/dist/components/Rules/RuleBuilder/ConditionTree/AttackCondition.js +0 -691
  125. package/dist/components/Rules/RuleBuilder/ConditionTree/ConditionCard.d.ts +0 -19
  126. package/dist/components/Rules/RuleBuilder/ConditionTree/ConditionCard.js +0 -72
  127. package/dist/components/Rules/RuleBuilder/ConditionTree/ConditionTree.d.ts +0 -27
  128. package/dist/components/Rules/RuleBuilder/ConditionTree/ConditionTree.js +0 -407
  129. package/dist/components/Rules/RuleBuilder/ConditionTree/FieldCondition.d.ts +0 -14
  130. package/dist/components/Rules/RuleBuilder/ConditionTree/FieldCondition.js +0 -269
  131. package/dist/components/Rules/RuleBuilder/ConditionTree/GroupCondition.d.ts +0 -25
  132. package/dist/components/Rules/RuleBuilder/ConditionTree/GroupCondition.js +0 -99
  133. package/dist/components/Rules/RuleBuilder/ConditionTree/SampleCondition.d.ts +0 -14
  134. package/dist/components/Rules/RuleBuilder/ConditionTree/SampleCondition.js +0 -118
  135. package/dist/components/Rules/RuleBuilder/ConditionTree/SignalCondition.d.ts +0 -14
  136. package/dist/components/Rules/RuleBuilder/ConditionTree/SignalCondition.js +0 -446
  137. package/dist/components/Rules/RuleBuilder/ConditionTree/TagCondition.d.ts +0 -14
  138. package/dist/components/Rules/RuleBuilder/ConditionTree/TagCondition.js +0 -266
  139. package/dist/components/Rules/RuleBuilder/ConditionTree/classes.d.ts +0 -35
  140. package/dist/components/Rules/RuleBuilder/ConditionTree/classes.js +0 -57
  141. package/dist/components/Rules/RuleBuilder/ConditionTree/index.d.ts +0 -15
  142. package/dist/components/Rules/RuleBuilder/ConditionTree/index.js +0 -10
  143. package/dist/components/Rules/RuleBuilder/RuleBuilder.d.ts +0 -67
  144. package/dist/components/Rules/RuleBuilder/RuleBuilder.js +0 -366
  145. package/dist/components/Rules/RuleBuilder/Summary/ActionSummary.d.ts +0 -32
  146. package/dist/components/Rules/RuleBuilder/Summary/ActionSummary.js +0 -420
  147. package/dist/components/Rules/RuleBuilder/Summary/ConditionSummary.d.ts +0 -27
  148. package/dist/components/Rules/RuleBuilder/Summary/ConditionSummary.js +0 -446
  149. package/dist/components/Rules/RuleBuilder/Summary/index.d.ts +0 -7
  150. package/dist/components/Rules/RuleBuilder/Summary/index.js +0 -2
  151. package/dist/components/Rules/RuleBuilder/classes.d.ts +0 -19
  152. package/dist/components/Rules/RuleBuilder/classes.js +0 -18
  153. package/dist/components/Rules/RuleBuilder/index.d.ts +0 -55
  154. package/dist/components/Rules/RuleBuilder/index.js +0 -11
  155. package/dist/components/Rules/RuleBuilder/models/actionModel.d.ts +0 -31
  156. package/dist/components/Rules/RuleBuilder/models/actionModel.js +0 -276
  157. package/dist/components/Rules/RuleBuilder/models/conditionModel.d.ts +0 -95
  158. package/dist/components/Rules/RuleBuilder/models/conditionModel.js +0 -418
  159. package/dist/components/Rules/RuleBuilder/models/index.d.ts +0 -3
  160. package/dist/components/Rules/RuleBuilder/models/index.js +0 -3
  161. package/dist/components/Rules/RuleBuilder/models/validation.d.ts +0 -176
  162. package/dist/components/Rules/RuleBuilder/models/validation.js +0 -242
  163. package/dist/components/Rules/RuleBuilder/shared/ChoiceSelect.d.ts +0 -27
  164. package/dist/components/Rules/RuleBuilder/shared/ChoiceSelect.js +0 -92
  165. package/dist/components/Rules/RuleBuilder/shared/index.d.ts +0 -1
  166. package/dist/components/Rules/RuleBuilder/shared/index.js +0 -1
  167. package/dist/components/Rules/RuleBuilder/types.d.ts +0 -384
  168. package/dist/components/Rules/RuleBuilder/types.js +0 -0
  169. package/dist/components/Rules/RuleBuilder/utils/constants.d.ts +0 -65
  170. package/dist/components/Rules/RuleBuilder/utils/constants.js +0 -356
  171. package/dist/components/Rules/RuleBuilder/utils/extractBindings.d.ts +0 -48
  172. package/dist/components/Rules/RuleBuilder/utils/extractBindings.js +0 -42
  173. package/dist/components/Rules/RuleBuilder/utils/helpers.d.ts +0 -92
  174. package/dist/components/Rules/RuleBuilder/utils/helpers.js +0 -54
  175. package/dist/components/Rules/RuleBuilder/utils/index.d.ts +0 -2
  176. package/dist/components/Rules/RuleBuilder/utils/index.js +0 -2
@@ -0,0 +1,768 @@
1
+ ---
2
+ title: Create and edit forms
3
+ description: Use when building a form that creates or edits an entity, and you must choose between a Dialog, a Drawer with Timeline sections, or a Drawer with a Stepper.
4
+ components: [Dialog, Drawer, Field, Input, Textarea, Timeline, Stepper, Button, VStack, Tooltip, Alert, Table, InlineEdit, Attribute, Toaster]
5
+ keywords: [form, create, edit, new, add, wizard, steps, stepper, multi-step, sections, timeline, drawer form, modal form, dialog form, field, label, required, optional, validation, error, submit, cancel, unsaved changes]
6
+ order: 60
7
+ ---
8
+
9
+ # Create and edit forms
10
+
11
+ Form size picks the container.
12
+
13
+ ## When to use
14
+
15
+ | Need | Use | Not |
16
+ | --- | --- | --- |
17
+ | Up to 6 fields, one concern (create user) | `Dialog` with no `width` (560) | A `Drawer` for three inputs |
18
+ | Dependent sections seen together (create provider) | `Drawer width={700}` + `Timeline` with numbered sections | A `Stepper` hiding sections |
19
+ | Gated parts, each needs the previous (create policy) | `Drawer` with no `width` (640) + `Stepper` | One long `Timeline` with 20 fields |
20
+ | Pick many rows ("Add users to group") | `Dialog width={960}` with a selectable `Table` | A 200-item multi-select |
21
+ | Edit one value on a detail view | `InlineEdit` on the `Attribute` | A drawer for one field |
22
+ | Independent values saved one by one | [Settings page](settings-page.md) | A drawer opened from the page |
23
+ | A yes/no before an action | [Confirmation dialogs](confirmation-dialogs.md) | A form dialog with no fields |
24
+
25
+ - Edit uses the same container as create.
26
+ - There is no `Form`, `FormDialog`, `FormDrawer`, `Wizard`, vertical `Stepper` or form-level validation component.
27
+
28
+ ## Rules
29
+
30
+ ### Container and layout
31
+
32
+ - Wrap body and footer (or the whole `Stepper`) in `<form className='flex min-h-0 flex-1 flex-col'>` so Enter submits.
33
+ - Size with `width` (400 to 1130): `Dialog` 560 default, 400/960 presets; `Drawer` 640 default, `700` for Timeline forms. There is no `size` prop or exported size constant.
34
+ - Bodies own their padding. **Never** add `p-*`, `px-*` or `py-*` around their content.
35
+ - **Never** pass `className` to `DrawerHeader`, `DrawerBody`, `DrawerFooter`, their `Dialog*` aliases, or `Field`. Size the control or grid cell instead.
36
+ - **Never** add a close X; the header has one.
37
+ - Space fields with `<VStack gap={24}>` in a dialog and `<VStack gap={12}>` in a drawer section. Not `FieldGroup` (fixed 16px). There is no `gap` prop on `Field` or `TimelineContent`.
38
+ - **Never** style `FieldGroup`, `FieldLabel` or `FieldDescription` with `className`; it is ignored.
39
+ - Add `className='py-16'` to `StepperContent`.
40
+ - If two related fields are short (name and ID, port and protocol), put them in `grid grid-cols-2 gap-12`. URLs, secrets and free text get full width.
41
+ - Number `Timeline` sections in `TimelineIndicator`; title them with a noun phrase.
42
+ - `Stepper` wraps `DrawerBody` and `DrawerFooter`; its Prev/Next triggers work only inside it. Give it `className='flex min-h-0 flex-1 flex-col'`.
43
+ - Inside `Stepper`: `StepperList aria-label='…'` (one `StepperItem index status` per step), then `DrawerBody` holding one `StepperContent index` per step, then `DrawerFooter`.
44
+ - Max 6 `Stepper` steps. Vertical numbered sections are a `Timeline`, even if Figma says "stepper".
45
+
46
+ ### Fields
47
+
48
+ - Wrap every control in `Field`; **never** a bare `<label>`.
49
+ - Order the parts: `FieldLabel` (with `FieldIndicator`), `FieldDescription`, control, `FieldError`.
50
+ - Put `required` on `Field` and `FieldIndicator` in every label (`*` or "(Optional)"). **Never** type "(optional)" yourself.
51
+ - Pass `error` and `disabled` to the control itself. `Field invalid` and `Field disabled` do not reach `Input` or `Textarea`.
52
+ - One helper line at most, stating the consequence.
53
+ - Show the provider icon in the select option and trigger.
54
+
55
+ ### Buttons and copy
56
+
57
+ | Element | Write | Not |
58
+ | --- | --- | --- |
59
+ | Title | "Create identity provider" / "Edit identity provider" | "New", "Provider settings" |
60
+ | Submit | Title's verb + entity; edit: "Save changes" | "Submit", "OK", "Update" |
61
+ | Stepper | "Next"; last step: "Create policy" | "Continue →", "Finish" |
62
+ | Description | What happens after submit: "We send an invitation link to this email." | A restatement of the title |
63
+ | Cancel | "Cancel" | "Close", "Discard" |
64
+ | Error | "Enter a client ID." | "Invalid", "Field is required!" |
65
+
66
+ - Submit is the default primary `Button type='submit'`, last on the right. Cancel is `variant='ghost' color='neutral'` in `DialogClose`/`DrawerClose asChild`.
67
+ - Omit `size` on footer buttons.
68
+ - **Never** put submit in the header or add a second primary.
69
+ - Stepper footer: Cancel left; Back (`variant='outline' color='neutral'`) and Next right. Back disables itself on step 1; don't wire `disabled`.
70
+ - On the last step, render submit instead of `StepperNextTrigger` (disabled there).
71
+
72
+ ### Behavior
73
+
74
+ - Call `event.preventDefault()`. Close only after success.
75
+ - Edit: prefill fields; disable submit until a change.
76
+ - Show `FieldError` only after blur or submit.
77
+ - `Stepper` never blocks steps. Set `status='danger'` on steps with errors, `'completed'` on valid ones. There is no `linear`, `isStepValid` or `orientation` prop.
78
+
79
+ ## Examples
80
+
81
+ A dialog form with a 24px field stack.
82
+
83
+ Submit stays disabled until the required fields are filled, the email error shows only after
84
+ blur or submit, and a successful request closes the dialog, then shows a toast.
85
+
86
+ ```tsx story=CreateInDialog
87
+ import { type ChangeEvent, type FormEvent, useState } from 'react';
88
+ import { Button } from '@wallarm-org/design-system/Button';
89
+ import { Dialog, DialogBody, DialogClose, DialogContent, DialogFooter, DialogHeader, DialogTitle, DialogTrigger } from '@wallarm-org/design-system/Dialog';
90
+ import { Field, FieldDescription, FieldError, FieldIndicator, FieldLabel } from '@wallarm-org/design-system/Field';
91
+ import { Input } from '@wallarm-org/design-system/Input';
92
+ import { VStack } from '@wallarm-org/design-system/Stack';
93
+ import { Textarea } from '@wallarm-org/design-system/Textarea';
94
+ import { useToast } from '@wallarm-org/design-system/Toast';
95
+
96
+ export const CreateInDialog = () => {
97
+ const toast = useToast();
98
+ const [open, setOpen] = useState(false);
99
+ const [name, setName] = useState('');
100
+ const [email, setEmail] = useState('');
101
+ const [message, setMessage] = useState('');
102
+ const [emailTouched, setEmailTouched] = useState(false);
103
+ const [pending, setPending] = useState(false);
104
+
105
+ const emailInvalid = emailTouched && !EMAIL_PATTERN.test(email.trim());
106
+ const canSubmit = name.trim() !== '' && email.trim() !== '';
107
+
108
+ const handleOpenChange = (next: boolean) => {
109
+ setOpen(next);
110
+ if (!next) {
111
+ setName('');
112
+ setEmail('');
113
+ setMessage('');
114
+ setEmailTouched(false);
115
+ }
116
+ };
117
+ const handleNameChange = (event: ChangeEvent<HTMLInputElement>) => setName(event.target.value);
118
+ const handleEmailChange = (event: ChangeEvent<HTMLInputElement>) => setEmail(event.target.value);
119
+ const handleEmailBlur = () => setEmailTouched(true);
120
+ const handleMessageChange = (event: ChangeEvent<HTMLTextAreaElement>) =>
121
+ setMessage(event.target.value);
122
+
123
+ const handleSubmit = async (event: FormEvent) => {
124
+ event.preventDefault();
125
+ setEmailTouched(true);
126
+ if (!EMAIL_PATTERN.test(email.trim())) return;
127
+ setPending(true);
128
+ await saveRequest();
129
+ setPending(false);
130
+ handleOpenChange(false);
131
+ toast.create({ id: 'user-created', title: 'User created', type: 'success' });
132
+ };
133
+
134
+ return (
135
+ <div className='p-24'>
136
+ <Dialog open={open} onOpenChange={handleOpenChange} data-testid='create-user-dialog'>
137
+ <DialogTrigger asChild>
138
+ <Button>Create user</Button>
139
+ </DialogTrigger>
140
+ <DialogContent>
141
+ <DialogHeader>
142
+ <DialogTitle>Create user</DialogTitle>
143
+ </DialogHeader>
144
+ <form onSubmit={handleSubmit} className='flex min-h-0 flex-1 flex-col'>
145
+ <DialogBody>
146
+ <VStack gap={24}>
147
+ <Field required>
148
+ <FieldLabel>
149
+ Full name
150
+ <FieldIndicator />
151
+ </FieldLabel>
152
+ <Input
153
+ value={name}
154
+ onChange={handleNameChange}
155
+ placeholder='Maria Lopez'
156
+ data-testid='create-user-name'
157
+ />
158
+ </Field>
159
+ <Field required data-testid='create-user-email-field'>
160
+ <FieldLabel>
161
+ Email
162
+ <FieldIndicator />
163
+ </FieldLabel>
164
+ <FieldDescription>We send an invitation link to this email.</FieldDescription>
165
+ <Input
166
+ type='email'
167
+ value={email}
168
+ error={emailInvalid}
169
+ onChange={handleEmailChange}
170
+ onBlur={handleEmailBlur}
171
+ placeholder='maria.lopez@acme-bank.com'
172
+ data-testid='create-user-email'
173
+ />
174
+ {emailInvalid && <FieldError>Enter an email address.</FieldError>}
175
+ </Field>
176
+ <Field>
177
+ <FieldLabel>
178
+ Message
179
+ <FieldIndicator />
180
+ </FieldLabel>
181
+ <Textarea
182
+ value={message}
183
+ onChange={handleMessageChange}
184
+ placeholder='Added to the SOC on-call rotation.'
185
+ />
186
+ </Field>
187
+ </VStack>
188
+ </DialogBody>
189
+ <DialogFooter>
190
+ <DialogClose asChild>
191
+ <Button variant='ghost' color='neutral'>
192
+ Cancel
193
+ </Button>
194
+ </DialogClose>
195
+ <Button
196
+ type='submit'
197
+ disabled={!canSubmit}
198
+ loading={pending}
199
+ data-testid='create-user-submit'
200
+ >
201
+ Create user
202
+ </Button>
203
+ </DialogFooter>
204
+ </form>
205
+ </DialogContent>
206
+ </Dialog>
207
+ </div>
208
+ );
209
+ };
210
+ ```
211
+
212
+ An invalid field: `error` goes on the control, `FieldError` renders only while invalid.
213
+
214
+ Shown after blur: the description stays above the control, the error line below it.
215
+
216
+ ```tsx story=InvalidField
217
+ import { Field, FieldDescription, FieldError, FieldIndicator, FieldLabel } from '@wallarm-org/design-system/Field';
218
+ import { Input } from '@wallarm-org/design-system/Input';
219
+
220
+ export const InvalidField = () => (
221
+ <div className='w-400 p-24'>
222
+ <Field required data-testid='invalid-email-field'>
223
+ <FieldLabel>
224
+ Email
225
+ <FieldIndicator />
226
+ </FieldLabel>
227
+ <FieldDescription>The invitation link expires in 7 days.</FieldDescription>
228
+ <Input type='email' defaultValue='maria.lopez' error />
229
+ <FieldError>Enter an email address.</FieldError>
230
+ </Field>
231
+ </div>
232
+ );
233
+ ```
234
+
235
+ Edit reuses the create container. A field fixed after create is disabled, with a tooltip on a wrapping `span`.
236
+
237
+ Fields are prefilled, and "Save changes" stays disabled until a value changes.
238
+
239
+ ```tsx story=EditInDialog
240
+ import { type ChangeEvent, type FormEvent, useState } from 'react';
241
+ import { Button } from '@wallarm-org/design-system/Button';
242
+ import { Dialog, DialogBody, DialogClose, DialogContent, DialogFooter, DialogHeader, DialogTitle, DialogTrigger } from '@wallarm-org/design-system/Dialog';
243
+ import { Field, FieldIndicator, FieldLabel } from '@wallarm-org/design-system/Field';
244
+ import { Input } from '@wallarm-org/design-system/Input';
245
+ import { VStack } from '@wallarm-org/design-system/Stack';
246
+ import { useToast } from '@wallarm-org/design-system/Toast';
247
+ import { Tooltip, TooltipContent, TooltipTrigger } from '@wallarm-org/design-system/Tooltip';
248
+
249
+ export const EditInDialog = () => {
250
+ const toast = useToast();
251
+ const [open, setOpen] = useState(false);
252
+ const [name, setName] = useState(USER.name);
253
+ const [email, setEmail] = useState(USER.email);
254
+ const [pending, setPending] = useState(false);
255
+
256
+ const dirty = name !== USER.name || email !== USER.email;
257
+ const canSubmit = dirty && name.trim() !== '' && EMAIL_PATTERN.test(email.trim());
258
+
259
+ const handleOpenChange = (next: boolean) => {
260
+ setOpen(next);
261
+ if (!next) {
262
+ setName(USER.name);
263
+ setEmail(USER.email);
264
+ }
265
+ };
266
+ const handleNameChange = (event: ChangeEvent<HTMLInputElement>) => setName(event.target.value);
267
+ const handleEmailChange = (event: ChangeEvent<HTMLInputElement>) => setEmail(event.target.value);
268
+
269
+ const handleSubmit = async (event: FormEvent) => {
270
+ event.preventDefault();
271
+ setPending(true);
272
+ await saveRequest();
273
+ setPending(false);
274
+ setOpen(false);
275
+ toast.create({ id: 'user-updated', title: 'User updated', type: 'success' });
276
+ };
277
+
278
+ return (
279
+ <div className='p-24'>
280
+ <Dialog open={open} onOpenChange={handleOpenChange} data-testid='edit-user-dialog'>
281
+ <DialogTrigger asChild>
282
+ <Button variant='outline' color='neutral'>
283
+ Edit user
284
+ </Button>
285
+ </DialogTrigger>
286
+ <DialogContent>
287
+ <DialogHeader>
288
+ <DialogTitle>Edit user</DialogTitle>
289
+ </DialogHeader>
290
+ <form onSubmit={handleSubmit} className='flex min-h-0 flex-1 flex-col'>
291
+ <DialogBody>
292
+ <VStack gap={24}>
293
+ <Field required>
294
+ <FieldLabel>
295
+ User ID
296
+ <FieldIndicator />
297
+ </FieldLabel>
298
+ <Tooltip>
299
+ <TooltipTrigger asChild>
300
+ <span>
301
+ <Input value={USER.id} disabled data-testid='edit-user-id' />
302
+ </span>
303
+ </TooltipTrigger>
304
+ <TooltipContent>The ID can't change after the user is created.</TooltipContent>
305
+ </Tooltip>
306
+ </Field>
307
+ <Field required>
308
+ <FieldLabel>
309
+ Full name
310
+ <FieldIndicator />
311
+ </FieldLabel>
312
+ <Input value={name} onChange={handleNameChange} data-testid='edit-user-name' />
313
+ </Field>
314
+ <Field required>
315
+ <FieldLabel>
316
+ Email
317
+ <FieldIndicator />
318
+ </FieldLabel>
319
+ <Input type='email' value={email} onChange={handleEmailChange} />
320
+ </Field>
321
+ </VStack>
322
+ </DialogBody>
323
+ <DialogFooter>
324
+ <DialogClose asChild>
325
+ <Button variant='ghost' color='neutral'>
326
+ Cancel
327
+ </Button>
328
+ </DialogClose>
329
+ <Button
330
+ type='submit'
331
+ disabled={!canSubmit}
332
+ loading={pending}
333
+ data-testid='edit-user-submit'
334
+ >
335
+ Save changes
336
+ </Button>
337
+ </DialogFooter>
338
+ </form>
339
+ </DialogContent>
340
+ </Dialog>
341
+ </div>
342
+ );
343
+ };
344
+ ```
345
+
346
+ Numbered `Timeline` sections, each a 12px field stack, inside a `Drawer width={700}` body.
347
+
348
+ Short related fields share a two-column row; URLs and secrets get full width. "Test
349
+ connection" reports in its section with an `Alert`, never a toast.
350
+
351
+ ```tsx story=CreateInDrawerWithSections
352
+ import { type ChangeEvent, type FormEvent, useState } from 'react';
353
+ import { Alert, AlertContent, AlertDescription, AlertIcon, AlertTitle } from '@wallarm-org/design-system/Alert';
354
+ import { Button } from '@wallarm-org/design-system/Button';
355
+ import { Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger } from '@wallarm-org/design-system/Drawer';
356
+ import { Field, FieldDescription, FieldIndicator, FieldLabel } from '@wallarm-org/design-system/Field';
357
+ import { Input } from '@wallarm-org/design-system/Input';
358
+ import { VStack } from '@wallarm-org/design-system/Stack';
359
+ import { Timeline, TimelineConnector, TimelineContent, TimelineIndicator, TimelineItem, TimelineSeparator, TimelineTitle } from '@wallarm-org/design-system/Timeline';
360
+ import { useToast } from '@wallarm-org/design-system/Toast';
361
+
362
+ export const CreateInDrawerWithSections = () => {
363
+ const toast = useToast();
364
+ const [open, setOpen] = useState(false);
365
+ const [name, setName] = useState('');
366
+ const [slug, setSlug] = useState('');
367
+ const [domain, setDomain] = useState('');
368
+ const [clientId, setClientId] = useState('');
369
+ const [clientSecret, setClientSecret] = useState('');
370
+ const [testing, setTesting] = useState(false);
371
+ const [connected, setConnected] = useState(false);
372
+ const [pending, setPending] = useState(false);
373
+
374
+ const credentialsFilled = domain.trim() !== '' && clientId.trim() !== '' && clientSecret !== '';
375
+ const canSubmit = name.trim() !== '' && slug.trim() !== '' && credentialsFilled;
376
+
377
+ const handleNameChange = (event: ChangeEvent<HTMLInputElement>) => setName(event.target.value);
378
+ const handleSlugChange = (event: ChangeEvent<HTMLInputElement>) => setSlug(event.target.value);
379
+ const handleDomainChange = (event: ChangeEvent<HTMLInputElement>) => {
380
+ setDomain(event.target.value);
381
+ setConnected(false);
382
+ };
383
+ const handleClientIdChange = (event: ChangeEvent<HTMLInputElement>) => {
384
+ setClientId(event.target.value);
385
+ setConnected(false);
386
+ };
387
+ const handleClientSecretChange = (event: ChangeEvent<HTMLInputElement>) => {
388
+ setClientSecret(event.target.value);
389
+ setConnected(false);
390
+ };
391
+
392
+ const handleTestConnection = async () => {
393
+ setTesting(true);
394
+ await saveRequest();
395
+ setTesting(false);
396
+ setConnected(true);
397
+ };
398
+
399
+ const handleSubmit = async (event: FormEvent) => {
400
+ event.preventDefault();
401
+ setPending(true);
402
+ await saveRequest();
403
+ setPending(false);
404
+ setOpen(false);
405
+ toast.create({ id: 'provider-created', title: 'Identity provider created', type: 'success' });
406
+ };
407
+
408
+ return (
409
+ <div className='p-24'>
410
+ <Drawer open={open} onOpenChange={setOpen} width={700} data-testid='create-provider-drawer'>
411
+ <DrawerTrigger asChild>
412
+ <Button>Create identity provider</Button>
413
+ </DrawerTrigger>
414
+ <DrawerContent>
415
+ <DrawerHeader>
416
+ <DrawerTitle>Create identity provider</DrawerTitle>
417
+ </DrawerHeader>
418
+ <form onSubmit={handleSubmit} className='flex min-h-0 flex-1 flex-col'>
419
+ <DrawerBody>
420
+ <Timeline data-testid='create-provider-sections'>
421
+ <TimelineItem>
422
+ <TimelineConnector>
423
+ <TimelineIndicator>1</TimelineIndicator>
424
+ <TimelineSeparator />
425
+ </TimelineConnector>
426
+ <TimelineContent>
427
+ <TimelineTitle>Provider details</TimelineTitle>
428
+ <VStack gap={12}>
429
+ <div className='grid grid-cols-2 gap-12'>
430
+ <Field required>
431
+ <FieldLabel>
432
+ Name
433
+ <FieldIndicator />
434
+ </FieldLabel>
435
+ <Input value={name} onChange={handleNameChange} placeholder='Okta SSO' />
436
+ </Field>
437
+ <Field required>
438
+ <FieldLabel>
439
+ Provider ID
440
+ <FieldIndicator />
441
+ </FieldLabel>
442
+ <Input value={slug} onChange={handleSlugChange} placeholder='okta-sso' />
443
+ </Field>
444
+ </div>
445
+ </VStack>
446
+ </TimelineContent>
447
+ </TimelineItem>
448
+ <TimelineItem>
449
+ <TimelineConnector>
450
+ <TimelineIndicator>2</TimelineIndicator>
451
+ <TimelineSeparator />
452
+ </TimelineConnector>
453
+ <TimelineContent>
454
+ <TimelineTitle>Okta connection</TimelineTitle>
455
+ <VStack gap={12}>
456
+ <Field required>
457
+ <FieldLabel>
458
+ Okta domain
459
+ <FieldIndicator />
460
+ </FieldLabel>
461
+ <Input
462
+ value={domain}
463
+ onChange={handleDomainChange}
464
+ placeholder='https://acme-bank.okta.com'
465
+ data-testid='create-provider-domain'
466
+ />
467
+ </Field>
468
+ <Field required>
469
+ <FieldLabel>
470
+ Client ID
471
+ <FieldIndicator />
472
+ </FieldLabel>
473
+ <Input
474
+ value={clientId}
475
+ onChange={handleClientIdChange}
476
+ data-testid='create-provider-client-id'
477
+ />
478
+ </Field>
479
+ <Field required>
480
+ <FieldLabel>
481
+ Client secret
482
+ <FieldIndicator />
483
+ </FieldLabel>
484
+ <FieldDescription>
485
+ Stored encrypted; you can't view it again.
486
+ </FieldDescription>
487
+ <Input
488
+ type='password'
489
+ value={clientSecret}
490
+ onChange={handleClientSecretChange}
491
+ data-testid='create-provider-client-secret'
492
+ />
493
+ </Field>
494
+ <div>
495
+ <Button
496
+ variant='outline'
497
+ color='neutral'
498
+ disabled={!credentialsFilled}
499
+ loading={testing}
500
+ onClick={handleTestConnection}
501
+ data-testid='create-provider-test'
502
+ >
503
+ Test connection
504
+ </Button>
505
+ </div>
506
+ {connected && (
507
+ <Alert color='success' data-testid='create-provider-test-result'>
508
+ <AlertIcon />
509
+ <AlertContent>
510
+ <AlertTitle>Connected to Okta</AlertTitle>
511
+ <AlertDescription>
512
+ Wallarm reached acme-bank.okta.com with these credentials.
513
+ </AlertDescription>
514
+ </AlertContent>
515
+ </Alert>
516
+ )}
517
+ </VStack>
518
+ </TimelineContent>
519
+ </TimelineItem>
520
+ </Timeline>
521
+ </DrawerBody>
522
+ <DrawerFooter>
523
+ <DrawerClose asChild>
524
+ <Button variant='ghost' color='neutral'>
525
+ Cancel
526
+ </Button>
527
+ </DrawerClose>
528
+ <Button
529
+ type='submit'
530
+ disabled={!canSubmit}
531
+ loading={pending}
532
+ data-testid='create-provider-submit'
533
+ >
534
+ Create identity provider
535
+ </Button>
536
+ </DrawerFooter>
537
+ </form>
538
+ </DrawerContent>
539
+ </Drawer>
540
+ </div>
541
+ );
542
+ };
543
+ ```
544
+
545
+ A `Stepper` wrapping body and footer; submit replaces Next on the last step.
546
+
547
+ Cancel sits left, Back and Next right. Steps never block: a step left with empty required
548
+ fields turns `danger`, a filled one `completed`.
549
+
550
+ ```tsx story=CreateInDrawerWithSteps
551
+ import { type ChangeEvent, type FormEvent, useState } from 'react';
552
+ import { Button } from '@wallarm-org/design-system/Button';
553
+ import { Drawer, DrawerBody, DrawerClose, DrawerContent, DrawerFooter, DrawerFooterControls, DrawerHeader, DrawerTitle, DrawerTrigger } from '@wallarm-org/design-system/Drawer';
554
+ import { Field, FieldDescription, FieldIndicator, FieldLabel } from '@wallarm-org/design-system/Field';
555
+ import { Input } from '@wallarm-org/design-system/Input';
556
+ import { VStack } from '@wallarm-org/design-system/Stack';
557
+ import { Stepper, StepperContent, StepperIndicator, StepperItem, type StepperItemStatus, StepperList, StepperNextTrigger, StepperPrevTrigger, StepperSeparator, StepperTitle, StepperTrigger } from '@wallarm-org/design-system/Stepper';
558
+ import { Textarea } from '@wallarm-org/design-system/Textarea';
559
+ import { useToast } from '@wallarm-org/design-system/Toast';
560
+
561
+ export const CreateInDrawerWithSteps = () => {
562
+ const toast = useToast();
563
+ const [open, setOpen] = useState(false);
564
+ const [step, setStep] = useState(0);
565
+ const [name, setName] = useState('');
566
+ const [description, setDescription] = useState('');
567
+ const [host, setHost] = useState('');
568
+ const [path, setPath] = useState('');
569
+ const [rps, setRps] = useState('');
570
+ const [pending, setPending] = useState(false);
571
+ const [visited, setVisited] = useState<number[]>([]);
572
+
573
+ const valid = [name.trim() !== '', host.trim() !== '' && path.trim() !== '', rps.trim() !== ''];
574
+ const statuses = valid.map<StepperItemStatus>((ok, i) =>
575
+ !visited.includes(i) ? 'upcoming' : ok ? 'completed' : 'danger',
576
+ );
577
+ const last = step === POLICY_STEPS.length - 1;
578
+
579
+ const handleStepChange = ({ step: next }: { step: number }) => {
580
+ setVisited(prev => (prev.includes(step) ? prev : [...prev, step]));
581
+ setStep(next);
582
+ };
583
+ const handleNameChange = (event: ChangeEvent<HTMLInputElement>) => setName(event.target.value);
584
+ const handleDescriptionChange = (event: ChangeEvent<HTMLTextAreaElement>) =>
585
+ setDescription(event.target.value);
586
+ const handleHostChange = (event: ChangeEvent<HTMLInputElement>) => setHost(event.target.value);
587
+ const handlePathChange = (event: ChangeEvent<HTMLInputElement>) => setPath(event.target.value);
588
+ const handleRpsChange = (event: ChangeEvent<HTMLInputElement>) => setRps(event.target.value);
589
+
590
+ const handleSubmit = async (event: FormEvent) => {
591
+ event.preventDefault();
592
+ setPending(true);
593
+ await saveRequest();
594
+ setPending(false);
595
+ setOpen(false);
596
+ toast.create({ id: 'policy-created', title: 'Policy created', type: 'success' });
597
+ };
598
+
599
+ return (
600
+ <div className='p-24'>
601
+ <Drawer open={open} onOpenChange={setOpen} data-testid='create-policy-drawer'>
602
+ <DrawerTrigger asChild>
603
+ <Button>Create policy</Button>
604
+ </DrawerTrigger>
605
+ <DrawerContent>
606
+ <DrawerHeader>
607
+ <DrawerTitle>Create policy</DrawerTitle>
608
+ </DrawerHeader>
609
+ <form onSubmit={handleSubmit} className='flex min-h-0 flex-1 flex-col'>
610
+ <Stepper
611
+ count={POLICY_STEPS.length}
612
+ step={step}
613
+ onStepChange={handleStepChange}
614
+ className='flex min-h-0 flex-1 flex-col'
615
+ data-testid='create-policy-stepper'
616
+ >
617
+ <StepperList aria-label='Create policy steps'>
618
+ {POLICY_STEPS.map((title, i) => (
619
+ <StepperItem key={title} index={i} status={statuses[i]}>
620
+ <StepperTrigger>
621
+ <StepperIndicator />
622
+ <StepperTitle>{title}</StepperTitle>
623
+ </StepperTrigger>
624
+ <StepperSeparator />
625
+ </StepperItem>
626
+ ))}
627
+ </StepperList>
628
+ <DrawerBody>
629
+ <StepperContent index={0} className='py-16'>
630
+ <VStack gap={12}>
631
+ <Field required>
632
+ <FieldLabel>
633
+ Name
634
+ <FieldIndicator />
635
+ </FieldLabel>
636
+ <Input
637
+ value={name}
638
+ onChange={handleNameChange}
639
+ placeholder='Login brute-force limit'
640
+ />
641
+ </Field>
642
+ <Field>
643
+ <FieldLabel>
644
+ Description
645
+ <FieldIndicator />
646
+ </FieldLabel>
647
+ <Textarea value={description} onChange={handleDescriptionChange} />
648
+ </Field>
649
+ </VStack>
650
+ </StepperContent>
651
+ <StepperContent index={1} className='py-16'>
652
+ <VStack gap={12}>
653
+ <div className='grid grid-cols-2 gap-12'>
654
+ <Field required>
655
+ <FieldLabel>
656
+ Host
657
+ <FieldIndicator />
658
+ </FieldLabel>
659
+ <Input
660
+ value={host}
661
+ onChange={handleHostChange}
662
+ placeholder='api.acme-bank.com'
663
+ />
664
+ </Field>
665
+ <Field required>
666
+ <FieldLabel>
667
+ Path
668
+ <FieldIndicator />
669
+ </FieldLabel>
670
+ <Input value={path} onChange={handlePathChange} placeholder='/v1/login' />
671
+ </Field>
672
+ </div>
673
+ </VStack>
674
+ </StepperContent>
675
+ <StepperContent index={2} className='py-16'>
676
+ <VStack gap={12}>
677
+ <Field required>
678
+ <FieldLabel>
679
+ Requests per second
680
+ <FieldIndicator />
681
+ </FieldLabel>
682
+ <FieldDescription>
683
+ Requests over the limit from one IP get a 429.
684
+ </FieldDescription>
685
+ <Input
686
+ type='number'
687
+ value={rps}
688
+ onChange={handleRpsChange}
689
+ placeholder='10'
690
+ />
691
+ </Field>
692
+ </VStack>
693
+ </StepperContent>
694
+ </DrawerBody>
695
+ <DrawerFooter>
696
+ <DrawerFooterControls placement='left'>
697
+ <DrawerClose asChild>
698
+ <Button variant='ghost' color='neutral'>
699
+ Cancel
700
+ </Button>
701
+ </DrawerClose>
702
+ </DrawerFooterControls>
703
+ <DrawerFooterControls placement='right'>
704
+ <StepperPrevTrigger asChild>
705
+ <Button variant='outline' color='neutral'>
706
+ Back
707
+ </Button>
708
+ </StepperPrevTrigger>
709
+ {last ? (
710
+ <Button
711
+ type='submit'
712
+ disabled={!valid.every(Boolean)}
713
+ loading={pending}
714
+ data-testid='create-policy-submit'
715
+ >
716
+ Create policy
717
+ </Button>
718
+ ) : (
719
+ <StepperNextTrigger asChild>
720
+ <Button>Next</Button>
721
+ </StepperNextTrigger>
722
+ )}
723
+ </DrawerFooterControls>
724
+ </DrawerFooter>
725
+ </Stepper>
726
+ </form>
727
+ </DrawerContent>
728
+ </Drawer>
729
+ </div>
730
+ );
731
+ };
732
+ ```
733
+
734
+ ## States
735
+
736
+ | State | Show | Example component |
737
+ | --- | --- | --- |
738
+ | Pristine | Submit disabled until required filled | `Button disabled={!canSubmit}` |
739
+ | Invalid field | Red border and an error line | `error` on the control + `FieldError` |
740
+ | Submitting | Spinner on submit | `Button loading={pending}` (also disables) |
741
+ | Server rejects one field | Message on that field | `error` + `FieldError` |
742
+ | Server rejects the request | Error atop the body; values kept | `Alert color='destructive'` |
743
+ | "Test connection" result | In the section, never a toast | `Alert color='success'` / `'destructive'` |
744
+ | Later section not ready | Disabled, with why: "Select a service first" | `FieldDescription` |
745
+ | Field fixed after create | Disabled, with a tooltip | `TooltipTrigger asChild` on a `span` |
746
+ | Dirty close | Unsaved-changes dialog | Variant D in [Confirmation dialogs](confirmation-dialogs.md) |
747
+ | Success | Close, then a toast | `useToast().create({ title: 'User created', type: 'success' })` |
748
+
749
+ ## What your app owns
750
+
751
+ - Values, validation, touched/dirty state, the request and server errors.
752
+ - Values across close: containers unmount content, so lift state out.
753
+ - The unsaved-changes guard: intercept `onOpenChange(false)`.
754
+ - Current step and statuses (`step`, `onStepChange`, `status`).
755
+ - Focusing the first invalid field after submit.
756
+ - The toast: `useToast` from `@wallarm-org/design-system/Toast`, one `Toaster` at the root.
757
+ - A live preview (SSO "Continue with …"): build it from `Button` in a `grid grid-cols-2 gap-12` row.
758
+
759
+ `FieldIndicator`, `Dialog*` and `useToast` import from subpaths. Where the `Stepper` story differs, follow this page.
760
+
761
+ ## Related
762
+
763
+ - [Confirmation dialogs](confirmation-dialogs.md): unsaved-changes guard.
764
+ - [Feedback toasts](feedback-toasts.md): success toast.
765
+ - [Detail drawer](detail-drawer.md): opens the edit form.
766
+ - [Settings page](settings-page.md)
767
+ - [Spacing](../foundations/spacing.md)
768
+ - [Layering](../foundations/layering.md): a `Dialog` inside a `Drawer`.