@matthieumordrel/chart-studio 0.1.0

package/dist/core/metric-utils.js

@@ -0,0 +1,142 @@
+/**
+ * Default metric used when no numeric aggregation is selected.
+ */
+export const DEFAULT_METRIC = { kind: 'count' };
+/**
+ * Type guard for aggregate metrics.
+ */
+export function isAggregateMetric(metric) {
+    return metric.kind === 'aggregate';
+}
+/**
+ * Compare two metric definitions for semantic equality.
+ */
+export function isSameMetric(left, right) {
+    if (left.kind !== right.kind) {
+        return false;
+    }
+    if (left.kind === 'count') {
+        return true;
+    }
+    return (right.kind === 'aggregate'
+        && left.columnId === right.columnId
+        && left.aggregate === right.aggregate
+        && (left.includeZeros ?? true) === (right.includeZeros ?? true));
+}
+/**
+ * Human-readable label for a numeric aggregate.
+ */
+export function getAggregateMetricLabel(columnLabel, aggregate) {
+    switch (aggregate) {
+        case 'sum':
+            return `Sum of ${columnLabel}`;
+        case 'avg':
+            return `Avg ${columnLabel}`;
+        case 'min':
+            return `Min ${columnLabel}`;
+        case 'max':
+            return `Max ${columnLabel}`;
+    }
+}
+/**
+ * Human-readable label for a metric.
+ */
+export function getMetricLabel(metric, columns) {
+    if (!isAggregateMetric(metric)) {
+        return 'Count';
+    }
+    const column = columns.find((candidate) => candidate.type === 'number' && candidate.id === metric.columnId);
+    if (!column) {
+        return 'Count';
+    }
+    return getAggregateMetricLabel(column.label, metric.aggregate);
+}
+/**
+ * Build the metric options available for a set of columns.
+ */
+export function buildAvailableMetrics(columns) {
+    const metrics = [DEFAULT_METRIC];
+    const numberColumns = columns.filter((column) => column.type === 'number');
+    for (const column of numberColumns) {
+        metrics.push({ kind: 'aggregate', columnId: column.id, aggregate: 'sum' }, { kind: 'aggregate', columnId: column.id, aggregate: 'avg' }, { kind: 'aggregate', columnId: column.id, aggregate: 'min' }, { kind: 'aggregate', columnId: column.id, aggregate: 'max' });
+    }
+    return metrics;
+}
+/**
+ * Expand declarative metric restriction entries into the normalized metric list
+ * used by the runtime and typed chart state.
+ */
+export function normalizeMetricAllowances(allowedMetrics) {
+    if (!allowedMetrics) {
+        return undefined;
+    }
+    const normalized = [];
+    for (const allowedMetric of allowedMetrics) {
+        if (allowedMetric.kind === 'count') {
+            normalized.push(allowedMetric);
+            continue;
+        }
+        const aggregates = Array.isArray(allowedMetric.aggregate)
+            ? allowedMetric.aggregate
+            : [allowedMetric.aggregate];
+        for (const aggregate of aggregates) {
+            normalized.push({
+                kind: 'aggregate',
+                columnId: allowedMetric.columnId,
+                aggregate,
+                includeZeros: allowedMetric.includeZeros,
+            });
+        }
+    }
+    return normalized;
+}
+/**
+ * Apply a declarative metric whitelist to the inferred metric options.
+ *
+ * Metrics are matched structurally so callers can safely pass fresh object
+ * literals in `config.metric.allowed`. The final order follows the declarative
+ * restriction list, so the first allowed metric becomes the default.
+ */
+export function restrictAvailableMetrics(metrics, config) {
+    const normalizedAllowedMetrics = normalizeMetricAllowances(config?.allowed);
+    if (!normalizedAllowedMetrics) {
+        const hiddenMetrics = config?.hidden;
+        if (!hiddenMetrics || hiddenMetrics.length === 0) {
+            return [...metrics];
+        }
+        const visibleMetrics = metrics.filter(metric => hiddenMetrics.every(hiddenMetric => !isSameMetric(metric, hiddenMetric)));
+        return visibleMetrics.length > 0 ? visibleMetrics : [metrics[0] ?? DEFAULT_METRIC];
+    }
+    const allowedMetrics = normalizedAllowedMetrics.filter(allowedMetric => metrics.some(metric => isSameMetric(metric, allowedMetric)));
+    const hiddenMetrics = config?.hidden;
+    const restricted = !hiddenMetrics || hiddenMetrics.length === 0
+        ? allowedMetrics
+        : allowedMetrics.filter(metric => hiddenMetrics.every(hiddenMetric => !isSameMetric(metric, hiddenMetric)));
+    // A chart always needs one active metric. Fall back to the inferred default if
+    // the whitelist ends up empty or does not match the active source.
+    return restricted.length > 0 ? restricted : [metrics[0] ?? DEFAULT_METRIC];
+}
+/**
+ * Validate a metric against the active source.
+ */
+export function resolveMetric(metric, columns, availableMetrics, configuredDefaultMetric) {
+    if (availableMetrics && availableMetrics.length > 0) {
+        const selectedMetric = availableMetrics.find(candidate => isSameMetric(candidate, metric));
+        if (selectedMetric) {
+            return selectedMetric;
+        }
+        const defaultMetric = configuredDefaultMetric
+            ? availableMetrics.find(candidate => isSameMetric(candidate, configuredDefaultMetric))
+            : undefined;
+        return defaultMetric ?? availableMetrics[0];
+    }
+    if (!isAggregateMetric(metric)) {
+        return DEFAULT_METRIC;
+    }
+    const column = columns.find((candidate) => candidate.type === 'number' && candidate.id === metric.columnId);
+    if (!column) {
+        return DEFAULT_METRIC;
+    }
+    return metric;
+}
+//# sourceMappingURL=metric-utils.js.map

