@espressif/dashboard-ui-components 1.10.0 → 1.11.0

package/dist/components/carousel/carousel.js

@@ -0,0 +1,158 @@
+"use client";
+import { cn } from "../../utils/cn.js";
+import { Carousel as Carousel$1, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious } from "../../core/carousel/carousel.js";
+import * as React$1 from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import Autoplay from "embla-carousel-autoplay";
+//#region src/components/carousel/carousel.tsx
+var MAX_DOTS_MIN = 1;
+var MAX_DOTS_MAX = 10;
+var MAX_DOTS_DEFAULT = 5;
+var DELAY_MIN = 1e3;
+var DELAY_MAX = 1e4;
+var DELAY_DEFAULT = 3e3;
+function clamp(value, min, max, fallback) {
+	if (!Number.isFinite(value)) return fallback;
+	return Math.min(max, Math.max(min, Math.floor(value)));
+}
+/**
+* Compute the sliding window of dot indices to render when the item count
+* exceeds `maxDots`. Returns the indices themselves — clicking dot at
+* position `i` scrolls to `windowIndices[i]`.
+*/
+function getDotWindow(total, maxDots, selectedIndex) {
+	if (total <= maxDots) return Array.from({ length: total }, (_, i) => i);
+	let start = selectedIndex - Math.floor(maxDots / 2);
+	if (start < 0) start = 0;
+	if (start > total - maxDots) start = total - maxDots;
+	return Array.from({ length: maxDots }, (_, i) => start + i);
+}
+function DotsRow({ total, maxDots, selectedIndex, orientation, onDotClick }) {
+	const window = getDotWindow(total, maxDots, selectedIndex);
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("flex items-center justify-center gap-1.5", orientation === "horizontal" ? "mt-3 flex-row" : "ml-3 flex-col"),
+		role: "tablist",
+		"aria-label": "Carousel pagination",
+		children: window.map((index) => {
+			const isActive = index === selectedIndex;
+			return /* @__PURE__ */ jsx("button", {
+				type: "button",
+				role: "tab",
+				"aria-selected": isActive,
+				"aria-label": `Go to slide ${index + 1}`,
+				onClick: () => onDotClick(index),
+				className: cn("rounded-full transition-all duration-200 ease-out", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2", orientation === "horizontal" ? isActive ? "h-2 w-4 bg-foreground" : "h-2 w-2 bg-muted-foreground/40 hover:bg-muted-foreground/60" : isActive ? "h-4 w-2 bg-foreground" : "h-2 w-2 bg-muted-foreground/40 hover:bg-muted-foreground/60")
+			}, index);
+		})
+	});
+}
+/**
+* High-level, data-driven carousel. Wraps shadcn/ui's Embla-based primitives
+* with a batteries-included API: pass `data`, pick a `navigation` style, and
+* everything else — autoplay, looping, keyboard arrow keys, dot pagination —
+* is wired up for you.
+*
+* For advanced composition (non-uniform slide widths, controlling multiple
+* carousels from one API, etc.) use `navigation="custom"` with
+* `renderNavigation`; the underlying Embla instance is not exposed.
+*/
+function Carousel({ data, orientation = "horizontal", navigation = "dots", maxDots = MAX_DOTS_DEFAULT, autoplay = false, delay = DELAY_DEFAULT, loop = true, onNext, onPrevious, renderNavigation, className, itemClassName }) {
+	const clampedMaxDots = clamp(maxDots, MAX_DOTS_MIN, MAX_DOTS_MAX, MAX_DOTS_DEFAULT);
+	const clampedDelay = clamp(delay, DELAY_MIN, DELAY_MAX, DELAY_DEFAULT);
+	const autoplayPlugin = React$1.useRef(autoplay ? Autoplay({
+		delay: clampedDelay,
+		stopOnInteraction: true
+	}) : null);
+	React$1.useEffect(() => {
+		if (!autoplayPlugin.current || !autoplay) return;
+		autoplayPlugin.current = Autoplay({
+			delay: clampedDelay,
+			stopOnInteraction: true
+		});
+	}, [autoplay, clampedDelay]);
+	const plugins = React$1.useMemo(() => autoplay && autoplayPlugin.current ? [autoplayPlugin.current] : [], [autoplay, clampedDelay]);
+	const [api, setApi] = React$1.useState();
+	const [selectedIndex, setSelectedIndex] = React$1.useState(0);
+	const [scrollSnaps, setScrollSnaps] = React$1.useState([]);
+	const [canScrollPrev, setCanScrollPrev] = React$1.useState(false);
+	const [canScrollNext, setCanScrollNext] = React$1.useState(false);
+	const prevIndexRef = React$1.useRef(0);
+	React$1.useEffect(() => {
+		if (!api) return;
+		setScrollSnaps(api.scrollSnapList());
+		setSelectedIndex(api.selectedScrollSnap());
+		prevIndexRef.current = api.selectedScrollSnap();
+		const handleSelect = () => {
+			const next = api.selectedScrollSnap();
+			const prev = prevIndexRef.current;
+			const total = api.scrollSnapList().length;
+			const diff = next - prev;
+			const isForward = diff === 1 || loop && diff === -(total - 1);
+			const isBackward = diff === -1 || loop && diff === total - 1;
+			if (isForward) onNext?.();
+			else if (isBackward) onPrevious?.();
+			prevIndexRef.current = next;
+			setSelectedIndex(next);
+			setCanScrollPrev(api.canScrollPrev());
+			setCanScrollNext(api.canScrollNext());
+		};
+		const handleReInit = () => {
+			setScrollSnaps(api.scrollSnapList());
+			setSelectedIndex(api.selectedScrollSnap());
+			setCanScrollPrev(api.canScrollPrev());
+			setCanScrollNext(api.canScrollNext());
+		};
+		setCanScrollPrev(api.canScrollPrev());
+		setCanScrollNext(api.canScrollNext());
+		api.on("select", handleSelect);
+		api.on("reInit", handleReInit);
+		return () => {
+			api.off("select", handleSelect);
+			api.off("reInit", handleReInit);
+		};
+	}, [
+		api,
+		loop,
+		onNext,
+		onPrevious
+	]);
+	const scrollTo = React$1.useCallback((index) => api?.scrollTo(index), [api]);
+	const navigationState = {
+		canScrollPrev,
+		canScrollNext,
+		selectedIndex,
+		scrollSnaps,
+		scrollPrev: React$1.useCallback(() => api?.scrollPrev(), [api]),
+		scrollNext: React$1.useCallback(() => api?.scrollNext(), [api]),
+		scrollTo
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn(orientation === "horizontal" ? "flex flex-col" : "flex flex-row", className),
+		children: [
+			/* @__PURE__ */ jsxs(Carousel$1, {
+				setApi,
+				orientation,
+				opts: { loop },
+				plugins,
+				className: "min-w-0 flex-1",
+				children: [/* @__PURE__ */ jsx(CarouselContent, { children: data.map((item) => /* @__PURE__ */ jsx(CarouselItem, {
+					className: itemClassName,
+					children: item.content
+				}, item.id)) }), navigation === "arrows" && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(CarouselPrevious, {}), /* @__PURE__ */ jsx(CarouselNext, {})] })]
+			}),
+			navigation === "dots" && data.length > 1 && /* @__PURE__ */ jsx(DotsRow, {
+				total: data.length,
+				maxDots: clampedMaxDots,
+				selectedIndex,
+				orientation,
+				onDotClick: scrollTo
+			}),
+			navigation === "custom" && renderNavigation && /* @__PURE__ */ jsx("div", {
+				className: cn(orientation === "horizontal" ? "mt-3" : "ml-3"),
+				children: renderNavigation(navigationState)
+			})
+		]
+	});
+}
+//#endregion
+export { Carousel };

