@sequenceholdings/atlas-ui 3.3.0 → 3.4.1

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
@@ -140,6 +140,46 @@ declare interface AppStatusBadgeProps {
140
140
  className?: string;
141
141
  }
142
142
 
143
+ export declare function ArtifactAppShell({ header, status, navigation, footer, children, className, contentClassName, scrollMode, ...props }: ArtifactAppShellProps): JSX.Element;
144
+
145
+ export declare type ArtifactAppShellProps = ComponentProps<'div'> & {
146
+ header?: ReactNode;
147
+ status?: ReactNode;
148
+ navigation?: ReactNode;
149
+ footer?: ReactNode;
150
+ contentClassName?: string;
151
+ scrollMode?: ArtifactAppShellScrollMode;
152
+ };
153
+
154
+ export declare type ArtifactAppShellScrollMode = 'document' | 'contained';
155
+
156
+ export declare function ArtifactOfflineControl({ status, onEnrolledChange, disabled, compact, className, icon, }: {
157
+ status: ArtifactOfflineUiStatus;
158
+ onEnrolledChange: (enrolled: boolean) => void;
159
+ disabled?: boolean;
160
+ compact?: boolean;
161
+ className?: string;
162
+ icon?: ReactNode;
163
+ }): JSX.Element;
164
+
165
+ export declare interface ArtifactOfflineStatusCopy {
166
+ title: string;
167
+ subtitle: string;
168
+ ariaLabel: string;
169
+ tone: 'neutral' | 'ready' | 'warning' | 'danger';
170
+ }
171
+
172
+ export declare interface ArtifactOfflineUiStatus {
173
+ enrolled: boolean;
174
+ online: boolean;
175
+ pending: number;
176
+ failed: number;
177
+ syncing: boolean;
178
+ loading: boolean;
179
+ updating: boolean;
180
+ error?: string | null;
181
+ }
182
+
143
183
  /**
144
184
  * Button that reflects the lifecycle of an async mutation:
145
185
  * idle → pending (spinner) → success/error (auto-resets).
@@ -327,7 +367,7 @@ export declare interface ButtonProps extends React_2.ButtonHTMLAttributes<HTMLBu
327
367
 
328
368
  export declare const buttonVariants: (props?: ({
329
369
  variant?: "default" | "link" | "secondary" | "destructive" | "outline" | "ghost" | "submit" | null | undefined;
330
- size?: "default" | "sm" | "icon" | "lg" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
370
+ size?: "default" | "touch" | "sm" | "icon" | "lg" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | "icon-touch" | null | undefined;
331
371
  } & ClassProp) | undefined) => string;
332
372
 
333
373
  export declare function Calendar({ className, classNames, showOutsideDays, ...props }: React_2.ComponentProps<typeof DayPicker>): JSX.Element;
@@ -1068,10 +1108,20 @@ export declare namespace DialogHeader {
1068
1108
  var displayName: string;
1069
1109
  }
1070
1110
 
1111
+ export declare function DialogLayer({ children, className, }: {
1112
+ children: React_2.ReactNode;
1113
+ className?: string;
1114
+ }): JSX.Element;
1115
+
1071
1116
  export declare const DialogOverlay: React_2.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
1072
1117
 
1073
1118
  export declare function DialogPortal({ container, ...props }: React_2.ComponentProps<typeof DialogPrimitive.Portal>): JSX.Element;
1074
1119
 
1120
+ /** Highest z-index this dialog content claims, at least the inbox dialog floor. */
1121
+ export declare function dialogStackZ({ className }: {
1122
+ className?: string;
1123
+ }): number;
1124
+
1075
1125
  export declare const DialogTitle: React_2.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React_2.RefAttributes<HTMLHeadingElement>, "ref"> & React_2.RefAttributes<HTMLHeadingElement>>;
1076
1126
 
1077
1127
  export declare const DialogTrigger: React_2.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React_2.RefAttributes<HTMLButtonElement>>;
