photon-grid-core 0.0.1

package/chart/chart-analyzer/cardinality-analyzer.d.ts

@@ -0,0 +1,13 @@
+import type { ColumnDef } from '../../types/column.types';
+import type { RowNode } from '../../types/row.types';
+import type { CardinalityInfo } from './types';
+/**
+ * Counts distinct values for a single column and classifies cardinality.
+ * Used by the RecommendationEngine to choose between pie (low cardinality)
+ * and bar charts (high cardinality).
+ */
+export declare class CardinalityAnalyzer {
+    /** @param topN  Max number of top-frequency values to return */
+    analyze(column: ColumnDef, rows: RowNode[], topN?: number): CardinalityInfo;
+}
+//# sourceMappingURL=cardinality-analyzer.d.ts.map

package/chart/chart-analyzer/cardinality-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardinality-analyzer.d.ts","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/cardinality-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,gEAAgE;IAChE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,SAAK,GAAG,eAAe;CAqBxE"}

package/chart/chart-analyzer/cardinality-analyzer.js

@@ -0,0 +1,28 @@
+/**
+ * Counts distinct values for a single column and classifies cardinality.
+ * Used by the RecommendationEngine to choose between pie (low cardinality)
+ * and bar charts (high cardinality).
+ */
+export class CardinalityAnalyzer {
+    /** @param topN  Max number of top-frequency values to return */
+    analyze(column, rows, topN = 20) {
+        const freq = new Map();
+        for (const row of rows) {
+            if (row.type !== 'data')
+                continue;
+            const raw = row.data[column.field];
+            const key = raw == null ? '' : String(raw);
+            freq.set(key, (freq.get(key) ?? 0) + 1);
+        }
+        const topValues = Array.from(freq.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, topN)
+            .map(([k]) => k);
+        return {
+            uniqueCount: freq.size,
+            isHighCardinality: freq.size > 20,
+            topValues,
+        };
+    }
+}
+//# sourceMappingURL=cardinality-analyzer.js.map

package/chart/chart-analyzer/cardinality-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardinality-analyzer.js","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/cardinality-analyzer.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAC9B,gEAAgE;IAChE,OAAO,CAAC,MAAiB,EAAE,IAAe,EAAE,IAAI,GAAG,EAAE;QACnD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YAClC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;aACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC3B,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;aACd,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAEnB,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,iBAAiB,EAAE,IAAI,CAAC,IAAI,GAAG,EAAE;YACjC,SAAS;SACV,CAAC;IACJ,CAAC;CACF"}

package/chart/chart-analyzer/dimension-analyzer.d.ts

@@ -0,0 +1,12 @@
+import type { ColumnDef } from '../../types/column.types';
+import type { RowNode } from '../../types/row.types';
+import type { DimensionInfo } from './types';
+/**
+ * Identifies categorical/ordinal columns in the selection and computes
+ * cardinality metadata needed by downstream analyzers and the
+ * RecommendationEngine.
+ */
+export declare class DimensionAnalyzer {
+    analyze(columns: ColumnDef[], rows: RowNode[]): DimensionInfo[];
+}
+//# sourceMappingURL=dimension-analyzer.d.ts.map

package/chart/chart-analyzer/dimension-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-analyzer.d.ts","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/dimension-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,aAAa,EAAE;CA2BhE"}

package/chart/chart-analyzer/dimension-analyzer.js

@@ -0,0 +1,33 @@
+import { DIMENSION_TYPES, DATE_TYPES, MAX_CATEGORIES } from './types';
+/**
+ * Identifies categorical/ordinal columns in the selection and computes
+ * cardinality metadata needed by downstream analyzers and the
+ * RecommendationEngine.
+ */
+export class DimensionAnalyzer {
+    analyze(columns, rows) {
+        const dimCols = columns.filter((c) => DIMENSION_TYPES.has(c.type));
+        return dimCols.map((col) => {
+            const seen = new Set();
+            for (const row of rows) {
+                if (row.type !== 'data')
+                    continue;
+                const raw = row.data[col.field];
+                seen.add(raw == null ? '' : String(raw));
+            }
+            const isDate = DATE_TYPES.has(col.type);
+            const isBoolean = col.type === 'boolean';
+            const isHighCardinality = seen.size > 20;
+            const uniqueValues = Array.from(seen).slice(0, MAX_CATEGORIES);
+            return {
+                column: col,
+                role: isDate ? 'date' : isBoolean ? 'boolean' : 'category',
+                uniqueValues,
+                uniqueCount: seen.size,
+                isHighCardinality,
+                isDate,
+            };
+        });
+    }
+}
+//# sourceMappingURL=dimension-analyzer.js.map

