semiotic 3.3.1 → 3.4.1

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

@@ -1,8 +1,9 @@
+import type { Datum } from "../charts/shared/datumTypes";
 export interface Bin {
     start: number;
     end: number;
     total: number;
     categories: Map<string, number>;
 }
-export declare function computeBins(data: Iterable<Record<string, any>>, getTime: (d: Record<string, any>) => number, getValue: (d: Record<string, any>) => number, binSize: number, getCategory?: (d: Record<string, any>) => string): Map<number, Bin>;
-export declare function computeBinExtent(data: Iterable<Record<string, any>>, getTime: (d: Record<string, any>) => number, getValue: (d: Record<string, any>) => number, binSize: number, getCategory?: (d: Record<string, any>) => string): [number, number];
+export declare function computeBins(data: Iterable<Datum>, getTime: (d: Datum) => number, getValue: (d: Datum) => number, binSize: number, getCategory?: (d: Datum) => string): Map<number, Bin>;
+export declare function computeBinExtent(data: Iterable<Datum>, getTime: (d: Datum) => number, getValue: (d: Datum) => number, binSize: number, getCategory?: (d: Datum) => string): [number, number];

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

@@ -1,4 +1,5 @@
 import type { RealtimeScales, RealtimeLayout, LineStyle, RealtimeAccessors, BarStyle, WaterfallStyle, SwarmStyle } from "../types";
