semiotic 3.3.1 → 3.4.1

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

@@ -1,10 +1,11 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamGeoFrameProps, ProjectionProp } from "../../stream/geoTypes";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { LegendPosition } from "../shared/hooks";
 import type { RealtimeFrameHandle } from "../../realtime/types";
-export interface DistanceCartogramProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface DistanceCartogramProps<TDatum extends Datum = Datum> extends BaseChartProps {
     /** Point data with geographic coordinates */
     points?: TDatum[];
     /** Route/edge data with source/target fields */
@@ -23,7 +24,7 @@ export interface DistanceCartogramProps<TDatum extends Record<string, any> = Rec
     /** ID of the center point */
     center: string;
     /** Cost/distance accessor — numeric field or function */
-    costAccessor: string | ((d: any) => number);
+    costAccessor: string | ((d: Datum) => number);
     /** Interpolation between geographic (0) and cartogram (1) @default 1 */
     strength?: number;
     /** Line rendering mode @default "straight" */
@@ -80,11 +81,11 @@ export interface DistanceCartogramProps<TDatum extends Record<string, any> = Rec
     /** Label for cost units shown on rings (e.g. "hrs", "km") */
     costLabel?: string;
     /** Annotations */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Passthrough */
     frameProps?: Partial<Omit<StreamGeoFrameProps, "projection">>;
 }
 export declare const DistanceCartogram: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: DistanceCartogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: DistanceCartogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -1,11 +1,11 @@
-import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
 import type { StreamGeoFrameProps, ProjectionProp } from "../../stream/geoTypes";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
 import type { Style } from "../../stream/types";
 import type { GeoParticleStyle } from "../../stream/GeoParticlePool";
 import { type AreasProp } from "../../geo/useReferenceAreas";
