semiotic 3.4.0 → 3.4.2

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, SceneDatum } 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[];
@@ -57,9 +58,9 @@ export interface RealtimeEdge {
     _introFromZero?: boolean;
     direction?: string;
     circular?: boolean;
-    circularPathData?: any;
+    circularPathData?: CircularPathData;
     bezier?: BezierCache;
-    data?: Record<string, any>;
+    data?: Datum;
     /** Unique key for this edge (supports parallel edges between same node pair) */
     _edgeKey?: string;
     _pulseIntensity?: number;
@@ -79,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;
@@ -132,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;
@@ -146,7 +168,7 @@ export interface NetworkCircleNode {
     cy: number;
     r: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     id?: string;
     label?: string;
     depth?: number;
@@ -162,7 +184,7 @@ export interface NetworkRectNode {
     w: number;
     h: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     id?: string;
     label?: string;
     depth?: number;
@@ -183,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;
@@ -198,7 +220,7 @@ export interface NetworkLineEdge {
     x2: number;
     y2: number;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     _pulseIntensity?: number;
     _pulseColor?: string;
 }
@@ -208,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. */
@@ -220,7 +242,7 @@ export interface NetworkRibbonEdge {
     type: "ribbon";
     pathD: string;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     _pulseIntensity?: number;
     _pulseColor?: string;
     _cachedPath2D?: Path2D;
@@ -231,7 +253,7 @@ export interface NetworkCurvedEdge {
     type: "curved";
     pathD: string;
     style: Style;
-    datum: any;
+    datum: SceneDatum;
     _pulseIntensity?: number;
     _pulseColor?: string;
     _cachedPath2D?: Path2D;
@@ -299,24 +321,24 @@ 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) => 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;
@@ -324,17 +346,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;
@@ -347,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)
@@ -362,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 */
@@ -377,7 +403,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 +415,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";
@@ -400,8 +426,8 @@ export interface StreamNetworkFrameProps<T = Record<string, any>> {
     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;
@@ -409,16 +435,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 +467,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[];
     };
@@ -468,11 +494,11 @@ export interface StreamNetworkFrameProps<T = Record<string, any>> {
     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 */
@@ -490,9 +516,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, 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";
 export type OrdinalChartType = "bar" | "clusterbar" | "point" | "swarm" | "pie" | "donut" | "boxplot" | "violin" | "histogram" | "ridgeline" | "timeline" | "funnel" | "bar-funnel" | "swimlane";
 export interface OrdinalScales {
     o: ScaleBand<string>;
@@ -23,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;
@@ -49,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;
@@ -97,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;
@@ -112,7 +113,7 @@ export interface ConnectorSceneNode {
     x2: number;
     y2: number;
     style: Style;
-    datum: any;
+    datum: Datum;
     group?: string;
     _pulseIntensity?: number;
     _pulseColor?: string;
@@ -125,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;
@@ -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);
-    dynamicColumnWidth?: string | ((data: any[]) => number);
-    pieceStyle?: (d: any, category?: string) => Style;
-    summaryStyle?: (d: any, category?: string) => Style;
+    connectorAccessor?: string | ((d: Datum) => string);
+    connectorStyle?: Style | ((d: Datum) => 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. */
+    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,19 +283,18 @@ 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. */
     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;
@@ -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.
  */