@epilot/spark-ui 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/components/line-chart.cjs

@@ -0,0 +1,310 @@
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_chunk = require("../chunk-aJGBMT86.cjs");
+const require_utils_format = require("../utils/format.cjs");
+const require_components_chart = require("./chart.cjs");
+let react = require("react");
+react = require_chunk.__toESM(react);
+let react_jsx_runtime = require("react/jsx-runtime");
+let _visx_event = require("@visx/event");
+let _visx_group = require("@visx/group");
+let _visx_scale = require("@visx/scale");
+let _visx_shape = require("@visx/shape");
+let _visx_curve = require("@visx/curve");
+let _visx_tooltip = require("@visx/tooltip");
+let _visx_vendor_d3_array = require("@visx/vendor/d3-array");
+let cnfast = require("cnfast");
+//#region src/components/line-chart.tsx
+const DEFAULT_MARGIN = {
+	top: 16,
+	right: 16,
+	bottom: 40,
+	left: 48
+};
+const CURVE_MAP = {
+	monotone: _visx_curve.curveMonotoneX,
+	step: _visx_curve.curveStep,
+	"step-after": _visx_curve.curveStepAfter,
+	"step-before": _visx_curve.curveStepBefore,
+	linear: _visx_curve.curveLinear
+};
+const resolveCurve = (type) => CURVE_MAP[type];
+const dateBisector = (0, _visx_vendor_d3_array.bisector)((d) => d.date);
+const bisectDate = (data, x, lo) => dateBisector.left(data, x, lo);
+/** Whether `date` falls within a series' own x-range (data is sorted ascending). */
+function withinDomain(data, date) {
+	const first = data[0];
+	const last = data[data.length - 1];
+	if (!first || !last) return false;
+	const t = date.valueOf();
+	return t >= first.date.valueOf() && t <= last.date.valueOf();
+}
+/**
+* y-domain padded 10% beyond the data extent. The baseline is pinned to 0 so
+* all-positive series render from the axis up; a series that dips below 0
+* (signed grid / battery power) extends the domain downward to keep the zero
+* crossing visible.
+*/
+function computeYDomain(data) {
+	let min = 0;
+	let max = 0;
+	for (const d of data) {
+		if (d.value < min) min = d.value;
+		if (d.value > max) max = d.value;
+	}
+	if (min === max) return [min, min + 1];
+	return [min * 1.1, max * 1.1];
+}
+function nearestDatum(data, date) {
+	if (data.length === 0) return void 0;
+	const index = bisectDate(data, date, 1);
+	const d0 = data[index - 1];
+	const d1 = data[index];
+	if (!d0) return d1;
+	if (!d1) return d0;
+	return date.valueOf() - d0.date.valueOf() > d1.date.valueOf() - date.valueOf() ? d1 : d0;
+}
+const defaultFormatDate = (date) => date.toLocaleDateString(void 0, {
+	month: "short",
+	day: "numeric"
+});
+const defaultValueFormat = require_utils_format.localeNumberFormat();
+const defaultFormatValue = (value) => defaultValueFormat.format(value);
+const LINE_COLORS = [
+	"stroke-spark-9",
+	"stroke-green-9",
+	"stroke-blue-9",
+	"stroke-orange-9",
+	"stroke-red-9"
+];
+const DOT_COLORS = [
+	"fill-spark-9",
+	"fill-green-9",
+	"fill-blue-9",
+	"fill-orange-9",
+	"fill-red-9"
+];
+const LEGEND_COLORS = [
+	"var(--spark-9)",
+	"var(--green-9)",
+	"var(--blue-9)",
+	"var(--orange-9)",
+	"var(--red-9)"
+];
+const LineChart = ({ series, width, height, margin = DEFAULT_MARGIN, curve: defaultCurve = "monotone", showGrid = true, showTooltip: enableTooltip = true, className, xTickCount = 5, yTickCount = 4, formatDate = defaultFormatDate, formatTooltipDate, formatValue = defaultFormatValue, yDomain, referenceLines, topContent }) => {
+	const { showTooltip, hideTooltip, tooltipData, tooltipLeft, tooltipTop, tooltipOpen } = (0, _visx_tooltip.useTooltip)();
+	const innerWidth = Math.max(0, width - margin.left - margin.right);
+	const innerHeight = Math.max(0, height - margin.top - margin.bottom);
+	const allData = (0, react.useMemo)(() => series.flatMap((s) => s.data), [series]);
+	const xScale = (0, react.useMemo)(() => (0, _visx_scale.scaleTime)({
+		range: [0, innerWidth],
+		domain: (0, _visx_vendor_d3_array.extent)(allData, (d) => d.date)
+	}), [allData, innerWidth]);
+	const yScale = (0, react.useMemo)(() => (0, _visx_scale.scaleLinear)({
+		range: [innerHeight, 0],
+		domain: yDomain ?? computeYDomain(allData),
+		nice: !yDomain
+	}), [
+		allData,
+		innerHeight,
+		yDomain
+	]);
+	const xTicks = xScale.ticks(xTickCount);
+	const yTicks = yScale.ticks(yTickCount);
+	const handleTooltip = (0, react.useCallback)((event) => {
+		if (!enableTooltip) return;
+		const point = (0, _visx_event.localPoint)(event);
+		if (!point) return;
+		const x0 = xScale.invert(point.x - margin.left);
+		let anchorDate = null;
+		let bestDistance = Infinity;
+		for (const s of series) {
+			const d = nearestDatum(s.data, x0);
+			if (!d) continue;
+			const distance = Math.abs(d.date.valueOf() - x0.valueOf());
+			if (distance < bestDistance) {
+				bestDistance = distance;
+				anchorDate = d.date;
+			}
+		}
+		if (!anchorDate) return;
+		showTooltip({
+			tooltipData: { date: anchorDate },
+			tooltipLeft: xScale(anchorDate) + margin.left,
+			tooltipTop: margin.top
+		});
+	}, [
+		enableTooltip,
+		margin,
+		series,
+		showTooltip,
+		xScale
+	]);
+	const tooltipRows = tooltipData ? series.flatMap((s, i) => {
+		const d = nearestDatum(s.data, tooltipData.date);
+		if (!d || !withinDomain(s.data, tooltipData.date)) return [];
+		return [{
+			key: s.id,
+			label: s.label ?? s.id,
+			color: LEGEND_COLORS[i % LEGEND_COLORS.length],
+			value: formatValue(d.value)
+		}];
+	}) : [];
+	const [tooltipRef, tooltipSize] = require_components_chart.useMeasuredSize();
+	const tooltipPos = require_components_chart.clampTooltipPosition({
+		anchorX: tooltipLeft ?? 0,
+		anchorY: tooltipTop ?? margin.top,
+		width,
+		height,
+		tipWidth: tooltipSize.width,
+		tipHeight: tooltipSize.height,
+		placement: "beside"
+	});
+	if (width < 10 || height < 10) return null;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: (0, cnfast.cn)("relative", className),
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("svg", {
+				className: "block",
+				height,
+				width,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(_visx_group.Group, {
+					left: margin.left,
+					top: margin.top,
+					children: [
+						showGrid && yTicks.map((tick) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("line", {
+							className: "stroke-slate-a4",
+							strokeDasharray: "4,4",
+							x1: 0,
+							x2: innerWidth,
+							y1: yScale(tick),
+							y2: yScale(tick)
+						}, `grid-y-${tick}`)),
+						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("line", {
+							className: "stroke-slate-a6",
+							x1: 0,
+							x2: innerWidth,
+							y1: innerHeight,
+							y2: innerHeight
+						}),
+						referenceLines?.map((ref) => {
+							const x = xScale(ref.date);
+							if (!Number.isFinite(x)) return null;
+							const anchorEnd = x > innerWidth / 2;
+							return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("g", {
+								pointerEvents: "none",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("line", {
+									className: "stroke-orange-8",
+									strokeDasharray: "3,3",
+									x1: x,
+									x2: x,
+									y1: 0,
+									y2: innerHeight
+								}), ref.label != null && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("text", {
+									className: "fill-orange-11 text-[10px]",
+									dy: "0.9em",
+									textAnchor: anchorEnd ? "end" : "start",
+									x: x + (anchorEnd ? -4 : 4),
+									y: 0,
+									children: ref.label
+								})]
+							}, ref.key);
+						}),
+						xTicks.map((tick) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("text", {
+							className: "fill-slate-a11 text-xs",
+							dy: "1em",
+							textAnchor: "middle",
+							x: xScale(tick),
+							y: innerHeight + 8,
+							children: formatDate(tick)
+						}, `x-${tick.valueOf()}`)),
+						yTicks.map((tick) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("text", {
+							className: "fill-slate-a11 text-xs",
+							dx: "-0.5em",
+							dy: "0.32em",
+							textAnchor: "end",
+							x: -4,
+							y: yScale(tick),
+							children: formatValue(tick)
+						}, `y-${tick}`)),
+						series.map((s, i) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_visx_shape.LinePath, {
+							className: (0, cnfast.cn)(LINE_COLORS[i % LINE_COLORS.length], s.className),
+							curve: resolveCurve(s.curve ?? defaultCurve),
+							data: s.data,
+							fill: "none",
+							strokeDasharray: s.dashed ? s.dashPattern ?? "6,4" : void 0,
+							strokeWidth: 2,
+							x: (d) => xScale(d.date),
+							y: (d) => yScale(d.value)
+						}, s.id)),
+						enableTooltip && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("rect", {
+							fill: "transparent",
+							height: innerHeight,
+							onMouseLeave: hideTooltip,
+							onMouseMove: handleTooltip,
+							onTouchEnd: hideTooltip,
+							onTouchMove: handleTooltip,
+							width: innerWidth,
+							x: 0,
+							y: 0
+						}),
+						tooltipOpen && tooltipData && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("line", {
+							className: "stroke-slate-a6",
+							pointerEvents: "none",
+							strokeDasharray: "4,4",
+							x1: xScale(tooltipData.date),
+							x2: xScale(tooltipData.date),
+							y1: 0,
+							y2: innerHeight
+						}), series.map((s, i) => {
+							const d = nearestDatum(s.data, tooltipData.date);
+							if (!d || !withinDomain(s.data, tooltipData.date)) return null;
+							return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("circle", {
+								className: (0, cnfast.cn)(DOT_COLORS[i % DOT_COLORS.length]),
+								cx: xScale(d.date),
+								cy: yScale(d.value),
+								pointerEvents: "none",
+								r: 4,
+								stroke: "white",
+								strokeWidth: 2
+							}, s.id);
+						})] })
+					]
+				})
+			}),
+			topContent && topContent.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "pointer-events-none absolute inset-0",
+				children: topContent.map((item) => {
+					const x = xScale(item.date);
+					if (!Number.isFinite(x)) return null;
+					return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						className: "absolute -translate-x-1/2",
+						style: {
+							left: margin.left + x,
+							top: 0
+						},
+						children: item.content
+					}, item.key);
+				})
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				ref: tooltipRef,
+				className: "pointer-events-none absolute z-10",
+				style: {
+					left: tooltipPos.left,
+					top: tooltipPos.top,
+					opacity: tooltipOpen && tooltipData ? 1 : 0,
+					transition: "left 140ms ease-out, top 140ms ease-out, opacity 140ms ease-out"
+				},
+				children: tooltipData && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_components_chart.ChartTooltipCard, {
+					label: (formatTooltipDate ?? formatDate)(tooltipData.date),
+					rows: tooltipRows
+				})
+			})
+		]
+	});
+};
+//#endregion
+exports.LineChart = LineChart;
+
+//# sourceMappingURL=line-chart.cjs.map

