@facto-to/design-system 0.1.0-beta.7 → 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/AI.md +2 -0
- package/README.md +16 -0
- package/dist/ai/SKILL.md +2 -1
- package/dist/ai/references/api.d.ts +292 -12
- package/dist/ai/references/catalog.json +26 -1
- package/dist/ai/references/components.md +15 -1
- package/dist/ai/references/integration.md +1 -1
- package/dist/ai/references/motion.md +31 -0
- package/dist/ai/references/tokens.css +6 -0
- package/dist/ai/references/version.json +3 -3
- package/dist/index.d.ts +292 -12
- package/dist/index.js +1680 -741
- package/dist/styles.css +1 -1
- package/dist/tokens.css +6 -0
- package/package.json +1 -1
|
@@ -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
|
}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import * as react from 'react';
|
|
2
|
-
import {
|
|
2
|
+
import { ReactNode, HTMLAttributes, RefObject, ImgHTMLAttributes, MouseEventHandler, AnchorHTMLAttributes, ButtonHTMLAttributes, InputHTMLAttributes, ComponentPropsWithoutRef, ComponentPropsWithRef, CSSProperties, SVGProps, TextareaHTMLAttributes } from 'react';
|
|
3
3
|
import * as PopoverPrimitive from '@radix-ui/react-popover';
|
|
4
4
|
import * as MenuPrimitive from '@radix-ui/react-dropdown-menu';
|
|
5
5
|
import * as TooltipPrimitive from '@radix-ui/react-tooltip';
|
|
@@ -9,6 +9,79 @@ import * as DialogPrimitive from '@radix-ui/react-dialog';
|
|
|
9
9
|
import * as SwitchPrimitive from '@radix-ui/react-switch';
|
|
10
10
|
import * as TabsPrimitive from '@radix-ui/react-tabs';
|
|
11
11
|
|
|
12
|
+
/** Auto enables motion while respecting the operating system's reduced-motion preference. */
|
|
13
|
+
type MotionMode = 'auto' | 'none';
|
|
14
|
+
/** Shared presentation timings in milliseconds, independent of application timing. */
|
|
15
|
+
declare const motionTokens: {
|
|
16
|
+
readonly duration: {
|
|
17
|
+
readonly feedback: 160;
|
|
18
|
+
readonly content: 180;
|
|
19
|
+
readonly surface: 220;
|
|
20
|
+
readonly overlay: 240;
|
|
21
|
+
};
|
|
22
|
+
readonly easing: {
|
|
23
|
+
readonly standard: "cubic-bezier(.22, 1, .36, 1)";
|
|
24
|
+
};
|
|
25
|
+
};
|
|
26
|
+
declare function useMotion(override?: MotionMode): {
|
|
27
|
+
motion: MotionMode;
|
|
28
|
+
reduced: boolean;
|
|
29
|
+
enabled: boolean;
|
|
30
|
+
};
|
|
31
|
+
/** Nest to override a section. The display-contents boundary adds no layout box. */
|
|
32
|
+
declare function FactoMotionProvider({ motion, children }: {
|
|
33
|
+
motion?: MotionMode;
|
|
34
|
+
children: ReactNode;
|
|
35
|
+
}): react.JSX.Element;
|
|
36
|
+
|
|
37
|
+
type MotionOverride = 'auto' | 'none';
|
|
38
|
+
interface StepTransitionProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
|
|
39
|
+
stepKey: string | number;
|
|
40
|
+
children: ReactNode;
|
|
41
|
+
motion?: MotionOverride;
|
|
42
|
+
}
|
|
43
|
+
/** Replaces step content immediately while coordinating the surrounding height. */
|
|
44
|
+
declare function StepTransition({ stepKey, children, motion, className, ...props }: StepTransitionProps): react.JSX.Element;
|
|
45
|
+
interface AnimatedDisclosureProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
|
|
46
|
+
open: boolean;
|
|
47
|
+
children: ReactNode;
|
|
48
|
+
motion?: MotionOverride;
|
|
49
|
+
}
|
|
50
|
+
/** Controlled region whose closed content is immediately removed from keyboard navigation. */
|
|
51
|
+
declare function AnimatedDisclosure({ open, children, motion, className, ...props }: AnimatedDisclosureProps): react.JSX.Element;
|
|
52
|
+
interface AnimatedFeedbackProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
|
|
53
|
+
show: boolean;
|
|
54
|
+
children: ReactNode;
|
|
55
|
+
motion?: MotionOverride;
|
|
56
|
+
}
|
|
57
|
+
/** Controlled feedback presentation; consumer validation and alert semantics change synchronously. */
|
|
58
|
+
declare function AnimatedFeedback({ show, children, motion, className, role, ...props }: AnimatedFeedbackProps): react.JSX.Element;
|
|
59
|
+
interface ContentRevealProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
|
|
60
|
+
children: ReactNode;
|
|
61
|
+
ready?: boolean;
|
|
62
|
+
motion?: MotionOverride;
|
|
63
|
+
}
|
|
64
|
+
/** Reveals only when pending content becomes ready; later content updates remain still. */
|
|
65
|
+
declare function ContentReveal({ children, ready, motion, className, ...props }: ContentRevealProps): react.JSX.Element;
|
|
66
|
+
|
|
67
|
+
type ListMotionKey = string | number;
|
|
68
|
+
/**
|
|
69
|
+
* Applies FLIP movement to rows with a `data-list-motion-key` matching an item key.
|
|
70
|
+
* Rows removed by React are never retained for an exit animation.
|
|
71
|
+
*/
|
|
72
|
+
declare function useKeyedListMotion<Key extends ListMotionKey>(rootRef: RefObject<HTMLElement | null>, itemKeys: readonly Key[], { motion }?: {
|
|
73
|
+
motion?: MotionMode;
|
|
74
|
+
}): void;
|
|
75
|
+
interface SelectionMotionProps extends HTMLAttributes<HTMLDivElement> {
|
|
76
|
+
/** Overrides the nearest Facto motion setting for this visual treatment. */
|
|
77
|
+
motion?: MotionMode;
|
|
78
|
+
}
|
|
79
|
+
/**
|
|
80
|
+
* Positions a decorative surface beneath the selected descendant. Selection and
|
|
81
|
+
* keyboard behavior remain the responsibility of the controls it contains.
|
|
82
|
+
*/
|
|
83
|
+
declare function SelectionMotion({ motion, className, children, ...props }: SelectionMotionProps): react.JSX.Element;
|
|
84
|
+
|
|
12
85
|
interface ListRowSlots {
|
|
13
86
|
leading?: ReactNode;
|
|
14
87
|
title: ReactNode;
|
|
@@ -101,6 +174,12 @@ interface OtpInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'def
|
|
|
101
174
|
onValueChange: (value: string) => void;
|
|
102
175
|
/** Number of visual code cells and the maximum accepted code length. */
|
|
103
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;
|
|
104
183
|
/** Called once for each distinct complete value, after the controlled value updates. */
|
|
105
184
|
onComplete?: (value: string) => void;
|
|
106
185
|
/** Delay before `onComplete`, allowing the final digit to render before navigation. */
|
|
@@ -115,11 +194,11 @@ interface OtpInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'def
|
|
|
115
194
|
containerClassName?: string;
|
|
116
195
|
}
|
|
117
196
|
/**
|
|
118
|
-
* Accessible segmented one-time-code input backed by one native input
|
|
119
|
-
*
|
|
120
|
-
* 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.
|
|
121
200
|
*/
|
|
122
|
-
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;
|
|
123
202
|
interface ResendCodeButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'type'> {
|
|
124
203
|
/** UTC timestamp (milliseconds) or Date until another request may be sent. */
|
|
125
204
|
deadline?: number | Date | null;
|
|
@@ -187,16 +266,211 @@ declare function NotificationsProvider({ children, duration, maxVisible, label,
|
|
|
187
266
|
/** Returns the notification API for the nearest NotificationsProvider. */
|
|
188
267
|
declare function useToast(): ToastApi;
|
|
189
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
|
+
|
|
190
463
|
type FactoThemeTokens = Partial<Record<`--facto-${string}`, string | number>>;
|
|
191
464
|
type ThemeTokens = FactoThemeTokens;
|
|
192
465
|
interface FactoThemeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
|
|
193
466
|
/** Scoped overrides; unspecified tokens inherit the dashboard defaults or parent theme. */
|
|
467
|
+
motion?: MotionMode;
|
|
194
468
|
tokens?: FactoThemeTokens;
|
|
195
469
|
/** Inline styles take precedence over the tokens prop. */
|
|
196
470
|
style?: CSSProperties & Partial<ThemeTokens>;
|
|
197
471
|
}
|
|
198
472
|
/** Scoped token container. Inline `--facto-*` values are forwarded to portalled overlays. */
|
|
199
|
-
declare function FactoTheme({ className, tokens, style, ...props }: FactoThemeProps): react.JSX.Element;
|
|
473
|
+
declare function FactoTheme({ className, tokens, style, motion, ...props }: FactoThemeProps): react.JSX.Element;
|
|
200
474
|
/** Shared decorative symbols; name the containing control, not the glyph. */
|
|
201
475
|
type IconName = 'close' | 'arrowLeft' | 'check' | 'chevronDown' | 'chevronRight' | 'info' | 'warning' | 'plus' | 'chevronLeft' | 'copy' | 'search';
|
|
202
476
|
interface IconProps extends SVGProps<SVGSVGElement> {
|
|
@@ -215,6 +489,7 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
|
|
|
215
489
|
size?: ButtonSize;
|
|
216
490
|
fullWidth?: boolean;
|
|
217
491
|
/** Shows a non-interactive progress indicator and disables the control. */
|
|
492
|
+
motion?: MotionMode;
|
|
218
493
|
loading?: boolean;
|
|
219
494
|
leadingIcon?: ReactNode;
|
|
220
495
|
trailingIcon?: ReactNode;
|
|
@@ -294,6 +569,8 @@ interface SelectProps {
|
|
|
294
569
|
placeholder?: string;
|
|
295
570
|
label?: ReactNode;
|
|
296
571
|
error?: ReactNode;
|
|
572
|
+
/** Opt in to a visible control border; default is borderless. */
|
|
573
|
+
bordered?: boolean;
|
|
297
574
|
disabled?: boolean;
|
|
298
575
|
name?: string;
|
|
299
576
|
id?: string;
|
|
@@ -302,7 +579,7 @@ interface SelectProps {
|
|
|
302
579
|
className?: string;
|
|
303
580
|
}
|
|
304
581
|
/** Controlled or uncontrolled Radix select. Use `options` for stable value/label pairs. */
|
|
305
|
-
declare function Select({ options, value, defaultValue, onValueChange, placeholder, label, error, disabled, name, id, ariaLabel, 'aria-describedby': ariaDescribedBy, className, }: SelectProps): react.JSX.Element;
|
|
582
|
+
declare function Select({ options, value, defaultValue, onValueChange, placeholder, label, error, disabled, bordered, name, id, ariaLabel, 'aria-describedby': ariaDescribedBy, className, }: SelectProps): react.JSX.Element;
|
|
306
583
|
interface SwitchProps extends Omit<ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, 'children'> {
|
|
307
584
|
label?: ReactNode;
|
|
308
585
|
description?: ReactNode;
|
|
@@ -328,10 +605,11 @@ declare const DialogDescription: typeof DialogPrimitive.Description;
|
|
|
328
605
|
type OverlayMotionVariant = 'auto' | 'bottom' | 'none';
|
|
329
606
|
interface DialogContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
|
|
330
607
|
size?: 'sm' | 'md';
|
|
608
|
+
motion?: MotionMode;
|
|
331
609
|
motionVariant?: OverlayMotionVariant;
|
|
332
610
|
}
|
|
333
611
|
/** Focus-managed modal content. Place title and description inside for accessible announcements. */
|
|
334
|
-
declare function DialogContent({ size, motionVariant, className, style, children, ...props }: DialogContentProps): react.JSX.Element;
|
|
612
|
+
declare function DialogContent({ size, motionVariant, motion, className, style, children, ...props }: DialogContentProps): react.JSX.Element;
|
|
335
613
|
declare const Sheet: react.FC<DialogPrimitive.DialogProps>;
|
|
336
614
|
declare const SheetTrigger: react.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
|
|
337
615
|
declare const SheetClose: react.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & react.RefAttributes<HTMLButtonElement>>;
|
|
@@ -339,10 +617,11 @@ declare const SheetTitle: react.ForwardRefExoticComponent<Omit<DialogPrimitive.D
|
|
|
339
617
|
declare const SheetDescription: react.ForwardRefExoticComponent<DialogPrimitive.DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>>;
|
|
340
618
|
interface SheetContentProps extends ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
|
|
341
619
|
side?: 'center' | 'right' | 'bottom';
|
|
620
|
+
motion?: MotionMode;
|
|
342
621
|
motionVariant?: OverlayMotionVariant;
|
|
343
622
|
}
|
|
344
623
|
/** Focus-managed side or mobile-bottom sheet. */
|
|
345
|
-
declare function SheetContent({ side, motionVariant, className, style, children, ...props }: SheetContentProps): react.JSX.Element;
|
|
624
|
+
declare function SheetContent({ side, motionVariant, motion, className, style, children, ...props }: SheetContentProps): react.JSX.Element;
|
|
346
625
|
interface SkeletonProps extends HTMLAttributes<HTMLSpanElement> {
|
|
347
626
|
width?: string | number;
|
|
348
627
|
height?: string | number;
|
|
@@ -386,11 +665,12 @@ declare function TooltipContent({ variant, className, style, sideOffset, collisi
|
|
|
386
665
|
/** Dashboard notifications default to 2.6 seconds. */
|
|
387
666
|
declare function ToastProvider({ duration, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Provider>): react.JSX.Element;
|
|
388
667
|
interface ToastProps extends ComponentPropsWithRef<typeof ToastPrimitive.Root> {
|
|
668
|
+
motion?: MotionMode;
|
|
389
669
|
icon?: ReactNode;
|
|
390
670
|
tone?: NoticeTone;
|
|
391
671
|
}
|
|
392
672
|
/** Controlled or uncontrolled notification. Render a ToastViewport inside the provider. */
|
|
393
|
-
declare function Toast({ tone, icon, className, style, children, ...props }: ToastProps): react.JSX.Element;
|
|
673
|
+
declare function Toast({ tone, icon, className, style, motion, children, ...props }: ToastProps): react.JSX.Element;
|
|
394
674
|
declare function ToastTitle({ className, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Title>): react.JSX.Element;
|
|
395
675
|
declare function ToastDescription({ className, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Description>): react.JSX.Element;
|
|
396
676
|
declare function ToastAction({ className, ...props }: ComponentPropsWithRef<typeof ToastPrimitive.Action>): react.JSX.Element;
|
|
@@ -432,5 +712,5 @@ interface ListSkeletonProps extends HTMLAttributes<HTMLDivElement> {
|
|
|
432
712
|
/** Loading placeholder only: consumers own the query and loading state. */
|
|
433
713
|
declare function ListSkeleton({ rows, label, className, ...props }: ListSkeletonProps): react.JSX.Element;
|
|
434
714
|
|
|
435
|
-
export { Avatar, Badge, Button, Card, Checkbox, DashboardGrid, Dialog, DialogClose, DialogContent, DialogDescription, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmptyState, EnhancedSearchField, ErrorState, FactoTheme, Field, FilterChip, Icon, IconButton, ListGroup, ListRow, ListSkeleton, LoadingMore, LogoStack, ModalFooter, ModalHeader, Notice, NotificationsProvider, OtpInput, Popover, PopoverClose, PopoverContent, PopoverTrigger, ResendCodeButton, SearchField, Select, Sheet, SheetClose, SheetContent, SheetDescription, SheetTitle, SheetTrigger, Skeleton, Stack, StepChecklist, 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, useToast };
|
|
436
|
-
export type { AvatarProps, BadgeProps, BadgeTone, ButtonProps, ButtonSize, ButtonVariant, CheckboxProps, DialogContentProps, EmptyStateProps, EnhancedSearchFieldProps, ErrorStateProps, FactoThemeProps, FactoThemeTokens, FieldProps, FilterChipProps, IconButtonProps, IconName, IconProps, ListGroupProps, ListRowButtonProps, ListRowLinkProps, ListRowProps, ListRowSlots, ListRowStaticProps, ListSkeletonProps, LoadingMoreProps, LogoStackItem, LogoStackProps, NoticeProps, NoticeTone, NotificationsProviderProps, OtpInputProps, OverlayMotionVariant, ResendCodeButtonProps, SearchFieldProps, SelectItem, SelectProps, SheetContentProps, SkeletonProps, StackProps, StepChecklistItem, StepChecklistProps, StepChecklistState, 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 };
|