package/dist/core/metric-utils.js.map

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

package/dist/core/pipeline-data-points.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Bucket and aggregation steps for the chart transformation pipeline.
+ */
+import type { ChartColumn, Metric, NumberColumn, TimeBucket, TransformedDataPoint } from './types.js';
+type DataPointResult = {
+    data: TransformedDataPoint[];
+    groups: string[];
+};
+/**
+ * Build chart-ready data points by bucketing the X-axis, pivoting groups, and
+ * aggregating the selected metric.
+ *
+ * @param items - Filtered source data
+ * @param xColumn - Active X-axis column
+ * @param groupByColumn - Optional group-by column
+ * @param metric - Selected metric configuration
+ * @param numberColumns - Number columns available for metric lookup
+ * @param timeBucket - Time bucket used for date X-axes
+ * @returns Aggregated chart data points and group labels
+ */
+export declare function buildDataPoints<T, TColumnId extends string>(items: T[], xColumn: ChartColumn<T, TColumnId>, groupByColumn: ChartColumn<T, TColumnId> | null, metric: Metric<TColumnId>, numberColumns: NumberColumn<T, TColumnId>[], timeBucket: TimeBucket): DataPointResult;
+export {};
+//# sourceMappingURL=pipeline-data-points.d.ts.map

package/dist/core/pipeline-data-points.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-data-points.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-data-points.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EACV,WAAW,EAEX,MAAM,EACN,YAAY,EACZ,UAAU,EACV,oBAAoB,EACrB,MAAM,YAAY,CAAA;AAOnB,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,oBAAoB,EAAE,CAAA;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,SAAS,SAAS,MAAM,EACzD,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,EAClC,aAAa,EAAE,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,IAAI,EAC/C,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,EACzB,aAAa,EAAE,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAC3C,UAAU,EAAE,UAAU,GACrB,eAAe,CAkBjB"}

package/dist/core/pipeline-data-points.js