@@ -1532,6 +1582,8 @@ export declare interface FilterSelectProps<T extends string> {
1532
1582
  onChange: (next: T[]) => void;
1533
1583
  }
1534
1584
 
1585
+ export declare function formatArtifactOfflineStatus(status: ArtifactOfflineUiStatus): ArtifactOfflineStatusCopy;
1586
+
1535
1587
  /**
1536
1588
  * Format a byte count to a human-readable string. Matches the
1537
1589
  * conventions users expect in file dialogs: 1024-base, one decimal
@@ -1850,6 +1902,19 @@ declare interface LineSparklineCellProps {
1850
1902
  className?: string;
1851
1903
  }
1852
1904
 
1905
+ declare const MENU_OFFSET: {
1906
+ readonly select: 10;
1907
+ readonly popover: 20;
1908
+ readonly abovePopover: 30;
1909
+ };
1910
+
1911
+ export declare type MenuStack = keyof typeof MENU_OFFSET;
1912
+
1913
+ export declare function menuStackStyle({ menuZ, style, }: {
1914
+ menuZ: number | undefined;
1915
+ style?: React_2.CSSProperties;
1916
+ }): React_2.CSSProperties | undefined;
1917
+
1853
1918
  /**
1854
1919
  * Recharts area chart for a metric's record series — the shared primitive behind
1855
1920
  * the metric sparkline (cards) and the metric detail view. Mirrors the Jarvis
@@ -1914,6 +1979,68 @@ declare interface MetricGridProps {
1914
1979
  className?: string;
1915
1980
  }
1916
1981
 
1982
+ /**
1983
+ * Viewport width (px) at or below which Atlas may treat the screen as "mobile".
1984
+ * Single source of truth — do not hard-code the breakpoint anywhere else.
1985
+ *
1986
+ * 640px is deliberately a clean phone/tablet divider: it sits above every
1987
+ * phone's portrait width (the largest are ~480px) and below every iPad's
1988
+ * portrait width (the smallest, the Mini, is ~744px), so phones pivot and
1989
+ * tablets stay on desktop. Avoid 768px — that lands exactly on the historical
1990
+ * iPad-portrait width and ambiguously catches the Mini.
1991
+ */
1992
+ export declare const MOBILE_BREAKPOINT_PX = 640;
1993
+
1994
+ export declare function MobileActionBar({ sticky, className, children, ...props }: MobileActionBarProps): JSX.Element;
1995
+
1996
+ export declare type MobileActionBarProps = ComponentProps<'footer'> & {
1997
+ sticky?: boolean;
1998
+ };
1999
+
2000
+ export declare function MobileAppNav({ items, value, onChange, label, variant, className, ...props }: MobileAppNavProps): JSX.Element;
2001
+
2002
+ export declare type MobileAppNavItem = {
2003
+ value: string;
2004
+ label: string;
2005
+ icon?: ReactNode;
2006
+ badge?: ReactNode;
2007
+ disabled?: boolean;
2008
+ };
2009
+
2010
+ export declare const mobileAppNavItemVariants: (props?: ({
2011
+ variant?: "line" | "segmented" | null | undefined;
2012
+ } & ClassProp) | undefined) => string;
2013
+
2014
+ export declare type MobileAppNavProps = Omit<ComponentProps<'nav'>, 'onChange'> & VariantProps<typeof mobileAppNavItemVariants> & {
2015
+ items: MobileAppNavItem[];
2016
+ value: string;
2017
+ onChange: (value: string) => void;
2018
+ label?: string;
2019
+ };
2020
+
2021
+ export declare function MobileListRow({ title, titleText, description, leading, trailing, showChevron, className, type, ...props }: MobileListRowProps): JSX.Element;
2022
+
2023
+ export declare type MobileListRowProps = Omit<ComponentProps<'button'>, 'title'> & {
2024
+ title: ReactNode;
2025
+ titleText?: string;
2026
+ description?: ReactNode;
2027
+ leading?: ReactNode;
2028
+ trailing?: ReactNode;
2029
+ showChevron?: boolean;
2030
+ };
2031
+
2032
+ export declare function MobilePageHeader({ title, description, leading, actions, onBack, backLabel, sticky, className, ...props }: MobilePageHeaderProps): JSX.Element;
2033
+
2034
+ export declare type MobilePageHeaderProps = Omit<ComponentProps<'header'>, 'title'> & {
2035
+ title: string;
2036
+ description?: string;
2037
+ leading?: ReactNode;
2038
+ actions?: ReactNode;
2039
+ onBack?: () => void;
2040
+ backLabel?: string;
2041
+ sticky?: boolean;
2042
+ };
2043
+
1917
2044
  export declare function MultiSelect({ label, countLabel, options, selected, onChange, searchPlaceholder, emptyMessage, maxStackedIcons, hideWhenEmpty, modal, className, }: MultiSelectProps): JSX.Element | null;
