@matthieumordrel/chart-studio 0.1.0

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,GACf,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,aAAa,EACb,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,iCAAiC,EACjC,mCAAmC,EACnC,kCAAkC,EAClC,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC9B,UAAU,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,WAAW,EACX,eAAe,EACf,MAAM,EACN,WAAW,EACX,aAAa,EACb,UAAU,EACV,wBAAwB,EACxB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,uBAAuB,GACxB,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/**
+ * chart-studio — TanStack Table for charts.
+ *
+ * A headless, composable charting library built on top of Recharts.
+ * Pass raw data for the zero-config path, or add an explicit `schema` when you
+ * want full control over inference overrides, derived columns, and selectable
+ * chart controls.
+ *
+ * @example
+ * ```tsx
+ * import { defineChartSchema, useChart } from '@matthieumordrel/chart-studio'
+ * import { Chart, ChartToolbar, ChartCanvas } from '@matthieumordrel/chart-studio/ui'
+ *
+ * function MyChart({ data }) {
+ *   const chart = useChart({
+ *     data,
+ *     schema: defineChartSchema<typeof data[number]>()({
+ *       columns: {
+ *         dateAdded: { label: 'Date Added', type: 'date' },
+ *         ownerName: { label: 'Consultant' },
+ *         salary: { format: 'currency' }
+ *       }
+ *     })
+ *   })
+ *   return (
+ *     <Chart chart={chart}>
+ *       <ChartToolbar />
+ *       <ChartCanvas />
+ *     </Chart>
+ *   )
+ * }
+ * ```
+ */
+// Headless charting API.
+export { CHART_TYPE_CONFIG, defineChartSchema, inferColumnsFromData, useChart, getSeriesColor, buildColorMap, runPipeline, applyFilters, extractAvailableFilters, buildAvailableMetrics, getMetricLabel, } from './core/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,yBAAyB;AACzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,WAAW,EACX,YAAY,EACZ,uBAAuB,EACvB,qBAAqB,EACrB,cAAc,GACf,MAAM,iBAAiB,CAAA"}

package/dist/ui/chart-axis-ticks.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared axis tick value type for cartesian X axes.
+ */
+export type AxisTickValue = string | number;
+/**
+ * Options used to select the visible X-axis ticks for a categorical chart.
+ */
+type SelectVisibleXAxisTicksOptions = {
+    values: readonly AxisTickValue[];
+    labels: readonly string[];
+    plotWidth: number;
+    minimumTickGap?: number;
+    measureLabelWidth?: (label: string) => number;
+};
+/**
+ * Select visible X-axis tick values so labels stay readable, the first and last
+ * values always remain visible, and any unavoidable wider gaps are pushed away
+ * from the chart edges.
+ */
+export declare function selectVisibleXAxisTicks({ values, labels, plotWidth, minimumTickGap, measureLabelWidth, }: SelectVisibleXAxisTicksOptions): AxisTickValue[];
+/**
+ * Estimate the minimum index distance required between rendered labels so they
+ * can fit inside the available plot width without overlapping.
+ */
+export declare function estimateMinimumTickStep(labels: readonly string[], plotWidth: number, minimumTickGap: number, measureLabelWidth: (label: string) => number): number;
+/**
+ * Build the visible tick indices for a given point count and minimum step.
+ *
+ * The selector keeps the first and last tick, shows as many intermediate ticks
+ * as possible, and places any wider fallback gaps near the center so the edges
+ * stay visually balanced.
+ */
+export declare function buildVisibleTickIndices(pointCount: number, minimumStep: number): number[];
+export {};
+//# sourceMappingURL=chart-axis-ticks.d.ts.map

package/dist/ui/chart-axis-ticks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-axis-ticks.d.ts","sourceRoot":"","sources":["../../src/ui/chart-axis-ticks.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAA;AAE3C;;GAEG;AACH,KAAK,8BAA8B,GAAG;IACpC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IAChC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CAC9C,CAAA;AAOD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,MAAM,EACN,SAAS,EACT,cAAyC,EACzC,iBAAqD,GACtD,EAAE,8BAA8B,GAAG,aAAa,EAAE,CAQlD;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAC3C,MAAM,CAQR;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCzF"}

