semiotic 3.4.0 → 3.4.1

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>;
@@ -20,13 +21,32 @@ export interface BarChartProps<TDatum extends Record<string, any> = Record<strin
     /** 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. Function comparators
+     *  `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;
@@ -36,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">>;
@@ -45,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>;
@@ -32,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>;
@@ -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;
 };

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle } from "../../stream/ordinalTypes";
 import type { LegendInteractionMode } from "../shared/hooks";
@@ -35,7 +36,7 @@ import type { RealtimeFrameHandle } from "../../realtime/types";
  * doesn't follow this low-to-high convention, the chart will misrepresent
  * the polarity.
  */
-export interface LikertChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface LikertChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     /** Question / item accessor — the ordinal axis. */
     categoryAccessor?: ChartAccessor<TDatum, string>;
@@ -83,7 +84,7 @@ export interface LikertChartProps<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">>;
@@ -92,6 +93,6 @@ export interface LikertChartHandle extends RealtimeFrameHandle {
     getScales(): ReturnType<NonNullable<StreamOrdinalFrameHandle["getScales"]>>;
 }
 export declare const LikertChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: LikertChartProps<TDatum> & React.RefAttributes<LikertChartHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: LikertChartProps<TDatum> & React.RefAttributes<LikertChartHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/PieChart.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 PieChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface PieChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -19,10 +20,10 @@ export interface PieChartProps<TDatum extends Record<string, any> = Record<strin
     legendInteraction?: LegendInteractionMode;
     legendPosition?: LegendPosition;
     tooltip?: TooltipProp;
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export declare const PieChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: PieChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: PieChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/RidgelinePlot.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 RidgelinePlotProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface RidgelinePlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -25,7 +26,7 @@ export interface RidgelinePlotProps<TDatum extends Record<string, any> = Record<
     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">>;
@@ -37,6 +38,6 @@ export interface RidgelinePlotProps<TDatum extends Record<string, any> = Record<
  * baseline. The amplitude prop controls overlap between rows.
  */
 export declare const RidgelinePlot: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: RidgelinePlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: RidgelinePlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/StackedBarChart.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 StackedBarChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface StackedBarChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     stackBy: ChartAccessor<TDatum, string>;
