semiotic 3.0.0 → 3.1.0

package/dist/components/charts/geo/ProportionalSymbolMap.d.ts

@@ -0,0 +1,67 @@
+import * as React from "react";
+import type { StreamGeoFrameProps, ProjectionProp } from "../../stream/geoTypes";
+import type { RealtimeFrameHandle } from "../../realtime/types";
+import type { BaseChartProps, ChartAccessor } from "../shared/types";
+import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
+import type { Style } from "../../stream/types";
+import { type AreasProp } from "../../geo/useReferenceAreas";
+export interface ProportionalSymbolMapProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+    /** Point data with geographic coordinates */
+    points?: TDatum[];
+    /** Longitude accessor @default "lon" */
+    xAccessor?: ChartAccessor<TDatum, number>;
+    /** Latitude accessor @default "lat" */
+    yAccessor?: ChartAccessor<TDatum, number>;
+    /** Field to scale point size */
+    sizeBy: ChartAccessor<TDatum, number>;
+    /** Min and max radius @default [3, 30] */
+    sizeRange?: [number, number];
+    /** Field to determine point color */
+    colorBy?: ChartAccessor<TDatum, string>;
+    /** Color scheme @default "category10" */
+    colorScheme?: string | string[];
+    /** Geographic projection @default "equalEarth" */
+    projection?: ProjectionProp;
+    /** Show graticule grid lines */
+    graticule?: boolean | import("../../stream/geoTypes").GraticuleConfig;
+    /** Optional background geography */
+    areas?: AreasProp;
+    /** Style for background areas @default { fill: "#f0f0f0", stroke: "#ccc" } */
+    areaStyle?: Style;
+    /** Tooltip config */
+    tooltip?: TooltipProp;
+    /** Show legend */
+    showLegend?: boolean;
+    /** Legend interaction mode */
+    legendInteraction?: LegendInteractionMode;
+    /** Legend position */
+    legendPosition?: LegendPosition;
+    /** Padding fraction for auto-fit projection. 0.1 = 10% inset from edges. @default 0 */
+    fitPadding?: number;
+    /** Enable zoom/pan. Defaults to true when tileURL is set, false otherwise. */
+    zoomable?: boolean;
+    /** [minZoom, maxZoom] @default [1, 8] */
+    zoomExtent?: [number, number];
+    /** Zoom change callback */
+    onZoom?: StreamGeoFrameProps["onZoom"];
+    /**
+     * When true, drag gestures rotate the projection (globe spinning)
+     * instead of panning. Defaults to true for orthographic projection.
+     */
+    dragRotate?: boolean;
+    /** Raster tile URL template or function. Enables tile basemap (Mercator only). */
+    tileURL?: string | ((z: number, x: number, y: number, dpr: number) => string);
+    /** Attribution text for tile provider */
+    tileAttribution?: string;
+    /** Max cached tiles @default 256 */
+    tileCacheSize?: number;
+    /** Annotations */
+    annotations?: Record<string, any>[];
+    /** Passthrough */
+    frameProps?: Partial<Omit<StreamGeoFrameProps, "points" | "projection">>;
+}
+export declare const ProportionalSymbolMap: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: ProportionalSymbolMapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/components/charts/geo/index.d.ts

@@ -0,0 +1,8 @@
+export { ChoroplethMap } from "./ChoroplethMap";
+export type { ChoroplethMapProps } from "./ChoroplethMap";
+export { ProportionalSymbolMap } from "./ProportionalSymbolMap";
+export type { ProportionalSymbolMapProps } from "./ProportionalSymbolMap";
+export { FlowMap } from "./FlowMap";
+export type { FlowMapProps } from "./FlowMap";
+export { DistanceCartogram } from "./DistanceCartogram";
+export type { DistanceCartogramProps } from "./DistanceCartogram";

package/dist/{charts → components/charts}/index.d.ts

