semiotic 3.4.0 → 3.4.2

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

@@ -6,5 +6,5 @@ export type { ForecastResult } from "./statisticalOverlays";
 /** Duplicated here to avoid pulling in the heavy statisticalOverlays module at import time */
 export declare const SEGMENT_FIELD: "__forecastSegment";
 export declare function buildForecastLazy(...args: Parameters<typeof import("./statisticalOverlays")["buildForecast"]>): Promise<import("./statisticalOverlays").ForecastResult>;
-export declare function buildAnomalyAnnotationsLazy(...args: Parameters<typeof import("./statisticalOverlays")["buildAnomalyAnnotations"]>): Promise<Record<string, any>[]>;
-export declare function createSegmentLineStyleLazy(...args: Parameters<typeof import("./statisticalOverlays")["createSegmentLineStyle"]>): Promise<(d: Record<string, any>) => Record<string, any>>;
+export declare function buildAnomalyAnnotationsLazy(...args: Parameters<typeof import("./statisticalOverlays")["buildAnomalyAnnotations"]>): Promise<import("./datumTypes").Datum[]>;
+export declare function createSegmentLineStyleLazy(...args: Parameters<typeof import("./statisticalOverlays")["createSegmentLineStyle"]>): Promise<(d: import("./datumTypes").Datum) => import("./datumTypes").Datum>;

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

@@ -1,3 +1,4 @@
+import type { Datum } from "./datumTypes";
 import * as React from "react";
 /**
  * Shared tooltip for distribution charts (BoxPlot, ViolinPlot, RidgelinePlot).
@@ -7,5 +8,5 @@ import * as React from "react";
  */
 export declare function buildStatsTooltip(options?: {
     /** If provided, computes fallback stats from raw data when d.stats is missing */
-    valueAccessor?: string | ((d: any) => number);
-}): (d: Record<string, any>) => React.ReactElement;
+    valueAccessor?: string | ((d: Datum) => number);
+}): (d: Datum) => React.ReactElement;

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

@@ -1,5 +1,6 @@
 import * as React from "react";
 import type { HoverData } from "../../realtime/types";
+import type { Datum } from "./datumTypes";
 export interface TooltipFieldConfig {
     label: string;
     accessor: string | ((d: any) => any);
@@ -17,9 +18,9 @@ export interface TooltipFieldConfig {
  * Extract a display name from an accessor.
  * Strings return themselves; functions return "value".
  */
-export declare function accessorName(acc: string | Function): string;
+export declare function accessorName(acc: string | ((...args: any[]) => any)): string;
 export declare function formatVal(v: unknown): string;
-export declare function resolveValue(d: Record<string, any>, acc: string | ((d: Record<string, any>) => any)): unknown;
+export declare function resolveValue(d: Datum, acc: string | ((d: Datum) => any)): unknown;
 /**
  * Build a default tooltipContent function for StreamXYFrame HOCs.
  * Receives HoverData ({ data, time, value, x, y }) and renders
@@ -34,13 +35,13 @@ export declare function buildDefaultTooltip(fields: TooltipFieldConfig[]): (hove
  *   (PieChart/DonutChart wrap data in arrays). Default: `d.data || d`.
  */
 export declare function buildOrdinalTooltip({ categoryAccessor, valueAccessor, groupAccessor, groupLabel, pieData, valueFormat, }: {
-    categoryAccessor: string | ((d: any) => any);
-    valueAccessor: string | ((d: any) => any);
-    groupAccessor?: string | ((d: any) => any);
+    categoryAccessor: string | ((d: Datum) => any);
+    valueAccessor: string | ((d: Datum) => any);
+    groupAccessor?: string | ((d: Datum) => any);
     groupLabel?: string;
     pieData?: boolean;
     /** Same formatter the HOC passes to the value axis. Threaded here so the
      *  default tooltip shows values consistently with the axis ("$450k", not
      *  "450000"). Override by passing a custom `tooltip` prop. */
     valueFormat?: (v: any, ...rest: any[]) => React.ReactNode;
-}): (d: Record<string, any>) => React.ReactNode;
+}): (d: Datum) => React.ReactNode;

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