package/chart/chart-analyzer/dimension-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-analyzer.js","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/dimension-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGtE;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC5B,OAAO,CAAC,OAAoB,EAAE,IAAe;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC,CAAC;QAE7E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACzB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAE/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;oBAAE,SAAS;gBAClC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3C,CAAC;YAED,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAc,CAAC,CAAC;YAClD,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC;YACzC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;YACzC,MAAM,YAAY,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;YAE/D,OAAO;gBACL,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;gBAC1D,YAAY;gBACZ,WAAW,EAAE,IAAI,CAAC,IAAI;gBACtB,iBAAiB;gBACjB,MAAM;aACP,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/chart/chart-analyzer/histogram-analyzer.d.ts

@@ -0,0 +1,11 @@
+import type { MeasureInfo, AnalyzedChart } from './types';
+/**
+ * Produces a frequency-distribution dataset from a single numeric column.
+ * Bin count is determined by Sturges' formula: ceil(log2(n) + 1).
+ * The output is consumed by a column-grouped chart in the renderer.
+ */
+export declare class HistogramAnalyzer {
+    analyze(measures: MeasureInfo[]): AnalyzedChart | null;
+    private fmtRange;
+}
+//# sourceMappingURL=histogram-analyzer.d.ts.map

package/chart/chart-analyzer/histogram-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"histogram-analyzer.d.ts","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/histogram-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG1D;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,aAAa,GAAG,IAAI;IA+BtD,OAAO,CAAC,QAAQ;CAOjB"}

package/chart/chart-analyzer/histogram-analyzer.js

@@ -0,0 +1,43 @@
+import { APEX_COLORS } from './types';
+/**
+ * Produces a frequency-distribution dataset from a single numeric column.
+ * Bin count is determined by Sturges' formula: ceil(log2(n) + 1).
+ * The output is consumed by a column-grouped chart in the renderer.
+ */
+export class HistogramAnalyzer {
+    analyze(measures) {
+        if (!measures.length)
+            return null;
+        const measure = measures[0];
+        const values = measure.allValues.filter((v) => !isNaN(v));
+        if (!values.length)
+            return null;
+        // Sturges' formula, clamped between 5 and 20 bins
+        const binCount = Math.min(Math.max(Math.ceil(Math.log2(values.length) + 1), 5), 20);
+        const range = measure.max - measure.min || 1;
+        const binSize = range / binCount;
+        const bins = [];
+        for (let i = 0; i < binCount; i++) {
+            bins.push({ start: measure.min + i * binSize, end: measure.min + (i + 1) * binSize, count: 0 });
+        }
+        for (const v of values) {
+            const idx = Math.min(Math.floor((v - measure.min) / binSize), binCount - 1);
+            if (idx >= 0)
+                bins[idx].count++;
+        }
+        return {
+            title: `${measure.column.header} Distribution`,
+            data: {
+                labels: bins.map((b) => this.fmtRange(b.start, b.end)),
+                datasets: [{ label: 'Frequency', data: bins.map((b) => b.count), color: APEX_COLORS[0] }],
+            },
+        };
+    }
+    fmtRange(start, end) {
+        const f = (n) => n >= 1000000 ? `${(n / 1000000).toFixed(1)}M`
+            : n >= 1000 ? `${(n / 1000).toFixed(1)}K`
+                : Number.isInteger(n) ? String(n) : n.toFixed(1);
+        return `${f(start)}–${f(end)}`;
+    }
+}
+//# sourceMappingURL=histogram-analyzer.js.map

package/chart/chart-analyzer/histogram-analyzer.js.map

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

package/chart/chart-analyzer/index.d.ts

