photon-grid-core 0.0.3 → 1.0.1

package/chart/model/chart-model.d.ts

@@ -0,0 +1,153 @@
+import type { CellRange } from '../../types/grid.types';
+import type { ChartPanelType } from '../chart-panel';
+/**
+ * How multiple grid rows sharing a category value are collapsed into a single
+ * chart data point.
+ *
+ * - `sum` / `avg` / `count` / `min` / `max` — standard reductions.
+ * - `none` — no aggregation: every selected data row becomes its own category
+ *   (matches AG Grid's "Aggregate" toggle in the off position).
+ */
+export type ChartAggregation = 'sum' | 'avg' | 'count' | 'min' | 'max' | 'none';
+/** Placement of the series legend relative to the plot area. */
+export type LegendPosition = 'top' | 'bottom' | 'left' | 'right';
+/** Horizontal text alignment used by titles and subtitles. */
+export type TextAlign = 'left' | 'center' | 'right';
+/**
+ * Title / subtitle configuration. All fields are optional; an empty or absent
+ * {@link TitleOptions.text} suppresses the band entirely and reclaims its space.
+ */
+export interface TitleOptions {
+    readonly text?: string;
+    readonly color?: string;
+    readonly fontSize?: number;
+    readonly align?: TextAlign;
+}
+/** Legend visibility and placement. */
+export interface LegendOptions {
+    readonly enabled: boolean;
+    readonly position: LegendPosition;
+}
+/** Per-axis presentation. Colors are optional so they can fall back to theme tokens. */
+export interface AxisOptions {
+    readonly title?: string;
+    readonly titleColor?: string;
+    readonly labelColor?: string;
+    readonly lineColor?: string;
+    readonly showGridLines?: boolean;
+    readonly showTicks?: boolean;
+    readonly showLabels?: boolean;
+}
+/**
+ * Series styling. {@link SeriesStyle.colorByKey} maps a series' column id (or
+ * label) to an explicit color override; unmapped series fall back to the theme
+ * palette. Stroke / fill apply to line and area series.
+ */
+export interface SeriesStyle {
+    readonly colorByKey: Readonly<Record<string, string>>;
+    readonly strokeWidth?: number;
+    readonly fillOpacity?: number;
+}
+/** Chart-wide presentation not tied to a specific axis or series. */
+export interface ChartStyleOptions {
+    readonly backgroundColor?: string;
+    readonly fontFamily?: string;
+    readonly fontSize?: number;
+}
+/**
+ * The complete, serializable definition of a range chart. This is the single
+ * source of truth a {@link RangeChartController} renders from — it can be read
+ * via `api.getChartModels()` and re-applied via `api.restoreChart(model)`.
+ *
+ * The model is treated as immutable: mutations go through {@link applyModelChange},
+ * which returns a new frozen instance rather than editing in place.
+ */
+export interface ChartModel {
+    /** Stable identifier, unique within a grid. */
+    readonly chartId: string;
+    /** Concrete chart type drawn by the renderer. */
+    readonly chartType: ChartPanelType;
+    /** The grid cell range the chart was created from. */
+    readonly cellRange: CellRange;
+    /**
+     * Column ids that form the chart's candidate pool — the union of every source
+     * cell range's columns, in visible order. Drives which columns the Set Up tab
+     * offers for the category and series roles, so non-contiguous multi-range
+     * selections are represented faithfully (not just the bounding {@link cellRange}).
+     */
+    readonly chartColIds: readonly string[];
+    /** Column id whose values form the category (x) axis. */
+    readonly categoryColId: string;
+    /** Column ids plotted as series (one dataset each). */
+    readonly seriesColIds: readonly string[];
+    /** Aggregation applied when rows share a category value. */
+    readonly aggregation: ChartAggregation;
+    /** When `true`, categories and series are transposed. */
+    readonly switchCategorySeries: boolean;
+    /**
+     * When `true` the chart is detached from the grid: it no longer re-renders on
+     * data / sort / filter changes and keeps its last-built snapshot.
+     */
+    readonly unlinked: boolean;
+    readonly title: TitleOptions;
+    readonly subtitle: TitleOptions;
+    readonly legend: LegendOptions;
+    readonly xAxis: AxisOptions;
+    readonly yAxis: AxisOptions;
+    readonly series: SeriesStyle;
+    readonly style: ChartStyleOptions;
+}
+/** The subset of {@link ChartModel} a caller must supply to build a default. */
+export interface ChartModelSeed {
+    readonly chartId: string;
+    readonly chartType: ChartPanelType;
+    readonly cellRange: CellRange;
+    readonly categoryColId: string;
+    readonly seriesColIds: readonly string[];
+    /** Candidate column pool. Defaults to the category plus every series column. */
+    readonly chartColIds?: readonly string[];
+    readonly aggregation?: ChartAggregation;
+    readonly title?: string;
+}
+/**
+ * Builds a fully-populated {@link ChartModel} from the minimal information
+ * available at creation time, filling every optional section with sensible
+ * defaults. The returned model is deep-frozen.
+ *
+ * @param seed - Identity, type, range and column roles for the new chart.
+ * @returns A frozen, ready-to-render chart model.
+ */
+export declare function createDefaultChartModel(seed: ChartModelSeed): ChartModel;
+/**
+ * Produces a new {@link ChartModel} with `patch` applied over `model`. Nested
+ * object sections (title, legend, axes, series, style) are shallow-merged so a
+ * caller can patch a single field without restating the whole section. The
+ * result is deep-frozen; the input is never mutated.
+ *
+ * @param model - The current model.
+ * @param patch - Partial fields to overlay. Nested sections merge; scalars replace.
+ * @returns A new frozen model.
+ */
+export declare function applyModelChange(model: ChartModel, patch: ChartModelPatch): ChartModel;
+/**
+ * A partial chart model used by {@link applyModelChange}. Every top-level field
+ * and nested section is optional and independently patchable.
+ */
+export interface ChartModelPatch {
+    readonly chartType?: ChartPanelType;
+    readonly cellRange?: CellRange;
+    readonly chartColIds?: readonly string[];
+    readonly categoryColId?: string;
+    readonly seriesColIds?: readonly string[];
+    readonly aggregation?: ChartAggregation;
+    readonly switchCategorySeries?: boolean;
+    readonly unlinked?: boolean;
+    readonly title?: Partial<TitleOptions>;
+    readonly subtitle?: Partial<TitleOptions>;
+    readonly legend?: Partial<LegendOptions>;
+    readonly xAxis?: Partial<AxisOptions>;
+    readonly yAxis?: Partial<AxisOptions>;
+    readonly series?: Partial<SeriesStyle>;
+    readonly style?: Partial<ChartStyleOptions>;
+}
+//# sourceMappingURL=chart-model.d.ts.map

