@matthieumordrel/chart-studio 0.1.0

package/dist/core/pipeline.js

@@ -0,0 +1,157 @@
+/**
+ * Data transformation pipeline.
+ *
+ * Pure functions that transform raw data into chart-ready format.
+ * Pipeline: Raw Data -> Filter -> Bucket by X-axis -> Pivot by groupBy -> Aggregate -> Sort
+ */
+import { getSeriesColor } from './colors.js';
+import { formatChartValue } from './formatting.js';
+import { getMetricLabel } from './metric-utils.js';
+import { buildDataPoints } from './pipeline-data-points.js';
+import { getStringValue } from './pipeline-helpers.js';
+/**
+ * Apply active filters to the raw data.
+ * Filters are AND-combined across columns and OR-combined within a column.
+ *
+ * @param data - Raw data items
+ * @param columns - Column definitions used to read values
+ * @param filters - Active filter state
+ * @returns Filtered data items
+ */
+export function applyFilters(data, columns, filters) {
+    if (filters.size === 0)
+        return [...data];
+    return data.filter((item) => {
+        for (const [columnId, activeValues] of filters) {
+            if (activeValues.size === 0)
+                continue;
+            const column = columns.find((candidate) => candidate.id === columnId);
+            if (!column)
+                continue;
+            if (!activeValues.has(getStringValue(item, column))) {
+                return false;
+            }
+        }
+        return true;
+    });
+}
+/**
+ * Apply sorting to transformed data points.
+ *
+ * @param data - Aggregated chart data points
+ * @param sorting - Explicit sort configuration
+ * @param isTimeSeries - Whether the X-axis is date-based
+ * @returns Sorted chart data points
+ */
+function applySorting(data, sorting, isTimeSeries) {
+    if (isTimeSeries) {
+        return data.toSorted((a, b) => String(a['xKey']).localeCompare(String(b['xKey'])));
+    }
+    if (!sorting) {
+        return data.toSorted((a, b) => getPointTotal(b) - getPointTotal(a));
+    }
+    const direction = sorting.direction === 'asc' ? 1 : -1;
+    return data.toSorted((a, b) => {
+        const aValue = a[sorting.key] ?? 0;
+        const bValue = b[sorting.key] ?? 0;
+        if (typeof aValue === 'number' && typeof bValue === 'number') {
+            return (aValue - bValue) * direction;
+        }
+        return String(aValue).localeCompare(String(bValue)) * direction;
+    });
+}
+/**
+ * Sum all numeric series values for a transformed data point.
+ *
+ * @param point - Transformed chart data point
+ * @returns Combined numeric total across series keys
+ */
+function getPointTotal(point) {
+    return Object.entries(point)
+        .filter(([key]) => key !== 'xLabel' && key !== 'xKey')
+        .reduce((sum, [, value]) => sum + (typeof value === 'number' ? value : 0), 0);
+}
+/**
+ * Build recharts series definitions from group labels.
+ *
+ * @param groups - Group labels returned by the pivot step
+ * @param metricLabel - Human-readable label for the selected metric
+ * @param useShadcn - Whether to use shadcn-compatible color variables
+ * @returns Recharts series metadata
+ */
+function buildSeries(groups, metricLabel, useShadcn = true) {
+    return groups.map((group, index) => ({
+        dataKey: group,
+        label: group === 'value' ? metricLabel : group,
+        color: getSeriesColor(index, useShadcn),
+    }));
+}
+/**
+ * Run the full transformation pipeline.
+ *
+ * Raw Data -> Filter -> Bucket -> Pivot -> Aggregate -> Sort -> Output
+ *
+ * @param input - Pipeline configuration and source data
+ * @returns Transformed data, series metadata, and group labels
+ */
+export function runPipeline(input) {
+    const { data, columns, xAxisId, groupById, metric, timeBucket, filters, sorting } = input;
+    const xColumn = columns.find((column) => column.id === xAxisId);
+    if (!xColumn)
+        return { data: [], series: [], groups: [] };
+    const groupByColumn = groupById
+        ? (columns.find((column) => column.id === groupById) ?? null)
+        : null;
+    const numberColumns = columns.filter((column) => column.type === 'number');
+    const filtered = applyFilters(data, columns, filters);
+    const { data: points, groups } = buildDataPoints(filtered, xColumn, groupByColumn, metric, numberColumns, timeBucket);
+    return {
+        data: applySorting(points, sorting, xColumn.type === 'date'),
+        series: buildSeries(groups, getMetricLabel(metric, columns)),
+        groups,
+    };
+}
+/**
+ * Extract available filter options from data for every category and boolean
+ * column.
+ *
+ * @param data - Raw data items
+ * @param columns - Column definitions
+ * @returns Filter metadata and option counts per filterable column
+ */
+export function extractAvailableFilters(data, columns) {
+    const filterableColumns = columns.filter((column) => column.type === 'category' || column.type === 'boolean');
+    return filterableColumns.map((column) => {
+        const counts = new Map();
+        for (const item of data) {
+            const value = getStringValue(item, column);
+            const formattedLabel = formatFilterOptionLabel(item, column);
+            const existing = counts.get(value);
+            if (existing) {
+                counts.set(value, { count: existing.count + 1, label: existing.label });
+                continue;
+            }
+            counts.set(value, { count: 1, label: formattedLabel });
+        }
+        return {
+            columnId: column.id,
+            label: column.label,
+            type: column.type,
+            options: [...counts.entries()]
+                .toSorted(([, left], [, right]) => right.count - left.count)
+                .map(([value, option]) => ({ value, label: option.label, count: option.count })),
+        };
+    });
+}
+/**
+ * Derive one human-facing filter option label from the typed column value while
+ * keeping the underlying filter state keyed by the stable string value.
+ */
+function formatFilterOptionLabel(item, column) {
+    return formatChartValue(column.accessor(item), {
+        column,
+        surface: 'tooltip',
+        item,
+    });
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/core/pipeline.js.map

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