semiotic 3.3.1 → 3.4.1

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

@@ -1,5 +1,6 @@
+import type { Datum } from "../shared/datumTypes";
 import * as React from "react";
-import type { StreamOrdinalFrameProps } from "../../stream/ordinalTypes";
+import type { StreamOrdinalFrameProps, StreamOrdinalFrameHandle } from "../../stream/ordinalTypes";
 import type { LegendInteractionMode } from "../shared/hooks";
 import type { BaseChartProps, ChartAccessor, CategoryFormatFn } from "../shared/types";
 import { type TooltipProp } from "../../Tooltip/Tooltip";
@@ -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,12 +84,15 @@ 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">>;
 }
+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<RealtimeFrameHandle>): 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>;
@@ -16,8 +17,8 @@ export interface StackedBarChartProps<TDatum extends Record<string, any> = Recor
     colorBy?: ChartAccessor<TDatum, string>;
     colorScheme?: string | string[];
     normalize?: boolean;
-    /** Category sort order. Default: false (data insertion order). "asc"/"desc" sorts by total stacked value. Custom comparators receive category keys. */
-    sort?: boolean | "asc" | "desc" | ((a: string, b: string) => number);
+    /** Category sort order. Default: `false` (data insertion order). `"asc"`/`"desc"` sorts by total stacked value. `"auto"` preserves insertion order while streaming and falls through to value-desc on static data. Custom comparators receive category keys. */
+    sort?: boolean | "asc" | "desc" | "auto" | ((a: string, b: string) => number);
     barPadding?: number;
     /** Rounded top corner radius. Only the topmost stacked segment gets rounded. */
     roundedTop?: number;
@@ -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 */

package/dist/components/charts/realtime/RealtimeLineChart.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 RealtimeLineChartProps<TDatum extends Record<string, any> = Record<string, any>> {
+import type { Datum } from "../shared/datumTypes";
+export interface RealtimeLineChartProps<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 RealtimeLineChartProps<TDatum extends Record<string, any> = Rec
     /** Ring buffer capacity */
     windowSize?: number;
     /** Controlled data array */
-    data?: Record<string, any>[];
+    data?: Datum[];
     /** Time value accessor */
     timeAccessor?: ChartAccessor<TDatum, number>;
     /** Value accessor */
@@ -49,6 +50,8 @@ export interface RealtimeLineChartProps<TDatum extends Record<string, any> = Rec
     strokeWidth?: number;
     /** Dash pattern (e.g. "4,2") */
     strokeDasharray?: string;
+    /** Uniform line opacity (0–1). Pairs with `stroke` / `strokeWidth` for the designer-facing primitive vocabulary. */
+    opacity?: number;
     /** Show canvas-drawn axes */
     showAxes?: boolean;
     /** Background fill color */
@@ -60,9 +63,9 @@ export interface RealtimeLineChartProps<TDatum extends Record<string, any> = Rec
     /** 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 +100,7 @@ export interface RealtimeLineChartProps<TDatum extends Record<string, any> = Rec
     /** Legend interaction mode */
     legendInteraction?: LegendInteractionMode;
     /** ID accessor for remove()/update() on the push API */
-    pointIdAccessor?: string | ((d: any) => string);
+    pointIdAccessor?: string | ((d: Datum) => string);
 }
 /**
  * RealtimeLineChart - Simplified wrapper for streaming line charts.
@@ -119,6 +122,6 @@ export interface RealtimeLineChartProps<TDatum extends Record<string, any> = Rec
  * ```
  */
 export declare const RealtimeLineChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: RealtimeLineChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/realtime/RealtimeSwarmChart.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 RealtimeSwarmChartProps<TDatum extends Record<string, any> = Record<string, any>> {
+import type { Datum } from "../shared/datumTypes";
+export interface RealtimeSwarmChartProps<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 RealtimeSwarmChartProps<TDatum extends Record<string, any> = Re
     /** Ring buffer capacity */
     windowSize?: number;
     /** Controlled data array */
-    data?: Record<string, any>[];
+    data?: Datum[];
     /** Time value accessor */
     timeAccessor?: ChartAccessor<TDatum, number>;
     /** Value accessor */
@@ -68,9 +69,9 @@ export interface RealtimeSwarmChartProps<TDatum extends Record<string, any> = Re
     /** Callback on hover */
     onHover?: (d: HoverData | null) => void;
     /** Annotation objects (including threshold coloring) */
-    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 RealtimeSwarmChartProps<TDatum extends Record<string, any> = Re
     /** Legend interaction mode */
     legendInteraction?: LegendInteractionMode;
     /** ID accessor for remove()/update() on the push API */
-    pointIdAccessor?: string | ((d: any) => string);
+    pointIdAccessor?: string | ((d: Datum) => string);
 }
 /**
  * RealtimeSwarmChart - Simplified wrapper for streaming dot/swarm charts.
@@ -121,6 +122,6 @@ export interface RealtimeSwarmChartProps<TDatum extends Record<string, any> = Re
  * ```
  */
 export declare const RealtimeSwarmChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: RealtimeSwarmChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: RealtimeSwarmChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

