@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
package/dist/index.d.ts
CHANGED
|
@@ -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 };
|