@sentropic/dataviz-core 0.1.0 → 0.2.1

package/dist/aggregate.d.ts

@@ -2,8 +2,8 @@
  * Grouping and aggregation primitives.
  *
  * All functions are pure and side-effect free. Aggregations guard against
- * non-finite numbers (NaN, Infinity) and return a sensible neutral value for
- * an empty input.
+ * non-finite numbers (NaN, Infinity). Empty sum/count return 0; empty
+ * avg/min/max return NaN so callers can distinguish "no data" from a real 0.
  */
 import type { Aggregation, Measure, Row } from './model.js';
 /**
@@ -19,8 +19,8 @@ export declare function groupBy(rows: Row[], dimensionId: string): Map<string, R
  *
  * - `count` counts *rows* (not non-null values) — it returns `rows.length`.
  * - `sum`/`avg`/`min`/`max` ignore non-finite / non-numeric cells.
- * - An empty input (or one with no numeric cells) returns the neutral value:
- *   `0` for sum/avg/count, `0` for min/max with no data.
+ * - An empty input (or one with no numeric cells) returns `0` for sum/count
+ *   and `NaN` for avg/min/max.
  */
 export declare function aggregate(rows: Row[], measure: Measure): number;
 /** Lower-level helper: aggregate a raw value array by aggregation kind. */

package/dist/aggregate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../src/aggregate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAa5E;AAiBD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE/D;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,WAAW,EACxB,QAAQ,SAAgB,GACvB,MAAM,CAkBR;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAOnE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,GAAG,EAAE,EACX,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GACf,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAOvC"}
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../src/aggregate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAa5E;AAiBD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAE/D;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,WAAW,EACxB,QAAQ,SAAgB,GACvB,MAAM,CAwBR;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAOnE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,GAAG,EAAE,EACX,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GACf,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAOvC"}

package/dist/aggregate.js

@@ -2,8 +2,8 @@
  * Grouping and aggregation primitives.
  *
  * All functions are pure and side-effect free. Aggregations guard against