package/dist/components/line-chart.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-chart.cjs","names":["curveMonotoneX","curveStep","curveStepAfter","curveStepBefore","curveLinear","localeNumberFormat","useMeasuredSize","clampTooltipPosition","Group","LinePath","ChartTooltipCard"],"sources":["../../src/components/line-chart.tsx"],"sourcesContent":["import {\n  curveLinear,\n  curveMonotoneX,\n  curveStep,\n  curveStepAfter,\n  curveStepBefore,\n} from '@visx/curve'\nimport { localPoint } from '@visx/event'\nimport { Group } from '@visx/group'\nimport { scaleLinear, scaleTime } from '@visx/scale'\nimport { LinePath } from '@visx/shape'\nimport { useTooltip } from '@visx/tooltip'\nimport { bisector, extent } from '@visx/vendor/d3-array'\nimport * as React from 'react'\nimport { useCallback, useMemo } from 'react'\nimport { cn } from '../utils/cn'\nimport { localeNumberFormat } from '../utils/format'\nimport {\n  ChartTooltipCard,\n  type ChartTooltipRow,\n  clampTooltipPosition,\n  useMeasuredSize,\n} from './chart'\n\nexport interface LineChartDatum {\n  date: Date\n  value: number\n}\n\nexport type LineChartCurve =\n  | 'monotone'\n  | 'step'\n  | 'step-after'\n  | 'step-before'\n  | 'linear'\n\nexport interface LineChartSeries {\n  id: string\n  data: LineChartDatum[]\n  /** Label shown in the hover tooltip. Defaults to `id`. */\n  label?: React.ReactNode\n  className?: string\n  /** Curve interpolation type. Default: inherits from LineChartProps.curve */\n  curve?: LineChartCurve\n  /** Render as a dashed line */\n  dashed?: boolean\n  /** Custom dash pattern (e.g. \"8,4\" or \"4,2,1,2\"). Only applies when dashed is true. */\n  dashPattern?: string\n}\n\nexport interface LineChartProps {\n  series: LineChartSeries[]\n  width: number\n  height: number\n  margin?: { top: number; right: number; bottom: number; left: number }\n  /** Default curve for all series. Default: 'monotone' */\n  curve?: LineChartCurve\n  showGrid?: boolean\n  showTooltip?: boolean\n  className?: string\n  xTickCount?: number\n  yTickCount?: number\n  /** Fixes the y-axis to an explicit `[min, max]`. Defaults to the data extent. */\n  yDomain?: [number, number]\n  /** Formats the x-axis tick labels. */\n  formatDate?: (date: Date) => string\n  /** Formats the tooltip title. Defaults to `formatDate`. */\n  formatTooltipDate?: (date: Date) => string\n  formatValue?: (value: number) => string\n  /**\n   * Vertical reference markers positioned on the time axis (e.g. sunrise /\n   * sunset). Each renders a dashed line across the plot with an optional label.\n   */\n  referenceLines?: Array<{ key: string; date: Date; label?: React.ReactNode }>\n  /**\n   * HTML content pinned to the top of the plot at a given time (e.g. an hourly\n   * weather icon). Positioned by the same time scale as the series, so it lines\n   * up with the curve below it.\n   */\n  topContent?: Array<{ key: string; date: Date; content: React.ReactNode }>\n}\n\nconst DEFAULT_MARGIN = { top: 16, right: 16, bottom: 40, left: 48 }\n\nconst CURVE_MAP = {\n  monotone: curveMonotoneX,\n  step: curveStep,\n  'step-after': curveStepAfter,\n  'step-before': curveStepBefore,\n  linear: curveLinear,\n} as const\n\nconst resolveCurve = (type: LineChartCurve) => CURVE_MAP[type]\n\nconst dateBisector = bisector<LineChartDatum, Date>((d) => d.date)\nconst bisectDate = (data: LineChartDatum[], x: Date, lo?: number) =>\n  dateBisector.left(data, x, lo)\n\n/** Whether `date` falls within a series' own x-range (data is sorted ascending). */\nfunction withinDomain(data: LineChartDatum[], date: Date): boolean {\n  const first = data[0]\n  const last = data[data.length - 1]\n  if (!first || !last) return false\n  const t = date.valueOf()\n  return t >= first.date.valueOf() && t <= last.date.valueOf()\n}\n\n/**\n * y-domain padded 10% beyond the data extent. The baseline is pinned to 0 so\n * all-positive series render from the axis up; a series that dips below 0\n * (signed grid / battery power) extends the domain downward to keep the zero\n * crossing visible.\n */\nfunction computeYDomain(data: LineChartDatum[]): [number, number] {\n  let min = 0\n  let max = 0\n  for (const d of data) {\n    if (d.value < min) min = d.value\n    if (d.value > max) max = d.value\n  }\n  if (min === max) return [min, min + 1]\n  return [min * 1.1, max * 1.1]\n}\n\nfunction nearestDatum(\n  data: LineChartDatum[],\n  date: Date,\n): LineChartDatum | undefined {\n  if (data.length === 0) return undefined\n  const index = bisectDate(data, date, 1)\n  const d0 = data[index - 1]\n  const d1 = data[index]\n  if (!d0) return d1\n  if (!d1) return d0\n  return date.valueOf() - d0.date.valueOf() > d1.date.valueOf() - date.valueOf()\n    ? d1\n    : d0\n}\n\nconst defaultFormatDate = (date: Date) =>\n  date.toLocaleDateString(undefined, { month: 'short', day: 'numeric' })\n\nconst defaultValueFormat = localeNumberFormat()\nconst defaultFormatValue = (value: number) => defaultValueFormat.format(value)\n\nconst LINE_COLORS = [\n  'stroke-spark-9',\n  'stroke-green-9',\n  'stroke-blue-9',\n  'stroke-orange-9',\n  'stroke-red-9',\n]\n\nconst DOT_COLORS = [\n  'fill-spark-9',\n  'fill-green-9',\n  'fill-blue-9',\n  'fill-orange-9',\n  'fill-red-9',\n]\n\n// CSS-var colours matching LINE_COLORS, used for the tooltip legend dots.\nconst LEGEND_COLORS = [\n  'var(--spark-9)',\n  'var(--green-9)',\n  'var(--blue-9)',\n  'var(--orange-9)',\n  'var(--red-9)',\n]\n\nconst LineChart: React.FC<LineChartProps> = ({\n  series,\n  width,\n  height,\n  margin = DEFAULT_MARGIN,\n  curve: defaultCurve = 'monotone',\n  showGrid = true,\n  showTooltip: enableTooltip = true,\n  className,\n  xTickCount = 5,\n  yTickCount = 4,\n  formatDate = defaultFormatDate,\n  formatTooltipDate,\n  formatValue = defaultFormatValue,\n  yDomain,\n  referenceLines,\n  topContent,\n}) => {\n  const {\n    showTooltip,\n    hideTooltip,\n    tooltipData,\n    tooltipLeft,\n    tooltipTop,\n    tooltipOpen,\n  } = useTooltip<{ date: Date }>()\n\n  const innerWidth = Math.max(0, width - margin.left - margin.right)\n  const innerHeight = Math.max(0, height - margin.top - margin.bottom)\n\n  const allData = useMemo(() => series.flatMap((s) => s.data), [series])\n\n  const xScale = useMemo(\n    () =>\n      scaleTime({\n        range: [0, innerWidth],\n        domain: extent(allData, (d) => d.date) as [Date, Date],\n      }),\n    [allData, innerWidth],\n  )\n\n  const yScale = useMemo(\n    () =>\n      scaleLinear({\n        range: [innerHeight, 0],\n        domain: yDomain ?? computeYDomain(allData),\n        nice: !yDomain,\n      }),\n    [allData, innerHeight, yDomain],\n  )\n\n  const xTicks = xScale.ticks(xTickCount)\n  const yTicks = yScale.ticks(yTickCount)\n\n  const handleTooltip = useCallback(\n    (\n      event:\n        | React.TouchEvent<SVGRectElement>\n        | React.MouseEvent<SVGRectElement>,\n    ) => {\n      if (!enableTooltip) return\n\n      const point = localPoint(event)\n      if (!point) return\n\n      const x0 = xScale.invert(point.x - margin.left)\n\n      // Snap to the data point closest to the cursor across all series, so the\n      // cursor line + tooltip line up with real values.\n      let anchorDate: Date | null = null\n      let bestDistance = Infinity\n      for (const s of series) {\n        const d = nearestDatum(s.data, x0)\n        if (!d) continue\n        const distance = Math.abs(d.date.valueOf() - x0.valueOf())\n        if (distance < bestDistance) {\n          bestDistance = distance\n          anchorDate = d.date\n        }\n      }\n\n      if (!anchorDate) return\n\n      showTooltip({\n        tooltipData: { date: anchorDate },\n        tooltipLeft: xScale(anchorDate) + margin.left,\n        tooltipTop: margin.top,\n      })\n    },\n    [enableTooltip, margin, series, showTooltip, xScale],\n  )\n\n  const tooltipRows: ChartTooltipRow[] = tooltipData\n    ? series.flatMap((s, i) => {\n        const d = nearestDatum(s.data, tooltipData.date)\n        if (!d || !withinDomain(s.data, tooltipData.date)) return []\n        return [\n          {\n            key: s.id,\n            label: s.label ?? s.id,\n            color: LEGEND_COLORS[i % LEGEND_COLORS.length] as string,\n            value: formatValue(d.value),\n          },\n        ]\n      })\n    : []\n\n  const [tooltipRef, tooltipSize] = useMeasuredSize<HTMLDivElement>()\n  const tooltipPos = clampTooltipPosition({\n    anchorX: tooltipLeft ?? 0,\n    anchorY: tooltipTop ?? margin.top,\n    width,\n    height,\n    tipWidth: tooltipSize.width,\n    tipHeight: tooltipSize.height,\n    placement: 'beside',\n  })\n\n  if (width < 10 || height < 10) return null\n\n  return (\n    <div className={cn('relative', className)}>\n      <svg className=\"block\" height={height} width={width}>\n        <Group left={margin.left} top={margin.top}>\n          {/* Grid lines */}\n          {showGrid &&\n            yTicks.map((tick) => (\n              <line\n                className=\"stroke-slate-a4\"\n                key={`grid-y-${tick}`}\n                strokeDasharray=\"4,4\"\n                x1={0}\n                x2={innerWidth}\n                y1={yScale(tick)}\n                y2={yScale(tick)}\n              />\n            ))}\n\n          {/* X axis */}\n          <line\n            className=\"stroke-slate-a6\"\n            x1={0}\n            x2={innerWidth}\n            y1={innerHeight}\n            y2={innerHeight}\n          />\n\n          {/* Reference markers (e.g. sunrise / sunset) */}\n          {referenceLines?.map((ref) => {\n            const x = xScale(ref.date)\n            if (!Number.isFinite(x)) return null\n            // Sit the label beside the line, on whichever side keeps it in\n            // frame: right of a left-half marker, left of a right-half one.\n            const anchorEnd = x > innerWidth / 2\n            return (\n              <g key={ref.key} pointerEvents=\"none\">\n                <line\n                  className=\"stroke-orange-8\"\n                  strokeDasharray=\"3,3\"\n                  x1={x}\n                  x2={x}\n                  y1={0}\n                  y2={innerHeight}\n                />\n                {ref.label != null && (\n                  <text\n                    className=\"fill-orange-11 text-[10px]\"\n                    dy=\"0.9em\"\n                    textAnchor={anchorEnd ? 'end' : 'start'}\n                    x={x + (anchorEnd ? -4 : 4)}\n                    y={0}\n                  >\n                    {ref.label}\n                  </text>\n                )}\n              </g>\n            )\n          })}\n\n          {/* X axis labels */}\n          {xTicks.map((tick) => (\n            <text\n              className=\"fill-slate-a11 text-xs\"\n              dy=\"1em\"\n              key={`x-${tick.valueOf()}`}\n              textAnchor=\"middle\"\n              x={xScale(tick)}\n              y={innerHeight + 8}\n            >\n              {formatDate(tick)}\n            </text>\n          ))}\n\n          {/* Y axis labels */}\n          {yTicks.map((tick) => (\n            <text\n              className=\"fill-slate-a11 text-xs\"\n              dx=\"-0.5em\"\n              dy=\"0.32em\"\n              key={`y-${tick}`}\n              textAnchor=\"end\"\n              x={-4}\n              y={yScale(tick)}\n            >\n              {formatValue(tick)}\n            </text>\n          ))}\n\n          {/* Lines */}\n          {series.map((s, i) => (\n            <LinePath\n              className={cn(LINE_COLORS[i % LINE_COLORS.length], s.className)}\n              curve={resolveCurve(s.curve ?? defaultCurve)}\n              data={s.data}\n              fill=\"none\"\n              key={s.id}\n              strokeDasharray={s.dashed ? (s.dashPattern ?? '6,4') : undefined}\n              strokeWidth={2}\n              x={(d) => xScale(d.date)}\n              y={(d) => yScale(d.value)}\n            />\n          ))}\n\n          {/* Tooltip hover target */}\n          {enableTooltip && (\n            <rect\n              fill=\"transparent\"\n              height={innerHeight}\n              onMouseLeave={hideTooltip}\n              onMouseMove={handleTooltip}\n              onTouchEnd={hideTooltip}\n              onTouchMove={handleTooltip}\n              width={innerWidth}\n              x={0}\n              y={0}\n            />\n          )}\n\n          {/* Cursor line + a dot per series */}\n          {tooltipOpen && tooltipData && (\n            <>\n              <line\n                className=\"stroke-slate-a6\"\n                pointerEvents=\"none\"\n                strokeDasharray=\"4,4\"\n                x1={xScale(tooltipData.date)}\n                x2={xScale(tooltipData.date)}\n                y1={0}\n                y2={innerHeight}\n              />\n              {series.map((s, i) => {\n                const d = nearestDatum(s.data, tooltipData.date)\n                if (!d || !withinDomain(s.data, tooltipData.date)) return null\n                return (\n                  <circle\n                    key={s.id}\n                    className={cn(DOT_COLORS[i % DOT_COLORS.length])}\n                    cx={xScale(d.date)}\n                    cy={yScale(d.value)}\n                    pointerEvents=\"none\"\n                    r={4}\n                    stroke=\"white\"\n                    strokeWidth={2}\n                  />\n                )\n              })}\n            </>\n          )}\n        </Group>\n      </svg>\n\n      {topContent && topContent.length > 0 && (\n        <div className=\"pointer-events-none absolute inset-0\">\n          {topContent.map((item) => {\n            const x = xScale(item.date)\n            if (!Number.isFinite(x)) return null\n            return (\n              <div\n                key={item.key}\n                className=\"absolute -translate-x-1/2\"\n                style={{ left: margin.left + x, top: 0 }}\n              >\n                {item.content}\n              </div>\n            )\n          })}\n        </div>\n      )}\n\n      <div\n        ref={tooltipRef}\n        className=\"pointer-events-none absolute z-10\"\n        style={{\n          left: tooltipPos.left,\n          top: tooltipPos.top,\n          opacity: tooltipOpen && tooltipData ? 1 : 0,\n          transition:\n            'left 140ms ease-out, top 140ms ease-out, opacity 140ms ease-out',\n        }}\n      >\n        {tooltipData && (\n          <ChartTooltipCard\n            label={(formatTooltipDate ?? formatDate)(tooltipData.date)}\n            rows={tooltipRows}\n          />\n        )}\n      </div>\n    </div>\n  )\n}\n\nexport { LineChart }\n"],"mappings":"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"}

