@texturehq/edges 2.5.2 → 2.5.3

package/dist/index.d.cts

@@ -5536,6 +5536,12 @@ type KpiFormatter = ComponentFormatter;
  *   trend={dataPoints}
  * />
  * ```
+ *
+ * The "tile" opt-ins (`unit`, `sub`, `dashed`, `labelVariant="mono-caps"`,
+ * `sparkVariant="area"`, `tileValueSize`) let the `entity.now` and `metrics.kpi`
+ * blocks draw their KPI cell from this one primitive instead of hand-rolling it.
+ * Every one is optional and defaults to the legacy presentation, so existing
+ * callers (Boards, standalone Kpi) are unaffected until they opt in.
  */
 type KpiStatus = "neutral" | "success" | "warning" | "error" | "info";
 type KpiSize = "sm" | "md" | "lg";
@@ -5566,7 +5572,7 @@ interface KpiProps {
     };
     /** Help text or tooltip content */
     helpText?: React__default.ReactNode;
-    /** Size variant */
+    /** Size variant — controls label/value type roles and internal gap. */
     size?: KpiSize;
     /** Layout orientation */
     orientation?: KpiOrientation;
@@ -5588,8 +5594,45 @@ interface KpiProps {
     renderDelta?: (delta?: number) => React__default.ReactNode;
     /** Custom trend renderer */
     renderTrend?: (points?: TrendPoint[]) => React__default.ReactNode;
+    /**
+     * Secondary unit suffix rendered inline after the value in a smaller,
+     * secondary tone (e.g. "kW", "%", "MW"). Display-only.
+     */
+    unit?: string;
+    /**
+     * Secondary line under the value (e.g. "as of 2h ago", "of 400 A"). Static,
+     * already localised by the caller. Kept even when `dashed`.
+     */
+    sub?: React__default.ReactNode;
+    /**
+     * Offline contract: the value is dashed to "—" and de-emphasised (the entity
+     * is offline and this is a live metric). The cell keeps its slot so a grid
+     * stays identical online/offline; the sparkline is suppressed and `sub` is
+     * kept. Distinct from `empty` (which is "no metric at all").
+     */
+    dashed?: boolean;
+    /**
+     * Label presentation. `"mono-caps"` renders the design's Geist-Mono 10px
+     * uppercase caption so blocks don't hand-pass `labelClassName`.
+     */
+    labelVariant?: "default" | "mono-caps";
+    /**
+     * Sparkline style. `"line"` (default, back-compat) is the thin border-muted
+     * polyline; `"area"` is the smooth Catmull-Rom curve with a gradient area
+     * fill (the shared tile sparkline). The caller decides whether a series is
+     * worth drawing; this only draws for ≥ 2 points and no-ops otherwise.
+     */
+    sparkVariant?: "line" | "area";
+    /** Text-color utility class for the `"area"` sparkline (drives currentColor). */
+    sparkTone?: string;
+    /**
+     * Opt-in "tile" value presentation: brand-font display value at a fixed size.
+     * `"md"` = 24px (entity/device tiles), `"lg"` = 34px (Boards summary). When
+     * unset the value uses the `size`-driven display type role (legacy behavior).
+     */
+    tileValueSize?: "md" | "lg";
 }
-declare function Kpi({ label, value, formatter, delta, deltaPeriodLabel, deltaIntent, trend, status, helpText, size, orientation, isLoading, empty, error, onClick, className, labelClassName, renderValue, renderDelta, renderTrend, }: KpiProps): react_jsx_runtime.JSX.Element;
+declare function Kpi({ label, value, formatter, delta, deltaPeriodLabel, deltaIntent, trend, status, helpText, size, orientation, isLoading, empty, error, onClick, className, labelClassName, renderValue, renderDelta, renderTrend, unit, sub, dashed, labelVariant, sparkVariant, sparkTone, tileValueSize, }: KpiProps): react_jsx_runtime.JSX.Element;
 
 /**
  * KpiGroup Component — Layout container for multiple KPIs

package/dist/index.d.ts

@@ -5536,6 +5536,12 @@ type KpiFormatter = ComponentFormatter;
  *   trend={dataPoints}
  * />
  * ```
