semiotic 3.4.0 → 3.4.1

package/dist/components/store/TooltipStore.d.ts

@@ -1,4 +1,4 @@
-declare let TooltipProvider: import("react").FC<{
+declare const TooltipProvider: import("react").FC<{
     children: React.ReactNode;
 }>, useTooltip: <R>(selector: (state: unknown) => R) => R;
 export { TooltipProvider, useTooltip };

package/dist/components/store/useSelection.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 export { useCrosshairPosition, setCrosshairPosition, clearCrosshairPosition } from "./LinkedCrosshairStore";
 export interface UseSelectionOptions {
     /** Name of the selection to participate in */
@@ -9,7 +10,7 @@ export interface UseSelectionOptions {
 }
 export interface UseSelectionResult {
     /** Returns true if the datum matches the current selection */
-    predicate: (datum: Record<string, any>) => boolean;
+    predicate: (datum: Datum) => boolean;
     /** Whether any selection clause is currently active */
     isActive: boolean;
     /** Set a point selection (categorical values) */
@@ -30,9 +31,9 @@ export interface UseLinkedHoverOptions {
 }
 export interface UseLinkedHoverResult {
     /** Call with a datum to set hover, or null to clear */
-    onHover: (datum: Record<string, any> | null) => void;
+    onHover: (datum: Datum | null) => void;
     /** Returns true if datum matches the hover selection */
-    predicate: (datum: Record<string, any>) => boolean;
+    predicate: (datum: Datum) => boolean;
     /** Whether any hover is active */
     isActive: boolean;
 }
@@ -53,7 +54,7 @@ export interface UseBrushSelectionResult {
         end: (extent: any) => void;
     };
     /** Returns true if datum matches the brush selection */
-    predicate: (datum: Record<string, any>) => boolean;
+    predicate: (datum: Datum) => boolean;
     /** Whether any brush is active */
     isActive: boolean;
     /** Clear the brush */
@@ -64,4 +65,4 @@ export declare function useBrushSelection(options: UseBrushSelectionOptions): Us
  * Returns the subset of `data` that matches the given selection.
  * In crossfilter mode, pass the consumer's clientId so its own clause is excluded.
  */
-export declare function useFilteredData<T extends Record<string, any>>(data: T[], selectionName: string, clientId?: string): T[];
+export declare function useFilteredData<T extends Datum>(data: T[], selectionName: string, clientId?: string): T[];

package/dist/components/stream/AccessibleDataTable.d.ts

@@ -26,7 +26,7 @@ interface AccessibleDataTableProps {
  * On activation (or when ChartContainer's dataSummary action is toggled),
  * computes a statistical summary (.describe()-style) and shows 5 sample rows.
  */
-export declare function AccessibleDataTable({ scene, chartType, tableId, chartTitle }: AccessibleDataTableProps): React.JSX.Element | null;
+export declare function AccessibleDataTable({ scene, chartType, tableId, chartTitle }: AccessibleDataTableProps): import("react/jsx-runtime").JSX.Element | null;
 interface NetworkAccessibleDataTableProps {
     nodes: Array<{
         datum?: any;
@@ -48,25 +48,25 @@ interface NetworkAccessibleDataTableProps {
 /**
  * JIT accessible data summary for network charts.
  */
-export declare function NetworkAccessibleDataTable({ nodes, edges, chartType, tableId, chartTitle }: NetworkAccessibleDataTableProps): React.JSX.Element | null;
+export declare function NetworkAccessibleDataTable({ nodes, edges, chartType, tableId, chartTitle }: NetworkAccessibleDataTableProps): import("react/jsx-runtime").JSX.Element | null;
 /**
  * Screen-reader-only summary note for the chart.
  * Rendered as role="note" so assistive technology can discover it.
  */
 export declare function ScreenReaderSummary({ summary }: {
     summary?: string;
-}): React.JSX.Element | null;
+}): import("react/jsx-runtime").JSX.Element | null;
 /**
  * Screen-reader-only skip link to jump past chart canvas to the data table.
  * Only rendered when accessibleTable is enabled.
  */
 export declare function SkipToTableLink({ tableId }: {
     tableId: string;
-}): React.JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 /**
  * Visually-hidden aria-live region that mirrors tooltip text for screen readers.
  */
 export declare function AriaLiveTooltip({ hoverPoint }: {
     hoverPoint: any;
-}): React.JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 export { SR_ONLY_STYLE };

package/dist/components/stream/CanvasHitTester.d.ts

@@ -1,6 +1,7 @@
 import type { SceneNode, PointSceneNode } from "./types";
 import type { RingBuffer } from "../realtime/RingBuffer";
 import type { Quadtree } from "d3-quadtree";
+import type { Datum } from "../charts/shared/datumTypes";
 export interface HitResult {
     node: SceneNode;
     datum: any;
@@ -39,4 +40,4 @@ export declare function findAllNodesAtX(scene: SceneNode[], px: number, maxXDist
 /**
  * Binary search for nearest point by time value in a RingBuffer.
  */
-export declare function findNearestIndex(buf: RingBuffer<Record<string, any>>, targetTime: number, getTime: (d: Record<string, any>) => number): number;
+export declare function findNearestIndex(buf: RingBuffer<Datum>, targetTime: number, getTime: (d: Datum) => number): number;

package/dist/components/stream/DataSourceAdapter.d.ts

@@ -1,6 +1,7 @@
 import type { Changeset } from "./types";
+import type { Datum } from "../charts/shared/datumTypes";
 export type ChangesetCallback<T> = (changeset: Changeset<T>) => void;
-export declare class DataSourceAdapter<T = Record<string, any>> {
+export declare class DataSourceAdapter<T = Datum> {
     private callback;
     private lastBoundedData;
     private chunkTimer;

package/dist/components/stream/FocusRing.d.ts

@@ -1,4 +1,3 @@
-import * as React from "react";
 /**
  * Shape-appropriate keyboard focus indicator for canvas-based charts.
  *
@@ -30,4 +29,4 @@ export interface FocusRingProps {
     /** Height of rect-shaped focus target */
     height?: number;
 }
-export declare function FocusRing({ active, hoverPoint, margin, size, shape, width, height }: FocusRingProps): React.JSX.Element | null;
+export declare function FocusRing({ active, hoverPoint, margin, size, shape, width, height }: FocusRingProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/stream/GeoParticlePool.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * GeoParticlePool — particle system for geo line paths.
  *
@@ -20,7 +21,7 @@ export interface GeoParticleStyle {
     /** Particle radius @default 2 */
     radius?: number;
     /** Particle color: a CSS color string, "source" to inherit from line stroke, or a function `(datum) => string` */
-    color?: string | ((datum: any) => string);
+    color?: string | ((datum: Datum) => string);
     /** Particle opacity @default 0.7 */
     opacity?: number;
     /** Speed multiplier @default 1 */

package/dist/components/stream/GeoPipelineStore.d.ts

@@ -3,6 +3,7 @@ import { type Quadtree } from "d3-quadtree";
 import type { GeoPipelineConfig, GeoScales, GeoSceneNode } from "./geoTypes";
 import type { PointSceneNode, StreamLayout } from "./types";
 import type { ActiveTransition } from "./pipelineTransitionUtils";
+import type { Datum } from "../charts/shared/datumTypes";
 export declare class GeoPipelineStore {
     config: GeoPipelineConfig;
     scene: GeoSceneNode[];
@@ -38,19 +39,19 @@ export declare class GeoPipelineStore {
     constructor(config: GeoPipelineConfig);
     updateConfig(config: Partial<GeoPipelineConfig>): void;
     setAreas(features: GeoJSON.Feature[]): void;
-    setPoints(data: Record<string, any>[]): void;
-    setLines(data: Record<string, any>[]): void;
+    setPoints(data: Datum[]): void;
+    setLines(data: Datum[]): void;
     /** Initialize streaming mode with a ring buffer */
     initStreaming(windowSize?: number): void;
     /** Push a single streaming point */
-    pushPoint(datum: Record<string, any>): void;
+    pushPoint(datum: Datum): void;
     /** Push multiple streaming points */
-    pushMany(data: Record<string, any>[]): void;
+    pushMany(data: Datum[]): void;
     /**
      * Remove points by ID. Requires pointIdAccessor to be configured.
      * Returns the removed items.
      */
-    removePoint(id: string | string[]): Record<string, any>[];
+    removePoint(id: string | string[]): Datum[];
     clear(): void;
     computeScene(layout: StreamLayout): void;
     private fitProjection;
@@ -82,7 +83,7 @@ export declare class GeoPipelineStore {
         scale: number;
         translate: [number, number];
     };
-    getPoints(): Record<string, any>[];
+    getPoints(): Datum[];
     /**
      * Build (or clear) the quadtree spatial index for point scene nodes.
      * Only built when the point count exceeds QUADTREE_THRESHOLD; below that

package/dist/components/stream/MarginalGraphics.d.ts

@@ -1,4 +1,3 @@
-import * as React from "react";
 import type { ScaleLinear } from "d3-scale";
 import type { MarginalConfig, MarginalType } from "./types";
 export type MarginalOrient = "top" | "bottom" | "left" | "right";
@@ -16,4 +15,4 @@ export interface MarginalGraphicsProps {
 }
 /** Resolve a string shorthand or full config into a MarginalConfig */
 export declare function normalizeMarginalConfig(input: MarginalConfig | MarginalType): MarginalConfig;
-export declare function MarginalGraphics({ orient, config: rawConfig, values, scale, size, length }: MarginalGraphicsProps): React.JSX.Element | null;
+export declare function MarginalGraphics({ orient, config: rawConfig, values, scale, size, length }: MarginalGraphicsProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/stream/NetworkPipelineStore.d.ts

@@ -1,6 +1,7 @@
 import { ParticlePool } from "./ParticlePool";
 import type { ActiveTransition } from "./pipelineTransitionUtils";
 import type { NetworkPipelineConfig, NetworkSceneNode, NetworkSceneEdge, NetworkLabel, RealtimeNode, RealtimeEdge, EdgePush } from "./networkTypes";
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * NetworkPipelineStore — stateful store for the StreamNetworkFrame.
  *
@@ -134,12 +135,12 @@ export declare class NetworkPipelineStore {
     /**
      * Update a node's data by ID. Returns the previous data, or null if not found.
      */
-    updateNode(id: string, updater: (data: Record<string, any>) => Record<string, any>): Record<string, any> | null;
+    updateNode(id: string, updater: (data: Datum) => Datum): Datum | null;
     /**
      * Update all edges between source and target. Handles parallel edges.
      * Returns array of previous data values (one per updated edge), or empty array.
      */
-    updateEdge(sourceId: string, targetId: string, updater: (data: Record<string, any>) => Record<string, any>): Record<string, any>[];
+    updateEdge(sourceId: string, targetId: string, updater: (data: Datum) => Datum): Datum[];
     /**
      * Remove a node by ID. Also removes all edges connected to this node.
      * Returns true if the node was found and removed.

package/dist/components/stream/NetworkSVGOverlay.d.ts

@@ -1,4 +1,4 @@
-import * as React from "react";
+import type { Datum } from "../charts/shared/datumTypes";
 import type { ReactNode } from "react";
 import type { NetworkLabel } from "./networkTypes";
 import type { LegendGroup, GradientLegendConfig } from "../types/legendTypes";
@@ -47,8 +47,8 @@ export interface NetworkSVGOverlayProps {
         h?: number;
     }>;
     /** Annotations */
-    annotations?: Record<string, any>[];
-    svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: any) => ReactNode;
+    annotations?: Datum[];
+    svgAnnotationRules?: (annotation: Datum, index: number, context: any) => ReactNode;
     annotationFrame?: number;
 }
 /**
@@ -57,7 +57,7 @@ export interface NetworkSVGOverlayProps {
  * Unlike XY/ordinal overlays, network charts don't have axes or grid lines.
  * The overlay is positioned absolutely over the canvas.
  */
-export declare function NetworkSVGOverlay(props: NetworkSVGOverlayProps): React.JSX.Element;
+export declare function NetworkSVGOverlay(props: NetworkSVGOverlayProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace NetworkSVGOverlay {
     var displayName: string;
 }

package/dist/components/stream/OrdinalBrushOverlay.d.ts

@@ -1,21 +1,3 @@
-/**
- * OrdinalBrushOverlay — d3-brush SVG overlay for ordinal frames.
- *
- * Renders a transparent SVG positioned above the canvas. Brushes along the
- * r-axis (value axis) only: horizontal projection → brushX, vertical → brushY.
- *
- * Key design decisions:
- *   - Outer SVG has pointerEvents:"none", inner brush-g has "all", so
- *     axes/legends rendered underneath remain clickable.
- *   - d3-brush lifecycle (useEffect) depends on [width, height, isHorizontal]
- *     only — NOT scales. Scales are read from a ref to avoid brush teardown
- *     mid-drag (scales change every render due to new object identity).
- *   - A separate useEffect repositions the brush when scales change (streaming).
- *
- * Consumed by: StreamOrdinalFrame (rendered when brush prop is set).
- * Wired by: useOrdinalBrush hook in HOC charts.
- */
-import * as React from "react";
 import type { OrdinalScales } from "./ordinalTypes";
 interface OrdinalBrushOverlayProps {
     width: number;
@@ -39,5 +21,5 @@ interface OrdinalBrushOverlayProps {
  * In horizontal projection, r maps to x-pixels → uses brushX.
  * In vertical projection, r maps to y-pixels → uses brushY.
  */
-export declare function OrdinalBrushOverlay({ width, height, totalWidth, totalHeight, margin, scales, onBrush }: OrdinalBrushOverlayProps): React.JSX.Element;
+export declare function OrdinalBrushOverlay({ width, height, totalWidth, totalHeight, margin, scales, onBrush }: OrdinalBrushOverlayProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/stream/OrdinalPipelineStore.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * OrdinalPipelineStore — stateful pipeline for ordinal chart data.
  *
@@ -114,20 +115,20 @@ export declare class OrdinalPipelineStore {
     private snapshotPositions;
     private startTransition;
     advanceTransition(now: number): boolean;
-    getData(): Record<string, any>[];
+    getData(): Datum[];
     /**
      * Remove data items by ID. Requires dataIdAccessor to be configured.
      * Returns the removed items. Marks the store dirty for scene rebuild.
      */
-    remove(id: string | string[]): Record<string, any>[];
+    remove(id: string | string[]): Datum[];
     /**
      * Update data items by ID. Requires dataIdAccessor.
      * Returns the previous values. Categories and extents are rebuilt.
      */
-    update(id: string | string[], updater: (d: Record<string, any>) => Record<string, any>): Record<string, any>[];
+    update(id: string | string[], updater: (d: Datum) => Datum): Datum[];
     clear(): void;
     get size(): number;
-    getOAccessor(): (d: any) => string;
-    getRAccessor(): (d: any) => number;
+    getOAccessor(): (d: Datum) => string;
+    getRAccessor(): (d: Datum) => number;
     updateConfig(config: Partial<OrdinalPipelineConfig>): void;
 }

package/dist/components/stream/OrdinalSVGOverlay.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 import * as React from "react";
 import type { OrdinalScales } from "./ordinalTypes";
 import type { AnnotationContext } from "../realtime/types";
@@ -42,12 +43,12 @@ interface OrdinalSVGOverlayProps {
     legendIsolatedCategories?: Set<string>;
     legendPosition?: "right" | "left" | "top" | "bottom";
     foregroundGraphics?: ReactNode;
-    annotations?: Record<string, any>[];
-    svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
+    annotations?: Datum[];
+    svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
     annotationFrame?: number;
     xAccessor?: string;
     yAccessor?: string;
-    annotationData?: Record<string, any>[];
+    annotationData?: Datum[];
     /** When true, grid lines and axis baselines are skipped (rendered by OrdinalSVGUnderlay instead) */
     underlayRendered?: boolean;
     children?: ReactNode;
@@ -69,6 +70,6 @@ interface OrdinalSVGUnderlayProps {
     rFormat?: (d: number) => string;
     rTickValues?: number[];
 }
-export declare function OrdinalSVGUnderlay(props: OrdinalSVGUnderlayProps): React.JSX.Element | null;
-export declare function OrdinalSVGOverlay(props: OrdinalSVGOverlayProps): React.JSX.Element | null;
+export declare function OrdinalSVGUnderlay(props: OrdinalSVGUnderlayProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function OrdinalSVGOverlay(props: OrdinalSVGOverlayProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/components/stream/PipelineStore.d.ts

@@ -1,6 +1,7 @@
+import type { Datum } from "../charts/shared/datumTypes";
 import { type Quadtree } from "d3-quadtree";
 import { RingBuffer } from "../realtime/RingBuffer";
-import type { Changeset, StreamChartType, StreamScales, StreamLayout, SceneNode, PointSceneNode, CandlestickStyle, Style, ArrowOfTime, WindowMode, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, CurveType } from "./types";
+import type { Changeset, StreamChartType, StreamScales, StreamLayout, SceneNode, PointSceneNode, CandlestickStyle, Style, ArrowOfTime, WindowMode, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, CurveType, BarStyle, ThemeSemanticColors } from "./types";
 import type { ActiveTransition } from "./pipelineTransitionUtils";
 export interface PipelineConfig {
     chartType: StreamChartType;
@@ -12,14 +13,14 @@ export interface PipelineConfig {
     /** Pixel inset on scale ranges to prevent glyph clipping at chart edges. Default 0. */
     scalePadding?: number;
     maxCapacity?: number;
-    xAccessor?: string | ((d: any) => number);
-    yAccessor?: string | ((d: any) => number);
-    timeAccessor?: string | ((d: any) => number);
-    valueAccessor?: string | ((d: any) => number);
-    colorAccessor?: string | ((d: any) => string);
-    sizeAccessor?: string | ((d: any) => number);
-    groupAccessor?: string | ((d: any) => string);
-    categoryAccessor?: string | ((d: any) => string);
+    xAccessor?: string | ((d: Datum) => number);
+    yAccessor?: string | ((d: Datum) => number);
+    timeAccessor?: string | ((d: Datum) => number);
+    valueAccessor?: string | ((d: Datum) => number);
+    colorAccessor?: string | ((d: Datum) => string);
+    sizeAccessor?: string | ((d: Datum) => number);
+    groupAccessor?: string | ((d: Datum) => string);
+    categoryAccessor?: string | ((d: Datum) => string);
     lineDataAccessor?: string;
     xScaleType?: "linear" | "log" | "time";
     yScaleType?: "linear" | "log";
@@ -28,16 +29,16 @@ export interface PipelineConfig {
     sizeRange?: [number, number];
     binSize?: number;
     normalize?: boolean;
-    openAccessor?: string | ((d: any) => number);
-    highAccessor?: string | ((d: any) => number);
-    lowAccessor?: string | ((d: any) => number);
-    closeAccessor?: string | ((d: any) => number);
+    openAccessor?: string | ((d: Datum) => number);
+    highAccessor?: string | ((d: Datum) => number);
+    lowAccessor?: string | ((d: Datum) => number);
+    closeAccessor?: string | ((d: Datum) => number);
     candlestickStyle?: CandlestickStyle;
     /** Internal: set by PipelineStore when open/close accessors are both missing */
     candlestickRangeMode?: boolean;
-    boundsAccessor?: string | ((d: any) => number);
+    boundsAccessor?: string | ((d: Datum) => number);
     boundsStyle?: any;
-    y0Accessor?: string | ((d: any) => number);
+    y0Accessor?: string | ((d: Datum) => number);
     gradientFill?: {
         topOpacity: number;
         bottomOpacity: number;
@@ -55,10 +56,10 @@ export interface PipelineConfig {
         }>;
     };
     lineStyle?: any;
-    pointStyle?: (d: any) => Style & {
+    pointStyle?: (d: Datum) => Style & {
         r?: number;
     };
-    areaStyle?: (d: any) => Style;
+    areaStyle?: (d: Datum) => Style;
     swarmStyle?: {
         radius?: number;
         fill?: string;
@@ -78,8 +79,31 @@ export interface PipelineConfig {
     colorScheme?: string | string[];
     /** Theme categorical palette — used as fallback when colorScheme is not an explicit array */
     themeCategorical?: string[];
+    /**
+     * Theme-resolved semantic role colors. Scene builders use these as the
+     * default before falling back to hardcoded hex. Populated by the Stream
+     * Frame from the in-memory `SemioticTheme.colors` object at render time
+     * — the values are concrete hex (or whatever the preset declares), not
+     * `var(...)` strings, and so this channel does NOT participate in the
+     * DOM CSS cascade. Changing the ambient theme (`<ThemeProvider>`) or
+     * swapping to a nested provider is how you override these values.
+     *
+     * Per-scope overrides via CSS custom properties
+     * (e.g. `<div style={{ "--semiotic-danger": "#c00" }}>`) work only for
+     * values a user explicitly passes through as `var(--...)` strings in
+     * chart props — those are resolved via `getComputedStyle` in the
+     * canvas renderer at paint time (see `resolveCSSColor.ts`). The theme
+     * defaults in this field don't read CSS.
+     */
+    themeSemantic?: ThemeSemanticColors;
+    /** Theme sequential scheme name (e.g. "blues") — fallback when `colorScheme` is not explicitly set for magnitude encodings (heatmap, choropleth, size). */
+    themeSequential?: string;
+    /** Theme diverging scheme name (e.g. "RdBu") — fallback when `colorScheme` is not explicitly set for midpoint encodings (likert, bivariate, ± deviation). */
+    themeDiverging?: string;
     barColors?: Record<string, string>;
-    annotations?: Record<string, any>[];
+    /** Histogram bar style — fill/stroke/strokeWidth/gap. Accepted by RealtimeHistogram and routed through to the bar scene builder. */
+    barStyle?: BarStyle;
+    annotations?: Datum[];
     decay?: DecayConfig;
     pulse?: PulseConfig;
     transition?: TransitionConfig;
@@ -91,7 +115,7 @@ export interface PipelineConfig {
     heatmapYBins?: number;
     showValues?: boolean;
     heatmapValueFormat?: (v: number) => string;
-    pointIdAccessor?: string | ((d: any) => string);
+    pointIdAccessor?: string | ((d: Datum) => string);
     curve?: CurveType;
 }
 export declare class PipelineStore {
@@ -124,8 +148,15 @@ export declare class PipelineStore {
     lastIngestTime: number;
     /** Unified color map cache keyed by sorted category set — shared across point, swarm, etc. */
     private _colorMapCache;
-    /** Separate group→color map for resolveGroupColor (insertion-order based, never invalidates _colorMapCache) */
+    /** Separate group→color map for resolveGroupColor (insertion-order based, never invalidates _colorMapCache).
+     *  FIFO-bounded to `GROUP_COLOR_MAP_CAP` entries — in long-running streams with unique group IDs (e.g. UUIDs
+     *  as `lineBy` keys) this would otherwise grow unboundedly. Evicted groups that re-appear get a new palette
+     *  slot; stable color assignment is only guaranteed for the most-recent `CAP` unique groups. */
     private _groupColorMap;
+    /** Monotonic counter for group-color palette indexing. Decoupled from `_groupColorMap.size` so FIFO eviction
+     *  doesn't cause new groups to collide with existing entries on a shrunk map. */
+    private _groupColorCounter;
+    private static readonly GROUP_COLOR_MAP_CAP;
     private _barCategoryCache;
     /** Sorted bin boundary values from the last bar scene build (for data-driven brush snapping) */
     private _binBoundaries;
@@ -202,7 +233,11 @@ export declare class PipelineStore {
     private resolveAreaStyle;
     /** Resolve a group name to a color from the cached color map or a dedicated group palette.
      *  First checks _colorMapCache (populated by resolveColorMap when colorAccessor is set).
-     *  Falls back to _groupColorMap (insertion-order, never mutates _colorMapCache). */
+     *  Falls back to _groupColorMap (insertion-order, never mutates _colorMapCache).
+     *
+     *  FIFO-evicts the oldest entry when the map exceeds `GROUP_COLOR_MAP_CAP`. The palette index
+     *  uses `_groupColorCounter` (monotonic, decoupled from map size) so eviction doesn't cause
+     *  new groups to collide with existing entries on a shrunk map. */
     private resolveGroupColor;
     /**
      * Return a cached materialized array of the buffer contents.
@@ -211,18 +246,18 @@ export declare class PipelineStore {
      * transition ticks, hover redraws, and other non-data-changing renders.
      */
     private getBufferArray;
-    getData(): Record<string, any>[];
+    getData(): Datum[];
     /**
      * Remove data points by ID. Requires pointIdAccessor to be configured.
      * Returns the removed items. Marks the store dirty for scene rebuild.
      */
-    remove(id: string | string[]): Record<string, any>[];
+    remove(id: string | string[]): Datum[];
     /**
      * Update data points by ID. Requires pointIdAccessor.
      * The updater receives the current datum and returns the replacement.
      * Returns the previous values. Extents and scene are marked dirty.
      */
-    update(id: string | string[], updater: (d: Record<string, any>) => Record<string, any>): Record<string, any>[];
+    update(id: string | string[], updater: (d: Datum) => Datum): Datum[];
     /** Returns sorted bin boundary values from the last bar scene build. Persists until clear() or the next bar scene build. */
     getBinBoundaries(): number[];
     getExtents(): {
@@ -231,9 +266,9 @@ export declare class PipelineStore {
     } | null;
     clear(): void;
     get size(): number;
-    getBuffer(): RingBuffer<Record<string, any>>;
-    getXAccessor(): (d: any) => number;
-    getYAccessor(): (d: any) => number;
-    getCategoryAccessor(): ((d: any) => string) | undefined;
+    getBuffer(): RingBuffer<Datum>;
+    getXAccessor(): (d: Datum) => number;
+    getYAccessor(): (d: Datum) => number;
+    getCategoryAccessor(): ((d: Datum) => string) | undefined;
     updateConfig(config: Partial<PipelineConfig>): void;
 }

package/dist/components/stream/SVGOverlay.d.ts

@@ -1,4 +1,4 @@
-import * as React from "react";
+import type { Datum } from "../charts/shared/datumTypes";
 import type { StreamScales, MarginalGraphicsConfig } from "./types";
 import type { AnnotationContext } from "../realtime/types";
 import type { ReactNode } from "react";
@@ -38,8 +38,8 @@ interface SVGOverlayProps {
     yLabel?: string;
     /** Label for the right Y axis (dual-axis charts) */
     yLabelRight?: string;
-    xFormat?: (d: any, index?: number, allTicks?: number[]) => string | ReactNode;
-    yFormat?: (d: any) => string | ReactNode;
+    xFormat?: (d: number | Date | string, index?: number, allTicks?: number[]) => string | ReactNode;
+    yFormat?: (d: number | Date | string) => string | ReactNode;
     showGrid?: boolean;
     title?: string | ReactNode;
     legend?: ReactNode | {
@@ -65,12 +65,12 @@ interface SVGOverlayProps {
     marginalGraphics?: MarginalGraphicsConfig;
     xValues?: number[];
     yValues?: number[];
-    annotations?: Record<string, any>[];
-    svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
+    annotations?: Datum[];
+    svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
     annotationFrame?: number;
     xAccessor?: string;
     yAccessor?: string;
-    annotationData?: Record<string, any>[];
+    annotationData?: Datum[];
     pointNodes?: {
         pointId?: string;
         x: number;
@@ -102,9 +102,9 @@ interface SVGUnderlayProps {
     showAxes?: boolean;
     axes?: AxisConfig[];
     showGrid?: boolean;
-    xFormat?: (d: any, index?: number, allTicks?: number[]) => string | ReactNode;
-    yFormat?: (d: any) => string | ReactNode;
+    xFormat?: (d: number | Date | string, index?: number, allTicks?: number[]) => string | ReactNode;
+    yFormat?: (d: number | Date | string) => string | ReactNode;
 }
-export declare function SVGUnderlay(props: SVGUnderlayProps): React.JSX.Element | null;
-export declare function SVGOverlay(props: SVGOverlayProps): React.JSX.Element | null;
+export declare function SVGUnderlay(props: SVGUnderlayProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SVGOverlay(props: SVGOverlayProps): import("react/jsx-runtime").JSX.Element | null;
 export {};

package/dist/components/stream/SceneGraph.d.ts

@@ -1,16 +1,17 @@
 import type { SceneNode, LineSceneNode, AreaSceneNode, PointSceneNode, RectSceneNode, HeatcellSceneNode, Style, StreamScales, CurveType } from "./types";
-export declare function buildLineNode(data: Record<string, any>[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, style: Style, group?: string): LineSceneNode;
-export declare function buildAreaNode(data: Record<string, any>[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, baselineY: number, style: Style, group?: string, y0Get?: (d: Record<string, any>) => number): AreaSceneNode;
+import type { Datum } from "../charts/shared/datumTypes";
+export declare function buildLineNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, style: Style, group?: string): LineSceneNode;
+export declare function buildAreaNode(data: Datum[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, baselineY: number, style: Style, group?: string, y0Get?: (d: Datum) => number): AreaSceneNode;
 /** Per-group-per-x stacked top values, keyed by group then x */
 export type StackedTops = Map<string, Map<number, number>>;
 export declare function buildStackedAreaNodes(groups: {
     key: string;
-    data: Record<string, any>[];
-}[], scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, styleFn: (group: string, sampleDatum?: Record<string, any>) => Style, normalize?: boolean, curve?: CurveType): {
+    data: Datum[];
+}[], scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, styleFn: (group: string, sampleDatum?: Datum) => Style, normalize?: boolean, curve?: CurveType): {
     nodes: AreaSceneNode[];
     stackedTops: StackedTops;
 };
-export declare function buildPointNode(datum: Record<string, any>, scales: StreamScales, xGet: (d: Record<string, any>) => number, yGet: (d: Record<string, any>) => number, r: number, style: Style, pointId?: string): PointSceneNode | null;
+export declare function buildPointNode(datum: Datum, scales: StreamScales, xGet: (d: Datum) => number, yGet: (d: Datum) => number, r: number, style: Style, pointId?: string): PointSceneNode | null;
 export declare function buildRectNode(x: number, y: number, w: number, h: number, style: Style, datum: any, group?: string): RectSceneNode;
 export declare function buildHeatcellNode(x: number, y: number, w: number, h: number, fill: string, datum: any, options?: {
     value?: number;

package/dist/components/stream/StreamGeoFrame.d.ts

@@ -1,4 +1,5 @@
+import type { Datum } from "../charts/shared/datumTypes";
 import * as React from "react";
 import type { StreamGeoFrameProps, StreamGeoFrameHandle } from "./geoTypes";
-declare const StreamGeoFrame: React.ForwardRefExoticComponent<StreamGeoFrameProps<Record<string, any>> & React.RefAttributes<StreamGeoFrameHandle>>;
+declare const StreamGeoFrame: React.ForwardRefExoticComponent<StreamGeoFrameProps<Datum> & React.RefAttributes<StreamGeoFrameHandle>>;
 export default StreamGeoFrame;

package/dist/components/stream/StreamNetworkFrame.d.ts

@@ -1,4 +1,5 @@
+import type { Datum } from "../charts/shared/datumTypes";
 import * as React from "react";
 import type { StreamNetworkFrameProps, StreamNetworkFrameHandle } from "./networkTypes";
-declare const StreamNetworkFrame: React.ForwardRefExoticComponent<StreamNetworkFrameProps<Record<string, any>> & React.RefAttributes<StreamNetworkFrameHandle>>;
+declare const StreamNetworkFrame: React.ForwardRefExoticComponent<StreamNetworkFrameProps<Datum> & React.RefAttributes<StreamNetworkFrameHandle>>;
 export default StreamNetworkFrame;

package/dist/components/stream/StreamOrdinalFrame.d.ts

@@ -1,4 +1,5 @@
+import type { Datum } from "../charts/shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle } from "./ordinalTypes";
-declare const StreamOrdinalFrame: React.ForwardRefExoticComponent<StreamOrdinalFrameProps<Record<string, any>> & React.RefAttributes<StreamOrdinalFrameHandle<Record<string, any>>>>;
+declare const StreamOrdinalFrame: React.ForwardRefExoticComponent<StreamOrdinalFrameProps<Datum> & React.RefAttributes<StreamOrdinalFrameHandle<Datum>>>;
 export default StreamOrdinalFrame;

package/dist/components/stream/StreamXYFrame.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps, StreamXYFrameHandle } from "./types";
 /**
@@ -17,5 +18,5 @@ import type { StreamXYFrameProps, StreamXYFrameHandle } from "./types";
  * raw color without alpha — degrades gracefully.
  */
 export declare function withAlpha(color: string, alphaHex: string): string;
-declare const StreamXYFrame: React.ForwardRefExoticComponent<StreamXYFrameProps<Record<string, any>> & React.RefAttributes<StreamXYFrameHandle<Record<string, any>>>>;
+declare const StreamXYFrame: React.ForwardRefExoticComponent<StreamXYFrameProps<Datum> & React.RefAttributes<StreamXYFrameHandle<Datum>>>;
 export default StreamXYFrame;