@epilot/spark-ui 0.10.0

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

@@ -0,0 +1,90 @@
+"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;
+  /**
+   * CSS color for the tooltip swatch and hover dot (e.g. `var(--orange-9)`).
+   * Defaults to the palette color for the series index. Set this whenever
+   * `className` overrides the stroke so the tooltip stays in sync.
+   */
+  color?: 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;
+  /**
+   * Unit shown once at the top of the y-axis (e.g. "kW"). When set, y-axis tick
+   * labels render as plain numbers (matching BarChart / PowerHistoryChart)
+   * instead of repeating `formatValue` on every tick. `formatValue` still feeds
+   * the tooltip. Omit to keep the per-tick `formatValue` labels.
+   */
+  yAxisUnit?: string;
+  /** Overrides the y-axis tick formatter used when `yAxisUnit` is set. Defaults to the shared compact formatter. */
+  formatYTick?: (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;
+  }>;
+  zoomable?: boolean;
+  zoomResetLabel?: string;
+  zoomDomain?: [Date, Date] | null;
+  onZoomDomainChange?: (domain: [Date, Date] | null) => void;
+}
+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,90 @@
+"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;
+  /**
+   * CSS color for the tooltip swatch and hover dot (e.g. `var(--orange-9)`).
+   * Defaults to the palette color for the series index. Set this whenever
+   * `className` overrides the stroke so the tooltip stays in sync.
+   */
+  color?: 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;
+  /**
+   * Unit shown once at the top of the y-axis (e.g. "kW"). When set, y-axis tick
+   * labels render as plain numbers (matching BarChart / PowerHistoryChart)
+   * instead of repeating `formatValue` on every tick. `formatValue` still feeds
+   * the tooltip. Omit to keep the per-tick `formatValue` labels.
+   */
+  yAxisUnit?: string;
+  /** Overrides the y-axis tick formatter used when `yAxisUnit` is set. Defaults to the shared compact formatter. */
+  formatYTick?: (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;
+  }>;
+  zoomable?: boolean;
+  zoomResetLabel?: string;
+  zoomDomain?: [Date, Date] | null;
+  onZoomDomainChange?: (domain: [Date, Date] | null) => void;
+}
+declare const LineChart: React$1.FC<LineChartProps>;
+//#endregion
+export { LineChart, LineChartCurve, LineChartDatum, LineChartProps, LineChartSeries };
+//# sourceMappingURL=line-chart.d.ts.map