@facto-to/design-system 0.1.0-beta.8 → 0.1.0-beta.9
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.
- package/dist/ai/references/api.d.ts +206 -6
- package/dist/ai/references/catalog.json +17 -1
- package/dist/ai/references/components.md +13 -0
- package/dist/ai/references/integration.md +1 -1
- package/dist/ai/references/tokens.css +6 -0
- package/dist/ai/references/version.json +3 -3
- package/dist/index.d.ts +206 -6
- package/dist/index.js +1638 -984
- package/dist/styles.css +1 -1
- package/dist/tokens.css +6 -0
- package/package.json +1 -1
|
@@ -174,6 +174,12 @@ interface OtpInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'def
|
|
|
174
174
|
onValueChange: (value: string) => void;
|
|
175
175
|
/** Number of visual code cells and the maximum accepted code length. */
|
|
176
176
|
length?: number;
|
|
177
|
+
/** Adds a subtle midpoint gap for 6-digit (3-3) or 8-digit (4-4) readability. */
|
|
178
|
+
split?: boolean;
|
|
179
|
+
/** Accepts uppercase letters and digits instead of numeric digits only. */
|
|
180
|
+
alphanumeric?: boolean;
|
|
181
|
+
/** Displays confirmed accent styling once verification succeeds. */
|
|
182
|
+
verified?: boolean;
|
|
177
183
|
/** Called once for each distinct complete value, after the controlled value updates. */
|
|
178
184
|
onComplete?: (value: string) => void;
|
|
179
185
|
/** Delay before `onComplete`, allowing the final digit to render before navigation. */
|
|
@@ -188,11 +194,11 @@ interface OtpInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'def
|
|
|
188
194
|
containerClassName?: string;
|
|
189
195
|
}
|
|
190
196
|
/**
|
|
191
|
-
* Accessible segmented one-time-code input backed by one native input
|
|
192
|
-
*
|
|
193
|
-
* in the consuming
|
|
197
|
+
* Accessible segmented one-time-code input backed by one native input over
|
|
198
|
+
* 1:1 square visual cells so paste, platform autofill, and click-to-replace
|
|
199
|
+
* work natively. Authentication and verification stay in the consuming app.
|
|
194
200
|
*/
|
|
195
|
-
declare function OtpInput({ value, onValueChange, length, onComplete, completionDelay, pending, pendingLabel, label, helperText, error, id, className, containerClassName, disabled, readOnly, onPaste, onFocus, onBlur, ...props }: OtpInputProps): react.JSX.Element;
|
|
201
|
+
declare function OtpInput({ value, onValueChange, length, split, alphanumeric, verified, onComplete, completionDelay, pending, pendingLabel, label, helperText, error, id, className, containerClassName, disabled, readOnly, onPaste, onFocus, onBlur, onSelect, onClick, ...props }: OtpInputProps): react.JSX.Element;
|
|
196
202
|
interface ResendCodeButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'type'> {
|
|
197
203
|
/** UTC timestamp (milliseconds) or Date until another request may be sent. */
|
|
198
204
|
deadline?: number | Date | null;
|
|
@@ -260,6 +266,200 @@ declare function NotificationsProvider({ children, duration, maxVisible, label,
|
|
|
260
266
|
/** Returns the notification API for the nearest NotificationsProvider. */
|
|
261
267
|
declare function useToast(): ToastApi;
|
|
262
268
|
|
|
269
|
+
interface AuthFlowShellProps extends HTMLAttributes<HTMLDivElement> {
|
|
270
|
+
/** Standalone quiet page canvas (`page`) or embedded column (`plain`). */
|
|
271
|
+
surface?: 'page' | 'plain';
|
|
272
|
+
/** Expands column width to 620px for multi-column selection steps. */
|
|
273
|
+
wide?: boolean;
|
|
274
|
+
/** Coordinates smooth height and content transitions across steps when provided. */
|
|
275
|
+
stepKey?: string | number;
|
|
276
|
+
/** Motion override forwarded to StepTransition (`auto` | `none`). */
|
|
277
|
+
motion?: MotionOverride;
|
|
278
|
+
brand?: ReactNode;
|
|
279
|
+
badge?: ReactNode;
|
|
280
|
+
children: ReactNode;
|
|
281
|
+
}
|
|
282
|
+
/** Shared focused column shell for verification, MFA, and onboarding flows. */
|
|
283
|
+
declare function AuthFlowShell({ surface, wide, stepKey, motion, brand, badge, children, className, ...props }: AuthFlowShellProps): react.JSX.Element;
|
|
284
|
+
interface StepProgressProps extends HTMLAttributes<HTMLDivElement> {
|
|
285
|
+
current: number;
|
|
286
|
+
total: number;
|
|
287
|
+
label?: ReactNode;
|
|
288
|
+
}
|
|
289
|
+
/** Minimalist segmented step progress bar for multi-step flows. */
|
|
290
|
+
declare function StepProgress({ current, total, label, className, ...props }: StepProgressProps): react.JSX.Element;
|
|
291
|
+
interface IdentityEchoPillProps extends HTMLAttributes<HTMLDivElement> {
|
|
292
|
+
value: string;
|
|
293
|
+
onEdit?: () => void;
|
|
294
|
+
editLabel?: ReactNode;
|
|
295
|
+
}
|
|
296
|
+
/** Displays the active verification target (such as an email address) with an optional edit trigger. */
|
|
297
|
+
declare function IdentityEchoPill({ value, onEdit, editLabel, className, ...props }: IdentityEchoPillProps): react.JSX.Element;
|
|
298
|
+
interface CopyableSecretKeyProps {
|
|
299
|
+
/** Raw secret value copied to the clipboard. */
|
|
300
|
+
value: string;
|
|
301
|
+
/** Optional formatted string shown to the user (defaults to `value`). */
|
|
302
|
+
displayValue?: string;
|
|
303
|
+
copyLabel?: ReactNode;
|
|
304
|
+
copiedLabel?: ReactNode;
|
|
305
|
+
onCopy?: (value: string) => void;
|
|
306
|
+
className?: string;
|
|
307
|
+
ariaLabel?: string;
|
|
308
|
+
}
|
|
309
|
+
/** Tactile monospace key bar for manual authenticator app enrollment. */
|
|
310
|
+
declare function CopyableSecretKey({ value, displayValue, copyLabel, copiedLabel, onCopy, className, ariaLabel, }: CopyableSecretKeyProps): react.JSX.Element;
|
|
311
|
+
interface EmailVerificationStepProps {
|
|
312
|
+
email: string;
|
|
313
|
+
code: string;
|
|
314
|
+
onCodeChange: (value: string) => void;
|
|
315
|
+
onSubmit?: (code: string) => void;
|
|
316
|
+
/** Optional inline email update callback; shows an Edit action when provided. */
|
|
317
|
+
onEmailChange?: (nextEmail: string) => void;
|
|
318
|
+
onBack?: () => void;
|
|
319
|
+
onResend?: () => void;
|
|
320
|
+
resendDeadline?: number | Date | null;
|
|
321
|
+
resendPending?: boolean;
|
|
322
|
+
step?: {
|
|
323
|
+
current: number;
|
|
324
|
+
total: number;
|
|
325
|
+
label?: ReactNode;
|
|
326
|
+
};
|
|
327
|
+
title?: ReactNode;
|
|
328
|
+
description?: ReactNode;
|
|
329
|
+
helperText?: ReactNode;
|
|
330
|
+
error?: ReactNode;
|
|
331
|
+
pending?: boolean;
|
|
332
|
+
verified?: boolean;
|
|
333
|
+
autoSubmit?: boolean;
|
|
334
|
+
length?: number;
|
|
335
|
+
alphanumeric?: boolean;
|
|
336
|
+
unreadCount?: number;
|
|
337
|
+
submitLabel?: ReactNode;
|
|
338
|
+
backLabel?: ReactNode;
|
|
339
|
+
className?: string;
|
|
340
|
+
}
|
|
341
|
+
/**
|
|
342
|
+
* Reusable email verification step ("Check your inbox") built on 1:1 square
|
|
343
|
+
* `OtpInput` and isolated `ResendCodeButton` so countdown ticks never steal focus.
|
|
344
|
+
*/
|
|
345
|
+
declare function EmailVerificationStep({ email, code, onCodeChange, onSubmit, onEmailChange, onBack, onResend, resendDeadline, resendPending, step, title, description, helperText, error, pending, verified, autoSubmit, length, alphanumeric, unreadCount, submitLabel, backLabel, className, }: EmailVerificationStepProps): react.JSX.Element;
|
|
346
|
+
interface PasskeySetupCardProps {
|
|
347
|
+
step?: {
|
|
348
|
+
current: number;
|
|
349
|
+
total: number;
|
|
350
|
+
label?: ReactNode;
|
|
351
|
+
};
|
|
352
|
+
illustration?: ReactNode;
|
|
353
|
+
title?: ReactNode;
|
|
354
|
+
description?: ReactNode;
|
|
355
|
+
capabilities?: readonly ReactNode[];
|
|
356
|
+
ctaLabel?: ReactNode;
|
|
357
|
+
pendingLabel?: ReactNode;
|
|
358
|
+
pending?: boolean;
|
|
359
|
+
verified?: boolean;
|
|
360
|
+
verifiedMessage?: ReactNode;
|
|
361
|
+
error?: ReactNode;
|
|
362
|
+
onCreatePasskey: () => void;
|
|
363
|
+
onSwitchAlternative?: () => void;
|
|
364
|
+
alternativeLabel?: ReactNode;
|
|
365
|
+
className?: string;
|
|
366
|
+
}
|
|
367
|
+
/**
|
|
368
|
+
* Passkey-first MFA setup step. Keeps the quiet capability panel visually
|
|
369
|
+
* distinct from the 44px primary action below it.
|
|
370
|
+
*/
|
|
371
|
+
declare function PasskeySetupCard({ step, illustration, title, description, capabilities, ctaLabel, pendingLabel, pending, verified, verifiedMessage, error, onCreatePasskey, onSwitchAlternative, alternativeLabel, className, }: PasskeySetupCardProps): react.JSX.Element;
|
|
372
|
+
interface TotpEmailFactorProps {
|
|
373
|
+
code: string;
|
|
374
|
+
onCodeChange: (value: string) => void;
|
|
375
|
+
onSend: () => void;
|
|
376
|
+
deadline?: number | Date | null;
|
|
377
|
+
sending?: boolean;
|
|
378
|
+
title?: ReactNode;
|
|
379
|
+
description?: ReactNode;
|
|
380
|
+
}
|
|
381
|
+
interface TotpEnrollmentCardProps {
|
|
382
|
+
step?: {
|
|
383
|
+
current: number;
|
|
384
|
+
total: number;
|
|
385
|
+
label?: ReactNode;
|
|
386
|
+
};
|
|
387
|
+
title?: ReactNode;
|
|
388
|
+
description?: ReactNode;
|
|
389
|
+
issuer: string;
|
|
390
|
+
accountLabel: string;
|
|
391
|
+
/** QR code element (e.g. rendered SVG or `<img>` from a data URL). */
|
|
392
|
+
qrCode: ReactNode;
|
|
393
|
+
manualKey: string;
|
|
394
|
+
displayManualKey?: string;
|
|
395
|
+
code: string;
|
|
396
|
+
onCodeChange: (value: string) => void;
|
|
397
|
+
onSubmit: (code: string) => void;
|
|
398
|
+
/** Optional secondary email OTP factor for high-risk TOTP enable/disable flows. */
|
|
399
|
+
emailFactor?: TotpEmailFactorProps;
|
|
400
|
+
error?: ReactNode;
|
|
401
|
+
pending?: boolean;
|
|
402
|
+
verified?: boolean;
|
|
403
|
+
submitLabel?: ReactNode;
|
|
404
|
+
onSwitchAlternative?: () => void;
|
|
405
|
+
alternativeLabel?: ReactNode;
|
|
406
|
+
className?: string;
|
|
407
|
+
}
|
|
408
|
+
/**
|
|
409
|
+
* Authenticator app (TOTP) enrollment card combining a bordered QR code,
|
|
410
|
+
* tactile copyable manual key, square 6-digit `OtpInput`, and optional dual-factor email code.
|
|
411
|
+
*/
|
|
412
|
+
declare function TotpEnrollmentCard({ step, title, description, issuer, accountLabel, qrCode, manualKey, displayManualKey, code, onCodeChange, onSubmit, emailFactor, error, pending, verified, submitLabel, onSwitchAlternative, alternativeLabel, className, }: TotpEnrollmentCardProps): react.JSX.Element;
|
|
413
|
+
/** Formats recovery codes into a plain-text file payload for download. */
|
|
414
|
+
declare function formatRecoveryCodesText(codes: readonly string[], meta?: {
|
|
415
|
+
issuer?: string;
|
|
416
|
+
account?: string;
|
|
417
|
+
}): string;
|
|
418
|
+
interface RecoveryCodesStepProps {
|
|
419
|
+
codes: readonly string[];
|
|
420
|
+
/** Indices of already-consumed codes when rendered in account management mode. */
|
|
421
|
+
usedIndices?: readonly number[];
|
|
422
|
+
variant?: 'onboarding' | 'manage';
|
|
423
|
+
step?: {
|
|
424
|
+
current: number;
|
|
425
|
+
total: number;
|
|
426
|
+
label?: ReactNode;
|
|
427
|
+
};
|
|
428
|
+
title?: ReactNode;
|
|
429
|
+
description?: ReactNode;
|
|
430
|
+
confirmationLabel?: ReactNode;
|
|
431
|
+
continueLabel?: ReactNode;
|
|
432
|
+
regenerateLabel?: ReactNode;
|
|
433
|
+
onCopyAll?: (codes: readonly string[]) => void;
|
|
434
|
+
onDownload?: (codes: readonly string[]) => void;
|
|
435
|
+
onContinue?: () => void;
|
|
436
|
+
onRegenerate?: () => void;
|
|
437
|
+
className?: string;
|
|
438
|
+
}
|
|
439
|
+
/**
|
|
440
|
+
* Show-once recovery codes panel with 2-column monospace grid, grid-aligned
|
|
441
|
+
* 10px nested Copy/Download utility buttons, and explicit save confirmation gate.
|
|
442
|
+
*/
|
|
443
|
+
declare function RecoveryCodesStep({ codes, usedIndices, variant, step, title, description, confirmationLabel, continueLabel, regenerateLabel, onCopyAll, onDownload, onContinue, onRegenerate, className, }: RecoveryCodesStepProps): react.JSX.Element;
|
|
444
|
+
interface SelectionCardOption {
|
|
445
|
+
value: string;
|
|
446
|
+
title: ReactNode;
|
|
447
|
+
description?: ReactNode;
|
|
448
|
+
meta?: ReactNode;
|
|
449
|
+
metaTone?: 'default' | 'accent';
|
|
450
|
+
icon?: ReactNode;
|
|
451
|
+
disabled?: boolean;
|
|
452
|
+
}
|
|
453
|
+
interface SelectionCardGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
|
|
454
|
+
options: readonly SelectionCardOption[];
|
|
455
|
+
value: string;
|
|
456
|
+
onValueChange: (value: string) => void;
|
|
457
|
+
columns?: 1 | 2;
|
|
458
|
+
ariaLabel: string;
|
|
459
|
+
}
|
|
460
|
+
/** Accessible radio-card selection group for role, workspace, or funding mode steps. */
|
|
461
|
+
declare function SelectionCardGroup({ options, value, onValueChange, columns, ariaLabel, className, ...props }: SelectionCardGroupProps): react.JSX.Element;
|
|
462
|
+
|
|
263
463
|
type FactoThemeTokens = Partial<Record<`--facto-${string}`, string | number>>;
|
|
264
464
|
type ThemeTokens = FactoThemeTokens;
|
|
265
465
|
interface FactoThemeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
|
|
@@ -512,5 +712,5 @@ interface ListSkeletonProps extends HTMLAttributes<HTMLDivElement> {
|
|
|
512
712
|
/** Loading placeholder only: consumers own the query and loading state. */
|
|
513
713
|
declare function ListSkeleton({ rows, label, className, ...props }: ListSkeletonProps): react.JSX.Element;
|
|
514
714
|
|
|
515
|
-
export { AnimatedDisclosure, AnimatedFeedback, Avatar, Badge, Button, Card, Checkbox, ContentReveal, DashboardGrid, Dialog, DialogClose, DialogContent, DialogDescription, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmptyState, EnhancedSearchField, ErrorState, FactoMotionProvider, FactoTheme, Field, FilterChip, Icon, IconButton, ListGroup, ListRow, ListSkeleton, LoadingMore, LogoStack, ModalFooter, ModalHeader, Notice, NotificationsProvider, OtpInput, Popover, PopoverClose, PopoverContent, PopoverTrigger, ResendCodeButton, SearchField, Select, SelectionMotion, Sheet, SheetClose, SheetContent, SheetDescription, SheetTitle, SheetTrigger, Skeleton, Stack, StepChecklist, StepTransition, Surface, Switch, Tabs, TabsContent, TabsList, TabsTrigger, TextField, Textarea, Toast, ToastAction, ToastClose, ToastDescription, ToastProvider, ToastTitle, ToastViewport, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Widget, WidgetAction, WidgetAmount, WidgetHeader, WidgetKeyValue, WidgetList, WidgetRow, motionTokens, useKeyedListMotion, useMotion, useToast };
|
|
516
|
-
export type { AnimatedDisclosureProps, AnimatedFeedbackProps, AvatarProps, BadgeProps, BadgeTone, ButtonProps, ButtonSize, ButtonVariant, CheckboxProps, ContentRevealProps, DialogContentProps, EmptyStateProps, EnhancedSearchFieldProps, ErrorStateProps, FactoThemeProps, FactoThemeTokens, FieldProps, FilterChipProps, IconButtonProps, IconName, IconProps, ListGroupProps, ListRowButtonProps, ListRowLinkProps, ListRowProps, ListRowSlots, ListRowStaticProps, ListSkeletonProps, LoadingMoreProps, LogoStackItem, LogoStackProps, MotionMode, MotionOverride, NoticeProps, NoticeTone, NotificationsProviderProps, OtpInputProps, OverlayMotionVariant, ResendCodeButtonProps, SearchFieldProps, SelectItem, SelectProps, SelectionMotionProps, SheetContentProps, SkeletonProps, StackProps, StepChecklistItem, StepChecklistProps, StepChecklistState, StepTransitionProps, SurfaceProps, SwitchProps, TextFieldProps, TextareaProps, ToastActionOptions, ToastApi, ToastId, ToastOptions, ToastPromiseMessages, ToastProps, ToastTone, ToastUpdate, TooltipContentProps, WidgetActionButtonProps, WidgetActionLinkProps, WidgetActionProps, WidgetHeaderProps, WidgetProps };
|
|
715
|
+
export { AnimatedDisclosure, AnimatedFeedback, AuthFlowShell, Avatar, Badge, Button, Card, Checkbox, ContentReveal, CopyableSecretKey, DashboardGrid, Dialog, DialogClose, DialogContent, DialogDescription, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmailVerificationStep, EmptyState, EnhancedSearchField, ErrorState, FactoMotionProvider, FactoTheme, Field, FilterChip, Icon, IconButton, IdentityEchoPill, ListGroup, ListRow, ListSkeleton, LoadingMore, LogoStack, ModalFooter, ModalHeader, Notice, NotificationsProvider, OtpInput, PasskeySetupCard, Popover, PopoverClose, PopoverContent, PopoverTrigger, RecoveryCodesStep, ResendCodeButton, SearchField, Select, SelectionCardGroup, SelectionMotion, Sheet, SheetClose, SheetContent, SheetDescription, SheetTitle, SheetTrigger, Skeleton, Stack, StepChecklist, StepProgress, StepTransition, Surface, Switch, Tabs, TabsContent, TabsList, TabsTrigger, TextField, Textarea, Toast, ToastAction, ToastClose, ToastDescription, ToastProvider, ToastTitle, ToastViewport, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TotpEnrollmentCard, Widget, WidgetAction, WidgetAmount, WidgetHeader, WidgetKeyValue, WidgetList, WidgetRow, formatRecoveryCodesText, motionTokens, useKeyedListMotion, useMotion, useToast };
|
|
716
|
+
export type { AnimatedDisclosureProps, AnimatedFeedbackProps, AuthFlowShellProps, AvatarProps, BadgeProps, BadgeTone, ButtonProps, ButtonSize, ButtonVariant, CheckboxProps, ContentRevealProps, CopyableSecretKeyProps, DialogContentProps, EmailVerificationStepProps, EmptyStateProps, EnhancedSearchFieldProps, ErrorStateProps, FactoThemeProps, FactoThemeTokens, FieldProps, FilterChipProps, IconButtonProps, IconName, IconProps, IdentityEchoPillProps, ListGroupProps, ListRowButtonProps, ListRowLinkProps, ListRowProps, ListRowSlots, ListRowStaticProps, ListSkeletonProps, LoadingMoreProps, LogoStackItem, LogoStackProps, MotionMode, MotionOverride, NoticeProps, NoticeTone, NotificationsProviderProps, OtpInputProps, OverlayMotionVariant, PasskeySetupCardProps, RecoveryCodesStepProps, ResendCodeButtonProps, SearchFieldProps, SelectItem, SelectProps, SelectionCardGroupProps, SelectionCardOption, SelectionMotionProps, SheetContentProps, SkeletonProps, StackProps, StepChecklistItem, StepChecklistProps, StepChecklistState, StepProgressProps, StepTransitionProps, SurfaceProps, SwitchProps, TextFieldProps, TextareaProps, ToastActionOptions, ToastApi, ToastId, ToastOptions, ToastPromiseMessages, ToastProps, ToastTone, ToastUpdate, TooltipContentProps, TotpEmailFactorProps, TotpEnrollmentCardProps, WidgetActionButtonProps, WidgetActionLinkProps, WidgetActionProps, WidgetHeaderProps, WidgetProps };
|
|
@@ -1,16 +1,18 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"package": "@facto-to/design-system",
|
|
4
|
-
"packageVersion": "0.1.0-beta.
|
|
4
|
+
"packageVersion": "0.1.0-beta.9",
|
|
5
5
|
"exports": [
|
|
6
6
|
"AnimatedDisclosure",
|
|
7
7
|
"AnimatedFeedback",
|
|
8
|
+
"AuthFlowShell",
|
|
8
9
|
"Avatar",
|
|
9
10
|
"Badge",
|
|
10
11
|
"Button",
|
|
11
12
|
"Card",
|
|
12
13
|
"Checkbox",
|
|
13
14
|
"ContentReveal",
|
|
15
|
+
"CopyableSecretKey",
|
|
14
16
|
"DashboardGrid",
|
|
15
17
|
"Dialog",
|
|
16
18
|
"DialogClose",
|
|
@@ -23,6 +25,7 @@
|
|
|
23
25
|
"DropdownMenuItem",
|
|
24
26
|
"DropdownMenuSeparator",
|
|
25
27
|
"DropdownMenuTrigger",
|
|
28
|
+
"EmailVerificationStep",
|
|
26
29
|
"EmptyState",
|
|
27
30
|
"EnhancedSearchField",
|
|
28
31
|
"ErrorState",
|
|
@@ -32,6 +35,7 @@
|
|
|
32
35
|
"FilterChip",
|
|
33
36
|
"Icon",
|
|
34
37
|
"IconButton",
|
|
38
|
+
"IdentityEchoPill",
|
|
35
39
|
"ListGroup",
|
|
36
40
|
"ListRow",
|
|
37
41
|
"ListSkeleton",
|
|
@@ -42,13 +46,16 @@
|
|
|
42
46
|
"Notice",
|
|
43
47
|
"NotificationsProvider",
|
|
44
48
|
"OtpInput",
|
|
49
|
+
"PasskeySetupCard",
|
|
45
50
|
"Popover",
|
|
46
51
|
"PopoverClose",
|
|
47
52
|
"PopoverContent",
|
|
48
53
|
"PopoverTrigger",
|
|
54
|
+
"RecoveryCodesStep",
|
|
49
55
|
"ResendCodeButton",
|
|
50
56
|
"SearchField",
|
|
51
57
|
"Select",
|
|
58
|
+
"SelectionCardGroup",
|
|
52
59
|
"SelectionMotion",
|
|
53
60
|
"Sheet",
|
|
54
61
|
"SheetClose",
|
|
@@ -59,6 +66,7 @@
|
|
|
59
66
|
"Skeleton",
|
|
60
67
|
"Stack",
|
|
61
68
|
"StepChecklist",
|
|
69
|
+
"StepProgress",
|
|
62
70
|
"StepTransition",
|
|
63
71
|
"Surface",
|
|
64
72
|
"Switch",
|
|
@@ -79,6 +87,7 @@
|
|
|
79
87
|
"TooltipContent",
|
|
80
88
|
"TooltipProvider",
|
|
81
89
|
"TooltipTrigger",
|
|
90
|
+
"TotpEnrollmentCard",
|
|
82
91
|
"Widget",
|
|
83
92
|
"WidgetAction",
|
|
84
93
|
"WidgetAmount",
|
|
@@ -86,6 +95,7 @@
|
|
|
86
95
|
"WidgetKeyValue",
|
|
87
96
|
"WidgetList",
|
|
88
97
|
"WidgetRow",
|
|
98
|
+
"formatRecoveryCodesText",
|
|
89
99
|
"motionTokens",
|
|
90
100
|
"useKeyedListMotion",
|
|
91
101
|
"useMotion",
|
|
@@ -99,6 +109,7 @@
|
|
|
99
109
|
"--facto-action-danger-hover",
|
|
100
110
|
"--facto-action-danger-pressed",
|
|
101
111
|
"--facto-action-disabled",
|
|
112
|
+
"--facto-action-disabled-border",
|
|
102
113
|
"--facto-action-disabled-text",
|
|
103
114
|
"--facto-action-link",
|
|
104
115
|
"--facto-action-link-pressed",
|
|
@@ -109,6 +120,8 @@
|
|
|
109
120
|
"--facto-action-secondary",
|
|
110
121
|
"--facto-action-secondary-hover",
|
|
111
122
|
"--facto-action-secondary-pressed",
|
|
123
|
+
"--facto-auth-canvas",
|
|
124
|
+
"--facto-badge-dot",
|
|
112
125
|
"--facto-badge-padding",
|
|
113
126
|
"--facto-button-danger-padding",
|
|
114
127
|
"--facto-button-font-size",
|
|
@@ -162,6 +175,7 @@
|
|
|
162
175
|
"--facto-line-height-heading-md",
|
|
163
176
|
"--facto-line-height-heading-sm",
|
|
164
177
|
"--facto-line-height-label",
|
|
178
|
+
"--facto-line-strong",
|
|
165
179
|
"--facto-motion-overlay-backdrop-enter",
|
|
166
180
|
"--facto-motion-overlay-bottom-distance",
|
|
167
181
|
"--facto-motion-overlay-bottom-duration",
|
|
@@ -181,6 +195,7 @@
|
|
|
181
195
|
"--facto-radius-danger",
|
|
182
196
|
"--facto-radius-dialog",
|
|
183
197
|
"--facto-radius-input",
|
|
198
|
+
"--facto-radius-nested-control",
|
|
184
199
|
"--facto-radius-sheet",
|
|
185
200
|
"--facto-radius-sheet-mobile",
|
|
186
201
|
"--facto-search-placeholder",
|
|
@@ -210,6 +225,7 @@
|
|
|
210
225
|
"--facto-switch-track-checked",
|
|
211
226
|
"--facto-tabs-list-background",
|
|
212
227
|
"--facto-text",
|
|
228
|
+
"--facto-text-secondary",
|
|
213
229
|
"--facto-toast-default-description",
|
|
214
230
|
"--facto-toast-default-foreground",
|
|
215
231
|
"--facto-toast-desktop-reserve",
|
|
@@ -40,3 +40,16 @@ Use `NotificationsProvider` with `useToast()` for scoped notification state, ids
|
|
|
40
40
|
Use `Popover` for contextual interactive content and `DropdownMenu` for actions. Both restore focus; Tooltip remains supplemental text. `ListRow` becomes an anchor with href or a button with onClick, otherwise a static row. Never nest a button in an interactive row. `ListGroup`, `Avatar`, `LogoStack`, `ErrorState`, `LoadingMore`, `StepChecklist` are generic presentation; keep business registries, routing and data fetching in the app.
|
|
41
41
|
|
|
42
42
|
`FilterChip` exposes selected/aria-pressed; `ListSkeleton` exposes row count and an accessible loading label. `Field` requires inputId; give its native input the same id.
|
|
43
|
+
|
|
44
|
+
## Auth and verification kit
|
|
45
|
+
|
|
46
|
+
Use the shared UI-only auth and verification components across login, onboarding, MFA enrollment, and account security screens so every surface inherits identical spacing, 1:1 square OTP cells, and 44px operate button proportions:
|
|
47
|
+
|
|
48
|
+
- `AuthFlowShell`: centered `380px` single-axis page canvas (`surface="page"`, `#fdfdfd`) or embedded column (`surface="plain"`), with `wide` (`620px`) for multi-column selection steps.
|
|
49
|
+
- `StepProgress`: minimalist 3px segmented step bar (`current`, `total`, `label`).
|
|
50
|
+
- `IdentityEchoPill` & `CopyableSecretKey`: read-only identity bar with optional inline edit action, and tactile monospace setup-key copy button.
|
|
51
|
+
- `OtpInput`: single native `<input autocomplete="one-time-code">` layered over 1:1 square visual cells (`aspect-ratio: 1 / 1`), supporting `split` (3-3 / 4-4 grouping), `alphanumeric`, `verified`, active-slot caret, and single-click digit replacement. Never build OTP inputs from multiple `<input maxlength="1">` fields.
|
|
52
|
+
- `EmailVerificationStep`: composes mail badge, `IdentityEchoPill` (with optional inline email editor), square `OtpInput`, 44px primary CTA (or `autoSubmit`), and isolated `ResendCodeButton` that preserves OTP input focus during countdowns.
|
|
53
|
+
- `PasskeySetupCard` & `TotpEnrollmentCard`: passkey-first hero with quiet capability panel and independent 44px primary CTA; TOTP QR + `CopyableSecretKey` + square `OtpInput` (plus optional `emailFactor` for dual-factor enrollment).
|
|
54
|
+
- `RecoveryCodesStep` & `formatRecoveryCodesText`: 2x4 monospace code grid, grid-aligned 10px nested-radius `Copy codes` / `Download .txt` toolbar, and explicit confirmation checkbox gate (plus `variant="manage"` for security settings).
|
|
55
|
+
- `SelectionCardGroup`: accessible `role="radiogroup"` selection cards for workspace, role, or mode choices.
|
|
@@ -7,7 +7,7 @@ Read version.json for the version used to generate this skill. Check the target
|
|
|
7
7
|
For a new compatible project with no installed package:
|
|
8
8
|
|
|
9
9
|
```sh
|
|
10
|
-
npm install --save-exact @facto-to/design-system@0.1.0-beta.
|
|
10
|
+
npm install --save-exact @facto-to/design-system@0.1.0-beta.9
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
React 19 and React DOM 19 must already be compatible with the host; do not reinstall or upgrade them blindly. No Tailwind, backend SDK, API key or runtime environment variable is required.
|
|
@@ -25,14 +25,18 @@
|
|
|
25
25
|
--facto-tracking-heading-tight: -0.02em;
|
|
26
26
|
--facto-tracking-heading-lg: -0.588px;
|
|
27
27
|
--facto-canvas: #f5f5f4;
|
|
28
|
+
--facto-auth-canvas: #fdfdfd;
|
|
28
29
|
--facto-surface: #fff;
|
|
29
30
|
--facto-subtle: #f3f3f2;
|
|
30
31
|
--facto-text: #121411;
|
|
32
|
+
--facto-text-secondary: #4a4d47;
|
|
31
33
|
--facto-control-text: #121411;
|
|
32
34
|
--facto-muted: #62655f;
|
|
33
35
|
/* Accessible secondary copy on the existing tinted surfaces. */
|
|
34
36
|
--facto-muted-on-subtle: #62655f;
|
|
35
37
|
--facto-line: #e7e7e5;
|
|
38
|
+
--facto-line-strong: #d4d5d1;
|
|
39
|
+
--facto-badge-dot: #ed174c;
|
|
36
40
|
--facto-accent: #00d64f;
|
|
37
41
|
--facto-accent-strong: #0b6b4b;
|
|
38
42
|
--facto-accent-soft: #e7fbf2;
|
|
@@ -58,8 +62,10 @@
|
|
|
58
62
|
--facto-action-link: #0b6b4b;
|
|
59
63
|
--facto-action-link-pressed: #084d36;
|
|
60
64
|
--facto-action-disabled: #eaeae7;
|
|
65
|
+
--facto-action-disabled-border: #e4e4e1;
|
|
61
66
|
--facto-action-disabled-text: #62655f;
|
|
62
67
|
--facto-surface-border: #e7e7e5;
|
|
68
|
+
--facto-radius-nested-control: 10px;
|
|
63
69
|
--facto-radius-control: 12px;
|
|
64
70
|
--facto-radius-input: 12px;
|
|
65
71
|
--facto-radius-card: 16px;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"package": "@facto-to/design-system",
|
|
4
|
-
"packageVersion": "0.1.0-beta.
|
|
4
|
+
"packageVersion": "0.1.0-beta.9",
|
|
5
5
|
"peerDependencies": {
|
|
6
6
|
"react": "^19.0.0",
|
|
7
7
|
"react-dom": "^19.0.0"
|
|
@@ -15,6 +15,6 @@
|
|
|
15
15
|
"scope": "Existing component baseline only; public standard 1.2.24 is a target, not a full adoption claim."
|
|
16
16
|
}
|
|
17
17
|
},
|
|
18
|
-
"apiSha256": "
|
|
19
|
-
"tokensSha256": "
|
|
18
|
+
"apiSha256": "793b478804a2fb4a4406782da916cc4d0aed2abec3874792280f2397c9b3ab85",
|
|
19
|
+
"tokensSha256": "42f9f438e697a666dd9baf48417719ecc00485484f61f94a7d091c864e637644"
|
|
20
20
|
}
|