@outsidedata/dolex 0.1.0

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

@@ -0,0 +1,69 @@
+/**
+ * Pattern Registry — stores all visualization patterns and provides lookup.
+ *
+ * The registry is the single source of truth for all available patterns.
+ * Patterns register themselves on import, and the registry provides
+ * methods to query patterns by ID, category, or data requirements.
+ */
+import type { VisualizationPattern, PatternCategory, DataRequirements } from '../types.js';
+declare class PatternRegistry {
+    private patterns;
+    /**
+     * Register a pattern. Throws if a pattern with the same ID already exists.
+     */
+    register(pattern: VisualizationPattern): void;
+    /**
+     * Get a pattern by its unique ID.
+     */
+    get(id: string): VisualizationPattern | undefined;
+    /**
+     * Get all registered patterns.
+     */
+    getAll(): VisualizationPattern[];
+    /**
+     * Get all patterns in a specific category.
+     */
+    getByCategory(category: PatternCategory): VisualizationPattern[];
+    /**
+     * Get all available categories with their pattern counts.
+     */
+    getCategories(): {
+        category: PatternCategory;
+        count: number;
+        patterns: string[];
+    }[];
+    /**
+     * Get patterns that are compatible with the given data requirements.
+     * This is a structural check — it verifies that the data CAN work
+     * with the pattern, not whether it SHOULD.
+     */
+    getCompatible(opts: {
+        rowCount: number;
+        numericColumnCount: number;
+        categoricalColumnCount: number;
+        dateColumnCount: number;
+        hasHierarchy?: boolean;
+        hasTimeSeries?: boolean;
+    }): VisualizationPattern[];
+    /**
+     * Get a summary of all patterns suitable for external listing.
+     */
+    listPatterns(): {
+        id: string;
+        name: string;
+        category: PatternCategory;
+        description: string;
+        bestFor: string;
+        dataRequirements: DataRequirements;
+    }[];
+    /**
+     * Total number of registered patterns.
+     */
+    get size(): number;
+}
+/**
+ * The global pattern registry. Populated with all built-in patterns on import.
+ */
+export declare const registry: PatternRegistry;
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/patterns/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA6D3F,cAAM,eAAe;IACnB,OAAO,CAAC,QAAQ,CAAgD;IAEhE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAO7C;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIjD;;OAEG;IACH,MAAM,IAAI,oBAAoB,EAAE;IAIhC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,oBAAoB,EAAE;IAIhE;;OAEG;IACH,aAAa,IAAI;QAAE,QAAQ,EAAE,eAAe,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE;IAcnF;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GAAG,oBAAoB,EAAE;IAO1B;;OAEG;IACH,YAAY,IAAI;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,eAAe,CAAC;QAC1B,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,gBAAgB,CAAC;KACpC,EAAE;IAWH;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AA+CD;;GAEG;AACH,eAAO,MAAM,QAAQ,iBAAwB,CAAC"}

package/dist/src/patterns/registry.js