package/dist/ui/chart-axis-ticks.js

@@ -0,0 +1,80 @@
+/**
+ * Default horizontal breathing room kept between two rendered tick labels.
+ */
+const DEFAULT_MINIMUM_TICK_GAP = 8;
+/**
+ * Select visible X-axis tick values so labels stay readable, the first and last
+ * values always remain visible, and any unavoidable wider gaps are pushed away
+ * from the chart edges.
+ */
+export function selectVisibleXAxisTicks({ values, labels, plotWidth, minimumTickGap = DEFAULT_MINIMUM_TICK_GAP, measureLabelWidth = measureLabelWidthByCharacterCount, }) {
+    if (values.length <= 2) {
+        return [...values];
+    }
+    const minimumStep = estimateMinimumTickStep(labels, plotWidth, minimumTickGap, measureLabelWidth);
+    const visibleIndices = buildVisibleTickIndices(values.length, minimumStep);
+    return visibleIndices.map((index) => values[index]);
+}
+/**
+ * Estimate the minimum index distance required between rendered labels so they
+ * can fit inside the available plot width without overlapping.
+ */
+export function estimateMinimumTickStep(labels, plotWidth, minimumTickGap, measureLabelWidth) {
+    if (labels.length <= 1) {
+        return 1;
+    }
+    const widestLabel = labels.reduce((maxWidth, label) => Math.max(maxWidth, measureLabelWidth(label)), 0);
+    const slotWidth = plotWidth / Math.max(labels.length - 1, 1);
+    return Math.max(1, Math.ceil((widestLabel + minimumTickGap) / Math.max(slotWidth, 1)));
+}
+/**
+ * Build the visible tick indices for a given point count and minimum step.
+ *
+ * The selector keeps the first and last tick, shows as many intermediate ticks
+ * as possible, and places any wider fallback gaps near the center so the edges
+ * stay visually balanced.
+ */
+export function buildVisibleTickIndices(pointCount, minimumStep) {
+    if (pointCount <= 0) {
+        return [];
+    }
+    if (pointCount <= 2) {
+        return Array.from({ length: pointCount }, (_, index) => index);
+    }
+    const safeMinimumStep = Math.max(1, Math.floor(minimumStep));
+    if (safeMinimumStep === 1) {
+        return Array.from({ length: pointCount }, (_, index) => index);
+    }
+    const gapCount = Math.floor((pointCount - 1) / safeMinimumStep);
+    if (gapCount === 0) {
+        return [0, pointCount - 1];
+    }
+    const gaps = Array.from({ length: gapCount }, () => safeMinimumStep);
+    const remainder = (pointCount - 1) - safeMinimumStep * gapCount;
+    for (const gapIndex of getCenteredGapOrder(gapCount).slice(0, remainder)) {
+        const gap = gaps[gapIndex];
+        if (gap !== undefined) {
+            gaps[gapIndex] = gap + 1;
+        }
+    }
+    const visibleIndices = [0];
+    for (const gap of gaps) {
+        visibleIndices.push(visibleIndices[visibleIndices.length - 1] + gap);
+    }
+    return visibleIndices;
+}
+/**
+ * Order gap positions from the center outward so any larger fallback gaps land
+ * away from the chart edges.
+ */
+function getCenteredGapOrder(gapCount) {
+    const center = (gapCount - 1) / 2;
+    return Array.from({ length: gapCount }, (_, index) => index).sort((left, right) => Math.abs(left - center) - Math.abs(right - center) || left - right);
+}
+/**
+ * Lightweight default width estimate used by tests and non-DOM callers.
+ */
+function measureLabelWidthByCharacterCount(label) {
+    return label.length;
+}
+//# sourceMappingURL=chart-axis-ticks.js.map

package/dist/ui/chart-axis-ticks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-axis-ticks.js","sourceRoot":"","sources":["../../src/ui/chart-axis-ticks.ts"],"names":[],"mappings":"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"}