package/dist/components/line-chart.d.cts

@@ -0,0 +1,71 @@
+"use client";
+
+import * as React$1 from "react";
+
+//#region src/components/line-chart.d.ts
+interface LineChartDatum {
+  date: Date;
+  value: number;
+}
+type LineChartCurve = 'monotone' | 'step' | 'step-after' | 'step-before' | 'linear';
+interface LineChartSeries {
+  id: string;
+  data: LineChartDatum[];
+  /** Label shown in the hover tooltip. Defaults to `id`. */
+  label?: React$1.ReactNode;
+  className?: string;
+  /** Curve interpolation type. Default: inherits from LineChartProps.curve */
+  curve?: LineChartCurve;
+  /** Render as a dashed line */
+  dashed?: boolean;
+  /** Custom dash pattern (e.g. "8,4" or "4,2,1,2"). Only applies when dashed is true. */
+  dashPattern?: string;
+}
+interface LineChartProps {
+  series: LineChartSeries[];
+  width: number;
+  height: number;
+  margin?: {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+  };
+  /** Default curve for all series. Default: 'monotone' */
+  curve?: LineChartCurve;
+  showGrid?: boolean;
+  showTooltip?: boolean;
+  className?: string;
+  xTickCount?: number;
+  yTickCount?: number;
+  /** Fixes the y-axis to an explicit `[min, max]`. Defaults to the data extent. */
+  yDomain?: [number, number];
+  /** Formats the x-axis tick labels. */
+  formatDate?: (date: Date) => string;
+  /** Formats the tooltip title. Defaults to `formatDate`. */
+  formatTooltipDate?: (date: Date) => string;
+  formatValue?: (value: number) => string;
+  /**
+   * Vertical reference markers positioned on the time axis (e.g. sunrise /
+   * sunset). Each renders a dashed line across the plot with an optional label.
+   */
+  referenceLines?: Array<{
+    key: string;
+    date: Date;
+    label?: React$1.ReactNode;
+  }>;
+  /**
+   * HTML content pinned to the top of the plot at a given time (e.g. an hourly
+   * weather icon). Positioned by the same time scale as the series, so it lines
+   * up with the curve below it.
+   */
+  topContent?: Array<{
+    key: string;
+    date: Date;
+    content: React$1.ReactNode;
+  }>;
+}
+declare const LineChart: React$1.FC<LineChartProps>;
+//#endregion
+export { LineChart, LineChartCurve, LineChartDatum, LineChartProps, LineChartSeries };
+//# sourceMappingURL=line-chart.d.cts.map

