semiotic 3.4.0 → 3.4.1

package/dist/components/charts/xy/QuadrantChart.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -43,7 +44,7 @@ export interface CenterlineStyle {
 /**
  * QuadrantChart component props
  */
-export interface QuadrantChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps, AxisConfig {
+export interface QuadrantChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
     /** Array of data points */
     data?: TDatum[];
     /** Field name or function to access x values @default "x" */
@@ -89,7 +90,7 @@ export interface QuadrantChartProps<TDatum extends Record<string, any> = Record<
     /** Legend position */
     legendPosition?: LegendPosition;
     /** Annotation objects */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Additional StreamXYFrame props */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
 }
@@ -115,6 +116,6 @@ export interface QuadrantChartProps<TDatum extends Record<string, any> = Record<
  * ```
  */
 export declare const QuadrantChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: QuadrantChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: QuadrantChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/xy/Scatterplot.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps, MarginalGraphicsConfig } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -7,7 +8,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 /**
  * Scatterplot component props
  */
-export interface ScatterplotProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps, AxisConfig {
+export interface ScatterplotProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
     /** Array of data points. Each point should have x and y properties. */
     data?: TDatum[];
     /** Field name or function to access x values @default "x" */
@@ -43,7 +44,7 @@ export interface ScatterplotProps<TDatum extends Record<string, any> = Record<st
     /** Legend position */
     legendPosition?: LegendPosition;
     /** Annotation objects to render on the chart */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Additional StreamXYFrame props for advanced customization */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
 }
@@ -60,6 +61,6 @@ export interface ScatterplotProps<TDatum extends Record<string, any> = Record<st
  * ```
  */
 export declare const Scatterplot: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: ScatterplotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: ScatterplotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/xy/ScatterplotMatrix.d.ts

@@ -1,7 +1,7 @@
-import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
-export interface ScatterplotMatrixProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface ScatterplotMatrixProps<TDatum extends Datum = Datum> extends BaseChartProps {
     /** Array of data objects */
     data: TDatum[];
     /** Array of field names to include in the matrix */
@@ -65,7 +65,7 @@ export interface ScatterplotMatrixProps<TDatum extends Record<string, any> = Rec
  * />
  * ```
  */
-export declare function ScatterplotMatrix<TDatum extends Record<string, any> = Record<string, any>>(props: ScatterplotMatrixProps<TDatum>): React.JSX.Element;
+export declare function ScatterplotMatrix<TDatum extends Datum = Datum>(props: ScatterplotMatrixProps<TDatum>): import("react/jsx-runtime").JSX.Element;
 export declare namespace ScatterplotMatrix {
     var displayName: string;
 }

package/dist/components/charts/xy/StackedAreaChart.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -7,7 +8,7 @@ import { type TooltipProp } from "../../Tooltip/Tooltip";
 /**
  * StackedAreaChart component props
  */
-export interface StackedAreaChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps, AxisConfig {
+export interface StackedAreaChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
     /**
      * Array of data points, grouped by category.
      * @example
@@ -124,7 +125,7 @@ export interface StackedAreaChartProps<TDatum extends Record<string, any> = Reco
     /**
      * Annotation objects to render on the chart
      */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /**
      * Additional StreamXYFrame props for advanced customization
      * For full control, consider using StreamXYFrame directly
@@ -157,6 +158,6 @@ export interface StackedAreaChartProps<TDatum extends Record<string, any> = Reco
  * ```
  */
 export declare const StackedAreaChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: StackedAreaChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: StackedAreaChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/data/transforms.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * Data transform helpers for common data shapes.
  * Import from "semiotic/data"
@@ -6,7 +7,7 @@
  * Bin continuous data into histogram-ready format.
  * Returns array of { category, value } objects suitable for BarChart.
  */
-export declare function bin<T extends Record<string, any>>(data: T[], options: {
+export declare function bin<T extends Datum>(data: T[], options: {
     field: string;
     bins?: number;
     domain?: [number, number];
@@ -18,28 +19,28 @@ export declare function bin<T extends Record<string, any>>(data: T[], options: {
  * Group and aggregate data.
  * Returns array of { [groupBy]: string, value: number } objects.
  */
-export declare function rollup<T extends Record<string, any>>(data: T[], options: {
+export declare function rollup<T extends Datum>(data: T[], options: {
     groupBy: string;
     value: string;
     agg?: "sum" | "mean" | "count" | "min" | "max";
-}): Record<string, any>[];
+}): Datum[];
 /**
  * Group flat rows into line-chart-ready nested format.
  * Returns array of { id, coordinates } objects for LineChart with lineBy.
  */
-export declare function groupBy<T extends Record<string, any>>(data: T[], options: {
+export declare function groupBy<T extends Datum>(data: T[], options: {
     key: string;
     fields?: string[];
 }): {
     id: string;
-    coordinates: Record<string, any>[];
+    coordinates: Datum[];
 }[];
 /**
  * Pivot wide data to long format.
  * Converts column-per-variable to row-per-variable.
  */
-export declare function pivot<T extends Record<string, any>>(data: T[], options: {
+export declare function pivot<T extends Datum>(data: T[], options: {
     columns: string[];
     nameField?: string;
     valueField?: string;
-}): Record<string, any>[];
+}): Datum[];

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

@@ -1,9 +1,10 @@
 import type { SerializedSelections } from "./selectionSerializer";
+import type { Datum } from "../charts/shared/datumTypes";
 export interface ChartConfig {
     /** Component name, e.g. "LineChart", "SankeyDiagram" */
     component: string;
     /** Serializable props only — functions and React elements stripped */
-    props: Record<string, any>;
+    props: Datum;
     /** Config schema version */
     version: string;
     /** ISO 8601 timestamp */
@@ -18,10 +19,10 @@ export interface ToConfigOptions {
     selections?: SerializedSelections;
 }
 export type CopyFormat = "json" | "jsx";
-export declare function toConfig(componentName: string, props: Record<string, any>, options?: ToConfigOptions): ChartConfig;
+export declare function toConfig(componentName: string, props: Datum, options?: ToConfigOptions): ChartConfig;
 export declare function fromConfig(config: ChartConfig): {
     componentName: string;
-    props: Record<string, any>;
+    props: Datum;
 };
 export declare function toURL(config: ChartConfig): string;
 export declare function fromURL(urlString: string): ChartConfig;

package/dist/components/geo/mergeData.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../charts/shared/datumTypes";
 /**
  * Merge external data into GeoJSON features by joining on a key field.
  *
@@ -12,7 +13,7 @@
  * Cross-pollination: This pattern (key-based data join) could be extracted
  * to a shared utility for any data merge operation in Semiotic.
  */
-export declare function mergeData<T extends Record<string, any>>(features: GeoJSON.Feature[], data: T[], options: {
+export declare function mergeData<T extends Datum>(features: GeoJSON.Feature[], data: T[], options: {
     featureKey: string;
     dataKey: string;
 }): GeoJSON.Feature[];

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,14 @@ 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
@@ -199,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-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,6 +15,7 @@ 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";
@@ -25,3 +26,4 @@ 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;
@@ -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,14 +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;
@@ -20,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;
@@ -61,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;