@@ -0,0 +1,236 @@
+/**
+ * Bucket and aggregation steps for the chart transformation pipeline.
+ */
+import { isAggregateMetric } from './metric-utils.js';
+import { aggregate, dateBucketKey, dateBucketLabel, getStringValue } from './pipeline-helpers.js';
+/**
+ * Build chart-ready data points by bucketing the X-axis, pivoting groups, and
+ * aggregating the selected metric.
+ *
+ * @param items - Filtered source data
+ * @param xColumn - Active X-axis column
+ * @param groupByColumn - Optional group-by column
+ * @param metric - Selected metric configuration
+ * @param numberColumns - Number columns available for metric lookup
+ * @param timeBucket - Time bucket used for date X-axes
+ * @returns Aggregated chart data points and group labels
+ */
+export function buildDataPoints(items, xColumn, groupByColumn, metric, numberColumns, timeBucket) {
+    const groupSet = new Set();
+    if (groupByColumn) {
+        for (const item of items) {
+            groupSet.add(getStringValue(item, groupByColumn));
+        }
+    }
+    const groups = groupByColumn ? [...groupSet].toSorted() : ['value'];
+    const metricColumn = isAggregateMetric(metric)
+        ? (numberColumns.find((column) => column.id === metric.columnId) ?? null)
+        : null;
+    if (xColumn.type === 'date') {
+        return buildTimeBuckets(items, xColumn, groupByColumn, groups, metric, metricColumn, timeBucket);
+    }
+    return buildCategoryBuckets(items, xColumn, groupByColumn, groups, metric, metricColumn);
+}
+/**
+ * Generate a continuous sequence of date buckets from the minimum to maximum
+ * date found in the data.
+ *
+ * @param items - Filtered source data
+ * @param xColumn - Active date column
+ * @param bucket - Time bucket granularity
+ * @returns Every bucket between the first and last date in the dataset
+ */
+function generateBucketsFromData(items, xColumn, bucket) {
+    let min = null;
+    let max = null;
+    for (const item of items) {
+        const rawValue = xColumn.accessor(item);
+        if (rawValue == null)
+            continue;
+        const date = new Date(rawValue);
+        if (Number.isNaN(date.getTime()))
+            continue;
+        if (!min || date < min)
+            min = date;
+        if (!max || date > max)
+            max = date;
+    }
+    if (!min || !max)
+        return [];
+    const buckets = [];
+    const cursor = startOfBucket(min, bucket);
+    const seenKeys = new Set();
+    const maxBuckets = 500;
+    for (let bucketCount = 0; bucketCount < maxBuckets; bucketCount += 1) {
+        if (cursor > max)
+            break;
+        const key = dateBucketKey(cursor, bucket);
+        if (!seenKeys.has(key)) {
+            seenKeys.add(key);
+            buckets.push({ key, label: dateBucketLabel(key, bucket) });
+        }
+        advanceBucketCursor(cursor, bucket);
+    }
+    return buckets;
+}
+/**
+ * Normalize a date to the start of its containing bucket.
+ *
+ * @param date - Source date
+ * @param bucket - Time bucket granularity
+ * @returns Start boundary for the bucket containing the source date
+ */
+function startOfBucket(date, bucket) {
+    const normalized = new Date(date);
+    normalized.setHours(0, 0, 0, 0);
+    switch (bucket) {
+        case 'day':
+            return normalized;
+        case 'week': {
+            const day = normalized.getDay();
+            normalized.setDate(normalized.getDate() - ((day + 6) % 7));
+            return normalized;
+        }
+        case 'month':
+            normalized.setDate(1);
+            return normalized;
+        case 'quarter':
+            normalized.setMonth(Math.floor(normalized.getMonth() / 3) * 3, 1);
+            return normalized;
+        case 'year':
+            normalized.setMonth(0, 1);
+            return normalized;
+    }
+}
+/**
+ * Advance a mutable cursor by a single bucket interval.
+ *
+ * @param cursor - Current date cursor
+ * @param bucket - Time bucket granularity
+ */
+function advanceBucketCursor(cursor, bucket) {
+    switch (bucket) {
+        case 'day':
+            cursor.setDate(cursor.getDate() + 1);
+            break;
+        case 'week':
+            cursor.setDate(cursor.getDate() + 7);
+            break;
+        case 'month':
+            cursor.setMonth(cursor.getMonth() + 1);
+            break;
+        case 'quarter':
+            cursor.setMonth(cursor.getMonth() + 3);
+            break;
+        case 'year':
+            cursor.setFullYear(cursor.getFullYear() + 1);
+            break;
+    }
+}
+/**
+ * Build data points for a date X-axis.
+ *
+ * @param items - Filtered source data
+ * @param xColumn - Active date column
+ * @param groupByColumn - Optional group-by column
+ * @param groups - Resolved group labels
+ * @param metric - Selected metric configuration
+ * @param metricColumn - Resolved numeric metric column
+ * @param timeBucket - Time bucket granularity
+ * @returns Aggregated date-bucketed data points
+ */
+function buildTimeBuckets(items, xColumn, groupByColumn, groups, metric, metricColumn, timeBucket) {
+    const allBuckets = generateBucketsFromData(items, xColumn, timeBucket);
+    const accumulator = new Map();
+    for (const { key } of allBuckets) {
+        const groupMap = new Map();
+        for (const group of groups) {
+            groupMap.set(group, []);
+        }
+        accumulator.set(key, groupMap);
+    }
+    for (const item of items) {
+        const rawValue = xColumn.accessor(item);
+        if (rawValue == null)
+            continue;
+        const date = new Date(rawValue);
+        const key = dateBucketKey(date, timeBucket);
+        const groupMap = accumulator.get(key);
+        if (!groupMap)
+            continue;
+        const group = groupByColumn ? getStringValue(item, groupByColumn) : 'value';
+        const values = groupMap.get(group);
+        if (!values)
+            continue;
+        if (metricColumn) {
+            const metricValue = metricColumn.accessor(item);
+            if (metricValue != null)
+                values.push(metricValue);
+        }
+        else {
+            values.push(1);
+        }
+    }
+    const data = allBuckets.map(({ key, label }) => {
+        const point = { xLabel: label, xKey: key };
+        const groupMap = accumulator.get(key);
+        for (const group of groups) {
+            point[group] = aggregate(groupMap.get(group) ?? [], metric.kind === 'aggregate' ? metric.aggregate : 'count', metric.kind === 'aggregate' ? (metric.includeZeros ?? true) : true);
+        }
+        return point;
+    });
+    return { data, groups };
+}
+/**
+ * Build data points for a categorical or boolean X-axis.
+ *
+ * @param items - Filtered source data
+ * @param xColumn - Active X-axis column
+ * @param groupByColumn - Optional group-by column
+ * @param groups - Resolved group labels
+ * @param metric - Selected metric configuration
+ * @param metricColumn - Resolved numeric metric column
+ * @returns Aggregated category-bucketed data points
+ */
+function buildCategoryBuckets(items, xColumn, groupByColumn, groups, metric, metricColumn) {
+    const xValues = new Set();
+    for (const item of items) {
+        xValues.add(getStringValue(item, xColumn));
+    }
+    const accumulator = new Map();
+    for (const xValue of xValues) {
+        const groupMap = new Map();
+        for (const group of groups) {
+            groupMap.set(group, []);
+        }
+        accumulator.set(xValue, groupMap);
+    }
+    for (const item of items) {
+        const xValue = getStringValue(item, xColumn);
+        const groupMap = accumulator.get(xValue);
+        if (!groupMap)
+            continue;
+        const group = groupByColumn ? getStringValue(item, groupByColumn) : 'value';
+        const values = groupMap.get(group);
+        if (!values)
+            continue;
+        if (metricColumn) {
+            const metricValue = metricColumn.accessor(item);
+            if (metricValue != null)
+                values.push(metricValue);
+        }
+        else {
+            values.push(1);
+        }
+    }
+    const data = [...xValues].map((xValue) => {
+        const point = { xLabel: xValue, xKey: xValue };
+        const groupMap = accumulator.get(xValue);
+        for (const group of groups) {
+            point[group] = aggregate(groupMap.get(group) ?? [], metric.kind === 'aggregate' ? metric.aggregate : 'count', metric.kind === 'aggregate' ? (metric.includeZeros ?? true) : true);
+        }
+        return point;
+    });
+    return { data, groups };
+}
+//# sourceMappingURL=pipeline-data-points.js.map