package/dist/components/chart/area-chart.js

@@ -0,0 +1,135 @@
+import { cn } from "../../utils/cn.js";
+import { ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent } from "./chart.js";
+import { buildAutoSeriesConfig, coerceSeriesValuesToNumbers, inferCategoryKey } from "./chart-series-data.js";
+import * as React$1 from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Area, AreaChart, CartesianGrid, XAxis, YAxis } from "recharts";
+//#region src/components/chart/area-chart.tsx
+var DEFAULT_MARGIN = {
+	top: 0,
+	right: 0,
+	bottom: 0,
+	left: 0
+};
+var DEFAULT_X_AXIS_PADDING = {
+	left: 0,
+	right: 0
+};
+var AreaChart$1 = React$1.forwardRef(function AreaChart$2({ data, config: explicitConfig, categoryKey, stacked = false, curveType = "monotone", showTooltip = true, showLegend = false, showGrid = false, hideXAxis = false, hideYAxis = false, xAxisTickFormatter, yAxisTickFormatter, className, margin, xAxisPadding }, ref) {
+	const resolvedMargin = {
+		...DEFAULT_MARGIN,
+		...margin
+	};
+	const resolvedXAxisPadding = {
+		...DEFAULT_X_AXIS_PADDING,
+		...xAxisPadding
+	};
+	const resolvedCategoryKey = React$1.useMemo(() => categoryKey ?? inferCategoryKey(data[0]), [categoryKey, data]);
+	const config = React$1.useMemo(() => buildAutoSeriesConfig(data, resolvedCategoryKey, explicitConfig), [
+		data,
+		resolvedCategoryKey,
+		explicitConfig
+	]);
+	const seriesKeys = React$1.useMemo(() => Object.keys(config), [config]);
+	const chartData = React$1.useMemo(() => coerceSeriesValuesToNumbers(data, seriesKeys), [data, seriesKeys]);
+	const gradientPrefix = `area-fill-${React$1.useId().replace(/:/g, "")}`;
+	const gradientStops = stacked ? {
+		peak: .42,
+		highlight: .32,
+		mid: .18,
+		soft: .06
+	} : {
+		peak: .28,
+		highlight: .22,
+		mid: .1,
+		soft: .03
+	};
+	return /* @__PURE__ */ jsx(ChartContainer, {
+		ref,
+		config,
+		className: cn("w-full", className),
+		children: /* @__PURE__ */ jsxs(AreaChart, {
+			accessibilityLayer: true,
+			data: chartData,
+			margin: resolvedMargin,
+			children: [
+				/* @__PURE__ */ jsx("defs", { children: seriesKeys.map((key) => /* @__PURE__ */ jsxs("linearGradient", {
+					id: `${gradientPrefix}-${key}`,
+					x1: "0",
+					y1: "0",
+					x2: "0",
+					y2: "1",
+					children: [
+						/* @__PURE__ */ jsx("stop", {
+							offset: "0%",
+							stopColor: `var(--color-${key})`,
+							stopOpacity: gradientStops.peak
+						}),
+						/* @__PURE__ */ jsx("stop", {
+							offset: "14%",
+							stopColor: `var(--color-${key})`,
+							stopOpacity: gradientStops.highlight
+						}),
+						/* @__PURE__ */ jsx("stop", {
+							offset: "38%",
+							stopColor: `var(--color-${key})`,
+							stopOpacity: gradientStops.mid
+						}),
+						/* @__PURE__ */ jsx("stop", {
+							offset: "70%",
+							stopColor: `var(--color-${key})`,
+							stopOpacity: gradientStops.soft
+						}),
+						/* @__PURE__ */ jsx("stop", {
+							offset: "100%",
+							stopColor: `var(--color-${key})`,
+							stopOpacity: 0
+						})
+					]
+				}, key)) }),
+				showGrid && /* @__PURE__ */ jsx(CartesianGrid, { vertical: false }),
+				/* @__PURE__ */ jsx(XAxis, {
+					type: "category",
+					dataKey: resolvedCategoryKey,
+					hide: hideXAxis,
+					tickLine: false,
+					axisLine: false,
+					tickMargin: 8,
+					tickFormatter: xAxisTickFormatter,
+					padding: resolvedXAxisPadding,
+					interval: "preserveStartEnd"
+				}),
+				/* @__PURE__ */ jsx(YAxis, {
+					type: "number",
+					hide: hideYAxis,
+					tickLine: false,
+					axisLine: false,
+					tickMargin: 8,
+					tickFormatter: yAxisTickFormatter
+				}),
+				showTooltip && /* @__PURE__ */ jsx(ChartTooltip, {
+					cursor: {
+						fill: "var(--color-muted)",
+						fillOpacity: .12
+					},
+					content: /* @__PURE__ */ jsx(ChartTooltipContent, {})
+				}),
+				showLegend && /* @__PURE__ */ jsx(ChartLegend, { content: /* @__PURE__ */ jsx(ChartLegendContent, {}) }),
+				seriesKeys.map((key) => /* @__PURE__ */ jsx(Area, {
+					type: curveType,
+					dataKey: key,
+					stackId: stacked ? "stack" : void 0,
+					fill: `url(#${gradientPrefix}-${key})`,
+					stroke: `var(--color-${key})`,
+					strokeWidth: 1,
+					strokeOpacity: .75,
+					strokeLinecap: "round",
+					strokeLinejoin: "round",
+					isAnimationActive: true
+				}, key))
+			]
+		})
+	});
+});
+//#endregion
+export { AreaChart$1 as AreaChart };

