@outsidedata/dolex 0.1.0

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

@@ -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.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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"}

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

@@ -0,0 +1,10 @@
+/**
+ * Line Chart — standard time series.
+ *
+ * The baseline temporal pattern. Connects data points
+ * chronologically to show trends, cycles, and change over time.
+ * Works best with a single series or 2-5 series.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const linePattern: VisualizationPattern;
+//# sourceMappingURL=line.d.ts.map

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

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

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

@@ -0,0 +1,104 @@
+/**
+ * Line Chart — standard time series.
+ *
+ * The baseline temporal pattern. Connects data points
+ * chronologically to show trends, cycles, and change over time.
+ * Works best with a single series or 2-5 series.
+ */
+export const linePattern = {
+    id: 'line',
+    name: 'Line Chart',
+    category: 'time',
+    description: 'Points connected chronologically by lines. The standard for showing trends, cycles, seasonality, and change over continuous time.',
+    bestFor: 'Single time series or comparing 2-5 series. Showing trends, growth patterns, seasonal effects.',
+    notFor: 'More than 5 series (spaghetti — use small multiples), categorical data (use bar), distribution (use histogram).',
+    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 data with 1-5 series — line chart is the standard',
+            weight: 60,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.numericColumnCount >= 1 &&
+                    ctx.dataShape.seriesCount <= 5);
+            },
+        },
+        {
+            condition: 'Intent mentions trend, over time, or time series',
+            weight: 40,
+            matches: (ctx) => {
+                return /\b(trend|over\s+time|time\s*series|month|year|quarter|growth|decline|trajectory|progress)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Single series with many time points — classic line chart',
+            weight: 30,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.seriesCount <= 1 &&
+                    ctx.dataShape.rowCount >= 5);
+            },
+        },
+        {
+            condition: 'Penalize for too many series — spaghetti chart',
+            weight: -40,
+            matches: (ctx) => {
+                return ctx.dataShape.seriesCount > 5 && ctx.dataShape.hasTimeSeries;
+            },
+        },
+        {
+            condition: 'Penalize when no time dimension exists',
+            weight: -50,
+            matches: (ctx) => {
+                return !ctx.dataShape.hasTimeSeries && ctx.dataShape.dateColumnCount === 0;
+            },
+        },
+    ],
+    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: 'line',
+            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,
+                showPoints: options?.showPoints ?? (data.length <= 50),
+                showArea: options?.showArea ?? false,
+                interpolation: options?.interpolation ?? 'monotone',
+                strokeWidth: options?.strokeWidth ?? 2,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=line.js.map

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

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

package/dist/src/patterns/definitions/time/small-multiples.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Small Multiples — N > 5 series, avoids spaghetti.
+ *
+ * Instead of overlaying many lines on one chart (spaghetti),
+ * creates a grid of individual mini-charts, one per series.
+ * Each shares the same axes for easy comparison while keeping
+ * individual patterns readable.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const smallMultiplesPattern: VisualizationPattern;
+//# sourceMappingURL=small-multiples.d.ts.map

package/dist/src/patterns/definitions/time/small-multiples.d.ts.map

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

package/dist/src/patterns/definitions/time/small-multiples.js