@@ -24,6 +24,8 @@ export { ScatterplotMatrix } from "./xy/ScatterplotMatrix";
 export type { ScatterplotMatrixProps } from "./xy/ScatterplotMatrix";
 export { MinimapChart } from "./xy/MinimapChart";
 export type { MinimapChartProps, MinimapConfig } from "./xy/MinimapChart";
+export { QuadrantChart } from "./xy/QuadrantChart";
+export type { QuadrantChartProps, QuadrantsConfig, QuadrantConfig, CenterlineStyle } from "./xy/QuadrantChart";
 export { BarChart } from "./ordinal/BarChart";
 export type { BarChartProps } from "./ordinal/BarChart";
 export { StackedBarChart } from "./ordinal/StackedBarChart";
@@ -58,6 +60,8 @@ export { Treemap } from "./network/Treemap";
 export type { TreemapProps } from "./network/Treemap";
 export { CirclePack } from "./network/CirclePack";
 export type { CirclePackProps } from "./network/CirclePack";
+export { OrbitDiagram } from "./network/OrbitDiagram";
+export type { OrbitDiagramProps, OrbitNode } from "./network/OrbitDiagram";
 export { RealtimeLineChart } from "./realtime/RealtimeLineChart";
 export type { RealtimeLineChartProps } from "./realtime/RealtimeLineChart";
 export { RealtimeTemporalHistogram, RealtimeHistogram } from "./realtime/RealtimeHistogram";

package/dist/{charts → components/charts}/network/ChordDiagram.d.ts