@@ -29,12 +30,12 @@ export interface StackedBarChartProps<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 StackedBarChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: StackedBarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: StackedBarChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/SwarmPlot.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 SwarmPlotProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface SwarmPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -26,7 +27,7 @@ export interface SwarmPlotProps<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 */
@@ -43,6 +44,6 @@ export interface SwarmPlotProps<TDatum extends Record<string, any> = Record<stri
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export declare const SwarmPlot: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: SwarmPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: SwarmPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/SwimlaneChart.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 SwimlaneChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface SwimlaneChartProps<TDatum extends Datum = Datum> extends BaseChartProps {
     /** Data array. Omit for push API mode. */
     data?: TDatum[];
     /** Accessor for lane categories (swim lanes). Default "category". */
@@ -42,7 +43,7 @@ export interface SwimlaneChartProps<TDatum extends Record<string, any> = Record<
     /** Tooltip configuration */
     tooltip?: TooltipProp;
     /** Annotation objects */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Enable brush on the value axis */
     brush?: boolean;
     /** Callback when brush selection changes */
@@ -64,6 +65,6 @@ export interface SwimlaneChartProps<TDatum extends Record<string, any> = Record<
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export declare const SwimlaneChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: SwimlaneChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: SwimlaneChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/ordinal/ViolinPlot.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 ViolinPlotProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface ViolinPlotProps<TDatum extends Datum = Datum> extends BaseChartProps {
     data?: TDatum[];
     categoryAccessor?: ChartAccessor<TDatum, string>;
     valueAccessor?: ChartAccessor<TDatum, number>;
@@ -25,7 +26,7 @@ export interface ViolinPlotProps<TDatum extends Record<string, any> = Record<str
     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 */
@@ -42,6 +43,6 @@ export interface ViolinPlotProps<TDatum extends Record<string, any> = Record<str
     frameProps?: Partial<Omit<StreamOrdinalFrameProps, "data" | "size">>;
 }
 export declare const ViolinPlot: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: ViolinPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: ViolinPlotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/realtime/RealtimeHeatmap.d.ts

@@ -5,7 +5,8 @@ import type { ReactNode } from "react";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { ChartMode, ChartAccessor, SelectionConfig } from "../shared/types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
-export interface RealtimeHeatmapProps<TDatum extends Record<string, any> = Record<string, any>> {
+import type { Datum } from "../shared/datumTypes";
+export interface RealtimeHeatmapProps<TDatum extends Datum = Datum> {
     /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
     mode?: ChartMode;
     /** Chart dimensions as [width, height] */
@@ -32,7 +33,7 @@ export interface RealtimeHeatmapProps<TDatum extends Record<string, any> = Recor
     /** Ring buffer capacity */
     windowSize?: number;
     /** Controlled data array */
-    data?: Record<string, any>[];
+    data?: Datum[];
     /** Time/x value accessor */
     timeAccessor?: ChartAccessor<TDatum, number>;
     /** Value/y accessor */
@@ -62,9 +63,9 @@ export interface RealtimeHeatmapProps<TDatum extends Record<string, any> = Recor
     /** Callback on hover */
     onHover?: (d: HoverData | null) => void;
     /** Annotation objects */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** SVG annotation render function */
-    svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
+    svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
     /** Custom formatter for time axis ticks */
     tickFormatTime?: (value: number) => string;
     /** Custom formatter for value axis ticks */
@@ -97,7 +98,7 @@ export interface RealtimeHeatmapProps<TDatum extends Record<string, any> = Recor
     /** Legend interaction mode */
     legendInteraction?: LegendInteractionMode;
     /** ID accessor for remove()/update() on the push API */
-    pointIdAccessor?: string | ((d: any) => string);
+    pointIdAccessor?: string | ((d: Datum) => string);
 }
 /**
  * RealtimeHeatmap - Streaming heatmap with 2D grid binning.
@@ -121,6 +122,6 @@ export interface RealtimeHeatmapProps<TDatum extends Record<string, any> = Recor
  * ```
  */
 export declare const RealtimeHeatmap: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: RealtimeHeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: RealtimeHeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/realtime/RealtimeHistogram.d.ts

@@ -5,7 +5,8 @@ import type { ReactNode } from "react";
 import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 import type { ChartMode, ChartAccessor, SelectionConfig } from "../shared/types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
-export interface RealtimeTemporalHistogramProps<TDatum extends Record<string, any> = Record<string, any>> {
+import type { Datum } from "../shared/datumTypes";
+export interface RealtimeTemporalHistogramProps<TDatum extends Datum = Datum> {
     /** Display mode: "primary" (full chrome), "context" (compact), "sparkline" (inline) */
     mode?: ChartMode;
     /** Time interval for binning */
@@ -34,7 +35,7 @@ export interface RealtimeTemporalHistogramProps<TDatum extends Record<string, an
     /** Ring buffer capacity */
     windowSize?: number;
     /** Controlled data array */
-    data?: Record<string, any>[];
+    data?: Datum[];
     /** Time value accessor */
     timeAccessor?: ChartAccessor<TDatum, number>;
     /** Value accessor */
@@ -61,6 +62,8 @@ export interface RealtimeTemporalHistogramProps<TDatum extends Record<string, an
     stroke?: string;
     /** Bar stroke width */
     strokeWidth?: number;
+    /** Uniform bar opacity (0–1). Pairs with `color` / `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
+    opacity?: number;
     /** Gap between bars in pixels */
     gap?: number;
     /** Show canvas-drawn axes */
@@ -74,9 +77,9 @@ export interface RealtimeTemporalHistogramProps<TDatum extends Record<string, an
     /** Callback on hover */
     onHover?: (d: HoverData | null) => void;
     /** Annotation objects */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** SVG annotation render function */
-    svgAnnotationRules?: (annotation: Record<string, any>, index: number, context: AnnotationContext) => ReactNode;
+    svgAnnotationRules?: (annotation: Datum, index: number, context: AnnotationContext) => ReactNode;
     /** Custom formatter for time axis ticks */
     tickFormatTime?: (value: number) => string;
     /** Custom formatter for value axis ticks */
@@ -131,7 +134,7 @@ export interface RealtimeTemporalHistogramProps<TDatum extends Record<string, an
     /** Legend interaction mode */
     legendInteraction?: LegendInteractionMode;
     /** ID accessor for remove()/update() on the push API */
-    pointIdAccessor?: string | ((d: any) => string);
+    pointIdAccessor?: string | ((d: Datum) => string);
 }
 /**
  * RealtimeTemporalHistogram - Streaming temporal histogram.
@@ -164,12 +167,12 @@ export interface RealtimeTemporalHistogramProps<TDatum extends Record<string, an
  * ```
  */
 export declare const RealtimeTemporalHistogram: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: RealtimeTemporalHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: RealtimeTemporalHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };
 /** @deprecated Use RealtimeTemporalHistogram instead */
 export declare const RealtimeHistogram: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: RealtimeTemporalHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: RealtimeTemporalHistogramProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };
 /** @deprecated Use RealtimeTemporalHistogramProps instead */