+ *
+ * The "tile" opt-ins (`unit`, `sub`, `dashed`, `labelVariant="mono-caps"`,
+ * `sparkVariant="area"`, `tileValueSize`) let the `entity.now` and `metrics.kpi`
+ * blocks draw their KPI cell from this one primitive instead of hand-rolling it.
+ * Every one is optional and defaults to the legacy presentation, so existing
+ * callers (Boards, standalone Kpi) are unaffected until they opt in.
  */
 type KpiStatus = "neutral" | "success" | "warning" | "error" | "info";
 type KpiSize = "sm" | "md" | "lg";
@@ -5566,7 +5572,7 @@ interface KpiProps {
     };
     /** Help text or tooltip content */
     helpText?: React__default.ReactNode;
-    /** Size variant */
+    /** Size variant — controls label/value type roles and internal gap. */
     size?: KpiSize;
     /** Layout orientation */
     orientation?: KpiOrientation;
@@ -5588,8 +5594,45 @@ interface KpiProps {
     renderDelta?: (delta?: number) => React__default.ReactNode;
     /** Custom trend renderer */
     renderTrend?: (points?: TrendPoint[]) => React__default.ReactNode;
+    /**
+     * Secondary unit suffix rendered inline after the value in a smaller,
+     * secondary tone (e.g. "kW", "%", "MW"). Display-only.
+     */
+    unit?: string;
+    /**
+     * Secondary line under the value (e.g. "as of 2h ago", "of 400 A"). Static,
+     * already localised by the caller. Kept even when `dashed`.
+     */
+    sub?: React__default.ReactNode;
+    /**
+     * Offline contract: the value is dashed to "—" and de-emphasised (the entity
+     * is offline and this is a live metric). The cell keeps its slot so a grid
+     * stays identical online/offline; the sparkline is suppressed and `sub` is
+     * kept. Distinct from `empty` (which is "no metric at all").
+     */
+    dashed?: boolean;
+    /**
+     * Label presentation. `"mono-caps"` renders the design's Geist-Mono 10px
+     * uppercase caption so blocks don't hand-pass `labelClassName`.
+     */
+    labelVariant?: "default" | "mono-caps";
+    /**
+     * Sparkline style. `"line"` (default, back-compat) is the thin border-muted
+     * polyline; `"area"` is the smooth Catmull-Rom curve with a gradient area
+     * fill (the shared tile sparkline). The caller decides whether a series is
+     * worth drawing; this only draws for ≥ 2 points and no-ops otherwise.
+     */
+    sparkVariant?: "line" | "area";
+    /** Text-color utility class for the `"area"` sparkline (drives currentColor). */
+    sparkTone?: string;
+    /**
+     * Opt-in "tile" value presentation: brand-font display value at a fixed size.
+     * `"md"` = 24px (entity/device tiles), `"lg"` = 34px (Boards summary). When
+     * unset the value uses the `size`-driven display type role (legacy behavior).
+     */
+    tileValueSize?: "md" | "lg";
 }
-declare function Kpi({ label, value, formatter, delta, deltaPeriodLabel, deltaIntent, trend, status, helpText, size, orientation, isLoading, empty, error, onClick, className, labelClassName, renderValue, renderDelta, renderTrend, }: KpiProps): react_jsx_runtime.JSX.Element;
+declare function Kpi({ label, value, formatter, delta, deltaPeriodLabel, deltaIntent, trend, status, helpText, size, orientation, isLoading, empty, error, onClick, className, labelClassName, renderValue, renderDelta, renderTrend, unit, sub, dashed, labelVariant, sparkVariant, sparkTone, tileValueSize, }: KpiProps): react_jsx_runtime.JSX.Element;
 
 /**
  * KpiGroup Component — Layout container for multiple KPIs