@@ -1,13 +1,15 @@
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * ChordDiagram component props
  */
 export interface ChordDiagramProps<TNode extends Record<string, any> = Record<string, any>, TEdge extends Record<string, any> = Record<string, any>> extends BaseChartProps {
     nodes?: TNode[];
-    edges: TEdge[];
+    edges?: TEdge[];
     sourceAccessor?: ChartAccessor<TEdge, string>;
     targetAccessor?: ChartAccessor<TEdge, string>;
     valueAccessor?: ChartAccessor<TEdge, number>;
@@ -21,6 +23,7 @@ export interface ChordDiagramProps<TNode extends Record<string, any> = Record<st
     nodeLabel?: ChartAccessor<TNode, string>;
     showLabels?: boolean;
     enableHover?: boolean;
+    legendInteraction?: LegendInteractionMode;
     edgeOpacity?: number;
     tooltip?: TooltipProp;
     frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
@@ -30,7 +33,7 @@ export interface ChordDiagramProps<TNode extends Record<string, any> = Record<st
  *
  * Wraps StreamNetworkFrame (canvas-first) for chord relationship visualization.
  */
-export declare function ChordDiagram<TNode extends Record<string, any> = Record<string, any>, TEdge extends Record<string, any> = Record<string, any>>(props: ChordDiagramProps<TNode, TEdge>): React.JSX.Element;
-export declare namespace ChordDiagram {
-    var displayName: string;
-}
+export declare const ChordDiagram: {
+    <TNode extends Record<string, any> = Record<string, any>, TEdge extends Record<string, any> = Record<string, any>>(props: ChordDiagramProps<TNode, TEdge> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{charts → components/charts}/network/CirclePack.d.ts

@@ -1,14 +1,15 @@
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
-import type { BaseChartProps, ChartAccessor, Accessor } from "../shared/types";
+import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * CirclePack component props
  */
 export interface CirclePackProps<TNode extends Record<string, any> = Record<string, any>> extends BaseChartProps {
     data: TNode;
     childrenAccessor?: ChartAccessor<TNode, TNode[]>;
-    valueAccessor?: Accessor<number>;
+    valueAccessor?: ChartAccessor<TNode, number>;
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string | number>;
     colorScheme?: string | string[];
@@ -18,6 +19,7 @@ export interface CirclePackProps<TNode extends Record<string, any> = Record<stri
     circleOpacity?: number;
     padding?: number;
     enableHover?: boolean;
+    legendInteraction?: LegendInteractionMode;
     tooltip?: TooltipProp;
     frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
 }

package/dist/{charts → components/charts}/network/ForceDirectedGraph.d.ts

@@ -1,13 +1,15 @@
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 /**
  * ForceDirectedGraph component props
  */
 export interface ForceDirectedGraphProps<TNode extends Record<string, any> = Record<string, any>, TEdge extends Record<string, any> = Record<string, any>> extends BaseChartProps {
-    nodes: TNode[];
-    edges: TEdge[];
+    nodes?: TNode[];
+    edges?: TEdge[];
     nodeIDAccessor?: ChartAccessor<TNode, string>;
     sourceAccessor?: ChartAccessor<TEdge, string>;
     targetAccessor?: ChartAccessor<TEdge, string>;
@@ -24,6 +26,8 @@ export interface ForceDirectedGraphProps<TNode extends Record<string, any> = Rec
     showLabels?: boolean;
     enableHover?: boolean;
     showLegend?: boolean;
+    legendInteraction?: LegendInteractionMode;
+    legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
     frameProps?: Partial<Omit<StreamNetworkFrameProps, "nodes" | "edges" | "size">>;
 }
@@ -32,7 +36,7 @@ export interface ForceDirectedGraphProps<TNode extends Record<string, any> = Rec
  *
  * Wraps StreamNetworkFrame (canvas-first) for force-directed network visualization.
  */
-export declare function ForceDirectedGraph<TNode extends Record<string, any> = Record<string, any>, TEdge extends Record<string, any> = Record<string, any>>(props: ForceDirectedGraphProps<TNode, TEdge>): React.JSX.Element;
-export declare namespace ForceDirectedGraph {
-    var displayName: string;
-}
+export declare const ForceDirectedGraph: {
+    <TNode extends Record<string, any> = Record<string, any>, TEdge extends Record<string, any> = Record<string, any>>(props: ForceDirectedGraphProps<TNode, TEdge> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/components/charts/network/OrbitDiagram.d.ts

@@ -0,0 +1,79 @@
+import * as React from "react";
+import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
+import type { BaseChartProps } from "../shared/types";
+import { type TooltipProp } from "../../Tooltip/Tooltip";
+export interface OrbitNode {
+    datum: any;
+    x: number;
+    y: number;
+    ring: number;
+    angle: number;
+    depth: number;
+    parent?: OrbitNode;
+    children?: OrbitNode[];
+    id?: string;
+}
+type OrbitMode = "flat" | "solar" | "atomic" | number[];
+export interface OrbitDiagramProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+    /** Hierarchical data — single root object with children */
+    data: TDatum;
+    /** How to access children from each datum @default "children" */
+    childrenAccessor?: string | ((d: TDatum) => TDatum[] | null | undefined);
+    /** How to identify each node @default "name" */
+    nodeIdAccessor?: string | ((d: any) => string);
+    /** Field or function for node color */
+    colorBy?: string | ((d: any) => string);
+    /** Color scheme @default "category10" */
+    colorScheme?: string | string[];
+    /** Color by hierarchy depth instead of field @default false */
+    colorByDepth?: boolean;
+    /**
+     * Ring arrangement mode:
+     * - "flat": all children in one ring
+     * - "solar": one child per ring
+     * - "atomic": [2, 8] electron shell pattern
+     * - number[]: custom ring capacities (last value repeats)
+     * @default "flat"
+     */
+    orbitMode?: OrbitMode;
+    /** Ring size divisor per depth. Larger = tighter orbits. @default 2.95 */
+    orbitSize?: number | ((node: any) => number);
+    /** Orbit speed in degrees per frame @default 0.25 */
+    speed?: number;
+    /** Per-node speed modifier @default (node) => 1 / (node.depth + 1) */
+    revolution?: (node: any) => number;
+    /**
+     * Built-in revolution style presets:
+     * - "locked": children rotate with parent at decreasing speed (default)
+     * - "decay": each depth level progressively slower, independent of parent
+     * - "alternate": odd-depth rings reverse direction
+     * Ignored when `revolution` function is provided.
+     * @default "locked"
+     */
+    revolutionStyle?: "locked" | "decay" | "alternate";
+    /** Vertical squash for elliptical orbits. 1 = circle, 0.5 = ellipse @default 1 */
+    eccentricity?: number | ((node: any) => number);
+    /** Show orbital ring paths @default true */
+    showRings?: boolean;
+    /** Node radius. Number or function of node. @default 6 */
+    nodeRadius?: number | ((node: any) => number);
+    /** Show node labels @default false */
+    showLabels?: boolean;
+    /** Enable animation @default true */
+    animated?: boolean;
+    /** Tooltip configuration. Function form receives the raw datum (not OrbitNode). */
+    tooltip?: TooltipProp;
+    /** Enable hover @default true */
+    enableHover?: boolean;
+    /** Annotation objects */
+    annotations?: Array<Record<string, any>>;
+    /** Additional SVG content */
+    foregroundGraphics?: React.ReactNode;
+    /** Frame props passthrough */
+    frameProps?: Partial<Omit<StreamNetworkFrameProps, "data" | "size">>;
+}
+export declare function OrbitDiagram<TDatum extends Record<string, any> = Record<string, any>>(props: OrbitDiagramProps<TDatum>): React.JSX.Element;
+export declare namespace OrbitDiagram {
+    var displayName: string;
+}
+export {};

package/dist/{charts → components/charts}/network/SankeyDiagram.d.ts

@@ -1,13 +1,15 @@
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * SankeyDiagram component props
  */
 export interface SankeyDiagramProps<TNode extends Record<string, any> = Record<string, any>, TEdge extends Record<string, any> = Record<string, any>> extends BaseChartProps {
     nodes?: TNode[];
-    edges: TEdge[];
+    edges?: TEdge[];
     sourceAccessor?: ChartAccessor<TEdge, string>;
     targetAccessor?: ChartAccessor<TEdge, string>;
     valueAccessor?: ChartAccessor<TEdge, number>;
@@ -22,6 +24,7 @@ export interface SankeyDiagramProps<TNode extends Record<string, any> = Record<s
     nodeLabel?: ChartAccessor<TNode, string>;
     showLabels?: boolean;
     enableHover?: boolean;
+    legendInteraction?: LegendInteractionMode;
     edgeOpacity?: number;
     edgeSort?: (a: any, b: any) => number;
     tooltip?: TooltipProp;
@@ -32,7 +35,7 @@ export interface SankeyDiagramProps<TNode extends Record<string, any> = Record<s
  *
  * Wraps StreamNetworkFrame (canvas-first) for Sankey flow visualization.
  */
-export declare function SankeyDiagram<TNode extends Record<string, any> = Record<string, any>, TEdge extends Record<string, any> = Record<string, any>>(props: SankeyDiagramProps<TNode, TEdge>): React.JSX.Element;
-export declare namespace SankeyDiagram {
-    var displayName: string;
-}
+export declare const SankeyDiagram: {
+    <TNode extends Record<string, any> = Record<string, any>, TEdge extends Record<string, any> = Record<string, any>>(props: SankeyDiagramProps<TNode, TEdge> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{charts → components/charts}/network/TreeDiagram.d.ts

@@ -1,7 +1,8 @@
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
-import type { BaseChartProps, ChartAccessor, Accessor } from "../shared/types";
+import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * TreeDiagram component props
  */
@@ -10,7 +11,7 @@ export interface TreeDiagramProps<TNode extends Record<string, any> = Record<str
     layout?: "tree" | "cluster" | "partition" | "treemap" | "circlepack";
     orientation?: "vertical" | "horizontal" | "radial";
     childrenAccessor?: ChartAccessor<TNode, TNode[]>;
-    valueAccessor?: Accessor<number>;
+    valueAccessor?: ChartAccessor<TNode, number>;
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string | number>;
     colorScheme?: string | string[];
@@ -20,6 +21,7 @@ export interface TreeDiagramProps<TNode extends Record<string, any> = Record<str
     showLabels?: boolean;
     nodeSize?: number;
     enableHover?: boolean;
+    legendInteraction?: LegendInteractionMode;
     tooltip?: TooltipProp;
     frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
 }

package/dist/{charts → components/charts}/network/Treemap.d.ts

@@ -1,14 +1,15 @@
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
-import type { BaseChartProps, ChartAccessor, Accessor } from "../shared/types";
+import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * Treemap component props
  */
 export interface TreemapProps<TNode extends Record<string, any> = Record<string, any>> extends BaseChartProps {
     data: TNode;
     childrenAccessor?: ChartAccessor<TNode, TNode[]>;
-    valueAccessor?: Accessor<number>;
+    valueAccessor?: ChartAccessor<TNode, number>;
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string | number>;
     colorScheme?: string | string[];
@@ -19,6 +20,7 @@ export interface TreemapProps<TNode extends Record<string, any> = Record<string,
     padding?: number;
     paddingTop?: number;
     enableHover?: boolean;
+    legendInteraction?: LegendInteractionMode;
     tooltip?: TooltipProp;
     frameProps?: Partial<Omit<StreamNetworkFrameProps, "edges" | "size">>;
 }

package/dist/{charts → components/charts}/ordinal/BarChart.d.ts

@@ -1,12 +1,14 @@
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 /**
  * BarChart component props
  */
 export interface BarChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
-    data: TDatum[];
+    data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
     orientation?: "vertical" | "horizontal";
@@ -20,6 +22,8 @@ export interface BarChartProps<TDatum extends Record<string, any> = Record<strin
     enableHover?: boolean;
     showGrid?: boolean;
     showLegend?: boolean;
+    legendInteraction?: LegendInteractionMode;
+    legendPosition?: "right" | "left" | "top" | "bottom";
     tooltip?: TooltipProp;
     annotations?: Record<string, any>[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
@@ -27,7 +31,7 @@ export interface BarChartProps<TDatum extends Record<string, any> = Record<strin
 /**
  * BarChart - Visualize categorical data with bars.
  */
-export declare function BarChart<TDatum extends Record<string, any> = Record<string, any>>(props: BarChartProps<TDatum>): React.JSX.Element;
-export declare namespace BarChart {
-    var displayName: string;
-}
+export declare const BarChart: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: BarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{charts → components/charts}/ordinal/BoxPlot.d.ts

@@ -1,9 +1,11 @@
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 export interface BoxPlotProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
-    data: TDatum[];
+    data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
     orientation?: "vertical" | "horizontal";
@@ -18,11 +20,13 @@ export interface BoxPlotProps<TDatum extends Record<string, any> = Record<string
     enableHover?: boolean;
     showGrid?: boolean;
     showLegend?: boolean;
+    legendInteraction?: LegendInteractionMode;
+    legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
     annotations?: Record<string, any>[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
-export declare function BoxPlot<TDatum extends Record<string, any> = Record<string, any>>(props: BoxPlotProps<TDatum>): React.JSX.Element;
-export declare namespace BoxPlot {
-    var displayName: string;
-}
+export declare const BoxPlot: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: BoxPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{charts → components/charts}/ordinal/DonutChart.d.ts

@@ -1,9 +1,11 @@
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 export interface DonutChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
-    data: TDatum[];
+    data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
     innerRadius?: number;
@@ -14,11 +16,13 @@ export interface DonutChartProps<TDatum extends Record<string, any> = Record<str
     slicePadding?: number;
     enableHover?: boolean;
     showLegend?: boolean;
+    legendInteraction?: LegendInteractionMode;
+    legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
     annotations?: Record<string, any>[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
-export declare function DonutChart<TDatum extends Record<string, any> = Record<string, any>>(props: DonutChartProps<TDatum>): React.JSX.Element;
-export declare namespace DonutChart {
-    var displayName: string;
-}
+export declare const DonutChart: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: DonutChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{charts → components/charts}/ordinal/DotPlot.d.ts

@@ -1,9 +1,11 @@
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 export interface DotPlotProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
-    data: TDatum[];
+    data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
     orientation?: "vertical" | "horizontal";
@@ -18,11 +20,13 @@ export interface DotPlotProps<TDatum extends Record<string, any> = Record<string
     enableHover?: boolean;
     showGrid?: boolean;
     showLegend?: boolean;
+    legendInteraction?: LegendInteractionMode;
+    legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
     annotations?: Record<string, any>[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
-export declare function DotPlot<TDatum extends Record<string, any> = Record<string, any>>(props: DotPlotProps<TDatum>): React.JSX.Element;
-export declare namespace DotPlot {
-    var displayName: string;
-}
+export declare const DotPlot: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: DotPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{charts → components/charts}/ordinal/GroupedBarChart.d.ts

@@ -1,9 +1,11 @@
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 export interface GroupedBarChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
-    data: TDatum[];
+    data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     groupBy: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -17,11 +19,13 @@ export interface GroupedBarChartProps<TDatum extends Record<string, any> = Recor
     enableHover?: boolean;
     showGrid?: boolean;
     showLegend?: boolean;
+    legendInteraction?: LegendInteractionMode;
+    legendPosition?: "right" | "left" | "top" | "bottom";
     tooltip?: TooltipProp;
     annotations?: Record<string, any>[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
-export declare function GroupedBarChart<TDatum extends Record<string, any> = Record<string, any>>(props: GroupedBarChartProps<TDatum>): React.JSX.Element;
-export declare namespace GroupedBarChart {
-    var displayName: string;
-}
+export declare const GroupedBarChart: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: GroupedBarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{charts → components/charts}/ordinal/Histogram.d.ts

@@ -1,9 +1,11 @@
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 export interface HistogramProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
-    data: TDatum[];
+    data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
     bins?: number;
@@ -17,11 +19,12 @@ export interface HistogramProps<TDatum extends Record<string, any> = Record<stri
     enableHover?: boolean;
     showGrid?: boolean;
     showLegend?: boolean;
+    legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
     annotations?: Record<string, any>[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
-export declare function Histogram<TDatum extends Record<string, any> = Record<string, any>>(props: HistogramProps<TDatum>): React.JSX.Element;
-export declare namespace Histogram {
-    var displayName: string;
-}
+export declare const Histogram: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: HistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{charts → components/charts}/ordinal/PieChart.d.ts

@@ -1,9 +1,11 @@
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
+import type { RealtimeFrameHandle } from "../../realtime/types";
 export interface PieChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
-    data: TDatum[];
+    data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
     colorBy?: ChartAccessor<TDatum, string>;
@@ -12,11 +14,13 @@ export interface PieChartProps<TDatum extends Record<string, any> = Record<strin
     slicePadding?: number;
     enableHover?: boolean;
     showLegend?: boolean;
+    legendInteraction?: LegendInteractionMode;
+    legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
     annotations?: Record<string, any>[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
-export declare function PieChart<TDatum extends Record<string, any> = Record<string, any>>(props: PieChartProps<TDatum>): React.JSX.Element;
-export declare namespace PieChart {
-    var displayName: string;
-}
+export declare const PieChart: {
+    <TDatum extends Record<string, any> = Record<string, any>>(props: PieChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

package/dist/{charts → components/charts}/ordinal/RidgelinePlot.d.ts

@@ -1,5 +1,6 @@
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 export interface RidgelinePlotProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
@@ -19,6 +20,7 @@ export interface RidgelinePlotProps<TDatum extends Record<string, any> = Record<
     enableHover?: boolean;
     showGrid?: boolean;
     showLegend?: boolean;
+    legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
     annotations?: Record<string, any>[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;