@perspective-dev/viewer-charts 5.2.0 → 5.3.0

package/dist/esm/charts/candlestick/candlestick-render.d.ts

@@ -21,4 +21,7 @@ export declare function invalidateGlyphBuffers(chart: CandlestickChart): void;
  */
 export declare function rebuildGlyphBuffers(chart: CandlestickChart, glManager: WebGLContextManager): void;
 export declare function renderCandlestickFrame(chart: CandlestickChart, glManager: WebGLContextManager): void;
+/**
+ * Draw axes chrome + (optional) tooltip onto the overlay canvas.
+ */
 export declare function renderCandlestickChromeOverlay(chart: CandlestickChart): void;

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

@@ -29,6 +29,7 @@ export interface SplitGroup {
 export declare class CartesianChart extends AbstractChart {
     readonly glyph: Glyph;
     constructor(glyph: Glyph);
+    protected colorScaleColumn(): string | null;
     /**
      * Rendering pipeline selector. `"cartesian"` is the default —
      * draws axes, gridlines, and ticks via the chrome canvas.

package/dist/esm/charts/chart-base.d.ts

@@ -57,6 +57,7 @@ export declare abstract class AbstractChart implements ChartImplementation {
     _glManager: WebGLContextManager | null;
     _gridlineCanvas: HTMLCanvasElement | OffscreenCanvas | null;
     _chromeCanvas: HTMLCanvasElement | OffscreenCanvas | null;
+    _overlayPresenter: (() => void) | null;
     /**
      * 2D-canvas draw closures collected during `_fullRender` (the GL
      * pass) and flushed by {@link _flush2D} *after* the scheduler's
@@ -163,11 +164,14 @@ export declare abstract class AbstractChart implements ChartImplementation {
     _emitQueue: Promise<void>;
     /**
      * Cached resolved theme — populated on first `_resolveTheme()` call,
-     * cleared by `invalidateTheme()` (driven from `plugin.restyle()`).
-     * `getComputedStyle` / `getPropertyValue` reads cost ~100µs each;
-     * zoom/hover dispatch redraws at 60Hz so we resolve once and reuse.
+     * cleared by `invalidateTheme()` (driven from `plugin.restyle()`)
+     * and by `setColumnsConfig` (per-column color overrides patch the
+     * resolved theme). `getComputedStyle` / `getPropertyValue` reads
+     * cost ~100µs each; zoom/hover dispatch redraws at 60Hz so we
+     * resolve once and reuse.
      */
     _theme: Theme | null;
+    _themeColorColumn: string | null;
     /**
      * On-demand single-row fetcher used by lazy tooltip column
      * lookups. Reset on every `setView` call; subclasses read
@@ -181,6 +185,12 @@ export declare abstract class AbstractChart implements ChartImplementation {
     _lazyRows: LazyRowFetcher | null;
     setGridlineCanvas(canvas: HTMLCanvasElement | OffscreenCanvas): void;
     setChromeCanvas(canvas: HTMLCanvasElement | OffscreenCanvas): void;
+    setOverlayPresenter(cb: () => void): void;
+    /**
+     * Present a chrome-overlay repaint that ran outside the scheduler's
+     * frame chain.
+     */
+    presentOverlay(): void;
     setTheme(vars: Record<string, string>): void;
     setZoomController(zc: ZoomController): void;
     /**
@@ -294,12 +304,15 @@ export declare abstract class AbstractChart implements ChartImplementation {
      * inputs in `uploadAndRender`; they take effect on next data load.
      */
     setPluginConfig(cfg: PluginConfig): void;
-    /**
-     * Lazily decode the host-supplied theme vars. Subsequent calls hit
-     * the cache until `invalidateTheme()` clears it. Render-path
-     * callers should always read theme values through this method so
-     * the parsed `Theme` (gradient stops, palette, etc.) amortizes
-     * across an entire frame.
+    protected colorScaleColumn(): string | null;
+    /**
+     * Lazily decode the host-supplied theme vars, then patch in any
+     * per-column color-scale override for `colorScaleColumn()`.
+     * Subsequent calls hit the cache until `invalidateTheme()` /
+     * `setColumnsConfig` clears it or the color column changes.
+     * Render-path callers should always read theme values through this
+     * method so the parsed `Theme` (gradient stops, palette, etc.)
+     * amortizes across an entire frame.
      */
     _resolveTheme(): Theme;
     /**

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

@@ -59,6 +59,10 @@ export interface ChartImplementation {
      * Set the chrome canvas (above WebGL, for axes/labels/legend/tooltip).
      */
     setChromeCanvas?(canvas: HTMLCanvasElement | OffscreenCanvas): void;
+    /**
+     * Install the renderer's overlay-present hook.
+     */
+    setOverlayPresenter?(cb: () => void): void;
     /**
      * Hand the chart a pre-computed CSS-variable map produced on the
      * main thread via `snapshotThemeVars(el)`, which it can decode into

package/dist/esm/charts/common/category-axis-resolver.d.ts

@@ -87,7 +87,7 @@ export declare function synthesizeStringLevel(rp: ColumnData, numRows: number, l
  * category axis falls back to the raw row index — callers infer that
  * from `rowPaths.length === 0`.
  */
-export declare function resolveCategoryAxis(columns: ColumnDataMap, numRows: number, groupByLen: number, levelTypes?: string[]): CategoryAxisResult;
+export declare function resolveCategoryAxis(columns: ColumnDataMap, numRows: number, groupByLen: number, levelTypes?: string[], axisMode?: AxisMode): CategoryAxisResult;
 export interface ValueCategoryColumn {
     /**
      * Source aggregate column name; used only for the axis label fallback.

package/dist/esm/charts/common/tree-chart.d.ts

@@ -18,6 +18,7 @@ export declare function firstNonMetadataColumn(columns: ColumnDataMap): string;
  * layout modules can read/write them without friction.
  */
 export declare abstract class TreeChartBase extends AbstractChart {
+    protected colorScaleColumn(): string | null;
     _sizeName: string;
     _colorName: string;
     /**

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

@@ -41,6 +41,7 @@ export interface HeatmapFacet {
  * scale and a single legend.
  */
 export declare class HeatmapChart extends AbstractChart {
+    protected colorScaleColumn(): string | null;
     _program: WebGLProgram | null;
     _locations: HeatmapLocations | null;
     _cornerBuffer: WebGLBuffer | null;

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

@@ -28,6 +28,16 @@ export interface ColumnChartConfig {
      * `"skip"`). Default `"skip"`. No effect on bar / scatter.
      */
     interpolate?: InterpolateMode;
+    /**
+     * Single series-color override (`#rrggbb`) — the no-`split_by`
+     * shape.
+     */
+    color?: string;
+    /**
+     * Discrete color palette cycled over this column's split-generated
+     * series — the `split_by` shape.
+     */
+    palette?: string;
 }
 /**
  * Resolve the render glyph for an aggregate base name. Lookup key is the
@@ -45,6 +55,14 @@ export declare function resolveStack(aggName: string, chartType: ChartType, cfg:
  * `columns_config[aggName].alt_axis`.
  */
 export declare function resolveAltAxis(aggName: string, cfg: Record<string, ColumnChartConfig> | undefined): boolean;
+/**
+ * Resolve a per-series color override from `columns_config`, or `null`
+ * when the theme palette applies.
+ */
+export declare function resolveSeriesColorOverride(series: {
+    aggName: string;
+    splitIdx: number;
+}, facetActive: boolean, cfg: Record<string, ColumnChartConfig> | undefined): [number, number, number] | null;
 /**
  * Resolve the interpolation mode for this aggregate.
  */

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

@@ -190,13 +190,16 @@ export declare class SeriesChart extends CategoricalYChart {
     /**
      * Cached palette + identity-keys for short-circuiting per-frame
      * resolution. Inputs (`seriesPalette` ref, `gradientStops` ref,
-     * `series.length`) only change on data load or `restyle()`.
+     * `series.length`, `_columnsConfig` ref — per-series color
+     * overrides) only change on data load, `restyle()`, or
+     * `setColumnsConfig`.
      */
     _paletteCache: [number, number, number][] | null;
     _paletteCacheKey: {
         seriesPalette: [number, number, number][] | null;
         gradientStops: unknown;
         seriesLength: number;
+        columnsConfig: unknown;
     } | null;
     /**
      * Reusable scratch for the build pipeline — keeps the stack ladder

package/dist/esm/charts/sunburst/sunburst-render.d.ts

@@ -19,4 +19,8 @@ export declare function facetCenterForNode(chart: SunburstChart, nodeId: number)
  * Full-frame render: layout → WebGL arcs → chrome overlay.
  */
 export declare function renderSunburstFrame(chart: SunburstChart, glManager: WebGLContextManager): void;
+/**
+ * Render the chrome overlay (labels, center text, hover highlight +
+ * tooltip).
+ */
 export declare function renderSunburstChromeOverlay(chart: SunburstChart): void;