@perspective-dev/viewer-charts 5.0.0 → 5.1.0

package/dist/esm/charts/series/glyphs/draw-areas.d.ts

@@ -23,9 +23,14 @@ export declare class AreaGlyph {
     /**
      * Bind persistent strip buffers and dispatch one TRIANGLE_STRIP per
      * series-run. Skips hidden series. `splitFilter` (faceted frames)
-     * draws only the series whose `splitIdx` matches.
+     * draws only the series whose `splitIdx` matches; `aggRange` (mixed
+     * glyph-run frames) only those whose `aggIdx` lies in the inclusive
+     * run span.
      */
-    draw(chart: SeriesChart, gl: GL, _glManager: WebGLContextManager, projLeft: Float32Array, projRight: Float32Array, opacity: number, splitFilter?: number): void;
+    draw(chart: SeriesChart, gl: GL, _glManager: WebGLContextManager, projLeft: Float32Array, projRight: Float32Array, opacity: number, splitFilter?: number, aggRange?: {
+        start: number;
+        end: number;
+    }): void;
     destroy(chart: SeriesChart): void;
 }
 export {};

package/dist/esm/charts/series/glyphs/draw-lines.d.ts

@@ -34,9 +34,14 @@ export declare class LineGlyph {
      * per series. Skips hidden series via `_hiddenSeries`. Gap /
      * transparency rendering is governed by `u_interp_alpha`, set per
      * series. `splitFilter` (faceted frames) draws only the series
-     * whose `splitIdx` matches — one call per facet.
+     * whose `splitIdx` matches — one call per facet. `aggRange` (mixed
+     * glyph-run frames) draws only the series whose `aggIdx` lies in
+     * the inclusive run span.
      */
-    draw(chart: SeriesChart, gl: GL, glManager: WebGLContextManager, projLeft: Float32Array, projRight: Float32Array, splitFilter?: number): void;
+    draw(chart: SeriesChart, gl: GL, glManager: WebGLContextManager, projLeft: Float32Array, projRight: Float32Array, splitFilter?: number, aggRange?: {
+        start: number;
+        end: number;
+    }): void;
     destroy(chart: SeriesChart): void;
 }
 export {};

package/dist/esm/charts/series/glyphs/draw-scatter.d.ts

@@ -26,11 +26,14 @@ export declare class ScatterGlyph {
     /**
      * Bind the persistent left/right buffers and issue up to two draw
      * calls. No per-frame allocations or buffer uploads. `splitFilter`
-     * (faceted frames) instead draws each matching series' contiguous
-     * bucket sub-range — one `drawArrays(POINTS, first, count)` per
-     * series of the facet.
+     * (faceted frames) and/or `aggRange` (mixed glyph-run frames)
+     * instead draw each matching series' contiguous bucket sub-range —
+     * one `drawArrays(POINTS, first, count)` per matching series.
      */
-    draw(chart: SeriesChart, gl: GL, glManager: WebGLContextManager, projLeft: Float32Array, projRight: Float32Array, splitFilter?: number): void;
+    draw(chart: SeriesChart, gl: GL, glManager: WebGLContextManager, projLeft: Float32Array, projRight: Float32Array, splitFilter?: number, aggRange?: {
+        start: number;
+        end: number;
+    }): void;
     destroy(chart: SeriesChart): void;
 }
 export {};

package/dist/esm/charts/series/series-interact.d.ts

@@ -8,8 +8,9 @@ import { type SeriesChartRecord } from "./series-build";
  */
 export declare function getHoveredBar(chart: SeriesChart): SeriesChartRecord | null;
 /**
- * Handle mouse-move across all glyph types. Tests (in reverse paint order
- * so top glyphs win): scatter points → line points → bars → areas.
+ * Handle mouse-move across all glyph types. Tests glyph runs in reverse
+ * paint order so top glyphs win — paint order is the `columns`
+ * declaration order (see `_glyphRuns` / `drawGlyphRuns`).
  * Updates `_hoveredBarIdx` or `_hoveredSample` and re-renders on change.
  *
  * Faceted frames first resolve the cell under the cursor: that cell's

package/dist/esm/charts/series/series.d.ts

@@ -26,6 +26,15 @@ export interface SeriesAutoFitCache {
     rightMax: number;
     hasRight: boolean;
 }
+/**
+ * One paint pass: the contiguous span of aggregates (`columns` indices,
+ * inclusive) sharing a glyph type. See {@link SeriesChart._glyphRuns}.
+ */
+export interface GlyphRun {
+    chartType: SeriesInfo["chartType"];
+    aggStart: number;
+    aggEnd: number;
+}
 export interface CachedLocations {
     u_proj_left: WebGLUniformLocation | null;
     u_proj_right: WebGLUniformLocation | null;
@@ -98,6 +107,35 @@ export declare class SeriesChart extends CategoricalYChart {
         start: number;
         count: number;
     }[] | null;
+    /**
+     * Paint order of the current build: consecutive aggregates sharing
+     * a glyph type, merged into runs, in `columns` declaration order
+     * (`aggIdx` ascending — later columns paint on top). The frame
+     * draws one pass per run; a homogeneous chart is a single run and
+     * degenerates to the legacy one-pass-per-type path. `aggEnd` is
+     * inclusive.
+     */
+    _glyphRuns: GlyphRun[];
+    /**
+     * Per-aggregate contiguous instance ranges in the uploaded bar
+     * buffers, indexed by `aggIdx` — the overlay-mode counterpart of
+     * `_facetBarRanges`, populated by `uploadBarInstances`' aggregate
+     * counting sort. `null` until first upload.
+     */
+    _barAggRanges: {
+        start: number;
+        count: number;
+    }[] | null;
+    /**
+     * Faceted per-(split, aggregate) instance ranges,
+     * `[splitIdx][aggIdx]` — instances are emitted split-major then
+     * aggregate-ordered, so a facet's glyph-run slice is contiguous.
+     * `null` in overlay mode.
+     */
+    _facetBarAggRanges: {
+        start: number;
+        count: number;
+    }[][] | null;
     /**
      * Columnar bar/area record storage. Indexed by bar slot in
      * `[0, _bars.count)`. Replaces the legacy `SeriesChartRecord[]` to
@@ -197,6 +235,19 @@ export declare class SeriesChart extends CategoricalYChart {
         min: number;
         max: number;
     } | null;
+    /**
+     * The axis partition (per-aggregate axis side) the expand
+     * accumulators were accumulated under. An accumulator is only
+     * meaningful for the partition that produced it: when an aggregate
+     * moves sides (`columns_config.alt_axis` pin via a config-only
+     * `update()`, or a data-driven `auto_alt_y_axis` flip), the side it
+     * LEFT would otherwise retain its extent forever — the departed
+     * column's range never leaves the primary axis. A signature
+     * mismatch resets BOTH accumulators before the union. Keyed per
+     * AGGREGATE (not per series) so split-group growth on a streaming
+     * update never spuriously resets.
+     */
+    _expandedAxisSig: string | null;
     /**
      * Numeric category-axis state. Populated only when `group_by` has
      * exactly one level and that level is `date | datetime | integer |