@@ -0,0 +1,58 @@
+import type { RowNode } from '../../types/row.types';
+import type { ColumnDef } from '../../types/column.types';
+import type { CellRange } from '../../types/grid.types';
+import { CardinalityAnalyzer } from './cardinality-analyzer';
+import type { AnalyzedChart, ChartRecommendation } from './types';
+export type { AnalyzedChart, ChartRecommendation };
+/**
+ * Top-level orchestrator that mirrors AG Grid's chart-range analysis pipeline:
+ *
+ *   selection → DimensionAnalyzer + MeasureAnalyzer
+ *             → RecommendationEngine (best chart type)
+ *             → chart-specific Analyzer (data shaping)
+ *             → AnalyzedChart (title + ChartData)
+ *
+ * Public API
+ * ----------
+ * analyze(ranges, rows, columns)
+ *   Returns the best-fit chart data for the current selection, or null when
+ *   the selection contains no numeric columns.
+ *
+ * analyzeForType(chartType, ranges, rows, columns)
+ *   Returns chart data shaped for the explicitly-requested chart type.
+ *
+ * recommend(ranges, rows, columns)
+ *   Returns a ranked list of ChartRecommendation objects so a UI can suggest
+ *   chart types to the user (future use / API extension).
+ */
+export declare class ChartAnalyzer {
+    private readonly dimensionAnalyzer;
+    private readonly measureAnalyzer;
+    readonly cardinalityAnalyzer: CardinalityAnalyzer;
+    private readonly aggregationAnalyzer;
+    private readonly histogramAnalyzer;
+    private readonly scatterAnalyzer;
+    private readonly bubbleAnalyzer;
+    private readonly pieAnalyzer;
+    private readonly barAnalyzer;
+    private readonly lineAnalyzer;
+    private readonly recommendationEngine;
+    /**
+     * Analyse a cell selection and return data shaped for the best chart type
+     * recommended by the RecommendationEngine, or null if no numeric data.
+     */
+    analyze(ranges: CellRange[], rows: RowNode[], columns: ColumnDef[]): AnalyzedChart | null;
+    /**
+     * Analyse a cell selection and return data shaped for the explicitly
+     * requested chart type.  Returns null if there are no numeric columns.
+     */
+    analyzeForType(chartType: string, ranges: CellRange[], rows: RowNode[], columns: ColumnDef[]): AnalyzedChart | null;
+    /**
+     * Return a ranked list of chart-type recommendations for the current
+     * selection. Useful for a "Recommended charts" panel (not yet in the UI).
+     */
+    recommend(ranges: CellRange[], rows: RowNode[], columns: ColumnDef[]): ChartRecommendation[];
+    private buildContext;
+    private dispatch;
+}
+//# sourceMappingURL=index.d.ts.map

package/chart/chart-analyzer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKxD,OAAO,EAAE,mBAAmB,EAAE,MAAO,wBAAwB,CAAC;AAU9D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAA8B,MAAM,SAAS,CAAC;AAE9F,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAa;IAExB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA8B;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;IAC9D,QAAQ,CAAS,mBAAmB,sBAA8B;IAClE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8B;IAClE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA8B;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;IAC9D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;IAC3D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8B;IAInE;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,aAAa,GAAG,IAAI;IAYzF;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,aAAa,GAAG,IAAI;IAUnH;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,mBAAmB,EAAE;IAQ5F,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,QAAQ;CAoCjB"}

package/chart/chart-analyzer/index.js

