@outsidedata/dolex 0.1.0

package/dist/src/patterns/definitions/comparison/bullet.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Bullet Chart — compact horizontal bar with target marker and qualitative range bands.
+ *
+ * The bullet chart replaces dashboard gauges and meters with a compact,
+ * information-dense display. Shows a primary measure (actual) against a
+ * comparative measure (target) with qualitative ranges providing context
+ * (poor / satisfactory / good).
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const bulletPattern: VisualizationPattern;
+//# sourceMappingURL=bullet.d.ts.map

package/dist/src/patterns/definitions/comparison/bullet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullet.d.ts","sourceRoot":"","sources":["../../../../../src/patterns/definitions/comparison/bullet.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,mBAAmB,CAAC;AAEjF,eAAO,MAAM,aAAa,EAAE,oBA4H3B,CAAC"}

package/dist/src/patterns/definitions/comparison/bullet.js

@@ -0,0 +1,121 @@
+/**
+ * Bullet Chart — compact horizontal bar with target marker and qualitative range bands.
+ *
+ * The bullet chart replaces dashboard gauges and meters with a compact,
+ * information-dense display. Shows a primary measure (actual) against a
+ * comparative measure (target) with qualitative ranges providing context
+ * (poor / satisfactory / good).
+ */
+export const bulletPattern = {
+    id: 'bullet',
+    name: 'Bullet Chart',
+    category: 'comparison',
+    description: 'Compact horizontal bar showing a primary measure against a target with qualitative range bands (poor/satisfactory/good). Stephen Few\'s replacement for gauges and meters.',
+    bestFor: 'Dashboard KPI tracking with context: actual vs target vs qualitative assessment. Revenue vs quota, CPU usage vs threshold, NPS score vs benchmark.',
+    notFor: 'Many categories without targets (use bar chart), composition or part-to-whole (use stacked bar or donut), time series (use line or sparkline).',
+    dataRequirements: {
+        minRows: 1,
+        maxRows: 12,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Metric name (label for each bullet)' },
+            { type: 'numeric', count: 2, description: 'Actual value and target value (plus optional range thresholds)' },
+        ],
+        minCategories: 1,
+        maxCategories: 12,
+    },
+    selectionRules: [
+        {
+            condition: 'Intent explicitly mentions bullet chart',
+            weight: 90,
+            matches: (ctx) => {
+                return /\b(bullet\s*chart|bullet)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Intent mentions actual vs target, KPI tracking, or performance against benchmark',
+            weight: 70,
+            matches: (ctx) => {
+                return /\b(vs\.?\s*target|versus\s*target|actual\s*vs|against\s*(target|benchmark|quota|threshold|goal)|kpi\s*(track|dashboard|monitor)|performance\s*(vs|against|to)\s*(target|benchmark|quota))\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Data has target-like columns — suggests actual vs target comparison',
+            weight: 55,
+            matches: (ctx) => {
+                const colNames = ctx.columns.map((c) => c.name.toLowerCase());
+                const hasActual = colNames.some((n) => /\b(actual|current|value|score|result)\b/.test(n));
+                const hasTarget = colNames.some((n) => /\b(target|goal|benchmark|quota|threshold|budget)\b/.test(n));
+                return hasActual && hasTarget;
+            },
+        },
+        {
+            condition: 'Few metrics with multiple numeric columns — good bullet chart candidate',
+            weight: 40,
+            matches: (ctx) => {
+                return (ctx.dataShape.rowCount >= 1 &&
+                    ctx.dataShape.rowCount <= 8 &&
+                    ctx.dataShape.numericColumnCount >= 2 &&
+                    ctx.dataShape.categoricalColumnCount >= 1);
+            },
+        },
+        {
+            condition: 'Penalize for time series data — use line or sparkline instead',
+            weight: -40,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries;
+            },
+        },
+        {
+            condition: 'Penalize for too many rows — bullet charts are for few KPIs',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.rowCount > 12;
+            },
+        },
+        {
+            condition: 'Penalize when only one numeric column — need at least actual and target',
+            weight: -50,
+            matches: (ctx) => {
+                return ctx.dataShape.numericColumnCount < 2;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const categoryCol = columns[0];
+        const numericCols = columns.filter((col) => {
+            const sample = data[0]?.[col];
+            return sample !== undefined && !isNaN(Number(sample));
+        });
+        const actualCol = options?.actualField ?? numericCols[0] ?? columns[1];
+        const targetCol = options?.targetField ?? numericCols[1] ?? columns[2];
+        const rangeFields = options?.rangeFields ?? numericCols.slice(2);
+        const spec = {
+            pattern: 'bullet',
+            title: options?.title ?? 'Performance vs Target',
+            data,
+            encoding: {
+                x: {
+                    field: actualCol,
+                    type: 'quantitative',
+                    title: actualCol,
+                },
+                color: {
+                    field: categoryCol,
+                    type: 'nominal',
+                },
+            },
+            config: {
+                metricField: categoryCol,
+                actualField: actualCol,
+                targetField: targetCol,
+                rangeFields: rangeFields.length > 0 ? rangeFields : undefined,
+                sortBy: options?.sortBy ?? 'value',
+                sortOrder: options?.sortOrder ?? 'descending',
+                rangeLabels: options?.rangeLabels,
+                showLabels: options?.showLabels ?? true,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=bullet.js.map

package/dist/src/patterns/definitions/comparison/bullet.js.map

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

package/dist/src/patterns/definitions/comparison/bump-chart.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Bump Chart — rank changes over time.
+ *
+ * Shows how the relative positions of entities change across
+ * ordered categories (usually time). Unlike line charts that show
+ * absolute values, bump charts show relative ranking, making it
+ * easy to spot who rose and who fell.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const bumpChartPattern: VisualizationPattern;
+//# sourceMappingURL=bump-chart.d.ts.map

package/dist/src/patterns/definitions/comparison/bump-chart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bump-chart.d.ts","sourceRoot":"","sources":["../../../../../src/patterns/definitions/comparison/bump-chart.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,mBAAmB,CAAC;AAEjF,eAAO,MAAM,gBAAgB,EAAE,oBAmI9B,CAAC"}

package/dist/src/patterns/definitions/comparison/bump-chart.js

@@ -0,0 +1,124 @@
+/**
+ * Bump Chart — rank changes over time.
+ *
+ * Shows how the relative positions of entities change across
+ * ordered categories (usually time). Unlike line charts that show
+ * absolute values, bump charts show relative ranking, making it
+ * easy to spot who rose and who fell.
+ */
+export const bumpChartPattern = {
+    id: 'bump-chart',
+    name: 'Bump Chart',
+    category: 'comparison',
+    description: 'Tracks rank positions of entities over time or ordered categories. Lines connect rankings, and crossings show when one entity overtakes another.',
+    bestFor: 'Ranking changes: team standings over seasons, product market share rank, country GDP ranking over decades, leaderboard progression.',
+    notFor: 'Absolute values (use line chart), single time point (use bar), too many entities (>12 gets unreadable), non-ordinal x-axis.',
+    dataRequirements: {
+        minRows: 6,
+        maxRows: 200,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Entity being ranked (team, country, etc.)' },
+            { type: 'numeric', count: 1, description: 'Value used to compute rankings' },
+        ],
+        minCategories: 3,
+        maxCategories: 12,
+        requiresTimeSeries: true,
+    },
+    selectionRules: [
+        {
+            condition: 'Intent explicitly mentions rank, ranking, position, or standings',
+            weight: 90,
+            matches: (ctx) => {
+                return /\b(rank|ranking|position|standing|leaderboard|leader|place|moved up|moved down|overtake|overtook)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Time series data with multiple categories (series) — potential for bump chart',
+            weight: 40,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.seriesCount >= 3 &&
+                    ctx.dataShape.seriesCount <= 12 &&
+                    ctx.dataShape.numericColumnCount >= 1);
+            },
+        },
+        {
+            condition: 'Moderate number of entities and time points — sweet spot for bump charts',
+            weight: 20,
+            matches: (ctx) => {
+                const dateCols = ctx.columns.filter((c) => c.type === 'date');
+                const timePoints = dateCols.length > 0 ? dateCols[0].uniqueCount : 0;
+                return (ctx.dataShape.seriesCount >= 3 &&
+                    ctx.dataShape.seriesCount <= 12 &&
+                    timePoints >= 3 &&
+                    timePoints <= 20);
+            },
+        },
+        {
+            condition: 'Penalize when no time dimension exists',
+            weight: -50,
+            matches: (ctx) => {
+                return !ctx.dataShape.hasTimeSeries && ctx.dataShape.dateColumnCount === 0;
+            },
+        },
+        {
+            condition: 'Penalize for too many entities — becomes unreadable',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.seriesCount > 12;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const entityCol = columns[0];
+        const timeCol = columns.length > 1 ? columns[1] : columns[0];
+        const valueCol = columns.length > 2 ? columns[2] : columns.length > 1 ? columns[1] : columns[0];
+        // Compute rankings from raw values
+        const timeValues = [...new Set(data.map((d) => d[timeCol]))];
+        const rankedData = [];
+        for (const time of timeValues) {
+            const rowsAtTime = data
+                .filter((d) => d[timeCol] === time)
+                .sort((a, b) => Number(b[valueCol]) - Number(a[valueCol]));
+            rowsAtTime.forEach((row, idx) => {
+                rankedData.push({
+                    ...row,
+                    _rank: idx + 1,
+                    _timePeriod: time,
+                });
+            });
+        }
+        const spec = {
+            pattern: 'bump-chart',
+            title: options?.title ?? `Ranking of ${entityCol} over ${timeCol}`,
+            data: rankedData,
+            encoding: {
+                x: {
+                    field: timeCol,
+                    type: 'ordinal',
+                    title: timeCol,
+                },
+                y: {
+                    field: '_rank',
+                    type: 'quantitative',
+                    title: 'Rank',
+                    sort: 'ascending',
+                },
+                color: {
+                    field: entityCol,
+                    type: 'nominal',
+                },
+            },
+            config: {
+                categoryField: entityCol,
+                timeField: timeCol,
+                valueField: valueCol,
+                showLabels: true,
+                strokeWidth: options?.strokeWidth ?? 3,
+                dotRadius: options?.dotRadius ?? 5,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=bump-chart.js.map

package/dist/src/patterns/definitions/comparison/bump-chart.js.map

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

package/dist/src/patterns/definitions/comparison/connected-dot-plot.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Connected Dot Plot — two metrics per category.
+ *
+ * Also called a "dumbbell chart" or "Cleveland dot plot".
+ * Shows two values per category connected by a line, making
+ * the gap between them the primary visual. Far clearer than
+ * grouped bars for comparing two measures.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const connectedDotPlotPattern: VisualizationPattern;
+//# sourceMappingURL=connected-dot-plot.d.ts.map

package/dist/src/patterns/definitions/comparison/connected-dot-plot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected-dot-plot.d.ts","sourceRoot":"","sources":["../../../../../src/patterns/definitions/comparison/connected-dot-plot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,mBAAmB,CAAC;AAEjF,eAAO,MAAM,uBAAuB,EAAE,oBAqGrC,CAAC"}

package/dist/src/patterns/definitions/comparison/connected-dot-plot.js

@@ -0,0 +1,99 @@
+/**
+ * Connected Dot Plot — two metrics per category.
+ *
+ * Also called a "dumbbell chart" or "Cleveland dot plot".
+ * Shows two values per category connected by a line, making
+ * the gap between them the primary visual. Far clearer than
+ * grouped bars for comparing two measures.
+ */
+export const connectedDotPlotPattern = {
+    id: 'connected-dot-plot',
+    name: 'Connected Dot Plot',
+    category: 'comparison',
+    description: 'Two dots per category connected by a line. The length of the connecting line encodes the gap between two values, making differences immediately visible.',
+    bestFor: 'Comparing two metrics per category: budget vs actual, male vs female, 2020 vs 2024, target vs achieved.',
+    notFor: 'Single metric (use bar), more than 2 metrics (use parallel coordinates or radar), time series with many points (use line).',
+    dataRequirements: {
+        minRows: 3,
+        maxRows: 30,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Category labels' },
+            { type: 'numeric', count: 2, description: 'Two values to compare per category' },
+        ],
+        minCategories: 3,
+        maxCategories: 20,
+    },
+    selectionRules: [
+        {
+            condition: 'Exactly 2 numeric columns — connected dot plot is superior to grouped bar',
+            weight: 70,
+            matches: (ctx) => {
+                return (ctx.dataShape.numericColumnCount === 2 &&
+                    ctx.dataShape.categoricalColumnCount >= 1 &&
+                    ctx.dataShape.categoryCount >= 3 &&
+                    ctx.dataShape.categoryCount <= 20);
+            },
+        },
+        {
+            condition: 'Intent mentions comparing two things per category',
+            weight: 50,
+            matches: (ctx) => {
+                return /\b(budget\s*vs|actual\s*vs|male\s*(and|vs)|female\s*(and|vs)|gap|both|two\s+metric|dual|paired|dumbbell)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Intent mentions range or span between values',
+            weight: 40,
+            matches: (ctx) => {
+                return /\b(range|span|min.+max|low.+high|start.+end)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Penalize for single metric',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.numericColumnCount < 2;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const categoryCol = columns[0];
+        const metric1Col = columns.length > 1 ? columns[1] : columns[0];
+        const metric2Col = columns.length > 2 ? columns[2] : metric1Col;
+        const spec = {
+            pattern: 'connected-dot-plot',
+            title: options?.title ?? `${metric1Col} vs ${metric2Col} by ${categoryCol}`,
+            data,
+            encoding: {
+                y: {
+                    field: categoryCol,
+                    type: 'nominal',
+                    title: categoryCol,
+                    sort: null,
+                },
+                x: {
+                    field: metric1Col,
+                    type: 'quantitative',
+                    title: `${metric1Col} / ${metric2Col}`,
+                },
+                color: {
+                    scale: {
+                        domain: [metric1Col, metric2Col],
+                        range: options?.colors ?? ['#4e79a7', '#e15759'],
+                    },
+                },
+            },
+            config: {
+                metric1Field: metric1Col,
+                metric2Field: metric2Col,
+                categoryField: categoryCol,
+                showLabels: options?.showLabels ?? true,
+                showDifference: options?.showDifference ?? true,
+                sortBy: options?.sortBy ?? 'gap',
+                sortOrder: options?.sortOrder ?? 'descending',
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=connected-dot-plot.js.map

package/dist/src/patterns/definitions/comparison/connected-dot-plot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected-dot-plot.js","sourceRoot":"","sources":["../../../../../src/patterns/definitions/comparison/connected-dot-plot.ts"],"names":[],"mappings":"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"}

package/dist/src/patterns/definitions/comparison/diverging-bar.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Diverging Bar Chart — differences from a baseline or zero.
+ *
+ * Excels when values span positive and negative, or when comparing
+ * deviations from an average/target. The visual encoding of direction
+ * (left vs right, or up vs down) makes differences instantly readable.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const divergingBarPattern: VisualizationPattern;
+//# sourceMappingURL=diverging-bar.d.ts.map

package/dist/src/patterns/definitions/comparison/diverging-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diverging-bar.d.ts","sourceRoot":"","sources":["../../../../../src/patterns/definitions/comparison/diverging-bar.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,mBAAmB,CAAC;AAEjF,eAAO,MAAM,mBAAmB,EAAE,oBAmGjC,CAAC"}

package/dist/src/patterns/definitions/comparison/diverging-bar.js

@@ -0,0 +1,97 @@
+/**
+ * Diverging Bar Chart — differences from a baseline or zero.
+ *
+ * Excels when values span positive and negative, or when comparing
+ * deviations from an average/target. The visual encoding of direction
+ * (left vs right, or up vs down) makes differences instantly readable.
+ */
+export const divergingBarPattern = {
+    id: 'diverging-bar',
+    name: 'Diverging Bar Chart',
+    category: 'comparison',
+    description: 'Horizontal bars extending left and right from a central baseline. Shows positive and negative deviations clearly.',
+    bestFor: 'Data with positive and negative values, profit/loss, above/below average, sentiment scores, change from baseline.',
+    notFor: 'All-positive data without a meaningful midpoint. Use standard bar instead.',
+    dataRequirements: {
+        minRows: 3,
+        maxRows: 40,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Category labels' },
+            { type: 'numeric', count: 1, description: 'Value with positive and negative range' },
+        ],
+        minCategories: 3,
+    },
+    selectionRules: [
+        {
+            condition: 'Data contains negative values — diverging bar is ideal',
+            weight: 70,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasNegativeValues &&
+                    ctx.dataShape.categoricalColumnCount >= 1 &&
+                    ctx.dataShape.numericColumnCount >= 1);
+            },
+        },
+        {
+            condition: 'Intent mentions difference, change, deviation, or baseline',
+            weight: 50,
+            matches: (ctx) => {
+                return /\b(differ|change|deviat|baseline|target|above|below|gain|loss|profit|deficit|surplus|sentiment|positive|negative)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Value range spans zero with meaningful spread on both sides',
+            weight: 30,
+            matches: (ctx) => {
+                const { min, max } = ctx.dataShape.valueRange;
+                return min < 0 && max > 0 && Math.abs(min) > max * 0.2 && Math.abs(max) > Math.abs(min) * 0.2;
+            },
+        },
+        {
+            condition: 'Penalize when no negative values exist',
+            weight: -40,
+            matches: (ctx) => {
+                return !ctx.dataShape.hasNegativeValues;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const categoryCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        const spec = {
+            pattern: 'diverging-bar',
+            title: options?.title ?? `${valueCol} deviation by ${categoryCol}`,
+            data,
+            encoding: {
+                x: {
+                    field: valueCol,
+                    type: 'quantitative',
+                    title: valueCol,
+                },
+                y: {
+                    field: categoryCol,
+                    type: 'nominal',
+                    title: categoryCol,
+                    sort: null,
+                },
+                color: {
+                    field: valueCol,
+                    type: 'quantitative',
+                    scale: {
+                        domain: [
+                            Math.min(...data.map((d) => Number(d[valueCol]) || 0)),
+                            0,
+                            Math.max(...data.map((d) => Number(d[valueCol]) || 0)),
+                        ],
+                        range: ['#d73027', '#f7f7f7', '#1a9850'],
+                    },
+                },
+            },
+            config: {
+                orientation: 'horizontal',
+                showLabels: true,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=diverging-bar.js.map

package/dist/src/patterns/definitions/comparison/diverging-bar.js.map

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

package/dist/src/patterns/definitions/comparison/grouped-bar.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Grouped Bar — side-by-side bars for multi-metric comparison.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const groupedBarPattern: VisualizationPattern;
+//# sourceMappingURL=grouped-bar.d.ts.map

package/dist/src/patterns/definitions/comparison/grouped-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grouped-bar.d.ts","sourceRoot":"","sources":["../../../../../src/patterns/definitions/comparison/grouped-bar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,mBAAmB,CAAC;AAEjF,eAAO,MAAM,iBAAiB,EAAE,oBAgH/B,CAAC"}

package/dist/src/patterns/definitions/comparison/grouped-bar.js

@@ -0,0 +1,103 @@
+/**
+ * Grouped Bar — side-by-side bars for multi-metric comparison.
+ */
+export const groupedBarPattern = {
+    id: 'grouped-bar',
+    name: 'Grouped Bar Chart',
+    category: 'comparison',
+    description: 'Side-by-side bars for comparing multiple metrics or series across categories. Nested groups with color-coded series.',
+    bestFor: 'Direct comparison of 2-4 metrics per category: revenue vs cost by department, male vs female enrollment by year, Q1 vs Q2 sales by product.',
+    notFor: 'Single metric (use bar), part-to-whole (use stacked-bar), >5 series (too many bars per group), time series (use line).',
+    dataRequirements: {
+        minRows: 4,
+        maxRows: 100,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Group category' },
+            { type: 'numeric', count: 1, description: 'Value to compare' },
+        ],
+        minCategories: 2,
+        maxCategories: 20,
+    },
+    selectionRules: [
+        {
+            condition: 'Intent explicitly mentions grouped bar or side-by-side bar',
+            weight: 90,
+            matches: (ctx) => {
+                return /\b(grouped?\s*bar|side[\s-]*by[\s-]*side\s*bar|clustered?\s*bar)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Two categorical columns + one numeric — classic grouped bar shape',
+            weight: 55,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoricalColumnCount >= 2 &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    !ctx.dataShape.hasTimeSeries);
+            },
+        },
+        {
+            condition: 'Multiple numeric columns with categories — compare metrics side by side',
+            weight: 50,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoricalColumnCount >= 1 &&
+                    ctx.dataShape.numericColumnCount >= 2 &&
+                    ctx.dataShape.numericColumnCount <= 5 &&
+                    !ctx.dataShape.hasTimeSeries);
+            },
+        },
+        {
+            condition: 'Intent mentions comparing multiple metrics',
+            weight: 25,
+            matches: (ctx) => {
+                return /\b(compar\w+\s+(multiple|several|different)\s+(metric|measure|value|series)|side[\s-]*by[\s-]*side|grouped)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Penalize for single numeric column with single categorical — regular bar is simpler',
+            weight: -30,
+            matches: (ctx) => {
+                return (ctx.dataShape.numericColumnCount === 1 &&
+                    ctx.dataShape.categoricalColumnCount === 1);
+            },
+        },
+        {
+            condition: 'Penalize for too many series (>5)',
+            weight: -25,
+            matches: (ctx) => {
+                return ctx.dataShape.numericColumnCount > 5;
+            },
+        },
+        {
+            condition: 'Penalize for time series data',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const categoryCol = columns[0];
+        const seriesCol = columns.length > 2 ? columns[1] : undefined;
+        const valueCol = columns.length > 2 ? columns[2] : columns.length > 1 ? columns[1] : columns[0];
+        const spec = {
+            pattern: 'grouped-bar',
+            title: options?.title ?? `Comparison by ${categoryCol}`,
+            data,
+            encoding: {
+                x: { field: categoryCol, type: 'nominal', title: categoryCol },
+                y: { field: valueCol, type: 'quantitative', title: valueCol },
+                color: seriesCol
+                    ? { field: seriesCol, type: 'nominal', scale: {} }
+                    : { field: categoryCol, type: 'nominal', scale: {} },
+            },
+            config: {
+                categoryField: categoryCol,
+                seriesField: seriesCol,
+                valueField: valueCol,
+                orientation: options?.orientation ?? 'vertical',
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=grouped-bar.js.map