semiotic 3.3.1 → 3.4.1

package/dist/components/charts/shared/useLikertAggregation.d.ts

@@ -1,5 +1,6 @@
 import type { RefObject, MutableRefObject } from "react";
 import type { StreamOrdinalFrameHandle } from "../../stream/ordinalTypes";
+import type { Datum } from "./datumTypes";
 export interface AggregatedRow {
     __likertCategory: string;
     /** Stacking key — may be sentinel value for neutral halves */
@@ -13,22 +14,32 @@ export interface AggregatedRow {
 /** Sentinel level names for the neutral split halves */
 export declare const NEUTRAL_NEG = "__likert_neutral_neg";
 export declare const NEUTRAL_POS = "__likert_neutral_pos";
-export declare function resolveAccessorFn<T>(accessor: string | ((d: any) => T) | undefined, fallback: string): (d: any) => T;
+export declare function resolveAccessorFn<T>(accessor: string | ((d: Datum) => T) | undefined, fallback: string): (d: Datum) => T;
 /**
  * Generate a diverging color scheme for N levels.
+ *
+ * Two paths:
+ *   • `themeDivergingSchemeName` supplied → sample the named d3-scale-chromatic
+ *     diverging interpolator at N evenly-spaced positions. Gives consumers the
+ *     ability to change the palette by changing the active theme's
+ *     `colors.diverging` string, without touching chart code.
+ *   • No scheme name → the original Carbon-inspired hardcoded palette
+ *     (preserves exact pre-theming behavior for consumers without a
+ *     ThemeProvider, and for custom themes that don't declare `diverging`).
+ *
  * Interpolates from red → gray → blue for odd, red → blue for even.
  */
-export declare function defaultDivergingScheme(n: number): string[];
-export declare function aggregateData(data: any[], levels: string[], getCat: (d: any) => string, getScore: ((d: any) => number) | null, getLevel: ((d: any) => string) | null, getCount: ((d: any) => number) | null): AggregatedRow[];
+export declare function defaultDivergingScheme(n: number, themeDivergingSchemeName?: string): string[];
+export declare function aggregateData(data: any[], levels: string[], getCat: (d: Datum) => string, getScore: ((d: Datum) => number) | null, getLevel: ((d: Datum) => string) | null, getCount: ((d: Datum) => number) | null): AggregatedRow[];
 export declare function toDivergingValues(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
 export declare function orderForDiverging(rows: AggregatedRow[], levels: string[]): AggregatedRow[];
 interface UseLikertAggregationConfig {
     data: any[] | undefined;
     levels: string[];
-    categoryAccessor?: string | ((d: any) => string);
-    valueAccessor?: string | ((d: any) => number);
-    levelAccessor?: string | ((d: any) => string);
-    countAccessor?: string | ((d: any) => number);
+    categoryAccessor?: string | ((d: Datum) => string);
+    valueAccessor?: string | ((d: Datum) => number);
+    levelAccessor?: string | ((d: Datum) => string);
+    countAccessor?: string | ((d: Datum) => number);
     isDiverging: boolean;
     frameRef: RefObject<StreamOrdinalFrameHandle | null>;
 }

package/dist/components/charts/shared/useOrdinalStreaming.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "./datumTypes";
 import type { Ref, RefObject } from "react";
 import type { StreamOrdinalFrameHandle } from "../../stream/ordinalTypes";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -20,7 +21,7 @@ interface UseOrdinalStreamingConfig {
     legendPosition?: LegendPosition;
     /** Results from useChartSetup — needed for legend/margin merge */
     setup: {
-        legendBehaviorProps: Record<string, any>;
+        legendBehaviorProps: Datum;
         legendPosition: LegendPosition;
         margin: {
             top: number;
@@ -32,7 +33,7 @@ interface UseOrdinalStreamingConfig {
 }
 interface UseOrdinalStreamingResult {
     /** Legend props merged with streaming legend (spread into streamProps) */
-    effectiveLegendProps: Record<string, any>;
+    effectiveLegendProps: Datum;
     /** Margin merged with streaming legend margin adjustments */
     effectiveMargin: {
         top: number;

package/dist/components/charts/shared/useResolvedSelection.d.ts

@@ -0,0 +1,2 @@
+import type { SelectionConfig } from "./types";
+export declare function useResolvedSelection(selection: SelectionConfig | undefined): SelectionConfig | undefined;

package/dist/components/charts/shared/useStreamingLegend.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "./datumTypes";
 import type { Accessor } from "./types";
 import type { LegendPosition } from "./hooks";
 /**
@@ -27,7 +28,7 @@ export declare function useStreamingLegend({ isPushMode, colorBy, colorScheme, s
     /** Legend position */
     legendPosition?: LegendPosition;
 }): {
-    wrapPush: (originalPush: (d: any) => void) => (datum: any) => void;
+    wrapPush: (originalPush: (d: Datum) => void) => (datum: Datum) => void;
     wrapPushMany: (originalPushMany: (d: any[]) => void) => (data: any[]) => void;
     resetCategories: () => void;
     streamingLegend: {

package/dist/components/charts/shared/validateChartData.d.ts

@@ -1,3 +1,4 @@
+import type { Datum } from "./datumTypes";
 /**
  * Validates chart data and accessors at render time.
  * Returns null if data is valid, or an error message string if not.
@@ -13,7 +14,7 @@ interface ArrayDataValidation {
     componentName: string;
     data: any[] | undefined | null;
     accessors?: Record<string, AccessorLike | undefined>;
-    requiredProps?: Record<string, any>;
+    requiredProps?: Datum;
 }
 interface ObjectDataValidation {
     componentName: string;

package/dist/components/charts/shared/validateProps.d.ts

@@ -1,10 +1,4 @@
-/**
- * Static props validation for AI code-generation pipelines.
- *
- * Validates component name, required props, prop types, enum values,
- * unknown props (typo detection), and data shape via the existing
- * validateArrayData / validateObjectData / validateNetworkData helpers.
- */
+import type { Datum } from "./datumTypes";
 import { VALIDATION_MAP } from "./validationMap";
 export { VALIDATION_MAP };
 export interface ValidationResult {
@@ -33,4 +27,4 @@ export interface ComponentSpec {
  * Checks: component name, required props, prop types, enum values,
  * unknown prop names (typo detection), and data shape + accessor validity.
  */
-export declare function validateProps(componentName: string, props: Record<string, any>): ValidationResult;
+export declare function validateProps(componentName: string, props: Datum): ValidationResult;

package/dist/components/charts/shared/withChartWrapper.d.ts

@@ -11,7 +11,7 @@ interface SafeRenderProps {
  * If the chart throws during render, runs diagnoseConfig to produce
  * actionable fix suggestions alongside the error message.
  */
-export declare function SafeRender({ componentName, width, height, chartProps, children }: SafeRenderProps): React.JSX.Element;
+export declare function SafeRender({ componentName, width, height, chartProps, children }: SafeRenderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Renders a "No data available" placeholder when data is empty.
  * Returns null when data is present or emptyContent is `false`.

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

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

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps, MarginalGraphicsConfig } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -7,7 +8,7 @@ import { type TooltipProp } from "../../Tooltip/Tooltip";
 /**
  * BubbleChart component props
  */
-export interface BubbleChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps, AxisConfig {
+export interface BubbleChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
     /**
      * Array of data points. Each point should have x, y, and size properties.
      * @example
@@ -108,7 +109,7 @@ export interface BubbleChartProps<TDatum extends Record<string, any> = Record<st
     /**
      * Annotation objects to render on the chart
      */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /**
      * Additional StreamXYFrame props for advanced customization
      * For full control, consider using StreamXYFrame directly
@@ -178,6 +179,6 @@ export interface BubbleChartProps<TDatum extends Record<string, any> = Record<st
  * @returns Rendered bubble chart
  */
 export declare const BubbleChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: BubbleChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: BubbleChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -0,0 +1,47 @@
+import type { Datum } from "../shared/datumTypes";
+import * as React from "react";
+import type { StreamXYFrameProps } from "../../stream/types";
+import type { RealtimeFrameHandle } from "../../realtime/types";
+import type { CandlestickStyle } from "../../stream/types";
+import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
+import { type TooltipProp } from "../../Tooltip/Tooltip";
+export interface CandlestickChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
+    data?: TDatum[];
+    xAccessor?: ChartAccessor<TDatum, number>;
+    /** Required — upper bound (candlestick high, or range top) */
+    highAccessor?: ChartAccessor<TDatum, number>;
+    /** Required — lower bound (candlestick low, or range bottom) */
+    lowAccessor?: ChartAccessor<TDatum, number>;
+    /** Optional — when paired with closeAccessor, renders OHLC candlesticks. Omit both to render a range chart. */
+    openAccessor?: ChartAccessor<TDatum, number>;
+    /** Optional — see openAccessor */
+    closeAccessor?: ChartAccessor<TDatum, number>;
+    candlestickStyle?: CandlestickStyle;
+    tooltip?: TooltipProp;
+    annotations?: Datum[];
+    enableHover?: boolean;
+    showGrid?: boolean;
+    frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
+}
+/**
+ * CandlestickChart — OHLC bars, or a range chart when open/close are omitted.
+ *
+ * Pass all four of `open/high/low/close` for classic candlesticks. Pass only
+ * `high/low` to degrade into a range/dumbbell visualization (PipelineStore
+ * auto-detects this via `candlestickRangeMode`).
+ *
+ * @example
+ * ```tsx
+ * // Full OHLC
+ * <CandlestickChart data={data} xAccessor="date"
+ *   openAccessor="o" highAccessor="h" lowAccessor="l" closeAccessor="c" />
+ *
+ * // Range-only (e.g. min/max over a window)
+ * <CandlestickChart data={data} xAccessor="date"
+ *   highAccessor="max" lowAccessor="min" />
+ * ```
+ */
+export declare const CandlestickChart: {
+    <TDatum extends Datum = Datum>(props: CandlestickChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    displayName?: string;
+};

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -7,7 +8,7 @@ import type { LegendInteractionMode } from "../shared/hooks";
 /**
  * ConnectedScatterplot component props
  */
-export interface ConnectedScatterplotProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps, AxisConfig {
+export interface ConnectedScatterplotProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
     /** Array of data points. Each point needs x and y properties. Omit when using push API. */
     data?: TDatum[];
     /** Field name or function to access x values @default "x" */
@@ -35,7 +36,7 @@ export interface ConnectedScatterplotProps<TDatum extends Record<string, any> =
     /** Legend interaction mode */
     legendInteraction?: LegendInteractionMode;
     /** Annotation objects to render on the chart */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Additional StreamXYFrame props for advanced customization */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
 }
@@ -59,6 +60,6 @@ export interface ConnectedScatterplotProps<TDatum extends Record<string, any> =
  * ```
  */
 export declare const ConnectedScatterplot: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: ConnectedScatterplotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: ConnectedScatterplotProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -7,7 +8,7 @@ import { type TooltipProp } from "../../Tooltip/Tooltip";
 /**
  * Heatmap component props
  */
-export interface HeatmapProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps {
+export interface HeatmapProps<TDatum extends Datum = Datum> extends BaseChartProps {
     /**
      * Array of data points with x, y, and value properties.
      * @example
@@ -46,12 +47,16 @@ export interface HeatmapProps<TDatum extends Record<string, any> = Record<string
     /**
      * Format function for y-axis tick labels
      */
-    yFormat?: (d: any) => string;
+    yFormat?: (d: number | Date | string) => string;
     /**
-     * Color scheme for the heatmap
-     * @default "blues"
+     * Color scheme for the heatmap — any d3-scale-chromatic sequential scheme
+     * name, `"custom"` (paired with `customColorScale`), or any scheme name
+     * emitted by a SemioticTheme's `colors.sequential`. When unset, falls back
+     * to the active theme's sequential scheme, then to `"blues"`.
+     *
+     * @default `theme.colors.sequential` (or `"blues"` when no ThemeProvider)
      */
-    colorScheme?: "blues" | "reds" | "greens" | "viridis" | "custom";
+    colorScheme?: "blues" | "reds" | "greens" | "viridis" | "oranges" | "purples" | "greys" | "plasma" | "inferno" | "magma" | "cividis" | "turbo" | "custom" | (string & {});
     /**
      * Custom color scale (used when colorScheme is "custom")
      * @example
@@ -108,7 +113,7 @@ export interface HeatmapProps<TDatum extends Record<string, any> = Record<string
     /**
      * Annotation objects to render on the chart
      */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /**
      * Additional StreamXYFrame props for advanced customization
      * For full control, consider using StreamXYFrame directly
@@ -174,6 +179,6 @@ export interface HeatmapProps<TDatum extends Record<string, any> = Record<string
  * @returns Rendered heatmap
  */
 export declare const Heatmap: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: HeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: HeatmapProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -8,7 +9,7 @@ import type { AnomalyConfig, ForecastConfig } from "../shared/statisticalOverlay
 /**
  * LineChart component props
  */
-export interface LineChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps, AxisConfig {
+export interface LineChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
     /**
      * Array of data points or array of line objects with coordinates.
      * @example
@@ -150,7 +151,7 @@ export interface LineChartProps<TDatum extends Record<string, any> = Record<stri
     /**
      * Annotation objects to render on the chart
      */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /**
      * Place category labels directly at line endpoints instead of using a separate legend.
      * When true, auto-hides the legend (override with `showLegend: true`).
@@ -262,6 +263,6 @@ export interface LineChartProps<TDatum extends Record<string, any> = Record<stri
  * @returns Rendered line chart
  */
 export declare const LineChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: LineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: LineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -1,4 +1,4 @@
-import * as React from "react";
+import type { Datum } from "../shared/datumTypes";
 import type { StreamXYFrameProps } from "../../stream/types";
 import type { LegendPosition } from "../shared/hooks";
 import type { BaseChartProps, AxisConfig, ChartAccessor } from "../shared/types";
@@ -14,7 +14,7 @@ export interface MinimapConfig {
         left?: number;
     };
     /** Line style override for the minimap */
-    lineStyle?: (d: Record<string, any>) => Record<string, any>;
+    lineStyle?: (d: Datum) => Datum;
     /** Show axes in minimap (default: false) */
     showAxes?: boolean;
     /** Background color for minimap */
@@ -22,7 +22,7 @@ export interface MinimapConfig {
     /** Brush direction: "x" (default) or "y" */
     brushDirection?: "x" | "y";
 }
-export interface MinimapChartProps<TDatum extends Record<string, any> = Record<string, any>> extends Omit<BaseChartProps, "onClick" | "onObservation" | "selection" | "linkedHover">, AxisConfig {
+export interface MinimapChartProps<TDatum extends Datum = Datum> extends Omit<BaseChartProps, "onClick" | "onObservation" | "selection" | "linkedHover">, AxisConfig {
     /** Array of data points or line objects with coordinates */
     data: TDatum[];
     /** X accessor (default: "x") */
@@ -70,7 +70,7 @@ export interface MinimapChartProps<TDatum extends Record<string, any> = Record<s
     /** Additional StreamXYFrame props */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
 }
-export declare function MinimapChart<TDatum extends Record<string, any> = Record<string, any>>(props: MinimapChartProps<TDatum>): React.JSX.Element;
+export declare function MinimapChart<TDatum extends Datum = Datum>(props: MinimapChartProps<TDatum>): import("react/jsx-runtime").JSX.Element;
 export declare namespace MinimapChart {
     var displayName: string;
 }

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

@@ -1,3 +1,4 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
 import type { StreamXYFrameProps, CurveType } from "../../stream/types";
 import type { RealtimeFrameHandle } from "../../realtime/types";
@@ -7,7 +8,7 @@ import type { LegendInteractionMode, LegendPosition } from "../shared/hooks";
 /**
  * Configuration for a single series in a MultiAxisLineChart.
  */
-export interface MultiAxisSeriesConfig<TDatum = Record<string, any>> {
+export interface MultiAxisSeriesConfig<TDatum = Datum> {
     /** Field name or function to access y values for this series */
     yAccessor: ChartAccessor<TDatum, number>;
     /** Axis label for this series */
@@ -23,7 +24,7 @@ export interface MultiAxisSeriesConfig<TDatum = Record<string, any>> {
 /**
  * MultiAxisLineChart component props
  */
-export interface MultiAxisLineChartProps<TDatum extends Record<string, any> = Record<string, any>> extends BaseChartProps, AxisConfig {
+export interface MultiAxisLineChartProps<TDatum extends Datum = Datum> extends BaseChartProps, AxisConfig {
     /** Array of data points shared by both series */
     data?: TDatum[];
     /** Field name or function to access x values @default "x" */
@@ -50,7 +51,7 @@ export interface MultiAxisLineChartProps<TDatum extends Record<string, any> = Re
     /** Legend position */
     legendPosition?: LegendPosition;
     /** Annotations */
-    annotations?: Record<string, any>[];
+    annotations?: Datum[];
     /** Additional StreamXYFrame props */
     frameProps?: Partial<Omit<StreamXYFrameProps, "chartType" | "data" | "size">>;
 }
@@ -66,6 +67,6 @@ export interface MultiAxisLineChartProps<TDatum extends Record<string, any> = Re
  * multi-line chart with a dev-mode console warning.
  */
 export declare const MultiAxisLineChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: MultiAxisLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: MultiAxisLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

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

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

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

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

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

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

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

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

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

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

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

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

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