@@ -0,0 +1,230 @@
+/**
+ * Pattern Registry — stores all visualization patterns and provides lookup.
+ *
+ * The registry is the single source of truth for all available patterns.
+ * Patterns register themselves on import, and the registry provides
+ * methods to query patterns by ID, category, or data requirements.
+ */
+// ─── COMPARISON ──────────────────────────────────────────────────────────────
+import { barPattern } from './definitions/comparison/bar.js';
+import { divergingBarPattern } from './definitions/comparison/diverging-bar.js';
+import { slopeChartPattern } from './definitions/comparison/slope-chart.js';
+import { connectedDotPlotPattern } from './definitions/comparison/connected-dot-plot.js';
+import { bumpChartPattern } from './definitions/comparison/bump-chart.js';
+import { lollipopPattern } from './definitions/comparison/lollipop.js';
+import { bulletPattern } from './definitions/comparison/bullet.js';
+import { groupedBarPattern } from './definitions/comparison/grouped-bar.js';
+import { waterfallPattern } from './definitions/comparison/waterfall.js';
+// ─── DISTRIBUTION ────────────────────────────────────────────────────────────
+import { histogramPattern } from './definitions/distribution/histogram.js';
+import { beeswarmPattern } from './definitions/distribution/beeswarm.js';
+import { violinPattern } from './definitions/distribution/violin.js';
+import { ridgelinePattern } from './definitions/distribution/ridgeline.js';
+import { stripPlotPattern } from './definitions/distribution/strip-plot.js';
+import { boxPlotPattern } from './definitions/distribution/box-plot.js';
+import { densityPlotPattern } from './definitions/distribution/density-plot.js';
+// ─── COMPOSITION ─────────────────────────────────────────────────────────────
+import { stackedBarPattern } from './definitions/composition/stacked-bar.js';
+import { wafflePattern } from './definitions/composition/waffle.js';
+import { treemapPattern } from './definitions/composition/treemap.js';
+import { sunburstPattern } from './definitions/composition/sunburst.js';
+import { circlePackPattern } from './definitions/composition/circle-pack.js';
+import { metricPattern } from './definitions/composition/metric.js';
+import { donutPattern } from './definitions/composition/donut.js';
+import { marimekkoPattern } from './definitions/composition/marimekko.js';
+import { iciclePattern } from './definitions/composition/icicle.js';
+// ─── TIME ────────────────────────────────────────────────────────────────────
+import { linePattern } from './definitions/time/line.js';
+import { areaPattern } from './definitions/time/area.js';
+import { smallMultiplesPattern } from './definitions/time/small-multiples.js';
+import { sparklineGridPattern } from './definitions/time/sparkline-grid.js';
+import { calendarHeatmapPattern } from './definitions/time/calendar-heatmap.js';
+import { streamGraphPattern } from './definitions/time/stream-graph.js';
+import { horizonChartPattern } from './definitions/time/horizon-chart.js';
+// ─── RELATIONSHIP ────────────────────────────────────────────────────────────
+import { scatterPattern } from './definitions/relationship/scatter.js';
+import { connectedScatterPattern } from './definitions/relationship/connected-scatter.js';
+import { parallelCoordinatesPattern } from './definitions/relationship/parallel-coordinates.js';
+import { radarPattern } from './definitions/relationship/radar.js';
+import { heatmapPattern } from './definitions/relationship/heatmap.js';
+// ─── FLOW ────────────────────────────────────────────────────────────────────
+import { sankeyPattern } from './definitions/flow/sankey.js';
+import { alluvialPattern } from './definitions/flow/alluvial.js';
+import { chordPattern } from './definitions/flow/chord.js';
+import { funnelPattern } from './definitions/flow/funnel.js';
+// ─── GEO ─────────────────────────────────────────────────────────────────────
+import { choroplethPattern } from './definitions/geo/choropleth.js';
+import { proportionalSymbolPattern } from './definitions/geo/proportional-symbol.js';
+// ─── REGISTRY ────────────────────────────────────────────────────────────────
+class PatternRegistry {
+    patterns = new Map();
+    /**
+     * Register a pattern. Throws if a pattern with the same ID already exists.
+     */
+    register(pattern) {
+        if (this.patterns.has(pattern.id)) {
+            throw new Error(`Pattern "${pattern.id}" is already registered.`);
+        }
+        this.patterns.set(pattern.id, pattern);
+    }
+    /**
+     * Get a pattern by its unique ID.
+     */
+    get(id) {
+        return this.patterns.get(id);
+    }
+    /**
+     * Get all registered patterns.
+     */
+    getAll() {
+        return Array.from(this.patterns.values());
+    }
+    /**
+     * Get all patterns in a specific category.
+     */
+    getByCategory(category) {
+        return this.getAll().filter((p) => p.category === category);
+    }
+    /**
+     * Get all available categories with their pattern counts.
+     */
+    getCategories() {
+        const categories = new Map();
+        for (const pattern of this.patterns.values()) {
+            const existing = categories.get(pattern.category) ?? [];
+            existing.push(pattern.id);
+            categories.set(pattern.category, existing);
+        }
+        return Array.from(categories.entries()).map(([category, patterns]) => ({
+            category,
+            count: patterns.length,
+            patterns,
+        }));
+    }
+    /**
+     * Get patterns that are compatible with the given data requirements.
+     * This is a structural check — it verifies that the data CAN work
+     * with the pattern, not whether it SHOULD.
+     */
+    getCompatible(opts) {
+        return this.getAll().filter((pattern) => {
+            const req = pattern.dataRequirements;
+            return isCompatible(req, opts);
+        });
+    }
+    /**
+     * Get a summary of all patterns suitable for external listing.
+     */
+    listPatterns() {
+        return this.getAll().map((p) => ({
+            id: p.id,
+            name: p.name,
+            category: p.category,
+            description: p.description,
+            bestFor: p.bestFor,
+            dataRequirements: p.dataRequirements,
+        }));
+    }
+    /**
+     * Total number of registered patterns.
+     */
+    get size() {
+        return this.patterns.size;
+    }
+}
+/**
+ * Check whether data characteristics meet a pattern's requirements.
+ */
+function isCompatible(req, opts) {
+    if (req.minRows !== undefined && opts.rowCount < req.minRows)
+        return false;
+    if (req.maxRows !== undefined && opts.rowCount > req.maxRows * 2)
+        return false; // Soft limit: allow 2x over
+    if (req.requiresTimeSeries && !opts.hasTimeSeries && opts.dateColumnCount === 0)
+        return false;
+    if (req.requiresHierarchy && !opts.hasHierarchy)
+        return false;
+    if (req.requiredColumns) {
+        for (const colReq of req.requiredColumns) {
+            let available = 0;
+            switch (colReq.type) {
+                case 'numeric':
+                    available = opts.numericColumnCount;
+                    break;
+                case 'categorical':
+                    available = opts.categoricalColumnCount;
+                    break;
+                case 'date':
+                    available = opts.dateColumnCount;
+                    break;
+                default:
+                    available = opts.categoricalColumnCount + opts.numericColumnCount;
+            }
+            if (available < colReq.count)
+                return false;
+        }
+    }
+    return true;
+}
+// ─── SINGLETON INSTANCE ──────────────────────────────────────────────────────
+/**
+ * The global pattern registry. Populated with all built-in patterns on import.
+ */
+export const registry = new PatternRegistry();
+// Register all built-in patterns
+const ALL_PATTERNS = [
+    // Comparison
+    barPattern,
+    divergingBarPattern,
+    slopeChartPattern,
+    connectedDotPlotPattern,
+    bumpChartPattern,
+    lollipopPattern,
+    bulletPattern,
+    groupedBarPattern,
+    waterfallPattern,
+    // Distribution
+    histogramPattern,
+    beeswarmPattern,
+    violinPattern,
+    ridgelinePattern,
+    stripPlotPattern,
+    boxPlotPattern,
+    densityPlotPattern,
+    // Composition
+    stackedBarPattern,
+    wafflePattern,
+    treemapPattern,
+    sunburstPattern,
+    circlePackPattern,
+    metricPattern,
+    donutPattern,
+    marimekkoPattern,
+    iciclePattern,
+    // Time
+    linePattern,
+    areaPattern,
+    smallMultiplesPattern,
+    sparklineGridPattern,
+    calendarHeatmapPattern,
+    streamGraphPattern,
+    horizonChartPattern,
+    // Relationship
+    scatterPattern,
+    connectedScatterPattern,
+    parallelCoordinatesPattern,
+    radarPattern,
+    heatmapPattern,
+    // Flow
+    sankeyPattern,
+    alluvialPattern,
+    chordPattern,
+    funnelPattern,
+    // Geo
+    choroplethPattern,
+    proportionalSymbolPattern,
+];
+for (const pattern of ALL_PATTERNS) {
+    registry.register(pattern);
+}
+//# sourceMappingURL=registry.js.map

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * Pattern Selection Intelligence.
+ *
+ * This is the core of the product. Analyzes data shape + user intent,
+ * scores every registered pattern, and returns ranked recommendations
+ * with reasoning.
+ *
+ * An LLM will always pick bar/line/pie. We pick bump charts, beeswarms,
+ * slope charts, waffles — because the selection rules encode design
+ * expertise that probabilistic token generation cannot.
+ */
+import type { DataColumn, PatternMatchContext, VisualizationRecommendation, PatternCategory } from '../types.js';
+export interface SelectionResult {
+    /** Best recommendation */
+    recommended: VisualizationRecommendation;
+    /** Alternative recommendations sorted by score */
+    alternatives: VisualizationRecommendation[];
+    /** The data shape analysis that drove the selection */
+    dataShape: PatternMatchContext['dataShape'];
+    /** The inferred intent category */
+    intentCategory: PatternCategory | 'unknown';
+}
+/**
+ * Select the best visualization pattern(s) for the given data and intent.
+ *
+ * This is the primary entry point for visualization intelligence.
+ * It builds a data shape context, scores all patterns against it,
+ * generates specs for the top recommendations, and returns them ranked.
+ *
+ * @param data - Array of data rows
+ * @param columns - Column metadata (types, cardinality, etc.)
+ * @param intent - User's description of what they want to see
+ * @param options - Optional configuration
+ * @returns Ranked recommendations with specs and reasoning
+ */
+export declare function selectPattern(data: Record<string, any>[], columns: DataColumn[], intent: string, options?: {
+    /** Maximum number of alternatives to return (default: 3) */
+    maxAlternatives?: number;
+    /** Only consider patterns in these categories */
+    filterCategories?: PatternCategory[];
+    /** Exclude specific pattern IDs */
+    excludePatterns?: string[];
+    /** Additional options passed to generateSpec */
+    specOptions?: Record<string, any>;
+    /** Force a specific pattern by ID — bypasses scoring, promoted to recommended */
+    forcePattern?: string;
+}): SelectionResult;
+/**
+ * Quick recommendation: just return the single best pattern ID and a brief reason.
+ * Useful for logging, debugging, or simple integrations.
+ */
+export declare function quickRecommend(data: Record<string, any>[], columns: DataColumn[], intent: string): {
+    patternId: string;
+    reasoning: string;
+};
+/**
+ * Score a specific pattern against data without generating a spec.
+ * Useful for testing individual patterns.
+ */
+export declare function scoreSpecificPattern(patternId: string, data: Record<string, any>[], columns: DataColumn[], intent: string): {
+    score: number;
+    matchedRules: {
+        condition: string;
+        weight: number;
+    }[];
+    reasoning: string;
+} | null;
+//# sourceMappingURL=selector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selector.d.ts","sourceRoot":"","sources":["../../../src/patterns/selector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EAEnB,2BAA2B,EAE3B,eAAe,EAChB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,WAAW,EAAE,2BAA2B,CAAC;IACzC,kDAAkD;IAClD,YAAY,EAAE,2BAA2B,EAAE,CAAC;IAC5C,uDAAuD;IACvD,SAAS,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC5C,mCAAmC;IACnC,cAAc,EAAE,eAAe,GAAG,SAAS,CAAC;CAC7C;AAWD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAC3B,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IACR,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,eAAe,CAuFjB;AA2VD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAC3B,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE,MAAM,GACb;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAM1C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EAC3B,OAAO,EAAE,UAAU,EAAE,EACrB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAapG"}