package/chart/model/chart-model.d.ts.map

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

package/chart/model/chart-model.js

@@ -0,0 +1,79 @@
+/**
+ * Builds a fully-populated {@link ChartModel} from the minimal information
+ * available at creation time, filling every optional section with sensible
+ * defaults. The returned model is deep-frozen.
+ *
+ * @param seed - Identity, type, range and column roles for the new chart.
+ * @returns A frozen, ready-to-render chart model.
+ */
+export function createDefaultChartModel(seed) {
+    const model = {
+        chartId: seed.chartId,
+        chartType: seed.chartType,
+        cellRange: seed.cellRange,
+        chartColIds: seed.chartColIds
+            ? [...seed.chartColIds]
+            : [seed.categoryColId, ...seed.seriesColIds],
+        categoryColId: seed.categoryColId,
+        seriesColIds: [...seed.seriesColIds],
+        aggregation: seed.aggregation ?? 'sum',
+        switchCategorySeries: false,
+        unlinked: false,
+        title: { text: seed.title ?? '', align: 'left' },
+        subtitle: { text: '', align: 'left' },
+        legend: { enabled: seed.seriesColIds.length > 1, position: 'bottom' },
+        xAxis: { showGridLines: false, showTicks: true, showLabels: true },
+        yAxis: { showGridLines: true, showTicks: true, showLabels: true },
+        series: { colorByKey: {}, strokeWidth: 2, fillOpacity: 0.4 },
+        style: {},
+    };
+    return deepFreeze(model);
+}
+/**
+ * Produces a new {@link ChartModel} with `patch` applied over `model`. Nested
+ * object sections (title, legend, axes, series, style) are shallow-merged so a
+ * caller can patch a single field without restating the whole section. The
+ * result is deep-frozen; the input is never mutated.
+ *
+ * @param model - The current model.
+ * @param patch - Partial fields to overlay. Nested sections merge; scalars replace.
+ * @returns A new frozen model.
+ */
+export function applyModelChange(model, patch) {
+    const next = {
+        ...model,
+        ...patch,
+        chartColIds: patch.chartColIds ? [...patch.chartColIds] : model.chartColIds,
+        seriesColIds: patch.seriesColIds ? [...patch.seriesColIds] : model.seriesColIds,
+        title: patch.title ? { ...model.title, ...patch.title } : model.title,
+        subtitle: patch.subtitle ? { ...model.subtitle, ...patch.subtitle } : model.subtitle,
+        legend: patch.legend ? { ...model.legend, ...patch.legend } : model.legend,
+        xAxis: patch.xAxis ? { ...model.xAxis, ...patch.xAxis } : model.xAxis,
+        yAxis: patch.yAxis ? { ...model.yAxis, ...patch.yAxis } : model.yAxis,
+        series: patch.series ? mergeSeries(model.series, patch.series) : model.series,
+        style: patch.style ? { ...model.style, ...patch.style } : model.style,
+    };
+    return deepFreeze(next);
+}
+/** Merges a series patch, deep-merging the {@link SeriesStyle.colorByKey} map. */
+function mergeSeries(current, patch) {
+    return {
+        ...current,
+        ...patch,
+        colorByKey: patch.colorByKey ? { ...current.colorByKey, ...patch.colorByKey } : current.colorByKey,
+    };
+}
+/**
+ * Recursively freezes an object graph so a model cannot be mutated after
+ * construction. Arrays and plain nested objects are frozen; primitives are
+ * returned as-is.
+ */
+function deepFreeze(value) {
+    if (value === null || typeof value !== 'object' || Object.isFrozen(value))
+        return value;
+    for (const key of Object.keys(value)) {
+        deepFreeze(value[key]);
+    }
+    return Object.freeze(value);
+}
+//# sourceMappingURL=chart-model.js.map