package/dist/components/chart/bar-chart.js

@@ -0,0 +1,151 @@
+import { cn } from "../../utils/cn.js";
+import { ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent } from "./chart.js";
+import { buildAutoSeriesConfig, coerceSeriesValuesToNumbers, inferCategoryKey } from "./chart-series-data.js";
+import * as React$1 from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Bar, BarChart, CartesianGrid, XAxis, YAxis } from "recharts";
+//#region src/components/chart/bar-chart.tsx
+var BAR_SIZE_MAP = {
+	sm: 14,
+	default: 24,
+	lg: 36
+};
+var BAR_RADIUS = 4;
+function resolveBarSize(size) {
+	if (size == null) return BAR_SIZE_MAP.default;
+	if (typeof size === "number") return size;
+	return BAR_SIZE_MAP[size];
+}
+function getBarRadius(index, total, stacked, rounded, layout) {
+	if (!rounded) return [
+		0,
+		0,
+		0,
+		0
+	];
+	const r = BAR_RADIUS;
+	if (!stacked || total === 1) return layout === "horizontal" ? [
+		r,
+		r,
+		0,
+		0
+	] : [
+		r,
+		0,
+		0,
+		r
+	];
+	const isFirst = index === 0;
+	const isLast = index === total - 1;
+	if (layout === "vertical") {
+		if (isFirst) return [
+			r,
+			0,
+			0,
+			r
+		];
+		if (isLast) return [
+			0,
+			r,
+			r,
+			0
+		];
+		return [
+			0,
+			0,
+			0,
+			0
+		];
+	}
+	if (isLast) return [
+		r,
+		r,
+		0,
+		0
+	];
+	if (isFirst) return [
+		0,
+		0,
+		0,
+		0
+	];
+	return [
+		0,
+		0,
+		0,
+		0
+	];
+}
+var BarChart$1 = React$1.forwardRef(function BarChart$2({ data, config: explicitConfig, categoryKey, layout = "horizontal", stacked = false, barSize, rounded = true, showTooltip = true, showLegend = false, showGrid = false, hideXAxis = false, hideYAxis = false, xAxisTickFormatter, yAxisTickFormatter, labelFormatter, tooltipFormatter, tooltipContent, barGap, categoryGap, className, margin }, ref) {
+	const resolvedCategoryKey = React$1.useMemo(() => categoryKey ?? inferCategoryKey(data[0]), [categoryKey, data]);
+	const config = React$1.useMemo(() => buildAutoSeriesConfig(data, resolvedCategoryKey, explicitConfig), [
+		data,
+		resolvedCategoryKey,
+		explicitConfig
+	]);
+	const barKeys = React$1.useMemo(() => Object.keys(config), [config]);
+	const chartData = React$1.useMemo(() => coerceSeriesValuesToNumbers(data, barKeys), [data, barKeys]);
+	const maxBarSize = resolveBarSize(barSize);
+	const isVertical = layout === "vertical";
+	return /* @__PURE__ */ jsx(ChartContainer, {
+		ref,
+		config,
+		className: cn("w-full", className),
+		children: /* @__PURE__ */ jsxs(BarChart, {
+			accessibilityLayer: true,
+			layout,
+			data: chartData,
+			margin,
+			barGap,
+			barCategoryGap: categoryGap,
+			children: [
+				showGrid && /* @__PURE__ */ jsx(CartesianGrid, {
+					vertical: !isVertical,
+					horizontal: isVertical
+				}),
+				/* @__PURE__ */ jsx(XAxis, {
+					type: isVertical ? "number" : "category",
+					dataKey: isVertical ? void 0 : resolvedCategoryKey,
+					hide: hideXAxis,
+					tickLine: false,
+					axisLine: false,
+					tickMargin: 8,
+					tickFormatter: xAxisTickFormatter,
+					...isVertical ? {
+						domain: [0, "dataMax"],
+						padding: {
+							left: 0,
+							right: 0
+						}
+					} : {}
+				}),
+				/* @__PURE__ */ jsx(YAxis, {
+					type: isVertical ? "category" : "number",
+					dataKey: isVertical ? resolvedCategoryKey : void 0,
+					hide: hideYAxis,
+					tickLine: false,
+					axisLine: false,
+					tickFormatter: yAxisTickFormatter
+				}),
+				showTooltip && /* @__PURE__ */ jsx(ChartTooltip, {
+					cursor: {
+						fill: "var(--color-muted)",
+						fillOpacity: .12
+					},
+					labelFormatter,
+					content: tooltipContent ?? /* @__PURE__ */ jsx(ChartTooltipContent, { formatter: tooltipFormatter })
+				}),
+				showLegend && /* @__PURE__ */ jsx(ChartLegend, { content: /* @__PURE__ */ jsx(ChartLegendContent, {}) }),
+				barKeys.map((key, i) => /* @__PURE__ */ jsx(Bar, {
+					dataKey: key,
+					stackId: stacked ? "stack" : void 0,
+					fill: `var(--color-${key})`,
+					maxBarSize,
+					radius: getBarRadius(i, barKeys.length, stacked, rounded, layout)
+				}, key))
+			]
+		})
+	});
+});
+//#endregion
+export { BarChart$1 as BarChart };