- * non-finite numbers (NaN, Infinity) and return a sensible neutral value for
- * an empty input.
+ * non-finite numbers (NaN, Infinity). Empty sum/count return 0; empty
+ * avg/min/max return NaN so callers can distinguish "no data" from a real 0.
  */
 /**
  * Partition rows by the distinct value of `dimensionId`.
@@ -46,8 +46,8 @@ function toFinite(value) {
  *
  * - `count` counts *rows* (not non-null values) — it returns `rows.length`.
  * - `sum`/`avg`/`min`/`max` ignore non-finite / non-numeric cells.
- * - An empty input (or one with no numeric cells) returns the neutral value:
- *   `0` for sum/avg/count, `0` for min/max with no data.
+ * - An empty input (or one with no numeric cells) returns `0` for sum/count
+ *   and `NaN` for avg/min/max.
  */
 export function aggregate(rows, measure) {
     return aggregateValues(extractNumbers(rows, measure.id), measure.aggregation, rows.length);
@@ -60,11 +60,17 @@ export function aggregateValues(values, aggregation, rowCount = values.length) {
         case 'sum':
             return values.reduce((acc, v) => acc + v, 0);
         case 'avg':
-            return values.length === 0 ? 0 : values.reduce((acc, v) => acc + v, 0) / values.length;
+            return values.length === 0
+                ? Number.NaN
+                : values.reduce((acc, v) => acc + v, 0) / values.length;
         case 'min':
-            return values.length === 0 ? 0 : values.reduce((acc, v) => (v < acc ? v : acc), values[0]);
+            return values.length === 0
+                ? Number.NaN
+                : values.reduce((acc, v) => (v < acc ? v : acc), values[0]);
         case 'max':
-            return values.length === 0 ? 0 : values.reduce((acc, v) => (v > acc ? v : acc), values[0]);
+            return values.length === 0
+                ? Number.NaN
+                : values.reduce((acc, v) => (v > acc ? v : acc), values[0]);
         default: {
             // Exhaustiveness guard — unreachable for a valid Aggregation.
             const _never = aggregation;

package/dist/aggregate.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../src/aggregate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAW,EAAE,WAAmB;IACtD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6EAA6E;AAC7E,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,IAAW,EAAE,OAAgB;IACrD,OAAO,eAAe,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7F,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAC7B,MAAgB,EAChB,WAAwB,EACxB,QAAQ,GAAG,MAAM,CAAC,MAAM;IAExB,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC;QAClB,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACzF,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;QAC9F,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;QAC9F,OAAO,CAAC,CAAC,CAAC;YACR,8DAA8D;YAC9D,MAAM,MAAM,GAAU,WAAW,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;AACH,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,IAAW,EAAE,KAAa;IACvD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAW,EACX,WAAmB,EACnB,OAAgB;IAEhB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC1C,MAAM,GAAG,GAA0C,EAAE,CAAC;IACtD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"aggregate.js","sourceRoot":"","sources":["../src/aggregate.ts"],"names":[],"mappings":"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"}

package/dist/analytics.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Analytic overlay data contracts.
+ *
+ * These builders compute values for overlays such as reference/goal lines,
+ * percentile bands, trend lines and error bars. Rendering belongs to the DS.
+ */
+import type { DataModel, Row } from './model.js';
+export interface ReferenceLineConfig {
+    id?: string;
+    label?: string;
+    value?: number;
+    measure?: string;
+}
+export interface ReferenceLineModel {
+    id: string;
+    label: string;
+    value: number;
+    source: 'static' | 'measure';
+    measureId?: string;
+}
+export interface PercentileBandConfig {
+    value: string;
+    lower: number;
+    upper: number;
+}
+export interface PercentileBandModel {
+    valueId: string;
+    lowerPercentile: number;
+    upperPercentile: number;
+    lowerValue: number;
+    upperValue: number;
+    median: number;
+}
+export interface TrendLineConfig {
+    x: string;
+    y: string;
+}
+export interface TrendPoint {
+    x: number;
+    y: number;
+}
+export interface TrendLineModel {
+    xId: string;
+    yId: string;
+    slope: number;
+    intercept: number;
+    rSquared: number;
+    points: TrendPoint[];
+}
+export interface ForecastConfig {
+    x: string;
+    y: string;
+    periods: number;
+    step?: number;
+}
+export interface ForecastModel {
+    xId: string;
+    yId: string;
+    method: 'linear';
+    slope: number;
+    intercept: number;
+    points: TrendPoint[];
+}
+export interface ErrorBarsConfig {
+    category: string;
+    value: string;
+    interval?: 'stdev' | 'stderr';
+}
+export interface ErrorBarItem {
+    key: string;
+    label: string;
+    count: number;
+    mean: number;
+    stdev: number;
+    lower: number;
+    upper: number;
+}
+export interface ErrorBarsModel {
+    categoryId: string;
+    valueId: string;
+    interval: 'stdev' | 'stderr';
+    items: ErrorBarItem[];
+}
+export interface AnalyticsClusterConfig {
+    fields: string[];
+    k: number;
+    maxIterations?: number;
+}
+export interface AnalyticsCluster {
+    id: string;
+    centroid: Record<string, number>;
+    count: number;
+    rowIndices: number[];
+}
+export interface AnalyticsClusterModel {
+    fields: string[];
+    clusters: AnalyticsCluster[];
+}
+export declare function buildReferenceLineModel(model: DataModel, data: readonly Row[], config: ReferenceLineConfig): ReferenceLineModel;
+export declare function buildPercentileBandModel(model: DataModel, data: readonly Row[], config: PercentileBandConfig): PercentileBandModel;
+export declare function buildTrendLineModel(model: DataModel, data: readonly Row[], config: TrendLineConfig): TrendLineModel;
+export declare function buildForecastModel(model: DataModel, data: readonly Row[], config: ForecastConfig): ForecastModel;
+export declare function buildErrorBarsModel(model: DataModel, data: readonly Row[], config: ErrorBarsConfig): ErrorBarsModel;
+export declare function buildAnalyticsClusterModel(model: DataModel, data: readonly Row[], config: AnalyticsClusterConfig): AnalyticsClusterModel;
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

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

package/dist/analytics.js

@@ -0,0 +1,323 @@
+/**
+ * Analytic overlay data contracts.
+ *
+ * These builders compute values for overlays such as reference/goal lines,
+ * percentile bands, trend lines and error bars. Rendering belongs to the DS.
+ */
+import { aggregate, extractNumbers } from './aggregate.js';
+import { findDimension, findMeasure } from './model.js';
+function cellKey(value) {
+    return value == null ? 'null' : String(value);
+}
+function toFiniteNumber(value) {
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : undefined;
+    if (typeof value === 'string' && value.trim() !== '') {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+}
+function assertValueField(model, id, role) {
+    if (!findMeasure(model, id) && !findDimension(model, id)) {
+        throw new Error(`Unknown ${role} field: ${id}`);
+    }
+}
+function resolveMeasure(model, id, role) {
+    const measure = findMeasure(model, id);
+    if (!measure) {
+        throw new Error(`Unknown ${role} measure: ${id}`);
+    }
+    return measure;
+}
+function assertDimension(model, id, role) {
+    if (!findDimension(model, id)) {
+        throw new Error(`Unknown ${role} dimension: ${id}`);
+    }
+}
+function assertPercentile(value, label) {
+    if (!Number.isFinite(value) || value < 0 || value > 1) {
+        throw new Error(`${label} percentile must be between 0 and 1`);
+    }
+}
+function quantile(sorted, p) {
+    if (sorted.length === 0)
+        return Number.NaN;
+    const position = (sorted.length - 1) * p;
+    const base = Math.floor(position);
+    const rest = position - base;
+    const current = sorted[base];
+    const next = sorted[base + 1] ?? current;
+    return current + rest * (next - current);
+}
+function groupRows(rows, field) {
+    const groups = new Map();
+    for (const row of rows) {
+        const key = cellKey(row[field]);
+        const bucket = groups.get(key);
+        if (bucket) {
+            bucket.push(row);
+        }
+        else {
+            groups.set(key, [row]);
+        }
+    }
+    return groups;
+}
+function mean(values) {
+    return values.length === 0
+        ? Number.NaN
+        : values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+function sampleStdev(values, avg) {
+    if (values.length <= 1)
+        return 0;
+    const variance = values.reduce((sum, value) => sum + (value - avg) ** 2, 0) / (values.length - 1);
+    return Math.sqrt(variance);
+}
+function assertPositiveInteger(value, message) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(message);
+    }
+}
+function numericPairs(data, xField, yField) {
+    return data
+        .map((row) => {
+        const x = toFiniteNumber(row[xField]);
+        const y = toFiniteNumber(row[yField]);
+        return x === undefined || y === undefined ? undefined : { x, y };
+    })
+        .filter((point) => point !== undefined);
+}
+export function buildReferenceLineModel(model, data, config) {
+    if (config.value !== undefined) {
+        if (!Number.isFinite(config.value)) {
+            throw new Error('Reference line value must be finite');
+        }
+        const label = config.label ?? 'Reference';
+        return {
+            id: config.id ?? `reference:${label}`,
+            label,
+            value: config.value,
+            source: 'static',
+        };
+    }
+    if (config.measure === undefined) {
+        throw new Error('Reference line requires either value or measure');
+    }
+    const measure = resolveMeasure(model, config.measure, 'reference line');
+    return {
+        id: config.id ?? `reference:${measure.id}`,
+        label: config.label ?? measure.label,
+        value: aggregate([...data], measure),
+        source: 'measure',
+        measureId: measure.id,
+    };
+}
+export function buildPercentileBandModel(model, data, config) {
+    assertValueField(model, config.value, 'percentile band value');
+    assertPercentile(config.lower, 'Lower');
+    assertPercentile(config.upper, 'Upper');
+    if (config.lower > config.upper) {
+        throw new Error('Percentile band requires lower <= upper');
+    }
+    const values = extractNumbers([...data], config.value).sort((a, b) => a - b);
+    return {
+        valueId: config.value,
+        lowerPercentile: config.lower,
+        upperPercentile: config.upper,
+        lowerValue: quantile(values, config.lower),
+        upperValue: quantile(values, config.upper),
+        median: quantile(values, 0.5),
+    };
+}
+export function buildTrendLineModel(model, data, config) {
+    assertValueField(model, config.x, 'trend x');
+    assertValueField(model, config.y, 'trend y');
+    const points = numericPairs(data, config.x, config.y);
+    if (points.length < 2) {
+        return {
+            xId: config.x,
+            yId: config.y,
+            slope: Number.NaN,
+            intercept: Number.NaN,
+            rSquared: Number.NaN,
+            points: [],
+        };
+    }
+    const xMean = mean(points.map((point) => point.x));
+    const yMean = mean(points.map((point) => point.y));
+    const sxx = points.reduce((sum, point) => sum + (point.x - xMean) ** 2, 0);
+    const sxy = points.reduce((sum, point) => sum + (point.x - xMean) * (point.y - yMean), 0);
+    const slope = sxx === 0 ? Number.NaN : sxy / sxx;
+    const intercept = yMean - slope * xMean;
+    const sst = points.reduce((sum, point) => sum + (point.y - yMean) ** 2, 0);
+    const sse = points.reduce((sum, point) => {
+        const predicted = intercept + slope * point.x;
+        return sum + (point.y - predicted) ** 2;
+    }, 0);
+    const rSquared = sst === 0 ? 1 : 1 - sse / sst;
+    const minX = Math.min(...points.map((point) => point.x));
+    const maxX = Math.max(...points.map((point) => point.x));
+    return {
+        xId: config.x,
+        yId: config.y,
+        slope,
+        intercept,
+        rSquared,
+        points: [
+            { x: minX, y: intercept + slope * minX },
+            { x: maxX, y: intercept + slope * maxX },
+        ],
+    };
+}
+export function buildForecastModel(model, data, config) {
+    assertPositiveInteger(config.periods, 'Forecast periods must be a positive integer');
+    if (config.step !== undefined && (!Number.isFinite(config.step) || config.step <= 0)) {
+        throw new Error('Forecast step must be a positive finite number');
+    }
+    const trend = buildTrendLineModel(model, data, { x: config.x, y: config.y });
+    const points = numericPairs(data, config.x, config.y);
+    if (!Number.isFinite(trend.slope) || points.length === 0) {
+        return {
+            xId: config.x,
+            yId: config.y,
+            method: 'linear',
+            slope: trend.slope,
+            intercept: trend.intercept,
+            points: [],
+        };
+    }
+    const sortedX = points.map((point) => point.x).sort((a, b) => a - b);
+    const maxX = sortedX[sortedX.length - 1];
+    const inferredStep = sortedX.length <= 1 ? 1 : (sortedX[sortedX.length - 1] - sortedX[0]) / (sortedX.length - 1);
+    const step = config.step ?? (inferredStep > 0 ? inferredStep : 1);
+    return {
+        xId: config.x,
+        yId: config.y,
+        method: 'linear',
+        slope: trend.slope,
+        intercept: trend.intercept,
+        points: Array.from({ length: config.periods }, (_, index) => {
+            const x = maxX + step * (index + 1);
+            return { x, y: trend.intercept + trend.slope * x };
+        }),
+    };
+}
+export function buildErrorBarsModel(model, data, config) {
+    assertDimension(model, config.category, 'error bars category');
+    assertValueField(model, config.value, 'error bars value');
+    const interval = config.interval ?? 'stdev';
+    if (interval !== 'stdev' && interval !== 'stderr') {
+        throw new Error('Error bars interval must be stdev or stderr');
+    }
+    return {
+        categoryId: config.category,
+        valueId: config.value,
+        interval,
+        items: Array.from(groupRows(data, config.category), ([key, rows]) => {
+            const values = extractNumbers(rows, config.value);
+            const avg = mean(values);
+            const stdev = sampleStdev(values, avg);
+            const offset = interval === 'stderr' ? stdev / Math.sqrt(values.length) : stdev;
+            return {
+                key,
+                label: key,
+                count: values.length,
+                mean: avg,
+                stdev,
+                lower: avg - offset,
+                upper: avg + offset,
+            };
+        }),
+    };
+}
+function clusterPoints(data, fields) {
+    const points = [];
+    data.forEach((row, rowIndex) => {
+        const vector = [];
+        const values = {};
+        for (const field of fields) {
+            const value = toFiniteNumber(row[field]);
+            if (value === undefined)
+                return;
+            vector.push(value);
+            values[field] = value;
+        }
+        points.push({ rowIndex, values, vector });
+    });
+    return points;
+}
+function squaredDistance(a, b) {
+    return a.reduce((sum, value, index) => sum + (value - b[index]) ** 2, 0);
+}
+function nearestCentroid(point, centroids) {
+    let bestIndex = 0;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    centroids.forEach((centroid, index) => {
+        const distance = squaredDistance(point.vector, centroid);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            bestIndex = index;
+        }
+    });
+    return bestIndex;
+}
+function centroidObject(fields, vector) {
+    const out = {};
+    fields.forEach((field, index) => {
+        out[field] = vector[index];
+    });
+    return out;
+}
+export function buildAnalyticsClusterModel(model, data, config) {
+    if (config.fields.length === 0) {
+        throw new Error('Analytics cluster requires at least one field');
+    }
+    for (const field of config.fields) {
+        assertValueField(model, field, 'analytics cluster');
+    }
+    assertPositiveInteger(config.k, 'Analytics cluster k must be a positive integer');
+    const maxIterations = config.maxIterations ?? 20;
+    assertPositiveInteger(maxIterations, 'Analytics cluster maxIterations must be a positive integer');
+    const points = clusterPoints(data, config.fields);
+    if (points.length < config.k) {
+        throw new Error('Analytics cluster k cannot exceed available complete rows');
+    }
+    let centroids = points.slice(0, config.k).map((point) => [...point.vector]);
+    let assignments = points.map(() => -1);
+    for (let iteration = 0; iteration < maxIterations; iteration += 1) {
+        const nextAssignments = points.map((point) => nearestCentroid(point, centroids));
+        const changed = nextAssignments.some((assignment, index) => assignment !== assignments[index]);
+        assignments = nextAssignments;
+        const sums = Array.from({ length: config.k }, () => Array.from({ length: config.fields.length }, () => 0));
+        const counts = Array.from({ length: config.k }, () => 0);
+        points.forEach((point, index) => {
+            const clusterIndex = assignments[index];
+            counts[clusterIndex] += 1;
+            point.vector.forEach((value, fieldIndex) => {
+                sums[clusterIndex][fieldIndex] += value;
+            });
+        });
+        centroids = centroids.map((centroid, clusterIndex) => counts[clusterIndex] === 0
+            ? centroid
+            : sums[clusterIndex].map((sum) => sum / counts[clusterIndex]));
+        if (!changed)
+            break;
+    }
+    return {
+        fields: [...config.fields],
+        clusters: centroids.map((centroid, clusterIndex) => {
+            const rowIndices = points
+                .filter((_, index) => assignments[index] === clusterIndex)
+                .map((point) => point.rowIndex);
+            return {
+                id: `cluster:${clusterIndex}`,
+                centroid: centroidObject(config.fields, centroid),
+                count: rowIndices.length,
+                rowIndices,
+            };
+        }),
+    };
+}
+//# sourceMappingURL=analytics.js.map

package/dist/analytics.js.map

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

package/dist/categorical.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Categorical/combo chart data contracts.
+ *
+ * This is the rendering-agnostic series model that DS chart components can
+ * consume or adapt for grouped bars, stacked bars, line/area combos, 100 %
+ * stacks, Pareto views and diverging bars.
+ */
+import type { DataModel, Measure, Row } from './model.js';
+export type CategoricalMark = 'bar' | 'line' | 'area';
+export type CategoricalAxis = 'left' | 'right';
+export type CategoricalMode = 'grouped' | 'stacked' | 'stacked-100';
+export type CategoricalMeasureInput = string | {
+    id: string;
+    mark?: CategoricalMark;
+    axis?: CategoricalAxis;
+};
+export interface CategoricalSeriesConfig {
+    category: string;
+    series?: string;
+    measures: CategoricalMeasureInput[];
+    mode?: CategoricalMode;
+}
+export interface CategoricalMeasure {
+    measure: Measure;
+    mark: CategoricalMark;
+    axis: CategoricalAxis;
+}
+export interface CategoricalSeries {
+    id: string;
+    label: string;
+    measureId: string;
+    seriesKey?: string;
+    seriesLabel?: string;
+    mark: CategoricalMark;
+    axis: CategoricalAxis;
+    values: number[];
+}
+export interface CategoricalSeriesModel {
+    categories: string[];
+    mode: CategoricalMode;
+    series: CategoricalSeries[];
+}
+export interface ParetoConfig {
+    category: string;
+    measure: string;
+}
+export interface ParetoItem {
+    key: string;
+    label: string;
+    value: number;
+    rank: number;
+    cumulativeValue: number;
+    cumulativePercent: number;
+}
+export interface ParetoModel {
+    categoryId: string;
+    measureId: string;
+    total: number;
+    items: ParetoItem[];
+}
+export type DivergingDirection = 'positive' | 'negative' | 'neutral';
+export interface DivergingBarConfig {
+    category: string;
+    measure: string;
+}
+export interface DivergingBarItem {
+    key: string;
+    label: string;
+    value: number;
+    start: number;
+    end: number;
+    direction: DivergingDirection;
+}
+export interface DivergingBarModel {
+    categoryId: string;
+    measureId: string;
+    baseline: 0;
+    domain: [number, number];
+    items: DivergingBarItem[];
+}
+export declare function buildCategoricalSeries(model: DataModel, data: readonly Row[], config: CategoricalSeriesConfig): CategoricalSeriesModel;
+export declare function buildParetoModel(model: DataModel, data: readonly Row[], config: ParetoConfig): ParetoModel;
+export declare function buildDivergingBarModel(model: DataModel, data: readonly Row[], config: DivergingBarConfig): DivergingBarModel;
+//# sourceMappingURL=categorical.d.ts.map

package/dist/categorical.d.ts.map

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