@quantumwake/terminal-ux-dashboard-components 0.1.22 → 0.1.24

package/dist/index.d.cts

@@ -146,6 +146,7 @@ interface ChartStyle {
     maxXTicks: number;
     maxYTicks: number;
     areaOpacity: number;
+    yFromZero: boolean;
     barLabels: boolean;
     seriesColors: string[];
 }
@@ -323,9 +324,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 +340,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. */

package/dist/index.d.ts

@@ -146,6 +146,7 @@ interface ChartStyle {
     maxXTicks: number;
     maxYTicks: number;
     areaOpacity: number;
+    yFromZero: boolean;
     barLabels: boolean;
     seriesColors: string[];
 }
@@ -323,9 +324,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 +340,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. */

package/dist/index.js

@@ -275,6 +275,7 @@ var DEFAULT_CHART_STYLE = {
   maxXTicks: 0,
   maxYTicks: 0,
   areaOpacity: 0.15,
+  yFromZero: false,
   barLabels: true,
   seriesColors: []
 };
@@ -644,7 +645,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 +667,28 @@ 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 || []);
+  let yScale = { type: "linear", min: "auto", max: "auto" };
+  if (s.yFromZero) {
+    const dataMax = Math.max(0, ...data.flatMap((serie) => serie.data.map((d) => Math.max(d.y, d.hi ?? d.y))));
+    yScale = { type: "linear", min: 0, max: niceCeil(dataMax) };
+  }
+  const bandedIds = new Set(data.filter((serie) => serie.data.some((d) => d.lo != null)).map((serie) => serie.id));
+  const bandsLayer = ({ series, yScale: yScale2, 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: yScale2(d.data.hi) })));
+    const lower = lineGenerator([...pts].reverse().map((d) => ({ x: d.position.x, y: yScale2(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
   )) });
@@ -685,7 +698,7 @@ function LineView({ records, xColumn, yColumn, data: presetData, dashedIds, styl
       data,
       margin,
       xScale: { type: "point" },
-      yScale: { type: "linear", min: "auto", max: "auto" },
+      yScale,
       curve: "monotoneX",
       enableArea: s.areaOpacity > 0,
       areaOpacity: s.areaOpacity,
@@ -698,11 +711,20 @@ 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 niceCeil(v) {
+  if (v <= 0) return 1;
+  const padded = v * 1.05;
+  const mag = Math.pow(10, Math.floor(Math.log10(padded)));
+  for (const step of [1, 2, 5, 10]) {
+    if (padded <= step * mag) return step * mag;
+  }
+  return 10 * mag;
+}
 function SparklineView({ data, height = 56, color = "#3987e5", showValue = false, format }) {
   const gradientId = useId();
   const width = 260;