package/chart/model/chart-model.js.map

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

package/chart/range-chart-controller.d.ts

@@ -0,0 +1,68 @@
+import type { GridContext } from '../core/grid-context';
+import type { ChartToolbarItem, ChartToolPanelName } from '../types/grid.types';
+import { type ChartPanelHost } from './chart-panel';
+import type { ChartRenderOptions } from './chart-renderer';
+import { type ChartColumnOption, type ChartToolPanelHost } from './chart-config/chart-tool-panel';
+import { type ChartModel, type ChartModelPatch } from './model/chart-model';
+/**
+ * Owns a single range chart: its serializable {@link ChartModel}, the floating
+ * {@link ChartPanel} view, the docked {@link ChartToolPanel}, and the grid
+ * subscription that keeps a linked chart in sync with the data.
+ *
+ * Implements both {@link ChartPanelHost} (render options + toolbar actions) and
+ * {@link ChartToolPanelHost} (model + column options for the config tabs), so
+ * the two views can be pure and stateless.
+ */
+export declare class RangeChartController implements ChartPanelHost, ChartToolPanelHost {
+    private readonly ctx;
+    private readonly hostEl;
+    private readonly onDestroyed;
+    private model;
+    private readonly panel;
+    private toolPanel;
+    private unsubscribeRows;
+    private refreshRaf;
+    private disposed;
+    constructor(ctx: GridContext, hostEl: HTMLElement, model: ChartModel, onDestroyed: (chartId: string) => void);
+    /** Opens the chart and, for a linked chart, subscribes to grid data changes. */
+    start(): void;
+    /** The current chart model (a frozen snapshot). */
+    getModel(): ChartModel;
+    /**
+     * Applies a model patch, rebuilds the chart, and notifies listeners. Central
+     * mutation path for every config control and API `updateChart` call.
+     */
+    updateModel(patch: ChartModelPatch): void;
+    /** Rebuilds chart data from the latest grid rows. No-op when unlinked. */
+    refreshFromGrid(): void;
+    /** Opens the configuration drawer inside the chart card, optionally on a tab. */
+    openToolPanel(tab?: ChartToolPanelName): void;
+    /** Detaches the chart from the grid, freezing its current snapshot. */
+    unlink(): void;
+    /** A data-URL snapshot of the chart. */
+    getImageDataURL(format?: 'png' | 'jpeg'): string | null;
+    /** Triggers a browser download of the chart. */
+    downloadImage(format?: 'png' | 'jpeg'): void;
+    /** Tears down the chart, its views, and its subscription. Idempotent. */
+    dispose(): void;
+    getRenderOptions(size: {
+        width: number;
+        height: number;
+    }): ChartRenderOptions;
+    getToolbarItems(): ChartToolbarItem[];
+    isUnlinked(): boolean;
+    onEditChart(): void;
+    onAdvancedSettings(): void;
+    onUnlink(): void;
+    onMove(_rect: DOMRect): void;
+    onClose(): void;
+    getColumnOptions(): ChartColumnOption[];
+    getPanels(): ChartToolPanelName[];
+    getDefaultPanel(): ChartToolPanelName;
+    private buildData;
+    private subscribe;
+    private teardownSubscription;
+    /** Coalesces multiple grid updates in a frame into a single rebuild. */
+    private scheduleRefresh;
+}
+//# sourceMappingURL=range-chart-controller.d.ts.map

