semiotic 3.4.0 → 3.4.1

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

@@ -1,23 +1,3 @@
-/**
- * XYBrushOverlay — d3-brush SVG overlay for XY frames.
- *
- * Renders a transparent SVG positioned above the canvas. Supports x, y, and
- * xy brush dimensions, bin snapping, and streaming brush tracking (shrinks/
- * clears the brush as data scrolls past the selected range).
- *
- * Key design decisions:
- *   - d3-brush lifecycle depends on [width, height, dimension, snap, binSize, snapDuring]
- *     only — scales and binBoundaries are read from refs to avoid teardown mid-drag.
- *   - Data-driven snapping (binBoundaries) uses binary search to snap to actual bin
- *     edges. Falls back to uniform grid math (binSize) when no boundaries are provided.
- *   - Bin snapping applies on "end" events by default. Set snapDuring=true to also
- *     snap during drag (the "brush" event).
- *   - Streaming tracking guards against y-only dimension (no x-domain to track).
- *   - isProgrammaticMoveRef prevents re-entrant brush events from .move() calls.
- *
- * Consumed by: StreamXYFrame (rendered when brush prop is set).
- */
-import * as React from "react";
 import type { StreamScales } from "./types";
 export interface XYBrushOverlayProps {
     width: number;
@@ -44,4 +24,4 @@ export interface XYBrushOverlayProps {
     snapDuring?: boolean;
     streaming?: boolean;
 }
-export declare function XYBrushOverlay({ width, height, totalWidth, totalHeight, margin, dimension, scales, onBrush, binSize, snap, binBoundaries, snapDuring, streaming }: XYBrushOverlayProps): React.JSX.Element;
+export declare function XYBrushOverlay({ width, height, totalWidth, totalHeight, margin, dimension, scales, onBrush, binSize, snap, binBoundaries, snapDuring, streaming }: XYBrushOverlayProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,13 +1,4 @@
-/**
- * Dev-mode helper that warns when user callbacks access properties that exist
- * on `.data` but not on the RealtimeNode/RealtimeEdge wrapper.
- *
- * Common pitfall:
- *   nodeStyle={(d) => ({ fill: d.category })}     // undefined!
- *   nodeStyle={(d) => ({ fill: d.data?.category })} // correct
- *
- * In production, this is a no-op passthrough.
- */
+import type { Datum } from "../charts/shared/datumTypes";
 export declare function wrapWithDataHint<T extends {
-    data?: Record<string, any>;
+    data?: Datum;
 }>(datum: T, callbackName: string): T;

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

@@ -1,9 +1,10 @@
 import type { ReactNode } from "react";
 import type { GeoProjection, GeoPath, GeoPermissibleObjects } from "d3-geo";
-import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, PointSceneNode, LineSceneNode } from "./types";
+import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, PointSceneNode, LineSceneNode, ThemeSemanticColors } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
 import type { HoverAnnotationConfig, HoverData } from "../realtime/types";
 import type { GeoParticleStyle } from "./GeoParticlePool";
