@quantumwake/terminal-ux-dashboard-components 0.1.22 → 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. */

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. */

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,7 +705,7 @@ 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)
     }
   ) });