package/dist/components/line-chart.d.ts

@@ -0,0 +1,71 @@
+"use client";
+
+import * as React$1 from "react";
+
+//#region src/components/line-chart.d.ts
+interface LineChartDatum {
+  date: Date;
+  value: number;
+}
+type LineChartCurve = 'monotone' | 'step' | 'step-after' | 'step-before' | 'linear';
+interface LineChartSeries {
+  id: string;
+  data: LineChartDatum[];
+  /** Label shown in the hover tooltip. Defaults to `id`. */
+  label?: React$1.ReactNode;
+  className?: string;
+  /** Curve interpolation type. Default: inherits from LineChartProps.curve */
+  curve?: LineChartCurve;
+  /** Render as a dashed line */
+  dashed?: boolean;
+  /** Custom dash pattern (e.g. "8,4" or "4,2,1,2"). Only applies when dashed is true. */
+  dashPattern?: string;
+}
+interface LineChartProps {
+  series: LineChartSeries[];
+  width: number;
+  height: number;
+  margin?: {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+  };
+  /** Default curve for all series. Default: 'monotone' */
+  curve?: LineChartCurve;
+  showGrid?: boolean;
+  showTooltip?: boolean;
+  className?: string;
+  xTickCount?: number;
+  yTickCount?: number;
+  /** Fixes the y-axis to an explicit `[min, max]`. Defaults to the data extent. */
+  yDomain?: [number, number];
+  /** Formats the x-axis tick labels. */
+  formatDate?: (date: Date) => string;
+  /** Formats the tooltip title. Defaults to `formatDate`. */
+  formatTooltipDate?: (date: Date) => string;
+  formatValue?: (value: number) => string;
+  /**
+   * Vertical reference markers positioned on the time axis (e.g. sunrise /
+   * sunset). Each renders a dashed line across the plot with an optional label.
+   */
+  referenceLines?: Array<{
+    key: string;
+    date: Date;
+    label?: React$1.ReactNode;
+  }>;
+  /**
+   * HTML content pinned to the top of the plot at a given time (e.g. an hourly
+   * weather icon). Positioned by the same time scale as the series, so it lines
+   * up with the curve below it.
+   */
+  topContent?: Array<{
+    key: string;
+    date: Date;
+    content: React$1.ReactNode;
+  }>;
+}
+declare const LineChart: React$1.FC<LineChartProps>;
+//#endregion
+export { LineChart, LineChartCurve, LineChartDatum, LineChartProps, LineChartSeries };
+//# sourceMappingURL=line-chart.d.ts.map