package/dist/components/chart/chart-colors.js

@@ -0,0 +1,85 @@
+//#region src/components/chart/chart-colors.ts
+/**
+* Default series palette (order preserved). Values resolve from `@theme` in `colors.css`
+* (`--color-chart-1` … `--color-chart-10`). Consumers must load library styles (e.g.
+* `@espressif/dashboard-ui-components/styles`) so these variables exist. Additional
+* entries (`11` … `20`) are explicit hex accents.
+*/
+var DEFAULT_CHART_SERIES_COLORS = [
+	"var(--color-chart-1)",
+	"var(--color-chart-2)",
+	"var(--color-chart-3)",
+	"var(--color-chart-4)",
+	"var(--color-chart-5)",
+	"var(--color-chart-6)",
+	"var(--color-chart-7)",
+	"var(--color-chart-8)",
+	"var(--color-chart-9)",
+	"var(--color-chart-10)",
+	"#7DB7FF",
+	"#78D6B2",
+	"#FFB98A",
+	"#B79CED",
+	"#F6A6C1",
+	"#7ED7D1",
+	"#F5D67A",
+	"#FF9C9C",
+	"#D6B5FF",
+	"#A8D5BA"
+];
+/**
+* Ordinal series palette as named keys (`color1` … `color20`). First 10 use the
+* theme CSS vars from `colors.css`; remaining entries are explicit hex accents.
+*
+* {@link DEFAULT_CHART_SERIES_COLORS}; use this when you want dot access like
+* `CHART_CATEGORY_COLORS.success` for categories.
+*/
+var CHART_SERIES_COLORS = {
+	color1: DEFAULT_CHART_SERIES_COLORS[0],
+	color2: DEFAULT_CHART_SERIES_COLORS[1],
+	color3: DEFAULT_CHART_SERIES_COLORS[2],
+	color4: DEFAULT_CHART_SERIES_COLORS[3],
+	color5: DEFAULT_CHART_SERIES_COLORS[4],
+	color6: DEFAULT_CHART_SERIES_COLORS[5],
+	color7: DEFAULT_CHART_SERIES_COLORS[6],
+	color8: DEFAULT_CHART_SERIES_COLORS[7],
+	color9: DEFAULT_CHART_SERIES_COLORS[8],
+	color10: DEFAULT_CHART_SERIES_COLORS[9],
+	color11: DEFAULT_CHART_SERIES_COLORS[10],
+	color12: DEFAULT_CHART_SERIES_COLORS[11],
+	color13: DEFAULT_CHART_SERIES_COLORS[12],
+	color14: DEFAULT_CHART_SERIES_COLORS[13],
+	color15: DEFAULT_CHART_SERIES_COLORS[14],
+	color16: DEFAULT_CHART_SERIES_COLORS[15],
+	color17: DEFAULT_CHART_SERIES_COLORS[16],
+	color18: DEFAULT_CHART_SERIES_COLORS[17],
+	color19: DEFAULT_CHART_SERIES_COLORS[18],
+	color20: DEFAULT_CHART_SERIES_COLORS[19]
+};
+/** Semantic chart colors — resolve from `colors.css` (`--color-chart-success`, etc.). For ordinal series see {@link CHART_SERIES_COLORS}. */
+var CHART_CATEGORY_COLORS = {
+	primary: "var(--color-chart-primary)",
+	secondary: "var(--color-chart-secondary)",
+	success: "var(--color-chart-success)",
+	error: "var(--color-chart-error)",
+	warning: "var(--color-chart-warning)",
+	disabled: "var(--color-chart-disabled)",
+	gray: "var(--color-chart-gray)"
+};
+function getChartSeriesColor(index) {
+	return DEFAULT_CHART_SERIES_COLORS[index % DEFAULT_CHART_SERIES_COLORS.length];
+}
+function buildSeriesChartConfig(keys, options) {
+	const palette = options?.colors && options.colors.length > 0 ? options.colors : DEFAULT_CHART_SERIES_COLORS;
+	const config = {};
+	for (let i = 0; i < keys.length; i++) {
+		const key = keys[i];
+		config[key] = {
+			label: options?.labels?.[key] ?? key,
+			color: palette[i % palette.length]
+		};
+	}
+	return config;
+}
+//#endregion
+export { CHART_CATEGORY_COLORS, CHART_SERIES_COLORS, DEFAULT_CHART_SERIES_COLORS, buildSeriesChartConfig, getChartSeriesColor };

