semiotic 3.4.1 → 3.4.2

package/ai/schema.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "name": "semiotic",
-  "version": "3.4.1",
+  "version": "3.4.2",
   "description": "React data visualization library for charts, networks, and beyond",
   "tools": [
     {

package/dist/components/export/selectionSerializer.d.ts

@@ -1,7 +1,7 @@
 import type { Selection } from "../store/SelectionStore";
 export type SerializedFieldSelection = {
     type: "point";
-    values: any[];
+    values: unknown[];
 } | {
     type: "interval";
     range: [number, number];

package/dist/components/realtime/types.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from "react";
-import type { ScaleLinear } from "d3-scale";
+import type { ScaleBand, ScaleLinear } from "d3-scale";
 import type { Datum } from "../charts/shared/datumTypes";
 export type ArrowOfTime = "up" | "down" | "left" | "right";
 export type WindowMode = "sliding" | "growing";
@@ -27,7 +27,7 @@ export interface AnnotationContext {
         time?: ScaleLinear<number, number>;
         value?: ScaleLinear<number, number>;
         /** The raw ordinal band scale (only in ordinal frames). Has .bandwidth(). */
-        o?: any;
+        o?: ScaleBand<string>;
     } | null;
     /** @deprecated Use scales.x / scales.y instead */
     timeAxis?: "x" | "y";
@@ -67,7 +67,7 @@ export interface HoverAnnotationConfig {
 }
 export interface HoverData {
     /** The raw datum from the user's data array (may be an object, array, or null for exit nodes) */
-    data: any;
+    data: Datum | null;
     /** Pixel X coordinate of the hovered element */
     x: number;
     /** Pixel Y coordinate of the hovered element */
@@ -82,12 +82,12 @@ export interface HoverData {
         value: number;
         valuePx?: number;
         color: string;
-        datum: any;
+        datum: Datum;
     }>;
     /** Pixel X of hover position (may differ from x for multi-point snap) */
     xPx?: number;
     /** Raw X domain value at hover position */
-    xValue?: any;
+    xValue?: unknown;
     /** Distribution statistics for boxplot/violin/ridgeline */
     stats?: {
         n: number;

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

@@ -2,7 +2,7 @@ import type { Datum } from "../charts/shared/datumTypes";
 export type ResolutionMode = "union" | "intersect" | "crossfilter";
 export interface FieldConstraint {
     type: "point";
-    values: Set<any>;
+    values: Set<unknown>;
 }
 export interface IntervalConstraint {
     type: "interval";

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

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

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

@@ -14,7 +14,7 @@ export interface UseSelectionResult {
     /** Whether any selection clause is currently active */
     isActive: boolean;
     /** Set a point selection (categorical values) */
-    selectPoints: (fieldValues: Record<string, any[]>) => void;
+    selectPoints: (fieldValues: Record<string, unknown[]>) => void;
     /** Set an interval selection (numeric ranges) */
     selectInterval: (fieldRanges: Record<string, [number, number]>) => void;
     /** Clear this client's clause */
@@ -47,12 +47,12 @@ export interface UseBrushSelectionOptions {
     yField?: string;
 }
 export interface UseBrushSelectionResult {
-    /** Interaction config to pass to frameProps.interaction */
     brushInteraction: {
         brush: "xyBrush" | "xBrush" | "yBrush";
-        during: (extent: any) => void;
-        end: (extent: any) => void;
+        during: (extent: BrushExtent | null) => void;
+        end: (extent: BrushExtent | null) => void;
     };
+    /** Interaction config to pass to frameProps.interaction */
     /** Returns true if datum matches the brush selection */
     predicate: (datum: Datum) => boolean;
     /** Whether any brush is active */
@@ -60,6 +60,9 @@ export interface UseBrushSelectionResult {
     /** Clear the brush */
     clear: () => void;
 }
+type LinearBrushExtent = [number, number];
+type XYBrushExtent = [[number, number], [number, number]];
+type BrushExtent = LinearBrushExtent | XYBrushExtent | [number, number][];
 export declare function useBrushSelection(options: UseBrushSelectionOptions): UseBrushSelectionResult;
 /**
  * Returns the subset of `data` that matches the given selection.

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

@@ -2,6 +2,17 @@ import type { Datum } from "../charts/shared/datumTypes";
 import type { ReactNode } from "react";
 import type { NetworkLabel } from "./networkTypes";
 import type { LegendGroup, GradientLegendConfig } from "../types/legendTypes";
+type AnnotationAnchorNode = {
+    type: string;
+    datum: Datum | null;
+    id?: string;
+    x?: number;
+    y?: number;
+    cx?: number;
+    cy?: number;
+    w?: number;
+    h?: number;
+};
 export interface NetworkSVGOverlayProps {
     width: number;
     height: number;
@@ -35,20 +46,14 @@ export interface NetworkSVGOverlayProps {
     /** User-provided SVG elements on top */
     foregroundGraphics?: ReactNode;
     /** Scene nodes for annotation positioning */
-    sceneNodes?: Array<{
-        type: string;
-        datum: any;
-        id?: string;
-        x?: number;
-        y?: number;
-        cx?: number;
-        cy?: number;
-        w?: number;
-        h?: number;
-    }>;
+    sceneNodes?: AnnotationAnchorNode[];
     /** Annotations */
     annotations?: Datum[];
-    svgAnnotationRules?: (annotation: Datum, index: number, context: any) => ReactNode;
+    svgAnnotationRules?: (annotation: Datum, index: number, context: {
+        width: number;
+        height: number;
+        sceneNodes?: AnnotationAnchorNode[];
+    }) => ReactNode;
     annotationFrame?: number;
 }
 /**
@@ -61,3 +66,4 @@ export declare function NetworkSVGOverlay(props: NetworkSVGOverlayProps): import
 export declare namespace NetworkSVGOverlay {
     var displayName: string;
 }
+export {};

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

@@ -1,6 +1,7 @@
 import type { ReactNode } from "react";
 import type { GeoProjection, GeoPath, GeoPermissibleObjects } from "d3-geo";
-import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, PointSceneNode, LineSceneNode, ThemeSemanticColors } from "./types";
+import type { GradientLegendConfig, LegendGroup } from "../types/legendTypes";
+import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, SceneDatum, PointSceneNode, ThemeSemanticColors } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
 import type { HoverAnnotationConfig, HoverData } from "../realtime/types";
 import type { GeoParticleStyle } from "./GeoParticlePool";
@@ -38,7 +39,7 @@ export interface GeoAreaSceneNode {
     /** Screen-space area in px² */
     screenArea: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     group?: string;
     interactive?: boolean;
     /** Lazily-cached Path2D parsed from pathData (avoids re-parsing on every hit test) */
@@ -47,8 +48,15 @@ export interface GeoAreaSceneNode {
     _pulseIntensity?: number;
     _pulseColor?: string;
 }
+export interface GeoLineSceneNode {
+    type: "line";
+    path: [number, number][];
+    style: Style;
+    datum: SceneDatum;
+    group?: string;
+}
 /** Union of all scene node types that GeoFrame produces */
-export type GeoSceneNode = GeoAreaSceneNode | PointSceneNode | LineSceneNode;
+export type GeoSceneNode = GeoAreaSceneNode | PointSceneNode | GeoLineSceneNode;
 export interface GeoScales {
     projection: GeoProjection;
     geoPath: GeoPath<any, GeoPermissibleObjects>;
@@ -62,7 +70,7 @@ export interface GeoPipelineConfig {
     fitPadding?: number;
     xAccessor?: string | ((d: Datum) => number);
     yAccessor?: string | ((d: Datum) => number);
-    lineDataAccessor?: string | ((d: Datum) => any[]);
+    lineDataAccessor?: string | ((d: Datum) => Datum[]);
     lineType?: "geo" | "line";
     /** Flow rendering style: "basic" (straight/great-circle), "offset" (bidirectional offset), "arc" (curved arcs) @default "basic" */
     flowStyle?: "basic" | "offset" | "arc";
@@ -70,7 +78,7 @@ export interface GeoPipelineConfig {
     pointStyle?: (d: Datum) => Style & {
         r?: number;
     };
-    lineStyle?: Style | ((d: any, group?: string) => Style);
+    lineStyle?: Style | ((d: Datum, group?: string) => Style);
     colorScheme?: string | string[];
     /** Theme-resolved semantic role colors — default fallback before hardcoded hex. See `ThemeSemanticColors` in ./types. */
     themeSemantic?: ThemeSemanticColors;
@@ -98,7 +106,7 @@ export interface StreamGeoFrameProps<T = Datum> {
     lines?: T[];
     xAccessor?: string | ((d: T) => number);
     yAccessor?: string | ((d: T) => number);
-    lineDataAccessor?: string | ((d: T) => any[]);
+    lineDataAccessor?: string | ((d: T) => Datum[]);
     pointIdAccessor?: string | ((d: T) => string);
     lineType?: "geo" | "line";
     /** Flow rendering style: "basic" (straight/great-circle), "offset" (bidirectional offset), "arc" (curved arcs) @default "basic" */
@@ -145,7 +153,7 @@ export interface StreamGeoFrameProps<T = Datum> {
     pointStyle?: (d: Datum) => Style & {
         r?: number;
     };
-    lineStyle?: Style | ((d: any, group?: string) => Style);
+    lineStyle?: Style | ((d: Datum, group?: string) => Style);
     colorScheme?: string | string[];
     enableHover?: boolean;
     hoverAnnotation?: boolean | HoverAnnotationConfig;
@@ -164,7 +172,11 @@ export interface StreamGeoFrameProps<T = Datum> {
     backgroundGraphics?: ReactNode;
     foregroundGraphics?: ReactNode;
     title?: string | ReactNode;
-    legend?: any;
+    legend?: ReactNode | {
+        legendGroups: LegendGroup[];
+    } | {
+        gradient: GradientLegendConfig;
+    };
     legendPosition?: "right" | "left" | "top" | "bottom";
     legendHoverBehavior?: (item: {
         label: string;

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

@@ -10,10 +10,15 @@
  * HoverData state that mouse hover does.
  */
 import type { HoverData } from "../realtime/types";
+import type { Datum } from "../charts/shared/datumTypes";
+import type { NetworkSceneEdge, NetworkSceneNode } from "./networkTypes";
+import type { SceneNode } from "./types";
+import type { OrdinalSceneNode } from "./ordinalTypes";
+import type { GeoSceneNode } from "./geoTypes";
 export interface NavPoint {
     x: number;
     y: number;
-    datum: any;
+    datum: Datum | null;
     /** Shape hint for focus ring rendering */
     shape?: "circle" | "rect" | "wedge";
     /** Width of rect-shaped elements (bars, sankey nodes) */
@@ -73,18 +78,18 @@ export declare function nextGraphIndex(key: string, pos: NavPosition, graph: Nav
  * Lines/areas carry a `group` field identifying the series.
  * ArrowRight/Left = within series, ArrowUp/Down = switch series.
  */
-export declare function extractXYNavPoints(scene: any[]): NavPoint[];
+export declare function extractXYNavPoints(scene: SceneNode[]): NavPoint[];
 /**
  * Extract navigable points from ordinal scene nodes.
  * Bars use `node.group` (stack/group key) falling back to `datum.category`.
  * ArrowRight/Left = across categories, ArrowUp/Down = within stacked segments.
  */
-export declare function extractOrdinalNavPoints(scene: any[]): NavPoint[];
+export declare function extractOrdinalNavPoints(scene: OrdinalSceneNode[]): NavPoint[];
 /**
  * Extract navigable points from network scene nodes.
  * Each node's group is its own id, enabling neighbor traversal via edges.
  */
-export declare function extractNetworkNavPoints(scene: any[]): NavPoint[];
+export declare function extractNetworkNavPoints(scene: NetworkSceneNode[]): NavPoint[];
 /**
  * Network-specific navigation: spatial arrow keys + edge following.
  *
@@ -94,14 +99,20 @@ export declare function extractNetworkNavPoints(scene: any[]): NavPoint[];
  *
  * Returns the flat index of the target node, -1 to clear, or null for unhandled keys.
  */
-export declare function nextNetworkIndex(key: string, pos: NavPosition, graph: NavGraph, edges: any[], neighborIndexRef: {
+export declare function nextNetworkIndex(key: string, pos: NavPosition, graph: NavGraph, edges: EdgeLike[], neighborIndexRef: {
     current: number;
 }): number | null;
+/** Collect neighbor node ids from edge list for a given node. */
+type EdgeLike = NetworkSceneEdge | {
+    source?: unknown;
+    target?: unknown;
+    datum?: Datum | null;
+};
 /**
  * Extract navigable points from geo scene nodes.
  * Flat navigation only (no meaningful grouping for geo).
  */
-export declare function extractGeoNavPoints(scene: any[]): NavPoint[];
+export declare function extractGeoNavPoints(scene: GeoSceneNode[]): NavPoint[];
 /**
  * Compute the next focus index given a key and current index.
  * Returns -1 to clear focus. Returns null for unhandled keys.
@@ -113,3 +124,4 @@ export declare function nextIndex(key: string, current: number, total: number):
  * Convert a NavPoint to HoverData for the tooltip system.
  */
 export declare function navPointToHover(point: NavPoint): HoverData;
+export {};

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

@@ -2,7 +2,7 @@ import type { ReactNode } from "react";
 import type { OnObservationCallback } from "../store/ObservationStore";
 import type { HoverData, AnnotationContext } from "../realtime/types";
 import type { LegendGroup } from "../types/legendTypes";
-import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors } from "./types";
+import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors, SceneDatum } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
 import type { Datum } from "../charts/shared/datumTypes";
 export interface TensionConfig {
@@ -58,7 +58,7 @@ export interface RealtimeEdge {
     _introFromZero?: boolean;
     direction?: string;
     circular?: boolean;
-    circularPathData?: any;
+    circularPathData?: CircularPathData;
     bezier?: BezierCache;
     data?: Datum;
     /** Unique key for this edge (supports parallel edges between same node pair) */
@@ -80,6 +80,27 @@ export interface BezierCache {
     segments?: Array<[BezierPoint, BezierPoint, BezierPoint, BezierPoint]>;
     halfWidth: number;
 }
+export interface CircularPathData {
+    sourceX: number;
+    targetX: number;
+    sourceY: number;
+    targetY: number;
+    rightFullExtent: number;
+    leftFullExtent: number;
+    verticalFullExtent: number;
+    rightInnerExtent: number;
+    leftInnerExtent: number;
+    verticalRightInnerExtent: number;
+    verticalLeftInnerExtent: number;
+    rightSmallArcRadius: number;
+    rightLargeArcRadius: number;
+    leftSmallArcRadius: number;
+    leftLargeArcRadius: number;
+    sourceWidth: number;
+    rightNodeBuffer: number;
+    leftNodeBuffer: number;
+    arcRadius: number;
+}
 export interface Particle {
     t: number;
     offset: number;
@@ -133,7 +154,7 @@ export interface RealtimeNetworkFrameProps {
     enableHover?: boolean;
     tooltipContent?: (d: {
         type: "node" | "edge";
-        data: any;
+        data: Datum | null;
     }) => ReactNode;
     onTopologyChange?: (nodes: RealtimeNode[], edges: RealtimeEdge[]) => void;
     background?: string;
@@ -147,7 +168,7 @@ export interface NetworkCircleNode {
     cy: number;
     r: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     id?: string;
     label?: string;
     depth?: number;
@@ -163,7 +184,7 @@ export interface NetworkRectNode {
     w: number;
     h: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     id?: string;
     label?: string;
     depth?: number;
@@ -184,7 +205,7 @@ export interface NetworkArcNode {
     /** End angle in radians, canvas convention */
     endAngle: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     id?: string;
     label?: string;
     _pulseIntensity?: number;
@@ -199,7 +220,7 @@ export interface NetworkLineEdge {
     x2: number;
     y2: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     _pulseIntensity?: number;
     _pulseColor?: string;
 }
@@ -209,7 +230,7 @@ export interface NetworkBezierEdge {
     pathD: string;
     bezierCache?: BezierCache;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     _pulseIntensity?: number;
     _pulseColor?: string;
     /** Lazily-built Path2D for hit testing; invalidated when pathD changes. */
@@ -221,7 +242,7 @@ export interface NetworkRibbonEdge {
     type: "ribbon";
     pathD: string;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     _pulseIntensity?: number;
     _pulseColor?: string;
     _cachedPath2D?: Path2D;
@@ -232,7 +253,7 @@ export interface NetworkCurvedEdge {
     type: "curved";
     pathD: string;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     _pulseIntensity?: number;
     _pulseColor?: string;
     _cachedPath2D?: Path2D;
@@ -306,18 +327,18 @@ export interface NetworkPipelineConfig {
     valueAccessor?: string | ((d: Datum) => number);
     /** Edge ID accessor for removeEdge(edgeId) — enables single-ID edge removal */
     edgeIdAccessor?: string | ((d: Datum) => string);
-    childrenAccessor?: string | ((d: Datum) => any[]);
+    childrenAccessor?: string | ((d: Datum) => Datum[]);
     hierarchySum?: string | ((d: Datum) => number);
     orientation?: "horizontal" | "vertical";
     nodeAlign?: "justify" | "left" | "right" | "center";
     nodePaddingRatio?: number;
     nodeWidth?: number;
-    edgeSort?: (a: any, b: any) => number;
+    edgeSort?: (a: unknown, b: unknown) => number;
     iterations?: number;
     forceStrength?: number;
     padAngle?: number;
     groupWidth?: number;
-    sortGroups?: (a: any, b: any) => number;
+    sortGroups?: (a: unknown, b: unknown) => number;
     treeOrientation?: "vertical" | "horizontal" | "radial";
     edgeType?: "line" | "curve";
     padding?: number;
@@ -352,11 +373,11 @@ export interface NetworkPipelineConfig {
      *  "atomic" ([2,8] electron shell), or custom capacities. @default "flat" */
     orbitMode?: "flat" | "solar" | "atomic" | number[];
     /** Ring size divisor per depth. Larger = tighter orbits. @default 2.95 */
-    orbitSize?: number | ((node: any) => number);
+    orbitSize?: number | ((node: Datum) => number);
     /** Orbit speed multiplier (higher = faster rotation). @default 0.25 */
     orbitSpeed?: number;
     /** Per-node speed modifier. @default (node) => 1 / (node.depth + 1) */
-    orbitRevolution?: (node: any) => number;
+    orbitRevolution?: (node: Datum) => number;
     /**
      * Built-in revolution style presets:
      * - "locked": children rotate with parent at decreasing speed (default)
@@ -367,7 +388,7 @@ export interface NetworkPipelineConfig {
      */
     orbitRevolutionStyle?: "locked" | "decay" | "alternate";
     /** Vertical squash for elliptical orbits. 1 = circle. @default 1 */
-    orbitEccentricity?: number | ((node: any) => number);
+    orbitEccentricity?: number | ((node: Datum) => number);
     /** Show orbital ring ellipses as foreground graphics. @default true */
     orbitShowRings?: boolean;
     /** Enable orbit animation. @default true */
@@ -405,8 +426,8 @@ export interface StreamNetworkFrameProps<T = Datum> {
     forceStrength?: number;
     padAngle?: number;
     groupWidth?: number;
-    sortGroups?: (a: any, b: any) => number;
-    edgeSort?: (a: any, b: any) => number;
+    sortGroups?: (a: unknown, b: unknown) => number;
+    edgeSort?: (a: unknown, b: unknown) => number;
     treeOrientation?: "vertical" | "horizontal" | "radial";
     edgeType?: "line" | "curve";
     padding?: number;
@@ -473,11 +494,11 @@ export interface StreamNetworkFrameProps<T = Datum> {
     staleness?: StalenessConfig;
     thresholds?: ThresholdAlertConfig;
     orbitMode?: "flat" | "solar" | "atomic" | number[];
-    orbitSize?: number | ((node: any) => number);
+    orbitSize?: number | ((node: Datum) => number);
     orbitSpeed?: number;
-    orbitRevolution?: (node: any) => number;
+    orbitRevolution?: (node: Datum) => number;
     orbitRevolutionStyle?: "locked" | "decay" | "alternate";
-    orbitEccentricity?: number | ((node: any) => number);
+    orbitEccentricity?: number | ((node: Datum) => number);
     orbitShowRings?: boolean;
     orbitAnimated?: boolean;
     /** Render a visually-hidden data table from the scene graph for screen readers */

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

@@ -1,7 +1,7 @@
 import type { ReactNode } from "react";
 import type { ScaleLinear, ScaleBand } from "d3-scale";
 import type { WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext } from "../realtime/types";
-import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors } from "./types";
+import type { Style, SceneDatum, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
 import type { LegendGroup } from "../types/legendTypes";
 import type { Datum } from "../charts/shared/datumTypes";
@@ -24,7 +24,7 @@ export interface WedgeSceneNode {
     /** Corner radius for rounded wedge arcs (d3-shape arc.cornerRadius) */
     cornerRadius?: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     category?: string;
     _pulseIntensity?: number;
     _pulseColor?: string;
@@ -50,13 +50,13 @@ export interface BoxplotSceneNode {
     maxPos: number;
     stats: DistributionStats;
     style: Style;
-    datum: any;
+    datum: Datum;
     category?: string;
     outliers?: {
         px: number;
         py: number;
         value: number;
-        datum: any;
+        datum: Datum;
     }[];
     _pulseIntensity?: number;
     _pulseColor?: string;
@@ -98,7 +98,7 @@ export interface ViolinSceneNode {
     /** Pre-computed distribution statistics for tooltips */
     stats?: DistributionStats;
     style: Style;
-    datum: any;
+    datum: Datum;
     category?: string;
     _pulseIntensity?: number;
     _pulseColor?: string;
@@ -113,7 +113,7 @@ export interface ConnectorSceneNode {
     x2: number;
     y2: number;
     style: Style;
-    datum: any;
+    datum: Datum;
     group?: string;
     _pulseIntensity?: number;
     _pulseColor?: string;
@@ -126,7 +126,7 @@ export interface TrapezoidSceneNode {
     /** Four corners: [top-left, top-right, bottom-right, bottom-left] */
     points: [number, number][];
     style: Style;
-    datum: any;
+    datum: Datum;
     category?: string;
     _pulseIntensity?: number;
     _pulseColor?: string;
@@ -205,9 +205,9 @@ export interface OrdinalPipelineConfig {
     oSort?: ((a: string, b: string) => number) | boolean | "asc" | "desc" | "auto";
     connectorAccessor?: string | ((d: Datum) => string);
     connectorStyle?: Style | ((d: Datum) => Style);
-    dynamicColumnWidth?: string | ((data: any[]) => number);
-    pieceStyle?: (d: any, category?: string) => Style;
-    summaryStyle?: (d: any, category?: string) => Style;
+    dynamicColumnWidth?: string | ((data: Datum[]) => number);
+    pieceStyle?: (d: Datum, category?: string) => Style;
+    summaryStyle?: (d: Datum, category?: string) => Style;
     colorScheme?: string | string[];
     themeCategorical?: string[];
     /** Theme-resolved semantic role colors — default fallback before hardcoded hex. See `ThemeSemanticColors` in ./types. */
@@ -293,8 +293,8 @@ export interface StreamOrdinalFrameProps<T = Datum> {
     rTickValues?: number[];
     /** Align first tick label to start and last tick label to end. Default false. */
     tickLabelEdgeAlign?: boolean;
-    pieceStyle?: (d: any, category?: string) => Style;
-    summaryStyle?: (d: any, category?: string) => Style;
+    pieceStyle?: (d: Datum, category?: string) => Style;
+    summaryStyle?: (d: Datum, category?: string) => Style;
     colorScheme?: string | string[];
     barColors?: Record<string, string>;
     showAxes?: boolean;

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

@@ -1,8 +1,12 @@
 import type { ReactNode } from "react";
 import type { ScaleLinear } from "d3-scale";
 import type { AnimateProp } from "./pipelineTransitionUtils";
+import type { LegendGroup, GradientLegendConfig } from "../types/legendTypes";
 import type { ArrowOfTime, WindowMode, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, HoverAnnotationConfig, HoverData, AnnotationContext, AnnotationAnchorMode } from "../realtime/types";
 import type { Datum } from "../charts/shared/datumTypes";
+export type SceneDatum = Datum | null;
+export type SeriesDatum = Datum[] | null;
+export type AxisTickFormat = ((d: number, index?: number, allTicks?: number[]) => string) | ((d: string, index?: number, allTicks?: number[]) => string) | ((d: Date, index?: number, allTicks?: number[]) => string);
 export interface ThemeSemanticColors {
     primary?: string;
     secondary?: string;
@@ -100,7 +104,7 @@ export interface LineSceneNode {
     /** Threshold-based color segments */
     colorThresholds?: LineColorThreshold[];
     style: Style;
-    datum: any;
+    datum: SeriesDatum;
     group?: string;
     /** Horizontal gradient for the line stroke */
     strokeGradient?: {
@@ -131,7 +135,7 @@ export interface AreaSceneNode {
     topPath: [number, number][];
     bottomPath: [number, number][];
     style: Style;
-    datum: any;
+    datum: SeriesDatum;
     group?: string;
     /** Gradient fill: opacity-based (topOpacity/bottomOpacity) or multi-color (colorStops) */
     fillGradient?: {
@@ -183,7 +187,7 @@ export interface PointSceneNode {
     y: number;
     r: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     /** Optional unique identifier for point-anchored annotations */
     pointId?: string;
     /** Pulse glow intensity 0–1 (set by PipelineStore when pulse is active) */
@@ -227,7 +231,7 @@ export interface RectSceneNode {
         }>;
     };
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     group?: string;
     _pulseIntensity?: number;
     _pulseColor?: string;
@@ -249,7 +253,7 @@ export interface HeatcellSceneNode {
     w: number;
     h: number;
     fill: string;
-    datum: any;
+    datum: SceneDatum;
     /** Optional style object (used for decay/transition opacity on heatmap cells) */
     style?: Style;
     /** Numeric cell value (for canvas text rendering when showValues is enabled) */
@@ -286,7 +290,7 @@ export interface CandlestickSceneNode {
     isUp: boolean;
     /** Range/dumbbell mode — no body, endpoint dots instead */
     isRange?: boolean;
-    datum: any;
+    datum: SceneDatum;
     /** Optional style object (used during transition opacity animations) */
     style?: Style;
     _pulseIntensity?: number;
@@ -446,7 +450,7 @@ export interface StreamXYFrameProps<T = Datum> {
         orient: "left" | "right" | "top" | "bottom";
         label?: string;
         ticks?: number;
-        tickFormat?: (d: any, index?: number, allTicks?: number[]) => string;
+        tickFormat?: AxisTickFormat;
         baseline?: boolean | "under";
         jaggedBase?: boolean;
     }>;
@@ -489,9 +493,9 @@ export interface StreamXYFrameProps<T = Datum> {
     svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
     showGrid?: boolean;
     legend?: ReactNode | {
-        legendGroups: any[];
+        legendGroups: LegendGroup[];
     } | {
-        gradient: import("../types/legendTypes").GradientLegendConfig;
+        gradient: GradientLegendConfig;
     };
     legendHoverBehavior?: (item: {
         label: string;