package/chart/range-chart-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-chart-controller.d.ts","sourceRoot":"","sources":["../../src/chart/range-chart-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,OAAO,EAAc,KAAK,cAAc,EAAuB,MAAM,eAAe,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAkB,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAClH,OAAO,EAAoB,KAAK,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAW9F;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,cAAc,EAAE,kBAAkB;IAS3E,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAEvB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAX9B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAS;gBAGN,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,WAAW,EACpC,KAAK,EAAE,UAAU,EACA,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IAMzD,gFAAgF;IAChF,KAAK,IAAI,IAAI;IAOb,mDAAmD;IACnD,QAAQ,IAAI,UAAU;IAItB;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAsBzC,0EAA0E;IAC1E,eAAe,IAAI,IAAI;IASvB,iFAAiF;IACjF,aAAa,CAAC,GAAG,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAS7C,uEAAuE;IACvE,MAAM,IAAI,IAAI;IAKd,wCAAwC;IACxC,eAAe,CAAC,MAAM,GAAE,KAAK,GAAG,MAAc,GAAG,MAAM,GAAG,IAAI;IAI9D,gDAAgD;IAChD,aAAa,CAAC,MAAM,GAAE,KAAK,GAAG,MAAc,GAAG,IAAI;IAInD,yEAAyE;IACzE,OAAO,IAAI,IAAI;IAoBf,gBAAgB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,kBAAkB;IAI7E,eAAe,IAAI,gBAAgB,EAAE;IAMrC,UAAU,IAAI,OAAO;IAIrB,WAAW,IAAI,IAAI;IAInB,kBAAkB,IAAI,IAAI;IAI1B,QAAQ,IAAI,IAAI;IAIhB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAK5B,OAAO,IAAI,IAAI;IAMf,gBAAgB,IAAI,iBAAiB,EAAE;IA0BvC,SAAS,IAAI,kBAAkB,EAAE;IAIjC,eAAe,IAAI,kBAAkB;IAMrC,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,oBAAoB;IAK5B,wEAAwE;IACxE,OAAO,CAAC,eAAe;CAOxB"}

package/chart/range-chart-controller.js

