@outsidedata/dolex 0.1.0

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Comparison patterns — for comparing values across categories.
+ */
+export { barPattern } from './bar.js';
+export { divergingBarPattern } from './diverging-bar.js';
+export { slopeChartPattern } from './slope-chart.js';
+export { connectedDotPlotPattern } from './connected-dot-plot.js';
+export { bumpChartPattern } from './bump-chart.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/patterns/definitions/comparison/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Comparison patterns — for comparing values across categories.
+ */
+export { barPattern } from './bar.js';
+export { divergingBarPattern } from './diverging-bar.js';
+export { slopeChartPattern } from './slope-chart.js';
+export { connectedDotPlotPattern } from './connected-dot-plot.js';
+export { bumpChartPattern } from './bump-chart.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/patterns/definitions/comparison/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Lollipop Chart — dots on sticks for cleaner ranking.
+ *
+ * A thin line from baseline to a dot at the data value.
+ * Like a bar chart with less ink. Cleaner than bars when
+ * there are many categories (10-40) and the dot emphasis
+ * makes values easier to read than bar endpoints.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const lollipopPattern: VisualizationPattern;
+//# sourceMappingURL=lollipop.d.ts.map

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

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

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

@@ -0,0 +1,122 @@
+/**
+ * Lollipop Chart — dots on sticks for cleaner ranking.
+ *
+ * A thin line from baseline to a dot at the data value.
+ * Like a bar chart with less ink. Cleaner than bars when
+ * there are many categories (10-40) and the dot emphasis
+ * makes values easier to read than bar endpoints.
+ */
+export const lollipopPattern = {
+    id: 'lollipop',
+    name: 'Lollipop Chart',
+    category: 'comparison',
+    description: 'Dots on sticks — a thin line from baseline to a dot at the data value. Like a bar chart with less ink, cleaner for many categories.',
+    bestFor: 'Ranking and comparison with many categories (10-40). Cleaner than bars when there are many items. Dot emphasis makes values easier to read.',
+    notFor: 'Few categories (<5, just use bar), composition or part-to-whole, time series data.',
+    dataRequirements: {
+        minRows: 3,
+        maxRows: 60,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Category axis' },
+            { type: 'numeric', count: 1, description: 'Value to compare' },
+        ],
+        minCategories: 3,
+        maxCategories: 50,
+    },
+    selectionRules: [
+        {
+            condition: 'Intent explicitly mentions lollipop chart',
+            weight: 90,
+            matches: (ctx) => {
+                return /\b(lollipop)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Many-category ranking (10-40 categories) — lollipop is cleaner than bars',
+            weight: 55,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoricalColumnCount >= 1 &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    ctx.dataShape.categoryCount >= 10 &&
+                    ctx.dataShape.categoryCount <= 40 &&
+                    !ctx.dataShape.hasTimeSeries);
+            },
+        },
+        {
+            condition: 'Moderate category count with ranking intent',
+            weight: 40,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoryCount >= 8 &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    /\b(rank|top|bottom|highest|lowest|most|least|largest|smallest)\b/i.test(ctx.intent));
+            },
+        },
+        {
+            condition: 'Default comparison shape — categories with one numeric value',
+            weight: 30,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoricalColumnCount >= 1 &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    !ctx.dataShape.hasTimeSeries);
+            },
+        },
+        {
+            condition: 'Penalize for very few categories — bar chart is simpler',
+            weight: -35,
+            matches: (ctx) => {
+                return ctx.dataShape.categoryCount < 5;
+            },
+        },
+        {
+            condition: 'Penalize for time series data',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries;
+            },
+        },
+        {
+            condition: 'Penalize for two numeric columns — connected dot plot is better',
+            weight: -20,
+            matches: (ctx) => {
+                return ctx.dataShape.numericColumnCount === 2;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const categoryCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        const spec = {
+            pattern: 'lollipop',
+            title: options?.title ?? `${valueCol} by ${categoryCol}`,
+            data,
+            encoding: {
+                x: {
+                    field: categoryCol,
+                    type: 'nominal',
+                    title: categoryCol,
+                },
+                y: {
+                    field: valueCol,
+                    type: 'quantitative',
+                    title: valueCol,
+                },
+                color: {
+                    field: categoryCol,
+                    type: 'nominal',
+                    scale: {},
+                },
+            },
+            config: {
+                categoryField: categoryCol,
+                valueField: valueCol,
+                orientation: options?.orientation ?? 'horizontal',
+                dotRadius: options?.dotRadius ?? 14,
+                sorted: options?.sorted ?? true,
+                sortBy: options?.sortBy ?? 'value',
+                sortOrder: options?.sortOrder ?? 'descending',
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=lollipop.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Slope Chart — two-point comparison.
+ *
+ * Shows change between exactly two time points or conditions.
+ * Far more effective than side-by-side bars for showing direction
+ * and magnitude of change. The slope of each line tells the story.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const slopeChartPattern: VisualizationPattern;
+//# sourceMappingURL=slope-chart.d.ts.map

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

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

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

@@ -0,0 +1,99 @@
+/**
+ * Slope Chart — two-point comparison.
+ *
+ * Shows change between exactly two time points or conditions.
+ * Far more effective than side-by-side bars for showing direction
+ * and magnitude of change. The slope of each line tells the story.
+ */
+export const slopeChartPattern = {
+    id: 'slope-chart',
+    name: 'Slope Chart',
+    category: 'comparison',
+    description: 'Lines connecting two points per category, showing change between two states. The angle of each slope communicates direction and magnitude of change at a glance.',
+    bestFor: 'Before/after comparisons, two-year trends, start vs end, A/B test results, policy change impacts.',
+    notFor: 'More than 2 time points (use line chart), single time point (use bar), more than 15 categories (too cluttered).',
+    dataRequirements: {
+        minRows: 4,
+        maxRows: 60,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Category (each gets a slope line)' },
+            { type: 'numeric', count: 1, description: 'Value metric' },
+        ],
+        minCategories: 2,
+        maxCategories: 15,
+    },
+    selectionRules: [
+        {
+            condition: 'Exactly 2 time points or conditions — slope chart is the best choice',
+            weight: 80,
+            matches: (ctx) => {
+                // Look for exactly 2 unique values in a date or secondary categorical column
+                const { dateColumnCount, categoricalColumnCount } = ctx.dataShape;
+                if (dateColumnCount >= 1) {
+                    const dateCol = ctx.columns.find((c) => c.type === 'date');
+                    if (dateCol && dateCol.uniqueCount === 2)
+                        return true;
+                }
+                if (categoricalColumnCount >= 2) {
+                    // Check if any categorical column has exactly 2 values (e.g., "before"/"after")
+                    const secondaryCats = ctx.columns.filter((c) => c.type === 'categorical');
+                    if (secondaryCats.some((c) => c.uniqueCount === 2))
+                        return true;
+                }
+                return false;
+            },
+        },
+        {
+            condition: 'Intent mentions before/after, start/end, or two-point comparison',
+            weight: 60,
+            matches: (ctx) => {
+                return /\b(before|after|start|end|then|now|initial|final|first|last|two\s*(year|point|period)|vs\.?\s|versus|a\s*\/\s*b|change\s+from|compared\s+to)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Penalize for many time points — use line chart instead',
+            weight: -50,
+            matches: (ctx) => {
+                const dateCols = ctx.columns.filter((c) => c.type === 'date');
+                return dateCols.some((c) => c.uniqueCount > 3);
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const categoryCol = columns[0];
+        const valueCol = columns.length > 2 ? columns[2] : columns.length > 1 ? columns[1] : columns[0];
+        const periodCol = columns.length > 2 ? columns[1] : columns.length > 1 ? columns[0] : columns[0];
+        // Determine the two periods
+        const periods = [...new Set(data.map((d) => d[periodCol]))].slice(0, 2);
+        const spec = {
+            pattern: 'slope-chart',
+            title: options?.title ?? `${valueCol}: ${periods[0]} vs ${periods[1]}`,
+            data,
+            encoding: {
+                x: {
+                    field: periodCol,
+                    type: 'ordinal',
+                    title: periodCol,
+                },
+                y: {
+                    field: valueCol,
+                    type: 'quantitative',
+                    title: valueCol,
+                },
+                color: {
+                    field: categoryCol,
+                    type: 'nominal',
+                },
+            },
+            config: {
+                periods,
+                categoryField: categoryCol,
+                valueField: valueCol,
+                timeField: periodCol,
+                showLabels: true,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=slope-chart.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Waterfall Chart — sequential cumulative positive/negative breakdown.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const waterfallPattern: VisualizationPattern;
+//# sourceMappingURL=waterfall.d.ts.map

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

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

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

@@ -0,0 +1,85 @@
+/**
+ * Waterfall Chart — sequential cumulative positive/negative breakdown.
+ */
+export const waterfallPattern = {
+    id: 'waterfall',
+    name: 'Waterfall Chart',
+    category: 'comparison',
+    description: 'Floating bars showing how an initial value is affected by sequential positive and negative intermediate values to reach a final total.',
+    bestFor: 'Financial breakdowns (revenue → costs → profit), variance analysis (budget → actuals), bridge charts showing contributing factors.',
+    notFor: 'Non-sequential data, simple comparison across categories, time series, part-to-whole.',
+    dataRequirements: {
+        minRows: 3,
+        maxRows: 30,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Step labels' },
+            { type: 'numeric', count: 1, description: 'Values (positive and negative)' },
+        ],
+        minCategories: 3,
+        maxCategories: 20,
+    },
+    selectionRules: [
+        {
+            condition: 'Intent explicitly mentions waterfall or bridge chart',
+            weight: 90,
+            matches: (ctx) => {
+                return /\b(waterfall|bridge\s*chart)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Financial breakdown with positive and negative values',
+            weight: 55,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoricalColumnCount >= 1 &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    ctx.dataShape.hasNegativeValues === true &&
+                    /\b(breakdown|contribut|step|cumulative|running|bridge|variance|profit|loss|revenue|cost|budget|actual)\b/i.test(ctx.intent));
+            },
+        },
+        {
+            condition: 'Sequential categorical data with mixed positive/negative values',
+            weight: 40,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoricalColumnCount >= 1 &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    ctx.dataShape.hasNegativeValues === true &&
+                    !ctx.dataShape.hasTimeSeries);
+            },
+        },
+        {
+            condition: 'Penalize for time series data',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries;
+            },
+        },
+        {
+            condition: 'Penalize when no negative values — just use bar chart',
+            weight: -40,
+            matches: (ctx) => {
+                return ctx.dataShape.hasNegativeValues !== true;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const categoryCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        const spec = {
+            pattern: 'waterfall',
+            title: options?.title ?? `${valueCol} Waterfall`,
+            data,
+            encoding: {
+                x: { field: categoryCol, type: 'nominal', title: categoryCol },
+                y: { field: valueCol, type: 'quantitative', title: valueCol },
+            },
+            config: {
+                categoryField: categoryCol,
+                valueField: valueCol,
+                totalColumns: ['first', 'last'],
+                showConnectors: true,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=waterfall.js.map

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

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

package/dist/src/patterns/definitions/composition/circle-pack.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Circle Pack — hierarchical composition with nested circles.
+ *
+ * Circles where area encodes value. The circular sibling of treemap:
+ * same data shape, same color system, different geometry.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const circlePackPattern: VisualizationPattern;
+//# sourceMappingURL=circle-pack.d.ts.map

package/dist/src/patterns/definitions/composition/circle-pack.d.ts.map

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

package/dist/src/patterns/definitions/composition/circle-pack.js

@@ -0,0 +1,103 @@
+/**
+ * Circle Pack — hierarchical composition with nested circles.
+ *
+ * Circles where area encodes value. The circular sibling of treemap:
+ * same data shape, same color system, different geometry.
+ */
+export const circlePackPattern = {
+    id: 'circle-pack',
+    name: 'Circle Pack',
+    category: 'composition',
+    description: 'Nested circles where area represents value. Shows hierarchical composition with an organic, visually distinct layout. Good alternative to treemap for fewer items.',
+    bestFor: 'Hierarchical data with size values: organizational budgets, market cap by sector, product categories. Best with fewer items than treemap since circles waste more space.',
+    notFor: 'Many small items (circles waste space vs rectangles), exact value comparisons (hard to compare circle areas), time series.',
+    dataRequirements: {
+        minRows: 3,
+        maxRows: 200,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Category labels (or hierarchical groups)' },
+            { type: 'numeric', count: 1, description: 'Size value for circle area' },
+        ],
+        requiresHierarchy: false,
+    },
+    selectionRules: [
+        {
+            condition: 'Intent explicitly mentions circle pack or bubble chart',
+            weight: 90,
+            matches: (ctx) => {
+                return /\b(circle\s*pack|packed?\s*circles?|bubble\s*chart|bubble\s*map)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Hierarchical data with composition intent — circle pack as alternative to treemap',
+            weight: 45,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasHierarchy &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    ctx.dataShape.categoricalColumnCount >= 2);
+            },
+        },
+        {
+            condition: 'Many categories (10+) with composition intent — circle pack handles moderate scale',
+            weight: 35,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoryCount >= 10 &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    /\b(compos|proportion|share|breakdown|makeup|size|biggest|largest)\b/i.test(ctx.intent));
+            },
+        },
+        {
+            condition: 'Penalize for very few categories — waffle or bar is clearer',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.categoryCount < 4 && !ctx.dataShape.hasHierarchy;
+            },
+        },
+        {
+            condition: 'Penalize for too many items — treemap handles scale better',
+            weight: -20,
+            matches: (ctx) => {
+                return ctx.dataShape.categoryCount > 100;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const categoryCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        const parentCol = columns.length > 2 ? columns[0] : undefined;
+        const childCol = columns.length > 2 ? columns[1] : undefined;
+        const sizeCol = columns.length > 2 ? columns[2] : valueCol;
+        const spec = {
+            pattern: 'circle-pack',
+            title: options?.title ?? `${valueCol} composition${parentCol ? ` (${parentCol} > ${childCol})` : ''}`,
+            data,
+            encoding: {
+                size: {
+                    field: sizeCol,
+                    type: 'quantitative',
+                    title: sizeCol,
+                },
+                color: {
+                    field: parentCol ?? categoryCol,
+                    type: 'nominal',
+                    title: parentCol ?? categoryCol,
+                },
+                label: {
+                    field: childCol ?? categoryCol,
+                    type: 'nominal',
+                },
+            },
+            config: {
+                categoryField: categoryCol,
+                valueField: sizeCol,
+                parentField: parentCol ?? null,
+                childField: childCol ?? null,
+                showLabels: options?.showLabels ?? true,
+                showValues: options?.showValues ?? true,
+                padding: options?.padding ?? 3,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=circle-pack.js.map

package/dist/src/patterns/definitions/composition/circle-pack.js.map

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

package/dist/src/patterns/definitions/composition/donut.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Donut Chart — circular part-to-whole with hollow center.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const donutPattern: VisualizationPattern;
+//# sourceMappingURL=donut.d.ts.map

package/dist/src/patterns/definitions/composition/donut.d.ts.map

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

package/dist/src/patterns/definitions/composition/donut.js

@@ -0,0 +1,101 @@
+/**
+ * Donut Chart — circular part-to-whole with hollow center.
+ */
+export const donutPattern = {
+    id: 'donut',
+    name: 'Donut Chart',
+    category: 'composition',
+    description: 'Circular part-to-whole chart with a hollow center showing category proportions as arc segments. The classic pie/donut.',
+    bestFor: 'Simple part-to-whole with 2-6 categories. Budget breakdown, market share, survey responses, vote share, portfolio allocation.',
+    notFor: 'More than 8 categories (slices become unreadable). Small differences between slices (hard to compare angles). Showing change over time. Precise value comparison.',
+    dataRequirements: {
+        minRows: 2,
+        maxRows: 8,
+        requiredColumns: [
+            { type: 'categorical', count: 1, description: 'Category labels (slices)' },
+            { type: 'numeric', count: 1, description: 'Value per category (determines arc angle)' },
+        ],
+        minCategories: 2,
+        maxCategories: 8,
+    },
+    selectionRules: [
+        {
+            condition: 'Intent explicitly mentions pie, donut, or circular chart',
+            weight: 85,
+            matches: (ctx) => {
+                return /\b(pie\s*chart|donut\s*chart|pie|donut|circular)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Part-to-whole with few categories',
+            weight: 55,
+            matches: (ctx) => {
+                return (ctx.dataShape.categoryCount >= 2 &&
+                    ctx.dataShape.categoryCount <= 6 &&
+                    ctx.dataShape.numericColumnCount >= 1);
+            },
+        },
+        {
+            condition: 'Intent mentions percentage, proportion, or share',
+            weight: 45,
+            matches: (ctx) => {
+                return /\b(percent|proportion|share|part.of|makeup|how\s+much\s+of|breakdown)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Very few categories (2-4) — donut is clean and simple',
+            weight: 25,
+            matches: (ctx) => {
+                return ctx.dataShape.categoryCount >= 2 && ctx.dataShape.categoryCount <= 4;
+            },
+        },
+        {
+            condition: 'Penalize for too many categories — slices become unreadable',
+            weight: -50,
+            matches: (ctx) => {
+                return ctx.dataShape.categoryCount > 8;
+            },
+        },
+        {
+            condition: 'Penalize when data has time dimension — stacked area or line is better',
+            weight: -25,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries;
+            },
+        },
+        {
+            condition: 'Penalize for hierarchical data — treemap or sunburst is better',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.hasHierarchy;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const categoryCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        const spec = {
+            pattern: 'donut',
+            title: options?.title ?? `${valueCol} breakdown`,
+            data,
+            encoding: {
+                color: {
+                    field: categoryCol,
+                    type: 'nominal',
+                    title: categoryCol,
+                },
+            },
+            config: {
+                categoryField: categoryCol,
+                valueField: valueCol,
+                startAngle: options?.startAngle ?? 0,
+                innerRadius: options?.innerRadius ?? 0.55,
+                showLabels: options?.showLabels ?? true,
+                showPercentages: options?.showPercentages ?? true,
+                centerLabel: options?.centerLabel ?? '',
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=donut.js.map