package/dist/core/pipeline-data-points.js.map

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

package/dist/core/pipeline-helpers.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shared helpers for the chart transformation pipeline.
+ */
+import type { AggregateFunction, ChartColumn, TimeBucket } from './types.js';
+/**
+ * Format a stable key for a date bucket.
+ *
+ * @param date - Source date
+ * @param bucket - Time bucket granularity
+ * @returns Machine-friendly bucket key
+ */
+export declare function dateBucketKey(date: Date, bucket: TimeBucket): string;
+/**
+ * Format a bucket key into a human-readable label.
+ *
+ * @param key - Bucket key
+ * @param bucket - Time bucket granularity
+ * @returns Display label for the chart axis
+ */
+export declare function dateBucketLabel(key: string, bucket: TimeBucket): string;
+/**
+ * Extract a comparable string value from an item using a column definition.
+ *
+ * @param item - Raw data item
+ * @param column - Column definition to read from
+ * @returns String value used by filters and groups
+ */
+export declare function getStringValue<T>(item: T, column: ChartColumn<T>): string;
+/**
+ * Aggregate numeric values using the requested function.
+ *
+ * @param values - Numeric values to aggregate
+ * @param fn - Aggregation strategy
+ * @param includeZeros - Whether zero values should participate in avg/min/max
+ * @returns Aggregated numeric result
+ */
+export declare function aggregate(values: number[], fn: AggregateFunction, includeZeros?: boolean): number;
+//# sourceMappingURL=pipeline-helpers.d.ts.map