@@ -0,0 +1,99 @@
+/**
+ * Small Multiples — N > 5 series, avoids spaghetti.
+ *
+ * Instead of overlaying many lines on one chart (spaghetti),
+ * creates a grid of individual mini-charts, one per series.
+ * Each shares the same axes for easy comparison while keeping
+ * individual patterns readable.
+ */
+export const smallMultiplesPattern = {
+    id: 'small-multiples',
+    name: 'Small Multiples',
+    category: 'time',
+    description: 'A grid of small charts, one per series, all sharing the same axes. Avoids the spaghetti problem of overlaying many time series while enabling comparison.',
+    bestFor: 'Comparing 5-25 time series: stock prices of multiple companies, temperature by city, sales by product line.',
+    notFor: 'Fewer than 4 series (use regular line chart), more than 30 series (use sparkline grid), single series.',
+    dataRequirements: {
+        minRows: 20,
+        requiredColumns: [
+            { type: 'date', count: 1, description: 'Shared time axis' },
+            { type: 'numeric', count: 1, description: 'Value to plot' },
+            { type: 'categorical', count: 1, description: 'Series identifier (one chart per value)' },
+        ],
+        requiresTimeSeries: true,
+    },
+    selectionRules: [
+        {
+            condition: 'Many series (5-25) over time — small multiples avoids spaghetti',
+            weight: 80,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.seriesCount >= 5 &&
+                    ctx.dataShape.seriesCount <= 25 &&
+                    ctx.dataShape.numericColumnCount >= 1);
+            },
+        },
+        {
+            condition: 'Intent mentions comparison of many series over time',
+            weight: 50,
+            matches: (ctx) => {
+                return /\b(small\s*multiple|facet|each\s+(country|city|product|company|region|team)|all\s+.*\s+over\s+time|individual\s+trend)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'More than 5 series detected on time data — line chart will be spaghetti',
+            weight: 60,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries && ctx.dataShape.seriesCount > 5;
+            },
+        },
+        {
+            condition: 'Penalize for few series — regular line chart works fine',
+            weight: -40,
+            matches: (ctx) => {
+                return ctx.dataShape.seriesCount < 4;
+            },
+        },
+        {
+            condition: 'Penalize for no time dimension',
+            weight: -50,
+            matches: (ctx) => {
+                return !ctx.dataShape.hasTimeSeries;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const timeCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        const seriesCol = columns.length > 2 ? columns[2] : columns.length > 1 ? columns[1] : columns[0];
+        const spec = {
+            pattern: 'small-multiples',
+            title: options?.title ?? `${valueCol} over ${timeCol} by ${seriesCol}`,
+            data,
+            encoding: {
+                x: {
+                    field: timeCol,
+                    type: 'temporal',
+                    title: timeCol,
+                },
+                y: {
+                    field: valueCol,
+                    type: 'quantitative',
+                    title: valueCol,
+                },
+                facet: {
+                    field: seriesCol,
+                    type: 'nominal',
+                    title: seriesCol,
+                },
+            },
+            config: {
+                timeField: timeCol,
+                valueField: valueCol,
+                seriesField: seriesCol,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=small-multiples.js.map

package/dist/src/patterns/definitions/time/small-multiples.js.map

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

package/dist/src/patterns/definitions/time/sparkline-grid.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Sparkline Grid — many series, compact.
+ *
+ * Dense grid of tiny line charts (sparklines) without axes,
+ * labels, or gridlines. Designed for dashboard-style overviews
+ * where you need to scan 10-100 series at once to find patterns.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const sparklineGridPattern: VisualizationPattern;
+//# sourceMappingURL=sparkline-grid.d.ts.map

package/dist/src/patterns/definitions/time/sparkline-grid.d.ts.map

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

package/dist/src/patterns/definitions/time/sparkline-grid.js

@@ -0,0 +1,123 @@
+/**
+ * Sparkline Grid — many series, compact.
+ *
+ * Dense grid of tiny line charts (sparklines) without axes,
+ * labels, or gridlines. Designed for dashboard-style overviews
+ * where you need to scan 10-100 series at once to find patterns.
+ */
+export const sparklineGridPattern = {
+    id: 'sparkline-grid',
+    name: 'Sparkline Grid',
+    category: 'time',
+    description: 'Dense grid of minimal line charts (sparklines), one per series. No axes or labels — just the shape of each trend. Designed for scanning many series at once.',
+    bestFor: 'Dashboard overview of 10-100 series: KPI dashboard, all product metrics, all regional trends. Finding which series stand out.',
+    notFor: 'Precise value reading (no axes), few series (use line chart or small multiples), non-temporal data.',
+    dataRequirements: {
+        minRows: 30,
+        requiredColumns: [
+            { type: 'date', count: 1, description: 'Time axis' },
+            { type: 'numeric', count: 1, description: 'Value' },
+            { type: 'categorical', count: 1, description: 'Series identifier' },
+        ],
+        requiresTimeSeries: true,
+    },
+    selectionRules: [
+        {
+            condition: 'Very many series (15+) — sparkline grid is the most compact',
+            weight: 85,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.seriesCount >= 15 &&
+                    ctx.dataShape.numericColumnCount >= 1);
+            },
+        },
+        {
+            condition: 'Intent mentions overview, dashboard, or scanning many series',
+            weight: 50,
+            matches: (ctx) => {
+                return /\b(overview|dashboard|all\s+\w+|summary|scan|sparkline|compact|every\s+(product|metric|region))\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Many series on time data — beyond what small multiples handles well',
+            weight: 40,
+            matches: (ctx) => {
+                return ctx.dataShape.hasTimeSeries && ctx.dataShape.seriesCount > 25;
+            },
+        },
+        {
+            condition: 'Penalize for few series — use line chart or small multiples',
+            weight: -40,
+            matches: (ctx) => {
+                return ctx.dataShape.seriesCount < 10;
+            },
+        },
+        {
+            condition: 'Penalize for no time dimension',
+            weight: -50,
+            matches: (ctx) => {
+                return !ctx.dataShape.hasTimeSeries;
+            },
+        },
+    ],
+    generateSpec: (data, columns, options) => {
+        const timeCol = columns[0];
+        const valueCol = columns.length > 1 ? columns[1] : columns[0];
+        const seriesCol = columns.length > 2 ? columns[2] : columns.length > 1 ? columns[1] : columns[0];
+        const seriesValues = [...new Set(data.map((d) => d[seriesCol]))];
+        const gridCols = options?.gridCols ?? Math.ceil(Math.sqrt(seriesValues.length));
+        // Compute min/max and latest trend direction per series
+        const seriesMeta = seriesValues.map((series) => {
+            const seriesData = data
+                .filter((d) => d[seriesCol] === series)
+                .sort((a, b) => (a[timeCol] > b[timeCol] ? 1 : -1));
+            const values = seriesData.map((d) => Number(d[valueCol]) || 0);
+            const last = values[values.length - 1] ?? 0;
+            const secondLast = values[values.length - 2] ?? last;
+            return {
+                series,
+                min: Math.min(...values),
+                max: Math.max(...values),
+                latest: last,
+                trend: last >= secondLast ? 'up' : 'down',
+                changePercent: secondLast !== 0 ? ((last - secondLast) / Math.abs(secondLast)) * 100 : 0,
+            };
+        });
+        const spec = {
+            pattern: 'sparkline-grid',
+            title: options?.title ?? `${valueCol} sparklines by ${seriesCol}`,
+            data,
+            encoding: {
+                x: {
+                    field: timeCol,
+                    type: 'temporal',
+                },
+                y: {
+                    field: valueCol,
+                    type: 'quantitative',
+                },
+                facet: {
+                    field: seriesCol,
+                    type: 'nominal',
+                },
+            },
+            config: {
+                timeField: timeCol,
+                valueField: valueCol,
+                seriesField: seriesCol,
+                gridCols,
+                seriesMeta,
+                cellWidth: options?.cellWidth ?? 100,
+                cellHeight: options?.cellHeight ?? 30,
+                curveType: options?.curveType ?? 'monotone',
+                showSeriesLabel: options?.showSeriesLabel ?? true,
+                showLatestValue: options?.showLatestValue ?? true,
+                showTrendIndicator: options?.showTrendIndicator ?? true,
+                highlightMinMax: options?.highlightMinMax ?? false,
+                strokeWidth: options?.strokeWidth ?? 1.5,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=sparkline-grid.js.map

package/dist/src/patterns/definitions/time/sparkline-grid.js.map

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

package/dist/src/patterns/definitions/time/stream-graph.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Stream Graph — stacked area with flowing, organic baseline.
+ *
+ * Layers flow around a central axis using wiggle or silhouette offset,
+ * creating an organic, flowing shape that emphasizes composition
+ * evolution over time.
+ */
+import type { VisualizationPattern } from '../../../types.js';
+export declare const streamGraphPattern: VisualizationPattern;
+//# sourceMappingURL=stream-graph.d.ts.map

package/dist/src/patterns/definitions/time/stream-graph.d.ts.map

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

package/dist/src/patterns/definitions/time/stream-graph.js

@@ -0,0 +1,122 @@
+/**
+ * Stream Graph — stacked area with flowing, organic baseline.
+ *
+ * Layers flow around a central axis using wiggle or silhouette offset,
+ * creating an organic, flowing shape that emphasizes composition
+ * evolution over time.
+ */
+export const streamGraphPattern = {
+    id: 'stream-graph',
+    name: 'Stream Graph',
+    category: 'time',
+    description: 'Stacked area chart with a flowing, organic baseline (centered or wiggle layout). Layers flow around a central axis, emphasizing how composition evolves over time.',
+    bestFor: 'Showing how composition evolves over time with an emphasis on flow and organic shape. Music genre popularity over decades, topic trends over time, seasonal patterns by category.',
+    notFor: 'Precise value reading (wiggle offset makes y values meaningless). Few series (<3). Non-temporal data.',
+    dataRequirements: {
+        minRows: 6,
+        requiredColumns: [
+            { type: 'date', count: 1, description: 'Time axis' },
+            { type: 'numeric', count: 1, description: 'Value per series per time point' },
+            { type: 'categorical', count: 1, description: 'Series/category identifier' },
+        ],
+        requiresTimeSeries: true,
+        minCategories: 3,
+        maxCategories: 15,
+    },
+    selectionRules: [
+        {
+            condition: 'Intent explicitly mentions stream graph or streamgraph',
+            weight: 90,
+            matches: (ctx) => {
+                return /\b(stream\s*graph|streamgraph|stream\s*chart)\b/i.test(ctx.intent);
+            },
+        },
+        {
+            condition: 'Temporal composition with many series and flow/organic/evolution intent',
+            weight: 65,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.seriesCount >= 3 &&
+                    ctx.dataShape.seriesCount <= 15 &&
+                    /\b(flow|organic|evolut|trend|composition\s+over\s+time|how\s+.*\s+change|popularity|genre|topic)\b/i.test(ctx.intent));
+            },
+        },
+        {
+            condition: 'Time series with many categories — stream graph handles visual density well',
+            weight: 40,
+            matches: (ctx) => {
+                return (ctx.dataShape.hasTimeSeries &&
+                    ctx.dataShape.seriesCount >= 5 &&
+                    ctx.dataShape.seriesCount <= 15 &&
+                    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 — stacked area or line is better',
+            weight: -30,
+            matches: (ctx) => {
+                return ctx.dataShape.seriesCount < 3;
+            },
+        },
+        {
+            condition: 'Penalize for too many series — visual clutter',
+            weight: -25,
+            matches: (ctx) => {
+                return ctx.dataShape.seriesCount > 15;
+            },
+        },
+        {
+            condition: 'Penalize when precise value reading is needed',
+            weight: -20,
+            matches: (ctx) => {
+                return /\b(exact|precise|compare\s+values|difference|rank)\b/i.test(ctx.intent);
+            },
+        },
+    ],
+    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: 'stream-graph',
+            title: options?.title ?? `${valueCol} streams over time`,
+            data,
+            encoding: {
+                x: {
+                    field: dateCol,
+                    type: 'temporal',
+                    title: dateCol,
+                },
+                y: {
+                    field: valueCol,
+                    type: 'quantitative',
+                    title: valueCol,
+                },
+                color: seriesCol
+                    ? {
+                        field: seriesCol,
+                        type: 'nominal',
+                        title: seriesCol,
+                    }
+                    : undefined,
+            },
+            config: {
+                timeField: dateCol,
+                valueField: valueCol,
+                seriesField: seriesCol ?? null,
+                offset: options?.offset ?? 'wiggle',
+                curve: options?.curve ?? 'basis',
+                interactive: options?.interactive ?? true,
+            },
+        };
+        return spec;
+    },
+};
+//# sourceMappingURL=stream-graph.js.map

package/dist/src/patterns/definitions/time/stream-graph.js.map

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

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

@@ -0,0 +1,23 @@
+/**
+ * Dolex Visualization Pattern Library — Public API.
+ *
+ * This module is the main entry point for all pattern-related functionality.
+ * It re-exports the registry, selector, utilities, and all pattern definitions.
+ *
+ * Usage:
+ *   import { selectPattern, registry } from './patterns/index.js';
+ *
+ *   const result = selectPattern(data, columns, "compare revenue by region");
+ *   console.log(result.recommended.spec);
+ */
+export { registry } from './registry.js';
+export { selectPattern, quickRecommend, scoreSpecificPattern } from './selector.js';
+export type { SelectionResult } from './selector.js';
+export { buildMatchContext, parseIntent, hasTimeSeriesColumn, countCategories, countSeries, hasNegativeValues, getValueRange, detectHierarchy, findColumnByType, findColumnsByType, inferFieldType, inferEncoding, } from './utils.js';
+export { barPattern, divergingBarPattern, slopeChartPattern, connectedDotPlotPattern, bumpChartPattern, } from './definitions/comparison/index.js';
+export { histogramPattern, beeswarmPattern, violinPattern, ridgelinePattern, stripPlotPattern, } from './definitions/distribution/index.js';
+export { stackedBarPattern, wafflePattern, treemapPattern, sunburstPattern, } from './definitions/composition/index.js';
+export { linePattern, smallMultiplesPattern, sparklineGridPattern, calendarHeatmapPattern, } from './definitions/time/index.js';
+export { scatterPattern, connectedScatterPattern, parallelCoordinatesPattern, radarPattern, } from './definitions/relationship/index.js';
+export { sankeyPattern, alluvialPattern, chordPattern, } from './definitions/flow/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIrD,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,mCAAmC,CAAC;AAG3C,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,0BAA0B,EAC1B,YAAY,GACb,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,6BAA6B,CAAC"}

package/dist/src/patterns/index.js

@@ -0,0 +1,32 @@
+/**
+ * Dolex Visualization Pattern Library — Public API.
+ *
+ * This module is the main entry point for all pattern-related functionality.
+ * It re-exports the registry, selector, utilities, and all pattern definitions.
+ *
+ * Usage:
+ *   import { selectPattern, registry } from './patterns/index.js';
+ *
+ *   const result = selectPattern(data, columns, "compare revenue by region");
+ *   console.log(result.recommended.spec);
+ */
+// ─── CORE API ────────────────────────────────────────────────────────────────
+export { registry } from './registry.js';
+export { selectPattern, quickRecommend, scoreSpecificPattern } from './selector.js';
+// ─── UTILITIES ───────────────────────────────────────────────────────────────
+export { buildMatchContext, parseIntent, hasTimeSeriesColumn, countCategories, countSeries, hasNegativeValues, getValueRange, detectHierarchy, findColumnByType, findColumnsByType, inferFieldType, inferEncoding, } from './utils.js';
+// ─── PATTERN DEFINITIONS ─────────────────────────────────────────────────────
+// Re-exported for direct access when needed.
+// Comparison
+export { barPattern, divergingBarPattern, slopeChartPattern, connectedDotPlotPattern, bumpChartPattern, } from './definitions/comparison/index.js';
+// Distribution
+export { histogramPattern, beeswarmPattern, violinPattern, ridgelinePattern, stripPlotPattern, } from './definitions/distribution/index.js';
+// Composition
+export { stackedBarPattern, wafflePattern, treemapPattern, sunburstPattern, } from './definitions/composition/index.js';
+// Time
+export { linePattern, smallMultiplesPattern, sparklineGridPattern, calendarHeatmapPattern, } from './definitions/time/index.js';
+// Relationship
+export { scatterPattern, connectedScatterPattern, parallelCoordinatesPattern, radarPattern, } from './definitions/relationship/index.js';
+// Flow
+export { sankeyPattern, alluvialPattern, chordPattern, } from './definitions/flow/index.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/patterns/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGpF,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,gFAAgF;AAChF,6CAA6C;AAE7C,aAAa;AACb,OAAO,EACL,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,mCAAmC,CAAC;AAE3C,eAAe;AACf,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qCAAqC,CAAC;AAE7C,cAAc;AACd,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,GAChB,MAAM,oCAAoC,CAAC;AAE5C,OAAO;AACP,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAErC,eAAe;AACf,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,0BAA0B,EAC1B,YAAY,GACb,MAAM,qCAAqC,CAAC;AAE7C,OAAO;AACP,OAAO,EACL,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,6BAA6B,CAAC"}