package/dist/components/charts/realtime/RealtimeWaterfallChart.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 RealtimeWaterfallChartProps<TDatum extends Record<string, any> = Record<string, any>> {
+import type { Datum } from "../shared/datumTypes";
+export interface RealtimeWaterfallChartProps<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 RealtimeWaterfallChartProps<TDatum extends Record<string, any>
     /** Ring buffer capacity */
     windowSize?: number;
     /** Controlled data array */
-    data?: Record<string, any>[];
+    data?: Datum[];
     /** Time value accessor */
     timeAccessor?: ChartAccessor<TDatum, number>;
     /** Value accessor (positive = gain, negative = loss) */
@@ -57,6 +58,8 @@ export interface RealtimeWaterfallChartProps<TDatum extends Record<string, any>
     stroke?: string;
     /** Bar stroke width */
     strokeWidth?: number;
+    /** Uniform bar opacity (0–1). */
+    opacity?: number;
     /** Show canvas-drawn axes */
     showAxes?: boolean;
     /** Background fill color */
@@ -68,9 +71,9 @@ export interface RealtimeWaterfallChartProps<TDatum extends Record<string, any>
     /** 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 +100,7 @@ export interface RealtimeWaterfallChartProps<TDatum extends Record<string, any>
     /** Legend interaction mode */
     legendInteraction?: LegendInteractionMode;
     /** ID accessor for remove()/update() on the push API */
-    pointIdAccessor?: string | ((d: any) => string);
+    pointIdAccessor?: string | ((d: Datum) => string);
 }
 /**
  * RealtimeWaterfallChart - Simplified wrapper for streaming waterfall charts.
@@ -118,6 +121,6 @@ export interface RealtimeWaterfallChartProps<TDatum extends Record<string, any>
  * ```
  */
 export declare const RealtimeWaterfallChart: {
-    <TDatum extends Record<string, any> = Record<string, any>>(props: RealtimeWaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
+    <TDatum extends Datum = Datum>(props: RealtimeWaterfallChartProps<TDatum> & React.RefAttributes<RealtimeFrameHandle>): React.ReactElement | null;
     displayName?: string;
 };

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

@@ -1,4 +1,3 @@
-import * as React from "react";
 export interface ChartErrorProps {
     /** Component name for the error message */
     componentName: string;
@@ -18,4 +17,4 @@ export interface ChartErrorProps {
  * Designed to be obvious in development but not alarming in production —
  * uses muted colors that adapt to light/dark backgrounds.
  */
-export default function ChartError({ componentName, message, diagnosticHint, width, height, }: ChartErrorProps): React.JSX.Element;
+export default function ChartError({ componentName, message, diagnosticHint, width, height, }: ChartErrorProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,3 +1,4 @@
+import type { Datum } from "./datumTypes";
 /**
  * Coordinate resolution helpers for annotations.
  *
@@ -9,15 +10,15 @@
  * Consumed by: annotationRules.tsx (all annotation type renderers)
  */
 import type { AnnotationContext } from "../../realtime/types";
-export declare function resolveX(ann: Record<string, any>, context: AnnotationContext): number | null;
-export declare function resolveY(ann: Record<string, any>, context: AnnotationContext): number | null;
+export declare function resolveX(ann: Datum, context: AnnotationContext): number | null;
+export declare function resolveY(ann: Datum, context: AnnotationContext): number | null;
 /**
  * Resolve annotation position respecting anchor mode.
  * - "fixed" (default): resolve from annotation's own fields
  * - "latest": resolve from the most recent datum in the buffer
  * - "sticky": resolve from annotation fields; if not found, use cached position
  */
-export declare function resolveAnchoredPosition(ann: Record<string, any>, index: number, context: AnnotationContext): {
+export declare function resolveAnchoredPosition(ann: Datum, index: number, context: AnnotationContext): {
     x: number;
     y: number;
 } | null;

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

@@ -1,3 +1,4 @@
 import * as React from "react";
 import type { AnnotationContext } from "../../realtime/types";
-export declare function createDefaultAnnotationRules(frameType: "xy" | "ordinal" | "network"): (annotation: Record<string, any>, index: number, context: AnnotationContext) => React.ReactNode | null;
+import type { Datum } from "./datumTypes";
+export declare function createDefaultAnnotationRules(_frameType: "xy" | "ordinal" | "network"): (annotation: Datum, index: number, context: AnnotationContext) => React.ReactNode | null;

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

@@ -1,4 +1,5 @@
 import { interpolateBlues, interpolateReds, interpolateGreens, interpolateOranges, interpolatePurples, interpolateViridis, interpolatePlasma } from "d3-scale-chromatic";
+import type { Datum } from "./datumTypes";
 /**
  * Predefined color schemes
  */
@@ -45,7 +46,7 @@ export declare const DEPTH_PALETTE_COLORS: string[];
  * getColor({value: 10}, d => d.value > 5 ? 'red' : 'blue')
  * ```
  */
-export declare function getColor(dataPoint: any, colorBy: string | ((d: any) => string), colorScale?: (v: any) => string): string;
+export declare function getColor(dataPoint: any, colorBy: string | ((d: Datum) => string), colorScale?: (v: any) => string): string;
 /**
  * Creates a color scale function from data
  *
@@ -60,7 +61,7 @@ export declare function getColor(dataPoint: any, colorBy: string | ((d: any) =>
  * const color = colorScale('A') // Returns color for category 'A'
  * ```
  */
-export declare function createColorScale(data: Array<Record<string, any>>, colorBy: string, scheme?: string | string[]): (v: string) => string;
+export declare function createColorScale(data: Array<Datum>, colorBy: string, scheme?: string | string[]): (v: string) => string;
 /**
  * Generates a size function based on sizeBy configuration
  *
@@ -70,4 +71,4 @@ export declare function createColorScale(data: Array<Record<string, any>>, color
  * @param domain - Optional domain for scaling [minValue, maxValue]
  * @returns Size value
  */
-export declare function getSize(dataPoint: any, sizeBy: string | ((d: any) => number), sizeRange?: [number, number], domain?: [number, number]): number;
+export declare function getSize(dataPoint: any, sizeBy: string | ((d: Datum) => number), sizeRange?: [number, number], domain?: [number, number]): number;

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

@@ -0,0 +1,20 @@
+/**
+ * `Datum` — the canonical "user-supplied chart data row" type.
+ *
+ * A charting library cannot know the shape of the user's data ahead of time.
+ * This alias names that intent: "an object whose field types we do not know
+ * until the user plugs in a concrete generic." Every HOC threads a
+ * `<TDatum extends Datum = Datum>` generic so accessors can autocomplete
+ * user field names when a concrete type is supplied, while still accepting
+ * arbitrary data otherwise.
+ *
+ * Why `any` (and not `unknown`) on the value side: the library and user code
+ * both do unguarded field access (`d.x`, `d[accessor]`, `...d` spreads). With
+ * `unknown`, each access would require a narrowing step that adds no runtime
+ * safety (the data is still dynamically shaped at runtime) but imposes
+ * ergonomic cost on every user accessor function and every internal pass
+ * that augments rows. The `any` in this specific alias is the single,
+ * documented, library-wide allowance; it's the "clear and established
+ * reason" referenced by the lint policy for `@typescript-eslint/no-explicit-any`.
+ */
+export type Datum = Record<string, any>;

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

@@ -1,9 +1,4 @@
-/**
- * diagnoseConfig — anti-pattern detector for Semiotic chart configurations.
- *
- * Catches common failure modes that produce blank charts or runtime errors,
- * returning actionable fix instructions for each issue found.
- */
+import type { Datum } from "./datumTypes";
 export interface Diagnosis {
     severity: "error" | "warning";
     code: string;
@@ -20,4 +15,4 @@ export interface DiagnosisResult {
  * Returns actionable diagnoses with severity, code, message, and fix instruction.
  * Runs validateProps internally — validation errors are included as diagnoses.
  */
-export declare function diagnoseConfig(componentName: string, props: Record<string, any>): DiagnosisResult;
+export declare function diagnoseConfig(componentName: string, props: Datum): DiagnosisResult;

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

@@ -1,3 +1,5 @@
+import * as React from "react";
+import type { Datum } from "./datumTypes";
 /**
  * Format number with specified format string
  *
@@ -38,7 +40,7 @@ export declare function formatAxis(type?: "number" | "date" | "percent" | "curre
     decimals?: number;
     format?: string;
     currency?: string;
-}): (d: any) => string;
+}): (d: number | string | Date) => string;
 /**
  * Creates a tooltip content generator
  *
@@ -56,7 +58,7 @@ export declare function formatAxis(type?: "number" | "date" | "percent" | "curre
  * )
  * ```
  */
-export declare function createTooltip(fields: string[], formatters?: Record<string, (v: any) => string>, labels?: Record<string, string>): (d: any) => JSX.Element;
+export declare function createTooltip(fields: string[], formatters?: Record<string, (v: any) => string>, labels?: Record<string, string>): (d: Datum) => React.JSX.Element;
 /**
  * Formats large numbers with K/M/B suffixes
  *