package/dist/ui/chart-canvas.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Chart canvas — renders the actual recharts chart based on the current state.
+ *
+ * Supports: bar, line, area (time-series), bar, pie, donut (categorical).
+ * Automatically switches between chart types based on the chart instance state.
+ */
+/**
+ * Props for ChartCanvas.
+ *
+ * @property height - Chart height in pixels (default: 300)
+ * @property className - Additional CSS classes
+ * @property showDataLabels - Opt into cartesian/pie value labels using the shared formatting rules.
+ */
+type ChartCanvasProps = {
+    height?: number;
+    className?: string;
+    showDataLabels?: boolean;
+};
+/** Renders the appropriate recharts chart based on the chart instance state. */
+export declare function ChartCanvas({ height, className, showDataLabels }: ChartCanvasProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=chart-canvas.d.ts.map

package/dist/ui/chart-canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-canvas.d.ts","sourceRoot":"","sources":["../../src/ui/chart-canvas.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+KH;;;;;;GAMG;AACH,KAAK,gBAAgB,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAuED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,EAAC,MAAY,EAAE,SAAS,EAAE,cAAsB,EAAC,EAAE,gBAAgB,2CA2F9F"}

package/dist/ui/chart-canvas.js

@@ -0,0 +1,338 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Chart canvas — renders the actual recharts chart based on the current state.
+ *
+ * Supports: bar, line, area (time-series), bar, pie, donut (categorical).
+ * Automatically switches between chart types based on the chart instance state.
+ */
+import { useEffect, useRef, useState } from 'react';
+import { Area, AreaChart, Bar, BarChart, CartesianGrid, Legend, LabelList, Line, LineChart, Pie, PieChart, Tooltip, XAxis, YAxis, } from 'recharts';
+import { createNumericRange, formatChartValue, formatTimeBucketLabel, shouldAllowDecimalTicks, } from '../core/formatting.js';
+import { useChartContext } from './chart-context.js';
+import { getSeriesColor } from '../core/colors.js';
+import { selectVisibleXAxisTicks } from './chart-axis-ticks.js';
+/**
+ * Estimates the pixel width the YAxis needs so no label is ever clipped.
+ * Considers both the visible range and the likely "nice" axis boundary Recharts
+ * may choose above it, then measures the widest formatted label and adds a
+ * small gutter for tick spacing.
+ */
+function estimateYAxisWidth(numericRange, valueColumn) {
+    const labels = getYAxisLabelCandidates(numericRange, valueColumn);
+    const widestLabel = labels.reduce((maxWidth, label) => Math.max(maxWidth, measureAxisLabelWidth(label)), 0);
+    return Math.max(MIN_Y_AXIS_WIDTH, Math.ceil(widestLabel + Y_AXIS_WIDTH_GUTTER));
+}
+/**
+ * Font used by the shared chart axis ticks (`text-xs` in the default theme).
+ */
+const AXIS_TICK_FONT = '12px system-ui, sans-serif';
+/**
+ * Canvas measurement can be unavailable in some environments, so keep a
+ * slightly generous character-width fallback.
+ */
+const FALLBACK_AXIS_CHARACTER_WIDTH = 8;
+/**
+ * Minimum width so short numeric axes still have breathing room.
+ */
+const MIN_Y_AXIS_WIDTH = 48;
+/**
+ * Extra space for tick margin plus a small anti-clipping buffer.
+ */
+const Y_AXIS_WIDTH_GUTTER = 18;
+/**
+ * Horizontal breathing room kept between two visible X-axis labels.
+ */
+const X_AXIS_MINIMUM_TICK_GAP = 8;
+/**
+ * Build a small set of realistic axis labels and size for the widest one.
+ * This catches cases where the chart data tops out below the rounded axis
+ * tick, such as `950` minutes producing a `1000` minute top tick.
+ */
+function getYAxisLabelCandidates(numericRange, valueColumn) {
+    const candidates = getYAxisCandidateValues(numericRange);
+    return candidates.map((value) => formatChartValue(value, {
+        column: valueColumn,
+        surface: 'axis',
+        numericRange,
+    }));
+}
+/**
+ * Include the visible extrema plus rounded axis boundaries so the width
+ * estimate matches what the axis is likely to render.
+ */
+function getYAxisCandidateValues(numericRange) {
+    if (!numericRange) {
+        return [0];
+    }
+    const maxAbs = Math.max(Math.abs(numericRange.min), Math.abs(numericRange.max));
+    const niceMaxAbs = getNiceAxisBoundary(maxAbs);
+    const values = new Set([0, numericRange.min, numericRange.max, maxAbs, niceMaxAbs]);
+    if (numericRange.min < 0) {
+        values.add(-niceMaxAbs);
+    }
+    return Array.from(values);
+}
+/**
+ * Approximate the rounded outer tick value chart libraries tend to choose for
+ * a human-friendly numeric axis.
+ */
+function getNiceAxisBoundary(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        return 0;
+    }
+    const exponent = Math.floor(Math.log10(value));
+    const magnitude = 10 ** exponent;
+    const fraction = value / magnitude;
+    if (fraction <= 1)
+        return magnitude;
+    if (fraction <= 2)
+        return 2 * magnitude;
+    if (fraction <= 5)
+        return 5 * magnitude;
+    return 10 * magnitude;
+}
+/**
+ * Measure axis text width in the browser and fall back to a safe character
+ * estimate in non-DOM environments.
+ */
+function measureAxisLabelWidth(label) {
+    if (typeof document === 'undefined') {
+        return label.length * FALLBACK_AXIS_CHARACTER_WIDTH;
+    }
+    const canvas = document.createElement('canvas');
+    const context = canvas.getContext('2d');
+    if (!context) {
+        return label.length * FALLBACK_AXIS_CHARACTER_WIDTH;
+    }
+    context.font = AXIS_TICK_FONT;
+    return context.measureText(label).width;
+}
+/**
+ * Approximate the drawable X-axis width after margins, Y-axis labels, and axis
+ * padding have taken their share of the SVG width.
+ */
+function getCartesianPlotWidth(totalWidth, yAxisWidth) {
+    return Math.max(1, totalWidth
+        - yAxisWidth
+        - CARTESIAN_BASE_MARGIN.left
+        - CARTESIAN_BASE_MARGIN.right
+        - CARTESIAN_X_AXIS_PADDING.left
+        - CARTESIAN_X_AXIS_PADDING.right);
+}
+/**
+ * Resolve the raw categorical tick value used by Recharts for one transformed
+ * pipeline point.
+ */
+function getXAxisTickValue(point) {
+    return typeof point['xKey'] === 'string' || typeof point['xKey'] === 'number'
+        ? point['xKey']
+        : String(point['xLabel']);
+}
+/**
+ * Important recharts styling — mirrors shadcn's ChartContainer CSS.
+ * Ensures proper text colors, grid lines, and outline handling.
+ */
+const RECHARTS_STYLES = [
+    'text-xs',
+    '[&_.recharts-cartesian-axis-tick_text]:fill-muted-foreground',
+    "[&_.recharts-cartesian-grid_line[stroke='#ccc']]:stroke-border/50",
+    '[&_.recharts-curve.recharts-tooltip-cursor]:stroke-border',
+    '[&_.recharts-layer]:outline-hidden',
+    '[&_.recharts-rectangle.recharts-tooltip-cursor]:fill-muted',
+    "[&_.recharts-reference-line_[stroke='#ccc']]:stroke-border",
+    '[&_.recharts-sector]:outline-hidden',
+    '[&_.recharts-surface]:outline-hidden',
+].join(' ');
+/**
+ * Reserve enough top padding for the tallest bar/point label plus its offset so
+ * data labels never clip against the SVG edge.
+ */
+const CARTESIAN_BASE_MARGIN = { top: 4, right: 8, left: 0, bottom: 0 };
+/**
+ * Vertical headroom required for one top-positioned cartesian data label.
+ */
+const CARTESIAN_DATA_LABEL_TOP_CLEARANCE = 28;
+/**
+ * Expand the cartesian chart margin only when top-positioned data labels are
+ * enabled.
+ */
+function getCartesianChartMargin(showDataLabels) {
+    return showDataLabels
+        ? {
+            ...CARTESIAN_BASE_MARGIN,
+            top: CARTESIAN_BASE_MARGIN.top + CARTESIAN_DATA_LABEL_TOP_CLEARANCE,
+        }
+        : CARTESIAN_BASE_MARGIN;
+}
+/**
+ * Keep the first and last rendered values from hugging the chart edges.
+ */
+const CARTESIAN_X_AXIS_PADDING = { left: 12, right: 12 };
+/**
+ * Hook that measures a container's width using ResizeObserver.
+ * Avoids the ResponsiveContainer issues with flexbox/grid layouts.
+ */
+function useContainerWidth() {
+    const ref = useRef(null);
+    const [width, setWidth] = useState(0);
+    useEffect(() => {
+        const el = ref.current;
+        if (!el)
+            return;
+        const observer = new ResizeObserver((entries) => {
+            const entry = entries[0];
+            if (entry)
+                setWidth(entry.contentRect.width);
+        });
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, []);
+    return { ref, width };
+}
+/** Renders the appropriate recharts chart based on the chart instance state. */
+export function ChartCanvas({ height = 300, className, showDataLabels = false }) {
+    const chart = useChartContext();
+    const { chartType, transformedData, series } = chart;
+    const { ref, width } = useContainerWidth();
+    const xColumn = chart.columns.find((column) => column.id === chart.xAxisId) ?? null;
+    const aggregateMetric = chart.metric.kind === 'aggregate' ? chart.metric : null;
+    const metricColumn = aggregateMetric
+        ? chart.columns.find((column) => column.id === aggregateMetric.columnId && column.type === 'number')
+        : null;
+    const valueColumn = metricColumn ?? { type: 'number', format: undefined };
+    const numericValues = transformedData.flatMap((point) => series.flatMap((seriesItem) => {
+        const value = point[seriesItem.dataKey];
+        return typeof value === 'number' ? [value] : [];
+    }));
+    const valueRange = createNumericRange(numericValues);
+    const allowDecimalTicks = shouldAllowDecimalTicks(numericValues);
+    if (transformedData.length === 0) {
+        return (_jsx("div", { ref: ref, className: `flex items-center justify-center text-sm text-muted-foreground ${className ?? ''}`, style: { height }, children: "No data available" }));
+    }
+    return (_jsx("div", { ref: ref, className: `${RECHARTS_STYLES} ${className ?? ''}`, style: { height }, children: width > 0 &&
+            (chartType === 'pie' || chartType === 'donut' ? (_jsx(PieChartRenderer, { data: transformedData, series: series, innerRadius: chartType === 'donut', width: width, height: height, valueColumn: valueColumn, valueRange: valueRange, allowDecimalTicks: allowDecimalTicks, xColumn: xColumn, timeBucket: chart.isTimeSeries ? chart.timeBucket : undefined, showDataLabels: showDataLabels })) : chartType === 'line' ? (_jsx(LineChartRenderer, { data: transformedData, series: series, width: width, height: height, valueColumn: valueColumn, valueRange: valueRange, allowDecimalTicks: allowDecimalTicks, xColumn: xColumn, timeBucket: chart.isTimeSeries ? chart.timeBucket : undefined, showDataLabels: showDataLabels })) : chartType === 'area' ? (_jsx(AreaChartRenderer, { data: transformedData, series: series, width: width, height: height, valueColumn: valueColumn, valueRange: valueRange, allowDecimalTicks: allowDecimalTicks, xColumn: xColumn, timeBucket: chart.isTimeSeries ? chart.timeBucket : undefined, showDataLabels: showDataLabels })) : (_jsx(BarChartRenderer, { data: transformedData, series: series, width: width, height: height, valueColumn: valueColumn, valueRange: valueRange, allowDecimalTicks: allowDecimalTicks, xColumn: xColumn, timeBucket: chart.isTimeSeries ? chart.timeBucket : undefined, showDataLabels: showDataLabels }))) }));
+}
+/**
+ * Shared shell for all Cartesian chart types.
+ * Owns the grid, axes, tooltip, and legend — the only things that change
+ * per chart type are the root component and the series element.
+ */
+function CartesianChartShell({ data, series, width, height, valueColumn, valueRange, allowDecimalTicks, xColumn, timeBucket, showDataLabels, Chart, renderSeries, }) {
+    const yAxisWidth = estimateYAxisWidth(valueRange, valueColumn);
+    const xAxisTickValues = selectVisibleXAxisTicks({
+        values: data.map(getXAxisTickValue),
+        labels: data.map((point) => formatXAxisValue(getXAxisTickValue(point), xColumn, timeBucket, 'axis')),
+        plotWidth: getCartesianPlotWidth(width, yAxisWidth),
+        minimumTickGap: X_AXIS_MINIMUM_TICK_GAP,
+        measureLabelWidth: measureAxisLabelWidth,
+    });
+    return (_jsxs(Chart, { data: data, width: width, height: height, margin: getCartesianChartMargin(showDataLabels), children: [_jsx(CartesianGrid, { vertical: false, strokeDasharray: "3 3" }), _jsx(XAxis, { dataKey: "xKey", tickLine: false, axisLine: false, tickMargin: 8, interval: 0, padding: CARTESIAN_X_AXIS_PADDING, ticks: xAxisTickValues, tickFormatter: (value) => formatXAxisValue(value, xColumn, timeBucket, 'axis') }), _jsx(YAxis, { tickLine: false, axisLine: false, tickMargin: 4, allowDecimals: allowDecimalTicks, width: yAxisWidth, tickFormatter: (value) => typeof value === 'number'
+                    ? formatChartValue(value, {
+                        column: valueColumn,
+                        surface: 'axis',
+                        numericRange: valueRange,
+                    })
+                    : String(value) }), _jsx(Tooltip, { formatter: (value) => typeof value === 'number'
+                    ? formatChartValue(value, {
+                        column: valueColumn,
+                        surface: 'tooltip',
+                        numericRange: valueRange,
+                    })
+                    : value, labelFormatter: (label, payload) => formatTooltipLabel(label, payload, xColumn, timeBucket) }), series.length > 1 && _jsx(Legend, {}), series.map(renderSeries)] }));
+}
+/**
+ * Resolve the most descriptive tooltip label from the transformed data point.
+ */
+function formatTooltipLabel(label, payload, xColumn, timeBucket) {
+    if (!xColumn) {
+        return String(label);
+    }
+    const point = payload?.[0]?.payload;
+    const rawXValue = typeof point?.['xKey'] === 'string' || typeof point?.['xKey'] === 'number'
+        ? point['xKey']
+        : label;
+    return formatXAxisValue(rawXValue, xColumn, timeBucket, 'tooltip');
+}
+/**
+ * Format one X-axis value using the same shared column rules as the rest of the
+ * chart while preserving the special bucket labels for inferred date buckets.
+ */
+function formatXAxisValue(value, xColumn, timeBucket, surface) {
+    if (!xColumn) {
+        return String(value);
+    }
+    if (xColumn.type === 'date' && timeBucket && typeof value === 'string' && !xColumn.formatter) {
+        return formatTimeBucketLabel(value, timeBucket, surface);
+    }
+    return formatChartValue(value, {
+        column: xColumn,
+        surface,
+        timeBucket,
+    });
+}
+function BarChartRenderer(props) {
+    const { series, showDataLabels, valueColumn, valueRange } = props;
+    return (_jsx(CartesianChartShell, { ...props, Chart: BarChart, renderSeries: (s) => (_jsx(Bar, { dataKey: s.dataKey, name: s.label, fill: s.color, radius: [4, 4, 0, 0], stackId: series.length > 1 ? 'stack' : undefined, children: showDataLabels && (_jsx(LabelList, { position: "top", offset: 8, formatter: (value) => formatDataLabel(value, valueColumn, valueRange) })) }, s.dataKey)) }));
+}
+function LineChartRenderer(props) {
+    const { showDataLabels, valueColumn, valueRange } = props;
+    return (_jsx(CartesianChartShell, { ...props, Chart: LineChart, renderSeries: (s) => (_jsx(Line, { type: "monotone", dataKey: s.dataKey, name: s.label, stroke: s.color, strokeWidth: 2, dot: { r: 3 }, activeDot: { r: 5 }, children: showDataLabels && (_jsx(LabelList, { position: "top", offset: 8, formatter: (value) => formatDataLabel(value, valueColumn, valueRange) })) }, s.dataKey)) }));
+}
+function AreaChartRenderer(props) {
+    const { series, showDataLabels, valueColumn, valueRange } = props;
+    return (_jsx(CartesianChartShell, { ...props, Chart: AreaChart, renderSeries: (s) => (_jsx(Area, { type: "monotone", dataKey: s.dataKey, name: s.label, stroke: s.color, fill: s.color, fillOpacity: 0.3, stackId: series.length > 1 ? 'stack' : undefined, children: showDataLabels && (_jsx(LabelList, { position: "top", offset: 8, formatter: (value) => formatDataLabel(value, valueColumn, valueRange) })) }, s.dataKey)) }));
+}
+function PieChartRenderer({ data, series, innerRadius, width, height, valueColumn, valueRange, xColumn, timeBucket, showDataLabels, }) {
+    const valueKey = series[0]?.dataKey;
+    const pieData = data.map((point, index) => {
+        return {
+            name: typeof point['xKey'] === 'string' || typeof point['xKey'] === 'number'
+                ? formatXAxisValue(point['xKey'], xColumn, timeBucket, 'tooltip')
+                : String(point['xLabel']),
+            value: valueKey && typeof point[valueKey] === 'number' ? point[valueKey] : 0,
+            fill: getSeriesColor(index),
+        };
+    });
+    return (_jsxs(PieChart, { width: width, height: height, children: [_jsx(Tooltip, { formatter: (value) => typeof value === 'number'
+                    ? formatChartValue(value, {
+                        column: valueColumn,
+                        surface: 'tooltip',
+                        numericRange: valueRange,
+                    })
+                    : value }), _jsx(Legend, {}), _jsx(Pie, { data: pieData, dataKey: "value", nameKey: "name", cx: "50%", cy: "50%", innerRadius: innerRadius ? '40%' : 0, outerRadius: "80%", label: showDataLabels
+                    ? ({ name, value }) => shouldHideDataLabel(value)
+                        ? ''
+                        : `${name}: ${typeof value === 'number'
+                            ? formatChartValue(value, {
+                                column: valueColumn,
+                                surface: 'data-label',
+                                numericRange: valueRange,
+                            })
+                            : value}`
+                    : false, labelLine: false })] }));
+}
+/**
+ * Format one cartesian data label with the same surface-aware rules used
+ * elsewhere in the chart UI.
+ */
+function formatDataLabel(value, valueColumn, valueRange) {
+    if (shouldHideDataLabel(value)) {
+        return '';
+    }
+    if (typeof value !== 'number') {
+        return String(value);
+    }
+    return formatChartValue(value, {
+        column: valueColumn,
+        surface: 'data-label',
+        numericRange: valueRange,
+    });
+}
+/**
+ * Suppress zero-value labels in the built-in UI so charts stay quieter by
+ * default while tooltips and raw values remain unchanged.
+ */
+function shouldHideDataLabel(value) {
+    return typeof value === 'number' && value === 0;
+}
+//# sourceMappingURL=chart-canvas.js.map

package/dist/ui/chart-canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart-canvas.js","sourceRoot":"","sources":["../../src/ui/chart-canvas.tsx"],"names":[],"mappings":"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"}

package/dist/ui/chart-context.d.ts

@@ -0,0 +1,89 @@
+/**
+ * React context for sharing the chart instance across composable UI components.
+ */
+import { type ReactElement, type ReactNode } from 'react';
+import type { ChartColumn, ChartInstance, ChartInstanceFromSchema, ChartSchema, Metric, ResolvedChartSchemaFromDefinition } from '../core/types.js';
+/**
+ * Type-erased chart instance stored in React context.
+ * This keeps the default UI primitives honest and safe for both single-source
+ * and multi-source charts.
+ */
+type ChartContextChart = Omit<ChartInstance<unknown, string>, 'columns' | 'filters'> & {
+    columns: readonly ChartColumn<any, string>[];
+    filters: Map<string, Set<string>>;
+};
+type AnyChartInstance = {
+    activeSourceId: string;
+    setActiveSource: (...args: any[]) => unknown;
+    hasMultipleSources: boolean;
+    sources: Array<{
+        id: string;
+        label: string;
+    }>;
+    chartType: ChartContextChart['chartType'];
+    setChartType: (...args: any[]) => unknown;
+    availableChartTypes: ChartContextChart['availableChartTypes'];
+    xAxisId: string | null;
+    setXAxis: (...args: any[]) => unknown;
+    availableXAxes: ChartContextChart['availableXAxes'];
+    groupById: string | null;
+    setGroupBy: (...args: any[]) => unknown;
+    availableGroupBys: ChartContextChart['availableGroupBys'];
+    metric: Metric<any>;
+    setMetric: (...args: any[]) => unknown;
+    availableMetrics: ChartContextChart['availableMetrics'];
+    timeBucket: ChartContextChart['timeBucket'];
+    setTimeBucket: (...args: any[]) => unknown;
+    availableTimeBuckets: ChartContextChart['availableTimeBuckets'];
+    isTimeSeries: boolean;
+    filters: Map<any, Set<string>>;
+    toggleFilter: (...args: any[]) => unknown;
+    clearFilter: (...args: any[]) => unknown;
+    clearAllFilters: () => void;
+    availableFilters: ChartContextChart['availableFilters'];
+    sorting: ChartContextChart['sorting'];
+    setSorting: (...args: any[]) => unknown;
+    dateRange: ChartContextChart['dateRange'];
+    referenceDateId: string | null;
+    setReferenceDateId: (...args: any[]) => unknown;
+    availableDateColumns: ChartContextChart['availableDateColumns'];
+    dateRangeFilter: ChartContextChart['dateRangeFilter'];
+    setDateRangeFilter: (...args: any[]) => unknown;
+    transformedData: ChartContextChart['transformedData'];
+    series: ChartContextChart['series'];
+    columns: readonly ChartColumn<any, string>[];
+    rawData: readonly unknown[];
+    recordCount: number;
+};
+/**
+ * Hook to access the chart instance from context.
+ * Must be used within a `<Chart>` provider.
+ *
+ * This hook stays intentionally broad so the default UI primitives remain safe
+ * for both single-source and multi-source charts.
+ */
+export declare function useChartContext(): ChartContextChart;
+/**
+ * Typed single-source chart context escape hatch for inferred charts.
+ * React cannot infer provider generics through arbitrary subtrees, so callers
+ * provide the row type (and optional schema type) explicitly.
+ */
+export declare function useTypedChartContext<T, const TSchema extends ChartSchema<T, any> | undefined = undefined>(): ChartInstanceFromSchema<T, ResolvedChartSchemaFromDefinition<TSchema>>;
+/**
+ * Root provider component. Wraps children with the chart instance context.
+ *
+ * @example
+ * ```tsx
+ * <Chart chart={chart}>
+ *   <ChartToolbar />
+ *   <ChartCanvas />
+ * </Chart>
+ * ```
+ */
+export declare function Chart({ chart, children, className, }: {
+    chart: AnyChartInstance;
+    children: ReactNode;
+    className?: string;
+}): ReactElement;
+export {};
+//# sourceMappingURL=chart-context.d.ts.map