+import type { Datum } from "../../charts/shared/datumTypes";
 export interface RendererOptions {
     binSize?: number;
     barColors?: Record<string, string>;
@@ -6,4 +7,4 @@ export interface RendererOptions {
     waterfallStyle?: WaterfallStyle;
     swarmStyle?: SwarmStyle;
 }
-export type RendererFn = (ctx: CanvasRenderingContext2D, data: Iterable<Record<string, any>>, scales: RealtimeScales, layout: RealtimeLayout, style: LineStyle, accessors: RealtimeAccessors, annotations?: Record<string, any>[], options?: RendererOptions) => void;
+export type RendererFn = (ctx: CanvasRenderingContext2D, data: Iterable<Datum>, scales: RealtimeScales, layout: RealtimeLayout, style: LineStyle, accessors: RealtimeAccessors, annotations?: Datum[], options?: RendererOptions) => void;

package/dist/components/realtime/renderers/waterfallRenderer.d.ts

@@ -1,3 +1,4 @@
 import type { RendererFn } from "./types";
-export declare function computeWaterfallExtent(data: Iterable<Record<string, any>>, getValue: (d: Record<string, any>) => number): [number, number];
+import type { Datum } from "../../charts/shared/datumTypes";
+export declare function computeWaterfallExtent(data: Iterable<Datum>, getValue: (d: Datum) => number): [number, number];
 export declare const waterfallRenderer: RendererFn;

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

@@ -1,5 +1,6 @@
 import type { ReactNode } from "react";
 import type { ScaleLinear } from "d3-scale";
+import type { Datum } from "../charts/shared/datumTypes";
 export type ArrowOfTime = "up" | "down" | "left" | "right";
 export type WindowMode = "sliding" | "growing";
 export type ThresholdType = "greater" | "lesser";
@@ -7,6 +8,7 @@ export interface LineStyle {
     stroke?: string;
     strokeWidth?: number;
     strokeDasharray?: string;
+    opacity?: number;
 }
 /**
  * Anchoring mode for streaming annotations.
@@ -33,7 +35,7 @@ export interface AnnotationContext {
     yAccessor?: string;
     width?: number;
     height?: number;
-    data?: Record<string, any>[];
+    data?: Datum[];
     frameType?: "xy" | "ordinal" | "network";
     /** Ordinal projection direction (only in ordinal frames) */
     projection?: "vertical" | "horizontal";
@@ -107,12 +109,13 @@ export interface HoverData {
     /** Whether the hovered element is a node or edge */
     nodeOrEdge?: "node" | "edge";
     /** GeoJSON feature properties (flattened for convenience) */
-    properties?: Record<string, any>;
+    properties?: Datum;
 }
 export interface BarStyle {
     fill?: string;
     stroke?: string;
     strokeWidth?: number;
+    opacity?: number;
     gap?: number;
 }
 export interface WaterfallStyle {
@@ -123,6 +126,7 @@ export interface WaterfallStyle {
     gap?: number;
     stroke?: string;
     strokeWidth?: number;
+    opacity?: number;
 }
 export interface SwarmStyle {
     radius?: number;
@@ -136,9 +140,9 @@ export interface RealtimeFrameProps {
     arrowOfTime?: ArrowOfTime;
     windowMode?: WindowMode;
     windowSize?: number;
-    data?: Record<string, any>[];
-    timeAccessor?: string | ((d: Record<string, any>) => number);
-    valueAccessor?: string | ((d: Record<string, any>) => number);
+    data?: Datum[];
+    timeAccessor?: string | ((d: Datum) => number);
+    valueAccessor?: string | ((d: Datum) => number);
     timeExtent?: [number, number];
     valueExtent?: [number, number];
     extentPadding?: number;
@@ -151,14 +155,14 @@ export interface RealtimeFrameProps {
     };
     className?: string;
     lineStyle?: LineStyle;
-    annotations?: Record<string, any>[];
-    svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
+    annotations?: Datum[];
+    svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
     hoverAnnotation?: boolean | HoverAnnotationConfig;
     tooltipContent?: (d: HoverData) => ReactNode;
     customHoverBehavior?: (d: HoverData | null) => void;
     showAxes?: boolean;
     background?: string;
-    categoryAccessor?: string | ((d: Record<string, any>) => string);
+    categoryAccessor?: string | ((d: Datum) => string);
     binSize?: number;
     barColors?: Record<string, string>;
     barStyle?: BarStyle;
@@ -168,14 +172,26 @@ export interface RealtimeFrameProps {
     tickFormatValue?: (value: number) => string;
 }
 export interface RealtimeFrameHandle {
-    push(point: Record<string, any>): void;
-    pushMany(points: Record<string, any>[]): void;
+    push(point: Datum): void;
+    pushMany(points: Datum[]): void;
     /** Remove data by ID. Requires an ID accessor (pointIdAccessor or dataIdAccessor). */
-    remove(id: string | string[]): Record<string, any>[];
+    remove(id: string | string[]): Datum[];
     /** Update data by ID in place. Requires an ID accessor. Returns previous values. */
-    update(id: string | string[], updater: (d: Record<string, any>) => Record<string, any>): Record<string, any>[];
+    update(id: string | string[], updater: (d: Datum) => Datum): Datum[];
     clear(): void;
-    getData(): Record<string, any>[];
+    getData(): Datum[];
+    /** Returns the frame's resolved scales, or null if unavailable.
+     *
+     *  The concrete scales object differs by frame type — XY charts
+     *  expose `{ x, y }`, ordinal charts expose `{ o, r, projection }`,
+     *  network/geo don't have a meaningful scale concept and may not
+     *  implement this method at all.
+     *
+     *  Typed as `unknown` so the shared handle stays compatible across
+     *  chart families. HOCs that want a narrower return type should
+     *  export a chart-specific handle (e.g. `LikertChartHandle`) that
+     *  extends this interface and narrows `getScales()`. */
+    getScales?(): unknown | null;
 }
 export interface RealtimeScales {
     time: ScaleLinear<number, number>;
@@ -187,7 +203,7 @@ export interface RealtimeLayout {
     timeAxis: "x" | "y";
 }
 export interface RealtimeAccessors {
-    time: (d: Record<string, any>) => number;
-    value: (d: Record<string, any>) => number;
-    category?: (d: Record<string, any>) => string;
+    time: (d: Datum) => number;
+    value: (d: Datum) => number;
+    category?: (d: Datum) => string;
 }

package/dist/components/semiotic-geo.d.ts

@@ -14,3 +14,7 @@ export { mergeData } from "./geo/mergeData";
 export { resolveReferenceGeography } from "./geo/referenceGeography";
 export type { ReferenceGeography } from "./geo/referenceGeography";
 export type { AreasProp } from "./geo/useReferenceAreas";
+export type { ChoroplethMapProps } from "./charts/geo/ChoroplethMap";
+export type { ProportionalSymbolMapProps } from "./charts/geo/ProportionalSymbolMap";
+export type { FlowMapProps } from "./charts/geo/FlowMap";
+export type { DistanceCartogramProps } from "./charts/geo/DistanceCartogram";

package/dist/components/semiotic-network.d.ts

@@ -12,3 +12,10 @@ export { Treemap } from "./charts/network/Treemap";
 export { CirclePack } from "./charts/network/CirclePack";
 export { OrbitDiagram } from "./charts/network/OrbitDiagram";
 export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType, NetworkSceneNode, NetworkSceneEdge, NetworkLabel, ThresholdAlertConfig } from "./stream/networkTypes";
+export type { ForceDirectedGraphProps } from "./charts/network/ForceDirectedGraph";
+export type { SankeyDiagramProps } from "./charts/network/SankeyDiagram";
+export type { ChordDiagramProps } from "./charts/network/ChordDiagram";
+export type { TreeDiagramProps } from "./charts/network/TreeDiagram";
+export type { TreemapProps } from "./charts/network/Treemap";
+export type { CirclePackProps } from "./charts/network/CirclePack";
+export type { OrbitDiagramProps } from "./charts/network/OrbitDiagram";

package/dist/components/semiotic-ordinal.d.ts

@@ -23,3 +23,11 @@ export { LikertChart } from "./charts/ordinal/LikertChart";
 export { createHatchPattern } from "./charts/shared/hatchPattern";
 export type { HatchPatternOptions } from "./charts/shared/hatchPattern";
 export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";
+export type { BarChartProps } from "./charts/ordinal/BarChart";
+export type { StackedBarChartProps } from "./charts/ordinal/StackedBarChart";
+export type { GroupedBarChartProps } from "./charts/ordinal/GroupedBarChart";
+export type { SwimlaneChartProps } from "./charts/ordinal/SwimlaneChart";
+export type { PieChartProps } from "./charts/ordinal/PieChart";
+export type { DonutChartProps } from "./charts/ordinal/DonutChart";
+export type { FunnelChartProps } from "./charts/ordinal/FunnelChart";
+export type { LikertChartProps } from "./charts/ordinal/LikertChart";

package/dist/components/semiotic-themes.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "./charts/shared/datumTypes";
 /**
  * semiotic/themes — Named theme presets for Semiotic charts.
  *
@@ -77,4 +78,4 @@ export declare function themeToCSS(theme: SemioticTheme, selector?: string): str
  * // { semiotic: { bg: { $value: "#fffff8", $type: "color" }, ... } }
  * ```
  */
-export declare function themeToTokens(theme: SemioticTheme): Record<string, any>;
+export declare function themeToTokens(theme: SemioticTheme): Datum;

package/dist/components/semiotic-xy.d.ts

@@ -15,4 +15,15 @@ export { ScatterplotMatrix } from "./charts/xy/ScatterplotMatrix";
 export { MinimapChart } from "./charts/xy/MinimapChart";
 export { QuadrantChart } from "./charts/xy/QuadrantChart";
 export { MultiAxisLineChart } from "./charts/xy/MultiAxisLineChart";
+export { CandlestickChart } from "./charts/xy/CandlestickChart";
 export type { StreamXYFrameProps, StreamXYFrameHandle } from "./stream/types";
+export type { LineChartProps } from "./charts/xy/LineChart";
+export type { AreaChartProps } from "./charts/xy/AreaChart";
+export type { StackedAreaChartProps } from "./charts/xy/StackedAreaChart";
+export type { ScatterplotProps } from "./charts/xy/Scatterplot";
+export type { ConnectedScatterplotProps } from "./charts/xy/ConnectedScatterplot";
+export type { BubbleChartProps } from "./charts/xy/BubbleChart";
+export type { HeatmapProps } from "./charts/xy/Heatmap";
+export type { QuadrantChartProps } from "./charts/xy/QuadrantChart";
+export type { MultiAxisLineChartProps } from "./charts/xy/MultiAxisLineChart";
+export type { CandlestickChartProps } from "./charts/xy/CandlestickChart";

package/dist/components/semiotic.d.ts

@@ -1,7 +1,7 @@
 import StreamXYFrame from "./stream/StreamXYFrame";
 import StreamOrdinalFrame from "./stream/StreamOrdinalFrame";
 import StreamNetworkFrame from "./stream/StreamNetworkFrame";
-import { Scatterplot, ConnectedScatterplot, LineChart, AreaChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GaugeChart, GroupedBarChart, FunnelChart, SwimlaneChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart } from "./charts";
+import { Scatterplot, ConnectedScatterplot, LineChart, AreaChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GaugeChart, GroupedBarChart, FunnelChart, SwimlaneChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart } from "./charts";
 import { LinkedCharts } from "./LinkedCharts";
 import { ThemeProvider, useTheme } from "./ThemeProvider";
 import { exportChart } from "./export/exportChart";
@@ -23,8 +23,8 @@ import { RealtimeTemporalHistogram, RealtimeHistogram } from "./charts/realtime/
 import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
 import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
 import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
-export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern };
-export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, QuadrantsConfig, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./charts";
+export { StreamXYFrame, StreamOrdinalFrame, StreamNetworkFrame, Scatterplot, ConnectedScatterplot, LineChart, AreaChart, StackedAreaChart, Heatmap, BubbleChart, BarChart, StackedBarChart, LikertChart, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, PieChart, DonutChart, GaugeChart, FunnelChart, GroupedBarChart, SwimlaneChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, MultiAxisLineChart, CandlestickChart, LinkedCharts, ThemeProvider, useTheme, exportChart, toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX, serializeSelections, deserializeSelections, fromVegaLite, ChartErrorBoundary, ChartContainer, ChartGrid, CategoryColorProvider, useCategoryColors, ContextLayout, DetailsPanel, Tooltip, MultiLineTooltip, normalizeTooltip, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeTemporalHistogram, RealtimeHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap, createHatchPattern };
+export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, LikertChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GaugeChartProps, GaugeThreshold, FunnelChartProps, GroupedBarChartProps, SwimlaneChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, MultiAxisLineChartProps, MultiAxisSeriesConfig, CandlestickChartProps, QuadrantsConfig, QuadrantConfig, CenterlineStyle, BaseChartProps, AxisConfig, Accessor, ChartAccessor, ChartMode } from "./charts";
 export type { StreamXYFrameProps, StreamXYFrameHandle, StreamChartType, RuntimeMode, SceneNode, Changeset, StreamScales, StreamLayout, CurveType, CanvasRendererFn } from "./stream/types";
 export type { StreamRendererFn } from "./stream/renderers/types";
 export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";

package/dist/components/server/animatedGif.d.ts

@@ -1,18 +1,4 @@
-/**
- * Animated GIF generation from semiotic chart data.
- *
- * Renders a sequence of chart frames by progressively feeding data into
- * PipelineStore, optionally applying transition easing and decay effects,
- * then encoding all frames as an animated GIF.
- *
- * Phases:
- *   1. Sliding window — slice data into progressive windows, render each
- *   2. Transition easing — interpolate enter/update between data windows
- *   3. Decay/pulse — apply age-based opacity fading per frame
- *
- * Requires: sharp (SVG→PNG rasterization), gifenc (GIF encoding)
- * Both are optional dependencies of semiotic.
- */
+import type { Datum } from "../charts/shared/datumTypes";
 import type { SemioticTheme } from "../store/ThemeStore";
 export interface AnimatedGifOptions {
     /** Frames per second (default 12) */
@@ -56,7 +42,7 @@ export interface AnimatedGifFrameConfig {
  * Generate SVG strings for each animation frame.
  * This is the core logic shared between GIF export and client-side preview.
  */
-export declare function generateFrameSVGs(chartType: string, data: Record<string, any>[], props: Record<string, any>, options?: AnimatedGifOptions): string[];
+export declare function generateFrameSVGs(chartType: string, data: Datum[], props: Datum, options?: AnimatedGifOptions): string[];
 /**
  * Generate SVG strings from an array of data snapshots.
  *
@@ -67,7 +53,7 @@ export declare function generateFrameSVGs(chartType: string, data: Record<string
  *
  * Each snapshot is passed directly to `renderChart()`.
  */
-export declare function generateFrameSequence(component: string, snapshots: Record<string, any>[], baseProps?: Record<string, any>): string[];
+export declare function generateFrameSequence(component: string, snapshots: Datum[], baseProps?: Datum): string[];
 /**
  * Render a chart as an animated GIF.
  *
@@ -75,4 +61,4 @@ export declare function generateFrameSequence(component: string, snapshots: Reco
  *
  * @returns Buffer containing the animated GIF
  */
-export declare function renderToAnimatedGif(chartType: string, data: Record<string, any>[], props: Record<string, any>, options?: AnimatedGifOptions): Promise<Buffer>;
+export declare function renderToAnimatedGif(chartType: string, data: Datum[], props: Datum, options?: AnimatedGifOptions): Promise<Buffer>;

package/dist/components/server/renderToStaticSVG.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * Server-side rendering of Semiotic charts to standalone SVG strings.
  *
@@ -24,7 +25,7 @@ interface ThemeAwareProps {
     theme?: ThemeInput;
     showLegend?: boolean;
     showGrid?: boolean;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     title?: string | React.ReactNode;
     description?: string;
     background?: string;
@@ -39,7 +40,7 @@ export declare function renderOrdinalToStaticSVG(props: StreamOrdinalFrameProps
 export declare function renderNetworkToStaticSVG(props: StreamNetworkFrameProps & ThemeAwareProps): string;
 export declare function renderGeoToStaticSVG(props: StreamGeoFrameProps & ThemeAwareProps): string;
 /** Chart component name to frame type + props mapping */
-type ChartName = "LineChart" | "AreaChart" | "StackedAreaChart" | "Scatterplot" | "BubbleChart" | "ConnectedScatterplot" | "Heatmap" | "Sparkline" | "BarChart" | "StackedBarChart" | "GroupedBarChart" | "PieChart" | "DonutChart" | "SwimlaneChart" | "Histogram" | "BoxPlot" | "ViolinPlot" | "SwarmPlot" | "DotPlot" | "RidgelinePlot" | "FunnelChart" | "GaugeChart" | "ForceDirectedGraph" | "SankeyDiagram" | "ChordDiagram" | "TreeDiagram" | "Treemap" | "CirclePack" | "ChoroplethMap" | "ProportionalSymbolMap";
+type ChartName = "LineChart" | "AreaChart" | "StackedAreaChart" | "Scatterplot" | "BubbleChart" | "ConnectedScatterplot" | "Heatmap" | "Sparkline" | "BarChart" | "StackedBarChart" | "GroupedBarChart" | "PieChart" | "DonutChart" | "SwimlaneChart" | "Histogram" | "BoxPlot" | "ViolinPlot" | "SwarmPlot" | "DotPlot" | "RidgelinePlot" | "LikertChart" | "FunnelChart" | "GaugeChart" | "ForceDirectedGraph" | "SankeyDiagram" | "ChordDiagram" | "TreeDiagram" | "Treemap" | "CirclePack" | "ChoroplethMap" | "ProportionalSymbolMap" | "FlowMap";
 interface RenderChartOptions {
     /** Output format — currently only "svg" is synchronous */
     format?: "svg";
@@ -50,7 +51,7 @@ interface RenderChartOptions {
  *
  * This is the primary API for AI/MCP workflows.
  */
-export declare function renderChart(component: ChartName, props: Record<string, any>, _options?: RenderChartOptions): string;
+export declare function renderChart(component: ChartName, props: Datum, _options?: RenderChartOptions): string;
 export interface RenderToImageOptions {
     /** Output format */
     format?: "png" | "jpeg";
@@ -65,13 +66,13 @@ export interface RenderToImageOptions {
  * Requires `sharp` as an optional peer dependency.
  * Falls back to a descriptive error if sharp is not installed.
  */
-export declare function renderToImage(frameTypeOrComponent: FrameType | ChartName, props: Record<string, any>, options?: RenderToImageOptions): Promise<Buffer>;
+export declare function renderToImage(frameTypeOrComponent: FrameType | ChartName, props: Datum, options?: RenderToImageOptions): Promise<Buffer>;
 export interface DashboardChart {
     /** Frame type or HOC component name */
     component?: ChartName;
     frameType?: FrameType;
     /** Chart props (data, accessors, etc.) */
-    props: Record<string, any>;
+    props: Datum;
     /** Span multiple columns (for emphasis="primary") */
     colSpan?: number;
 }

package/dist/components/server/serverChartConfigs.d.ts

@@ -1,17 +1,9 @@
-/**
- * Chart-specific prop mapping for renderChart().
- *
- * Each entry maps HOC-level props (categoryAccessor, valueAccessor, etc.)
- * to frame-level props (oAccessor, rAccessor, etc.) for server rendering.
- *
- * Extracted from renderToStaticSVG.tsx's 400-line switch statement to make
- * each chart type independently readable and testable.
- */
+import type { Datum } from "../charts/shared/datumTypes";
 type FrameType = "xy" | "ordinal" | "network" | "geo";
 interface ChartConfig {
     frameType: FrameType;
     /** Build frame props from HOC-level props */
-    buildProps: (data: any, colorBy: any, colorScheme: any, common: Record<string, any>, rest: Record<string, any>) => Record<string, any>;
+    buildProps: (data: any, colorBy: any, colorScheme: any, common: Datum, rest: Datum) => Datum;
 }
 export declare const CHART_CONFIGS: Record<string, ChartConfig>;
 export {};

package/dist/components/server/staticAnnotations.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * Static annotation rendering for server-side SVG.
  *
@@ -22,7 +23,7 @@ interface AnnotationLayout {
     height: number;
 }
 export interface StaticAnnotationConfig {
-    annotations: Record<string, any>[];
+    annotations: Datum[];
     scales: AnnotationScales;
     layout: AnnotationLayout;
     theme: SemioticTheme;

package/dist/components/server/staticLegend.d.ts

@@ -6,6 +6,7 @@
  */
 import * as React from "react";
 import type { SemioticTheme } from "../store/ThemeStore";
+import type { Datum } from "../charts/shared/datumTypes";
 export interface StaticLegendConfig {
     /** Category labels to show in legend */
     categories: string[];
@@ -36,4 +37,4 @@ export declare function renderStaticLegend(config: StaticLegendConfig): React.Re
 /**
  * Extract unique categories from data using an accessor.
  */
-export declare function extractCategories(data: any[], accessor: string | ((d: any) => string) | undefined): string[];
+export declare function extractCategories(data: any[], accessor: string | ((d: Datum) => string) | undefined): string[];

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 interface ObservationBase {
     timestamp: number;
     chartType: string;
@@ -5,7 +6,7 @@ interface ObservationBase {
 }
 export interface HoverObservation extends ObservationBase {
     type: "hover";
-    datum: Record<string, any>;
+    datum: Datum;
     x: number;
     y: number;
 }
@@ -26,7 +27,7 @@ export interface SelectionObservation extends ObservationBase {
     type: "selection";
     selection: {
         name: string;
-        fields: Record<string, any>;
+        fields: Datum;
     };
 }
 export interface SelectionEndObservation extends ObservationBase {
@@ -37,7 +38,7 @@ export interface SelectionEndObservation extends ObservationBase {
 }
 export interface ClickObservation extends ObservationBase {
     type: "click";
-    datum: Record<string, any>;
+    datum: Datum;
     x: number;
     y: number;
 }

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 export type ResolutionMode = "union" | "intersect" | "crossfilter";
 export interface FieldConstraint {
     type: "point";
@@ -25,13 +26,7 @@ export interface SelectionStoreState {
     setResolution: (selectionName: string, mode: ResolutionMode) => void;
     clearSelection: (selectionName: string) => void;
 }
-export declare function buildPredicate(selection: Selection, requestingClientId?: string): (d: Record<string, any>) => boolean;
+export declare function buildPredicate(selection: Selection, requestingClientId?: string): (d: Datum) => boolean;
 export declare const SelectionProvider: import("react").FC<{
     children: React.ReactNode;
-}>, useSelectionSelector: <R>(selector: (state: {
-    selections: Map<string, Selection>;
-    setClause(selectionName: string, clause: SelectionClause): void;
-    clearClause(selectionName: string, clientId: string): void;
-    setResolution(selectionName: string, mode: ResolutionMode): void;
-    clearSelection(selectionName: string): void;
-}) => R) => R;
+}>, useSelectionSelector: <R>(selector: (state: SelectionStoreState) => R) => R;

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

@@ -1,12 +1,35 @@
+import type { ThemeSemanticColors } from "../stream/types";
+/**
+ * Extract the semantic-role subset of a `SemioticTheme` into the flat
+ * `ThemeSemanticColors` shape that Stream Frames thread through to
+ * scene builders via `pipelineConfig.themeSemantic`.
+ *
+ * Centralizes two fallback rules documented on `SemioticTheme.colors`:
+ *   - `secondary` falls back to `primary` when unset
+ *   - `surface`   falls back to `background` when unset
+ *
+ * Called from every Stream Frame (XY / Ordinal / Network / Geo) so role
+ * additions and fallback tweaks land in exactly one place.
+ *
+ * Returns `undefined` when no theme is available so scene builders can
+ * skip the theme-default path and use their hardcoded fallbacks.
+ */
+export declare function resolveThemeSemanticColors(theme: SemioticTheme | null | undefined): ThemeSemanticColors | undefined;
+/** Apply accessibility flags to a resolved theme. Shared by ThemeStore and server themeResolver. */
+export declare function applyThemeAccessibility(theme: SemioticTheme): SemioticTheme;
 export interface SemioticTheme {
     mode: "light" | "dark" | "auto";
     colors: {
         primary: string;
+        /** Secondary accent color. Falls back to `primary` when unset. */
+        secondary?: string;
         categorical: string[];
         sequential: string;
         /** d3-scale-chromatic diverging scheme name, e.g. "RdBu", "PiYG" */
         diverging?: string;
         background: string;
+        /** Elevated surface fill (e.g. card/tooltip bg). Falls back to `background`. */
+        surface?: string;
         text: string;
         textSecondary: string;
         grid: string;
@@ -18,6 +41,16 @@ export interface SemioticTheme {
         selectionOpacity?: number;
         /** Default annotation text/marker color. Falls back to `text` if unset. */
         annotation?: string;
+        /** Positive outcomes, gains, "ok" states. */
+        success?: string;
+        /** Negative outcomes, losses, destructive actions. */
+        danger?: string;
+        /** Cautionary states, degraded but not failed. */
+        warning?: string;
+        /** Failed states, blocking errors. Typically more intense than `danger`. */
+        error?: string;
+        /** Neutral informational callouts, tips, help content. */
+        info?: string;
     };
     typography: {
         fontFamily: string;
@@ -59,7 +92,4 @@ export interface ThemeStoreState {
 }
 export declare const ThemeProvider: import("react").FC<{
     children: React.ReactNode;
-}>, useThemeSelector: <R>(selector: (state: {
-    theme: SemioticTheme;
-    setTheme(theme: Partial<SemioticTheme> | "light" | "dark" | "high-contrast"): void;
-}) => R) => R;
+}>, useThemeSelector: <R>(selector: (state: ThemeStoreState) => R) => R;

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

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

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

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

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

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

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

@@ -1,6 +1,7 @@
 import type { SceneNode, PointSceneNode } from "./types";
 import type { RingBuffer } from "../realtime/RingBuffer";
 import type { Quadtree } from "d3-quadtree";
+import type { Datum } from "../charts/shared/datumTypes";
 export interface HitResult {
     node: SceneNode;
     datum: any;
@@ -13,11 +14,16 @@ export interface HitResult {
  * Dispatches to type-specific hit testers for optimal performance.
  *
  * When a quadtree spatial index is provided (for scatter/bubble charts with
- * many points), point hit testing uses O(log n) quadtree.find() instead of
- * iterating all nodes. Non-point node types (line, rect, area, etc.) still
+ * many points), point hit testing routes through `findHitPointInQuadtree`,
+ * which visits every candidate within the widened search radius (using
+ * `maxPointRadius` so variable-size points like BubbleChart can't hide
+ * behind a nearer non-hit). The visit is authoritative — when it returns
+ * null, no point hit exists and the linear point loop is skipped.
+ *
+ * Non-point node types (line, rect, area, heatcell, candlestick) still
  * use the linear scan.
  */
-export declare function findNearestNode(scene: SceneNode[], px: number, py: number, maxDistance?: number, pointQuadtree?: Quadtree<PointSceneNode> | null): HitResult | null;
+export declare function findNearestNode(scene: SceneNode[], px: number, py: number, maxDistance?: number, pointQuadtree?: Quadtree<PointSceneNode> | null, maxPointRadius?: number): HitResult | null;
 /**
  * Find all line/area nodes at a given X pixel coordinate.
  * For each node, interpolates the Y value at px using the path data.
@@ -34,4 +40,4 @@ export declare function findAllNodesAtX(scene: SceneNode[], px: number, maxXDist
 /**
  * Binary search for nearest point by time value in a RingBuffer.
  */
-export declare function findNearestIndex(buf: RingBuffer<Record<string, any>>, targetTime: number, getTime: (d: Record<string, any>) => number): number;
+export declare function findNearestIndex(buf: RingBuffer<Datum>, targetTime: number, getTime: (d: Datum) => number): number;