@@ -1,7 +1,8 @@
 import type React from "react";
-import type { MarginType } from "../../types/generalTypes";
+import type { PartialMargin } from "../../types/marginType";
 import type { OnObservationCallback } from "../../store/ObservationStore";
 import type { AnimateProp } from "../../stream/pipelineTransitionUtils";
+import type { Datum } from "./datumTypes";
 /**
  * Selection consumption config — makes this chart react to a named selection
  */
@@ -11,9 +12,9 @@ export interface SelectionConfig {
     /** Opacity for unselected elements (default 0.2) */
     unselectedOpacity?: number;
     /** Style overrides for unselected elements */
-    unselectedStyle?: Record<string, any>;
+    unselectedStyle?: Datum;
     /** Style overrides for selected elements */
-    selectedStyle?: Record<string, any>;
+    selectedStyle?: Datum;
 }
 /**
  * Linked hover config
@@ -52,8 +53,10 @@ export interface BaseChartProps {
     width?: number;
     /** Chart height in pixels. Default: 400 */
     height?: number;
-    /** Margin around the chart. Can be number (same on all sides) or object specifying each side */
-    margin?: MarginType;
+    /** Margin around the chart. Accepts a number (same on all sides) or an object
+     *  with any subset of `top`/`bottom`/`left`/`right`. Missing sides fall back
+     *  to the chart-mode defaults. */
+    margin?: PartialMargin;
     /** Auto-match width to parent container. Default: false */
     responsiveWidth?: boolean;
     /** Auto-match height to parent container (requires parent with explicit height). Default: false */
