@sequenceholdings/atlas-ui 3.4.0 → 3.5.0

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
@@ -95,7 +95,7 @@ export declare const AlertDialogContent: React_2.ForwardRefExoticComponent<Omit<
95
95
  /**
96
96
  * Classes for the scrim behind the dialog. Pair with `className` when
97
97
  * raising z-index — a lone `className="z-modal"` lifts only the panel and
98
- * leaves the overlay at `z-50` (DES-315). Additive; defaults unchanged.
98
+ * leaves the overlay at `z-50` (DES-315).
99
99
  */
100
100
  overlayClassName?: string;
101
101
  } & React_2.RefAttributes<HTMLDivElement>>;
@@ -366,7 +366,7 @@ export declare interface ButtonProps extends React_2.ButtonHTMLAttributes<HTMLBu
366
366
  }
367
367
 
368
368
  export declare const buttonVariants: (props?: ({
369
- variant?: "default" | "link" | "secondary" | "destructive" | "outline" | "ghost" | "submit" | null | undefined;
369
+ variant?: "default" | "link" | "secondary" | "destructive" | "outline" | "ghost" | "row" | "submit" | null | undefined;
370
370
  size?: "default" | "touch" | "sm" | "icon" | "lg" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | "icon-touch" | null | undefined;
371
371
  } & ClassProp) | undefined) => string;
372
372
 