@@ -0,0 +1,130 @@
+import { normalizeRange } from '../../cell-selection/selection-range';
+import { DimensionAnalyzer } from './dimension-analyzer';
+import { MeasureAnalyzer } from './measure-analyzer';
+import { CardinalityAnalyzer } from './cardinality-analyzer';
+import { AggregationAnalyzer } from './aggregation-analyzer';
+import { HistogramAnalyzer } from './histogram-analyzer';
+import { ScatterAnalyzer } from './scatter-analyzer';
+import { BubbleAnalyzer } from './bubble-analyzer';
+import { PieAnalyzer } from './pie-analyzer';
+import { BarAnalyzer } from './bar-analyzer';
+import { LineAnalyzer } from './line-analyzer';
+import { RecommendationEngine } from './recommendation-engine';
+/**
+ * Top-level orchestrator that mirrors AG Grid's chart-range analysis pipeline:
+ *
+ *   selection → DimensionAnalyzer + MeasureAnalyzer
+ *             → RecommendationEngine (best chart type)
+ *             → chart-specific Analyzer (data shaping)
+ *             → AnalyzedChart (title + ChartData)
+ *
+ * Public API
+ * ----------
+ * analyze(ranges, rows, columns)
+ *   Returns the best-fit chart data for the current selection, or null when
+ *   the selection contains no numeric columns.
+ *
+ * analyzeForType(chartType, ranges, rows, columns)
+ *   Returns chart data shaped for the explicitly-requested chart type.
+ *
+ * recommend(ranges, rows, columns)
+ *   Returns a ranked list of ChartRecommendation objects so a UI can suggest
+ *   chart types to the user (future use / API extension).
+ */
+export class ChartAnalyzer {
+    constructor() {
+        // ── Sub-analyzers ────────────────────────────────────────────────────────
+        this.dimensionAnalyzer = new DimensionAnalyzer();
+        this.measureAnalyzer = new MeasureAnalyzer();
+        this.cardinalityAnalyzer = new CardinalityAnalyzer(); // public for potential external use
+        this.aggregationAnalyzer = new AggregationAnalyzer();
+        this.histogramAnalyzer = new HistogramAnalyzer();
+        this.scatterAnalyzer = new ScatterAnalyzer();
+        this.bubbleAnalyzer = new BubbleAnalyzer();
+        this.pieAnalyzer = new PieAnalyzer();
+        this.barAnalyzer = new BarAnalyzer();
+        this.lineAnalyzer = new LineAnalyzer();
+        this.recommendationEngine = new RecommendationEngine();
+    }
+    // ── Public API ───────────────────────────────────────────────────────────
+    /**
+     * Analyse a cell selection and return data shaped for the best chart type
+     * recommended by the RecommendationEngine, or null if no numeric data.
+     */
+    analyze(ranges, rows, columns) {
+        const ctx = this.buildContext(ranges, rows, columns);
+        if (!ctx)
+            return null;
+        const { dimensions, measures, selectedRows } = ctx;
+        if (!measures.length)
+            return null;
+        const recs = this.recommendationEngine.recommend(dimensions, measures);
+        const bestType = recs[0]?.chartType ?? 'column-grouped';
+        return this.dispatch(bestType, dimensions, measures, selectedRows);
+    }
+    /**
+     * Analyse a cell selection and return data shaped for the explicitly
+     * requested chart type.  Returns null if there are no numeric columns.
+     */
+    analyzeForType(chartType, ranges, rows, columns) {
+        const ctx = this.buildContext(ranges, rows, columns);
+        if (!ctx)
+            return null;
+        const { dimensions, measures, selectedRows } = ctx;
+        if (!measures.length)
+            return null;
+        return this.dispatch(chartType, dimensions, measures, selectedRows);
+    }
+    /**
+     * Return a ranked list of chart-type recommendations for the current
+     * selection. Useful for a "Recommended charts" panel (not yet in the UI).
+     */
+    recommend(ranges, rows, columns) {
+        const ctx = this.buildContext(ranges, rows, columns);
+        if (!ctx)
+            return [];
+        return this.recommendationEngine.recommend(ctx.dimensions, ctx.measures);
+    }
+    // ── Private helpers ──────────────────────────────────────────────────────
+    buildContext(ranges, rows, columns) {
+        if (!ranges.length || !rows.length || !columns.length)
+            return null;
+        const norm = normalizeRange(ranges[0]);
+        const selectedCols = columns.slice(norm.startColIndex, norm.endColIndex + 1);
+        const selectedRows = rows
+            .slice(norm.startRowIndex, norm.endRowIndex + 1)
+            .filter((r) => r.type === 'data');
+        if (!selectedRows.length || !selectedCols.length)
+            return null;
+        const dimensions = this.dimensionAnalyzer.analyze(selectedCols, selectedRows);
+        const measures = this.measureAnalyzer.analyze(selectedCols, selectedRows);
+        return { dimensions, measures, selectedRows, selectedCols };
+    }
+    dispatch(chartType, dimensions, measures, rows) {
+        switch (chartType) {
+            case 'pie':
+            case 'doughnut':
+                return this.pieAnalyzer.analyze(dimensions, measures, rows, this.aggregationAnalyzer);
+            case 'scatter':
+                return this.scatterAnalyzer.analyze(dimensions, measures, rows);
+            case 'bubble':
+                return this.bubbleAnalyzer.analyze(dimensions, measures, rows);
+            case 'line':
+            case 'area':
+                return this.lineAnalyzer.analyze(dimensions, measures, rows, this.aggregationAnalyzer);
+            case 'column-grouped':
+            case 'column-stacked':
+            case 'column-100stacked': {
+                // Single measure + no dimension → histogram (frequency distribution)
+                if (dimensions.length === 0 && measures.length === 1) {
+                    return this.histogramAnalyzer.analyze(measures);
+                }
+                return this.barAnalyzer.analyze(dimensions, measures, rows, this.aggregationAnalyzer);
+            }
+            default:
+                // bar-grouped, bar-stacked, bar-100stacked, funnel, polar
+                return this.barAnalyzer.analyze(dimensions, measures, rows, this.aggregationAnalyzer);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/chart/chart-analyzer/index.js.map

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

package/chart/chart-analyzer/line-analyzer.d.ts

@@ -0,0 +1,23 @@
+import type { RowNode } from '../../types/row.types';
+import type { DimensionInfo, MeasureInfo, AnalyzedChart } from './types';
+import type { AggregationAnalyzer } from './aggregation-analyzer';
+/**
+ * Builds data for line and area charts.
+ *
+ * Strategy:
+ *  • date dimension present  →  aggregate measures over the date axis;
+ *    produces a proper time-series with X labels from the date column.
+ *  • category dimension      →  same aggregation, labels from the dimension.
+ *  • no dimension            →  use row-index labels (1, 2, 3…), each row
+ *    is a separate data point with no aggregation.
+ *
+ * Titles:
+ *  • one measure + date dim  →  "Revenue over Date"
+ *  • one measure + category  →  "Revenue by Category"
+ *  • multiple measures       →  "Revenue & Profit"
+ */
+export declare class LineAnalyzer {
+    private static readonly MAX_POINTS_NO_DIM;
+    analyze(dimensions: DimensionInfo[], measures: MeasureInfo[], rows: RowNode[], agg: AggregationAnalyzer): AnalyzedChart | null;
+}
+//# sourceMappingURL=line-analyzer.d.ts.map

package/chart/chart-analyzer/line-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-analyzer.d.ts","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/line-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;;;;;;;;;;GAcG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAM;IAE/C,OAAO,CACL,UAAU,EAAE,aAAa,EAAE,EAC3B,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,EAAE,OAAO,EAAE,EACf,GAAG,EAAE,mBAAmB,GACvB,aAAa,GAAG,IAAI;CAkDxB"}

package/chart/chart-analyzer/line-analyzer.js

@@ -0,0 +1,61 @@
+import { APEX_COLORS } from './types';
+/**
+ * Builds data for line and area charts.
+ *
+ * Strategy:
+ *  • date dimension present  →  aggregate measures over the date axis;
+ *    produces a proper time-series with X labels from the date column.
+ *  • category dimension      →  same aggregation, labels from the dimension.
+ *  • no dimension            →  use row-index labels (1, 2, 3…), each row
+ *    is a separate data point with no aggregation.
+ *
+ * Titles:
+ *  • one measure + date dim  →  "Revenue over Date"
+ *  • one measure + category  →  "Revenue by Category"
+ *  • multiple measures       →  "Revenue & Profit"
+ */
+export class LineAnalyzer {
+    analyze(dimensions, measures, rows, agg) {
+        if (!measures.length)
+            return null;
+        // Prefer date dimension for a true time-series; fall back to first dimension
+        const dim = dimensions.find((d) => d.isDate) ?? dimensions[0] ?? null;
+        if (!dim) {
+            // Raw row-index series — good for trending visualisation without categories
+            const dataRows = rows.filter((r) => r.type === 'data').slice(0, LineAnalyzer.MAX_POINTS_NO_DIM);
+            const title = measures.map((m) => m.column.header).join(' & ');
+            return {
+                title,
+                data: {
+                    labels: dataRows.map((_, i) => String(i + 1)),
+                    datasets: measures.map((m, i) => ({
+                        label: m.column.header,
+                        data: dataRows.map((r) => {
+                            const v = Number(r.data[m.column.field]);
+                            return isNaN(v) ? 0 : v;
+                        }),
+                        color: APEX_COLORS[i % APEX_COLORS.length],
+                    })),
+                },
+            };
+        }
+        const aggregated = agg.aggregate(dim.column, measures.map((m) => m.column), rows);
+        const connector = dim.isDate ? 'over' : 'by';
+        const title = measures.length === 1
+            ? `${measures[0].column.header} ${connector} ${dim.column.header}`
+            : measures.map((m) => m.column.header).join(' & ');
+        return {
+            title,
+            data: {
+                labels: aggregated.labels,
+                datasets: measures.map((m, i) => ({
+                    label: m.column.header,
+                    data: aggregated.seriesData.get(m.column.field) ?? [],
+                    color: APEX_COLORS[i % APEX_COLORS.length],
+                })),
+            },
+        };
+    }
+}
+LineAnalyzer.MAX_POINTS_NO_DIM = 50;
+//# sourceMappingURL=line-analyzer.js.map

package/chart/chart-analyzer/line-analyzer.js.map

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

package/chart/chart-analyzer/measure-analyzer.d.ts

@@ -0,0 +1,11 @@
+import type { ColumnDef } from '../../types/column.types';
+import type { RowNode } from '../../types/row.types';
+import type { MeasureInfo } from './types';
+/**
+ * Identifies numeric columns (number, currency, percentage) and computes
+ * descriptive statistics used by chart-specific analyzers.
+ */
+export declare class MeasureAnalyzer {
+    analyze(columns: ColumnDef[], rows: RowNode[]): MeasureInfo[];
+}
+//# sourceMappingURL=measure-analyzer.d.ts.map

package/chart/chart-analyzer/measure-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-analyzer.d.ts","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/measure-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE;CAsC9D"}

package/chart/chart-analyzer/measure-analyzer.js

@@ -0,0 +1,44 @@
+import { MEASURE_TYPES } from './types';
+/**
+ * Identifies numeric columns (number, currency, percentage) and computes
+ * descriptive statistics used by chart-specific analyzers.
+ */
+export class MeasureAnalyzer {
+    analyze(columns, rows) {
+        const measCols = columns.filter((c) => MEASURE_TYPES.has(c.type));
+        return measCols.map((col) => {
+            const allValues = [];
+            for (const row of rows) {
+                if (row.type !== 'data')
+                    continue;
+                const v = Number(row.data[col.field]);
+                if (!isNaN(v))
+                    allValues.push(v);
+            }
+            if (!allValues.length) {
+                return { column: col, min: 0, max: 0, sum: 0, avg: 0, count: 0, hasNegatives: false, allValues };
+            }
+            let min = allValues[0];
+            let max = allValues[0];
+            let sum = 0;
+            for (const v of allValues) {
+                if (v < min)
+                    min = v;
+                if (v > max)
+                    max = v;
+                sum += v;
+            }
+            return {
+                column: col,
+                min,
+                max,
+                sum,
+                avg: sum / allValues.length,
+                count: allValues.length,
+                hasNegatives: min < 0,
+                allValues,
+            };
+        });
+    }
+}
+//# sourceMappingURL=measure-analyzer.js.map

package/chart/chart-analyzer/measure-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-analyzer.js","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/measure-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC;;;GAGG;AACH,MAAM,OAAO,eAAe;IAC1B,OAAO,CAAC,OAAoB,EAAE,IAAe;QAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC,CAAC;QAE5E,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC1B,MAAM,SAAS,GAAa,EAAE,CAAC;YAE/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;oBAAE,SAAS;gBAClC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;oBAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnC,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;YACnG,CAAC;YAED,IAAI,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACvB,IAAI,GAAG,GAAG,CAAC,CAAC;YAEZ,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,GAAG,GAAG;oBAAE,GAAG,GAAG,CAAC,CAAC;gBACrB,IAAI,CAAC,GAAG,GAAG;oBAAE,GAAG,GAAG,CAAC,CAAC;gBACrB,GAAG,IAAI,CAAC,CAAC;YACX,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,GAAG;gBACX,GAAG;gBACH,GAAG;gBACH,GAAG;gBACH,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC,MAAM;gBAC3B,KAAK,EAAE,SAAS,CAAC,MAAM;gBACvB,YAAY,EAAE,GAAG,GAAG,CAAC;gBACrB,SAAS;aACV,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/chart/chart-analyzer/pie-analyzer.d.ts

@@ -0,0 +1,19 @@
+import type { RowNode } from '../../types/row.types';
+import type { DimensionInfo, MeasureInfo, AnalyzedChart } from './types';
+import type { AggregationAnalyzer } from './aggregation-analyzer';
+/**
+ * Builds pie / doughnut chart data.
+ *
+ * Strategy:
+ *  • 1 dimension + 1 measure  →  aggregate measure by dimension, top-N slices
+ *    with an "Other (n)" remainder slice when the category count exceeds
+ *    PIE_MAX_SLICES.
+ *  • No dimension  →  treat the first PIE_MAX_SLICES rows as individual slices.
+ *
+ * Slices are sorted by value (descending) so the largest segment always
+ * appears first at the 12-o'clock position in the renderer.
+ */
+export declare class PieAnalyzer {
+    analyze(dimensions: DimensionInfo[], measures: MeasureInfo[], rows: RowNode[], agg: AggregationAnalyzer): AnalyzedChart | null;
+}
+//# sourceMappingURL=pie-analyzer.d.ts.map

package/chart/chart-analyzer/pie-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pie-analyzer.d.ts","sourceRoot":"","sources":["../../../src/chart/chart-analyzer/pie-analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW;IACtB,OAAO,CACL,UAAU,EAAE,aAAa,EAAE,EAC3B,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,EAAE,OAAO,EAAE,EACf,GAAG,EAAE,mBAAmB,GACvB,aAAa,GAAG,IAAI;CAsDxB"}

package/chart/chart-analyzer/pie-analyzer.js

@@ -0,0 +1,64 @@
+import { APEX_COLORS, PIE_MAX_SLICES } from './types';
+/**
+ * Builds pie / doughnut chart data.
+ *
+ * Strategy:
+ *  • 1 dimension + 1 measure  →  aggregate measure by dimension, top-N slices
+ *    with an "Other (n)" remainder slice when the category count exceeds
+ *    PIE_MAX_SLICES.
+ *  • No dimension  →  treat the first PIE_MAX_SLICES rows as individual slices.
+ *
+ * Slices are sorted by value (descending) so the largest segment always
+ * appears first at the 12-o'clock position in the renderer.
+ */
+export class PieAnalyzer {
+    analyze(dimensions, measures, rows, agg) {
+        if (!measures.length)
+            return null;
+        const dim = dimensions[0] ?? null;
+        const measure = measures[0];
+        if (!dim) {
+            // Dimensionless: show raw values of the first measure
+            const sliceRows = rows.filter((r) => r.type === 'data').slice(0, PIE_MAX_SLICES);
+            return {
+                title: `${measure.column.header} Distribution`,
+                data: {
+                    labels: sliceRows.map((_, i) => `Row ${i + 1}`),
+                    datasets: [{
+                            label: measure.column.header,
+                            data: sliceRows.map((r) => {
+                                const v = Number(r.data[measure.column.field]);
+                                return isNaN(v) ? 0 : v;
+                            }),
+                            color: APEX_COLORS[0],
+                        }],
+                },
+            };
+        }
+        // Aggregate measure by dimension
+        const aggregated = agg.aggregate(dim.column, [measure.column], rows);
+        const measureData = aggregated.seriesData.get(measure.column.field) ?? [];
+        // Pair labels with values, sort descending
+        const pairs = aggregated.labels
+            .map((label, i) => ({ label, value: measureData[i] ?? 0 }))
+            .sort((a, b) => b.value - a.value);
+        let topSlices = pairs.slice(0, PIE_MAX_SLICES);
+        const remainder = pairs.slice(PIE_MAX_SLICES);
+        if (remainder.length > 0) {
+            const otherSum = remainder.reduce((s, p) => s + p.value, 0);
+            topSlices.push({ label: `Other (${remainder.length})`, value: otherSum });
+        }
+        return {
+            title: `${measure.column.header} by ${dim.column.header}`,
+            data: {
+                labels: topSlices.map((s) => s.label),
+                datasets: [{
+                        label: measure.column.header,
+                        data: topSlices.map((s) => s.value),
+                        color: APEX_COLORS[0],
+                    }],
+            },
+        };
+    }
+}
+//# sourceMappingURL=pie-analyzer.js.map