-export interface FlowMapProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface FlowMapProps<TDatum extends Datum = Datum> extends BaseChartProps {
     /** Flow edges with source/target/value */
     flows?: {
         source: string;
@@ -73,11 +73,11 @@ export interface FlowMapProps<TDatum extends Record<string, any> = Record<string
     /** Max cached tiles @default 256 */
     tileCacheSize?: number;
     /** Annotations */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Passthrough */
     frameProps?: Partial<Omit<StreamGeoFrameProps, "projection">>;
 }
-export declare function FlowMap<TDatum extends Record<string, any> = Record<string, any>>(props: FlowMapProps<TDatum>): React.JSX.Element;
+export declare function FlowMap<TDatum extends Datum = Datum>(props: FlowMapProps<TDatum>): import("react/jsx-runtime").JSX.Element;
 export declare namespace FlowMap {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamGeoFrameProps, ProjectionProp } from "../../stream/geoTypes";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -6,7 +7,7 @@ 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 {
+export interface ProportionalSymbolMapProps<TDatum extends Datum = Datum> extends BaseChartProps {
     /** Point data with geographic coordinates */
     points?: TDatum[];
     /** Longitude accessor @default "lon" */
@@ -57,11 +58,11 @@ export interface ProportionalSymbolMapProps<TDatum extends Record<string, any> =
     /** Max cached tiles @default 256 */
     tileCacheSize?: number;
     /** Annotations */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** 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;
+    <TDatum extends Datum = Datum>(props: ProportionalSymbolMapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -28,12 +28,14 @@ export { QuadrantChart } from "./xy/QuadrantChart";
 export type { QuadrantChartProps, QuadrantsConfig, QuadrantConfig, CenterlineStyle } from "./xy/QuadrantChart";
 export { MultiAxisLineChart } from "./xy/MultiAxisLineChart";
 export type { MultiAxisLineChartProps, MultiAxisSeriesConfig } from "./xy/MultiAxisLineChart";
+export { CandlestickChart } from "./xy/CandlestickChart";
+export type { CandlestickChartProps } from "./xy/CandlestickChart";
 export { BarChart } from "./ordinal/BarChart";
 export type { BarChartProps } from "./ordinal/BarChart";
 export { StackedBarChart } from "./ordinal/StackedBarChart";
 export type { StackedBarChartProps } from "./ordinal/StackedBarChart";
 export { LikertChart } from "./ordinal/LikertChart";
-export type { LikertChartProps } from "./ordinal/LikertChart";
+export type { LikertChartProps, LikertChartHandle } from "./ordinal/LikertChart";
 export { SwarmPlot } from "./ordinal/SwarmPlot";
 export type { SwarmPlotProps } from "./ordinal/SwarmPlot";
 export { BoxPlot } from "./ordinal/BoxPlot";

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -7,7 +8,7 @@ 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 {
+export interface ChordDiagramProps<TNode extends Datum = Datum, TEdge extends Datum = Datum> extends BaseChartProps {
     nodes?: TNode[];
     edges?: TEdge[];
     sourceAccessor?: ChartAccessor<TEdge, string>;
@@ -16,7 +17,7 @@ export interface ChordDiagramProps<TNode extends Record<string, any> = Record<st
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string>;
     colorScheme?: string | string[];
-    edgeColorBy?: "source" | "target" | ((d: any) => string);
+    edgeColorBy?: "source" | "target" | ((d: Datum) => string);
     padAngle?: number;
     groupWidth?: number;
     sortGroups?: (a: any, b: any) => number;
@@ -34,6 +35,6 @@ export interface ChordDiagramProps<TNode extends Record<string, any> = Record<st
  * Wraps StreamNetworkFrame (canvas-first) for chord relationship visualization.
  */
 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;
+    <TNode extends Datum = Datum, TEdge extends Datum = Datum>(props: ChordDiagramProps<TNode, TEdge> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -1,4 +1,4 @@
-import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -6,7 +6,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * CirclePack component props
  */
-export interface CirclePackProps<TNode extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface CirclePackProps<TNode extends Datum = Datum> extends BaseChartProps {
     data: TNode;
     childrenAccessor?: ChartAccessor<TNode, TNode[]>;
     valueAccessor?: ChartAccessor<TNode, number>;
@@ -28,7 +28,7 @@ export interface CirclePackProps<TNode extends Record<string, any> = Record<stri
  *
  * Wraps StreamNetworkFrame (canvas-first) for circle-pack visualization.
  */
-export declare function CirclePack<TNode extends Record<string, any> = Record<string, any>>(props: CirclePackProps<TNode>): React.JSX.Element;
+export declare function CirclePack<TNode extends Datum = Datum>(props: CirclePackProps<TNode>): import("react/jsx-runtime").JSX.Element;
 export declare namespace CirclePack {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -7,7 +8,7 @@ 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 {
+export interface ForceDirectedGraphProps<TNode extends Datum = Datum, TEdge extends Datum = Datum> extends BaseChartProps {
     nodes?: TNode[];
     edges?: TEdge[];
     nodeIDAccessor?: ChartAccessor<TNode, string>;
@@ -37,6 +38,6 @@ export interface ForceDirectedGraphProps<TNode extends Record<string, any> = Rec
  * Wraps StreamNetworkFrame (canvas-first) for force-directed network visualization.
  */
 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;
+    <TNode extends Datum = Datum, TEdge extends Datum = Datum>(props: ForceDirectedGraphProps<TNode, TEdge> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
 import type { BaseChartProps } from "../shared/types";
@@ -14,15 +15,15 @@ export interface OrbitNode {
     id?: string;
 }
 type OrbitMode = "flat" | "solar" | "atomic" | number[];
-export interface OrbitDiagramProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface OrbitDiagramProps<TDatum extends Datum = Datum> 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);
+    nodeIdAccessor?: string | ((d: Datum) => string);
     /** Field or function for node color */
-    colorBy?: string | ((d: any) => string);
+    colorBy?: string | ((d: Datum) => string);
     /** Color scheme @default "category10" */
     colorScheme?: string | string[];
     /** Color by hierarchy depth instead of field @default false */
@@ -66,13 +67,13 @@ export interface OrbitDiagramProps<TDatum extends Record<string, any> = Record<s
     /** Enable hover @default true */
     enableHover?: boolean;
     /** Annotation objects */
-    annotations?: Array<Record<string, any>>;
+    annotations?: Array<Datum>;
     /** 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 function OrbitDiagram<TDatum extends Datum = Datum>(props: OrbitDiagramProps<TDatum>): import("react/jsx-runtime").JSX.Element;
 export declare namespace OrbitDiagram {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -7,7 +8,7 @@ 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 {
+export interface SankeyDiagramProps<TNode extends Datum = Datum, TEdge extends Datum = Datum> extends BaseChartProps {
     nodes?: TNode[];
     edges?: TEdge[];
     sourceAccessor?: ChartAccessor<TEdge, string>;
@@ -16,7 +17,7 @@ export interface SankeyDiagramProps<TNode extends Record<string, any> = Record<s
     nodeIdAccessor?: ChartAccessor<TNode, string>;
     colorBy?: ChartAccessor<TNode, string>;
     colorScheme?: string | string[];
-    edgeColorBy?: "source" | "target" | "gradient" | ((d: any) => string);
+    edgeColorBy?: "source" | "target" | "gradient" | ((d: Datum) => string);
     orientation?: "horizontal" | "vertical";
     nodeAlign?: "justify" | "left" | "right" | "center";
     nodePaddingRatio?: number;
@@ -36,6 +37,6 @@ export interface SankeyDiagramProps<TNode extends Record<string, any> = Record<s
  * Wraps StreamNetworkFrame (canvas-first) for Sankey flow visualization.
  */
 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;
+    <TNode extends Datum = Datum, TEdge extends Datum = Datum>(props: SankeyDiagramProps<TNode, TEdge> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -1,4 +1,4 @@
-import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -6,7 +6,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * TreeDiagram component props
  */
-export interface TreeDiagramProps<TNode extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface TreeDiagramProps<TNode extends Datum = Datum> extends BaseChartProps {
     data: TNode;
     layout?: "tree" | "cluster" | "partition" | "treemap" | "circlepack";
     orientation?: "vertical" | "horizontal" | "radial";
@@ -30,7 +30,7 @@ export interface TreeDiagramProps<TNode extends Record<string, any> = Record<str
  *
  * Wraps StreamNetworkFrame (canvas-first) for hierarchical tree visualization.
  */
-export declare function TreeDiagram<TNode extends Record<string, any> = Record<string, any>>(props: TreeDiagramProps<TNode>): React.JSX.Element;
+export declare function TreeDiagram<TNode extends Datum = Datum>(props: TreeDiagramProps<TNode>): import("react/jsx-runtime").JSX.Element;
 export declare namespace TreeDiagram {
     var displayName: string;
 }

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

@@ -1,4 +1,4 @@
-import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
 import type { StreamNetworkFrameProps } from "../../stream/networkTypes";
 import type { BaseChartProps, ChartAccessor } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -6,7 +6,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * Treemap component props
  */
-export interface TreemapProps<TNode extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface TreemapProps<TNode extends Datum = Datum> extends BaseChartProps {
     data: TNode;
     childrenAccessor?: ChartAccessor<TNode, TNode[]>;
     valueAccessor?: ChartAccessor<TNode, number>;
@@ -29,7 +29,7 @@ export interface TreemapProps<TNode extends Record<string, any> = Record<string,
  *
  * Wraps StreamNetworkFrame (canvas-first) for treemap visualization.
  */
-export declare function Treemap<TNode extends Record<string, any> = Record<string, any>>(props: TreemapProps<TNode>): React.JSX.Element;
+export declare function Treemap<TNode extends Datum = Datum>(props: TreemapProps<TNode>): import("react/jsx-runtime").JSX.Element;
 export declare namespace Treemap {
     var displayName: string;
 }

package/dist/components/charts/ordinal/BarChart.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { LegendInteractionMode } from "../shared/hooks";
@@ -7,7 +8,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 /**
  * BarChart component props
  */
-export interface BarChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface BarChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -17,10 +18,35 @@ export interface BarChartProps<TDatum extends Record<string, any> = Record<strin
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
     colorScheme?: string | string[];
-    sort?: boolean | "asc" | "desc" | ((a: Record<string, any>, b: Record<string, any>) => number);
+    /** Category ordering. `false` (default) = insertion order. `"asc"` /
+     *  `"desc"` sorts by total value. `"auto"` preserves insertion order
+     *  while streaming and falls through to value-desc on static data.
+     *  `true` = value-desc regardless of source. Custom comparator functions
+     *  receive category name strings (not row objects) and run against
+     *  the category list on the axis. */
+    sort?: boolean | "asc" | "desc" | "auto" | ((a: string, b: string) => number);
     barPadding?: number;
     /** Rounded top corner radius in pixels. Only the end away from the baseline is rounded. */
     roundedTop?: number;
+    /**
+     * Gradient fill from the bar's tip (opposite the baseline) toward its base.
+     * - `true` — default opacity fade (80% → 5% of the resolved fill color).
+     * - `{ topOpacity, bottomOpacity }` — explicit opacity stops on the resolved fill.
+     * - `{ colorStops: [{offset, color}, ...] }` — arbitrary multi-color gradient.
+     *
+     * Direction follows the bar's orientation (vertical/horizontal) and sign
+     * (positive/negative bars). Same API as `AreaChart.gradientFill`.
+     * @default false
+     */
+    gradientFill?: boolean | {
+        topOpacity: number;
+        bottomOpacity: number;
+    } | {
+        colorStops: Array<{
+            offset: number;
+            color: string;
+        }>;
+    };
     /** When true, adds padding below the 0 baseline. Default false (bars flush with axis). */
     baselinePadding?: boolean;
     enableHover?: boolean;
@@ -30,7 +56,7 @@ export interface BarChartProps<TDatum extends Record<string, any> = Record<strin
     legendInteraction?: LegendInteractionMode;
     legendPosition?: "right" | "left" | "top" | "bottom";
     tooltip?: TooltipProp;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
@@ -39,6 +65,6 @@ export interface BarChartProps<TDatum extends Record<string, any> = Record<strin
  * BarChart - Visualize categorical data with bars.
  */
 export declare const BarChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: BarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: BarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/BoxPlot.d.ts

@@ -1,10 +1,11 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor, CategoryFormatFn } 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 {
+export interface BoxPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -24,12 +25,12 @@ export interface BoxPlotProps<TDatum extends Record<string, any> = Record<string
     legendInteraction?: LegendInteractionMode;
     legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export declare const BoxPlot: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: BoxPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: BoxPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/DonutChart.d.ts

@@ -1,10 +1,11 @@
+import type { Datum } from "../shared/datumTypes";
 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 {
+export interface DonutChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -21,10 +22,10 @@ export interface DonutChartProps<TDatum extends Record<string, any> = Record<str
     legendInteraction?: LegendInteractionMode;
     legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export declare const DonutChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: DonutChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: DonutChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/DotPlot.d.ts

@@ -1,10 +1,11 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor, CategoryFormatFn } 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 {
+export interface DotPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -14,7 +15,15 @@ export interface DotPlotProps<TDatum extends Record<string, any> = Record<string
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
     colorScheme?: string | string[];
-    sort?: boolean | "asc" | "desc" | ((a: Record<string, any>, b: Record<string, any>) => number);
+    /** Category ordering. Default (`undefined`) resolves to `"auto"`, which
+     *  preserves insertion order while streaming and falls through to
+     *  value-desc on static data — the recommended choice when using the
+     *  push API so categories don't jump around as values fluctuate.
+     *  `true` forces value-desc regardless of source. `"asc"` / `"desc"`
+     *  sorts by total value. `false` for insertion order regardless of
+     *  source. Function comparators receive category name strings (not
+     *  row objects) and run against the category list on the axis. */
+    sort?: boolean | "asc" | "desc" | "auto" | ((a: string, b: string) => number);
     dotRadius?: number;
     categoryPadding?: number;
     enableHover?: boolean;
@@ -24,12 +33,12 @@ export interface DotPlotProps<TDatum extends Record<string, any> = Record<string
     legendInteraction?: LegendInteractionMode;
     legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export declare const DotPlot: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: DotPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: DotPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/FunnelChart.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { LegendInteractionMode } from "../shared/hooks";
@@ -7,7 +8,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
 /**
  * FunnelChart component props
  */
-export interface FunnelChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface FunnelChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     /** Accessor for funnel step names (e.g., "Awareness", "Interest", "Purchase") */
     stepAccessor?: ChartAccessor<TDatum, string>;
@@ -36,7 +37,7 @@ export interface FunnelChartProps<TDatum extends Record<string, any> = Record<st
     legendInteraction?: LegendInteractionMode;
     legendPosition?: "right" | "left" | "top" | "bottom";
     tooltip?: TooltipProp;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
@@ -52,6 +53,6 @@ export interface FunnelChartProps<TDatum extends Record<string, any> = Record<st
  * previous step (hatched). Multi-category renders grouped bars.
  */
 export declare const FunnelChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: FunnelChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: FunnelChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/GaugeChart.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { BaseChartProps } from "../shared/types";
@@ -43,7 +44,7 @@ export interface GaugeChartProps extends BaseChartProps {
     /** Enable tooltip on arc segments */
     tooltip?: TooltipProp;
     /** Annotations — supports threshold markers via standard annotation system */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Enable hover interaction (default true) */
     enableHover?: boolean;
     /** frameProps escape hatch */

package/dist/components/charts/ordinal/GroupedBarChart.d.ts

@@ -1,10 +1,11 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor, CategoryFormatFn } 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 {
+export interface GroupedBarChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     groupBy: ChartAccessor<TDatum, string>;
@@ -15,8 +16,8 @@ export interface GroupedBarChartProps<TDatum extends Record<string, any> = Recor
     valueFormat?: (d: number | string) => string;
     colorBy?: ChartAccessor<TDatum, string>;
     colorScheme?: string | string[];
-    /** Category sort order. Default: false (data insertion order). "asc"/"desc" sorts by total grouped value. Custom comparators receive category keys. */
-    sort?: boolean | "asc" | "desc" | ((a: string, b: string) => number);
+    /** Category sort order. Default: `false` (data insertion order). `"asc"`/`"desc"` sorts by total grouped value. `"auto"` preserves insertion order while streaming and falls through to value-desc on static data. Custom comparators receive category keys. */
+    sort?: boolean | "asc" | "desc" | "auto" | ((a: string, b: string) => number);
     barPadding?: number;
     /** Rounded corner radius on bar ends (away from baseline). */
     roundedTop?: number;
@@ -28,12 +29,12 @@ export interface GroupedBarChartProps<TDatum extends Record<string, any> = Recor
     legendInteraction?: LegendInteractionMode;
     legendPosition?: "right" | "left" | "top" | "bottom";
     tooltip?: TooltipProp;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Custom formatter for category tick labels */
     categoryFormat?: CategoryFormatFn;
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export declare const GroupedBarChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: GroupedBarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: GroupedBarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/Histogram.d.ts

@@ -1,10 +1,11 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor, CategoryFormatFn } 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 {
+export interface HistogramProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -23,7 +24,7 @@ export interface HistogramProps<TDatum extends Record<string, any> = Record<stri
     legendInteraction?: LegendInteractionMode;
     legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Enable brush on the value axis */
     brush?: boolean;
     /** Callback when brush selection changes */
@@ -40,6 +41,6 @@ export interface HistogramProps<TDatum extends Record<string, any> = Record<stri
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export declare const Histogram: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: HistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: HistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };