@sequenceholdings/atlas-ui 2.0.0 → 2.0.1

package/dist/index.d.ts

@@ -1767,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;
@@ -1789,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>>;