+import type { Datum } from "../charts/shared/datumTypes";
 export type ProjectionProp = GeoProjection | ProjectionName | ProjectionConfig;
 export type ProjectionName = "mercator" | "equalEarth" | "albersUsa" | "orthographic" | "naturalEarth" | "equirectangular";
 export interface ProjectionConfig {
@@ -21,8 +22,8 @@ export interface GraticuleConfig {
 }
 export interface DistanceCartogramConfig {
     center: string;
-    centerAccessor?: string | ((d: any) => string);
-    costAccessor: string | ((d: any) => number);
+    centerAccessor?: string | ((d: Datum) => string);
+    costAccessor: string | ((d: Datum) => number);
     strength?: number;
     lineMode?: "straight" | "fractional";
 }
@@ -59,18 +60,24 @@ export interface GeoPipelineConfig {
     projectionExtent?: [[number, number], [number, number]];
     /** Padding fraction for auto-fit projection. 0.1 = 10% inset from edges. @default 0 */
     fitPadding?: number;
-    xAccessor?: string | ((d: any) => number);
-    yAccessor?: string | ((d: any) => number);
-    lineDataAccessor?: string | ((d: any) => any[]);
+    xAccessor?: string | ((d: Datum) => number);
+    yAccessor?: string | ((d: Datum) => number);
+    lineDataAccessor?: string | ((d: Datum) => any[]);
     lineType?: "geo" | "line";
     /** Flow rendering style: "basic" (straight/great-circle), "offset" (bidirectional offset), "arc" (curved arcs) @default "basic" */
     flowStyle?: "basic" | "offset" | "arc";
-    areaStyle?: Style | ((d: any) => Style);
-    pointStyle?: (d: any) => Style & {
+    areaStyle?: Style | ((d: Datum) => Style);
+    pointStyle?: (d: Datum) => Style & {
         r?: number;
     };
     lineStyle?: Style | ((d: any, group?: string) => Style);
     colorScheme?: string | string[];
+    /** Theme-resolved semantic role colors — default fallback before hardcoded hex. See `ThemeSemanticColors` in ./types. */
+    themeSemantic?: ThemeSemanticColors;
+    /** Theme sequential scheme name — fallback for ChoroplethMap when colorScheme is not set. */
+    themeSequential?: string;
+    /** Theme diverging scheme name — available for geo consumers that need midpoint encodings. */
+    themeDiverging?: string;
     graticule?: boolean | GraticuleConfig;
     projectionTransform?: DistanceCartogramConfig;
     decay?: DecayConfig;
@@ -78,10 +85,10 @@ export interface GeoPipelineConfig {
     transition?: TransitionConfig;
     /** Whether to animate elements on first render */
     introAnimation?: boolean;
-    annotations?: Record<string, any>[];
-    pointIdAccessor?: string | ((d: any) => string);
+    annotations?: Datum[];
+    pointIdAccessor?: string | ((d: Datum) => string);
 }
-export interface StreamGeoFrameProps<T = Record<string, any>> {
+export interface StreamGeoFrameProps<T = Datum> {
     projection: ProjectionProp;
     projectionExtent?: [[number, number], [number, number]];
     /** Padding fraction for auto-fit projection. 0.1 = 10% inset from edges. @default 0 */
@@ -134,8 +141,8 @@ export interface StreamGeoFrameProps<T = Record<string, any>> {
     className?: string;
     background?: string;
     runtimeMode?: "bounded" | "streaming";
-    areaStyle?: Style | ((d: any) => Style);
-    pointStyle?: (d: any) => Style & {
+    areaStyle?: Style | ((d: Datum) => Style);
+    pointStyle?: (d: Datum) => Style & {
         r?: number;
     };
     lineStyle?: Style | ((d: any, group?: string) => Style);
@@ -145,7 +152,7 @@ export interface StreamGeoFrameProps<T = Record<string, any>> {
     tooltipContent?: (d: HoverData) => ReactNode;
     customClickBehavior?: (d: HoverData | null) => void;
     customHoverBehavior?: (d: HoverData | null) => void;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     decay?: DecayConfig;
     pulse?: PulseConfig;
     transition?: TransitionConfig;
@@ -176,10 +183,10 @@ export interface StreamGeoFrameProps<T = Record<string, any>> {
     summary?: string;
 }
 export interface StreamGeoFrameHandle {
-    push(datum: Record<string, any>): void;
-    pushMany(data: Record<string, any>[]): void;
+    push(datum: Datum): void;
+    pushMany(data: Datum[]): void;
     /** Remove points by ID. Requires pointIdAccessor. */
-    removePoint(id: string | string[]): Record<string, any>[];
+    removePoint(id: string | string[]): Datum[];
     clear(): void;
     getProjection(): GeoProjection | null;
     getGeoPath(): GeoPath<any, GeoPermissibleObjects> | null;
@@ -195,5 +202,5 @@ export interface StreamGeoFrameHandle {
     /** Animate back to initial view */
     resetZoom(): void;
     /** Get current data points */
-    getData(): Record<string, any>[];
+    getData(): Datum[];
 }

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * Shared hover data utilities for stream frames.
  *
@@ -25,7 +26,7 @@ export interface HoverPointerCoords {
  * this matches the historical behavior where all datum fields are
  * accessible directly on the hover object (d.fieldName).
  */
-export declare function spreadDatum(rawDatum: any): Record<string, any>;
+export declare function spreadDatum(rawDatum: any): Datum;
 /**
  * Build a HoverData object from a raw datum and pixel coordinates.
  * Spreads plain-object datum properties for backwards compatibility

package/dist/components/stream/layouts/hierarchySceneBuilders.d.ts

@@ -13,17 +13,18 @@
  * Consumed by: hierarchyLayoutPlugin.ts (buildScene dispatcher)
  */
 import type { NetworkPipelineConfig, NetworkSceneNode, NetworkSceneEdge, NetworkLabel, RealtimeNode, RealtimeEdge } from "../networkTypes";
-export declare function buildTreeScene(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number], nodeStyleFn: (d: any) => Record<string, any>, edgeStyleFn: (d: any) => Record<string, any>): {
+import type { Style } from "../types";
+export declare function buildTreeScene(nodes: RealtimeNode[], edges: RealtimeEdge[], config: NetworkPipelineConfig, size: [number, number], nodeStyleFn: (d: RealtimeNode) => Style, edgeStyleFn: (d: RealtimeEdge) => Style): {
     sceneNodes: NetworkSceneNode[];
     sceneEdges: NetworkSceneEdge[];
     labels: NetworkLabel[];
 };
-export declare function buildRectScene(nodes: RealtimeNode[], config: NetworkPipelineConfig, size: [number, number], nodeStyleFn: (d: any) => Record<string, any>): {
+export declare function buildRectScene(nodes: RealtimeNode[], config: NetworkPipelineConfig, size: [number, number], nodeStyleFn: (d: RealtimeNode) => Style): {
     sceneNodes: NetworkSceneNode[];
     sceneEdges: NetworkSceneEdge[];
     labels: NetworkLabel[];
 };
-export declare function buildCircleScene(nodes: RealtimeNode[], config: NetworkPipelineConfig, size: [number, number], nodeStyleFn: (d: any) => Record<string, any>): {
+export declare function buildCircleScene(nodes: RealtimeNode[], config: NetworkPipelineConfig, size: [number, number], nodeStyleFn: (d: RealtimeNode) => Style): {
     sceneNodes: NetworkSceneNode[];
     sceneEdges: NetworkSceneEdge[];
     labels: NetworkLabel[];

package/dist/components/stream/layouts/hierarchyUtils.d.ts

@@ -7,6 +7,7 @@
  * Consumed by: hierarchyLayoutPlugin.ts, hierarchySceneBuilders.ts
  */
 import type { NetworkPipelineConfig } from "../networkTypes";
+import type { Datum } from "../../charts/shared/datumTypes";
 /** Depth-based color palette shared across all hierarchy scene builders */
 export declare const DEPTH_PALETTE: string[];
 /**
@@ -19,7 +20,7 @@ export declare function parseColor(color: string): [number, number, number];
  * Uses perceived luminance (ITU-R BT.601).
  */
 export declare function contrastTextColor(bgColor: string): string;
-export declare function resolveChildrenAccessor(accessor: string | ((d: any) => any[]) | undefined): ((d: any) => any[]) | undefined;
+export declare function resolveChildrenAccessor(accessor: string | ((d: Datum) => any[]) | undefined): ((d: Datum) => any[]) | undefined;
 export declare function resolveNodeId(d: any, config: NetworkPipelineConfig, index: number): string;
-export declare function resolveLabelFn(nodeLabel: string | ((d: any) => string) | undefined): ((d: any) => string) | null;
-export declare function resolveDefaultNodeSize(nodeSize: number | string | ((d: any) => number) | undefined): number;
+export declare function resolveLabelFn(nodeLabel: string | ((d: Datum) => string) | undefined): ((d: Datum) => string) | null;
+export declare function resolveDefaultNodeSize(nodeSize: number | string | ((d: Datum) => number) | undefined): number;

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

@@ -2,8 +2,9 @@ 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 } from "./types";
+import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig, ThemeSemanticColors } from "./types";
 import type { AnimateProp } from "./pipelineTransitionUtils";
+import type { Datum } from "../charts/shared/datumTypes";
 export interface TensionConfig {
     weightChange: number;
     newEdge: number;
@@ -32,7 +33,7 @@ export interface RealtimeNode {
     _targetY1?: number;
     value: number;
     depth?: number;
-    data?: Record<string, any>;
+    data?: Datum;
     createdByFrame?: boolean;
     sourceLinks?: RealtimeEdge[];
     targetLinks?: RealtimeEdge[];
@@ -59,7 +60,7 @@ export interface RealtimeEdge {
     circular?: boolean;
     circularPathData?: any;
     bezier?: BezierCache;
-    data?: Record<string, any>;
+    data?: Datum;
     /** Unique key for this edge (supports parallel edges between same node pair) */
     _edgeKey?: string;
     _pulseIntensity?: number;
@@ -299,14 +300,14 @@ export interface ThresholdAlertConfig {
 }
 export interface NetworkPipelineConfig {
     chartType: NetworkChartType;
-    nodeIDAccessor?: string | ((d: any) => string);
-    sourceAccessor?: string | ((d: any) => string);
-    targetAccessor?: string | ((d: any) => string);
-    valueAccessor?: string | ((d: any) => number);
+    nodeIDAccessor?: string | ((d: Datum) => string);
+    sourceAccessor?: string | ((d: Datum) => string);
+    targetAccessor?: string | ((d: Datum) => string);
+    valueAccessor?: string | ((d: Datum) => number);
     /** Edge ID accessor for removeEdge(edgeId) — enables single-ID edge removal */
-    edgeIdAccessor?: string | ((d: any) => string);
-    childrenAccessor?: string | ((d: any) => any[]);
-    hierarchySum?: string | ((d: any) => number);
+    edgeIdAccessor?: string | ((d: Datum) => string);
+    childrenAccessor?: string | ((d: Datum) => any[]);
+    hierarchySum?: string | ((d: Datum) => number);
     orientation?: "horizontal" | "vertical";
     nodeAlign?: "justify" | "left" | "right" | "center";
     nodePaddingRatio?: number;
@@ -324,17 +325,21 @@ export interface NetworkPipelineConfig {
     tensionConfig?: TensionConfig;
     showParticles?: boolean;
     particleStyle?: ParticleStyle;
-    nodeStyle?: (d: any) => Record<string, any>;
-    edgeStyle?: (d: any) => Record<string, any>;
-    nodeLabel?: string | ((d: any) => string);
+    nodeStyle?: (d: Datum) => Datum;
+    edgeStyle?: (d: Datum) => Datum;
+    nodeLabel?: string | ((d: Datum) => string);
     showLabels?: boolean;
     labelMode?: "leaf" | "parent" | "all";
-    colorBy?: string | ((d: any) => string | number);
+    colorBy?: string | ((d: Datum) => string | number);
     colorScheme?: string | string[];
-    edgeColorBy?: "source" | "target" | "gradient" | ((d: any) => string);
+    /** Theme categorical palette — used as fallback when colorScheme is not an explicit array */
+    themeCategorical?: string[];
+    /** Theme-resolved semantic role colors — default fallback before hardcoded hex. See `ThemeSemanticColors` in ./types. */
+    themeSemantic?: ThemeSemanticColors;
+    edgeColorBy?: "source" | "target" | "gradient" | ((d: Datum) => string);
     edgeOpacity?: number;
     colorByDepth?: boolean;
-    nodeSize?: number | string | ((d: any) => number);
+    nodeSize?: number | string | ((d: Datum) => number);
     nodeSizeRange?: [number, number];
     decay?: DecayConfig;
     pulse?: PulseConfig;
@@ -377,7 +382,7 @@ export interface NetworkPipelineConfig {
         y: number;
     }>;
 }
-export interface StreamNetworkFrameProps<T = Record<string, any>> {
+export interface StreamNetworkFrameProps<T = Datum> {
     chartType: NetworkChartType;
     nodes?: T[];
     edges?: T[] | T;
@@ -389,7 +394,7 @@ export interface StreamNetworkFrameProps<T = Record<string, any>> {
     targetAccessor?: string | ((d: T) => string);
     valueAccessor?: string | ((d: T) => number);
     /** Edge ID accessor for removeEdge(edgeId) single-ID removal */
-    edgeIdAccessor?: string | ((d: any) => string);
+    edgeIdAccessor?: string | ((d: Datum) => string);
     childrenAccessor?: string | ((d: T) => T[]);
     hierarchySum?: string | ((d: T) => number);
     orientation?: "horizontal" | "vertical";
@@ -409,16 +414,16 @@ export interface StreamNetworkFrameProps<T = Record<string, any>> {
     tensionConfig?: Partial<TensionConfig>;
     showParticles?: boolean;
     particleStyle?: ParticleStyle;
-    nodeStyle?: (d: any) => Record<string, any>;
-    edgeStyle?: (d: any) => Record<string, any>;
-    colorBy?: string | ((d: any) => string | number);
+    nodeStyle?: (d: Datum) => Datum;
+    edgeStyle?: (d: Datum) => Datum;
+    colorBy?: string | ((d: Datum) => string | number);
     colorScheme?: string | string[];
-    edgeColorBy?: "source" | "target" | "gradient" | ((d: any) => string);
+    edgeColorBy?: "source" | "target" | "gradient" | ((d: Datum) => string);
     edgeOpacity?: number;
     colorByDepth?: boolean;
-    nodeSize?: number | string | ((d: any) => number);
+    nodeSize?: number | string | ((d: Datum) => number);
     nodeSizeRange?: [number, number];
-    nodeLabel?: string | ((d: any) => string);
+    nodeLabel?: string | ((d: Datum) => string);
     showLabels?: boolean;
     labelMode?: "leaf" | "parent" | "all";
     size?: [number, number];
@@ -441,8 +446,8 @@ export interface StreamNetworkFrameProps<T = Record<string, any>> {
     /** Chart instance identifier for observation filtering */
     chartId?: string;
     onTopologyChange?: (nodes: RealtimeNode[], edges: RealtimeEdge[]) => void;
-    annotations?: Record<string, any>[];
-    svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
+    annotations?: Datum[];
+    svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
     legend?: ReactNode | {
         legendGroups: LegendGroup[];
     };
@@ -490,9 +495,9 @@ export interface StreamNetworkFrameHandle {
     /** Remove edges by source+target, or by edge ID when edgeIdAccessor is configured. */
     removeEdge(sourceIdOrEdgeId: string, targetId?: string): boolean;
     /** Update a node's data by ID. Returns previous data. */
-    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+target. Returns array of previous data. */
-    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[];
     clear(): void;
     getTopology(): {
         nodes: RealtimeNode[];

package/dist/components/stream/ordinalSceneBuilders/barFunnelScene.d.ts

@@ -24,4 +24,4 @@ import type { OrdinalSceneContext } from "./types";
  *  - __barFunnelCategory: category key (for multi-category)
  *  - __barFunnelLabelX/Y: position for the floating label
  */
-export declare function buildBarFunnelScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildBarFunnelScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];

package/dist/components/stream/ordinalSceneBuilders/barScene.d.ts

@@ -1,4 +1,4 @@
 import type { OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
 import type { OrdinalSceneContext } from "./types";
-export declare function buildBarScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
-export declare function buildClusterBarScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildBarScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildClusterBarScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];

package/dist/components/stream/ordinalSceneBuilders/connectorScene.d.ts

@@ -1,3 +1,3 @@
 import type { ConnectorSceneNode, OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
 import type { OrdinalSceneContext } from "./types";
-export declare function buildConnectors(ctx: OrdinalSceneContext, pieceNodes: OrdinalSceneNode[], layout: OrdinalLayout): ConnectorSceneNode[];
+export declare function buildConnectors(ctx: OrdinalSceneContext, pieceNodes: OrdinalSceneNode[], _layout: OrdinalLayout): ConnectorSceneNode[];

package/dist/components/stream/ordinalSceneBuilders/pointScene.d.ts

@@ -1,4 +1,4 @@
 import type { OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
 import type { OrdinalSceneContext } from "./types";
-export declare function buildPointScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
-export declare function buildSwarmScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildPointScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildSwarmScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];

package/dist/components/stream/ordinalSceneBuilders/statisticalScene.d.ts

@@ -1,6 +1,6 @@
 import type { OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
 import type { OrdinalSceneContext } from "./types";
-export declare function buildBoxplotScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
-export declare function buildViolinScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
-export declare function buildHistogramScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
-export declare function buildRidgelineScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildBoxplotScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildViolinScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildHistogramScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildRidgelineScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];

package/dist/components/stream/ordinalSceneBuilders/swimlaneScene.d.ts

@@ -9,4 +9,4 @@ import type { OrdinalSceneContext } from "./types";
  * multiple items with the same subcategory can appear in the same lane —
  * they simply stack sequentially.
  */
-export declare function buildSwimlaneScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildSwimlaneScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];

package/dist/components/stream/ordinalSceneBuilders/timelineScene.d.ts

@@ -1,3 +1,3 @@
 import type { OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
 import type { OrdinalSceneContext } from "./types";
-export declare function buildTimelineScene(ctx: OrdinalSceneContext, layout: OrdinalLayout): OrdinalSceneNode[];
+export declare function buildTimelineScene(ctx: OrdinalSceneContext, _layout: OrdinalLayout): OrdinalSceneNode[];

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

@@ -1,21 +1,22 @@
 import type { ScaleLinear } from "d3-scale";
 import type { OrdinalScales, OrdinalColumn, OrdinalPipelineConfig, OrdinalSceneNode, OrdinalLayout } from "../ordinalTypes";
 import type { Style } from "../types";
+import type { Datum } from "../../charts/shared/datumTypes";
 export interface OrdinalSceneContext {
     scales: OrdinalScales;
     columns: Record<string, OrdinalColumn>;
     config: OrdinalPipelineConfig;
-    getR: (d: any) => number;
-    getStack?: (d: any) => string;
-    getGroup?: (d: any) => string;
-    getColor?: (d: any) => string;
-    getConnector?: (d: any) => string;
-    getO: (d: any) => string;
+    getR: (d: Datum) => number;
+    getStack?: (d: Datum) => string;
+    getGroup?: (d: Datum) => string;
+    getColor?: (d: Datum) => string;
+    getConnector?: (d: Datum) => string;
+    getO: (d: Datum) => string;
     multiScales: ScaleLinear<number, number>[];
-    rAccessors: ((d: any) => number)[];
+    rAccessors: ((d: Datum) => number)[];
     resolvePieceStyle: (d: any, category?: string) => Style;
     resolveSummaryStyle: (d: any, category?: string) => Style;
     /** For timeline: resolve rAccessor as [start, end] */
-    getRawRange: (d: any) => [number, number] | null;
+    getRawRange: (d: Datum) => [number, number] | null;
 }
 export type SceneBuilderFn = (ctx: OrdinalSceneContext, layout: OrdinalLayout) => OrdinalSceneNode[];

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

@@ -1,9 +1,10 @@
 import type { ReactNode } from "react";
 import type { ScaleLinear, ScaleBand } from "d3-scale";
-import type { ArrowOfTime, WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext } from "../realtime/types";
-import type { Style, DecayConfig, PulseConfig, TransitionConfig, StalenessConfig } from "./types";
+import type { WindowMode, HoverAnnotationConfig, HoverData, AnnotationContext } from "../realtime/types";
+import type { Style, 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";
 export type OrdinalChartType = "bar" | "clusterbar" | "point" | "swarm" | "pie" | "donut" | "boxplot" | "violin" | "histogram" | "ridgeline" | "timeline" | "funnel" | "bar-funnel" | "swimlane";
 export interface OrdinalScales {
     o: ScaleBand<string>;
@@ -143,7 +144,7 @@ export interface OrdinalColumn {
     width: number;
     middle: number;
     padding: number;
-    pieceData: Record<string, any>[];
+    pieceData: Datum[];
     /** For radial: proportion of total (0-1) */
     pct: number;
     /** For radial: cumulative start proportion */
@@ -156,22 +157,36 @@ export interface OrdinalPipelineConfig {
     windowMode: WindowMode;
     extentPadding: number;
     projection: "vertical" | "horizontal" | "radial";
-    categoryAccessor?: string | ((d: any) => string);
-    valueAccessor?: string | ((d: any) => number) | Array<string | ((d: any) => number)>;
-    colorAccessor?: string | ((d: any) => string);
-    stackBy?: string | ((d: any) => string);
-    groupBy?: string | ((d: any) => string);
-    timeAccessor?: string | ((d: any) => number);
+    categoryAccessor?: string | ((d: Datum) => string);
+    valueAccessor?: string | ((d: Datum) => number) | Array<string | ((d: Datum) => number)>;
+    colorAccessor?: string | ((d: Datum) => string);
+    stackBy?: string | ((d: Datum) => string);
+    groupBy?: string | ((d: Datum) => string);
+    timeAccessor?: string | ((d: Datum) => number);
     /** @deprecated Use categoryAccessor */
-    oAccessor?: string | ((d: any) => string);
+    oAccessor?: string | ((d: Datum) => string);
     /** @deprecated Use valueAccessor */
-    rAccessor?: string | ((d: any) => number) | Array<string | ((d: any) => number)>;
+    rAccessor?: string | ((d: Datum) => number) | Array<string | ((d: Datum) => number)>;
     multiAxis?: boolean;
     rExtent?: [number?, number?];
     oExtent?: string[];
     barPadding?: number;
     /** Rounded top corner radius for bar charts. Only the end away from the baseline is rounded. For stacked bars, only the topmost segment gets rounded. */
     roundedTop?: number;
+    /** Gradient fill for bar rects. `{ topOpacity, bottomOpacity }` fades the
+     *  resolved fill color from tip (opposite the baseline) to base; `{ colorStops }`
+     *  renders a multi-color gradient along the same axis. Direction follows the
+     *  bar's orientation (tip → base). Same shape as AreaChart.gradientFill
+     *  sans the `boolean` case — the HOC resolves `true` to default opacities. */
+    gradientFill?: {
+        topOpacity: number;
+        bottomOpacity: number;
+    } | {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
+    };
     /** When true, adds padding below the 0 baseline. When false (default), bars are flush with the axis line. */
     baselinePadding?: boolean;
     innerRadius?: number;
@@ -188,16 +203,22 @@ export interface OrdinalPipelineConfig {
     connectorOpacity?: number;
     showLabels?: boolean;
     oSort?: ((a: string, b: string) => number) | boolean | "asc" | "desc" | "auto";
-    connectorAccessor?: string | ((d: any) => string);
-    connectorStyle?: Style | ((d: any) => Style);
+    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;
     colorScheme?: string | string[];
     themeCategorical?: string[];
+    /** Theme-resolved semantic role colors — default fallback before hardcoded hex. See `ThemeSemanticColors` in ./types. */
+    themeSemantic?: ThemeSemanticColors;
+    /** Theme sequential scheme name — fallback for magnitude encodings. */
+    themeSequential?: string;
+    /** Theme diverging scheme name — fallback for midpoint encodings (LikertChart). */
+    themeDiverging?: string;
     barColors?: Record<string, string>;
     /** ID accessor for remove() — extracts a unique identifier from each datum */
-    dataIdAccessor?: string | ((d: any) => string);
+    dataIdAccessor?: string | ((d: Datum) => string);
     decay?: DecayConfig;
     pulse?: PulseConfig;
     transition?: TransitionConfig;
@@ -205,7 +226,7 @@ export interface OrdinalPipelineConfig {
     introAnimation?: boolean;
     staleness?: StalenessConfig;
 }
-export interface StreamOrdinalFrameProps<T = Record<string, any>> {
+export interface StreamOrdinalFrameProps<T = Datum> {
     chartType: OrdinalChartType;
     runtimeMode?: "bounded" | "streaming";
     data?: T[];
@@ -234,6 +255,17 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
     };
     barPadding?: number;
     roundedTop?: number;
+    /** Gradient fill for bar rects. Same shape as AreaChart.gradientFill sans
+     *  the boolean case — resolve booleans at the HOC layer. */
+    gradientFill?: {
+        topOpacity: number;
+        bottomOpacity: number;
+    } | {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
+    };
     baselinePadding?: boolean;
     innerRadius?: number;
     cornerRadius?: number;
@@ -251,13 +283,12 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
     oExtent?: string[];
     extentPadding?: number;
     oSort?: ((a: string, b: string) => number) | boolean | "asc" | "desc" | "auto";
-    arrowOfTime?: ArrowOfTime;
     windowMode?: WindowMode;
     windowSize?: number;
     connectorAccessor?: string | ((d: T) => string);
-    connectorStyle?: Style | ((d: any) => Style);
+    connectorStyle?: Style | ((d: Datum) => Style);
     /** ID accessor for remove()/update() — extracts a unique identifier from each datum */
-    dataIdAccessor?: string | ((d: any) => string);
+    dataIdAccessor?: string | ((d: Datum) => string);
     /** Custom tick values for the value (r) axis. Overrides the default d3 ticks. */
     rTickValues?: number[];
     /** Align first tick label to start and last tick label to end. Default false. */
@@ -288,8 +319,8 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
     hoverAnnotation?: boolean | HoverAnnotationConfig;
     tooltipContent?: (d: HoverData) => ReactNode;
     customHoverBehavior?: (d: HoverData | null) => void;
-    annotations?: Record<string, any>[];
-    svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
+    annotations?: Datum[];
+    svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
     showGrid?: boolean;
     legend?: ReactNode | {
         legendGroups: LegendGroup[];
@@ -334,7 +365,7 @@ export interface StreamOrdinalFrameProps<T = Record<string, any>> {
     /** Accessible summary rendered as a screen-reader-only note */
     summary?: string;
 }
-export interface StreamOrdinalFrameHandle<T = Record<string, any>> {
+export interface StreamOrdinalFrameHandle<T = Datum> {
     push(datum: T): void;
     pushMany(data: T[]): void;
     /** Replace all data. Unlike `clear() + pushMany()`, `replace()` preserves
@@ -363,4 +394,5 @@ export interface OrdinalLayout {
     height: number;
 }
 export type OrdinalRendererFn = (ctx: CanvasRenderingContext2D, nodes: OrdinalSceneNode[], scales: OrdinalScales, layout: OrdinalLayout) => void;
-export type { HoverData, HoverAnnotationConfig, AnnotationContext, ArrowOfTime, WindowMode };
+export type { HoverData, HoverAnnotationConfig, AnnotationContext, WindowMode };
+export type { ArrowOfTime } from "../realtime/types";

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * Shared decay encoding utilities for all pipeline stores.
  *
@@ -18,4 +19,4 @@ export declare function computeDecayOpacity(decay: DecayConfig, bufferIndex: num
  * Apply decay opacity to a list of scene nodes.
  * Uses the datum's index in the buffer data array.
  */
-export declare function applyDecay(decay: DecayConfig, nodes: SceneNode[], data: Record<string, any>[]): void;
+export declare function applyDecay(decay: DecayConfig, nodes: SceneNode[], data: Datum[]): void;

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * Pulse encoding for XY pipeline scene nodes.
  *
@@ -17,7 +18,7 @@ export declare function computePulseIntensity(pulse: PulseConfig, insertTime: nu
 /**
  * Apply pulse glow to scene nodes using insertion timestamps.
  */
-export declare function applyPulse(pulse: PulseConfig, nodes: SceneNode[], data: Record<string, any>[], timestampBuffer: RingBuffer<number>): void;
+export declare function applyPulse(pulse: PulseConfig, nodes: SceneNode[], data: Datum[], timestampBuffer: RingBuffer<number>): void;
 /**
  * Check whether there are active pulse animations needing continuous rendering.
  */