@@ -0,0 +1,209 @@
+import { GridEventType } from '../types/event.types';
+import { ChartPanel } from './chart-panel';
+import { ChartToolPanel } from './chart-config/chart-tool-panel';
+import { applyModelChange } from './model/chart-model';
+import { buildChartData, toRenderOptions } from './model/chart-model-mapper';
+/** Column data types treated as measures (plottable series). */
+const MEASURE_TYPES = new Set(['number', 'currency', 'percentage']);
+/** Column data types treated as dimensions (category candidates). */
+const DIMENSION_TYPES = new Set(['string', 'dropdown', 'date', 'boolean', 'email']);
+/** Default `⋮` toolbar items in display order. */
+const DEFAULT_TOOLBAR_ITEMS = ['edit', 'advancedSettings', 'unlink', 'download'];
+/**
+ * Owns a single range chart: its serializable {@link ChartModel}, the floating
+ * {@link ChartPanel} view, the docked {@link ChartToolPanel}, and the grid
+ * subscription that keeps a linked chart in sync with the data.
+ *
+ * Implements both {@link ChartPanelHost} (render options + toolbar actions) and
+ * {@link ChartToolPanelHost} (model + column options for the config tabs), so
+ * the two views can be pure and stateless.
+ */
+export class RangeChartController {
+    constructor(ctx, hostEl, model, onDestroyed) {
+        this.ctx = ctx;
+        this.hostEl = hostEl;
+        this.onDestroyed = onDestroyed;
+        this.toolPanel = null;
+        this.unsubscribeRows = null;
+        this.refreshRaf = null;
+        this.disposed = false;
+        this.model = model;
+        this.panel = new ChartPanel(hostEl);
+    }
+    /** Opens the chart and, for a linked chart, subscribes to grid data changes. */
+    start() {
+        this.panel.setHost(this);
+        this.panel.setChartType(this.model.chartType);
+        this.panel.open(this.model.chartType, this.model.title.text || 'Range Chart', this.buildData());
+        if (!this.model.unlinked)
+            this.subscribe();
+    }
+    /** The current chart model (a frozen snapshot). */
+    getModel() {
+        return this.model;
+    }
+    /**
+     * Applies a model patch, rebuilds the chart, and notifies listeners. Central
+     * mutation path for every config control and API `updateChart` call.
+     */
+    updateModel(patch) {
+        if (this.disposed)
+            return;
+        const wasLinked = !this.model.unlinked;
+        this.model = applyModelChange(this.model, patch);
+        if (patch.unlinked === true && wasLinked)
+            this.teardownSubscription();
+        else if (patch.unlinked === false && !wasLinked)
+            this.subscribe();
+        this.panel.setChartType(this.model.chartType);
+        this.panel.update(this.buildData());
+        // Note: the tool panel is NOT rebuilt here. Rebuilding on every edit would
+        // destroy the control mid-interaction (e.g. an open color picker). Structural
+        // controls (chart-type gallery, series add/remove) refresh themselves; live
+        // style controls keep their own DOM state and only drive the chart.
+        this.ctx.eventBus.emit(GridEventType.CHART_OPTIONS_CHANGED, {
+            chartId: this.model.chartId,
+            chartType: this.model.chartType,
+            chartModel: this.model,
+        });
+    }
+    /** Rebuilds chart data from the latest grid rows. No-op when unlinked. */
+    refreshFromGrid() {
+        if (this.disposed || this.model.unlinked)
+            return;
+        this.panel.update(this.buildData());
+        this.ctx.eventBus.emit(GridEventType.CHART_RANGE_SELECTION_CHANGED, {
+            chartId: this.model.chartId,
+            cellRange: this.model.cellRange,
+        });
+    }
+    /** Opens the configuration drawer inside the chart card, optionally on a tab. */
+    openToolPanel(tab) {
+        const body = this.panel.getBodyElement();
+        if (!body)
+            return;
+        if (!this.toolPanel) {
+            this.toolPanel = new ChartToolPanel(body, this, (px) => this.panel.setConfigReserve(px));
+        }
+        this.toolPanel.open(tab);
+    }
+    /** Detaches the chart from the grid, freezing its current snapshot. */
+    unlink() {
+        if (this.model.unlinked)
+            return;
+        this.updateModel({ unlinked: true });
+    }
+    /** A data-URL snapshot of the chart. */
+    getImageDataURL(format = 'png') {
+        return this.panel.getImageDataURL(format);
+    }
+    /** Triggers a browser download of the chart. */
+    downloadImage(format = 'png') {
+        this.panel.download(format);
+    }
+    /** Tears down the chart, its views, and its subscription. Idempotent. */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.teardownSubscription();
+        if (this.refreshRaf !== null) {
+            cancelAnimationFrame(this.refreshRaf);
+            this.refreshRaf = null;
+        }
+        this.toolPanel?.destroy();
+        this.toolPanel = null;
+        this.panel.close();
+        this.ctx.eventBus.emit(GridEventType.CHART_DESTROYED, {
+            chartId: this.model.chartId,
+            chartType: this.model.chartType,
+        });
+        this.onDestroyed(this.model.chartId);
+    }
+    // ── ChartPanelHost ─────────────────────────────────────────────────────────
+    getRenderOptions(size) {
+        return toRenderOptions(this.model, size);
+    }
+    getToolbarItems() {
+        const custom = this.ctx.options.getChartToolbarItems;
+        const base = [...DEFAULT_TOOLBAR_ITEMS];
+        return custom ? custom(base) : base;
+    }
+    isUnlinked() {
+        return this.model.unlinked;
+    }
+    onEditChart() {
+        this.openToolPanel();
+    }
+    onAdvancedSettings() {
+        this.openToolPanel('customize');
+    }
+    onUnlink() {
+        this.unlink();
+    }
+    onMove(_rect) {
+        // The configuration drawer is a child of the chart card, so it moves with
+        // the card automatically — no external re-docking is required.
+    }
+    onClose() {
+        this.dispose();
+    }
+    // ── ChartToolPanelHost ─────────────────────────────────────────────────────
+    getColumnOptions() {
+        const visible = this.ctx.columnModel.getVisibleColumns();
+        // Prefer the model's explicit candidate pool (union of the source ranges);
+        // fall back to the bounding cellRange for models seeded before chartColIds,
+        // then to all visible columns.
+        let cols;
+        if (this.model.chartColIds && this.model.chartColIds.length > 0) {
+            const byId = new Map(visible.map((c) => [c.colId, c]));
+            cols = this.model.chartColIds
+                .map((id) => byId.get(id))
+                .filter((c) => c !== undefined);
+        }
+        else {
+            const { startColIndex, endColIndex } = this.model.cellRange;
+            const lo = Math.min(startColIndex, endColIndex);
+            const hi = Math.max(startColIndex, endColIndex);
+            const inRange = visible.slice(lo, hi + 1);
+            cols = inRange.length > 0 ? inRange : visible;
+        }
+        return cols.map((c) => ({
+            colId: c.colId,
+            header: c.header,
+            isMeasure: MEASURE_TYPES.has(c.type),
+            isDimension: DIMENSION_TYPES.has(c.type),
+        }));
+    }
+    getPanels() {
+        return this.ctx.options.chartToolPanelsDef?.panels ?? ['chart', 'setup', 'customize'];
+    }
+    getDefaultPanel() {
+        return this.ctx.options.chartToolPanelsDef?.defaultToolPanel ?? 'chart';
+    }
+    // ── Internals ──────────────────────────────────────────────────────────────
+    buildData() {
+        const rows = this.ctx.store.get('visibleRows');
+        const columns = this.ctx.columnModel.getAllColumns();
+        return buildChartData(this.model, rows, columns);
+    }
+    subscribe() {
+        if (this.unsubscribeRows)
+            return;
+        this.unsubscribeRows = this.ctx.store.watch('visibleRows', () => this.scheduleRefresh());
+    }
+    teardownSubscription() {
+        this.unsubscribeRows?.();
+        this.unsubscribeRows = null;
+    }
+    /** Coalesces multiple grid updates in a frame into a single rebuild. */
+    scheduleRefresh() {
+        if (this.refreshRaf !== null || this.disposed)
+            return;
+        this.refreshRaf = requestAnimationFrame(() => {
+            this.refreshRaf = null;
+            this.refreshFromGrid();
+        });
+    }
+}
+//# sourceMappingURL=range-chart-controller.js.map

