@facto-to/design-system 0.1.0-beta.10 → 0.1.0-beta.11
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/DESIGN.md +2 -0
- package/dist/ai/references/DESIGN.md +2 -0
- package/dist/ai/references/api.d.ts +367 -16
- package/dist/ai/references/catalog.json +30 -1
- package/dist/ai/references/components.md +10 -1
- package/dist/ai/references/integration.md +1 -1
- package/dist/ai/references/version.json +3 -3
- package/dist/index.d.ts +367 -16
- package/dist/index.js +2767 -1494
- package/dist/styles.css +1 -1
- package/package.json +1 -1
package/DESIGN.md
CHANGED
|
@@ -182,6 +182,8 @@ Facto uses a **Restrained Daylight Operate** visual system across its user, part
|
|
|
182
182
|
- `size="lg"`: `min-height: 52px`, `padding: 12px 24px`, `16/24/500`, `999px` pill for comfortable standalone/checkout submit actions when explicitly chosen.
|
|
183
183
|
- **Core Primitives**: `Button`, `IconButton` (`44px` hit target, `28/38/44px` visible circle), `TextField`, `Textarea`, `SearchField`, `EnhancedSearchField`, `Field`, `OtpInput`, `ResendCodeButton`, `Select` (borderless default, `bordered` opt-in), `Checkbox` (`44x44` hit target, `20px` visual), `Switch` (`44x44` hit target, `34x20` track), `Badge`, `Notice`, `Surface`, `Card`, `Sheet`, `Dialog`, `ModalHeader`, `ModalFooter`, `Tabs`, `Tooltip`, `Popover`, `DropdownMenu`, `Toast`, `NotificationsProvider`, `FactoTheme`, `FactoMotionProvider`.
|
|
184
184
|
- **Auth & Verification Kit**: `AuthFlowShell`, `StepProgress`, `IdentityEchoPill`, `CopyableSecretKey`, `EmailVerificationStep`, `PasskeySetupCard`, `TotpEnrollmentCard`, `RecoveryCodesStep`, `formatRecoveryCodesText`, `SelectionCardGroup`.
|
|
185
|
+
- **Enterprise Workspace Kit**: `AppShell` (collapsible desktop icon rail + mobile slide-over drawer + skip link), `SidebarNavGroup`, `SidebarNavItem` (soft daylight surface active state with left ink indicator bar), `SidebarReturnLink`, `AppSwitcher` / `AppSwitcherTrigger`, `OrgScopeSelector` / `OrgScopeTrigger`, `Breadcrumb`, `PageHeader`, `SectionCard`, `CollapsibleSection`, `SettingsColumn` (focused `46rem` single column), `SettingsGroup`, `SettingsRow`, `MetricGrid`, `MetricCard`, `KeyValueList`, `KeyValueRow`, `CopyableField`, `AppGrid`, `AppCard`, `EnvironmentBadge` (`mode: 'dev' | 'prod'`, optional `alias`).
|
|
186
|
+
- **Loading Kit**: `Spinner`, `Skeleton`, `ListSkeleton` (`plain` or `card`), `CardSkeleton`, `MetricGridSkeleton`, `AppGridSkeleton`, `PageLoadingSkeleton` (`workspace` / `directory` / `list` / `settings` / `detail`), `AppShellSkeleton` (zero-CLS shell boot placeholder replacing blank full-page spinners), `LoadingMore`, `ContentReveal`.
|
|
185
187
|
- **Focus & Toast**: Text inputs use `#f5f5f5` idle surface and white focused surface with one `2px` dark inset outline (`outline-offset: -2px`, no shadow). Non-input controls use keyboard-only `2px` dark outer outline (`outline-offset: 2px`). Toasts sit top-right (`24px` desktop max-width `420px`; `16px` mobile full available width).
|
|
186
188
|
|
|
187
189
|
## Do's and Don'ts
|
|
@@ -182,6 +182,8 @@ Facto uses a **Restrained Daylight Operate** visual system across its user, part
|
|
|
182
182
|
- `size="lg"`: `min-height: 52px`, `padding: 12px 24px`, `16/24/500`, `999px` pill for comfortable standalone/checkout submit actions when explicitly chosen.
|
|
183
183
|
- **Core Primitives**: `Button`, `IconButton` (`44px` hit target, `28/38/44px` visible circle), `TextField`, `Textarea`, `SearchField`, `EnhancedSearchField`, `Field`, `OtpInput`, `ResendCodeButton`, `Select` (borderless default, `bordered` opt-in), `Checkbox` (`44x44` hit target, `20px` visual), `Switch` (`44x44` hit target, `34x20` track), `Badge`, `Notice`, `Surface`, `Card`, `Sheet`, `Dialog`, `ModalHeader`, `ModalFooter`, `Tabs`, `Tooltip`, `Popover`, `DropdownMenu`, `Toast`, `NotificationsProvider`, `FactoTheme`, `FactoMotionProvider`.
|
|
184
184
|
- **Auth & Verification Kit**: `AuthFlowShell`, `StepProgress`, `IdentityEchoPill`, `CopyableSecretKey`, `EmailVerificationStep`, `PasskeySetupCard`, `TotpEnrollmentCard`, `RecoveryCodesStep`, `formatRecoveryCodesText`, `SelectionCardGroup`.
|
|
185
|
+
- **Enterprise Workspace Kit**: `AppShell` (collapsible desktop icon rail + mobile slide-over drawer + skip link), `SidebarNavGroup`, `SidebarNavItem` (soft daylight surface active state with left ink indicator bar), `SidebarReturnLink`, `AppSwitcher` / `AppSwitcherTrigger`, `OrgScopeSelector` / `OrgScopeTrigger`, `Breadcrumb`, `PageHeader`, `SectionCard`, `CollapsibleSection`, `SettingsColumn` (focused `46rem` single column), `SettingsGroup`, `SettingsRow`, `MetricGrid`, `MetricCard`, `KeyValueList`, `KeyValueRow`, `CopyableField`, `AppGrid`, `AppCard`, `EnvironmentBadge` (`mode: 'dev' | 'prod'`, optional `alias`).
|
|
186
|
+
- **Loading Kit**: `Spinner`, `Skeleton`, `ListSkeleton` (`plain` or `card`), `CardSkeleton`, `MetricGridSkeleton`, `AppGridSkeleton`, `PageLoadingSkeleton` (`workspace` / `directory` / `list` / `settings` / `detail`), `AppShellSkeleton` (zero-CLS shell boot placeholder replacing blank full-page spinners), `LoadingMore`, `ContentReveal`.
|
|
185
187
|
- **Focus & Toast**: Text inputs use `#f5f5f5` idle surface and white focused surface with one `2px` dark inset outline (`outline-offset: -2px`, no shadow). Non-input controls use keyboard-only `2px` dark outer outline (`outline-offset: 2px`). Toasts sit top-right (`24px` desktop max-width `420px`; `16px` mobile full available width).
|
|
186
188
|
|
|
187
189
|
## Do's and Don'ts
|
|
@@ -462,6 +462,370 @@ interface SelectionCardGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, '
|
|
|
462
462
|
/** Accessible radio-card selection group for role, workspace, or funding mode steps. */
|
|
463
463
|
declare function SelectionCardGroup({ options, value, onValueChange, columns, ariaLabel, className, ...props }: SelectionCardGroupProps): react.JSX.Element;
|
|
464
464
|
|
|
465
|
+
interface SkeletonProps extends HTMLAttributes<HTMLSpanElement> {
|
|
466
|
+
width?: string | number;
|
|
467
|
+
height?: string | number;
|
|
468
|
+
circle?: boolean;
|
|
469
|
+
block?: boolean;
|
|
470
|
+
}
|
|
471
|
+
/** Decorative neutral loading placeholder. */
|
|
472
|
+
declare function Skeleton({ width, height, circle, block, className, style, ...props }: SkeletonProps): react.JSX.Element;
|
|
473
|
+
type SpinnerSize = 'sm' | 'md' | 'lg';
|
|
474
|
+
type SpinnerTone = 'default' | 'accent' | 'inherit';
|
|
475
|
+
interface SpinnerProps extends HTMLAttributes<HTMLSpanElement> {
|
|
476
|
+
size?: SpinnerSize;
|
|
477
|
+
tone?: SpinnerTone;
|
|
478
|
+
/** Accessible status label. Set `showLabel` to render it visibly next to the ring. */
|
|
479
|
+
label?: string;
|
|
480
|
+
showLabel?: boolean;
|
|
481
|
+
}
|
|
482
|
+
/** Accessible inline loading indicator honoring Facto motion settings. */
|
|
483
|
+
declare function Spinner({ size, tone, label, showLabel, className, ...props }: SpinnerProps): react.JSX.Element;
|
|
484
|
+
interface ListSkeletonProps extends HTMLAttributes<HTMLDivElement> {
|
|
485
|
+
rows?: number;
|
|
486
|
+
label?: string;
|
|
487
|
+
/** Show a circular avatar placeholder on each row. Defaults to true for compatibility. */
|
|
488
|
+
hasAvatar?: boolean;
|
|
489
|
+
/** Show a secondary line and right-aligned pill placeholder per row. */
|
|
490
|
+
hasTrailing?: boolean;
|
|
491
|
+
/** Wrap rows inside a bordered surface card. */
|
|
492
|
+
variant?: 'plain' | 'card';
|
|
493
|
+
}
|
|
494
|
+
/** Loading placeholder only: consumers own the query and loading state. */
|
|
495
|
+
declare function ListSkeleton({ rows, label, hasAvatar, hasTrailing, variant, className, ...props }: ListSkeletonProps): react.JSX.Element;
|
|
496
|
+
interface CardSkeletonProps extends HTMLAttributes<HTMLDivElement> {
|
|
497
|
+
lines?: number;
|
|
498
|
+
hasHeader?: boolean;
|
|
499
|
+
hasFooter?: boolean;
|
|
500
|
+
label?: string;
|
|
501
|
+
}
|
|
502
|
+
/** Structured card loading placeholder matching SectionCard proportions. */
|
|
503
|
+
declare function CardSkeleton({ lines, hasHeader, hasFooter, label, className, ...props }: CardSkeletonProps): react.JSX.Element;
|
|
504
|
+
interface MetricGridSkeletonProps extends HTMLAttributes<HTMLDivElement> {
|
|
505
|
+
count?: 2 | 3 | 4;
|
|
506
|
+
columns?: 2 | 3 | 4;
|
|
507
|
+
label?: string;
|
|
508
|
+
}
|
|
509
|
+
/** Responsive KPI metric grid skeleton matching MetricGrid geometry. */
|
|
510
|
+
declare function MetricGridSkeleton({ count, columns, label, className, ...props }: MetricGridSkeletonProps): react.JSX.Element;
|
|
511
|
+
interface AppGridSkeletonProps extends HTMLAttributes<HTMLDivElement> {
|
|
512
|
+
count?: number;
|
|
513
|
+
columns?: 2 | 3;
|
|
514
|
+
label?: string;
|
|
515
|
+
}
|
|
516
|
+
/** Directory card grid skeleton matching AppGrid & AppCard proportions. */
|
|
517
|
+
declare function AppGridSkeleton({ count, columns, label, className, ...props }: AppGridSkeletonProps): react.JSX.Element;
|
|
518
|
+
type PageLoadingSkeletonVariant = 'workspace' | 'directory' | 'list' | 'settings' | 'detail';
|
|
519
|
+
interface PageLoadingSkeletonProps extends HTMLAttributes<HTMLDivElement> {
|
|
520
|
+
variant?: PageLoadingSkeletonVariant;
|
|
521
|
+
rows?: number;
|
|
522
|
+
label?: string;
|
|
523
|
+
}
|
|
524
|
+
/** Route-level loading silhouette replacing blank screens or raw text status strings. */
|
|
525
|
+
declare function PageLoadingSkeleton({ variant, rows, label, className, ...props }: PageLoadingSkeletonProps): react.JSX.Element;
|
|
526
|
+
interface AppShellSkeletonProps extends HTMLAttributes<HTMLDivElement> {
|
|
527
|
+
navItems?: number;
|
|
528
|
+
pageVariant?: PageLoadingSkeletonVariant;
|
|
529
|
+
/** Optional stable brand lockup shown immediately during boot for zero-CLS continuity. */
|
|
530
|
+
brand?: ReactNode;
|
|
531
|
+
label?: string;
|
|
532
|
+
}
|
|
533
|
+
/** Full-viewport boot skeleton matching AppShell geometry to eliminate white-screen spinners. */
|
|
534
|
+
declare function AppShellSkeleton({ navItems, pageVariant, brand, label, className, ...props }: AppShellSkeletonProps): react.JSX.Element;
|
|
535
|
+
|
|
536
|
+
interface AppShellProps extends HTMLAttributes<HTMLDivElement> {
|
|
537
|
+
/** Top-left brand lockup or home link. Keep clean; never disguise as a dropdown. */
|
|
538
|
+
brand?: ReactNode;
|
|
539
|
+
/** Pinned context area directly below the brand header (e.g. SidebarReturnLink + AppSwitcher). */
|
|
540
|
+
sidebarContext?: ReactNode;
|
|
541
|
+
/** Primary scrollable navigation area inside the left sidebar. */
|
|
542
|
+
sidebar: ReactNode;
|
|
543
|
+
/** Pinned footer at the bottom of the left sidebar (e.g. account identity trigger). */
|
|
544
|
+
sidebarFooter?: ReactNode;
|
|
545
|
+
/** Accessible label for the outer sidebar landmark. */
|
|
546
|
+
sidebarLabel?: string;
|
|
547
|
+
/** Accessible label for the primary navigation landmark inside the sidebar. */
|
|
548
|
+
navLabel?: string;
|
|
549
|
+
/** Topbar left region (e.g. OrgScopeSelector on top-level views, Breadcrumb on nested views). */
|
|
550
|
+
topbarLeft?: ReactNode;
|
|
551
|
+
/** Topbar right region (e.g. search trigger, EnvironmentBadge, notification bell). */
|
|
552
|
+
topbarRight?: ReactNode;
|
|
553
|
+
/** Allow desktop sidebar collapse into a 64px icon rail. Defaults to true. */
|
|
554
|
+
collapsible?: boolean;
|
|
555
|
+
collapsed?: boolean;
|
|
556
|
+
defaultCollapsed?: boolean;
|
|
557
|
+
onCollapsedChange?: (collapsed: boolean) => void;
|
|
558
|
+
/** Optional localStorage key to persist desktop collapse state after hydration. */
|
|
559
|
+
collapseStorageKey?: string;
|
|
560
|
+
mobileNavOpen?: boolean;
|
|
561
|
+
onMobileNavOpenChange?: (open: boolean) => void;
|
|
562
|
+
contentMaxWidth?: 'default' | 'narrow' | 'full';
|
|
563
|
+
skipToContentLabel?: string;
|
|
564
|
+
mainId?: string;
|
|
565
|
+
children: ReactNode;
|
|
566
|
+
}
|
|
567
|
+
/**
|
|
568
|
+
* Persistent enterprise application shell with collapsible desktop rail,
|
|
569
|
+
* mobile slide-over drawer, sticky topbar, and accessible skip-to-content link.
|
|
570
|
+
*/
|
|
571
|
+
declare function AppShell({ brand, sidebarContext, sidebar, sidebarFooter, sidebarLabel, navLabel, topbarLeft, topbarRight, collapsible, collapsed: controlledCollapsed, defaultCollapsed, onCollapsedChange, collapseStorageKey, mobileNavOpen: controlledMobileOpen, onMobileNavOpenChange, contentMaxWidth, skipToContentLabel, mainId, className, children, ...props }: AppShellProps): react.JSX.Element;
|
|
572
|
+
interface SidebarNavGroupProps extends HTMLAttributes<HTMLDivElement> {
|
|
573
|
+
label?: ReactNode;
|
|
574
|
+
badge?: ReactNode;
|
|
575
|
+
children: ReactNode;
|
|
576
|
+
}
|
|
577
|
+
/** Semantic group of SidebarNavItem entries separated by hairline dividers. */
|
|
578
|
+
declare function SidebarNavGroup({ label, badge, className, children, ...props }: SidebarNavGroupProps): react.JSX.Element;
|
|
579
|
+
interface SidebarNavItemSharedProps {
|
|
580
|
+
icon?: ReactNode;
|
|
581
|
+
label: ReactNode;
|
|
582
|
+
badge?: ReactNode;
|
|
583
|
+
active?: boolean;
|
|
584
|
+
className?: string;
|
|
585
|
+
}
|
|
586
|
+
type SidebarNavItemLinkProps = SidebarNavItemSharedProps & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> & {
|
|
587
|
+
href: string;
|
|
588
|
+
};
|
|
589
|
+
type SidebarNavItemButtonProps = SidebarNavItemSharedProps & Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> & {
|
|
590
|
+
href?: undefined;
|
|
591
|
+
};
|
|
592
|
+
type SidebarNavItemProps = SidebarNavItemLinkProps | SidebarNavItemButtonProps;
|
|
593
|
+
/** Navigation destination rendered as an anchor (`href`) or action button inside SidebarNavGroup. */
|
|
594
|
+
declare const SidebarNavItem: react.ForwardRefExoticComponent<SidebarNavItemProps & react.RefAttributes<HTMLElement>>;
|
|
595
|
+
interface SidebarReturnLinkSharedProps {
|
|
596
|
+
label: ReactNode;
|
|
597
|
+
icon?: ReactNode;
|
|
598
|
+
className?: string;
|
|
599
|
+
}
|
|
600
|
+
type SidebarReturnLinkAnchorProps = SidebarReturnLinkSharedProps & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> & {
|
|
601
|
+
href: string;
|
|
602
|
+
};
|
|
603
|
+
type SidebarReturnLinkButtonProps = SidebarReturnLinkSharedProps & Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> & {
|
|
604
|
+
href?: undefined;
|
|
605
|
+
};
|
|
606
|
+
type SidebarReturnLinkProps = SidebarReturnLinkAnchorProps | SidebarReturnLinkButtonProps;
|
|
607
|
+
/** Explicit destination return link for scoped Level-2 sidebars (name by destination, e.g. "Applications"). */
|
|
608
|
+
declare const SidebarReturnLink: react.ForwardRefExoticComponent<SidebarReturnLinkProps & react.RefAttributes<HTMLElement>>;
|
|
609
|
+
interface ScopeSwitcherItem {
|
|
610
|
+
id: string;
|
|
611
|
+
name: string;
|
|
612
|
+
meta?: ReactNode;
|
|
613
|
+
trailing?: ReactNode;
|
|
614
|
+
disabled?: boolean;
|
|
615
|
+
}
|
|
616
|
+
interface AppSwitcherTriggerProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'name'> {
|
|
617
|
+
icon?: ReactNode;
|
|
618
|
+
name: ReactNode;
|
|
619
|
+
meta?: ReactNode;
|
|
620
|
+
}
|
|
621
|
+
/** Standalone styled trigger for custom application switchers. */
|
|
622
|
+
declare const AppSwitcherTrigger: react.ForwardRefExoticComponent<AppSwitcherTriggerProps & react.RefAttributes<HTMLButtonElement>>;
|
|
623
|
+
interface AppSwitcherProps {
|
|
624
|
+
icon?: ReactNode;
|
|
625
|
+
name: string;
|
|
626
|
+
meta?: ReactNode;
|
|
627
|
+
items: readonly ScopeSwitcherItem[];
|
|
628
|
+
activeId?: string;
|
|
629
|
+
onSelect: (id: string) => void;
|
|
630
|
+
menuLabel?: string;
|
|
631
|
+
headerAction?: ReactNode;
|
|
632
|
+
footerAction?: {
|
|
633
|
+
label: string;
|
|
634
|
+
onSelect: () => void;
|
|
635
|
+
};
|
|
636
|
+
emptyLabel?: string;
|
|
637
|
+
className?: string;
|
|
638
|
+
}
|
|
639
|
+
/** Dedicated Level-2 application switcher built on portalled Radix DropdownMenu (zero clipping). */
|
|
640
|
+
declare function AppSwitcher({ icon, name, meta, items, activeId, onSelect, menuLabel, headerAction, footerAction, emptyLabel, className, }: AppSwitcherProps): react.JSX.Element;
|
|
641
|
+
interface OrgScopeTriggerProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'name'> {
|
|
642
|
+
avatar?: ReactNode;
|
|
643
|
+
name: string;
|
|
644
|
+
}
|
|
645
|
+
/** Standalone styled trigger for topbar organization scope selectors. */
|
|
646
|
+
declare const OrgScopeTrigger: react.ForwardRefExoticComponent<OrgScopeTriggerProps & react.RefAttributes<HTMLButtonElement>>;
|
|
647
|
+
interface OrgScopeSelectorProps {
|
|
648
|
+
avatar?: ReactNode;
|
|
649
|
+
name: string;
|
|
650
|
+
items: readonly ScopeSwitcherItem[];
|
|
651
|
+
activeId?: string;
|
|
652
|
+
onSelect: (id: string) => void;
|
|
653
|
+
menuLabel?: string;
|
|
654
|
+
footerAction?: {
|
|
655
|
+
label: string;
|
|
656
|
+
onSelect: () => void;
|
|
657
|
+
};
|
|
658
|
+
emptyLabel?: string;
|
|
659
|
+
className?: string;
|
|
660
|
+
}
|
|
661
|
+
/** Topbar Level-1 organization scope selector built on portalled Radix DropdownMenu. */
|
|
662
|
+
declare function OrgScopeSelector({ avatar, name, items, activeId, onSelect, menuLabel, footerAction, emptyLabel, className, }: OrgScopeSelectorProps): react.JSX.Element;
|
|
663
|
+
interface BreadcrumbItem {
|
|
664
|
+
label: ReactNode;
|
|
665
|
+
href?: string;
|
|
666
|
+
onClick?: MouseEventHandler<HTMLButtonElement>;
|
|
667
|
+
current?: boolean;
|
|
668
|
+
}
|
|
669
|
+
interface BreadcrumbProps extends HTMLAttributes<HTMLElement> {
|
|
670
|
+
items: readonly BreadcrumbItem[];
|
|
671
|
+
label?: string;
|
|
672
|
+
}
|
|
673
|
+
/** Hierarchical location trail for Level-2+ views (omits ancestor crumbs below 600px). */
|
|
674
|
+
declare function Breadcrumb({ items, label, className, ...props }: BreadcrumbProps): react.JSX.Element | null;
|
|
675
|
+
interface PageHeaderProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
|
|
676
|
+
title: ReactNode;
|
|
677
|
+
badge?: ReactNode;
|
|
678
|
+
description?: ReactNode;
|
|
679
|
+
actions?: ReactNode;
|
|
680
|
+
headingAs?: 'h1' | 'h2';
|
|
681
|
+
}
|
|
682
|
+
/** Consistent top-of-view page header with balanced title wrapping and responsive action slot. */
|
|
683
|
+
declare function PageHeader({ title, badge, description, actions, headingAs, className, ...props }: PageHeaderProps): react.JSX.Element;
|
|
684
|
+
interface SectionCardProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
|
|
685
|
+
title?: ReactNode;
|
|
686
|
+
description?: ReactNode;
|
|
687
|
+
headerAction?: ReactNode;
|
|
688
|
+
bodyPadding?: 'default' | 'compact' | 'none';
|
|
689
|
+
footer?: ReactNode;
|
|
690
|
+
children: ReactNode;
|
|
691
|
+
}
|
|
692
|
+
/** Hairline-bordered workspace section card with structured header, body, and optional footer. */
|
|
693
|
+
declare function SectionCard({ title, description, headerAction, bodyPadding, footer, className, children, ...props }: SectionCardProps): react.JSX.Element;
|
|
694
|
+
interface CollapsibleSectionProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
|
|
695
|
+
title: ReactNode;
|
|
696
|
+
summary?: ReactNode;
|
|
697
|
+
open?: boolean;
|
|
698
|
+
defaultOpen?: boolean;
|
|
699
|
+
onOpenChange?: (open: boolean) => void;
|
|
700
|
+
children: ReactNode;
|
|
701
|
+
}
|
|
702
|
+
/** Progressive-disclosure section card for secondary metadata, session scopes, or audit trails. */
|
|
703
|
+
declare function CollapsibleSection({ title, summary, open: controlledOpen, defaultOpen, onOpenChange, className, children, ...props }: CollapsibleSectionProps): react.JSX.Element;
|
|
704
|
+
interface SettingsColumnProps extends HTMLAttributes<HTMLDivElement> {
|
|
705
|
+
width?: 'focused' | 'full';
|
|
706
|
+
children: ReactNode;
|
|
707
|
+
}
|
|
708
|
+
/** Focused 46rem single-column container for account, security, and application settings. */
|
|
709
|
+
declare function SettingsColumn({ width, className, ...props }: SettingsColumnProps): react.JSX.Element;
|
|
710
|
+
interface SettingsGroupProps extends Omit<HTMLAttributes<HTMLElement>, 'title'> {
|
|
711
|
+
title: ReactNode;
|
|
712
|
+
badge?: ReactNode;
|
|
713
|
+
description?: ReactNode;
|
|
714
|
+
action?: ReactNode;
|
|
715
|
+
children: ReactNode;
|
|
716
|
+
}
|
|
717
|
+
/** Grouped settings rows with an external section heading above a single hairline card. */
|
|
718
|
+
declare function SettingsGroup({ title, badge, description, action, className, children, ...props }: SettingsGroupProps): react.JSX.Element;
|
|
719
|
+
interface SettingsRowProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
|
|
720
|
+
icon?: ReactNode;
|
|
721
|
+
title: ReactNode;
|
|
722
|
+
badge?: ReactNode;
|
|
723
|
+
description?: ReactNode;
|
|
724
|
+
monoDescription?: boolean;
|
|
725
|
+
control?: ReactNode;
|
|
726
|
+
}
|
|
727
|
+
/** Single scannable setting row with optional leading icon, status badge, and right-aligned control. */
|
|
728
|
+
declare function SettingsRow({ icon, title, badge, description, monoDescription, control, className, ...props }: SettingsRowProps): react.JSX.Element;
|
|
729
|
+
interface MetricGridProps extends HTMLAttributes<HTMLDivElement> {
|
|
730
|
+
columns?: 2 | 3 | 4;
|
|
731
|
+
children: ReactNode;
|
|
732
|
+
}
|
|
733
|
+
/** Responsive KPI metric grid (4->2->1 columns). */
|
|
734
|
+
declare function MetricGrid({ columns, className, ...props }: MetricGridProps): react.JSX.Element;
|
|
735
|
+
interface MetricCardSharedProps {
|
|
736
|
+
label: ReactNode;
|
|
737
|
+
value: ReactNode;
|
|
738
|
+
meta?: ReactNode;
|
|
739
|
+
badge?: ReactNode;
|
|
740
|
+
className?: string;
|
|
741
|
+
}
|
|
742
|
+
type MetricCardStaticProps = MetricCardSharedProps & Omit<HTMLAttributes<HTMLDivElement>, 'children'>;
|
|
743
|
+
type MetricCardLinkProps = MetricCardSharedProps & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'children'> & {
|
|
744
|
+
href: string;
|
|
745
|
+
};
|
|
746
|
+
type MetricCardButtonProps = MetricCardSharedProps & Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children'> & {
|
|
747
|
+
onClick: MouseEventHandler<HTMLButtonElement>;
|
|
748
|
+
};
|
|
749
|
+
type MetricCardProps = MetricCardStaticProps | MetricCardLinkProps | MetricCardButtonProps;
|
|
750
|
+
/** Compact KPI card using tabular numerals; interactive when `href` or `onClick` is supplied. */
|
|
751
|
+
declare const MetricCard: react.ForwardRefExoticComponent<MetricCardProps & react.RefAttributes<HTMLElement>>;
|
|
752
|
+
interface KeyValueItemData {
|
|
753
|
+
label: ReactNode;
|
|
754
|
+
value: ReactNode;
|
|
755
|
+
mono?: boolean;
|
|
756
|
+
copyValue?: string;
|
|
757
|
+
}
|
|
758
|
+
interface KeyValueRowProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCopy'> {
|
|
759
|
+
label: ReactNode;
|
|
760
|
+
value: ReactNode;
|
|
761
|
+
mono?: boolean;
|
|
762
|
+
copyValue?: string;
|
|
763
|
+
onCopy?: (value: string) => void;
|
|
764
|
+
}
|
|
765
|
+
/** Single definition row inside KeyValueList. */
|
|
766
|
+
declare function KeyValueRow({ label, value, mono, copyValue, onCopy, className, ...props }: KeyValueRowProps): react.JSX.Element;
|
|
767
|
+
interface KeyValueListProps extends Omit<HTMLAttributes<HTMLDListElement>, 'onCopy'> {
|
|
768
|
+
items?: readonly KeyValueItemData[];
|
|
769
|
+
onCopy?: (value: string) => void;
|
|
770
|
+
children?: ReactNode;
|
|
771
|
+
}
|
|
772
|
+
/** Semantic `<dl>` key-value list separated by subtle hairlines. */
|
|
773
|
+
declare function KeyValueList({ items, onCopy, className, children, ...props }: KeyValueListProps): react.JSX.Element;
|
|
774
|
+
interface CopyableFieldProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onCopy'> {
|
|
775
|
+
label: ReactNode;
|
|
776
|
+
value: string;
|
|
777
|
+
hint?: ReactNode;
|
|
778
|
+
mono?: boolean;
|
|
779
|
+
copyLabel?: string;
|
|
780
|
+
copiedLabel?: string;
|
|
781
|
+
onCopy?: (value: string) => void;
|
|
782
|
+
}
|
|
783
|
+
/** Read-only identifier copy control with reflow-safe wrapping and nested 10px Copy action. */
|
|
784
|
+
declare function CopyableField({ label, value, hint, mono, copyLabel, copiedLabel, onCopy, className, ...props }: CopyableFieldProps): react.JSX.Element;
|
|
785
|
+
type EnvironmentMode = 'dev' | 'prod';
|
|
786
|
+
interface EnvironmentBadgeProps extends HTMLAttributes<HTMLSpanElement> {
|
|
787
|
+
mode: EnvironmentMode;
|
|
788
|
+
/** Override tag text (defaults to "DEV" for dev, "PROD" for prod). */
|
|
789
|
+
label?: string;
|
|
790
|
+
/** Optional partner-defined environment alias. Rendered only when non-empty. */
|
|
791
|
+
alias?: string | null;
|
|
792
|
+
/** Hide the alias on narrow viewports (useful inside compact topbars). */
|
|
793
|
+
hideAliasOnMobile?: boolean;
|
|
794
|
+
/** Render as an interactive button pill when provided (e.g. to open an alias popover). */
|
|
795
|
+
onClick?: MouseEventHandler<HTMLButtonElement>;
|
|
796
|
+
}
|
|
797
|
+
/** Explicit system environment marker (`DEV` / `PROD`) with optional custom alias. */
|
|
798
|
+
declare function EnvironmentBadge({ mode, label, alias, hideAliasOnMobile, onClick, className, ...props }: EnvironmentBadgeProps): react.JSX.Element;
|
|
799
|
+
interface AppGridProps extends HTMLAttributes<HTMLDivElement> {
|
|
800
|
+
columns?: 2 | 3;
|
|
801
|
+
children: ReactNode;
|
|
802
|
+
}
|
|
803
|
+
/** Responsive application directory card grid (3->2->1 columns). */
|
|
804
|
+
declare function AppGrid({ columns, className, ...props }: AppGridProps): react.JSX.Element;
|
|
805
|
+
interface AppCardSharedProps {
|
|
806
|
+
icon?: ReactNode;
|
|
807
|
+
name: ReactNode;
|
|
808
|
+
subtitle?: ReactNode;
|
|
809
|
+
environment?: EnvironmentMode;
|
|
810
|
+
environmentLabel?: string;
|
|
811
|
+
envAlias?: string | null;
|
|
812
|
+
topTrailing?: ReactNode;
|
|
813
|
+
status?: ReactNode;
|
|
814
|
+
meta?: ReactNode;
|
|
815
|
+
actionLabel?: ReactNode;
|
|
816
|
+
className?: string;
|
|
817
|
+
}
|
|
818
|
+
type AppCardStaticProps = AppCardSharedProps & Omit<HTMLAttributes<HTMLDivElement>, 'children'>;
|
|
819
|
+
type AppCardLinkProps = AppCardSharedProps & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'children' | 'name'> & {
|
|
820
|
+
href: string;
|
|
821
|
+
};
|
|
822
|
+
type AppCardButtonProps = AppCardSharedProps & Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'children' | 'name'> & {
|
|
823
|
+
onClick: MouseEventHandler<HTMLButtonElement>;
|
|
824
|
+
};
|
|
825
|
+
type AppCardProps = AppCardStaticProps | AppCardLinkProps | AppCardButtonProps;
|
|
826
|
+
/** Scannable selection card for application directories without exposing sensitive identifiers. */
|
|
827
|
+
declare const AppCard: react.ForwardRefExoticComponent<AppCardProps & react.RefAttributes<HTMLElement>>;
|
|
828
|
+
|
|
465
829
|
type FactoThemeTokens = Partial<Record<`--facto-${string}`, string | number>>;
|
|
466
830
|
type ThemeTokens = FactoThemeTokens;
|
|
467
831
|
interface FactoThemeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'> {
|
|
@@ -474,7 +838,7 @@ interface FactoThemeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'style'>
|
|
|
474
838
|
/** Scoped token container. Inline `--facto-*` values are forwarded to portalled overlays. */
|
|
475
839
|
declare function FactoTheme({ className, tokens, style, motion, ...props }: FactoThemeProps): react.JSX.Element;
|
|
476
840
|
/** Shared decorative symbols; name the containing control, not the glyph. */
|
|
477
|
-
type IconName = 'close' | 'arrowLeft' | 'check' | 'chevronDown' | 'chevronRight' | 'info' | 'warning' | 'plus' | 'chevronLeft' | 'copy' | 'search';
|
|
841
|
+
type IconName = 'close' | 'arrowLeft' | 'arrowRight' | 'check' | 'chevronDown' | 'chevronRight' | 'chevronsUpDown' | 'info' | 'warning' | 'plus' | 'chevronLeft' | 'copy' | 'search' | 'menu' | 'panelLeft';
|
|
478
842
|
interface IconProps extends SVGProps<SVGSVGElement> {
|
|
479
843
|
name: IconName;
|
|
480
844
|
size?: number;
|
|
@@ -624,13 +988,6 @@ interface SheetContentProps extends ComponentPropsWithoutRef<typeof DialogPrimit
|
|
|
624
988
|
}
|
|
625
989
|
/** Focus-managed side or mobile-bottom sheet. */
|
|
626
990
|
declare function SheetContent({ side, motionVariant, motion, className, style, children, ...props }: SheetContentProps): react.JSX.Element;
|
|
627
|
-
interface SkeletonProps extends HTMLAttributes<HTMLSpanElement> {
|
|
628
|
-
width?: string | number;
|
|
629
|
-
height?: string | number;
|
|
630
|
-
circle?: boolean;
|
|
631
|
-
}
|
|
632
|
-
/** Decorative neutral loading placeholder. */
|
|
633
|
-
declare function Skeleton({ width, height, circle, className, style, ...props }: SkeletonProps): react.JSX.Element;
|
|
634
991
|
interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
|
|
635
992
|
title: ReactNode;
|
|
636
993
|
description?: ReactNode;
|
|
@@ -707,12 +1064,6 @@ interface FilterChipProps extends ButtonHTMLAttributes<HTMLButtonElement> {
|
|
|
707
1064
|
}
|
|
708
1065
|
/** Compact toggle for a caller-owned filter. */
|
|
709
1066
|
declare function FilterChip({ selected, className, type, ...props }: FilterChipProps): react.JSX.Element;
|
|
710
|
-
interface ListSkeletonProps extends HTMLAttributes<HTMLDivElement> {
|
|
711
|
-
rows?: number;
|
|
712
|
-
label?: string;
|
|
713
|
-
}
|
|
714
|
-
/** Loading placeholder only: consumers own the query and loading state. */
|
|
715
|
-
declare function ListSkeleton({ rows, label, className, ...props }: ListSkeletonProps): react.JSX.Element;
|
|
716
1067
|
|
|
717
|
-
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 };
|
|
718
|
-
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 };
|
|
1068
|
+
export { AnimatedDisclosure, AnimatedFeedback, AppCard, AppGrid, AppGridSkeleton, AppShell, AppShellSkeleton, AppSwitcher, AppSwitcherTrigger, AuthFlowShell, Avatar, Badge, Breadcrumb, Button, Card, CardSkeleton, Checkbox, CollapsibleSection, ContentReveal, CopyableField, CopyableSecretKey, DashboardGrid, Dialog, DialogClose, DialogContent, DialogDescription, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, EmailVerificationStep, EmptyState, EnhancedSearchField, EnvironmentBadge, ErrorState, FactoMotionProvider, FactoTheme, Field, FilterChip, Icon, IconButton, IdentityEchoPill, KeyValueList, KeyValueRow, ListGroup, ListRow, ListSkeleton, LoadingMore, LogoStack, MetricCard, MetricGrid, MetricGridSkeleton, ModalFooter, ModalHeader, Notice, NotificationsProvider, OrgScopeSelector, OrgScopeTrigger, OtpInput, PageHeader, PageLoadingSkeleton, PasskeySetupCard, Popover, PopoverClose, PopoverContent, PopoverTrigger, RecoveryCodesStep, ResendCodeButton, SearchField, SectionCard, Select, SelectionCardGroup, SelectionMotion, SettingsColumn, SettingsGroup, SettingsRow, Sheet, SheetClose, SheetContent, SheetDescription, SheetTitle, SheetTrigger, SidebarNavGroup, SidebarNavItem, SidebarReturnLink, Skeleton, Spinner, 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 };
|
|
1069
|
+
export type { AnimatedDisclosureProps, AnimatedFeedbackProps, AppCardButtonProps, AppCardLinkProps, AppCardProps, AppCardStaticProps, AppGridProps, AppGridSkeletonProps, AppShellProps, AppShellSkeletonProps, AppSwitcherProps, AppSwitcherTriggerProps, AuthFlowShellProps, AvatarProps, BadgeProps, BadgeTone, BreadcrumbItem, BreadcrumbProps, ButtonProps, ButtonSize, ButtonVariant, CardSkeletonProps, CheckboxProps, CollapsibleSectionProps, ContentRevealProps, CopyableFieldProps, CopyableSecretKeyProps, DialogContentProps, EmailVerificationStepProps, EmptyStateProps, EnhancedSearchFieldProps, EnvironmentBadgeProps, EnvironmentMode, ErrorStateProps, FactoThemeProps, FactoThemeTokens, FieldProps, FilterChipProps, IconButtonProps, IconName, IconProps, IdentityEchoPillProps, KeyValueItemData, KeyValueListProps, KeyValueRowProps, ListGroupProps, ListRowButtonProps, ListRowLinkProps, ListRowProps, ListRowSlots, ListRowStaticProps, ListSkeletonProps, LoadingMoreProps, LogoStackItem, LogoStackProps, MetricCardButtonProps, MetricCardLinkProps, MetricCardProps, MetricCardStaticProps, MetricGridProps, MetricGridSkeletonProps, MotionMode, MotionOverride, NoticeProps, NoticeTone, NotificationsProviderProps, OrgScopeSelectorProps, OrgScopeTriggerProps, OtpInputProps, OverlayMotionVariant, PageHeaderProps, PageLoadingSkeletonProps, PageLoadingSkeletonVariant, PasskeySetupCardProps, RecoveryCodesStepProps, ResendCodeButtonProps, ScopeSwitcherItem, SearchFieldProps, SectionCardProps, SelectItem, SelectProps, SelectionCardGroupProps, SelectionCardOption, SelectionMotionProps, SettingsColumnProps, SettingsGroupProps, SettingsRowProps, SheetContentProps, SidebarNavGroupProps, SidebarNavItemButtonProps, SidebarNavItemLinkProps, SidebarNavItemProps, SidebarReturnLinkAnchorProps, SidebarReturnLinkButtonProps, SidebarReturnLinkProps, SkeletonProps, SpinnerProps, SpinnerSize, SpinnerTone, 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,17 +1,28 @@
|
|
|
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.11",
|
|
5
5
|
"exports": [
|
|
6
6
|
"AnimatedDisclosure",
|
|
7
7
|
"AnimatedFeedback",
|
|
8
|
+
"AppCard",
|
|
9
|
+
"AppGrid",
|
|
10
|
+
"AppGridSkeleton",
|
|
11
|
+
"AppShell",
|
|
12
|
+
"AppShellSkeleton",
|
|
13
|
+
"AppSwitcher",
|
|
14
|
+
"AppSwitcherTrigger",
|
|
8
15
|
"AuthFlowShell",
|
|
9
16
|
"Avatar",
|
|
10
17
|
"Badge",
|
|
18
|
+
"Breadcrumb",
|
|
11
19
|
"Button",
|
|
12
20
|
"Card",
|
|
21
|
+
"CardSkeleton",
|
|
13
22
|
"Checkbox",
|
|
23
|
+
"CollapsibleSection",
|
|
14
24
|
"ContentReveal",
|
|
25
|
+
"CopyableField",
|
|
15
26
|
"CopyableSecretKey",
|
|
16
27
|
"DashboardGrid",
|
|
17
28
|
"Dialog",
|
|
@@ -28,6 +39,7 @@
|
|
|
28
39
|
"EmailVerificationStep",
|
|
29
40
|
"EmptyState",
|
|
30
41
|
"EnhancedSearchField",
|
|
42
|
+
"EnvironmentBadge",
|
|
31
43
|
"ErrorState",
|
|
32
44
|
"FactoMotionProvider",
|
|
33
45
|
"FactoTheme",
|
|
@@ -36,16 +48,25 @@
|
|
|
36
48
|
"Icon",
|
|
37
49
|
"IconButton",
|
|
38
50
|
"IdentityEchoPill",
|
|
51
|
+
"KeyValueList",
|
|
52
|
+
"KeyValueRow",
|
|
39
53
|
"ListGroup",
|
|
40
54
|
"ListRow",
|
|
41
55
|
"ListSkeleton",
|
|
42
56
|
"LoadingMore",
|
|
43
57
|
"LogoStack",
|
|
58
|
+
"MetricCard",
|
|
59
|
+
"MetricGrid",
|
|
60
|
+
"MetricGridSkeleton",
|
|
44
61
|
"ModalFooter",
|
|
45
62
|
"ModalHeader",
|
|
46
63
|
"Notice",
|
|
47
64
|
"NotificationsProvider",
|
|
65
|
+
"OrgScopeSelector",
|
|
66
|
+
"OrgScopeTrigger",
|
|
48
67
|
"OtpInput",
|
|
68
|
+
"PageHeader",
|
|
69
|
+
"PageLoadingSkeleton",
|
|
49
70
|
"PasskeySetupCard",
|
|
50
71
|
"Popover",
|
|
51
72
|
"PopoverClose",
|
|
@@ -54,16 +75,24 @@
|
|
|
54
75
|
"RecoveryCodesStep",
|
|
55
76
|
"ResendCodeButton",
|
|
56
77
|
"SearchField",
|
|
78
|
+
"SectionCard",
|
|
57
79
|
"Select",
|
|
58
80
|
"SelectionCardGroup",
|
|
59
81
|
"SelectionMotion",
|
|
82
|
+
"SettingsColumn",
|
|
83
|
+
"SettingsGroup",
|
|
84
|
+
"SettingsRow",
|
|
60
85
|
"Sheet",
|
|
61
86
|
"SheetClose",
|
|
62
87
|
"SheetContent",
|
|
63
88
|
"SheetDescription",
|
|
64
89
|
"SheetTitle",
|
|
65
90
|
"SheetTrigger",
|
|
91
|
+
"SidebarNavGroup",
|
|
92
|
+
"SidebarNavItem",
|
|
93
|
+
"SidebarReturnLink",
|
|
66
94
|
"Skeleton",
|
|
95
|
+
"Spinner",
|
|
67
96
|
"Stack",
|
|
68
97
|
"StepChecklist",
|
|
69
98
|
"StepProgress",
|
|
@@ -13,7 +13,7 @@ See catalog.json for the exact runtime exports and api.d.ts for types. The catal
|
|
|
13
13
|
- Motion: FactoMotionProvider, useMotion, motionTokens, StepTransition, AnimatedDisclosure, AnimatedFeedback, ContentReveal, SelectionMotion, useKeyedListMotion. Read [motion.md](motion.md) for global/individual controls and application-state boundaries.
|
|
14
14
|
- Theme: FactoTheme and FactoThemeTokens type. Defaults work without custom values; inline token overrides are forwarded to portals.
|
|
15
15
|
|
|
16
|
-
There is no exported Table, DataTable, DatePicker, Chart,
|
|
16
|
+
There is no exported Table, DataTable, DatePicker, Chart, Form controller or router. Keep host implementations for these and apply scoped tokens, or choose a separate dependency only when the task needs it. Do not import internal dist files, copy source modules or claim shadcn-compatible props merely because the implementation uses Radix.
|
|
17
17
|
|
|
18
18
|
## Overlay motion
|
|
19
19
|
|
|
@@ -53,3 +53,12 @@ Use the shared UI-only auth and verification components across login, onboarding
|
|
|
53
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
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
55
|
- `SelectionCardGroup`: accessible `role="radiogroup"` selection cards for workspace, role, or mode choices.
|
|
56
|
+
|
|
57
|
+
## Enterprise workspace and loading kit (beta.11)
|
|
58
|
+
|
|
59
|
+
Use the enterprise workspace and loading primitives for multi-view partner, developer, and operator portals while keeping routing, authentication, and data fetching in the host:
|
|
60
|
+
|
|
61
|
+
- **Shell & Scope Navigation**: `AppShell` (sticky desktop sidebar, desktop-only collapsible `64px` icon rail with optional `collapseStorageKey`, mobile slide-over drawer with Escape dismiss, sticky topbar, skip-to-content link), `SidebarNavGroup`, `SidebarNavItem` (`href` anchor or button with soft surface active state), `SidebarReturnLink` (explicit destination return link for Level-2 scoped sidebars), `OrgScopeSelector` / `OrgScopeTrigger` (Level-1 topbar organization selector on portalled Radix `DropdownMenu`), and `AppSwitcher` / `AppSwitcherTrigger` (Level-2 sidebar application switcher on portalled Radix `DropdownMenu`).
|
|
62
|
+
- **Page Structure & Settings**: `Breadcrumb` (Level-2+ location trail that collapses ancestor items below `600px`), `PageHeader`, `SectionCard`, `CollapsibleSection`, and focused `46rem` single-column `SettingsColumn`, `SettingsGroup`, and `SettingsRow`.
|
|
63
|
+
- **Data & Application Directory**: `MetricGrid`, `MetricCard`, `KeyValueList`, `KeyValueRow`, `CopyableField` (reflow-safe wrapping with nested `10px` Copy button), `AppGrid`, `AppCard`, and `EnvironmentBadge` (`mode: 'dev' | 'prod'`, optional custom `alias` shown only when non-empty).
|
|
64
|
+
- **Loading Kit**: `Spinner`, `Skeleton`, `ListSkeleton` (`variant="card"` + `hasTrailing`), `CardSkeleton`, `MetricGridSkeleton`, `AppGridSkeleton`, `PageLoadingSkeleton` (`workspace` / `directory` / `list` / `settings` / `detail`), and `AppShellSkeleton` (full-viewport boot skeleton replacing blank white spinners).
|
|
@@ -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.11
|
|
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.
|
|
@@ -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.11",
|
|
5
5
|
"peerDependencies": {
|
|
6
6
|
"react": "^19.0.0",
|
|
7
7
|
"react-dom": "^19.0.0"
|
|
@@ -11,9 +11,9 @@
|
|
|
11
11
|
"owner": "Facto-to/design-system",
|
|
12
12
|
"visualContract": "references/DESIGN.md",
|
|
13
13
|
"qaContract": "references/qa-contract.md",
|
|
14
|
-
"designMdSha256": "
|
|
14
|
+
"designMdSha256": "f54d348b172b366f6286305bbbf54368d38927db819517e625ed37fa3910786a",
|
|
15
15
|
"qaContractSha256": "f78f66f3cb0493f68943bbe68431dea9825e6bbd4cc4e685362c99b483b463f9"
|
|
16
16
|
},
|
|
17
|
-
"apiSha256": "
|
|
17
|
+
"apiSha256": "74faf62fe52d2e1fe263481c089ba659cfba1e01115a69728e133687bdbf5acc",
|
|
18
18
|
"tokensSha256": "c4c6a1792221c54042e9c95ea351fc84f0c3920128c5115a6b99b1ded6e79c86"
|
|
19
19
|
}
|