package/dist/core/pipeline-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-helpers.d.ts","sourceRoot":"","sources":["../../src/core/pipeline-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAC,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAC,MAAM,YAAY,CAAA;AAE1E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAoBpE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAEvE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,CAqBzE;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,YAAY,UAAO,GAAG,MAAM,CAkB9F"}

package/dist/core/pipeline-helpers.js

@@ -0,0 +1,98 @@
+/**
+ * Shared helpers for the chart transformation pipeline.
+ */
+import { formatTimeBucketLabel } from './formatting.js';
+/**
+ * Format a stable key for a date bucket.
+ *
+ * @param date - Source date
+ * @param bucket - Time bucket granularity
+ * @returns Machine-friendly bucket key
+ */
+export function dateBucketKey(date, bucket) {
+    const year = date.getFullYear();
+    const month = date.getMonth();
+    switch (bucket) {
+        case 'day':
+            return `${year}-${String(month + 1).padStart(2, '0')}-${String(date.getDate()).padStart(2, '0')}`;
+        case 'week': {
+            const day = date.getDay();
+            const monday = new Date(date);
+            monday.setDate(date.getDate() - ((day + 6) % 7));
+            return `${monday.getFullYear()}-${String(monday.getMonth() + 1).padStart(2, '0')}-${String(monday.getDate()).padStart(2, '0')}`;
+        }
+        case 'month':
+            return `${year}-${String(month + 1).padStart(2, '0')}`;
+        case 'quarter':
+            return `${year}-Q${Math.floor(month / 3) + 1}`;
+        case 'year':
+            return `${year}`;
+    }
+}
+/**
+ * Format a bucket key into a human-readable label.
+ *
+ * @param key - Bucket key
+ * @param bucket - Time bucket granularity
+ * @returns Display label for the chart axis
+ */
+export function dateBucketLabel(key, bucket) {
+    return formatTimeBucketLabel(key, bucket, 'axis');
+}
+/**
+ * Extract a comparable string value from an item using a column definition.
+ *
+ * @param item - Raw data item
+ * @param column - Column definition to read from
+ * @returns String value used by filters and groups
+ */
+export function getStringValue(item, column) {
+    switch (column.type) {
+        case 'boolean': {
+            const value = column.accessor(item);
+            if (value === true)
+                return column.trueLabel;
+            if (value === false)
+                return column.falseLabel;
+            return 'Unknown';
+        }
+        case 'category': {
+            const value = column.accessor(item);
+            return value ?? 'Unknown';
+        }
+        case 'date': {
+            const value = column.accessor(item);
+            return value != null ? String(value) : 'Unknown';
+        }
+        case 'number': {
+            const value = column.accessor(item);
+            return value != null ? String(value) : 'Unknown';
+        }
+    }
+}
+/**
+ * Aggregate numeric values using the requested function.
+ *
+ * @param values - Numeric values to aggregate
+ * @param fn - Aggregation strategy
+ * @param includeZeros - Whether zero values should participate in avg/min/max
+ * @returns Aggregated numeric result
+ */
+export function aggregate(values, fn, includeZeros = true) {
+    if (fn === 'count')
+        return values.length;
+    const effectiveValues = !includeZeros && fn !== 'sum' ? values.filter((value) => value !== 0) : values;
+    if (effectiveValues.length === 0)
+        return 0;
+    switch (fn) {
+        case 'sum':
+            return effectiveValues.reduce((sum, value) => sum + value, 0);
+        case 'avg':
+            return effectiveValues.reduce((sum, value) => sum + value, 0) / effectiveValues.length;
+        case 'min':
+            return Math.min(...effectiveValues);
+        case 'max':
+            return Math.max(...effectiveValues);
+    }
+}
+//# sourceMappingURL=pipeline-helpers.js.map

