semiotic 3.0.0 → 3.1.0

package/dist/{charts → components/charts}/xy/StackedAreaChart.d.ts

@@ -1,5 +1,7 @@
 import * as React from "react";
 import type { StreamXYFrameProps } from "../../stream/types";
+import type { RealtimeFrameHandle } from "../../realtime/types";
+import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 /**
@@ -13,7 +15,7 @@ export interface StackedAreaChartProps<TDatum extends Record<string, any> = Reco
      * [{x: 1, y: 10, category: 'A'}, {x: 2, y: 20, category: 'A'}, {x: 1, y: 15, category: 'B'}]
      * ```
      */
-    data: TDatum[];
+    data?: TDatum[];
     /**
      * Field name or function to access x values
      * @default "x"
@@ -93,6 +95,17 @@ export interface StackedAreaChartProps<TDatum extends Record<string, any> = Reco
      * @default true (when multiple areas)
      */
     showLegend?: boolean;
+    /**
+     * Legend interaction mode.
+     * - "highlight": hover dims non-hovered categories to 30% opacity
+     * - "isolate": click toggles category visibility with checkmark indicators
+     * - "none": static legend (default)
+     */
+    legendInteraction?: LegendInteractionMode;
+    /**
+     * Legend position
+     */
+    legendPosition?: LegendPosition;
     /**
      * Tooltip configuration
      */
@@ -132,7 +145,7 @@ export interface StackedAreaChartProps<TDatum extends Record<string, any> = Reco
  * />
  * ```
  */
-export declare function StackedAreaChart<TDatum extends Record<string, any> = Record<string, any>>(props: StackedAreaChartProps<TDatum>): React.JSX.Element;
-export declare namespace StackedAreaChart {
-    var displayName: string;
-}
+export declare const StackedAreaChart: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: StackedAreaChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{export → components/export}/exportChart.d.ts

@@ -1,5 +1,10 @@
 /**
- * Export a semiotic chart to SVG or PNG from the browser.
+ * Export a semiotic chart to PNG (default) or SVG from the browser.
+ *
+ * PNG export composites the canvas data layer underneath the SVG overlay,
+ * producing a complete image. SVG export captures only the SVG overlay
+ * (axes, labels, annotations) since canvas content cannot be represented
+ * as SVG.
  *
  * @example
  * ```tsx

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

@@ -0,0 +1,18 @@
+/**
+ * Merge external data into GeoJSON features by joining on a key field.
+ *
+ * @example
+ * ```ts
+ * const enriched = mergeData(worldCountries, myCSV, {
+ *   featureKey: "properties.iso_a3",
+ *   dataKey: "country_code"
+ * })
+ * ```
+ *
+ * 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: {
+    featureKey: string;
+    dataKey: string;
+}): GeoJSON.Feature[];

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

@@ -0,0 +1,10 @@
+export type ReferenceGeography = "world-110m" | "world-50m" | "land-110m" | "land-50m";
+/**
+ * Resolve a string reference to GeoJSON features.
+ * Uses dynamic import so bundlers can tree-shake/code-split the data.
+ */
+export declare function resolveReferenceGeography(name: ReferenceGeography): Promise<GeoJSON.Feature[]>;
+/**
+ * Check whether a value is a known reference geography string.
+ */
+export declare function isReferenceGeography(value: unknown): value is ReferenceGeography;

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

@@ -0,0 +1,13 @@
+import { type ReferenceGeography } from "./referenceGeography";
+export type AreasProp = GeoJSON.Feature[] | ReferenceGeography;
+/**
+ * Hook that resolves an `areas` prop — either GeoJSON features passed directly,
+ * or a string reference ("world-110m", etc.) that triggers an async load.
+ *
+ * Returns `null` while loading, resolved features when ready.
+ *
+ * When `areas` is already an array, the value is returned synchronously via
+ * useMemo (no stale-frame lag between prop changes). The useState+useEffect
+ * path is only used for async reference string resolution.
+ */
+export declare function useReferenceAreas(areas: AreasProp | undefined): GeoJSON.Feature[] | null;

