@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/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 so paste
192
- * and platform autofill work as expected. Authentication and verification stay
193
- * in the consuming application.
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 };