package/dist/components/chart/chart-series-data.js

@@ -0,0 +1,53 @@
+import { buildSeriesChartConfig } from "./chart-colors.js";
+//#region src/components/chart/chart-series-data.ts
+/**
+* Column names that map to the category / X axis even when values look numeric
+* (e.g. Unix epoch in `t`). Without this, `t: 1777507200` would be treated as a
+* Y series and `usage` could be confused as category depending on key order.
+*/
+var CATEGORY_AXIS_KEY_RE = /^(t|time|timestamp|date|ts|x|day|month|year|segment|label|name)$/i;
+var NUMERIC_STRING_RE = /^-?\d+(\.\d+)?([eE][+-]?\d+)?$/;
+function isLikelyYSeriesColumn(key, value) {
+	if (CATEGORY_AXIS_KEY_RE.test(key)) return false;
+	if (typeof value === "number" && Number.isFinite(value)) return true;
+	if (typeof value === "string") {
+		const s = value.trim();
+		if (s === "") return false;
+		return NUMERIC_STRING_RE.test(s);
+	}
+	return false;
+}
+/** First column that is not a plausible Y-metric; otherwise undefined (index / implicit X). */
+function inferCategoryKey(firstRow) {
+	if (!firstRow) return void 0;
+	for (const key of Object.keys(firstRow)) if (!isLikelyYSeriesColumn(key, firstRow[key])) return key;
+}
+function deriveSeriesKeysFromRow(firstRow, categoryKey) {
+	return Object.keys(firstRow).filter((k) => k !== categoryKey && isLikelyYSeriesColumn(k, firstRow[k]));
+}
+/** Coerce numeric strings to numbers for series columns so Recharts scales/lines work. */
+function coerceSeriesValuesToNumbers(data, seriesKeys) {
+	if (seriesKeys.length === 0) return data;
+	return data.map((row) => {
+		const out = { ...row };
+		for (const key of seriesKeys) {
+			const v = out[key];
+			if (typeof v === "string") {
+				const s = v.trim();
+				if (NUMERIC_STRING_RE.test(s)) {
+					const n = Number(s);
+					if (Number.isFinite(n)) out[key] = n;
+				}
+			}
+		}
+		return out;
+	});
+}
+function buildAutoSeriesConfig(data, categoryKey, explicitConfig) {
+	if (explicitConfig) return explicitConfig;
+	const first = data[0];
+	if (!first) return {};
+	return buildSeriesChartConfig(deriveSeriesKeysFromRow(first, categoryKey));
+}
+//#endregion
+export { buildAutoSeriesConfig, coerceSeriesValuesToNumbers, deriveSeriesKeysFromRow, inferCategoryKey, isLikelyYSeriesColumn };