1918
2045
 
1919
2046
  /**
@@ -2826,7 +2953,7 @@ export declare interface SectionLoadingStateProps {
2826
2953
  label?: string;
2827
2954
  }
2828
2955
 
2829
- export declare function SegmentedControl<T extends string>({ options, value, onChange, className, }: SegmentedControlProps<T>): JSX.Element;
2956
+ export declare function SegmentedControl<T extends string>({ options, value, onChange, className, size, }: SegmentedControlProps<T>): JSX.Element;
2830
2957
 
2831
2958
  declare interface SegmentedControlOption<T extends string> {
2832
2959
  value: T;
@@ -2839,6 +2966,7 @@ declare interface SegmentedControlProps<T extends string> {
2839
2966
  value: T;
2840
2967
  onChange: (value: T) => void;
2841
2968
  className?: string;
2969
+ size?: 'default' | 'touch';
2842
2970
  }
2843
2971
 
2844
2972
  export declare const Select: React_2.FC<SelectPrimitive.SelectProps>;
@@ -3917,6 +4045,32 @@ export declare interface UseEditableDraftResult<TDraft> {
3917
4045
  reset: () => void;
3918
4046
  }
3919
4047
 
4048
+ /**
4049
+ * Returns `true` only when the viewport is narrow (at or below
4050
+ * {@link MOBILE_BREAKPOINT_PX}) **and** the primary pointer is coarse (touch).
4051
+ *
4052
+ * This is the canonical "show the mobile UI" gate. It is capability-based, not
4053
+ * user-agent-based: a narrow desktop window driven by a mouse stays on desktop,
4054
+ * while a phone/tablet (or an iPad masquerading as desktop in its UA) pivots.
4055
+ * On the server it returns `false` (assume desktop) and re-gates on the client
4056
+ * after hydration; gated surfaces should tolerate a one-frame flash.
4057
+ *
4058
+ * To exercise this locally, use the browser's device toolbar (which emulates a
4059
+ * coarse pointer) — by design, simply dragging a desktop window narrow will not
4060
+ * trigger it.
4061
+ */
4062
+ export declare function useIsMobileViewport(): boolean;
4063
+
4064
+ /**
4065
+ * Inline z-index for a menu portaled out of a dialog, or `undefined` when the
4066
+ * menu is not inside one (page menus keep their class z-index and stay under
4067
+ * a later modal). Caller `style.zIndex` and a higher `z-[N]` class still win.
4068
+ */
4069
+ export declare function useMenuZIndex({ layer, className, }: {
4070
+ layer: MenuStack;
4071
+ className?: string;
4072
+ }): number | undefined;
4073
+
3920
4074
  /**
3921
4075
  * Optimistic mutation over a family of React Query list caches matched by a
3922
4076
  * partial key. Same lifecycle as `useOptimisticResource` (cancel + snapshot +