@@ -474,13 +474,12 @@ export declare function ChartTooltipContent({ active, payload, className, indica
474
474
  * - `size-4` (16px)
475
475
  * - `rounded-badge` (4px) — a square with softened corners, NOT a
476
476
  * circle. This is chosen for its VALUE, not its name: a checkbox is
477
- * not a label about something, but `badge` is the only radius role
478
- * that stays 4px in both flag states, and 4px is the only step that
477
+ * not a label about something, but `badge` is the only 4px radius
478
+ * role, and 4px is the only step that
479
479
  * keeps a 16px box reading as a square. `rounded-control` would make
480
480
  * it a full circle — that is a radio button, not a checkbox — and
481
- * `rounded-surface-nested` (8px) would render it as a 50% pill.
482
- * Kept off the legacy `rounded-xs` so it survives the DES-324
483
- * deletion of the legacy scale (DES-379).
481
+ * `rounded-surface-nested` (8px) would render it as a 50% pill
482
+ * (DES-379).
484
483
  * - Neutral `border-input` when unchecked; flips to `border-primary`
485
484
  * when checked/indeterminate so the outline blends with the fill.
486
485
  * - No drop shadow — consistent with the rest of Atlas's form
@@ -708,8 +707,7 @@ export declare const codeBadgeVariants: (props?: ({
708
707
  * Table-cell wrapper around `CodeBadge` for columns that render literal
709
708
  * strings (version labels, cron expressions, IDs). Kept as a separate export
710
709
  * so column definitions can stay value-oriented (`<CodePillCell value={v} />`)
711
- * rather than wrapping children — but the visual treatment now lives in
712
- * the shared `CodeBadge` primitive.
710
+ * rather than wrapping children; the visual treatment lives in `CodeBadge`.
713
711
  */
714
712
  export declare function CodePillCell({ value, className, }: {
715
713
  value: React_2.ReactNode;
@@ -1040,8 +1038,7 @@ export declare type DefaultTaskStatus = 'todo' | 'in_progress' | 'blocked' | 'do
1040
1038
  * Atlas-specific behaviors:
1041
1039
  * - Portal mounts into the shared Atlas portal container
1042
1040
  * (`usePortalContainer()`), so dialogs trap focus + stacking
1043
- * correctly inside MFEs (chat-admin, inbox, agents) that isolate
1044
- * their own DOM scope.
1041
+ * correctly inside MFEs that isolate their own DOM scope.
1045
1042
  * - Fallback portal root is appended under `document.body` (NOT
1046
1043
  * `documentElement`) — a portal on `<html>` breaks Radix's
1047
1044
  * `aria-hidden` bookkeeping for nested layers.
@@ -1061,7 +1058,7 @@ export declare namespace Dialog {
1061
1058
 
1062
1059
  /**
1063
1060
  * DialogBody — the scrollable body region between DialogHeader and
1064
- * DialogFooter. New in this revision.
1061
+ * DialogFooter.
1065
1062
  *
1066
1063
  * Use this for any dialog with form fields, long content, or anything
1067
1064
  * that might exceed the viewport. For very short dialogs where the
@@ -1089,7 +1086,7 @@ export declare const DialogContent: React_2.ForwardRefExoticComponent<Omit<Dialo
1089
1086
  /**
1090
1087
  * Classes for the scrim behind the dialog. Pair with `className` when
1091
1088
  * raising z-index — a lone `className="z-modal"` lifts only the panel and
1092
- * leaves the overlay at `z-50` (DES-315). Additive; defaults unchanged.
1089
+ * leaves the overlay at `z-50` (DES-315).
1093
1090
  */
1094
1091
  overlayClassName?: string;
1095
1092
  } & React_2.RefAttributes<HTMLDivElement>>;
@@ -1108,10 +1105,20 @@ export declare namespace DialogHeader {
1108
1105
  var displayName: string;
1109
1106
  }
1110
1107
 
1108
+ export declare function DialogLayer({ children, className, }: {
1109
+ children: React_2.ReactNode;
1110
+ className?: string;
1111
+ }): JSX.Element;
1112
+
1111
1113
  export declare const DialogOverlay: React_2.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
1112
1114
 
1113
1115
  export declare function DialogPortal({ container, ...props }: React_2.ComponentProps<typeof DialogPrimitive.Portal>): JSX.Element;
1114
1116
 
1117
+ /** Highest z-index this dialog content claims, at least `DIALOG_STACK_FLOOR`. */
1118
+ export declare function dialogStackZ({ className }: {
1119
+ className?: string;
1120
+ }): number;
1121
+
1115
1122
  export declare const DialogTitle: React_2.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React_2.RefAttributes<HTMLHeadingElement>, "ref"> & React_2.RefAttributes<HTMLHeadingElement>>;
1116
1123
 
1117
1124
  export declare const DialogTrigger: React_2.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React_2.RefAttributes<HTMLButtonElement>>;
@@ -1156,7 +1163,7 @@ export declare const DropdownMenuShortcut: {
1156
1163
  * keeps the top menu short and scales as options grow.
1157
1164
  *
1158
1165
  * Reference: `PrincipalRow` / `GroupMembersDetail` role menus. See also
1159
- * `.cursor/rules/design-system.md` ("Overflow menus: nest the option list").
1166
+ * `.cursor/rules/design-system.mdc` ("Overflow menus: nest the option list").
1160
1167
  */
1161
1168
  export declare const DropdownMenuSub: React_2.FC<DropdownMenuPrimitive.DropdownMenuSubProps>;
1162
1169
 
@@ -1174,8 +1181,7 @@ export declare function EditorPageHeader({ title, description, actions, classNam
1174
1181
  * EditorPageHeader — section title + description block used at the top of
1175
1182
  * each editor pane (Prompt, Tools, Input Schema, etc.).
1176
1183
  *
1177
- * Replaces the older `<Panel>` Card-wrap pattern with a flat layout that
1178
- * matches the new editor design. Title is 18px (one step up from the
1184
+ * A flat layout (no Card wrap). Title is 18px (one step up from the
1179
1185
  * dashboard's 16px page header), description is 13px secondary text.
1180
1186
  *
1181
1187
  * Pair with `EditorSection` for vertically-stacked content blocks under the
@@ -1892,11 +1898,23 @@ declare interface LineSparklineCellProps {
1892
1898
  className?: string;
1893
1899
  }
1894
1900
 
1901
+ declare const MENU_OFFSET: {
1902
+ readonly select: 10;
1903
+ readonly popover: 20;
1904
+ readonly abovePopover: 30;
1905
+ };
1906
+
1907
+ export declare type MenuStack = keyof typeof MENU_OFFSET;
1908
+
1909
+ export declare function menuStackStyle({ menuZ, style, }: {
1910
+ menuZ: number | undefined;
1911
+ style?: React_2.CSSProperties;
1912
+ }): React_2.CSSProperties | undefined;
1913
+
1895
1914
  /**
1896
1915
  * Recharts area chart for a metric's record series — the shared primitive behind
1897
- * the metric sparkline (cards) and the metric detail view. Mirrors the Jarvis
1898
- * metric-card chart (gradient area, monotone line) so metric viz reads the same
1899
- * everywhere. Lives in atlas-ui so standalone artifacts can reuse it without
1916
+ * the metric sparkline (cards) and the metric detail view (gradient area,
1917
+ * monotone line), so metric viz reads the same everywhere. Lives in atlas-ui so standalone artifacts can reuse it without
1900
1918
  * pulling chart.js.
1901
1919
  */
1902
1920
  export declare function MetricAreaChart({ points, color, series, stacked, height, variant, valueFormatter, dateFormatter, balanceYAxis, yAxisWidth, integerYAxis, className, }: MetricAreaChartProps): JSX.Element;
@@ -1960,11 +1978,9 @@ declare interface MetricGridProps {
1960
1978
  * Viewport width (px) at or below which Atlas may treat the screen as "mobile".
1961
1979
  * Single source of truth — do not hard-code the breakpoint anywhere else.
1962
1980
  *
1963
- * 640px is deliberately a clean phone/tablet divider: it sits above every
1964
- * phone's portrait width (the largest are ~480px) and below every iPad's
1965
- * portrait width (the smallest, the Mini, is ~744px), so phones pivot and
1966
- * tablets stay on desktop. Avoid 768px — that lands exactly on the historical
1967
- * iPad-portrait width and ambiguously catches the Mini.
1981
+ * 640px is deliberately above phone portrait widths. iPads are detected
1982
+ * separately because BankSouth's iPad workflow uses the mobile shell in both
1983
+ * orientations, including when iPadOS advertises a desktop-style Mac UA.
1968
1984
  */
1969
1985
  export declare const MOBILE_BREAKPOINT_PX = 640;
1970
1986
 
@@ -2383,7 +2399,7 @@ declare interface ProColumnMetaBase {
2383
2399
  * toggle, delete button). Clicks anywhere in the cell — including the
2384
2400
  * padding around the control — stop at the cell instead of bubbling to
2385
2401
  * the row's `onRowClick`, so a near-miss on the control can't navigate
2386
- * away. The control itself no longer needs its own `stopPropagation`.
2402
+ * away. The control itself needs no `stopPropagation` of its own.
2387
2403
  */
2388
2404
  interactive?: boolean;
2389
2405
  /**
@@ -2853,11 +2869,19 @@ declare interface RowAction {
2853
2869
  hidden?: boolean;
2854
2870
  }
2855
2871
 
2856
- export declare function scoreBand(value: number): 'green' | 'amber' | 'red';
2872
+ export declare function scoreBand(value: number, bands?: ScoreBands): 'green' | 'amber' | 'red';
2857
2873
 
2858
- export declare function ScoreBarCell({ value, className, }: {
2874
+ /** Lower bounds (inclusive) of the green (`pass`) and amber (`partial`) bands. */
2875
+ declare type ScoreBands = {
2876
+ pass: number;
2877
+ partial: number;
2878
+ };
2879
+
2880
+ export declare function ScoreBarCell({ value, className, bands, }: {
2859
2881
  value: number | null | undefined;
2860
2882
  className?: string;
2883
+ /** Band thresholds; defaults to `DEFAULT_SCORE_BANDS` (0.78 / 0.5). */
2884
+ bands?: ScoreBands;
2861
2885
  }): JSX.Element;
2862
2886
 
2863
2887
  export declare const ScrollArea: React_2.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
@@ -3505,8 +3529,8 @@ export declare interface TaskListProps<T extends TaskListItem> {
3505
3529
  /**
3506
3530
  * Fires with the post-search / post-filter / post-"My Tasks" visible set
3507
3531
  * whenever it changes. The list owns those controls internally, so a
3508
- * consumer that needs the live visible scope (e.g. publishing a Jarvis
3509
- * chat-view snapshot) can't derive it from `tasks` — this surfaces it.
3532
+ * consumer that needs the live visible scope (e.g. publishing a chat-view
3533
+ * snapshot) can't derive it from `tasks` — this surfaces it.
3510
3534
  */
3511
3535
  onVisibleTasksChange?: (visible: T[]) => void;
3512
3536
  /**
@@ -3629,13 +3653,10 @@ export declare interface TaskRowProps {
3629
3653
  */
3630
3654
  onDelete?: () => void;
3631
3655
  /**
3632
- * Suppress the owner avatar regardless of `ownerEmail`. Used by
3633
- * surfaces where every row is already implicitly scoped to the
3634
- * caller (MyWeek's per-card task list — every card and task on it
3635
- * belongs to the signed-in user, so repeating the same JJ pip on
3636
- * every row is pure chrome). The avatar still renders by default;
3637
- * surfaces with mixed-owner task lists (Tasks tab, HypothesisDetail)
3638
- * leave this off.
3656
+ * Suppress the owner avatar regardless of `ownerEmail`. For surfaces
3657
+ * where every row is already implicitly scoped to the caller, so
3658
+ * repeating the same avatar on every row is pure chrome. Mixed-owner
3659
+ * task lists leave this off.
3639
3660
  */
3640
3661
  hideOwner?: boolean;
3641
3662
  /**
@@ -3748,10 +3769,8 @@ export declare type TextareaProps = React_2.ComponentProps<"textarea"> & Textare
3748
3769
  * Provides a themeable container + tooltip/legend chrome so charts across
3749
3770
  * Atlas share one styling contract instead of each app hand-rolling recharts
3750
3771
  * markup. New charts should compose `ChartContainer` + a `ChartConfig` and let
3751
- * this primitive resolve colors from the `--chart-*` design tokens.
3752
- *
3753
- * Jarvis is migrating its bespoke recharts usage onto this primitive — prefer
3754
- * it over importing recharts directly in new code.
3772
+ * this primitive resolve colors from the `--chart-*` design tokens. Prefer it
3773
+ * over importing recharts directly in new code.
3755
3774
  */
3756
3775
  declare const THEMES: {
3757
3776
  readonly light: "";
@@ -4003,8 +4022,8 @@ export declare function useAppClassName(): string | undefined;
4003
4022
  * workstream object to one side's owner rows); the mapper is read from a ref so
4004
4023
  * passing an inline closure doesn't trigger spurious resyncs.
4005
4024
  *
4006
- * Extracted from `inline-text-cell.tsx`; the shared layer for every inline
4007
- * editor (text cells, owner pickers, date cells, …).
4025
+ * The shared layer for every inline editor (text cells, owner pickers, date
4026
+ * cells, …).
4008
4027
  */
4009
4028
  export declare function useEditableDraft<TValue, TDraft = TValue>(params: {
4010
4029
  value: TValue;
@@ -4023,12 +4042,14 @@ export declare interface UseEditableDraftResult<TDraft> {
4023
4042
  }
4024
4043
 
4025
4044
  /**
4026
- * Returns `true` only when the viewport is narrow (at or below
4027
- * {@link MOBILE_BREAKPOINT_PX}) **and** the primary pointer is coarse (touch).
4045
+ * Returns `true` for iPads in either orientation, or when the viewport is
4046
+ * narrow (at or below {@link MOBILE_BREAKPOINT_PX}) and the primary pointer
4047
+ * is coarse (touch).
4028
4048
  *
4029
- * This is the canonical "show the mobile UI" gate. It is capability-based, not
4030
- * user-agent-based: a narrow desktop window driven by a mouse stays on desktop,
4031
- * while a phone/tablet (or an iPad masquerading as desktop in its UA) pivots.
4049
+ * This is the canonical "show the mobile UI" gate. Narrow-phone support uses
4050
+ * viewport and pointer capabilities; iPad support uses its UA or the
4051
+ * desktop-class iPadOS combination of a MacIntel platform and touch points.
4052
+ * A narrow desktop window driven by a mouse stays on desktop.
4032
4053
  * On the server it returns `false` (assume desktop) and re-gates on the client
4033
4054
  * after hydration; gated surfaces should tolerate a one-frame flash.
4034
4055
  *
@@ -4038,6 +4059,16 @@ export declare interface UseEditableDraftResult<TDraft> {
4038
4059
  */
4039
4060
  export declare function useIsMobileViewport(): boolean;
4040
4061
 
4062
+ /**
4063
+ * Inline z-index for a menu portaled out of a dialog, or `undefined` when the
4064
+ * menu is not inside one (page menus keep their class z-index and stay under
4065
+ * a later modal). Caller `style.zIndex` and a higher `z-[N]` class still win.
4066
+ */
4067
+ export declare function useMenuZIndex({ layer, className, }: {
4068
+ layer: MenuStack;
4069
+ className?: string;
4070
+ }): number | undefined;
4071
+
4041
4072
  /**
4042
4073
  * Optimistic mutation over a family of React Query list caches matched by a
4043
4074
  * partial key. Same lifecycle as `useOptimisticResource` (cancel + snapshot +
@@ -4103,7 +4134,7 @@ export declare interface UseOptimisticListParams<TCache, TVariables, TResult> {
4103
4134
  /**
4104
4135
  * Optimistic mutation over a single React Query cache entry.
4105
4136
  *
4106
- * Encapsulates the full lifecycle the Jarvis playbook prescribes:
4137
+ * Encapsulates the full optimistic lifecycle:
4107
4138
  * `onMutate` cancels in-flight queries, snapshots the entry, and applies an
4108
4139
  * optimistic patch; `onError` rolls back to the snapshot; `onSuccess`
4109
4140
  * reconciles from the server result (or trusts the patch); and settle does NOT
@@ -4143,9 +4174,8 @@ export declare interface UseOptimisticResourceParams<TData, TVariables, TResult>
4143
4174
  /**
4144
4175
  * Invalidate the PATCHED key on settle. Defaults to `false`: invalidating a
4145
4176
  * key you just optimistically patched re-runs its query and lets a stale
4146
- * in-flight response overwrite the patch for a frame — the flash-back the
4147
- * Jarvis frontend-mutations playbook warns against. Only enable when you
4148
- * cannot reconcile from the server result.
4177
+ * in-flight response overwrite the patch for a frame (flash-back). Only
4178
+ * enable when you cannot reconcile from the server result.
4149
4179
  */
4150
4180
  invalidateOnSettle?: boolean;
4151
4181
  /**
@@ -4212,9 +4242,7 @@ export declare interface UserAvatarProps {
4212
4242
  colorKey?: string;
4213
4243
  /**
4214
4244
  * Optional explicit initials (e.g. "AR", "ML"). Use when the displayed
4215
- * `name` is a single token but you want a two-letter avatar — common in
4216
- * Jarvis where `emailToName()` returns just the first name from the
4217
- * TEAM roster. Falls back to deriving from `name` when omitted, which
4245
+ * `name` is a single token but you want a two-letter avatar. Falls back to deriving from `name` when omitted, which
4218
4246
  * yields a single letter for one-word names.
4219
4247
  */
4220
4248
  initials?: string;
@@ -4261,28 +4289,11 @@ export declare interface UserChipUser {
4261
4289
  initials?: string;
4262
4290
  }
4263
4291
 
4264
- /**
4265
- * Resolve a `ParsedDate` (year/month/day, any of which may be null)
4266
- * into a concrete `Date`, using the reference date and `dayDefault`
4267
- * to fill in the missing pieces.
4268
- *
4269
- * Decisions:
4270
- * - Missing day: 1st of the month for `start`, last day for `end`.
4271
- * - Missing month: January (start) or December (end).
4272
- * - Missing year: current year, unless picking that year would put
4273
- * the date in the future for "bare month" inputs — in which case
4274
- * we fall back to the prior year (matches Mercury's behaviour for
4275
- * "Dec" entered in July).
4276
- *
4277
- * Returns `null` if the resulting date doesn't actually exist (e.g.
4278
- * "Feb 30 2024" was typed).
4279
- */
4280
4292
  /**
4281
4293
  * Direction the parser leans when a year is missing from the user's
4282
- * input. Default is `'past'` — matches the original retrospective bias
4283
- * (`"Dec"` in July → last December). Forward-planning surfaces (due
4284
- * dates, scheduling) pass `'future'` so `"Jun 8"` in May reads as the
4285
- * upcoming June 8 instead of last year's.
4294
+ * input. Default is `'past'` (`"Dec"` in July → last December).
4295
+ * Forward-planning surfaces (due dates, scheduling) pass `'future'` so
4296
+ * `"Jun 8"` in May reads as the upcoming June 8 instead of last year's.
4286
4297
  */
4287
4298
  declare type YearBias = 'past' | 'future';
4288
4299