package/dist/{realtime → components/realtime}/RingBuffer.d.ts

@@ -10,6 +10,7 @@ export declare class RingBuffer<T> {
     peek(): T | undefined;
     peekOldest(): T | undefined;
     [Symbol.iterator](): Iterator<T>;
+    forEach(callback: (value: T, index: number) => void): void;
     toArray(): T[];
     resize(newCapacity: number): T[];
     clear(): void;

package/dist/{realtime → components/realtime}/types.d.ts

@@ -8,6 +8,16 @@ export interface LineStyle {
     strokeWidth?: number;
     strokeDasharray?: string;
 }
+/**
+ * Anchoring mode for streaming annotations.
+ * - `"fixed"` (default): anchored to specific datum coordinates; disappears when out of view.
+ * - `"latest"`: annotation attaches to the most recent datum in the buffer.
+ *   On each frame, the annotation's position is re-resolved to the latest data point.
+ *   Useful for "current value" labels.
+ * - `"sticky"`: annotation stays at its last known pixel position after the target datum
+ *   is evicted from the window. It freezes in place rather than disappearing.
+ */
+export type AnnotationAnchorMode = "fixed" | "latest" | "sticky";
 export interface AnnotationContext {
     scales?: {
         x?: ScaleLinear<number, number>;
@@ -30,6 +40,13 @@ export interface AnnotationContext {
         y: number;
         r: number;
     }[];
+    /** Curve interpolation type from the parent chart */
+    curve?: string;
+    /** Cache of last known pixel positions for sticky annotations, keyed by annotation index */
+    stickyPositionCache?: Map<number, {
+        x: number;
+        y: number;
+    }>;
 }
 export interface CrosshairStyle {
     stroke?: string;

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

@@ -0,0 +1,61 @@
+export { LineChart } from "./charts/xy/LineChart";
+export { AreaChart } from "./charts/xy/AreaChart";
+export { StackedAreaChart } from "./charts/xy/StackedAreaChart";
+export { Scatterplot } from "./charts/xy/Scatterplot";
+export { ConnectedScatterplot } from "./charts/xy/ConnectedScatterplot";
+export { BubbleChart } from "./charts/xy/BubbleChart";
+export { Heatmap } from "./charts/xy/Heatmap";
+export { ScatterplotMatrix } from "./charts/xy/ScatterplotMatrix";
+export { LinkedCharts } from "./LinkedCharts";
+export { useSelection, useLinkedHover, useBrushSelection, useFilteredData } from "./LinkedCharts";
+export { BarChart } from "./charts/ordinal/BarChart";
+export { StackedBarChart } from "./charts/ordinal/StackedBarChart";
+export { GroupedBarChart } from "./charts/ordinal/GroupedBarChart";
+export { SwarmPlot } from "./charts/ordinal/SwarmPlot";
+export { BoxPlot } from "./charts/ordinal/BoxPlot";
+export { Histogram } from "./charts/ordinal/Histogram";
+export { ViolinPlot } from "./charts/ordinal/ViolinPlot";
+export { DotPlot } from "./charts/ordinal/DotPlot";
+export { RidgelinePlot } from "./charts/ordinal/RidgelinePlot";
+export { PieChart } from "./charts/ordinal/PieChart";
+export { DonutChart } from "./charts/ordinal/DonutChart";
+export { ForceDirectedGraph } from "./charts/network/ForceDirectedGraph";
+export { ChordDiagram } from "./charts/network/ChordDiagram";
+export { SankeyDiagram } from "./charts/network/SankeyDiagram";
+export { TreeDiagram } from "./charts/network/TreeDiagram";
+export { Treemap } from "./charts/network/Treemap";
+export { CirclePack } from "./charts/network/CirclePack";
+export { OrbitDiagram } from "./charts/network/OrbitDiagram";
+export { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
+export { RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+export { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
+export { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
+export { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
+export { TooltipProvider } from "./store/TooltipStore";
+export { MultiLineTooltip } from "./Tooltip/Tooltip";
+export { ThemeProvider, useTheme } from "./ThemeProvider";
+export { exportChart } from "./export/exportChart";
+export { ChartContainer } from "./ChartContainer";
+export type { ChartContainerProps, ChartContainerHandle } from "./ChartContainer";
+export { ChartGrid } from "./ChartGrid";
+export type { ChartGridProps } from "./ChartGrid";
+export { ContextLayout } from "./ContextLayout";
+export type { ContextLayoutProps } from "./ContextLayout";
+export { CategoryColorProvider, useCategoryColors } from "./CategoryColors";
+export type { CategoryColorMap, CategoryColorProviderProps } from "./CategoryColors";
+export { DetailsPanel } from "./DetailsPanel";
+export type { DetailsPanelProps } from "./DetailsPanel";
+export { validateProps } from "./charts/shared/validateProps";
+export type { ValidationResult } from "./charts/shared/validateProps";
+export { diagnoseConfig } from "./charts/shared/diagnoseConfig";
+export type { Diagnosis, DiagnosisResult } from "./charts/shared/diagnoseConfig";
+export type { AnomalyConfig, ForecastConfig } from "./charts/shared/statisticalOverlays";
+export { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
+export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
+export { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
+export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
+export { fromVegaLite } from "./data/fromVegaLite";
+export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
+export { useChartObserver } from "./store/useObservation";
+export type { UseChartObserverOptions, UseChartObserverResult } from "./store/useObservation";
+export type { ChartObservation, OnObservationCallback, HoverObservation, HoverEndObservation, BrushObservation, BrushEndObservation, SelectionObservation, SelectionEndObservation, ClickObservation, ClickEndObservation } from "./store/ObservationStore";

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

@@ -0,0 +1,8 @@
+/**
+ * Semiotic data transform utilities.
+ * Import from "semiotic/data"
+ */
+export { bin, rollup, groupBy, pivot } from "./data/transforms";
+export { fromVegaLite } from "./data/fromVegaLite";
+export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
+export { mergeData } from "./geo/mergeData";

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

@@ -0,0 +1,16 @@
+/**
+ * Geo entry point — geographic visualization: choropleth, proportional symbol, flow maps.
+ * Import from "semiotic/geo" instead of the full bundle to reduce bundle size.
+ */
+import StreamGeoFrame from "./stream/StreamGeoFrame";
+export { StreamGeoFrame };
+export { ChoroplethMap } from "./charts/geo/ChoroplethMap";
+export { ProportionalSymbolMap } from "./charts/geo/ProportionalSymbolMap";
+export { FlowMap } from "./charts/geo/FlowMap";
+export { DistanceCartogram } from "./charts/geo/DistanceCartogram";
+export type { StreamGeoFrameProps, StreamGeoFrameHandle, GeoAreaSceneNode, GeoSceneNode, GeoScales, ProjectionProp, ProjectionName, GraticuleConfig, DistanceCartogramConfig, GeoPipelineConfig } from "./stream/geoTypes";
+export type { GeoParticleStyle } from "./stream/GeoParticlePool";
+export { mergeData } from "./geo/mergeData";
+export { resolveReferenceGeography } from "./geo/referenceGeography";
+export type { ReferenceGeography } from "./geo/referenceGeography";
+export type { AreasProp } from "./geo/useReferenceAreas";

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

@@ -0,0 +1,14 @@
+/**
+ * Network entry point — force graphs, sankey, chord, trees, treemaps, circle packing.
+ * Import from "semiotic/network" instead of the full bundle to reduce bundle size.
+ */
+import StreamNetworkFrame from "./stream/StreamNetworkFrame";
+export { StreamNetworkFrame };
+export { ForceDirectedGraph } from "./charts/network/ForceDirectedGraph";
+export { SankeyDiagram } from "./charts/network/SankeyDiagram";
+export { ChordDiagram } from "./charts/network/ChordDiagram";
+export { TreeDiagram } from "./charts/network/TreeDiagram";
+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";

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

@@ -0,0 +1,18 @@
+/**
+ * Ordinal entry point — bar charts, pie charts, distribution charts.
+ * Import from "semiotic/ordinal" instead of the full bundle to reduce bundle size.
+ */
+import StreamOrdinalFrame from "./stream/StreamOrdinalFrame";
+export { StreamOrdinalFrame };
+export { BarChart } from "./charts/ordinal/BarChart";
+export { StackedBarChart } from "./charts/ordinal/StackedBarChart";
+export { GroupedBarChart } from "./charts/ordinal/GroupedBarChart";
+export { SwarmPlot } from "./charts/ordinal/SwarmPlot";
+export { BoxPlot } from "./charts/ordinal/BoxPlot";
+export { Histogram } from "./charts/ordinal/Histogram";
+export { ViolinPlot } from "./charts/ordinal/ViolinPlot";
+export { DotPlot } from "./charts/ordinal/DotPlot";
+export { PieChart } from "./charts/ordinal/PieChart";
+export { DonutChart } from "./charts/ordinal/DonutChart";
+export { RidgelinePlot } from "./charts/ordinal/RidgelinePlot";
+export type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle, OrdinalChartType, OrdinalScales, OrdinalSceneNode } from "./stream/ordinalTypes";

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

@@ -0,0 +1,22 @@
+/**
+ * Realtime entry point — for streaming/realtime canvas-first visualizations.
+ * Import from "semiotic/realtime" instead of the full bundle to reduce bundle size.
+ */
+import StreamXYFrame from "./stream/StreamXYFrame";
+import StreamNetworkFrame from "./stream/StreamNetworkFrame";
+import { RingBuffer } from "./realtime/RingBuffer";
+import { IncrementalExtent } from "./realtime/IncrementalExtent";
+import { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
+import { RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+import { RealtimeSwarmChart } from "./charts/realtime/RealtimeSwarmChart";
+import { RealtimeWaterfallChart } from "./charts/realtime/RealtimeWaterfallChart";
+import { RealtimeHeatmap } from "./charts/realtime/RealtimeHeatmap";
+export { StreamXYFrame, StreamNetworkFrame, RingBuffer, IncrementalExtent, RealtimeLineChart, RealtimeHistogram, RealtimeSwarmChart, RealtimeWaterfallChart, RealtimeHeatmap };
+export type { RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
+export type { RealtimeHistogramProps } from "./charts/realtime/RealtimeHistogram";
+export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
+export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
+export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";
+export type { ArrowOfTime, WindowMode, ThresholdType, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, AnnotationContext, CrosshairStyle, HoverAnnotationConfig, HoverData } from "./realtime/types";
+export type { StreamXYFrameProps, StreamXYFrameHandle, StreamChartType } from "./stream/types";
+export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType } from "./stream/networkTypes";

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

@@ -0,0 +1 @@
+export { renderToStaticSVG, renderXYToStaticSVG, renderOrdinalToStaticSVG, renderNetworkToStaticSVG, renderGeoToStaticSVG } from "./server/renderToStaticSVG";

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

@@ -0,0 +1,17 @@
+/**
+ * XY entry point — line, area, scatter, heatmap, and bubble charts.
+ * Import from "semiotic/xy" instead of the full bundle to reduce bundle size.
+ */
+import StreamXYFrame from "./stream/StreamXYFrame";
+export { StreamXYFrame };
+export { LineChart } from "./charts/xy/LineChart";
+export { AreaChart } from "./charts/xy/AreaChart";
+export { StackedAreaChart } from "./charts/xy/StackedAreaChart";
+export { Scatterplot } from "./charts/xy/Scatterplot";
+export { ConnectedScatterplot } from "./charts/xy/ConnectedScatterplot";
+export { BubbleChart } from "./charts/xy/BubbleChart";
+export { Heatmap } from "./charts/xy/Heatmap";
+export { ScatterplotMatrix } from "./charts/xy/ScatterplotMatrix";
+export { MinimapChart } from "./charts/xy/MinimapChart";
+export { QuadrantChart } from "./charts/xy/QuadrantChart";
+export type { StreamXYFrameProps, StreamXYFrameHandle } from "./stream/types";

package/dist/components/semiotic.d.ts

@@ -0,0 +1,57 @@
+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, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, PieChart, DonutChart, GroupedBarChart, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart } from "./charts";
+import { LinkedCharts } from "./LinkedCharts";
+import { ThemeProvider, useTheme } from "./ThemeProvider";
+import { exportChart } from "./export/exportChart";
+import { toConfig, fromConfig, toURL, fromURL, copyConfig, configToJSX } from "./export/chartConfig";
+import { serializeSelections, deserializeSelections } from "./export/selectionSerializer";
+import { fromVegaLite } from "./data/fromVegaLite";
+import { ChartErrorBoundary } from "./ChartErrorBoundary";
+import { ChartContainer } from "./ChartContainer";
+import { ChartGrid } from "./ChartGrid";
+import { CategoryColorProvider, useCategoryColors } from "./CategoryColors";
+import { ContextLayout } from "./ContextLayout";
+import { DetailsPanel } from "./DetailsPanel";
+import { Tooltip, MultiLineTooltip, normalizeTooltip } from "./Tooltip/Tooltip";
+import { RingBuffer } from "./realtime/RingBuffer";
+import { IncrementalExtent } from "./realtime/IncrementalExtent";
+import { RealtimeLineChart } from "./charts/realtime/RealtimeLineChart";
+import { RealtimeTemporalHistogram, RealtimeHistogram } from "./charts/realtime/RealtimeHistogram";
+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, SwarmPlot, BoxPlot, Histogram, ViolinPlot, RidgelinePlot, DotPlot, ForceDirectedGraph, ChordDiagram, SankeyDiagram, TreeDiagram, PieChart, DonutChart, GroupedBarChart, Treemap, CirclePack, OrbitDiagram, ScatterplotMatrix, MinimapChart, QuadrantChart, 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 };
+export { ScatterplotProps, ConnectedScatterplotProps, LineChartProps, AreaChartProps, StackedAreaChartProps, HeatmapProps, BubbleChartProps, BarChartProps, StackedBarChartProps, SwarmPlotProps, BoxPlotProps, HistogramProps, ViolinPlotProps, DotPlotProps, PieChartProps, DonutChartProps, GroupedBarChartProps, RidgelinePlotProps, OrbitDiagramProps, OrbitNode, ForceDirectedGraphProps, ChordDiagramProps, SankeyDiagramProps, TreeDiagramProps, TreemapProps, CirclePackProps, ScatterplotMatrixProps, MinimapChartProps, MinimapConfig, QuadrantChartProps, 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";
+export type { StreamNetworkFrameProps, StreamNetworkFrameHandle, NetworkChartType, NetworkSceneNode, NetworkSceneEdge, NetworkLabel, ThresholdAlertConfig } from "./stream/networkTypes";
+export type { SelectionConfig, LinkedHoverProp, LinkedBrushProp } from "./charts/shared/types";
+export type { LinkedChartsProps } from "./LinkedCharts";
+export { useSelection, useLinkedHover, useBrushSelection, useFilteredData } from "./LinkedCharts";
+export type { UseSelectionOptions, UseSelectionResult, UseLinkedHoverOptions, UseLinkedHoverResult, UseBrushSelectionOptions, UseBrushSelectionResult } from "./LinkedCharts";
+export { useChartObserver } from "./LinkedCharts";
+export type { UseChartObserverOptions, UseChartObserverResult } from "./LinkedCharts";
+export type { ChartObservation, OnObservationCallback } from "./store/ObservationStore";
+export type { ResolutionMode, SelectionClause, Selection } from "./store/SelectionStore";
+export type { SemioticTheme } from "./ThemeProvider";
+export { LIGHT_THEME, DARK_THEME } from "./ThemeProvider";
+export type { ChartErrorBoundaryProps } from "./ChartErrorBoundary";
+export type { ChartContainerProps, ChartContainerHandle } from "./ChartContainer";
+export type { ChartGridProps } from "./ChartGrid";
+export type { CategoryColorMap, CategoryColorProviderProps } from "./CategoryColors";
+export type { ContextLayoutProps } from "./ContextLayout";
+export type { DetailsPanelProps } from "./DetailsPanel";
+export type { ChartConfig, ToConfigOptions, CopyFormat } from "./export/chartConfig";
+export type { VegaLiteSpec, VegaLiteEncoding } from "./data/fromVegaLite";
+export type { SerializedSelections, SerializedSelection, SerializedFieldSelection } from "./export/selectionSerializer";
+export { smartTickFormat } from "./charts/shared/formatUtils";
+export type { TooltipProp, TooltipConfig, TooltipField, MultiLineTooltipConfig } from "./Tooltip/Tooltip";
+export type { ArrowOfTime, WindowMode, ThresholdType, LineStyle, BarStyle, WaterfallStyle, SwarmStyle, AnnotationContext, AnnotationAnchorMode, CrosshairStyle, HoverAnnotationConfig, HoverData } from "./realtime/types";
+export type { RealtimeLineChartProps } from "./charts/realtime/RealtimeLineChart";
+export type { RealtimeTemporalHistogramProps, RealtimeHistogramProps } from "./charts/realtime/RealtimeHistogram";
+export type { RealtimeSwarmChartProps } from "./charts/realtime/RealtimeSwarmChart";
+export type { RealtimeWaterfallChartProps } from "./charts/realtime/RealtimeWaterfallChart";
+export type { RealtimeHeatmapProps } from "./charts/realtime/RealtimeHeatmap";

package/dist/{server → components/server}/renderToStaticSVG.d.ts

@@ -1,9 +1,18 @@
+/**
+ * Server-side rendering of Semiotic charts to standalone SVG strings.
+ *
+ * Uses the shared SceneToSVG converters (same code used by Stream Frames
+ * for SSR) plus PipelineStore / OrdinalPipelineStore / NetworkPipelineStore
+ * for scene graph computation.
+ */
 import type { StreamXYFrameProps } from "../stream/types";
 import type { StreamNetworkFrameProps } from "../stream/networkTypes";
 import type { StreamOrdinalFrameProps } from "../stream/ordinalTypes";
-type FrameType = "xy" | "ordinal" | "network";
-export declare function renderToStaticSVG(frameType: FrameType, props: StreamXYFrameProps | StreamNetworkFrameProps | StreamOrdinalFrameProps): string;
+import type { StreamGeoFrameProps } from "../stream/geoTypes";
+type FrameType = "xy" | "ordinal" | "network" | "geo";
+export declare function renderToStaticSVG(frameType: FrameType, props: StreamXYFrameProps | StreamNetworkFrameProps | StreamOrdinalFrameProps | StreamGeoFrameProps): string;
 export declare function renderXYToStaticSVG(props: StreamXYFrameProps): string;
 export declare function renderOrdinalToStaticSVG(props: StreamOrdinalFrameProps): string;
 export declare function renderNetworkToStaticSVG(props: StreamNetworkFrameProps): string;
+export declare function renderGeoToStaticSVG(props: StreamGeoFrameProps): string;
 export {};

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

@@ -0,0 +1,50 @@
+import * as React from "react";
+/** Scene node type used by the accessible data table — accepts any frame's scene nodes */
+type AnySceneNode = {
+    type: string;
+    [key: string]: any;
+};
+/**
+ * Compute an aria-label describing the chart type and data shape from the scene graph.
+ */
+export declare function computeCanvasAriaLabel(scene: AnySceneNode[], chartType: string): string;
+/**
+ * Compute an aria-label for network charts from scene nodes and edges.
+ */
+export declare function computeNetworkAriaLabel(nodeCount: number, edgeCount: number, chartType: string): string;
+interface AccessibleDataTableProps {
+    scene: AnySceneNode[];
+    chartType: string;
+}
+/**
+ * Visually-hidden data table for screen readers, generated from the scene graph.
+ * Renders up to 50 rows with a truncation note.
+ */
+export declare function AccessibleDataTable({ scene, chartType }: AccessibleDataTableProps): React.JSX.Element | null;
+interface NetworkAccessibleDataTableProps {
+    nodes: Array<{
+        datum?: any;
+        id?: string;
+        cx?: number;
+        cy?: number;
+        x?: number;
+        y?: number;
+    }>;
+    edges: Array<{
+        datum?: any;
+        source?: string;
+        target?: string;
+    }>;
+    chartType: string;
+}
+/**
+ * Visually-hidden data table for network charts.
+ */
+export declare function NetworkAccessibleDataTable({ nodes, edges, chartType }: NetworkAccessibleDataTableProps): React.JSX.Element | null;
+/**
+ * Visually-hidden aria-live region that mirrors tooltip text for screen readers.
+ */
+export declare function AriaLiveTooltip({ hoverPoint }: {
+    hoverPoint: any;
+}): React.JSX.Element;
+export {};

package/dist/{stream → components/stream}/CanvasHitTester.d.ts

@@ -1,5 +1,6 @@
-import type { SceneNode } from "./types";
+import type { SceneNode, PointSceneNode } from "./types";
 import type { RingBuffer } from "../realtime/RingBuffer";
+import type { Quadtree } from "d3-quadtree";
 export interface HitResult {
     node: SceneNode;
     datum: any;
@@ -10,8 +11,13 @@ export interface HitResult {
 /**
  * Find the nearest scene node to the given pixel coordinates.
  * 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
+ * use the linear scan.
  */
-export declare function findNearestNode(scene: SceneNode[], px: number, py: number, maxDistance?: number): HitResult | null;
+export declare function findNearestNode(scene: SceneNode[], px: number, py: number, maxDistance?: number, pointQuadtree?: Quadtree<PointSceneNode> | null): HitResult | null;
 /**
  * Binary search for nearest point by time value in a RingBuffer.
  */

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

@@ -0,0 +1,64 @@
+import type { Changeset } from "./types";
+export type ChangesetCallback<T> = (changeset: Changeset<T>) => void;
+export declare class DataSourceAdapter<T = Record<string, any>> {
+    private callback;
+    private lastBoundedData;
+    private chunkTimer;
+    private chunkThreshold;
+    private chunkSize;
+    /** Buffer for batching high-frequency push() calls */
+    private pushBuffer;
+    /** Whether a microtask flush is already scheduled */
+    private flushScheduled;
+    constructor(callback: ChangesetCallback<T>, options?: {
+        chunkThreshold?: number;
+        chunkSize?: number;
+    });
+    /** Update chunking options without recreating the adapter. */
+    updateChunkOptions(options: {
+        chunkThreshold?: number;
+        chunkSize?: number;
+    }): void;
+    /** Clear the dedup cache so the next setBoundedData call re-ingests even the same reference.
+     *  Also cancels any in-flight progressive chunking and discards buffered pushes. */
+    clearLastData(): void;
+    /**
+     * Ingest a bounded data array (from props).
+     *
+     * Small datasets emit a single changeset synchronously.
+     * Large datasets (> CHUNK_THRESHOLD) are split into chunks that render
+     * progressively: the first chunk fires immediately (bounded: true to
+     * reset + seed the buffer), subsequent chunks arrive on successive
+     * animation frames (bounded: false so they append without clearing).
+     */
+    setBoundedData(data: T[]): void;
+    /**
+     * Flush all buffered push data as a single changeset.
+     * Called automatically via microtask after push()/pushMany().
+     */
+    private flushPushBuffer;
+    /** Schedule a microtask flush if one isn't already pending. */
+    private scheduleFlush;
+    /**
+     * Push a single datum (streaming mode).
+     * Data is buffered and flushed as a single changeset via microtask,
+     * so rapid sequential push() calls within the same task are batched
+     * into one callback invocation.
+     */
+    push(datum: T): void;
+    /**
+     * Push multiple data (streaming batch).
+     * Like push(), data is buffered and flushed via microtask. Multiple
+     * pushMany() calls within the same task are coalesced.
+     */
+    pushMany(data: T[]): void;
+    /**
+     * Immediately flush any buffered push data without waiting for the microtask.
+     * Useful when you need the data to be processed synchronously (e.g., in tests).
+     */
+    flush(): void;
+    /**
+     * Reset the adapter state.
+     */
+    clear(): void;
+}

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

@@ -0,0 +1,19 @@
+import type { GeoSceneNode } from "./geoTypes";
+import type { PointSceneNode } from "./types";
+import type { Quadtree } from "d3-quadtree";
+export interface GeoHitResult {
+    node: GeoSceneNode;
+    distance: number;
+}
+/**
+ * Hit test geo scene nodes.
+ *
+ * Strategy:
+ * 1. Points first (topmost visual layer) — quadtree if available, else linear scan
+ * 2. Geo areas via ctx.isPointInPath(Path2D) — reverse order for top-layer-wins
+ * 3. Lines via closest-segment distance
+ *
+ * The `hitCtx` parameter is a shared offscreen canvas context used for
+ * isPointInPath checks without polluting the visible canvas.
+ */
+export declare function findNearestGeoNode(nodes: GeoSceneNode[], mouseX: number, mouseY: number, maxDistance: number, hitCtx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, pointQuadtree?: Quadtree<PointSceneNode>): GeoHitResult | null;

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

@@ -0,0 +1,46 @@
+/**
+ * GeoParticlePool — particle system for geo line paths.
+ *
+ * Unlike the network ParticlePool (which uses bezier curves), this
+ * travels particles along polyline paths (arrays of screen-space points).
+ * Used by StreamGeoFrame to animate flow lines on maps.
+ */
+export interface GeoParticle {
+    /** Progress along the polyline [0, 1] */
+    t: number;
+    /** Perpendicular offset from path centerline [-0.5, 0.5] */
+    offset: number;
+    /** Which line index this particle travels */
+    lineIndex: number;
+    active: boolean;
+    x: number;
+    y: number;
+}
+export interface GeoParticleStyle {
+    /** Particle radius @default 2 */
+    radius?: number;
+    /** Particle color: a CSS color string, "source" to inherit from line stroke, or a function `(datum) => string` */
+    color?: string | ((datum: any) => string);
+    /** Particle opacity @default 0.7 */
+    opacity?: number;
+    /** Speed multiplier @default 1 */
+    speedMultiplier?: number;
+    /** Max particles per line @default 30 */
+    maxPerLine?: number;
+    /** Spawn rate (probability per frame per line) @default 0.15 */
+    spawnRate?: number;
+}
+export declare class GeoParticlePool {
+    particles: GeoParticle[];
+    private capacity;
+    constructor(capacity: number);
+    spawn(lineIndex: number): GeoParticle | null;
+    /**
+     * Advance all active particles.
+     * @param paths - array of polyline paths, one per line index
+     * @param lineWidths - strokeWidth per line (for perpendicular offset scaling)
+     */
+    step(deltaTime: number, speed: number, paths: [number, number][][], lineWidths: number[]): void;
+    countForLine(lineIndex: number): number;
+    clear(): void;
+}