@sequenceholdings/atlas-ui 1.0.1 → 2.0.1

package/dist/index.d.ts

@@ -1661,11 +1661,9 @@ export declare interface GenericAvatarProps {
     className?: string;
 }
 
-/**
- * Maps a numeric value within [min, max] to a warm green→amber background.
- * Returns `undefined` for zero / degenerate ranges so the caller can skip styling.
- */
-export declare function heatColor(value: number, min: number, max: number): string | undefined;
+export declare function heatCellStyle(value: number, min: number, max: number): {
+    backgroundColor: string;
+} | undefined;
 
 /**
  * Sortable, paginated table with heat-colored numeric cells.
@@ -1769,7 +1767,13 @@ declare interface KpiTileProps {
     deltaTone?: 'positive' | 'negative' | 'neutral';
     /** Optional small line of text below the value (captions, context). */
     footer?: React_2.ReactNode;
-    /** When 'warn', the tile picks up an amber tint to flag attention. */
+    /**
+     * Tints the tile to carry a signal: 'warn' amber for an attention threshold,
+     * 'danger' red for an alarm. Prefer this over passing a coloured ring through
+     * `className` — a `ring-<role>/30` outline measures 1.34:1 against the tile in
+     * light, which is not a signal. The tonal states read because the label and
+     * value turn coloured (7.3:1 on the tint), not because the fill is strong.
+     */
     tone?: KpiTone;
     /** Inline adornment rendered next to the value (e.g. live dot). */
     valueAdornment?: React_2.ReactNode;
@@ -1791,14 +1795,15 @@ declare interface KpiTileProps {
  * KpiTile — compact metric card for the top of dashboards.
  *
  * Differs from `MetricCard` in two deliberate ways:
- *   - supports a colored "warn" state (tinted background/border) for KPIs that
- *     themselves carry an attention signal (e.g. "Needs attention: 1")
+ *   - supports colored tonal states (tinted background/border) for KPIs that
+ *     themselves carry a signal: `warn` for an attention threshold, `danger`
+ *     for an alarm the viewer is expected to act on (e.g. "Flagged: 3")
  *   - exposes `delta`, `deltaTone`, and `footer` slots so the monitoring-style
  *     copy ("+0.4pp vs prev 24h", "5 agents live") renders consistently
  *
  * When you only need a static label + value + subtitle, prefer MetricCard.
  */
-declare type KpiTone = 'neutral' | 'warn' | 'info';
+declare type KpiTone = 'neutral' | 'warn' | 'info' | 'danger';
 
 export declare const Label: React_2.ForwardRefExoticComponent<Omit<LabelPrimitive.LabelProps & React_2.RefAttributes<HTMLLabelElement>, "ref"> & VariantProps<(props?: ClassProp | undefined) => string> & LabelOwnProps & React_2.RefAttributes<HTMLLabelElement>>;