@@ -80,6 +83,12 @@ export interface BaseChartProps {
     /** Uniform fill color for all data marks. Overrides colorScheme and theme categorical.
      * For per-category coloring, use `colorBy` + `colorScheme` instead. */
     color?: string;
+    /** Uniform stroke color for all data marks. Accepts a CSS variable. */
+    stroke?: string;
+    /** Uniform stroke width in pixels. */
+    strokeWidth?: number;
+    /** Uniform opacity for all data marks (0–1). Distinct from `--semiotic-selection-opacity` which only dims non-selected marks. */
+    opacity?: number;
     /** Accessible description overriding the auto-generated aria-label on the chart container.
      * Should describe the chart's purpose or content for screen reader users. */
     description?: string;
@@ -99,9 +108,9 @@ export interface BaseChartProps {
     /** Max pixel distance for hover/click hit testing. Default 30. Increase for sparse charts, decrease for dense ones. */
     hoverRadius?: number;
     /** ID accessor for remove()/update() on XY charts. Extracts a unique identifier from each datum. */
-    pointIdAccessor?: string | ((d: any) => string);
+    pointIdAccessor?: string | ((d: Datum) => string);
     /** ID accessor for remove()/update() on ordinal charts. Extracts a unique identifier from each datum. */
-    dataIdAccessor?: string | ((d: any) => string);
+    dataIdAccessor?: string | ((d: Datum) => string);
     /** Visual emphasis level for dashboard hierarchy. "primary" spans two columns in ChartGrid. */
     emphasis?: "primary" | "secondary";
     /** Enable declarative bounded animation (enter/exit/update transitions + intro).
@@ -118,9 +127,9 @@ export interface AxisConfig {
     /** Label for the y-axis */
     yLabel?: string;
     /** Format function for x-axis tick labels. Return string or ReactNode for custom rendering. */
-    xFormat?: (d: any, index?: number, allTicks?: number[]) => string | React.ReactNode;
+    xFormat?: (d: number | Date | string, index?: number, allTicks?: number[]) => string | React.ReactNode;
     /** Format function for y-axis tick labels. Return string or ReactNode for custom rendering. */
-    yFormat?: (d: any) => string | React.ReactNode;
+    yFormat?: (d: number | Date | string) => string | React.ReactNode;
 }
 /**
  * Category formatting for ordinal chart tick labels.
@@ -134,14 +143,14 @@ export type CategoryFormatFn = (label: string, index?: number) => string | React
 export type Accessor<T = any> = string | ((d: any, i?: number) => T);
 /**
  * Generic accessor type that provides autocomplete when TDatum is specified.
- * Uses Record<string, any> in the function param so HOC charts can pass
+ * Uses Datum in the function param so HOC charts can pass
  * accessors to Stream Frames without contravariance errors under strict mode.
  */
-export type ChartAccessor<TDatum, T> = (keyof TDatum & string) | ((d: Record<string, any>, i?: number) => T);
+export type ChartAccessor<TDatum, T> = (keyof TDatum & string) | ((d: Datum, i?: number) => T);
 /**
  * Color configuration
  */
-export interface ColorConfig<TDatum = Record<string, any>> {
+export interface ColorConfig<TDatum = Datum> {
     /** Field name or function to determine color */
     colorBy?: ChartAccessor<TDatum, string>;
     /** Color scheme name (e.g., "blues", "category10") */
@@ -152,7 +161,7 @@ export interface ColorConfig<TDatum = Record<string, any>> {
 /**
  * Size configuration
  */
-export interface SizeConfig<TDatum = Record<string, any>> {
+export interface SizeConfig<TDatum = Datum> {
     /** Field name or function to determine size */
     sizeBy?: ChartAccessor<TDatum, number>;
     /** Min and max size range */

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

@@ -1,8 +1,9 @@
+import type { Datum } from "./datumTypes";
 import { useChartLegendAndMargin, useLegendInteraction, DEFAULT_COLOR } from "./hooks";
 import type { LegendInteractionMode, LegendPosition } from "./hooks";
 import type { Accessor, SelectionConfig, LinkedHoverProp } from "./types";
 import type { OnObservationCallback } from "../../store/ObservationStore";
-import type { MarginType } from "../../types/generalTypes";
+import type { PartialMargin } from "../../types/marginType";
 import type { SelectionHookResult } from "./selectionUtils";
 import type { ReactElement, ReactNode } from "react";
 /**
@@ -14,7 +15,7 @@ import type { ReactElement, ReactNode } from "react";
  */
 export interface ChartSetupInput {
     /** The data array used for color scale and category extraction */
-    data: Array<Record<string, any>>;
+    data: Array<Datum>;
     /** The original data prop (may be undefined) — used for empty-state check */
     rawData: unknown[] | undefined;
     /** The color-by accessor (may be an "actual" colorBy derived from stackBy/groupBy/categoryAccessor) */
@@ -42,7 +43,7 @@ export interface ChartSetupInput {
     /** Show legend override */
     showLegend: boolean | undefined;
     /** User-provided margin */
-    userMargin: MarginType | undefined;
+    userMargin: PartialMargin | undefined;
     /** Mode-resolved margin defaults */
     marginDefaults: {
         top: number;
@@ -81,9 +82,9 @@ export interface ChartSetupResult {
     /** The active cross-chart selection hook (before legend merge) */
     activeSelectionHook: SelectionHookResult | null;
     /** Custom hover behavior callback for the frame */
-    customHoverBehavior: (d: Record<string, any> | null) => void;
+    customHoverBehavior: (d: Datum | null) => void;
     /** Custom click behavior callback for the frame */
-    customClickBehavior: (d: Record<string, any> | null) => void;
+    customClickBehavior: (d: Datum | null) => void;
     /** Legend config (or undefined if no legend) */
     legend: ReturnType<typeof useChartLegendAndMargin>["legend"];
     /** Computed margin with legend-aware adjustments */
@@ -98,7 +99,7 @@ export interface ChartSetupResult {
     /** If non-null, the HOC should return this element (loading or empty state) */
     earlyReturn: ReactElement | null;
     /** Props to spread into the stream frame for legend behavior */
-    legendBehaviorProps: Record<string, any>;
+    legendBehaviorProps: Datum;
     /** Crosshair props to spread into StreamXYFrame when linkedHover mode is "x-position" */
     crosshairProps: {
         linkedCrosshairName: string;

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/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;
 };