package/chart/range-chart-controller.js.map

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

package/chart/range-chart-service.d.ts

@@ -0,0 +1,78 @@
+import type { GridContext } from '../core/grid-context';
+import type { CellRange } from '../types/grid.types';
+import type { ChartPanelType } from './chart-panel';
+import { type ChartAggregation, type ChartModel } from './model/chart-model';
+/** Parameters for {@link RangeChartService.createRangeChart}. */
+export interface CreateRangeChartParams {
+    /**
+     * Grid cell range the chart is built from. For a single-range selection this
+     * is the range; for a multi-range selection it should be the primary range,
+     * with the full set passed via {@link CreateRangeChartParams.cellRanges}.
+     */
+    readonly cellRange: CellRange;
+    /**
+     * All selected cell ranges when charting a multi-range (e.g. non-contiguous
+     * column) selection. Their columns are unioned into the candidate pool. When
+     * omitted, only {@link CreateRangeChartParams.cellRange} is used.
+     */
+    readonly cellRanges?: readonly CellRange[];
+    /** Chart type. Defaults to the grid's `defaultChartType`, then `column-grouped`. */
+    readonly chartType?: ChartPanelType;
+    /** Category (x-axis) column id. Auto-detected from the range when omitted. */
+    readonly categoryColId?: string;
+    /** Series column ids. Auto-detected (numeric columns) when omitted. */
+    readonly seriesColIds?: readonly string[];
+    /** Aggregation for rows sharing a category. Defaults to `sum`. */
+    readonly aggregation?: ChartAggregation;
+    /** When `true`, the floating panel is not opened (headless model only). */
+    readonly suppressPanel?: boolean;
+}
+/**
+ * Owns every range chart in a grid. Seeds serializable {@link ChartModel}s from
+ * cell ranges, constructs a {@link RangeChartController} per chart, routes the
+ * GridApi chart surface, and disposes everything on grid teardown.
+ */
+export declare class RangeChartService {
+    private readonly ctx;
+    private readonly charts;
+    private readonly hostEl;
+    private nextId;
+    constructor(ctx: GridContext);
+    /**
+     * Creates a range chart from a cell range and opens its panel.
+     *
+     * @param params - Range, type, and optional column roles.
+     * @returns The new chart id, or an empty string when the range has no numeric
+     *          columns to plot.
+     */
+    createRangeChart(params: CreateRangeChartParams): string;
+    /** Serializable models for every live chart (for save / restore). */
+    getChartModels(): ChartModel[];
+    /** Applies a full model to an existing chart, matched by `chartId`. */
+    updateChart(model: ChartModel): void;
+    /** Recreates a chart from a previously saved model, opening its panel. */
+    restoreChart(model: ChartModel): string;
+    /** A data-URL image of a chart, or null if unknown. */
+    getChartImageDataURL(chartId: string, format?: 'png' | 'jpeg'): string | null;
+    /** Triggers a browser download of a chart. */
+    downloadChart(chartId: string, format?: 'png' | 'jpeg'): void;
+    /** Destroys a single chart. */
+    destroyChart(chartId: string): void;
+    /** Destroys every chart. Called on grid teardown. */
+    disposeAll(): void;
+    /**
+     * Builds a default model from the params, auto-detecting the category and
+     * series columns from the selection when the caller didn't specify them.
+     * Collapses one or many cell ranges into a single ordered, de-duplicated pool
+     * of candidate columns. Returns `null` when the selection contains no numeric
+     * column to plot.
+     */
+    private seedModel;
+    /**
+     * Unions the visible columns spanned by every cell range into a single list in
+     * visible (left-to-right) order, without duplicates. Falls back to all visible
+     * columns when the ranges resolve to an empty span. `O(ranges + columns)`.
+     */
+    private collectRangeColumns;
+}
+//# sourceMappingURL=range-chart-service.d.ts.map

package/chart/range-chart-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-chart-service.d.ts","sourceRoot":"","sources":["../../src/chart/range-chart-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAQ7B,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3C,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAKhB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,MAAM,CAAK;gBAEU,GAAG,EAAE,WAAW;IAI7C;;;;;;OAMG;IACH,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM;IAoBxD,qEAAqE;IACrE,cAAc,IAAI,UAAU,EAAE;IAI9B,uEAAuE;IACvE,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAsBpC,0EAA0E;IAC1E,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAevC,uDAAuD;IACvD,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,KAAK,GAAG,MAAc,GAAG,MAAM,GAAG,IAAI;IAIpF,8CAA8C;IAC9C,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,KAAK,GAAG,MAAc,GAAG,IAAI;IAIpE,+BAA+B;IAC/B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAInC,qDAAqD;IACrD,UAAU,IAAI,IAAI;IAKlB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAqCjB;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;CAW5B"}