@outsidedata/dolex 0.1.0

package/dist/src/patterns/definitions/relationship/radar.js

@@ -0,0 +1,125 @@
+/**
+ * Radar Chart (Spider Chart) — multivariate profile.
+ *
+ * A radial chart where each axis extends from the center,
+ * one per variable. The resulting polygon shows the "shape"
+ * of an entity's profile. Best for comparing 1-3 entities
+ * across 5-10 dimensions.
+ */
+export const radarPattern = {
+    id: 'radar',
+    name: 'Radar Chart',
+    category: 'relationship',
+    description: 'Radial axes extending from a center point, one per variable. Each entity forms a polygon. The shape reveals strengths, weaknesses, and overall profile.',
+    bestFor: 'Comparing 1-3 entity profiles across 5-10 dimensions: player stat comparison, product feature comparison, skill assessment, balanced scorecard.',
+    notFor: 'Many entities over 4 (polygons overlap), many dimensions over 12 (too dense), precise value comparison (radial distorts area).',
+    dataRequirements: {
+        minRows: 1,
+        maxRows: 12,
+        requiredColumns: [
+            { type: 'numeric', count: 3, description: 'Three or more metrics forming the profile' },
+        ],
+    },
+    selectionRules: [
+        {
+            condition: 'Few entities (1-3) with many metrics — radar shows the full profile shape',
+            weight: 75,
+            matches: (ctx) => {
+                return (ctx.dataShape.numericColumnCount >= 4 &&
+                    ctx.dataShape.numericColumnCount <= 12 &&
+                    ctx.dataShape.rowCount >= 1 &&
+                    ctx.dataShape.rowCount <= 4);
+            },
+        },
+        {
+            condition: 'Intent mentions profile, strengths/weaknesses, or radar',
+            weight: 60,
+            matches: (ctx) => {
+                return /\b(profile|strength|weakness|radar|spider|skill|balanced|assessment|scorecard|attribute|stat|characteristic)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Comparing exactly 2 entities across multiple metrics — radar overlay is powerful',
+            weight: 50,
+            matches: (ctx) => {
+                return (ctx.dataShape.rowCount === 2 &&
+                    ctx.dataShape.numericColumnCount >= 4);
+            },
+        },
+        {
+            condition: 'Penalize for many entities — polygons become unreadable',
+            weight: -40,
+            matches: (ctx) => {
+                return ctx.dataShape.rowCount > 4;
+            },
+        },
+        {
+            condition: 'Penalize for few dimensions — scatter or bar is clearer',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.numericColumnCount < 4;
+            },
+        },
+        {
+            condition: 'Penalize for many dimensions — too dense to read',
+            weight: -25,
+            matches: (ctx) => {
+                return ctx.dataShape.numericColumnCount > 12;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const entityCol = columns.find((_col, i) => {
+            // First column is often the entity label
+            return i === 0 && data.length > 1;
+        }) ?? columns[0];
+        // All other columns are metric dimensions
+        const metricCols = columns.filter((col) => col !== entityCol);
+        // Normalize values to 0-1 range for each metric
+        const normalizedData = data.map((row) => {
+            const normalized = { ...row };
+            for (const col of metricCols) {
+                const values = data.map((d) => Number(d[col]) || 0);
+                const min = Math.min(...values);
+                const max = Math.max(...values);
+                const range = max - min || 1;
+                normalized[`_norm_${col}`] = ((Number(row[col]) || 0) - min) / range;
+            }
+            return normalized;
+        });
+        const spec = {
+            pattern: 'radar',
+            title: options?.title ?? `Profile comparison`,
+            data: normalizedData,
+            encoding: {
+                angle: {
+                    field: '_dimension',
+                    type: 'nominal',
+                },
+                radius: {
+                    field: '_value',
+                    type: 'quantitative',
+                },
+                color: data.length > 1
+                    ? {
+                        field: entityCol,
+                        type: 'nominal',
+                        title: entityCol,
+                    }
+                    : undefined,
+            },
+            config: {
+                categoryField: entityCol,
+                dimensions: metricCols,
+                showLabels: options?.showLabels ?? true,
+                showGrid: options?.showGrid ?? true,
+                gridLevels: options?.gridLevels ?? 5,
+                fillOpacity: options?.fillOpacity ?? 0.2,
+                strokeWidth: options?.strokeWidth ?? 2,
+                dotRadius: options?.dotRadius ?? 4,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=radar.js.map

package/dist/src/patterns/definitions/relationship/radar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radar.js","sourceRoot":"","sources":["../../../../../src/patterns/definitions/relationship/radar.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,YAAY,GAAyB;IAChD,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,cAAc;IACxB,WAAW,EACT,yJAAyJ;IAC3J,OAAO,EACL,iJAAiJ;IACnJ,MAAM,EACJ,gIAAgI;IAElI,gBAAgB,EAAE;QAChB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,EAAE;QACX,eAAe,EAAE;YACf,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE;SACxF;KACF;IAED,cAAc,EAAE;QACd;YACE,SAAS,EAAE,2EAA2E;YACtF,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,OAAO,CACL,GAAG,CAAC,SAAS,CAAC,kBAAkB,IAAI,CAAC;oBACrC,GAAG,CAAC,SAAS,CAAC,kBAAkB,IAAI,EAAE;oBACtC,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,CAAC;oBAC3B,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,CAAC,CAC5B,CAAC;YACJ,CAAC;SACF;QACD;YACE,SAAS,EAAE,yDAAyD;YACpE,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,OAAO,iHAAiH,CAAC,IAAI,CAC3H,GAAG,CAAC,MAAM,CACX,CAAC;YACJ,CAAC;SACF;QACD;YACE,SAAS,EAAE,kFAAkF;YAC7F,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,OAAO,CACL,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,CAAC;oBAC5B,GAAG,CAAC,SAAS,CAAC,kBAAkB,IAAI,CAAC,CACtC,CAAC;YACJ,CAAC;SACF;QACD;YACE,SAAS,EAAE,yDAAyD;YACpE,MAAM,EAAE,CAAC,EAAE;YACX,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,OAAO,GAAG,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC;YACpC,CAAC;SACF;QACD;YACE,SAAS,EAAE,yDAAyD;YACpE,MAAM,EAAE,CAAC,EAAE;YACX,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,OAAO,GAAG,CAAC,SAAS,CAAC,kBAAkB,GAAG,CAAC,CAAC;YAC9C,CAAC;SACF;QACD;YACE,SAAS,EAAE,kDAAkD;YAC7D,MAAM,EAAE,CAAC,EAAE;YACX,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,OAAO,GAAG,CAAC,SAAS,CAAC,kBAAkB,GAAG,EAAE,CAAC;YAC/C,CAAC;SACF;KACF;IAED,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QACvC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACzC,yCAAyC;YACzC,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACpC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;QAEjB,0CAA0C;QAC1C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;QAE9D,gDAAgD;QAChD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACtC,MAAM,UAAU,GAAwB,EAAE,GAAG,GAAG,EAAE,CAAC;YACnD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACpD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;gBAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;gBAChC,MAAM,KAAK,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;gBAC7B,UAAU,CAAC,SAAS,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC;YACvE,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAsB;YAC9B,OAAO,EAAE,OAAO;YAChB,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,oBAAoB;YAC7C,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE;gBACR,KAAK,EAAE;oBACL,KAAK,EAAE,YAAY;oBACnB,IAAI,EAAE,SAAS;iBAChB;gBACD,MAAM,EAAE;oBACN,KAAK,EAAE,QAAQ;oBACf,IAAI,EAAE,cAAc;iBACrB;gBACD,KAAK,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC;oBACpB,CAAC,CAAC;wBACE,KAAK,EAAE,SAAS;wBAChB,IAAI,EAAE,SAAS;wBACf,KAAK,EAAE,SAAS;qBACjB;oBACH,CAAC,CAAC,SAAS;aACd;YACD,MAAM,EAAE;gBACN,aAAa,EAAE,SAAS;gBACxB,UAAU,EAAE,UAAU;gBACtB,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI;gBACvC,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,IAAI;gBACnC,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,CAAC;gBACpC,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,GAAG;gBACxC,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,CAAC;gBACtC,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;aACnC;SACF,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/src/patterns/definitions/relationship/scatter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Scatter Plot — two variables.
+ *
+ * The standard for showing the relationship between two numeric
+ * variables. Position encodes both values, revealing correlations,
+ * clusters, and outliers.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const scatterPattern: VisualizationPattern;
+//# sourceMappingURL=scatter.d.ts.map

package/dist/src/patterns/definitions/relationship/scatter.d.ts.map

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

package/dist/src/patterns/definitions/relationship/scatter.js

@@ -0,0 +1,122 @@
+/**
+ * Scatter Plot — two variables.
+ *
+ * The standard for showing the relationship between two numeric
+ * variables. Position encodes both values, revealing correlations,
+ * clusters, and outliers.
+ */
+export const scatterPattern = {
+    id: 'scatter',
+    name: 'Scatter Plot',
+    category: 'relationship',
+    description: 'Each point represents one observation, positioned by two numeric variables. Reveals correlations, clusters, outliers, and the shape of relationships.',
+    bestFor: 'Exploring the relationship between two numeric variables: height vs weight, price vs quantity, score vs study hours.',
+    notFor: 'Categorical data (use bar), time series (use line unless comparing two metrics), single variable (use histogram).',
+    dataRequirements: {
+        minRows: 10,
+        requiredColumns: [
+            { type: 'numeric', count: 2, description: 'Two variables to compare' },
+        ],
+    },
+    selectionRules: [
+        {
+            condition: 'Two numeric columns — scatter is the natural choice for relationships',
+            weight: 60,
+            matches: (ctx) => {
+                return (ctx.dataShape.numericColumnCount >= 2 &&
+                    !ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.categoricalColumnCount <= 1);
+            },
+        },
+        {
+            condition: 'Intent mentions correlation, relationship, or scatter',
+            weight: 50,
+            matches: (ctx) => {
+                return /\b(correlat|relationship|scatter|association|regress|predict|x\s+vs\s+y|versus)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Enough data points for a meaningful scatter (10+)',
+            weight: 20,
+            matches: (ctx) => {
+                return ctx.dataShape.rowCount >= 10 && ctx.dataShape.numericColumnCount >= 2;
+            },
+        },
+        {
+            condition: 'Optional categorical column for color grouping',
+            weight: 15,
+            matches: (ctx) => {
+                return (ctx.dataShape.numericColumnCount >= 2 &&
+                    ctx.dataShape.categoricalColumnCount === 1 &&
+                    ctx.dataShape.categoryCount <= 10);
+            },
+        },
+        {
+            condition: 'Penalize for time series — use line or connected scatter',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries;
+            },
+        },
+        {
+            condition: 'Penalize for single numeric column',
+            weight: -40,
+            matches: (ctx) => {
+                return ctx.dataShape.numericColumnCount < 2;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const xCol = columns[0];
+        const yCol = columns.length > 1 ? columns[1] : columns[0];
+        const colorCol = columns.length > 2 ? columns[2] : undefined;
+        const sizeCol = options?.sizeField
+            ? columns.find(c => c === options.sizeField)
+            : undefined;
+        const spec = {
+            pattern: 'scatter',
+            title: options?.title ?? `${yCol} vs ${xCol}`,
+            data,
+            encoding: {
+                x: {
+                    field: xCol,
+                    type: 'quantitative',
+                    title: xCol,
+                },
+                y: {
+                    field: yCol,
+                    type: 'quantitative',
+                    title: yCol,
+                },
+                color: colorCol
+                    ? {
+                        field: colorCol,
+                        type: 'nominal',
+                        title: colorCol,
+                    }
+                    : undefined,
+                size: sizeCol
+                    ? {
+                        field: sizeCol,
+                        type: 'quantitative',
+                        title: sizeCol,
+                        range: options?.sizeRange ?? [3, 20],
+                    }
+                    : undefined,
+            },
+            config: {
+                xField: xCol,
+                yField: yCol,
+                colorField: colorCol ?? null,
+                sizeField: sizeCol ?? null,
+                dotRadius: options?.dotRadius ?? 5,
+                opacity: options?.opacity ?? 0.7,
+                showTrendLine: options?.showTrendLine ?? false,
+                showRegressionLine: options?.showRegressionLine ?? false,
+                jitter: options?.jitter ?? 0,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=scatter.js.map

package/dist/src/patterns/definitions/relationship/scatter.js.map

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

package/dist/src/patterns/definitions/time/area.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Area Chart — volume over time with optional stacking.
+ *
+ * Like a line chart but with the area below filled, emphasizing
+ * magnitude. Stacked variant shows composition changing over time.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const areaPattern: VisualizationPattern;
+//# sourceMappingURL=area.d.ts.map

package/dist/src/patterns/definitions/time/area.d.ts.map

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

package/dist/src/patterns/definitions/time/area.js

@@ -0,0 +1,97 @@
+/**
+ * Area Chart — volume over time with optional stacking.
+ *
+ * Like a line chart but with the area below filled, emphasizing
+ * magnitude. Stacked variant shows composition changing over time.
+ */
+export const areaPattern = {
+    id: 'area',
+    name: 'Area Chart',
+    category: 'time',
+    description: 'Filled area chart emphasizing volume and magnitude over time. Supports single-series, multi-series overlapping, stacked, and normalized (100%) stacked modes. Multiple interpolation curves: monotone (smooth), linear, step (staircase), curve (smooth rounded), cardinal, catmullRom. Configurable fill opacity.',
+    bestFor: 'Showing volume/magnitude over time. Revenue over time, website traffic, cumulative totals. Stacked: market share over time, revenue by product line. Step curve for discrete intervals (e.g. monthly billing). Normalized for proportion tracking.',
+    notFor: 'Comparing exact values across many series (overlapping areas obscure), non-temporal data, precise comparisons (use bar).',
+    dataRequirements: {
+        minRows: 3,
+        requiredColumns: [
+            { type: 'date', count: 1, description: 'Time axis' },
+            { type: 'numeric', count: 1, description: 'Value over time' },
+        ],
+        requiresTimeSeries: true,
+    },
+    selectionRules: [
+        {
+            condition: 'Time series with intent for volume, area, magnitude, or cumulative',
+            weight: 55,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    /\b(area|volume|magnitude|cumulative|total|fill|stacked\s*area|revenue|traffic|visitors)\b/i.test(ctx.intent));
+            },
+        },
+        {
+            condition: 'Stacked composition over time with explicit stacked intent',
+            weight: 60,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.seriesCount >= 2 &&
+                    ctx.dataShape.seriesCount <= 8 &&
+                    /\b(stacked|composition\s+over\s+time|share\s+over\s+time|breakdown\s+over\s+time|proportion)\b/i.test(ctx.intent));
+            },
+        },
+        {
+            condition: 'Penalize when no time dimension exists',
+            weight: -50,
+            matches: (ctx) => {
+                return !ctx.dataShape.hasTimeSeries && ctx.dataShape.dateColumnCount === 0;
+            },
+        },
+        {
+            condition: 'Penalize for too many series — visual clutter',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.seriesCount > 8;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const timeCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        const seriesCol = columns.length > 2 ? columns[2] : undefined;
+        const spec = {
+            pattern: 'area',
+            title: options?.title ?? `${valueCol} over ${timeCol}`,
+            data,
+            encoding: {
+                x: {
+                    field: timeCol,
+                    type: 'temporal',
+                    title: timeCol,
+                },
+                y: {
+                    field: valueCol,
+                    type: 'quantitative',
+                    title: valueCol,
+                },
+                color: seriesCol
+                    ? {
+                        field: seriesCol,
+                        type: 'nominal',
+                        title: seriesCol,
+                    }
+                    : undefined,
+            },
+            config: {
+                timeField: timeCol,
+                valueField: valueCol,
+                seriesField: seriesCol ?? null,
+                stacked: options?.stacked ?? false,
+                normalized: options?.normalized ?? false,
+                curve: options?.curve ?? 'monotone',
+                opacity: options?.opacity ?? 0.7,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=area.js.map

package/dist/src/patterns/definitions/time/area.js.map

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

package/dist/src/patterns/definitions/time/calendar-heatmap.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Calendar Heatmap — daily patterns.
+ *
+ * Shows values mapped onto a calendar grid, revealing day-of-week
+ * patterns, seasonal effects, and daily variations. Made famous
+ * by GitHub's contribution graph.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const calendarHeatmapPattern: VisualizationPattern;
+//# sourceMappingURL=calendar-heatmap.d.ts.map

package/dist/src/patterns/definitions/time/calendar-heatmap.d.ts.map

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

package/dist/src/patterns/definitions/time/calendar-heatmap.js

@@ -0,0 +1,109 @@
+/**
+ * Calendar Heatmap — daily patterns.
+ *
+ * Shows values mapped onto a calendar grid, revealing day-of-week
+ * patterns, seasonal effects, and daily variations. Made famous
+ * by GitHub's contribution graph.
+ */
+export const calendarHeatmapPattern = {
+    id: 'calendar-heatmap',
+    name: 'Calendar Heatmap',
+    category: 'time',
+    description: 'Values mapped onto a calendar grid (weeks as columns, days as rows). Color intensity encodes magnitude. Reveals day-of-week effects, seasonal patterns, and anomalous days.',
+    bestFor: 'Daily data over months or years: website traffic, sales, commits, exercise, temperature. Finding day-of-week and seasonal patterns.',
+    notFor: 'Non-daily data (weekly, monthly — use line), very short time spans (use bar), non-temporal data.',
+    dataRequirements: {
+        minRows: 30,
+        requiredColumns: [
+            { type: 'date', count: 1, description: 'Daily date' },
+            { type: 'numeric', count: 1, description: 'Value for each day' },
+        ],
+        requiresTimeSeries: true,
+    },
+    selectionRules: [
+        {
+            condition: 'Daily data spanning at least a month — calendar heatmap is ideal',
+            weight: 80,
+            matches: (ctx) => {
+                if (!ctx.dataShape.hasTimeSeries || ctx.dataShape.dateColumnCount === 0)
+                    return false;
+                const dateCol = ctx.columns.find((c) => c.type === 'date');
+                // Need enough unique dates to represent daily data
+                return dateCol !== undefined && dateCol.uniqueCount >= 28;
+            },
+        },
+        {
+            condition: 'Intent mentions daily patterns, calendar, or day-of-week',
+            weight: 60,
+            matches: (ctx) => {
+                return /\b(daily|calendar|day.of.week|weekday|weekend|heatmap|every\s+day|github|activity|contribution)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Large number of time points — calendar is more compact than line for daily data',
+            weight: 30,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries && ctx.dataShape.rowCount >= 90;
+            },
+        },
+        {
+            condition: 'Penalize for non-daily granularity (few time points suggests monthly/yearly)',
+            weight: -40,
+            matches: (ctx) => {
+                const dateCol = ctx.columns.find((c) => c.type === 'date');
+                return dateCol !== undefined && dateCol.uniqueCount < 20;
+            },
+        },
+        {
+            condition: 'Penalize for no time dimension',
+            weight: -50,
+            matches: (ctx) => {
+                return !ctx.dataShape.hasTimeSeries;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const dateCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        // Compute value range for color scale
+        const values = data.map((d) => Number(d[valueCol])).filter((v) => !isNaN(v));
+        const minVal = Math.min(...values);
+        const maxVal = Math.max(...values);
+        const spec = {
+            pattern: 'calendar-heatmap',
+            title: options?.title ?? `${valueCol} calendar`,
+            data,
+            encoding: {
+                x: {
+                    field: dateCol,
+                    type: 'temporal',
+                    title: 'Week',
+                },
+                y: {
+                    field: '_dayOfWeek',
+                    type: 'ordinal',
+                    title: 'Day',
+                },
+                color: {
+                    field: valueCol,
+                    type: 'quantitative',
+                    scale: {
+                        domain: [minVal, maxVal],
+                        range: options?.colorRange ?? ['#ebedf0', '#9be9a8', '#40c463', '#30a14e', '#216e39'],
+                    },
+                    title: valueCol,
+                },
+            },
+            config: {
+                timeField: dateCol,
+                valueField: valueCol,
+                cellSize: options?.cellSize ?? 15,
+                cellGap: options?.cellGap ?? 2,
+                showMonthLabels: options?.showMonthLabels ?? true,
+                showDayLabels: options?.showDayLabels ?? true,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=calendar-heatmap.js.map

package/dist/src/patterns/definitions/time/calendar-heatmap.js.map

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

package/dist/src/patterns/definitions/time/horizon-chart.d.ts

@@ -0,0 +1,3 @@
+import type { VisualizationPattern } from '../../../types.js';
+export declare const horizonChartPattern: VisualizationPattern;
+//# sourceMappingURL=horizon-chart.d.ts.map

package/dist/src/patterns/definitions/time/horizon-chart.d.ts.map

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

package/dist/src/patterns/definitions/time/horizon-chart.js

@@ -0,0 +1,92 @@
+export const horizonChartPattern = {
+    id: 'horizon-chart',
+    name: 'Horizon Chart',
+    category: 'time',
+    description: 'Ultra-compact time series that folds the y-axis into color bands, layering positive values and mirroring negatives. Shows many series in very little vertical space.',
+    bestFor: 'Dashboard monitoring of 10-50+ time series simultaneously. Server metrics, stock prices, sensor readings. When you need to spot anomalies across many series at once.',
+    notFor: 'Precise value reading, unfamiliar audiences (requires learning), fewer than 5 series.',
+    dataRequirements: {
+        minRows: 10,
+        requiredColumns: [
+            { type: 'date', count: 1, description: 'Time axis' },
+            { type: 'numeric', count: 1, description: 'Value to visualize' },
+            { type: 'categorical', count: 1, description: 'Series identifier (10-50 series)' },
+        ],
+        requiresTimeSeries: true,
+    },
+    selectionRules: [
+        {
+            condition: 'Explicit horizon chart intent',
+            weight: 80,
+            matches: (ctx) => {
+                return /\bhorizon\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Many-series time monitoring with compact or dense intent',
+            weight: 55,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.seriesCount >= 10 &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    /\b(compact|dense|monitor|overview|dashboard|anomal|many\s*series|all\s*series|sensor|server|metric)\b/i.test(ctx.intent));
+            },
+        },
+        {
+            condition: 'Large number of time series (10+) without specific intent',
+            weight: 35,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.seriesCount >= 10 &&
+                    ctx.dataShape.numericColumnCount >= 1);
+            },
+        },
+        {
+            condition: 'Penalize when no time dimension exists',
+            weight: -50,
+            matches: (ctx) => {
+                return !ctx.dataShape.hasTimeSeries && ctx.dataShape.dateColumnCount === 0;
+            },
+        },
+        {
+            condition: 'Penalize for too few series — use line chart instead',
+            weight: -40,
+            matches: (ctx) => {
+                return ctx.dataShape.seriesCount < 5;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const dateCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        const seriesCol = columns.length > 2 ? columns[2] : undefined;
+        const spec = {
+            pattern: 'horizon-chart',
+            title: options?.title ?? `${valueCol} across series`,
+            data,
+            encoding: {
+                x: {
+                    field: dateCol,
+                    type: 'temporal',
+                    title: dateCol,
+                },
+                color: seriesCol
+                    ? {
+                        field: seriesCol,
+                        type: 'nominal',
+                        title: seriesCol,
+                    }
+                    : undefined,
+            },
+            config: {
+                timeField: dateCol,
+                valueField: valueCol,
+                seriesField: seriesCol ?? null,
+                bands: options?.bands ?? 3,
+                mode: options?.mode ?? 'mirror',
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=horizon-chart.js.map

package/dist/src/patterns/definitions/time/horizon-chart.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Time patterns — for showing change, trends, and patterns over time.
+ */
+export { linePattern } from './line.js';
+export { smallMultiplesPattern } from './small-multiples.js';
+export { sparklineGridPattern } from './sparkline-grid.js';
+export { calendarHeatmapPattern } from './calendar-heatmap.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/patterns/definitions/time/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC"}