package/dist/core/pipeline-helpers.js.map

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

package/dist/core/pipeline.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 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 type { AvailableFilter, ChartColumn, ChartSeries, FilterState, Metric, SortConfig, TimeBucket, TransformedDataPoint } from './types.js';
+/**
+ * Input for the transformation pipeline.
+ *
+ * @property data - Raw data items
+ * @property columns - Column definitions
+ * @property xAxisId - Active X-axis column ID
+ * @property groupById - Active groupBy column ID (null = no grouping)
+ * @property metric - What the Y-axis measures
+ * @property timeBucket - Time bucket size for date X-axes
+ * @property filters - Active filter state
+ * @property sorting - Sort configuration
+ */
+export type PipelineInput<T, TColumnId extends string = string> = {
+    data: readonly T[];
+    columns: readonly ChartColumn<T, TColumnId>[];
+    xAxisId: TColumnId;
+    groupById: TColumnId | null;
+    metric: Metric<TColumnId>;
+    timeBucket: TimeBucket;
+    filters: FilterState<TColumnId>;
+    sorting: SortConfig | null;
+};
+/**
+ * Output of the transformation pipeline.
+ *
+ * @property data - Transformed data points ready for recharts
+ * @property series - Series definitions for rendering
+ * @property groups - Unique group labels
+ */
+export type PipelineOutput = {
+    data: TransformedDataPoint[];
+    series: ChartSeries[];
+    groups: string[];
+};
+/**
+ * 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 declare function applyFilters<T, TColumnId extends string>(data: readonly T[], columns: readonly ChartColumn<T, TColumnId>[], filters: FilterState<TColumnId>): T[];
+/**
+ * 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 declare function runPipeline<T, TColumnId extends string>(input: PipelineInput<T, TColumnId>): PipelineOutput;
+/**
+ * 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 declare function extractAvailableFilters<T, TColumnId extends string>(data: readonly T[], columns: readonly ChartColumn<T, TColumnId>[]): AvailableFilter<TColumnId>[];
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/core/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/core/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EACV,eAAe,EAGf,WAAW,EACX,WAAW,EACX,WAAW,EACX,MAAM,EAEN,UAAU,EACV,UAAU,EACV,oBAAoB,EACrB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,EAAE,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI;IAChE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAA;IAClB,OAAO,EAAE,SAAS,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAA;IAC7C,OAAO,EAAE,SAAS,CAAA;IAClB,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,CAAA;IAC/B,OAAO,EAAE,UAAU,GAAG,IAAI,CAAA;CAC3B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,oBAAoB,EAAE,CAAA;IAC5B,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,SAAS,MAAM,EACtD,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,OAAO,EAAE,SAAS,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAC7C,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,GAC9B,CAAC,EAAE,CAiBL;AAgED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,SAAS,MAAM,EACrD,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,SAAS,CAAC,GACjC,cAAc,CA2BhB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,SAAS,SAAS,MAAM,EACjE,IAAI,EAAE,SAAS,CAAC,EAAE,EAClB,OAAO,EAAE,SAAS,WAAW,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,GAC5C,eAAe,CAAC,SAAS,CAAC,EAAE,CA+B9B"}