@quantumwake/terminal-ux-dashboard-components 0.1.21 → 0.1.23

package/dist/index.d.cts

@@ -323,9 +323,14 @@ declare function PieView({ records, groupColumn, data: presetData, style }: PieV
 
 interface LineSerie {
     id: string;
+    /** lo/hi (optional, per point) draw a soft envelope band behind the
+     *  line — the reading for "this line summarizes several": the band is
+     *  the min–max spread of what it aggregates. */
     data: {
         x: string;
         y: number;
+        lo?: number;
+        hi?: number;
     }[];
 }
 interface LineViewProps {
@@ -334,12 +339,9 @@ interface LineViewProps {
     yColumn: string;
     /** Pre-shaped Nivo line series bypasses client-side processing. */
     data?: LineSerie[];
-    /** Serie ids to draw dotted — the aggregate-vs-individual distinction
-     *  (an average line reads as derived, a member line as observed). */
-    dashedIds?: string[];
     style?: Partial<ChartStyle>;
 }
-declare function LineView({ records, xColumn, yColumn, data: presetData, dashedIds, style }: LineViewProps): react.JSX.Element;
+declare function LineView({ records, xColumn, yColumn, data: presetData, style }: LineViewProps): react.JSX.Element;
 
 interface SparklineViewProps {
     /** The series, oldest first. */
@@ -348,8 +350,13 @@ interface SparklineViewProps {
     height?: number;
     /** Line + area hue. */
     color?: string;
+    /** Show the CURRENT (last) value as a readout over the mark — a trend
+     *  shape without its number answers "which way", never "how much". */
+    showValue?: boolean;
+    /** Formats the readout (e.g. v => `${v.toFixed(1)} ms`). Default: locale. */
+    format?: (v: number) => string;
 }
-declare function SparklineView({ data, height, color }: SparklineViewProps): react.JSX.Element;
+declare function SparklineView({ data, height, color, showValue, format }: SparklineViewProps): react.JSX.Element;
 
 interface ScatterSerie {
     id: string;

package/dist/index.d.ts

@@ -323,9 +323,14 @@ declare function PieView({ records, groupColumn, data: presetData, style }: PieV
 
 interface LineSerie {
     id: string;
+    /** lo/hi (optional, per point) draw a soft envelope band behind the
+     *  line — the reading for "this line summarizes several": the band is
+     *  the min–max spread of what it aggregates. */
     data: {
         x: string;
         y: number;
+        lo?: number;
+        hi?: number;
     }[];
 }
 interface LineViewProps {
@@ -334,12 +339,9 @@ interface LineViewProps {
     yColumn: string;
     /** Pre-shaped Nivo line series bypasses client-side processing. */
     data?: LineSerie[];
-    /** Serie ids to draw dotted — the aggregate-vs-individual distinction
-     *  (an average line reads as derived, a member line as observed). */
-    dashedIds?: string[];
     style?: Partial<ChartStyle>;
 }
-declare function LineView({ records, xColumn, yColumn, data: presetData, dashedIds, style }: LineViewProps): react.JSX.Element;
+declare function LineView({ records, xColumn, yColumn, data: presetData, style }: LineViewProps): react.JSX.Element;
 
 interface SparklineViewProps {
     /** The series, oldest first. */
@@ -348,8 +350,13 @@ interface SparklineViewProps {
     height?: number;
     /** Line + area hue. */
     color?: string;
+    /** Show the CURRENT (last) value as a readout over the mark — a trend
+     *  shape without its number answers "which way", never "how much". */
+    showValue?: boolean;
+    /** Formats the readout (e.g. v => `${v.toFixed(1)} ms`). Default: locale. */
+    format?: (v: number) => string;
 }
-declare function SparklineView({ data, height, color }: SparklineViewProps): react.JSX.Element;
+declare function SparklineView({ data, height, color, showValue, format }: SparklineViewProps): react.JSX.Element;
 
 interface ScatterSerie {
     id: string;

package/dist/index.js

@@ -644,7 +644,7 @@ function PieView({ records, groupColumn, data: presetData, style }) {
     }
   ) });
 }
-function LineView({ records, xColumn, yColumn, data: presetData, dashedIds, style }) {
+function LineView({ records, xColumn, yColumn, data: presetData, style }) {
   const computed = useMemo(() => {
     if (presetData || !records) return [];
     const sorted = [...records].filter((r) => r[xColumn] != null && r[yColumn] != null).sort((a, b) => {
@@ -666,16 +666,23 @@ function LineView({ records, xColumn, yColumn, data: presetData, dashedIds, styl
   ]));
   const longest = data.reduce((a, b) => b.data.length > a.data.length ? b : a, { id: "", data: [] });
   const tickValues = thinTicks(longest.data.map((d) => d.x), s.maxXTicks);
-  const dashed = new Set(dashedIds || []);
+  const bandedIds = new Set(data.filter((serie) => serie.data.some((d) => d.lo != null)).map((serie) => serie.id));
+  const bandsLayer = ({ series, yScale, lineGenerator }) => /* @__PURE__ */ jsx(Fragment, { children: series.map((serie) => {
+    const pts = serie.data.filter((d) => d.data.lo != null && d.data.hi != null && d.position.x != null);
+    if (pts.length < 2) return null;
+    const upper = lineGenerator(pts.map((d) => ({ x: d.position.x, y: yScale(d.data.hi) })));
+    const lower = lineGenerator([...pts].reverse().map((d) => ({ x: d.position.x, y: yScale(d.data.lo) })));
+    if (!upper || !lower) return null;
+    return /* @__PURE__ */ jsx("path", { d: `${upper} L ${lower.slice(1)} Z`, fill: serie.color, opacity: 0.12 }, `band-${serie.id}`);
+  }) });
   const linesLayer = ({ series, lineGenerator }) => /* @__PURE__ */ jsx(Fragment, { children: series.map((serie) => /* @__PURE__ */ jsx(
     "path",
     {
       d: lineGenerator(serie.data.map((d) => d.position)),
       fill: "none",
       stroke: serie.color,
-      strokeWidth: 2,
-      strokeLinecap: "round",
-      strokeDasharray: dashed.has(String(serie.id)) ? "1 5" : void 0
+      strokeWidth: bandedIds.has(String(serie.id)) ? 2.5 : 1.5,
+      strokeLinecap: "round"
     },
     serie.id
   )) });
@@ -698,12 +705,12 @@ function LineView({ records, xColumn, yColumn, data: presetData, dashedIds, styl
       axisBottom: { ...makeAxis(style, "x", xColumn), ...tickValues ? { tickValues } : {} },
       axisLeft: makeAxis(style, "y", yColumn, { numeric: true }),
       useMesh: true,
-      layers: ["grid", "markers", "axes", "areas", linesLayer, "crosshair", "slices", "mesh", "legends"],
+      layers: ["grid", "markers", "axes", "areas", bandsLayer, linesLayer, "crosshair", "slices", "mesh", "legends"],
       theme: buildNivoTheme(style)
     }
   ) });
 }
-function SparklineView({ data, height = 56, color = "#3987e5" }) {
+function SparklineView({ data, height = 56, color = "#3987e5", showValue = false, format }) {
   const gradientId = useId();
   const width = 260;
   const pts = data && data.length ? data : [0];
@@ -712,13 +719,18 @@ function SparklineView({ data, height = 56, color = "#3987e5" }) {
   const xy = (v, i) => [i * dx, height - v / max * (height - 4) - 2];
   const line = pts.map((v, i) => `${i === 0 ? "M" : "L"} ${xy(v, i)[0].toFixed(1)} ${xy(v, i)[1].toFixed(1)}`).join(" ");
   const area = `${line} L ${width} ${height} L 0 ${height} Z`;
-  return /* @__PURE__ */ jsxs("svg", { viewBox: `0 0 ${width} ${height}`, height, className: "w-full", preserveAspectRatio: "none", children: [
-    /* @__PURE__ */ jsx("defs", { children: /* @__PURE__ */ jsxs("linearGradient", { id: gradientId, x1: "0", y1: "0", x2: "0", y2: "1", children: [
-      /* @__PURE__ */ jsx("stop", { offset: "0%", stopColor: color, stopOpacity: "0.25" }),
-      /* @__PURE__ */ jsx("stop", { offset: "100%", stopColor: color, stopOpacity: "0" })
-    ] }) }),
-    /* @__PURE__ */ jsx("path", { d: area, fill: `url(#${gradientId})` }),
-    /* @__PURE__ */ jsx("path", { d: line, fill: "none", stroke: color, strokeWidth: "2", vectorEffect: "non-scaling-stroke" })
+  const current = pts[pts.length - 1];
+  const readout = format ? format(current) : current.toLocaleString(void 0, { maximumFractionDigits: 1 });
+  return /* @__PURE__ */ jsxs("div", { className: "relative", children: [
+    /* @__PURE__ */ jsxs("svg", { viewBox: `0 0 ${width} ${height}`, height, className: "w-full", preserveAspectRatio: "none", children: [
+      /* @__PURE__ */ jsx("defs", { children: /* @__PURE__ */ jsxs("linearGradient", { id: gradientId, x1: "0", y1: "0", x2: "0", y2: "1", children: [
+        /* @__PURE__ */ jsx("stop", { offset: "0%", stopColor: color, stopOpacity: "0.25" }),
+        /* @__PURE__ */ jsx("stop", { offset: "100%", stopColor: color, stopOpacity: "0" })
+      ] }) }),
+      /* @__PURE__ */ jsx("path", { d: area, fill: `url(#${gradientId})` }),
+      /* @__PURE__ */ jsx("path", { d: line, fill: "none", stroke: color, strokeWidth: "2", vectorEffect: "non-scaling-stroke" })
+    ] }),
+    showValue && /* @__PURE__ */ jsx("span", { className: "absolute right-1 top-0 font-mono text-lg text-midnight-text-primary", children: readout })
   ] });
 }
 function ScatterView({ records, xColumn, yColumn, data: presetData, style }) {